glomex oEmbed

Description

This is a WordPress plugin that acts as a bridge between our oEmbed endpoint and internal WP oEmbed service. It allows simple oEmbed operation – just paste a link into (basically) any WordPress editor and it will automagically convert this link into glomex player/playlist/integration.

Installation and operation

Operation simple as follows:

1. Install plugin into WordPress
2. Activate plugin
3. Follow instructions and configure the plugin
4. Forge a URL from template: https://exchange.glomex.com/[video|videos|playlist|playlists]/VIDEO_OR_PLAYLIST_ID (integrationId parameter is optional)
5. Go to your post and paste the url into any editor (editor must support oEmbed)
6. You get an embedded player inside content!

This plugin is intended for internal and external usage. It only requires a glomex Exchange integration ID to operate.

Shortcodes

[glomex_integration]

You can use the shortcode [glomex_integration] to embed a player in your post.
Additional shortcode parameters (not required):
* playlist_id – ID of the playlist to embed
* integration_id – override default integration ID
* variant – player variant (default: ‘player-listicle’)
* width – player width in pixels (default: responsive width)
* height – player height in pixels (default: 16:9 aspect ratio)

Note: All shortcode attributes are properly sanitized for security.
If both width and height are not specified, the player will use responsive sizing with 16:9 aspect ratio.

URL

The supported url scheme is https://exchange.glomex.com/[video|videos|playlist|playlists]/VIDEO_OR_PLAYLIST_ID

The placeholder variables are:
* VIDEO_OR_PLAYLIST_ID (mandatory) – the element id to embed
* [video|videos|playlist|playlists] (mandatory) – select one item to embed – it should exist in your account and be accessible with the given integration ID

Allowed parameters:

• integrationId (optional) – allows overriding integration ID for this single embed
• includeStructuredData (optional) – allows overriding structured data inclusion for this single embed

Plugin settings are used by default in all cases. Query strings will override the setting.

Configuration options

You can set up the default integration ID using the GLOMEX_INTEGRATION_ID environment variable.

Custom script attributes

On the settings page you can add custom HTML data-* attributes to the glomex player script tags. This is useful for telling performance/optimization plugins to leave the player script alone – for example, add data-cfasync = false to exclude the script from Cloudflare Rocket Loader, or data-no-optimize = 1 to exclude it from WP Rocket. Only data-* attribute names are accepted; other names are ignored. When “Output general script?” is enabled, the attributes are applied to the single script loaded on every page; otherwise they are added to each embed’s inline script on a best-effort basis.