DISCLAIMER: The integration with WordPress is no longer supported since January 28, 2022, and reached its end of life on April 28, 2022.
Introduction
By integrating your WordPress Blog or website with your Docebo learning platform, you can transform your site into a WordPress learning system. Begin by downloading the Docebo plugin for WordPress here. Now, you can follow the process outlined below to activate the app from the Apps & Features section of your Docebo platform.
Custom Plugins are not supported in WordPress.com (SaaS version of WordPress). You must have a hosted version (https://wordpress.org/) of your website in order to be able to install the Docebo WordPress App plugin. Please refer to this article for more details on differences between wordpress.com and wordpress.org.
Activating the WordPress App in Docebo
Activate the WordPress app as described in the Managing Apps & Features article of the Knowledge Base. The app is listed in the Third Party Integrations tab.
Once the WordPress app is activated, the API and SSO app activates automatically (if not already active). Do not deactivate this app in your platform or you won't be able to use your WordPress integration to its full potential.
Configuring the API and SSO App for WordPress
To set up your platform for your WordPress integration, you will first need to configure the API and SSO app. Access the Admin Menu from the gear icon. Then, find the API and SSO section in the menu and press the Manage subitem.
On the Settings page for the API and SSO app, stay in the SSO tab, then flag the option in the first section to Enable SSO with third-party software through a token. Then, type in a secret token hash of your choice and press Save Changes. Now you're ready to set up the WordPress app.
Remember that, according to the WordPress security standard, usernames cannot include spaces and special characters.
Managing the WordPress App Info in Docebo
To configure your WordPress app, access the Admin Menu from the gear icon. Then, find the WordPress section in the menu and press the Settings subitem. On this page, you will see all of the information provided by your platform that will be used for your plugin.
At the top of this page, you will see the link to download the plugin, in case you haven't done so already. The API Key, API Secret and SSO token will be used to configure this plugin. Now you can configure the plugin.
Configuring the Docebo Plugin for WordPress
Once the plugin is downloaded, log into your WordPress blog or website and access the Dashboard. Then, from the plugins menu on your dashboard, activate the Docebo plugin. Each menu item will allow you to configure the interaction between your WordPress blog and your Docebo platform. Let’s go through each item.
General Settings
First, choose which user scenario is right for you. If you want to keep your users in Docebo separate from WordPress, choose the first option. If you want to activate an SSO system that combines WordPress and Docebo login access, then choose the second option.
Now insert your Docebo platform address as well as the API Key, Secret Key and the SSO token displayed on the WordPress Settings page in your learning platform (please refer the section above to learn more about retrieving this info).
Log in
This box will enable your users to log in to your learning platform directly from a WordPress website without the SSO system. You can insert the login box in your WordPress page using the shortcode [docebo_login]
or by adding the Docebo Login widget. You can customize the block by adding a logo to your login box or, in case, to disable the usage of a logo (by default the plugin uses Docebo’s logo). You can also add a text below your logo if you would like to add instructions on login or simply use it for communication purposes. You can customize your login box by setting its dimensions and style or you can manually edit the CSS file in WordPress.
Single Sign-on
- Text link. You can add a link that will redirect your users to your learning platform directly in your WordPress page. To do so, use the following shortcode:
[docebo_sso_link text="YOUR LINK TEXT HERE"]
- SSO box. You can also display a box with your latest progress and available courses in the platform. Use the
[docebo_sso]
shortcode or the Docebo SSO Widget in WordPress. You can customize the box by adding a title and an intro text. You can also set the box width and height and the text for the SSO button and choose its position (left, center or right). In the box options, select whether you want to display courses in which the user is enrolled and the last attended course. In the Customize Your SSO section, you can change your text and colors, or you can manually edit the CSS file by clicking the link in WordPress.
My Courses
This function shows users in which courses they are currently enrolled. By clicking on each course, the user will then be redirected to the learning platform. You can use the [docebo_mycourses]
shortcode to view a complete list of the courses, indicating the block width and the number of courses to display. You can also add the My Courses widget from the learning platform to your page.
User Synchronization
This function will retrieve users from WordPress and add them to the Docebo Cloud, in the main platform root. The username and password will be retrieved and users already in Docebo Cloud will not be added. After the first synchronization, every user added in WordPress will be automatically created in your Docebo platform.