June 05, 2024

glomex oEmbed Plugin

Wordpress plugin that acts as a bridge between our oEmbed endpoint and internal WP oEmbed service.

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:

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

This plugin is intended for internal and external usage. There is no dependency on our infrastructure.

Shortcodes

[glomex_integration]

You can use the shortcode [glomex_integration] to embed a player in your post.
Additional shortcode parameters (not required): playlist_id, integration_id, variant, width, height.

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.

Installation

Uploading in WordPress Dashboard

Navigate to the ‘Add New’ in the plugins dashboard
Navigate to the ‘Upload’ area
Select the plugin archive from your computer
Click ‘Install Now’
Activate the plugin in the Plugin dashboard

Using FTP

Download plugin archive
Extract the archive to your computer
Upload the plugin directory to the plugins directory (it is usually /wp-content/plugins/ but sometimes it may vary)
Activate the plugin in the Plugin dashboard

FAQ

Which features do I need on my server?

You need at least WP 5.3.14, PHP 7.4 and curl extension enabled.

What do I need to operate the plugin?

You need to configure the plugin. There are only 2 options at the moment – integration ID and structured data configuration.
You need an account at glomex Exchange.

Where do I get my integration ID?

You need to navigate to your account at glomex Exchange.
Go to Manage => Players
Select one and copy Configuration ID
Paste the ID into the field on site or use to forge a link

Can I use more than one integration ID on the site?

Yes you can. You can have one “basic” integration ID in your plugin configuration and any amount of integration IDs
for embedded player.

What is a Structured data?

Structured data allows you to have more search-engine friendly site. In case of our plugin this means that results from
your site may appear as “Video” in Google search results. We provide a JSON-LD structured data for you. Read more on
JSON-LD.

Changelog

0.9.1

created glomex_integration shortcode to embed a player in your post

0.9.0

created functionality for the prefixing video ID in the URL
updated/tested with WP 6.4.3

0.8.5

updated vendor requirements

0.8.4

removed internal update checker
renamed functions/namespaces/constants names with new prefix

0.8.3

updated vendor requirements

0.8.2

fixed the problem with embedding URL decoding in popular page builders

0.8.1

fixed the problem with embedding URL decoding in older WP versions

0.8

fix files headers
fix grumphp config
refactor main oEmbed code to be better quality
implement custom codestyle based on CodeatCS

0.7

Use 2 different vendor directories and composer files

0.6

Load only single glomex-player.js on frontend

0.5.5

Bugfix in oEmbed URL generation function

0.5.4

Update documentation

0.5.3

Implemented update checker with support for Github repo

0.5.0

Initial release with basic functions