### Release notes

##### v6.1.1

2026-04-15

- Added missing default translation for payment flow result "dialogue_product_already_purchased", and improved error message fallback display.
- Affected files/shortcodes:
  - audienceplayer-core.js::openModalPurchase()

##### v6.1.0

2026-02-02

- Introduced a new short code [audienceplayer_purchase_subscription_button], which allows you to place a single purchase button for a given subscription (similar to existing shortcode [audienceplayer_purchase_product_button]). See Help > Shortcodes for more information.
- Introduced a new option for existing shortcode [audienceplayer_user_account] to display a "purchase button" if a User does not have a valid subscription. See Help > Shortcodes for more information.
- Improved display of prices in relevant shortcodes to avoid unnatural display of numbers (e.g. "€ 7,50" instead of "€ 7.5").
- Improved overall shortcode documentation (authentication/authorisation/after-purchase actions).
- Affected files and shortcodes which trigger the functions mentioned above:
  - audienceplayer-core.js::openModalPurchase() → additional graphql arguments added
  - [audienceplayer_purchase_product_button]
  - [audienceplayer_purchase_subscription_button]
  - [audienceplayer_purchase_subscriptions]
  - [audienceplayer_user_account]

##### v6.0.1

2025-07-24

- Repaired broken redirect callbacks in the purchase modal flow.
- Affected functions (repaired argument parsing):
  - audienceplayer-core.js::openModalPurchase()

##### v6.0.0

2025-05-22

☞ WARNING: major version update, observe possible breaking changes and as always, test thoroughly!

- Refactored all the deprecated AudiencePlayer API mutations and queries related to voucher validation and Product/Subscription acquisition (single new mutation: "UserPurchaseStackAcquire").
- Affected functions (argument changes):
  - audienceplayer-core.js::openModalPurchase()
  - audienceplayer-core.js::validateVoucherCode()
  - audienceplayer-core.js::redeemUserAccountVoucherCode()
- Affected shortcodes (which trigger the functions mentioned above):
  - [audienceplayer_article_detail]
  - [audienceplayer_purchase_product_button]
  - [audienceplayer_purchase_subscriptions]
  - [audienceplayer_user_account]
- New default translations were added to cover all known voucher error codes. If you overwrite translations in your own template (e.g. using "$AudiencePlayerWordpressPlugin->setTranslations([...])"), you might want to add the translations keys as well if necessary:
  - 'dialogue_voucher_code_claim_limit_overflow' : 'The voucher code cannot not be claimed, the allowed maximum number of claims has been exceeded.'
  - 'dialogue_voucher_code_not_claimed' => 'The voucher code cannot not be claimed, likely it has already been used.'
  - 'dialogue_voucher_code_product_intersect_not_allowed' => 'The voucher code cannot be applied to all of the selected products.'
  - 'dialogue_voucher_code_product_not_allowed' => 'The voucher code cannot be claimed in combination with selected products.'
  - 'dialogue_voucher_code_product_type_not_allowed' => 'The voucher code cannot be applied to the type of one or more selected products.'
  - 'dialogue_voucher_code_subscription_not_allowed' => 'The voucher code cannot be claimed in combination with selected subscription.'
  - 'dialogue_voucher_code_usage_not_allowed' => 'Usage of this voucher code is not allowed'
  - 'dialogue_voucher_code_user_email_not_allowed' => 'The voucher code cannot be claimed in combination with your current e-mail address.'
  - 'dialogue_voucher_code_user_subscription_not_allowed' => 'The voucher code cannot be claimed in combination with your already existing subscription.'

##### v5.0.2

2024-05-27

- Improved "AudiencePlayer User Synchronisation" for latest WordPress version 6.5+.

##### v5.0.1

2024-04-23

- Updated the AudiencePlayer Embed Player dependency to the latest version, with improved synchronisation of Asset Time Markers.

##### v5.0.0

2024-04-11

- Updated the AudiencePlayer Embed Player dependency to the latest version.
- Ensure you upgrade the AudiencePlayer Plugin to version 5.0.0 or higher before May 1st 2024. From this date lower versions may lose compatibility with the AudiencePlayer streaming infrastructure. For more information, please see CDN migration on May 1, 2024.

##### v4.6.1

2024-03-11

- When switching subscriptions on the my-account page, the listed subscription price is now the price per installment instead of the initial price (since the "price per installment" is the actual purchase price in this case).

##### v4.6.0

2023-08-01

- The "article-detail" shortcode has been expanded with configuration flag "show_seasons", so that a User can select the season for which to show the episodes.

##### v4.5.0

2023-05-24

- Added subscription-switch feature, which allows Users to switch their current subscription plan. This new feature is introduced in the existing shortcode "audienceplayer-shortcode-user-account.php", within the "subscription_info" block. See updated plugin help section for this shortcode with new configuration options.

##### v4.4.3

2023-05-10

- Updated dependency "AudiencePlayer Embed Player", update for Chromecast.

##### v4.4.2

2023-05-08

- Updated dependency "AudiencePlayer Embed Player", maintenance update for Embed Player and Chromecast.

##### v4.4.1

2023-04-26

- Replaced deprecated translation key "dialogue_subscription_renew" with new value "dialogue_information_renew_suspend_subscription" (affected shortcode: "audienceplayer-shortcode-user-account.php").

##### v4.4.0

2023-04-21

- Updated dependency "AudiencePlayer Embed Player", which now benefits from the latest time tracking AudiencePlayer API-endpoint.

##### v4.3.1

2023-04-21

- Minor improvement to AudiencePlayer project configuration synchronisation.

##### v4.3.0

2023-04-11

- Improved modal player behaviour by auto-closing the modal player after video has ended.
- Implemented support for enabling/disabling nomadic watching based on existing AudiencePlayer API project configuration.
- Minor code syntax and css improvements.

##### v4.2.2

2023-03-27

- Updated dependency "AudiencePlayer Embed Player", which improves time tracking accuracy during the last 30 seconds of playback.

##### v4.2.1

2023-03-16

- Added a new translation "dialogue_voucher_code_applicable_subscription_unknown" for the use case when a voucher code can only be claimed on a new or existing subscription.

##### v4.2.0

2023-03-06

- Improved automatic subscription/product purchase popup flow to avoid query-string parameter clashes for "purchase_subscription_id" and "purchase_product_id" when the page is reloaded.
  (N.B. helper method "removeQsaParameters" in audienceplayer-core.js, was renamed to "removeQsaParametersFromString")
- Added "retry"-button to the "failed payment-order validation" modal, when returning to site from payment provider (e.g. Mollie), so that the User may retry the validation. Included additional logging statement.
- Improved Admin logs table with info-button to immediately inspect the log properties (no longer necessary to first download the Excel export to inspect the properties).
- Routine composer library dependency update.

##### v4.1.1

2023-02-03

- Updated library dependency AudiencePlayer API client for PHP (v2.0.1: fix for custom integrations on Admin scope).

##### v4.1.0

2023-02-01

- Fixed minor compatibility issues for older PHP-versions 7.1 and 7.2 (N.B. If you are still on PHP v7.x, please consider upgrading to v8.x whenever possible!).
- Improved debugging capability (raw return) and metadata sanitisation (escaped quotes) on method "syncWordpressUserToAudiencePlayer" (often used in custom integrations).

##### v4.0.0

2022-12-01

- Updated AudiencePlayer API wrapper dependency to new major version 2
  Warning - possible breaking change depending on your custom implementation: Direct scripted usage of this dependency or custom references via this plugin to "$AudiencePlayerWordpressPlugin->api()" (IF any), should be checked.
- Improved error logging of AudiencePlayer API-calls.
- Plugin configuration tab "General" has been renamed to "Integrations".
- Introduced helper methods for the entitlement of Products and Subscriptions via Wordpress (See Help > Code Examples) + integration for WooCommerce which implements these helper methods automatically (available as "bèta feature" in "Configuration > Integrations").

##### v3.3.10

2022-11-11

- Updated embed-player dependency.

##### v3.3.9

2022-11-09

- Improved progress bar display for completed views.

##### v3.3.8

2022-11-08

- Bug fixes.
- Improved admin logs.

##### v3.3.7

2022-11-04

- Updated dependencies.
- Improved user metadata synchronisation with AudiencePlayer API.

##### v3.3.6

2022-11-03

- Routine maintenance and optimisations.

##### v3.3.5

2022-10-04

- Fixed a bug in the voucher-code validation flow.

##### v3.3.4

2022-06-27

- Routine update of libraries and dependencies.

##### v3.3.3

2022-03-21

- Expanded user synchronisation of e-mail/password to cover calls to cover wp_set_password() and wp_update_user(), in order to improve compatibility with third party plugins (such as WooCommerce).

##### v3.3.2

2022-03-16

- Fixed rendering issue for product/subscription short descriptions which contain line breaks (refactored helper function name from "escapeQuotes" into "sanitiseJsString" and added line-break escaping).
- General user-synchronisation efficiency improvements.

##### v3.3.1

2022-03-10

- Fixed failing user synchronisation between Wordpress and AudiencePlayer, when a user changes e-mail address by clicking on mail link ".../profile.php?newuseremail".
- Routine maintenance and dependency updates.

##### v3.3.0

2022-01-12

- Optimised player-statistics in AudiencePlayer embedded player and updated library dependencies.

##### v3.2.0

2021-12-28

- Improved geo-region and language detection in synchronisation with AudiencePlayer API and updated library dependencies.

##### v3.1.0

2021-09-09

- Implemented Debug helper tools and updated library dependencies.

##### v3.0.0

2021-08-27

- Implemented Google Chromecast support. If your AudiencePlayer plan includes "Chromecast", it can now be activated: Configuration > General.
- Plugin translations were remapped and are now synchronised with AudiencePlayer CMS.
  Warning - breaking change: Depending on your implementation, this may change/break your current translation setup!

##### v2.0.0

2021-06-03

- CSS colour variables were introduced in the main css template file "audienceplayer-shortcodes.css".
  Warning - breaking change: Depending on your implementation, this may change/break your current styling overwrites!

##### v1.10.0

2020-12-30

- Implemented modal-auto-open query-string-parameters "purchase_product_id" and "purchase_subscription_id".
- Implemented auto-login after registration.
- Implemented forced login with e-mail address and password when user-sync is activated.

##### v1.9.0

2020-12-28

- Added notifiable modal flow to user-account shortcode.

##### v1.8.0

2020-12-14

- Added dynamically generated Article Detail Pages.
- The url slug for these pages can be configured in the wp-admin.

##### v1.7.0

2020-12-03

- Expanded user sync logic with password-forgotten and remote authentication for non-existing Wordpress users.
- Improved shortcode template structure.
- Added PHP Warning triggers for unexpected shortcode use cases (like missing arguments).

##### v1.6.0

2020-11-30

- Implemented basic pagination for shortcode [audienceplayer_article_grid].
- Added image fallback to Asset-screenshot for shortcodes [audienceplayer_article_carousel], [audienceplayer_article_grid].

##### v1.5.0

2020-11-26

- Implemented user-sync logging + admin interface AudiencePlayer > Configuration > Logs.

##### v1.4.0

2020-11-20

- Added shortcodes: [audienceplayer_user_account], [audienceplayer_device_pairing].

##### v1.3.0

2020-11-17

- Added shortcodes: [audienceplayer_article_detail], [audienceplayer_purchase_product_button], [audienceplayer_purchase_subscriptions].

##### v1.2.1

2020-11-13

- First release in the Wordpress directory.

##### v1.2.0

2020-11-12

- Added shortcodes: [audienceplayer_purchase_product_button].

##### v1.1.0

2020-11-09

- Added shortcodes: [audienceplayer_article_carousel], [audienceplayer_article_grid], [audienceplayer_play_article_button], [audienceplayer_embed_article].

##### v1.0.0

2020-10-26

- Released first major version, including basic examples.