Embera

What this module does

This module is actually just a wrapper of the great Embera PHP library developed by Michael Pratt.

Copying from the library's GitHub description:

A Oembed consumer library, that gives you information about urls. It helps you replace urls to youtube or vimeo for example, with their html embed code. It has advanced features like offline support, responsive embeds and caching support.

By installing this module you get the Embera PHP library installed in you /vendor/ folder.
As a bonus, you also get a Drupal service embera.manager which uses Embera's file cache for storing responses (configurable via embera.file_cache.duration setting).

The service also provides the following methods:
- getThumbnailUrl(): Returns the URL of the thumbnail of the item
- getTitle(): Returns the title of the item.
- getEmbedCode(): Returns the embed code of the item.
- getEmbedInformation(): Returns the full response retrieved from the oEmbed provider via Embera.

The methods above also use static caching of the response (regardless of the file caching) for optimized performance in the same request.

Embera class' configuration

The configuration of the Embera class is easily modified by the embera.class.configuration setting. Check the Passing configuration options section of the documentation to check which options are supported.

Regarding the file cache, the responses get cached for 3600 seconds by default. You may modify the number of seconds by setting the embera.file_cache.duration to your desired value.

If for any reason, you want to disable the file cache completely, please set the embera.file.cache.disabled setting to TRUE.

PS: This module is destined to be used by module developers. You shouldn't install it unless you intend to use its service or another module requires it as a dependency.