Change record status: 
Project: 
Introduced in branch: 
8.x-1.x
Introduced in version: 
8.x-1.0-alpha2
Description: 

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>
Impacts: 
Site builders, administrators, editors
Module developers
Updates Done (doc team, etc.)
Online documentation: 
Not done
Theming guide: 
Not done
Module developer documentation: 
Not done
Examples project: 
Not done
Coder Review: 
Not done
Coder Upgrade: 
Not done
Other: 
Other updates done
Details: