Unlock a world of possibilities! Login now and discover the exclusive benefits awaiting you.
If you’ve came across the initial Qlik Cloud Wordpress plugin on the Qlik Community Design blog and gave it a try, you probably have run into some issues with it. Today, I’m going to share a new updated version of the Qlik Cloud WordPress plugin that brings a more efficient way to embed Qlik Cloud analytics into your WordPress websites.
In this post, I'll walk you through the steps to install, configure, and use the new version of the plugin to bring your Qlik Cloud visualizations directly into your WP pages and posts.
Why the Update?
The previous version of our plugin relied on JWT tokens for auth, iframes (single integration API) and nebula.js for embedding, which worked but had limitations such as third-party cookies. Qlik Embed is the new embedding library and adopts better auth flows. In this version, I'm using OAuth impersonation to generate access token on the backend without need for users to interact with a login page.
Installation Steps
1. Install the Plugin
- Log in to your WordPress Admin Dashboard.
- Navigate to Plugins on the left sidebar.
- Click on "Add New" at the top of the page.
- Upload the zipped file (download it from GitHub here)
- Locate the plugin and click "Install Now".
- After installation, click "Activate".
Note: If you have the previous version installed, deactivate and delete it before installing the new one to avoid conflicts.
Configuring Qlik Cloud Wordpress Plugin
Before using the plugin, you'll need to set up OAuth impersonation in your Qlik Cloud tenant.
Create an OAuth Client
- Log in to your Qlik Cloud tenant as an administrator.
- Navigate to Management Console > Integrations > OAuth.
- Click on "Create new" and fill in the required details:
- Name: Give a recognizable name like "WordPress Integration".
- Allowed Origins: Add your WordPress site's URL.
- Select the right scopes to grant to the client from the Scopes list.
- Check “Allow Machine-to-Machine (M2M)” and “Allow M2M user impersonation”
- Change the consent method to Trusted
- Save the client credentials (Client ID and Client Secret) to be used in WordPress Config.
Docs here: https://qlik.dev/authenticate/oauth/create/create-oauth-client-m2m-impersonation/
Make sure to read through the Guiding Principles of OAuth Impersonation: https://qlik.dev/authenticate/oauth/guiding-principles-oauth-impersonation
P.S: this method will create a number of anonymous users on your tenant and you need to implement a way to remove these users periodically (using a Qlik Application Automation / users API)
Configuring the Plugin
- In your WordPress dashboard, go to Settings > Qlik Cloud Embed.
- Fill in the required fields:
- Host: e.g.,
https://your-tenant.region.qlikcloud.com. - Client ID: From the OAuth client you created.
- Client Secret: From the OAuth client.
- Host: e.g.,
- Click "Save Changes".
Using the Plugin
Embedding Sheets and Visualizations
With the plugin configured, you can now embed Qlik Cloud content using Shortcodes.
1. Embed an Entire Sheet/App
Use the [qlik-embed-app] shortcode:
[qlik-embed-app appid="1234-c56a-4062-ac50-377bba443e85" sheetid="12345-698f-449f-9a17-dca17eeadb71"]
Parameters:
- appid: App ID
- sheetid: Sheet ID
2. Embed Individual Visualizations/Objects
Use the [qlik-embed-object] shortcode:
[qlik-embed-object appid="1234-64317-8432" objectid="1234-5553-326432"]
Parameters:
- appid: App ID
- objectid: Object ID
3. Embed Selections bar
Use the [qlik-embed-selections] shortcode:
[qlik-embed-selections appid="1234-c56a-4062-ac50-377bba443e85"]
Parameters:
- appid: App ID
Tip:
Finding IDs in Qlik Cloud
- Open your app in Qlik Cloud.
- Navigate to the sheet or object you want to embed.
- In the URL, find the sheet ID
- Sheet ID comes after
/sheet/
- Sheet ID comes after
- For object, right click on the chart, click on Embed, and look for objectid under the chart preview.
You can download the plugin here: https://github.com/qlik-demo-team/wp-qlik-saas-plugin
P.S: this plugin is maintained by myself. If you find any bugs or issues, please report them to me or create an issue on Github and I'll do my best to resolve them quickly.
Thank you!