Media Migration is now able to transform media_filter
filter plugin tokens (Drupal 7 Media WYSIWYG module) to media_embed
(Drupal 8|9 core Media module) HTML tags (<drupal-media>
). To transform the media_filter
embed tokens to media_embed
HTML tags, Drupal core 8.8+ or 9 is required, and developers should define a Media Migration specific setting in the destination site's settings.php
:
$settings['media_migration_embed_token_transform_destination_filter_plugin'] = 'media_embed';
The possible values of this setting are entity_embed
and media_embed
. If the key is not defined or its value is not entity_embed
or media_embed
, then Media Migrate will assume that the destination filter plugin ID is entity_embed
. Please, don't forget that media_embed
filter plugin exists only in Drupal core >=8.8. If you use an older Drupal release, then this setting will be ignored and the destination plugin will be entity_embed
.
If the destination filter plugin ID is set to media_embed
, then the embed media reference method is ignored since the media_embed
filter only handles UUID-based references.
Transformed embed code with entity_embed
:
<drupal-entity
data-embed-button="media"
data-entity-embed-display="view_mode:media.full"
data-entity-type="media"
data-entity-id="312" # or data-entity-uuid="bbf8cd44-65f0-4078-9a4f-b529c6394f57
alt="Alt override"
title="Title copy override"
data-align="center"></drupal-entity>
Transformed embed code with media_embed
:
<drupal-media
data-entity-type="media"
data-entity-uuid="bbf8cd44-65f0-4078-9a4f-b529c6394f57"
data-view-mode="full"
alt="Alt override"
title="Title copy override"
data-align="center"></drupal-media>