content_translation.install

Same filename in other branches
  1. 9 core/modules/content_translation/content_translation.install
  2. 10 core/modules/content_translation/content_translation.install
  3. 11.x core/modules/content_translation/content_translation.install

Installation functions for Content Translation module.

File

core/modules/content_translation/content_translation.install

View source
<?php


/**
 * @file
 * Installation functions for Content Translation module.
 */
use Drupal\Core\Entity\Sql\SqlEntityStorageInterface;
use Drupal\Core\Installer\InstallerKernel;
use Drupal\Core\Language\LanguageInterface;
use Drupal\Core\Url;

/**
 * Implements hook_install().
 */
function content_translation_install() {
    // Assign a fairly low weight to ensure our implementation of
    // hook_module_implements_alter() is run among the last ones.
    module_set_weight('content_translation', 10);
    // Skip the guidance messages about enabling translation features if the
    // module was installed in the Drupal installation process.
    if (InstallerKernel::installationAttempted()) {
        return;
    }
    // Translation works when at least two languages are added.
    if (count(\Drupal::languageManager()->getLanguages()) < 2) {
        $t_args = [
            ':language_url' => Url::fromRoute('entity.configurable_language.collection')->toString(),
        ];
        $message = t('This site has only a single language enabled. <a href=":language_url">Add at least one more language</a> in order to translate content.', $t_args);
        \Drupal::messenger()->addWarning($message);
    }
    // Point the user to the content translation settings.
    $t_args = [
        ':settings_url' => Url::fromRoute('language.content_settings_page')->toString(),
    ];
    $message = t('<a href=":settings_url">Enable translation</a> for <em>content types</em>, <em>taxonomy vocabularies</em>, <em>accounts</em>, or any other element you wish to translate.', $t_args);
    \Drupal::messenger()->addWarning($message);
}

/**
 * Rebuild the routes as the content translation routes have now new names.
 */
function content_translation_update_8001() {
    \Drupal::service('router.builder')->rebuild();
}

/**
 * Clear field type plugin caches to fix image field translatability.
 */
function content_translation_update_8002() {
    \Drupal::service('plugin.manager.field.field_type')->clearCachedDefinitions();
}

/**
 * Fix the initial values for content translation metadata fields.
 */
function content_translation_update_8400() {
    $database = \Drupal::database();
    
    /** @var \Drupal\content_translation\ContentTranslationManagerInterface $content_translation_manager */
    $content_translation_manager = \Drupal::service('content_translation.manager');
    
    /** @var \Drupal\Core\Entity\EntityLastInstalledSchemaRepositoryInterface $last_installed_schema_repository */
    $last_installed_schema_repository = \Drupal::service('entity.last_installed_schema.repository');
    $entity_type_manager = \Drupal::entityTypeManager();
    $entity_definition_update_manager = \Drupal::entityDefinitionUpdateManager();
    $entity_type_manager->clearCachedDefinitions();
    foreach ($content_translation_manager->getSupportedEntityTypes() as $entity_type_id => $entity_type_definition) {
        $storage = $entity_type_manager->getStorage($entity_type_id);
        if ($storage instanceof SqlEntityStorageInterface) {
            $entity_type = $entity_definition_update_manager->getEntityType($entity_type_id);
            $storage_definitions = $last_installed_schema_repository->getLastInstalledFieldStorageDefinitions($entity_type_id);
            // Since the entity type is managed by Content Translation, we can assume
            // that it is translatable, so we use the data and revision data tables.
            $tables_to_update = [
                $entity_type->getDataTable(),
            ];
            if ($entity_type->isRevisionable()) {
                $tables_to_update += [
                    $entity_type->getRevisionDataTable(),
                ];
            }
            foreach ($tables_to_update as $table_name) {
                // Fix the values of the 'content_translation_source' field.
                if (isset($storage_definitions['content_translation_source'])) {
                    $database->update($table_name)
                        ->fields([
                        'content_translation_source' => LanguageInterface::LANGCODE_NOT_SPECIFIED,
                    ])
                        ->isNull('content_translation_source')
                        ->execute();
                }
                // Fix the values of the 'content_translation_outdated' field.
                if (isset($storage_definitions['content_translation_outdated'])) {
                    $database->update($table_name)
                        ->fields([
                        'content_translation_outdated' => 0,
                    ])
                        ->isNull('content_translation_outdated')
                        ->execute();
                }
                // Fix the values of the 'content_translation_status' field.
                if (isset($storage_definitions['content_translation_status'])) {
                    $database->update($table_name)
                        ->fields([
                        'content_translation_status' => 1,
                    ])
                        ->isNull('content_translation_status')
                        ->execute();
                }
            }
        }
    }
}

Functions

Title Deprecated Summary
content_translation_install Implements hook_install().
content_translation_update_8001 Rebuild the routes as the content translation routes have now new names.
content_translation_update_8002 Clear field type plugin caches to fix image field translatability.
content_translation_update_8400 Fix the initial values for content translation metadata fields.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.