tv2regionerne / statamic-iframely
Requires
- statamic/cms: ^4.0 || ^5.0
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