About this plugin
This plugin connects your WordPress site to your CANITY account and displays services, events, and packages on any page. de. Optionally, the detail view can be embedded locally (modal, dedicated page, or inline).
Features
- Settings page under Settings → CANITY for the Partner API token
- A single shortcode [canity type="services|events|packages"] and [canity_detail] for the detail page
- Gutenberg block “CANITY List” as a convenient wrapper
- Optional embedded detail view (modal, dedicated WordPress page, inline) with deep links ( #canity-detail/{type}/{id} )
- Booking button always links to canity.de
- Services and events reserved for regular customers (Stammkund:innen) are not listed; instead, a teaser tile at the end of the list shows how many there are and links to your CANITY profile
- Responses are cached for 15 minutes (Transients API), reducing API load
- Custom CSS with.canity- namespacing, loaded only where needed; can be disabled under Settings → CANITY (enabled by default)
Usage
Shortcode
There is a single shortcode [canity]. Use the type attribute to choose what to display. The shortcode works on any page, post, or widget area.
Display services
[canity type="services"]
Lists all active individual offerings from your business as clickable cards — with image, title, optional “Online” label, duration, and price.
Display events / group offerings
[canity type="events"]
Shows all upcoming events with image, date badge, title, number of dates, and price.
Display packages and multi-visit cards
[canity type="packages"]
Displays all prepaid packages as compact cards with title, unit count, and price.
Attributes
The optional limit attribute restricts how many items are shown:
[canity type="services" limit="3"] [canity type="events" limit="5"] [canity type="packages" limit="4"]
Without limit (or with limit="0" ), all items are displayed.
Detail view
Under Settings → CANITY, you can embed the detail view on your site:
- Off (default): Click opens canity.de in a new tab.
- Modal: Details in a modal; deep link e.g. #canity-detail/events/{id}.
- Dedicated page: Click goes to a WordPress page with [canity_detail] and query parameters?canity_type=…&canity_id=….
- Inline: Detail expands below the card (only one panel open at a time).
Shortcode override: [canity type="services" detail="modal"] (values: external, modal, page, inline, or empty for global setting).
de.
Gutenberg block
If you prefer a visual workflow, add the “CANITY List” block in the block editor. In the sidebar you can choose the content type (Services / Events / Packages), the number of items, and optionally the detail view — without shortcode syntax.
For Dedicated page mode, use the “CANITY Detail” block (or shortcode [canity_detail] ) on the detail page.
Caching
API responses are cached for 15 minutes. Under Settings → CANITY, use Flush cache now to clear the cache manually — useful when you want changes in CANITY to appear on your site immediately.
External services
de ) to display services, events, and packages from your CANITY business on your WordPress site.
CANITY Partner API
de/api )
Purpose: Fetching list and detail data (services, events, packages, business profile) for display via shortcode, Gutenberg block, or embedded detail view.
What data is sent?
- The Partner API token stored in the plugin settings (as an Authorization: Bearer … HTTP header).
- A User-Agent header with the plugin version ( CANITY-WP-Plugin/… ).
No personal data from your website visitors is transmitted to CANITY.
When is data sent?
- When saving the API token under Settings → CANITY (validation via /partner/v1/me and /partner/v1/business ).
- When serving a page with the shortcode or block (server-side read requests to /partner/v1/services, /partner/v1/events, and /partner/v1/packages ).
- With embedded detail view (modal, inline, or dedicated page): additional read requests to the respective detail endpoints; in modal/inline mode, optionally via the WordPress REST endpoint /wp-json/canity/v1/detail (which forwards the request to CANITY server-side).
API responses are cached in WordPress transients for up to 15 minutes.
Images and links
g. for service, event, and trainer photos). These are loaded directly from CANITY servers in your visitors’ browsers ( <img src="…"> ).
g. de/b/{business-slug}/… ). When clicked, the visitor leaves your website.
Legal
- Terms of use: https://www.canity.de/agb
- Privacy policy: https://www.canity.de/datenschutz
Privacy and security
Partner API token
The Partner API token ( cnty_sk_… ) is stored in the WordPress option canity_options in plain text. This matches common practice for WordPress plugins that require API keys.
Who has access?
- WordPress users with Manage options ( manage_options ) can set or replace the token under Settings → CANITY.
- The admin UI shows only a truncated prefix (e.g. cnty_sk_12345678… ); the full key is not shown again there.
- The full token is readable in the database ( wp_options ) and in database backups/exports.
Recommendations
- Protect admin accounts and backup access accordingly.
- If compromised, revoke the token in CANITY and enter a new one in the plugin settings.
This plugin does not store or transmit personal data from your website visitors to CANITY (see External services ).
Resources
This plugin bundles the following third-party resource:
com/rsms/inter)
txt )
me/inter/
png )
Copyright CANITY. Included with permission for use in this plugin.