We’ve migrated our documentation to a new site, which means some URLs have changed.
Subscriptions
Subscriptions
Breadcrumbs

The Piano WordPress Plugin

Overview

The plugin provides:

  • AdBlock detector.

  • Integration with Composer: Experience execution based on parameter configuration in WordPress (author, create data, tags, ...).

  • Integration with UserRef: Generation and sending of user-tokens from WordPress user data.

  • Integration with Identity Management: Automatic configuration of all parameters for interaction between Wordpress, Identity Management and experiences. Use action call to add the authorization button.

  • Integration with AMP plugin: AMP experiences execute in WordPress and authorization on AMP-pages may use UserRef or Identity Management.

  • Shortcodes for embedding Piano templates in your content:

    • [piano_inline id="..."] for embedding inline templates.

    • [piano_my_account] for embedding the My Account template.

Implementation

Find the Piano plugin in WordPress.

  1. Open your Wordpress site’s dashboard.

  2. Navigate to Plugins →Add New.

  3. Search "Piano".

  4. Click to download the Piano plugin.

Copy your application ID and API token.

Navigate to your Piano publisher account and copy AID and API token

aid-and-token.png

Go to the Piano tab in WordPress.

In the application settings, enter the application ID and the API token from the Piano Sandbox / Dashboard application

app-settings.png

Composer 1X

In case you're using Composer 1x segmentation for Composer, you would need to insert your Site ID into the respective Cxense section input field in the Piano plugin settings:

cxense.png

Your account manager will provide you with your "Site ID".

Please make sure, you are using the newest version 1.0.2 of the Piano WordPress plugin.

Select functions

You've connected Piano and your Wordpress-enabled site. Choose whether to enable adblock tracking or disable Piano for privileged users and click Apply changes.

Image-3-1.png

Execute experiences

Test that your Piano experiences are showing up correctly in your Wordpress content.

Add shortcodes (optional).

Enable shortcodes for My Account & Inline Templates

  1. In WordPress, go to Pages and select the page to add the inline My Account widget or a template.

    pages444.png

  2. Create a new Shortcode block on the page and use:

    1. [piano_my_account] for the "My Account" widget

    2. [piano_inline id="..."] where the ellipsis is the name of an inline container selector.

  3. Click Update in the upper right.

    shortcode222-1024x464.png

  4. View the experience on your WordPress site.

    myacc.png

Last updated: