Issuu Embed Filter

The Issuu Embed Filter module provides a lightweight text filter for embedding
Issuu publications in Drupal content.

Content editors can insert an Issuu publication using a simple shortcode:

`[issuu=document_identifier]`

The filter converts the shortcode into a responsive Issuu iframe. The Issuu
username is configurable independently for each text format.

## Features

- Embeds Issuu publications using a simple shortcode.
- Provides a configurable Issuu username for each text format.
- Generates responsive iframe markup.
- Generates accessible iframe titles from document identifiers.
- Supports Drupal 10 and Drupal 11.
- Has no contributed module dependencies.
- Does not require editors to paste iframe or JavaScript code.

## Requirements

This module requires the Drupal core Filter module.

No third-party PHP libraries are required.

An Issuu account and published Issuu documents are required to display
publications.

## Installation

Install the module using Composer:

`composer require drupal/issuu_embed`

Enable the module through the Extend administration page or with Drush:

`drush en issuu_embed`

## Configuration

1. Go to Configuration > Content authoring > Text formats and editors.
2. Edit the text format that should support Issuu embeds.
3. Enable the Issuu embed filter.
4. Enter the Issuu username that owns the publications.
5. Save the text format.

## Usage

Add the following shortcode to formatted content:

`[issuu=summer_guide_2026]`

Replace `summer_guide_2026` with the Issuu document identifier.

## Similar projects and differences

- [Issuu Viewer](https://www.drupal.org/project/issuu_viewer) provides a
dedicated field type for Issuu documents. Issuu Embed Filter works inside
formatted text through Drupal's text filter system.
- [Media Entity Issuu](https://www.drupal.org/project/media_entity_issuu)
integrates Issuu publications with Drupal Media entities. Issuu Embed Filter
does not create entities and is intended for lightweight shortcode-based
embedding.
- [Issuu integration](https://www.drupal.org/project/issuu) provides older API,
upload, field, and media integrations. Issuu Embed Filter focuses only on
embedding existing publications in Drupal 10 and Drupal 11 content.