class MenuLinkParent in Drupal 9
Same name and namespace in other branches
- 8 core/modules/migrate/src/Plugin/migrate/process/MenuLinkParent.php \Drupal\migrate\Plugin\migrate\process\MenuLinkParent
Determines the parent of a menu link.
Menu link item belongs to a menu such as 'Navigation' or 'Administration'. Menu link item also has a parent item unless it is the root element of the menu.
This process plugin determines the parent item of a menu link. If the parent item can't be determined by ID, we try to determine it by a combination of menu name and parent link path.
The source is an array of three values:
- parent_id: The numeric ID of the parent menu link, or 0 if the link is the root element of the menu.
- menu_name: The name of the menu the menu link item belongs to.
- parent_link_path: The Drupal path or external URL the parent of this menu link points to.
Example:
process:
parent:
plugin: menu_link_parent
source:
- plid
- menu_name
- parent_link_path
In this example, first look for a menu link that had an ID defined by 'plid' in the source (e.g., '20'). If that fails, try to determine the parent by a combination of a menu name (e.g., 'management') and a parent menu link path (e.g., 'admin/structure').
Plugin annotation
@MigrateProcessPlugin(
id = "menu_link_parent"
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\migrate\ProcessPluginBase implements MigrateProcessInterface
- class \Drupal\migrate\Plugin\migrate\process\MenuLinkParent implements ContainerFactoryPluginInterface
- class \Drupal\migrate\ProcessPluginBase implements MigrateProcessInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of MenuLinkParent
See also
https://www.drupal.org/docs/8/api/menu-api
\Drupal\migrate\Plugin\MigrateProcessInterface
1 file declares its use of MenuLinkParent
- MenuLinkParentTest.php in core/
modules/ migrate/ tests/ src/ Unit/ process/ MenuLinkParentTest.php
File
- core/
modules/ migrate/ src/ Plugin/ migrate/ process/ MenuLinkParent.php, line 59
Namespace
Drupal\migrate\Plugin\migrate\processView source
class MenuLinkParent extends ProcessPluginBase implements ContainerFactoryPluginInterface {
/**
* The menu link plugin manager.
*
* @var \Drupal\Core\Menu\MenuLinkManagerInterface
*/
protected $menuLinkManager;
/**
* The currently running migration.
*
* @var \Drupal\migrate\Plugin\MigrationInterface
*/
protected $migration;
/**
* The migrate lookup service.
*
* @var \Drupal\migrate\MigrateLookupInterface
*/
protected $migrateLookup;
/**
* The menu link entity storage handler.
*
* @var \Drupal\Core\Entity\EntityStorageInterface
*/
protected $menuLinkStorage;
/**
* Constructs a MenuLinkParent object.
*
* @param array $configuration
* A configuration array containing information about the plugin instance.
* @param string $plugin_id
* The plugin_id for the plugin instance.
* @param mixed $plugin_definition
* The plugin implementation definition.
* @param \Drupal\migrate\MigrateLookupInterface $migrate_lookup
* The migrate lookup service.
* @param \Drupal\Core\Menu\MenuLinkManagerInterface $menu_link_manager
* The menu link manager.
* @param \Drupal\Core\Entity\EntityStorageInterface $menu_link_storage
* The menu link storage object.
* @param \Drupal\migrate\Plugin\MigrationInterface $migration
* The currently running migration.
*/
public function __construct(array $configuration, $plugin_id, $plugin_definition, MigrateLookupInterface $migrate_lookup, MenuLinkManagerInterface $menu_link_manager, EntityStorageInterface $menu_link_storage, MigrationInterface $migration) {
parent::__construct($configuration, $plugin_id, $plugin_definition);
$this->migration = $migration;
$this->migrateLookup = $migrate_lookup;
$this->menuLinkManager = $menu_link_manager;
$this->menuLinkStorage = $menu_link_storage;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition, MigrationInterface $migration = NULL) {
return new static($configuration, $plugin_id, $plugin_definition, $container
->get('migrate.lookup'), $container
->get('plugin.manager.menu.link'), $container
->get('entity_type.manager')
->getStorage('menu_link_content'), $migration);
}
/**
* {@inheritdoc}
*
* Find the parent link GUID.
*/
public function transform($value, MigrateExecutableInterface $migrate_executable, Row $row, $destination_property) {
$parent_id = array_shift($value);
// Handle root elements of a menu.
if (!$parent_id) {
return '';
}
$lookup_result = $this->migrateLookup
->lookup($this->migration
->id(), [
$parent_id,
]);
if ($lookup_result) {
$already_migrated_id = $lookup_result[0]['id'];
}
if (!empty($already_migrated_id) && ($link = $this->menuLinkStorage
->load($already_migrated_id))) {
return $link
->getPluginId();
}
// Parent could not be determined by ID, so we try to determine by the
// combination of the menu name and parent link path.
if (isset($value[1])) {
[
$menu_name,
$parent_link_path,
] = $value;
// If the parent link path is external, URL will be useless because the
// link will definitely not correspond to a Drupal route.
if (UrlHelper::isExternal($parent_link_path)) {
$links = $this->menuLinkStorage
->loadByProperties([
'menu_name' => $menu_name,
'link.uri' => $parent_link_path,
]);
}
else {
$url = Url::fromUserInput('/' . ltrim($parent_link_path, '/'));
if ($url
->isRouted()) {
$links = $this->menuLinkManager
->loadLinksByRoute($url
->getRouteName(), $url
->getRouteParameters(), $menu_name);
}
}
if (!empty($links)) {
return reset($links)
->getPluginId();
}
}
// Parent could not be determined.
throw new MigrateSkipRowException(sprintf("No parent link found for plid '%d' in menu '%s'.", $parent_id, $value[0]));
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
public | function | 2 | |
DependencySerializationTrait:: |
public | function | 2 | |
MenuLinkParent:: |
protected | property | The menu link plugin manager. | |
MenuLinkParent:: |
protected | property | The menu link entity storage handler. | |
MenuLinkParent:: |
protected | property | The migrate lookup service. | |
MenuLinkParent:: |
protected | property | The currently running migration. | |
MenuLinkParent:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
|
MenuLinkParent:: |
public | function |
Find the parent link GUID. Overrides ProcessPluginBase:: |
|
MenuLinkParent:: |
public | function |
Constructs a MenuLinkParent object. Overrides PluginBase:: |
|
MessengerTrait:: |
protected | property | The messenger. | 27 |
MessengerTrait:: |
public | function | Gets the messenger. | 27 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
2 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
ProcessPluginBase:: |
public | function |
Indicates whether the returned value requires multiple handling. Overrides MigrateProcessInterface:: |
3 |
StringTranslationTrait:: |
protected | property | The string translation service. | 4 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |