FysioVacature Vacaturewidget

FysioVacature Vacaturewidget connects a practice website to the external FysioVacature vacancy service. It displays the practice's published vacancies and, if enabled by the provider, its open-application option. Vacancy content remains centrally managed in FysioVacature. Applications continue on FysioVacature; this plugin does not collect candidate information or create local vacancy posts. An active FysioVacature widget code is required. Request access from https://fysiovacature.nl/vacature-widget and obtain your practice's embed code from FysioVacature. Installing this plugin does not activate the provider's service or grant access to another practice's vacancies. Provider access, accounts and commercial terms are separate from this plugin. Paste the 48-character public installation hash into Settings > FysioVacature widget. Pasting a complete embed into that field converts it locally before submission. A separate, unnamed helper field can also extract the hash in the browser. Only the hash is sent to WordPress; pasted script markup is never submitted by these controls or executed. Without JavaScript, enter only the hash. The administration interface is in Dutch. Features:

• Server-rendered HTML: vacancies and full descriptions are present in the initial page source.
• Compact vacancy cards with the same locally bundled two-tone icon set D as the FysioVacature JavaScript widget show available hours, salary, education and contract facts below the title, with local SVG icons and accessible labels. Missing facts are omitted; salary is never invented.
• Application buttons for individual vacancies appear only inside expanded descriptions.
• Configurable outbound UTM tags distinguish vacancy, application and organization links.
• Native details/summary controls open vacancy descriptions without JavaScript. In current browsers, opening the full description hides its short excerpt; collapsing it restores the excerpt.
• Locally bundled styles and installed font choices. No remote widget loader, fonts or images are required.
• Saved display settings and per-shortcode display overrides for colors, font, size, heading, count and summary length.
• A FysioVacature vacatures editor block and the [fysiovacature_widget] shortcode.
• A five-minute content cache shared across different display choices. WordPress transients automatically use an active persistent object cache such as Redis.
• Clear empty/error states and an administrator-initiated connection check.
• A fictional local styling preview that does not contact the provider.
• An optional practice-profile link below the widget, OFF by default. Vacancy source and application links provide the actual service routes.
• Optional usage measurement, OFF by default. Only opting in adds the local measurement script.
• An ItemList describing the visible vacancies. No JobPosting markup on this overview and no changes to the host page's canonical tag or other plugins' structured data.

The server parses the provider's HTML response as vacancy data, strips unapproved markup and rebuilds the display using local PHP templates and CSS. The provider's returned CSS and JavaScript are not executed. The PHP DOM extension is required. The plugin does not require the PHP mbstring extension beyond WordPress core compatibility functions. Salary facts come only from explicit salary statements in the published vacancy text. An explicit labeled amount is preferred; the phrase Marktconform salaris may be shortened to Marktconform. Missing or unknown salaries are omitted, never estimated. Hours, education and contract facts are read from the provider's published vacancy details. The locally bundled SVG paths were generated with AI assistance for this project and are distributed with the plugin under GPL-2.0-or-later to the extent applicable rights exist. They are not loaded from an external icon library; see assets/README.txt for asset provenance. External service: FysioVacature Provider: FysioVacature, https://fysiovacature.nl/. Purpose: obtain the current published vacancies belonging to the configured practice, the permitted open-application option and source/application links. A working service and valid provider-issued code are necessary. The WordPress server requests https://fysiovacature.nl/widgets/vacatures/{hash} when a displayed widget needs uncached data, during the five-minute scheduled refresh, or after an administrator explicitly clicks Koppeling controleren. Installing or activating an unconfigured plugin makes no provider request. Opening settings uses cached status and a fictional local preview, without initiating a request. These HTTPS requests disclose the web server's IP address, public widget hash and technical request metadata. The plugin uses a fixed plugin/version User-Agent, sends no visitor cookies or credentials, and does not send the visitor's IP address or embedding page URL in this server request. The service response includes public vacancy data and may contain a signed measurement receipt. The sanitized response is cached on the WordPress site. With measurement OFF, the plugin makes no browser request to FysioVacature to render or expand vacancies. Clicking a source/application link is a separate, visitor-initiated navigation to FysioVacature. Service information and access: https://fysiovacature.nl/vacature-widget Provider privacy statement: https://fysiovacature.nl/privacy-statement Provider terms: https://fysiovacature.nl/voorwaarden Optional usage measurement Measurement is OFF by default and is not required to display vacancies. An administrator must explicitly select the optional measurement checkbox and save to enable it. Block or shortcode display choices cannot enable it. When enabled on a public widget, the locally bundled assets/metrics.js may send requests directly from the visitor's browser to https://fysiovacature.nl/widgets/vacatures/{hash}/events. The payload contains the service-issued signed receipt, an event type (view, expand, apply, open_apply or organization) and a vacancy ID where relevant. It helps FysioVacature understand widget use and improve the service. The loader does not send a separate page URL or visitor identifier. It omits browser credentials and the referrer and respects Do Not Track and Global Privacy Control. The provider necessarily receives browser IP/network metadata for this direct connection. Browser behavior and hosting logs are outside the plugin. The plugin sets no cookies and creates no visitor profiles. It does not guarantee that all themes, other plugins or provider hosting do the same. Disabling measurements stops this plugin's measurement script on newly rendered pages, not records already received by FysioVacature. Clear page/CDN/optimization caches after a privacy change; previously cached or already open pages can retain the old choice until refreshed. Contact the provider about retained records. Outbound UTM tags UTM tags are ON by default for links to FysioVacature. Settings > FysioVacature widget lets administrators disable them or edit source, medium and campaign. A blank source uses the practice website domain, with medium widget and campaign fysiovacature by default. The content parameter distinguishes vacancy, application, open application and organization links. Existing unrelated query parameters are preserved. ItemList source URLs remain clean. These tags accompany a visitor-initiated click to FysioVacature. They identify the referring website and link type, not an individual visitor. They do not initiate background requests or enable the separate optional measurement script. A shortcode cannot override this site-wide choice. Review tags and privacy information for your website; clear page/optimization caches after changing them. Cache and availability The plugin caches sanitized vacancy data for five minutes. A bounded five-second request timeout and a brief error cache limit repeated failed requests. A scheduled refresh uses WP-Cron and therefore depends on site traffic or a configured server cron. The plugin does not keep expired vacancy data as an indefinite outage fallback. On service failure it offers a source link. Full-page, hosting and CDN caches are separate and can keep an earlier vacancy list or measurement choice for longer. Configure a suitable expiry for your vacancy page and purge these caches when vacancies or privacy settings change. An already served page does not live-refresh. Color/font changes are local and do not create extra service-cache variants. Installed fonts are used without downloading external font files.

1. Obtain an active widget embed code for your practice from FysioVacature.
2. Upload this plugin's ZIP using Plugins > Add New Plugin > Upload Plugin. Install and activate it.
3. Open Settings > FysioVacature widget. Paste your embed code or hash, choose display settings and save. Saving an active hash configures the documented external service connection. Leave optional usage measurement unchecked unless you want it.
4. Click Koppeling controleren to check the saved connection and warm the cache.
5. Add the FysioVacature vacatures block or place [fysiovacature_widget] in a Shortcode block. In the classic editor, put it on a separate line; in a page builder, use a Shortcode element.
6. Publish/update the page and inspect the public result. Clear any page or optimization cache after changes.

Once this plugin is accepted and published in the WordPress.org directory, it can also be installed by searching for its name under Plugins > Add New Plugin. This package does not claim directory approval.

1.2.1

• Use the provider's dedicated vacancy introduction and refresh the content cache on upgrade.
• The FysioVacature service no longer prepends a generated hours sentence to summaries. Hours remain in the facts and expanded details; hours written by the employer remain untouched.

1.2.0

• Match the renewed FysioVacature widget with locally bundled two-tone fact icons (set D), responsive cards and accessible field labels.
• Preserve the short collapsed summary, full expanded text and individual application button only inside the expanded vacancy.
• Keep configurable outbound UTM tags, optional usage measurement OFF by default, and clean structured-data source URLs.
• Make the additional practice-profile footer link optional and OFF by default.
• Document external-service access, salary extraction, icon provenance and GPL-compatible distribution for directory review.
• Remove an unnecessary dependency on native mbstring functions for ASCII fact labels and periods.

1.1.2

• Queue widget CSS in the page head when the queried page contains the shortcode or block, so separately rendered mobile content uses the same disclosure states and styling.
• Retain the render-time stylesheet fallback for widgets placed outside normal page content.

1.1.1

• Prevent host-theme list margins from stretching the last vacancy fact badge. Keep fact badges aligned at their natural height, including when wrapping.

1.1.0

• Add responsive vacancy cards with local SVG icons for available hours, salary, education and contract information.
• Retain the collapsed short summary; show the application button only inside the expanded vacancy.
• Add configurable, disableable UTM tags to outbound service links without changing structured-data source URLs or enabling usage measurements.

1.0.2

• Replace the visible short excerpt with the full description when expanded, restoring it on collapse, using local CSS and native details controls.
• Change the open control label to Vacature inklappen. No executable frontend script is needed for this behavior in current browsers.

1.0.1

• Extract pasted embed codes locally before saving. Submit only the public installation hash, avoiding unnecessary script markup in settings requests that can trigger a firewall.
• Add an optional unnamed local extraction field and native validation for the hash input. No firewall rules or security settings are changed.

1.0.0

• Initial submission package: server rendering, five-minute cache, native expansion, local styling, shortcode/block and optional measurement disabled by default.