Description
IBB partners show their courses on their own website with the Viona course list. This plugin replaces the copied embed code with a settings page, a block, an Elementor widget and a shortcode.
Viona is a service and a brand of IBB Institut für Berufliche Bildung AG. zirkel.design develops this plugin with IBB’s permission; you need a partner account with IBB to use it.
Features
- Block “Viona course list” (WordPress 7.0 or later) with selects for your filters and the start page, filled from your IBB partner account, plus scrolling and, where IBB shows them, hiding the Viona partner seal or the AI course advisor and a course page layout for that page
- Elementor widget “Viona course list” with the same selects as the block, optionally in the colours and font of your Elementor site
- WPBakery element “Viona course list” with the same choices
- Shortcode
[viona_courses]with the optional attributesfilter,route,scroll,seal="false",advisor="off",layout(standard,sidebarorcollapsible) andcss - Colours, corner radius and font of the list as settings, no CSS needed, or the text font of your block theme
- “Connect with Viona”: approve your website in the IBB partner portal, no hash or token to copy (needs HTTPS)
- Connection test that tells you when your website is not yet among the allowed domains and lets you ask IBB to add it, also under Tools → Site Health
- Views of the last 30 days on the dashboard
- Shows the course page layout you chose in the IBB partner portal, where IBB offers it
- Shows or hides the AI course advisor on all your pages, where IBB released it
- Sets the course page layout for all your pages, where IBB released it, and links to the look settings in the IBB partner portal
- Real addresses for every course and category below the page with the list, once IBB confirmed that page
- Takes over the settings of the older IBB VUC plugin; once you deactivate that plugin, its shortcodes
[ibb_vuc]and[vuc]keep working - Optional note with a button: the list loads only after a click
- Sets no cookies and tracks nothing on its own
External services
This plugin embeds the Viona course list, a service of IBB.
- In the visitor’s browser, the page loads the course list from the Viona whitelabel host (vuc.ibb.com by default): a script and the list itself in an iframe. The host receives the visitor’s IP address, browser details and the address of the page, as with any embedded content.
- In the browser of an editor, the block and the Elementor widget load a preview of the list from the same host, which receives the editor’s IP address.
- With the font of your theme or Elementor site switched on, the list loads it through the same host: Google fonts from Bunny Fonts, your own font files from your website. Visitors’ addresses do not reach either.
- From your website’s server, on your request or on the dashboard: with the button after the connection test, the plugin asks IBB to add your website to the allowed domains; for admins with an access token saved, the dashboard asks for the figures of the last 30 days (views, opened courses and opened flyers). Both send the same details as below and nothing about your visitors.
- From your website’s server, with an access token saved: on the settings page, in the block editor, for the connection test and once a day, the plugin asks the Viona embed API on the same host for the status of your access, your filters and list pages. It sends the access token, your website’s host name and the plugin version. It receives the name of your partner account, whether the list is active, whether your website is among the allowed domains, your filters and list pages, and the confirmed address for course URLs.
- When you click “Connect with Viona”, your browser opens the IBB partner portal on the same host with your website’s host name, the path of its address, whether it uses pretty permalinks, a random state, a check value derived from a secret kept on your server, and the plugin version. After you approve the website there, the portal sends your browser back to your website with a one-time code, and your website’s server sends that code and the secret to the Viona embed API and receives the access token, the name of your partner account and the name of the portal account that approved it.
- When you click “Disconnect”, “Discard” or delete the plugin, your website’s server tells the Viona embed API to revoke the access token.
- When you choose the page for course URLs, the plugin sends that page’s path (e.g.
/courses/) to the Viona embed API, for IBB to confirm.
Terms: https://www.ibb.com/impressum
Privacy policy: https://www.ibb.com/datenschutz
Installation
- Upload the
course-embed-for-vionafolder to/wp-content/plugins/and activate the plugin. - Open Settings → Viona course list and click “Connect with Viona”. Approve your website in the IBB partner portal with your login and activate the access back on the settings page.
- Alternatively, enter the partner hash and the access token from IBB and run the connection test.
- Add the block “Viona course list” or the shortcode
[viona_courses]to the page that should show the courses.
The access token can also be set in wp-config.php:
define('VIONA_EMBED_TOKEN', 'viona_...');
FAQ
Do I need an access token?
No. The course list shows with the partner hash alone. The token lets the plugin check the connection and offer your filters and list pages in the block.
The list stays empty. Why?
Browsers only show the list on websites IBB has allowed for your partner account. Run the connection test on the settings page; it tells you if your website is missing.
Can I set the values in code?
Yes. The filter viona_embed_settings receives the saved settings and may change them, for example to read the partner hash from an environment variable. The settings page shows which values come from code.
How do the course URLs work?
Course URLs are a feature IBB releases for each partner account; the settings show them once IBB did. Choose the page with the list under Settings → Viona course list → Course URLs. The plugin proposes its address to IBB; once IBB confirmed it, every course and category opens at its own address below that page, e.g. /courses/course-for-x/123-title/, instead of /courses/#/.... Old links with # keep working and are rewritten. IBB decides whether search engines may index these addresses; if not, they carry noindex and point to the page with the list as canonical, for WordPress, Rank Math and Yoast SEO. The filter viona_embed_rewrite_rules receives the rewrite rules for the page and may change them. Pretty permalinks are required.
Does it work with Elementor?
Yes. Add the widget “Viona course list” and choose the filter and start page; with an access token saved, the selects list those of your partner account. The editor shows a preview of the list; the start page and scrolling show on the published page. The shortcode works in Elementor’s Shortcode and Text Editor widgets as well.
Does a cookie banner or a caching plugin block the list?
The plugin sets no cookies. Whether visitors must agree before the list loads is up to your privacy policy; the list is a service of IBB. If they must, switch on “Load the list only after a click” in the settings: visitors then see a note and a button, and nothing comes from IBB before they click. The click is kept in the browser’s sessionStorage until the tab is closed, without any identifier; mention this in your privacy policy. The list’s frame is built in the browser by the Viona script, so content blockers that look for iframes in the page’s HTML (e.g. Borlabs Cookie, Real Cookie Banner) do not see one. If your banner blocks scripts from unknown hosts, allow the Viona host (vuc.ibb.com by default). Caching and optimisation plugins may combine or delay scripts: if the list stays empty, exclude iframe_parent.min.js and the inline script with CourseFrameObject from delaying and combining.
Can I show two lists on one page?
No, one list per page. Use one page per topic instead, each with its own filter.
Screenshots




Changelog
0.7.1
- Changed: the course page layout and the AI course advisor switch are now with the other settings on the settings page
- Fixed: the course page layout select no longer widens the settings page
0.7.0
- Added: choose the course page layout for all pages in the plugin settings, once IBB has released it for you
- Added: option to show another course page layout on a single page, in the block, Elementor, WPBakery and the shortcode (
layout="sidebar") - Added: link to the look settings of your course list in the IBB partner portal
0.6.0
- Added: switch to show or hide the AI course advisor on all pages, once IBB has released it for you
- Added: option to hide the AI course advisor on a single page, in the block, Elementor, WPBakery and the shortcode (
advisor="off")
0.5.1
- Fixed: the connection buttons sit in their own box above the settings, so clicking them never saves the settings form
- Improved: after disconnecting, the notice says when the course list needs the partner hash to show
0.5.0
- Added: “Connect with Viona” to set up the access with your IBB partner portal login, nothing to copy
- Added: button to disconnect the website, and the access is given back when you delete the plugin
- Changed: the dashboard shows views only; course requests are in the IBB partner portal
- Added: note on the settings page while IBB has not added your website yet
0.4.2
- Added: link to the partner portal under your figures, if you have an account there
- Removed: reminder about expiring access tokens, as tokens renew themselves while in use
0.4.1
- Added: reminder before your access token expires
- Added: notice when a page uses a filter that no longer exists
- Added: message on the page when the list cannot load
- Added: button to ask IBB to add your website
- Added: your figures of the last 30 days on the dashboard
0.4.0
- Added: WPBakery element
- Added: preview of the list in the block and the Elementor widget
- Added: the list can use the font of your theme, and the colours and font of your Elementor site
- Added: optional button, so the list loads only after a click
- Added: notice when your access token no longer works
- Improved: moving from the IBB VUC plugin takes one click
0.3.4
- Improved: the connection test checks what you typed, before you save
- Improved: the save button stays in view on the settings page
- Changed: the Viona server is no longer a setting; it can still be set in code with the filter
viona_embed_settings
0.3.3
- Changed: the older IBB VUC plugin is no longer deactivated on activation; a notice asks you to deactivate it
- Changed: the Viona server is set only in the settings, no longer in a shortcode
- Changed: course URLs below the chosen page open the page as soon as you choose it; the list uses them once IBB confirmed the page
0.3.2
- Changed: package details tidied up
0.3.1
- Changed: the description names IBB as the provider of Viona
0.3.0
- Added: Elementor widget with selects for filter and start page, scrolling and the partner seal
- Added: check under Tools → Site Health whether the list shows on your website
- Added: the course page layout chosen in the IBB partner portal shows in the settings
0.2.0
- Changed: new name, Course Embed for Viona
- Added: notes for Elementor, cookie banners and caching plugins
0.1.0
- First version: block, shortcode, settings, connection test, takeover of the IBB VUC plugin
- Added: real course URLs below the page with the list, once IBB confirmed it
- Added: scrolling and hiding the Viona partner seal in the block
