Embedder enables embedding in content fields area similar to how embeds work in WordPress, and can embed media from pasted links and HTML code.
- SilverStripe 3.1
Drop the module into your SilverStripe project and run /dev/build
Embedder must be activated in your project _config.php. This is done by registering which fields on which pagetypes Embedder should work. The following example would enable Embedder on the "Content" field on pages of the "Page" type:
Embedder::getInstance()->registerField("Page","Content");
The following example would enable Embedder on the "Intro" field on all page types:
Embedder::getInstance()->registerField("*","Intro");
Add the following to set the width of media embedded from links:
Embedder::getInstance()->setWidth(600);
The following methods are included to control embed size:
- setWidth([int])
- setHeight([int])
- setMaxWidth([int])
- setMaxHeight([int])
Sizes will be calculated with aspect ratio maintained.
Several pre-packaged providers (content sites) are included. They must be separately registered as such:
Embedder::getInstance()->registerProvider("Youtube");
The following providers are included:
- Flickr
- Viddler
- Vimeo
- Youtube
You can easily add more custom providers that conform to the oEmbed specification. Simply copy one of the included provider classes to your project directory and modify it to suit your needs, then run /dev/build to register the provider class with SilverStripe and enable it in your _config.php. See the oEmbed website for more information.
Embedder can also render pasted HTML code based on tag names:
Embedder::getInstance()->registerTags(array("object","iframe","embed"));
This registers <object>, <iframe> and <embed>-tags to be rendered as objects instead of HTML entities. For example, if the following code is pasted in an Embedder-enabled field it will be rendered as an iframe:
<iframe width="640" height="390"
src="http://www.youtube.com/embed/dQw4w9WgXcQ"
frameborder="0" allowfullscreen></iframe>