Embed share

The basic functionality of this shortcode is to print an iframe in the page with some additional functionality.

Default aspect ratio of the resulting iframe is 16/9 (16 points in width, 9 in height) and can be customized to any value, e.g. 4/3, 20/5 or even portrait versions of 3/4, 9/16 or a square 1/1. Invalid ratios are ignored and 16/9 is used instead (i.e. ratios with zero or a text)

Optionally a button can be appended to the iframe. Once a user clicks the button they are presented with a popup where they can copy the iframe code (e.g. for use on their pages:)

Optionally a link can be appended to the iframe. A new window with the iframe contents will be opened upon the link click:

PageBuilder widget

There is a page builder widget that comes with the shortcode for an easier use.

The setup for the above example can be seen on the following image:

Shortcode

Name: [skoda-embed-share url=„…“]

URL attribute is required and should be a valid URL or a relative URL on the current domain, e.g. https://google.com or /en/interesting-page/

Hiding iframe for unsupported resolutions

As of August 2018 it is possible to hide the embed when it becomes smaller than the resolution it can support. Instead a message will be shown to the user:

You can use this option by specifying a shortcode attribute or using the widget Embed Share and putting the number in the following field:

Optional attributes

Underlined values are defaults

  • ratio: a decimal value of the width vs height ratio. Can be supplied as two numbers width/height, i.e. 16/9, 3/4, or just 1.5
  • button: [ true | false ] Whether or not to print the embed button
  • new-window [ true | false | Some text ] Whether or not to print the link which opens the iframe in a new window. If you supply a custom text, it will be used instead of the default „Open in a new window“ text
  • hide-below [ number ] When this attribute is used, the iframe will be hidden when it becomes smaller than the specified number (size is in pixels)