ctools_entity_mask.module

Same filename in other branches
  1. 8.x-3.x modules/ctools_entity_mask/ctools_entity_mask.module

Helps entity type to take the fields, display configuration from entity type.

File

modules/ctools_entity_mask/ctools_entity_mask.module

View source
<?php


/**
 * @file
 * Helps entity type to take the fields, display configuration from entity type.
 */
use Drupal\Core\Entity\Display\EntityDisplayInterface;
use Drupal\Core\Entity\Display\EntityFormDisplayInterface;
use Drupal\Core\Entity\Display\EntityViewDisplayInterface;
use Drupal\Core\Entity\EntityTypeInterface;
use Drupal\Core\Entity\Sql\SqlContentEntityStorage;
use Drupal\ctools_entity_mask\MaskContentEntityStorage;

/**
 * Ensures that mask entity types have the same display modes as masked ones.
 *
 * @param array $display_modes
 *   The display modes.
 *
 * @see hook_entity_view_mode_info_alter()
 * @see \Drupal\Core\Entity\EntityDisplayRepository::getAllDisplayModesByEntityType()
 */
function ctools_entity_mask_copy_display_modes(array &$display_modes) {
    foreach (\Drupal::entityTypeManager()->getDefinitions() as $id => $entity_type) {
        $mask = $entity_type->get('mask');
        if ($mask && isset($display_modes[$mask])) {
            $display_modes[$id] = $display_modes[$mask];
        }
    }
}

/**
 * Implements hook_entity_view_mode_info_alter().
 */
function ctools_entity_mask_entity_view_mode_info_alter(&$view_modes) {
    ctools_entity_mask_copy_display_modes($view_modes);
}

/**
 * Implements hook_entity_form_mode_info_alter().
 */
function ctools_entity_mask_entity_form_mode_info_alter(&$form_modes) {
    ctools_entity_mask_copy_display_modes($form_modes);
}

/**
 * Implements hook_entity_type_alter().
 */
function ctools_entity_mask_entity_type_alter(array &$entity_types) {
    
    /** @var \Drupal\Core\Entity\EntityTypeInterface $entity_type */
    foreach ($entity_types as $entity_type) {
        // Mask entities should use our specialized storage handler, which simulates
        // a save but does not write anything to the database.
        if ($entity_type->get('mask') && $entity_type->getStorageClass() == SqlContentEntityStorage::class) {
            $entity_type->setStorageClass(MaskContentEntityStorage::class);
            // Mask entities should not maintain any tables.
            $entity_type->set('base_table', NULL);
            $entity_type->set('revision_table', NULL);
            $entity_type->set('data_table', NULL);
            $entity_type->set('revision_data_table', NULL);
            // Nor should they be exposed to Field UI.
            $entity_type->set('field_ui_base_route', NULL);
        }
    }
}

/**
 * Copies all components from a display for a masked entity type.
 *
 * If the given display is for a mask entity type, the corresponding display for
 * the masked entity type is loaded and all of its components are copied into
 * the given display. If no corresponding display exists for the masked entity
 * type, the default display will be loaded and used.
 *
 * @param \Drupal\Core\Entity\Display\EntityDisplayInterface $display
 *   The display for the mask entity type.
 */
function ctools_entity_mask_copy_display(EntityDisplayInterface $display) {
    $mask = \Drupal::entityTypeManager()->getDefinition($display->getTargetEntityTypeId())
        ->get('mask');
    // If the target entity type is not masking another entity type, there is
    // nothing to do here.
    if (empty($mask)) {
        return;
    }
    // Try to load the corresponding entity display for the masked entity type,
    // in descending order of preference.
    $bundle = $display->getTargetBundle();
    $displays = $display::loadMultiple([
        $mask . '.' . $bundle . '.' . $display->getMode(),
        $mask . '.' . $bundle . '.default',
    ]);
    // Nothing to do if there is no display we can borrow components from.
    if (empty($displays)) {
        return;
    }
    foreach (reset($displays)->getComponents() as $key => $component) {
        $display->setComponent($key, $component);
    }
}

/**
 * Implements hook_ENTITY_TYPE_create().
 */
function ctools_entity_mask_entity_view_display_create(EntityViewDisplayInterface $display) {
    ctools_entity_mask_copy_display($display);
}

/**
 * Implements hook_ENTITY_TYPE_create().
 */
function ctools_entity_mask_entity_form_display_create(EntityFormDisplayInterface $display) {
    ctools_entity_mask_copy_display($display);
}

/**
 * Implements hook_entity_view_display_alter().
 */
function ctools_entity_mask_entity_view_display_alter(EntityViewDisplayInterface $display, array $context) {
    ctools_entity_mask_copy_display($display);
}

/**
 * Implements hook_entity_form_display_alter().
 */
function ctools_entity_mask_entity_form_display_alter(EntityFormDisplayInterface $form_display, array $context) {
    ctools_entity_mask_copy_display($form_display);
}

/**
 * Implements hook_entity_bundle_field_info().
 */
function ctools_entity_mask_entity_bundle_field_info(EntityTypeInterface $entity_type, $bundle) {
    $info = [];
    $mask = $entity_type->get('mask');
    // Nothing to do if the entity type is not masking another entity type.
    if (empty($mask)) {
        return $info;
    }
    $storage_info = ctools_entity_mask_entity_field_storage_info($entity_type);
    
    /** @var \Drupal\field\FieldConfigInterface[] $fields */
    $fields = \Drupal::entityTypeManager()->getStorage('field_config')
        ->loadByProperties([
        'entity_type' => $mask,
        'bundle' => $bundle,
    ]);
    foreach ($fields as $field) {
        $field_name = $field->getName();
        $info[$field_name] = $field->createDuplicate()
            ->set('entity_type', $mask)
            ->set('fieldStorage', $storage_info[$field_name]);
    }
    return $info;
}

/**
 * Implements hook_entity_field_storage_info().
 */
function ctools_entity_mask_entity_field_storage_info(EntityTypeInterface $entity_type) {
    $info = [];
    $mask = $entity_type->get('mask');
    // Nothing to do if the entity type is not masking another entity type.
    if (empty($mask)) {
        return $info;
    }
    
    /** @var \Drupal\field\FieldStorageConfigInterface[] $fields */
    $fields = \Drupal::entityTypeManager()->getStorage('field_storage_config')
        ->loadByProperties([
        'entity_type' => $mask,
    ]);
    foreach ($fields as $field) {
        $field_name = $field->getName();
        $info[$field_name] = $field->createDuplicate()
            ->set('entity_type', $mask);
    }
    return $info;
}

Functions

Title Deprecated Summary
ctools_entity_mask_copy_display Copies all components from a display for a masked entity type.
ctools_entity_mask_copy_display_modes Ensures that mask entity types have the same display modes as masked ones.
ctools_entity_mask_entity_bundle_field_info Implements hook_entity_bundle_field_info().
ctools_entity_mask_entity_field_storage_info Implements hook_entity_field_storage_info().
ctools_entity_mask_entity_form_display_alter Implements hook_entity_form_display_alter().
ctools_entity_mask_entity_form_display_create Implements hook_ENTITY_TYPE_create().
ctools_entity_mask_entity_form_mode_info_alter Implements hook_entity_form_mode_info_alter().
ctools_entity_mask_entity_type_alter Implements hook_entity_type_alter().
ctools_entity_mask_entity_view_display_alter Implements hook_entity_view_display_alter().
ctools_entity_mask_entity_view_display_create Implements hook_ENTITY_TYPE_create().
ctools_entity_mask_entity_view_mode_info_alter Implements hook_entity_view_mode_info_alter().