Qlik Sense Wordpress Plugin


The Qlik Sense WordPress plugin allows the easy addition of Qlik Sense objects (charts, tables, toolbar, etc) to WordPress posts and pages. It was originally created by Yianni Ververis of Qlik and has been contributed to and improved by others, including myself.

This plugin is also featured on the Wordpress.org Plugin Directory to allow automatic installation and update notifications.

Installation

Here are the steps to get it installed on your WordPress powered website:
  1. Login to your WordPress Admin Portal.
  2. On the left hand navigation panel, select "Plugins".
  3. Towards the top of the plugins list, click the "Add New" button.

  4. In the search box towards the right hand side, type "Qlik Sense" and hit enter to search.

  5. The Qlik Sense plugin is currently one of only two results returned (the other being my Qlik for WordPress syntax highlighting plugin). Click the "Install Now" button next to it.

  6. WordPress will then download and install the plugin for you. Once complete, click the "Activate Plugin" link to complete the installation.

  7. The plugin is now installed and ready to be configured.


Upgrading

Assuming you have used the above installation method, like other WordPress plugins, you will be notified when a new version of the Qlik Sense plugin is available. Follow the prompts within the notification to upgrade to the latest stable release.

How to Configure

Before the plugin can be used, it must be configured as follows:

  1. Login to your WordPress Admin Portal.
  2. On the left hand navigation panel, select "Qlik Sense". 
  3. Enter the relevant Qlik Sense server URL, Virtual Proxy, Port and App ID(s) to connect to your Qlik Sense server:

  4. If you are using a local install of Qlik Sense Desktop instead, your settings should appear as follows: 

How to Use

The plugin utilizes a WordPress shortcode to insert Qlik Sense objects into a post or page. There are currently 3 shortcodes available to insert Qlik Sense objects, a clear selections button or the Qlik Sense selections toolbar. The shortcodes can be added manually as detailed below or alternatively, the shortcodes can be generated and inserted using the buttons provided within the WordPress text or visual post/page editor. In the text editor, place the cursor in the post/page where you wish to insert the object, then click the relevant Qlik Sense button on the editor menu. You You may be prompted to enter required parameters for the shortcode. Once complete, the shortcode will be added to the post or page.


Qlik Sense Object

This shortcode allows you to embed a chart, table or other Qlik Sense object. The shortcode syntax is as follows:
[qlik-sense-object id="page1-obj2" qvid="nvqpV" height="400"]
Parameters are as follows:
  • id="": is the unique div id. This is needed especially when you want to display the same object in 2 different instances
  • qvid="": Is the object id as found in the "dev-hub/single-configurator" or the Qlik Explorer for Developers
  • height="": The height of the visualization in pixels.
  • nointeraction="true" (optional): Add this if you want to disable interactions. If you want the objects to have interaction, you can just omit this.
  • app2="true" (optional):
  • appid="" (optional): The variable qs_appid is added to store the value from the custom field appid. The custom field is used to be able to use a separate app for each page rather than the apps defined in the plugin config.

Qlik Sense Clear Selections Button

This shortcode allows you to ebmed a Clear Selections button.
[qlik-sense-object-clear-selections title="Clear Selections"]
Parameters are as follows:
  • title="": Defines the text to be displayed on the button

Qlik Sense Selections Toolbar

This shortcode allows you to add the Qlik Sense selections toolbar to the post or page.
[qlik-sense-selection-toolbar]
No parameters are possible.

No comments:

Post a Comment