Embedding Packages

Shortcode

Basic usage

[smbr_player id="123"]

An alias is also available:

[slidemind_player id="123"]

Both shortcodes are functionally identical.

Attributes reference

Attribute	Description	Default	Values
`id`	Package ID (required)	`0`	Any valid package ID
`display`	Display mode	`inline`	`inline`, `overlay`, `newwindow`
`width`	Player width (inline mode)	`100%`	CSS value (e.g. `100%`, `800px`)
`height`	Player height (inline mode)	`600px`	CSS value
`trigger`	What opens the content (overlay/newwindow)	`button`	`button`, `image`, `link`
`button_text`	Custom button label	Package title	Any text
`button_size`	Button size	`normal`	`normal`, `small`, `large`
`button_style`	Button appearance	`filled`	`filled`, `outlined`
`show_fullscreen`	Show fullscreen button (inline mode)	`yes`	`yes`, `no`
`overlay_title`	Title shown in the overlay header	Package title	Any text
`overlay_width`	Overlay width	Global default	CSS value (e.g. `100%`, `900px`)
`overlay_height`	Overlay height	Global default	CSS value (e.g. `800px`)
`image`	Image URL for image trigger	—	URL
`link_text`	Link text for link trigger	—	Any text

Backward-compatible aliases

The following older attribute names are still supported but the overlay_* names are preferred:

Old name	New name
`lightbox_title`	`overlay_title`
`lightbox_width`	`overlay_width`
`lightbox_height`	`overlay_height`

If both old and new names are provided, the new name takes precedence.

Display mode aliases

These older display mode values are also accepted:

Old value	Maps to
`iframe`	`inline`
`lightbox`	`overlay`
`newtab`	`newwindow`

Examples

Inline with custom dimensions:

[smbr_player id="42" width="800px" height="500px"]

Inline without fullscreen button:

[smbr_player id="42" show_fullscreen="no"]

Overlay triggered by a button:

[smbr_player id="42" display="overlay" button_text="Start the module"]

Overlay triggered by an image:

[smbr_player id="42" display="overlay" trigger="image" image="https://example.com/thumbnail.jpg"]

Overlay with custom dimensions:

[smbr_player id="42" display="overlay" overlay_width="90%" overlay_height="700px" overlay_title="Safety Training"]

New window triggered by a link:

[smbr_player id="42" display="newwindow" trigger="link" link_text="Open in a new tab"]

Gutenberg block

Adding the block

In the block editor, click + to add a new block.
Search for SlideMind Player or browse the SlideMind category.
Select a package from the dropdown in the block toolbar.

The block inspector (right sidebar) exposes the following settings:

Setting	Panel	Description	Default
Package	Main	Select the package to display	—
Display mode	Display	`inline`, `overlay`, or `newwindow`	`inline`
Width	Display	Player width	`100%`
Height	Display	Player height	`600px`
Show fullscreen	Display	Toggle fullscreen button (inline only)	On
Trigger	Trigger	`button`, `image`, or `link` (overlay/newwindow only)	`button`
Button text	Trigger	Custom button label	Package title
Button size	Trigger	`normal`, `small`, or `large`	`normal`
Button style	Trigger	`filled` or `outlined`	`filled`
Image URL	Trigger	Image for image trigger	—
Link text	Trigger	Text for link trigger	—
Overlay title	Overlay	Title in the overlay header	Package title
Use global dimensions	Overlay	Use site-wide default overlay size	On
Overlay width	Overlay	Custom width (when global is off)	`100%`
Overlay height	Overlay	Custom height (when global is off)	`800px`

Tip: Settings that are not relevant to the selected display mode are automatically hidden. For example, trigger options only appear when the display mode is overlay or newwindow.

Editor preview

The block renders a server-side preview in the editor showing the package name and display mode. The actual SCORM/xAPI content does not load in the editor — it only runs on the frontend for logged-in users.

Display modes

Inline

The package loads directly in the page inside a sandboxed iframe.

Dimensions are controlled by the width and height attributes.
A fullscreen button appears in the top-right corner of the player (disable with show_fullscreen="no").
The iframe uses the following sandbox attributes: allow-scripts allow-same-origin allow-forms allow-popups allow-modals. Top navigation is not allowed.

Overlay

The package opens in a modal overlay on top of the page.

Triggers: a button, a clickable image, or a text link.
Dimensions: controlled by overlay_width and overlay_height. In the Gutenberg block, you can toggle “Use global dimensions” to inherit site-wide defaults.
Title: the overlay header displays the package title by default, or a custom title set with overlay_title.
The overlay includes a close button and a backdrop. Clicking outside the overlay closes it.

New window

The package opens in a new browser tab.

Triggers: a button, a clickable image, or a text link.
The content opens in a full-page launcher with the SCORM or xAPI runtime loaded.
No iframe sandboxing is applied in the new tab (the launcher page is nonce-protected).

Authentication and access

Login required — Learners must be logged in to WordPress to access package content. Unauthenticated users receive a 401 error.
Nonce-signed URLs — All launch URLs include a WordPress nonce for security. The nonce is generated when the shortcode or block renders and is verified on the server before serving content.
Iframe sandboxing — Inline and overlay iframes use sandbox="allow-scripts allow-same-origin allow-forms allow-popups allow-modals" to isolate uploaded content. Top-level navigation (allow-top-navigation) is intentionally excluded.

Next steps

Getting Started — Installation and first upload
Reports — Track learner progress and scores (Pro)
Administration — Package management, settings, LMS integration
FAQ & Troubleshooting — Common questions and solutions