WP2Amparex

Professional appointment booking tool with Amparex connection for WordPress.
Enables your customers to book appointments online.

Prerequisites:

  1. You have a functioning WordPress website
  2. You use AMPAREX and have a functioning AMPAREX API access.
Version 2.6.1 Aktualisiert 18. June 2026 PHP 7.4+ Lizenz: 1 Jahr(e) 1 Datei

Änderungsprotokoll

2.6.1

Publication Date: June 2026

  • Fixed: For specific employee/room combinations, WP2Amparex now sends allGivenResourcesMustBeAvailable=true to the Amparex FreeBusy endpoint.
  • Fallback: If the API returns an error in response to the AND path, or if the local strategy requires fewer API calls for many combinations, WP2Amparex continues to use the local intersection of individual resources.
  • Booking-Guard: Before the final booking call, WP2Amparex first checks the selected employee/room/slot without using the cache via the Amparex-AND query and only falls back to the local individual check in the event of API errors.
  • Debug: For combined resources, the support/debug section shows whether the AND flag is sent.
  • Documentation: The Amparex FreeBusy documentation describes the primary path, the fallback, and the verified Vollbach/Paderborn regression case.

2.6.0

Publication Date: June 2026

  • New: You can skip the store selection step using a validated deep link. The parameter is wp2a_branch and wait for the Amparex branch ID.
  • Security: The branch ID provided is checked on the server side against the current Amparex branch list. Invalid, deleted, or IDs from other clients are properly redirected back to the normal branch selection screen.
  • Admin UX: In the Settings Center, under "Amparex & Appointment Logic > Branches & Advisors > Branches," each branch now displays a ready-to-use deep link with a "Copy Link" button.
  • Navigation: For valid deep links, the "Back" button takes you either to the referring page or, if there is no referring page, to the standard store selection.
  • Robustness: The settings JavaScript files are now outputted more reliably as inline admin scripts, ensuring that copy buttons and existing admin interactions initialize correctly.

2.5.2

Publication Date: June 2026

  • Fix: For appointments involving staff and room resources, the Amparex free/busy response is returned for multiple resourceIDs is no longer interpreted as shared availability. Instead, WP2Amparex queries employees and rooms individually and calculates only true intersections locally.
  • Fix: Before the final booking call, WP2Amparex checks the selected employee/room/slot in real time and without using the cache. If any of the resources are not available, the booking is canceled before reaching the Amparex booking endpoint.
  • Improvement: The first calendar view uses the 4-week availability more efficiently and derives the current week from it, instead of querying the Amparex API twice—once for the current week and once for the preview.
  • Documentation: The confirmed Amparex Freebusy OR semantics, the local AND workaround, and the verified Vollbach/Paderborn regression case are documented in the repo docs and on the wiki.

2.5.1

Publication Date: May 2026

  • In the license section, you can now manually check for plugin updates. This simply clears the WP2Amparex update cache, and WordPress then rechecks the EDD update channel.
  • After a new release, installations can immediately check whether EDD / isla-stud.io is serving the latest version without having to clear the Amparex or Termin caches.

2.5.0

Publication Date: May 2026

  • Branches can be sorted in the Settings Center using drag-and-drop or the up/down buttons; the saved order is applied to the branch selection in the front end.
  • Consultants/employees can also be sorted; the front-end consultant selection uses the saved order when the consultant steps are active.
  • Branch and consultant sequences are saved for each connected Amparex setup and reloaded when switching back.
  • New or previously unsorted Amparex entries consistently appear below the saved items. Entries that are no longer available do not interfere with the user interface and are preserved in case they reappear later.
  • Saved Amparex setups now also display the number of branch and advisor positions and remove this data when the setup is deleted.

2.4.0

Publication Date: May 2026

  • Appointment categories, start/end of day, the "Disable Advisor Steps" option, and branch and advisor images are saved for each connected Amparex setup and restored when switching back.
  • Saved Amparex setups can be deleted individually in the Settings Center; this applies to client-specific categories, scheduling logic, branch screens, and advisor screens.
  • New mainline installations no longer display a pre-filled association key and use neutral license text. Previously saved license keys are retained.

2.3.1

Publication Date: May 2026

  • Fixed: For Amparex appointments booked online, the "Text" field is cleared, and the comment is reset to the standard technical booking text after the booking is completed.
  • Fix: Internal template, location, and icon markers such as Location_..., O-Service or fas fa-... no longer appear at the beginning of the Amparex comment field.

2.3.0

Publication Date: May 2026

  • In the overview, the Amparex configuration now displays the connected Amparex tenant instead of the technical API URL when the connection is complete.
  • Branch and consultant tiles can optionally display custom images from the WordPress media library; if no image is assigned, the existing icons will remain.
  • Image mapping is separate for each Amparex client and is retained even if the technical API credentials are changed.
  • The outdated settings section for the former "All" option and hidden event categories has been removed.
  • Admin workflows, mobile tabs, help texts, and support and design sections have been streamlined.
  • The EDD-only Release Builder is no longer hard-coded to version 2.2.0 and builds Stable artifacts from the current plugin version.

2.2.0

Publication Date: March 2026

  • ACF has been removed from the plugin and replaced with a dedicated WP2Amparex Settings Center.
  • Existing ACF option data will be migrated to the native `wp_options` table once; legacy data will be retained for the time being in case of rollbacks.
  • API access, scheduling logic, design, emails, support/debugging, and license management are now bundled into a separate admin area.
  • This release no longer includes the ACF runtime.

2.1.0

Publication Date: January 2026

  • Licensing and updates are now handled through EDD / isla-stud.io.
  • Freemius and Kestrel have been removed from the maintained release branch.
  • The license status only affects updates and admin notices; settings and the front end remain accessible at all times.

2.0.1

Publication Date: February 2026

  • New version of Bruecken for existing customers on the old Freemius channel.
  • It is built from the current refactored code and already includes the EDD license and update path.
  • Freemius will remain included only for this one update cycle; after that, the transition to isla-stud.io / EDD will take place.

2.0.0

Publication Date: January 2026

Version 2.0.0 is a comprehensive overhaul of WP2Amparex. The entire booking process has been technically rebuilt, numerous improvements for end users have been introduced, and the maintainability of the code has been significantly improved.

License and Settings

  • A new custom menu called "WP2Amparex" in the WordPress backend.
  • The refactored codebase will serve as the foundation for the future transition from Freemius to EDD.

Booking Process – More User-Friendly

  • If there is only one branch, the "Select Branch" step is skipped; the booking begins directly with the appointment category.
  • If there are no more available appointments in the first calendar week displayed (e.g., all slots are already booked), the calendar automatically jumps to the first week in which appointments are still available—whether or not you’ve selected a preferred counselor.
  • The calendar view now has consistent column heights for each day; overlapping appointment blocks (e.g., "busy" and "free") are displayed clearly.

Appointment Slots and Display

  • Improved detection of available time slots: All relevant rooms (including rooms with custom identifiers in the "description" field in Amparex, such as "Location_1" and "Location_2") are taken into account when searching for available time slots. This ensures that bookable time slots are displayed more reliably.
  • Debug Window (if enabled in the settings): An advanced overview of branches and resources, and a free/busy checker for employees and rooms.

Cache and Timeliness

  • New "Clear WP2Amparex Cache" button on the settings page. After making changes in Amparex (e.g., new appointments, updated opening hours) or after adjusting the API or client settings, you can clear the plugin cache specifically so that the latest data is loaded immediately.

Stability and WordPress Website Health

  • The plugin no longer starts a PHP session every time a page is loaded. The previous message in the WordPress "Site Health" section regarding open PHP sessions and their impact on REST API and loopback requests is therefore no longer displayed.

Technical Adjustments

  • Higher minimum requirements: WordPress 6.0, PHP 7.4.
  • Internal: Restructured code (e.g., centralized Ajax control, dedicated services for caching, Amparex integration, and slot search), improved maintainability, and preparation for future enhancements.

1.6.0

Publication Date: October 29, 2024

  • Third-Party Security Update: ACF Pro 6.3.9
  • Third-Party Security & Feature Update: Freemius SDK 2.9.0

1.5.6

Publication Date: July 9, 2024

  • Improvement: Improved navigability on touchscreen devices
  • Third-Party Update: ACF Pro 6.3.3
  • Third-Party Update: Freemius SDK 2.7.3

1.5.2

Publication Date: June 24, 2024

  • Small feature: After selecting a branch, only those appointment categories that are available at the selected branch are displayed.
  • Fixed: The admin email address stored in the store address was not used correctly. This has now been fixed.
  • Fixed: If the title field is not selected, the user receives an error message as expected. However, after the title field was subsequently selected correctly, the user was redirected to a 404 error page instead of being able to book the appointment. This behavior has now been corrected.
  • Third-Party Update: ACF Pro 6.3.1.2

1.4.4

Publication Date: May 17, 2024

  • Improvement: Error handling for missing Amparex settings.

1.4.3

Publication Date: May 17, 2024

  • Fix: PHP output buffer has been given higher priority, as the error "Headers already sent" was triggered in PHP in specific setups when used in combination with certain front-end page builders.

1.4.2

Publication Date: May 17, 2024

  • Third-Party Update: ACF Pro 6.2.10

1.4.1

Publication Date: May 17, 2024

  • Third-Party Update: Freemius SDK 2.7.2

1.4.0

Publication Date: May 17, 2024

  • Improvement: Touch events on mobile devices with touchscreens have been significantly improved.
  • Fix: minor code fixes
  • Small feature: It is now possible to skip the steps related to consultant selection or preferred consultant selection. There is now a corresponding checkbox for this in the plugin settings under the "Amparex API" tab.

1.3.0

Publication Date: April 20, 2024

  • Fixed: In some cases, the loading indicator was not within the visible window area.
  • Fix: minor code fixes
  • Small feature: The display of the room in the admin email can now be customized via the plugin options.
  • Third-Party Update: ACF Pro 6.2.9
  • Third-Party Update: Freemius SDK 2.7.0
  • Compatibility and Testing with WordPress 6.5.x

1.2.0

Publication Date: March 21, 2024

  • Improvement: The booking form now includes a drop-down menu for the title.
  • When booking an appointment, in addition to the title, the system now also includes information in the appointment comment field indicating whether the current appointment was booked with a preferred counselor or not. Previously, this information was communicated only via email.
  • When submitting title, first name, last name, email address, and phone number to Amparex, do not include spaces between the identifier and the detail (e.g., Title: Ms., First Name: Jutta, etc.). This makes it even easier to import this information directly from the appointment into a new customer record in Amparex.

1.1.9

Publication Date: March 19, 2024

  • Fix: "Headers already sent" when there is only 1 branch

1.1.8

Publication Date: February 28, 2024

  • Third-Party Security Update: ACF Pro 6.2.7

1.1.7

Publication Date: January 24, 2024

  • Improvement: If no specific consultant has been selected, the system now displays the available appointment slots for the consultant with the earliest available slot in the calendar. Previously, no such check was performed; instead, the available appointment slots were immediately displayed for the advisor for whom the Amparex API returned valid slot results first during the query.

1.1.6

Publication Date: January 24, 2024

  • Hotfix: Multiple location resource IDs are now supported in appointment template HTML.

1.1.5

Publication Date: January 23, 2024

  • Improvement: Employee and store availability check when an employee resource is explicitly marked to be visible only to certain stores, but has also been marked to be visible in all stores. This previously caused unexpected behavior when displaying slots in the calendar.

1.1.4

Publication Date: January 19, 2024

  • Improvement: Local Resources and Store Availability Check

1.1.3

Publication Date: January 17, 2024

  • Feature Update: Location resources are now included when booking appointments, provided they are correctly maintained in Amparex. For this to work, the word "Location_" must appear in the "Description" field of the (location) resource. The text following the underscore can be chosen freely, but must not contain any special characters, spaces, or umlauts. Example: Location_1 or Location_2 or Location_MuellerOffice or Location_Booth1, etc. In addition, the “comment” field must also specify which location resource is required for the booking. Here, you can specifically enter one or more location resource description tags (Location_1, Location_2, Location_Booth3, etc.). The entries must be separated by spaces. If all location resources are permitted for booking, simply enter the word Location_all
  • Code Cleanup
  • Third-Party Update: ACF Pro 6.2.5
  • Third-Party Update: Freemius SDK v.2.6.2

1.0.7.3

Publication Date: December 12, 2023

  • Hotfix: If no preferred advisor was selected and a resource was available that was not assigned to any employee but was still enabled for online appointment booking, the selected appointment was always booked into that resource, even though the selected appointment slot did not belong to that resource’s calendar. This update should resolve this issue. This version is a beta update and is awaiting approval for general release.

1.0.7

Publication Date: December 7, 2023

  • Improved and Fixed: Session Handling

1.0.6

Publication Date: December 4, 2023

  • Freemius Code Framework Update v.2.6.1

1.0.5

Publication Date: November 28, 2023

  • Improvement: Design colors and plugin styles are applied to basic elements such as anchor tags or button tags (links and buttons) only if the new checkbox "Should theme styles be overridden?" in the Design tab of the plugin settings is checked.

1.0.4

Publication Date: November 28, 2023

  • Font Awesome Pro v. 5.15.4 is integrated into this plugin and should now work correctly.
  • There has been a change in the logic regarding the emails sent after the booking form is filled out: The WordPress admin now only receives an admin email if neither a branch email address is available in Amparex nor an additional email address has been added in the WP2Amparex settings.
  • Link colors: The text color for links is determined by the theme or Elementor you have installed. Please check this setting in your theme or Elementor and configure the text color for links there. This plugin does not define link colors, as this should be part of the theme's logic.

1.0.3

Publication Date: November 27, 2023

  • Minor improvements regarding PHP compatibility (requires at least 7.1, but is also compatible with 8.0 and 8.1)

1.0.1

Publication Date: November 26, 2023

  • Built-in native update capability / Freemius

1.0.0

Publication Date: November 22, 2023

  • Initial release following RC v.0.2.8

Ressourcen