tv2regionerne/statamic-iframely

There is no license information available for the latest version (v1.2.0) of this package.

v1.2.0 2024-06-18 19:09 UTC

This package is auto-updated.

Last update: 2024-11-18 20:04:58 UTC


README

Statamic Iframely is a Statamic addon that enables integration with Iframely API.
Be aware that Iframely requires a paid subscription.

Features

Iframely is a uniform delivery service for all your various rich media embeds and URL data.
This addon provides a tag for easy embedding for social media and most websites.
The tag has a built in caching mechanism, to speed up requests and limit the API requests on Iframely.

How to Install

Run the following command from your project root:

composer require tv2regionerne/statamic-iframely

Publish the config

php artisan vendor:publish --tag statamic-iframely-config

Add your API key to your ENV and optionally adjust the cache configuration

IFRAMELY_API_KEY="Your API Key"
IFRAMELY_CACHE_ENABLED=true
IFRAMELY_CACHE_FOR="1 hour"

Please follow the documentation on the Iframely website on scripts and styles: https://iframely.com/docs/omit-script
https://iframely.com/docs/omit-css

The parameters omit_script and omit_css are enabled by default. You may change this through the parameters:

{{ iframely url="your url here" omit_script="0" omit_css="0" }}

How to Use

Update the config to enable private API's. Use the iframely antlers tag. The url parameter is required.

{{ iframely url="your url here" }}

There's a bunch of optional parameters which will be passed into the Iframely API call.
See the documentation for the below parameters on https://iframely.com/docs/iframely-api/

  • iframe
  • id
  • omit_script
  • omit_css
  • import
  • align
  • lazy
  • playerjs
  • click_to_play
  • consent
  • theme
  • language
  • ssl
  • media
  • autoplay
  • maxwidth
  • maxheight
  • origin
  • title