Same name and namespace in other branches
  1. 8.x-1.x src/EntityClone/Content/ContentEntityCloneFormBase.php \Drupal\entity_clone\EntityClone\Content\ContentEntityCloneFormBase 1 comment

Class Content Entity Clone Form Base.

Hierarchy

Expanded class hierarchy of ContentEntityCloneFormBase

1 file declares its use of ContentEntityCloneFormBase
entity_clone.module in ./entity_clone.module
Contains entity_clone.module.

File

src/EntityClone/Content/ContentEntityCloneFormBase.php, line 23

Namespace

Drupal\entity_clone\EntityClone\Content
View source
class ContentEntityCloneFormBase implements EntityHandlerInterface, EntityCloneFormInterface {
    
    /**
     * The entity type manager.
     *
     * @var \Drupal\Core\StringTranslation\TranslationManager
     */
    protected $translationManager;
    
    /**
     * The entity type manager service.
     *
     * @var \Drupal\Core\Entity\EntityTypeManager
     */
    protected $entityTypeManager;
    
    /**
     * The entity clone settings manager service.
     *
     * @var \Drupal\entity_clone\EntityCloneSettingsManager
     */
    protected $entityCloneSettingsManager;
    
    /**
     * Entities we've found while cloning.
     *
     * @var \Drupal\Core\Entity\ContentEntityInterface[]
     */
    protected $discoveredEntities = [];
    
    /**
     * Constructs a new ContentEntityCloneFormBase.
     *
     * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
     *   The entity type manager.
     * @param \Drupal\Core\StringTranslation\TranslationManager $translation_manager
     *   The string translation manager.
     * @param \Drupal\entity_clone\EntityCloneSettingsManager $entity_clone_settings_manager
     *   The entity clone settings manager.
     */
    public function __construct(EntityTypeManagerInterface $entity_type_manager, TranslationManager $translation_manager, EntityCloneSettingsManager $entity_clone_settings_manager) {
        $this->entityTypeManager = $entity_type_manager;
        $this->translationManager = $translation_manager;
        $this->entityCloneSettingsManager = $entity_clone_settings_manager;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function createInstance(ContainerInterface $container, EntityTypeInterface $entity_type) {
        return new static($container->get('entity_type.manager'), $container->get('string_translation'), $container->get('entity_clone.settings.manager'));
    }
    
    /**
     * {@inheritdoc}
     */
    public function formElement(EntityInterface $entity, $parent = TRUE, &$discovered_entities = []) {
        $form = [
            'recursive' => [],
        ];
        if ($entity instanceof FieldableEntityInterface) {
            $discovered_entities[$entity->getEntityTypeId()][$entity->id()] = $entity;
            foreach ($entity->getFieldDefinitions() as $field_id => $field_definition) {
                if ($field_definition instanceof FieldConfigInterface && in_array($field_definition->getType(), [
                    'entity_reference',
                    'entity_reference_revisions',
                ], TRUE)) {
                    $field = $entity->get($field_id);
                    
                    /** @var \Drupal\Core\Field\Plugin\Field\FieldType\EntityReferenceItem $value */
                    if ($field->count() > 0 && $this->entityTypeManager
                        ->getStorage($field->getSetting('target_type')) instanceof ContentEntityStorageInterface) {
                        $form['recursive'] = array_merge($form['recursive'], $this->getRecursiveFormElement($field_definition, $field_id, $field, $discovered_entities));
                    }
                }
            }
            if ($parent) {
                $form = array_merge([
                    'description' => [
                        '#markup' => $this->getFormDescription($form, $entity),
                        '#access' => TRUE,
                    ],
                ], $form);
            }
        }
        return $form;
    }
    
    /**
     * Get the recursive form element.
     *
     * @param \Drupal\Core\Field\FieldConfigInterface $field_definition
     *   The field definition.
     * @param string $field_id
     *   The field ID.
     * @param \Drupal\Core\Field\FieldItemListInterface $field
     *   The field item.
     * @param array $discovered_entities
     *   List of all entities already discovered.
     *
     * @return array
     *   The form element for a recursive clone.
     */
    protected function getRecursiveFormElement(FieldConfigInterface $field_definition, $field_id, FieldItemListInterface $field, array &$discovered_entities) {
        $form_element = [
            '#tree' => TRUE,
        ];
        $fieldset_access = !$this->entityCloneSettingsManager
            ->getHiddenValue($field_definition->getFieldStorageDefinition()
            ->getSetting('target_type'));
        $form_element[$field_definition->id()] = [
            '#type' => 'fieldset',
            '#title' => $this->translationManager
                ->translate('Entities referenced by field <em>@label (@field_id)</em>.', [
                '@label' => $field_definition->label(),
                '@field_id' => $field_id,
            ]),
            '#access' => $fieldset_access,
            '#description_should_be_shown' => $fieldset_access,
        ];
        foreach ($field as $value) {
            // Check if we're not dealing with an entity
            // That has been deleted in the meantime.
            if (!($referenced_entity = $value->get('entity')
                ->getTarget())) {
                continue;
            }
            
            /** @var \Drupal\Core\Entity\ContentEntityInterface $referenced_entity */
            $referenced_entity = $value->get('entity')
                ->getTarget()
                ->getValue();
            if (isset($discovered_entities[$referenced_entity->getEntityTypeId()]) && array_key_exists($referenced_entity->id(), $discovered_entities[$referenced_entity->getEntityTypeId()])) {
                $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['is_circular'] = [
                    '#type' => 'hidden',
                    '#value' => TRUE,
                ];
                $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['circular'] = [
                    '#type' => 'item',
                    '#markup' => $this->translationManager
                        ->translate('Circular reference detected'),
                ];
            }
            else {
                $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['clone'] = [
                    '#type' => 'checkbox',
                    '#title' => $this->translationManager
                        ->translate('Clone entity <strong>ID:</strong> <em>@entity_id</em>, <strong>Type:</strong> <em>@entity_type - @bundle</em>, <strong>Label:</strong> <em>@entity_label</em>', [
                        '@entity_id' => $referenced_entity->id(),
                        '@entity_type' => $referenced_entity->getEntityTypeId(),
                        '@bundle' => $referenced_entity->bundle(),
                        '@entity_label' => $referenced_entity->label(),
                    ]),
                    '#default_value' => $this->entityCloneSettingsManager
                        ->getDefaultValue($referenced_entity->getEntityTypeId()),
                    '#access' => $referenced_entity->access('view label'),
                ];
                if ($this->entityCloneSettingsManager
                    ->getDisableValue($referenced_entity->getEntityTypeId())) {
                    $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['clone']['#attributes'] = [
                        'disabled' => TRUE,
                    ];
                    $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['clone']['#value'] = $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['clone']['#default_value'];
                }
                $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['target_entity_type_id'] = [
                    '#type' => 'hidden',
                    '#value' => $referenced_entity->getEntityTypeId(),
                ];
                $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['target_bundle'] = [
                    '#type' => 'hidden',
                    '#value' => $referenced_entity->bundle(),
                ];
                if ($referenced_entity instanceof ContentEntityInterface) {
                    $form_element[$field_definition->id()]['references'][$referenced_entity->id()]['children'] = $this->getChildren($referenced_entity, $discovered_entities);
                }
            }
        }
        return $form_element;
    }
    
    /**
     * Fetches clonable children from a field.
     *
     * @param \Drupal\Core\Entity\ContentEntityInterface $referenced_entity
     *   The field item list.
     * @param array $discovered_entities
     *   List of all entities already discovered.
     *
     * @return array
     *   The list of children.
     */
    protected function getChildren(ContentEntityInterface $referenced_entity, array &$discovered_entities) {
        
        /** @var \Drupal\entity_clone\EntityClone\EntityCloneFormInterface $entity_clone_handler */
        if ($this->entityTypeManager
            ->hasHandler($referenced_entity->getEntityTypeId(), 'entity_clone_form')) {
            // Record that we've found this entity.
            $discovered_entities[$referenced_entity->getEntityTypeId()][$referenced_entity->id()] = $referenced_entity;
            $entity_clone_form_handler = $this->entityTypeManager
                ->getHandler($referenced_entity->getEntityTypeId(), 'entity_clone_form');
            return $entity_clone_form_handler->formElement($referenced_entity, FALSE, $discovered_entities);
        }
        return [];
    }
    
    /**
     * {@inheritdoc}
     */
    public function getValues(FormStateInterface $form_state) {
        return $form_state->getValues();
    }
    
    /**
     * Get the clone form confirmation page description.
     *
     * If there are no recursive elements visible, the default description should
     * be shown.
     *
     * @param array $form
     *   The clone form.
     * @param \Drupal\Core\Entity\EntityInterface $entity
     *   The entity.
     *
     * @return \Drupal\Core\StringTranslation\TranslatableMarkup
     *   Description to be shown
     */
    protected function getFormDescription(array $form, EntityInterface $entity) {
        $has_recursive = FALSE;
        $elements_visible = FALSE;
        if (isset($form['recursive'])) {
            $has_recursive = TRUE;
        }
        array_walk_recursive($form['recursive'], function ($item, $key) use (&$elements_visible) {
            if ($key === '#description_should_be_shown') {
                $elements_visible = $elements_visible || $item;
            }
        });
        if ($has_recursive && $elements_visible) {
            return $this->translationManager
                ->translate("\n            <p>Specify the child entities (the entities referenced by this entity) that should also be cloned as part of\n            the cloning process. If they're not included, these fields' referenced entities will be the same as in the\n            original.  In other words, fields in both the original entity and the cloned entity will refer to the same\n            referenced entity. Examples:</p>\n\n            <p>If you have a Paragraph field in your entity, and you choose not to clone it here, deleting the original\n            or cloned entity will also delete the Paragraph field from the other one. So you probably want to clone\n            Paragraph fields.</p>\n\n            <p>However, if you have a User reference field, you probably don't want to clone it here because a new User\n            will be created for referencing by the clone.</p>\n\n            <p>Some options may be disabled here, preventing you from changing them, as set by your administrator. Some\n            options may also be missing, hidden by your administrator, forcing you to clone with the default settings.\n            It's possible that there are no options here for you at all, or none need to be set, in which case you may\n            simply hit the <em>Clone</em> button.</p>\n          ");
        }
        else {
            return $this->translationManager
                ->translate("<p>Do you want to clone the <em>@type</em> entity named <em>@title</em>?</p>", [
                "@type" => $entity->getEntityType()
                    ->getLabel(),
                "@title" => $entity->label(),
            ]);
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
ContentEntityCloneFormBase::$discoveredEntities protected property Entities we've found while cloning.
ContentEntityCloneFormBase::$entityCloneSettingsManager protected property The entity clone settings manager service.
ContentEntityCloneFormBase::$entityTypeManager protected property The entity type manager service.
ContentEntityCloneFormBase::$translationManager protected property The entity type manager.
ContentEntityCloneFormBase::createInstance public static function
ContentEntityCloneFormBase::formElement public function Get all specific form element. Overrides EntityCloneFormInterface::formElement
ContentEntityCloneFormBase::getChildren protected function Fetches clonable children from a field.
ContentEntityCloneFormBase::getFormDescription protected function Get the clone form confirmation page description.
ContentEntityCloneFormBase::getRecursiveFormElement protected function Get the recursive form element.
ContentEntityCloneFormBase::getValues public function Get all new values provided by the specific form element. Overrides EntityCloneFormInterface::getValues
ContentEntityCloneFormBase::__construct public function Constructs a new ContentEntityCloneFormBase.