You are here

class DomainPathHelper in Domain Path 8

Hierarchy

Expanded class hierarchy of DomainPathHelper

1 string reference to 'DomainPathHelper'
domain_path.services.yml in ./domain_path.services.yml
domain_path.services.yml
1 service uses DomainPathHelper
domain_path.helper in ./domain_path.services.yml
Drupal\domain_path\DomainPathHelper

File

src/DomainPathHelper.php, line 17

Namespace

Drupal\domain_path
View source
class DomainPathHelper {
  use StringTranslationTrait;
  use DependencySerializationTrait;

  /**
   * @var \Drupal\Core\Session\AccountInterface
   */
  protected $accountManager;

  /**
   * @var \Drupal\Core\Entity\EntityTypeManagerInterface
   */
  protected $entityTypeManager;

  /**
   * @var \Drupal\path_alias\AliasManagerInterface
   */
  protected $aliasManager;

  /**
   * @var \Drupal\Core\Config\Config
   */
  protected $config;

  /**
   * The module handler.
   *
   * @var \Drupal\Core\Extension\ModuleHandlerInterface
   */
  protected $moduleHandler;

  /**
   * DomainPathHelper constructor.
   *
   * @param \Drupal\Core\Session\AccountInterface $account_manager
   *   The account manager.
   * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
   *   The entity type manager.
   * @param \Drupal\path_alias\AliasManagerInterface $alias_manager
   *   The alias manager.
   * @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
   *   The configuration factory.
   */
  public function __construct(AccountInterface $account_manager, EntityTypeManagerInterface $entity_type_manager, AliasManagerInterface $alias_manager, ConfigFactoryInterface $config_factory, ModuleHandlerInterface $module_handler) {
    $this->accountManager = $account_manager;
    $this->entityTypeManager = $entity_type_manager;
    $this->aliasManager = $alias_manager;
    $this->moduleHandler = $module_handler;
    $this->config = $config_factory
      ->get('domain_path.settings');
  }

  /**
   * The domain paths form element for the entity form.
   *
   * @param array $form
   *   The form array.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state object.
   * @param \Drupal\Core\Entity\ContentEntityInterface $entity
   *   Referenced entity.
   *
   * @return array $form
   *   Return the modified form array.
   */
  public function alterEntityForm(&$form, FormStateInterface $form_state, $entity) {
    $domains = $this->entityTypeManager
      ->getStorage('domain')
      ->loadMultipleSorted();
    $config = \Drupal::config('domain_path.settings');

    // Just exit if domain paths is not enabled for this entity.
    if (!$this
      ->domainPathsIsEnabled($entity) || !$domains) {
      return $form;
    }

    // Set up our variables.
    $entity_id = $entity
      ->id();
    $langcode = $entity
      ->language()
      ->getId();
    $show_delete = FALSE;
    $default = '';

    // Container for domain path fields
    $form['path']['widget'][0]['domain_path'] = [
      '#tree' => TRUE,
      '#type' => 'details',
      '#title' => $this
        ->t('Domain-specific paths'),
      '#description' => $this
        ->t('Override the default URL alias (above) for individual domains.'),
      // '#group' => 'path_settings',
      '#weight' => 110,
      '#open' => TRUE,
      '#access' => $this->accountManager
        ->hasPermission('edit domain path entity'),
    ];

    // Add an option to delete all domain paths. This is just for convenience
    // so the user doesn't have to manually remove the paths from each domain.
    $form['path']['widget'][0]['domain_path']['domain_path_delete'] = [
      '#type' => 'checkbox',
      '#title' => $this
        ->t('Delete domain-specific aliases'),
      '#default_value' => FALSE,
    ];

    // Add a domain path field for each domain.
    foreach ($domains as $domain_id => $domain) {
      $form['path']['widget'][0]['domain_path'][$domain_id] = [
        '#type' => 'container',
      ];

      // Gather the existing domain path.
      $path = FALSE;
      if ($entity_id) {
        $properties = [
          'source' => '/' . $entity
            ->toUrl()
            ->getInternalPath(),
          'language' => $langcode,
          'domain_id' => $domain_id,
        ];
        if ($domain_paths = $this->entityTypeManager
          ->getStorage('domain_path')
          ->loadByProperties($properties)) {
          $path = reset($domain_paths)
            ->get('alias')
            ->getString();
        }
      }

      // We only need to enable the delete checkbox if we have at least one
      // domain path.
      if (!$show_delete && $path) {
        $show_delete = TRUE;
      }
      $label = $domain
        ->label();
      if ($config
        ->get('alias_title') == 'hostname') {
        $label = $domain
          ->getHostname();
      }
      elseif ($config
        ->get('alias_title') == 'url') {
        $label = $domain
          ->getPath();
      }
      if ($this->moduleHandler
        ->moduleExists('domain_path_pathauto')) {

        //See https://git.drupalcode.org/project/pathauto/-/blob/8.x-1.x/src/PathautoWidget.php#L42
        if (isset($form['path']['widget'][0]['pathauto'])) {
          if ($form['path']['widget'][0]['pathauto']['#type'] == 'checkbox') {
            $form['path']['widget'][0]['domain_path'][$domain_id]['pathauto'] = [
              '#type' => 'checkbox',
              '#title' => $this
                ->t('Generate automatic URL alias for @domain', [
                '@domain' => Html::escape(rtrim($domain
                  ->getPath(), '/')),
              ]),
              '#default_value' => $form['path']['widget'][0]['pathauto']['#default_value'],
              '#weight' => -1,
            ];
          }
        }
      }
      $form['path']['widget'][0]['domain_path'][$domain_id]['path'] = [
        '#type' => 'textfield',
        '#title' => Html::escape(rtrim($label, '/')),
        '#default_value' => $path ? $path : $default,
        '#access' => $this->accountManager
          ->hasPermission('edit domain path entity'),
        '#states' => [
          'disabled' => [
            'input[name="path[0][domain_path][domain_path_delete]"]' => [
              'checked' => TRUE,
            ],
          ],
        ],
      ];
      if ($this->moduleHandler
        ->moduleExists('domain_path_pathauto')) {
        $form['path']['widget'][0]['domain_path'][$domain_id]['path']['#states'] = [
          'disabled' => [
            [
              'input[name="path[0][domain_path][domain_path_delete]"]' => [
                'checked' => TRUE,
              ],
            ],
            'OR',
            [
              'input[name="path[0][domain_path][' . $domain_id . '][pathauto]"]' => [
                'checked' => TRUE,
              ],
            ],
          ],
        ];
      }
      if ($config
        ->get('hide_path_alias_ui')) {

        // Hide the default URL alias for better UI
        if (isset($form['path']['widget'][0]['pathauto'])) {
          $form['path']['widget'][0]['pathauto']['#default_value'] = 0;
          $form['path']['widget'][0]['pathauto']['#access'] = FALSE;
        }
        if (isset($form['path']['widget'][0]['alias'])) {
          $form['path']['widget'][0]['alias']['#default_value'] = '';
          $form['path']['widget'][0]['alias']['#access'] = FALSE;
        }
        unset($form['path']['widget'][0]['domain_path']['#description']);
      }

      // If domain settings are on the page for this domain we only show if
      // it's checked. e.g. on the node form, we only show the domain path
      // field for domains we're publishing to
      if (!empty($form['field_domain_access']['widget']['#options'][$domain_id])) {
        $form['path']['widget'][0]['domain_path'][$domain_id]['#states']['invisible']['input[name="field_domain_access[' . $domain_id . ']"]'] = [
          'unchecked' => TRUE,
        ];
        $form['path']['widget'][0]['domain_path'][$domain_id]['#states']['invisible']['input[name="field_domain_all_affiliates[value]"]'] = [
          'unchecked' => TRUE,
        ];
      }
      else {
        if (!empty($form['field_domain_access']['widget']['#options'])) {
          $form['path']['widget'][0]['domain_path'][$domain_id]['#access'] = FALSE;
        }
      }
    }
    $form['path']['widget'][0]['domain_path']['domain_path_delete']['#access'] = $show_delete;

    // Add our validation and submit handlers.
    $form['#validate'][] = [
      $this,
      'validateEntityForm',
    ];
    if (!empty($form['actions'])) {
      if (array_key_exists('submit', $form['actions'])) {
        $form['actions']['submit']['#submit'][] = [
          $this,
          'submitEntityForm',
        ];
      }
    }
    else {

      // If no actions we just tack it on to the form submit handlers.
      $form['#submit'][] = [
        $this,
        'submitEntityForm',
      ];
    }
  }

  /**
   * Validation handler the domain paths element on the entity form.
   *
   * @param array $form
   *   The form array.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state object.
   */
  public static function validateEntityForm(array &$form, FormStateInterface $form_state) {

    // Set up variables.
    $entity = $form_state
      ->getFormObject()
      ->getEntity();
    $domain_path_storage = \Drupal::service('entity_type.manager')
      ->getStorage('domain_path');
    $path_values = $form_state
      ->getValue('path');
    $domain_path_values = $path_values[0]['domain_path'];

    // If we're just deleting the domain paths we don't have to validate
    // anything.
    if (!empty($domain_path_values['domain_path_delete'])) {
      return;
    }
    unset($domain_path_values['domain_path_delete']);
    $alias = isset($path_values[0]['alias']) ? $path_values[0]['alias'] : NULL;

    // Check domain access settings if they are on the form.
    $domain_access = [];
    if (!empty($form['field_domain_access']) && !empty($form_state
      ->getValue('field_domain_access'))) {
      foreach ($form_state
        ->getValue('field_domain_access') as $item) {
        $domain_access[$item['target_id']] = $item['target_id'];
      }
    }

    // If domain access is on for this form, we check the "all affiliates"
    // checkbox, otherwise we just assume it's available on all domains.
    $domain_access_all = !empty($form['field_domain_all_affiliates']) ? $form_state
      ->getValue('field_domain_all_affiliates')['value'] : TRUE;

    // Validate each path value.
    foreach ($domain_path_values as $domain_id => $domain_path_data) {

      // Don't validate if the domain doesn't have access (we remove aliases
      // for domains that don't have access to this entity).
      $domain_has_access = $domain_access_all || $domain_access && !empty($domain_access[$domain_id]);
      if (!$domain_has_access) {
        continue;
      }

      // If domain pathauto is not enabled, validate user entered path.
      if (!(\Drupal::service('module_handler')
        ->moduleExists('domain_path_pathauto') && $domain_path_data['pathauto'])) {
        $path = $domain_path_data['path'];
        if (!empty($path) && $path == $alias) {
          $form_state
            ->setError($form['path']['widget'][0]['domain_path'][$domain_id], t('Domain path "%path" matches the default path alias. You may leave the element blank.', [
            '%path' => $path,
          ]));
        }
        elseif (!empty($path)) {

          // Trim slashes and whitespace from end of path value.
          $path_value = rtrim(trim($path), " \\/");

          // Check that the paths start with a slash.
          if ($path_value && $path_value[0] !== '/') {
            $form_state
              ->setError($form['path']['widget'][0]['domain_path'][$domain_id]['path'], t('Domain path "%path" needs to start with a slash.', [
              '%path' => $path,
            ]));
          }

          // Check for duplicates.
          $entity_query = $domain_path_storage
            ->getQuery();
          $entity_query
            ->condition('domain_id', $domain_id)
            ->condition('alias', $path_value);
          if (!$entity
            ->isNew()) {
            $entity_query
              ->condition('source', '/' . $entity
              ->toUrl()
              ->getInternalPath(), '<>');
          }
          $result = $entity_query
            ->execute();
          if ($result) {
            $form_state
              ->setError($form['path']['widget'][0]['domain_path'][$domain_id]['path'], t('Domain path %path matches an existing domain path alias', [
              '%path' => $path_value,
            ]));
          }
        }
        if (isset($path_value)) {
          $domain_path_values[$domain_id] = $path_value;
        }
      }
      $form_state
        ->setValue('domain_path', $domain_path_values);
    }
  }

  /**
   * Submit handler for the domain paths element on the entity form.
   *
   * @param array $form
   *   The form array.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state object.
   */
  public function submitEntityForm($form, FormStateInterface $form_state) {

    // Setup Variables
    $entity = $form_state
      ->getFormObject()
      ->getEntity();
    $entity_system_path = '/' . $entity
      ->toUrl()
      ->getInternalPath();

    // Get the saved alias
    $default_alias = $this->aliasManager
      ->getAliasByPath($entity_system_path);
    $properties = [
      'source' => $entity_system_path,
      'language' => $entity
        ->language()
        ->getId(),
    ];
    $path_values = $form_state
      ->getValue('path');
    $domain_path_values = $path_values[0]['domain_path'];
    $domain_path_storage = $this->entityTypeManager
      ->getStorage('domain_path');

    // Check domain access settings if they are on the form.
    $domain_access = [];
    if (!empty($form['field_domain_access']) && !empty($form_state
      ->getValue('field_domain_access'))) {
      foreach ($form_state
        ->getValue('field_domain_access') as $item) {
        $domain_access[$item['target_id']] = $item['target_id'];
      }
    }

    // If domain access is on for this form, we check the "all affiliates"
    // checkbox, otherwise we just assume it's available on all domains.
    $domain_access_all = !empty($form['field_domain_all_affiliates']) ? $form_state
      ->getValue('field_domain_all_affiliates')['value'] : TRUE;

    // If not set to delete, then save changes.
    if (empty($domain_path_values['domain_path_delete'])) {
      unset($domain_path_values['domain_path_delete']);
      foreach ($domain_path_values as $domain_id => $domain_path_data) {
        $alias = $domain_path_data['path'];
        if ($this->moduleHandler
          ->moduleExists('domain_path_pathauto')) {
          $domain_path_pathauto_service = \Drupal::service('domain_path_pathauto.generator');
          if ($domain_path_data['pathauto']) {

            // Generate alias using pathauto.
            $alias = $domain_path_pathauto_service
              ->createEntityAlias($entity, 'return', $domain_id);

            // Remember pathauto default enabled setting.
            $domain_path_pathauto_service
              ->setDomainPathPathautoState($entity, $domain_id, TRUE);
          }
          else {

            // Delete pathauto default enabled setting.
            $domain_path_pathauto_service
              ->deleteDomainPathPathautoState($entity, $domain_id);
          }
        }

        // Get the existing domain path for this domain if it exists.
        $properties['domain_id'] = $domain_id;
        $domain_paths = $domain_path_storage
          ->loadByProperties($properties);
        $domain_path = $domain_paths ? reset($domain_paths) : NULL;
        $domain_has_access = $domain_access_all || $domain_access && !empty($domain_access[$domain_id]);

        // We don't want to save the alias if the domain path field is empty,
        // or if it matches the default alias, or if the domain doesn't have
        // access to this entity.
        if (!$alias || $alias == $default_alias || !$domain_has_access) {

          // Delete the existing domain path.
          if ($domain_path) {
            $domain_path
              ->delete();
          }
          continue;
        }

        // Create or update the domain path.
        $properties_map = [
          'alias' => $alias,
          'domain_id' => $domain_id,
        ] + $properties;
        if (!$domain_path) {
          $domain_path = $domain_path_storage
            ->create([
            'type' => 'domain_path',
          ]);
          foreach ($properties_map as $field => $value) {
            $domain_path
              ->set($field, $value);
          }
          $domain_path
            ->save();
        }
        else {
          if ($domain_path
            ->get('alias')->value != $alias) {
            $domain_path
              ->set('alias', $alias);
            $domain_path
              ->save();
          }
        }
      }
    }
    else {

      // Delete all domain path aliases.
      $domain_paths = $domain_path_storage
        ->loadByProperties($properties);
      foreach ($domain_paths as $domain_path) {
        $domain_path
          ->delete();
      }
    }
  }

  /**
   * Helper function for deleting domain paths from an entity.
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *   The entity object.
   */
  public function deleteEntityDomainPaths(EntityInterface $entity, $delete_all_translations = FALSE) {
    if ($this
      ->domainPathsIsEnabled($entity)) {
      $properties_map = [
        'source' => '/' . $entity
          ->toUrl()
          ->getInternalPath(),
      ];
      if (!$delete_all_translations) {
        $properties_map['language'] = $entity
          ->language()
          ->getId();
      }
      $domain_paths = $this->entityTypeManager
        ->getStorage('domain_path')
        ->loadByProperties($properties_map);
      if ($domain_paths) {
        foreach ($domain_paths as $domain_path) {
          $domain_path
            ->delete();
        }
      }
    }

    // Delete domain paths on domain delete.
    if ($entity instanceof DomainInterface) {
      $domain_paths = $this->entityTypeManager
        ->getStorage('domain_path')
        ->loadByProperties([
        'domain_id' => $entity
          ->id(),
      ]);
      if ($domain_paths) {
        foreach ($domain_paths as $domain_path) {
          $domain_path
            ->delete();
        }
      }
    }
  }

  /**
   * Helper function for retrieving configured entity types.
   *
   * @return array
   *   Returns array of configured entity types.
   */
  public function getConfiguredEntityTypes() {
    $enabled_entity_types = $this->config
      ->get('entity_types');
    $enabled_entity_types = array_filter($enabled_entity_types);
    return array_keys($enabled_entity_types);
  }

  /**
   * Check if domain paths is enabled for a given entity.
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *   The entity object.
   *
   * @return boolean
   *   Return TRUE or FALSE.
   */
  public function domainPathsIsEnabled(EntityInterface $entity) {
    return in_array($entity
      ->getEntityTypeId(), $this
      ->getConfiguredEntityTypes());
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DependencySerializationTrait::$_entityStorages protected property An array of entity type IDs keyed by the property name of their storages.
DependencySerializationTrait::$_serviceIds protected property An array of service IDs keyed by property name used for serialization.
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
DomainPathHelper::$accountManager protected property
DomainPathHelper::$aliasManager protected property
DomainPathHelper::$config protected property
DomainPathHelper::$entityTypeManager protected property
DomainPathHelper::$moduleHandler protected property The module handler.
DomainPathHelper::alterEntityForm public function The domain paths form element for the entity form.
DomainPathHelper::deleteEntityDomainPaths public function Helper function for deleting domain paths from an entity.
DomainPathHelper::domainPathsIsEnabled public function Check if domain paths is enabled for a given entity.
DomainPathHelper::getConfiguredEntityTypes public function Helper function for retrieving configured entity types.
DomainPathHelper::submitEntityForm public function Submit handler for the domain paths element on the entity form.
DomainPathHelper::validateEntityForm public static function Validation handler the domain paths element on the entity form.
DomainPathHelper::__construct public function DomainPathHelper constructor.
StringTranslationTrait::$stringTranslation protected property The string translation service. 1
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.