Media Entity Calameo

Provides integration of Calameo publications with the Drupal core Media module.

Installation

1. Enable the core Media module (if not already enabled).
2. Enable the Media Entity Calameo module.
3. Go to /admin/config/media/media_entity_calameo and add your API Key and API Secret Key from Calameo Developer.
4. Go to /admin/structure/media and click 'Add media bundle' to create a new bundle.
5. In the field Type provider, select Calameo.

Configuration

1. Go to the Manage display section for your Calameo media bundle.
2. For the source field, select Calameo embed under Format.
3. Click on the settings icon to configure:
   • Width: iframe width in pixels (default: 480)
   • Height: iframe height in pixels (default: 640)
   • Mode: Automatic, Viewer, or Mini
   • View: Automatic, Book, Slide, or Scroll
4. Enable Force domain if you encounter X-Frame-Origin errors (e.g., HTTP xframe-neterror-page).
5. Save.

Usage

When creating or editing content with a media field:

1. Click Add media.
2. Select your Calameo media bundle.
3. Enter either:
   • The Calameo publication ID (shortcode, e.g., 123abc456)
   • Or the full Calameo URL (e.g., https://calameo.com/read/123abc456)

The module will automatically extract the publication ID from URLs and generate the embed iframe using Calameo's official URL (//v.calameo.com/).

Maintainers

• tsymi
• macsim