farm.install in farmOS 2.x

Install, update and uninstall functions for the farmOS installation profile.

File

farm.install

<?php

/**
 * @file
 * Install, update and uninstall functions for the farmOS installation profile.
 */
use Drupal\Component\Serialization\Json;

/**
 * Implements hook_install().
 */
function farm_install() {

  // Use private file system by default.
  \Drupal::configFactory()
    ->getEditable('system.file')
    ->set('default_scheme', 'private')
    ->save();

  // Only allow admins to register new users.
  \Drupal::configFactory()
    ->getEditable('user.settings')
    ->set('register', 'admin_only')
    ->save();
}

/**
 * Implements hook_install_tasks().
 */
function farm_install_tasks(&$install_state) {

  // Add tasks for enabling farmOS modules.
  $tasks = [
    '\\Drupal\\farm\\Form\\FarmModulesForm' => [
      'display_name' => t('Install modules'),
      'type' => 'form',
    ],
    'farm_install_modules' => [
      'type' => 'batch',
    ],
  ];
  return $tasks;
}

/**
 * Implements hook_install_tasks_alter().
 */
function farm_install_tasks_alter(&$tasks, $install_state) {

  // Override install task display names to replace "site" with "farmOS".
  $alter_display_names = [
    'install_profile_modules' => t('Install farmOS'),
    'install_configure_form' => t('Configure farmOS'),
  ];
  foreach ($alter_display_names as $task => $display_name) {
    if (!empty($tasks[$task]['display_name'])) {
      $tasks[$task]['display_name'] = $display_name;
    }
  }
}

/**
 * Installs farmOS modules via a batch process.
 *
 * @param array $install_state
 *   An array of information about the current installation state.
 *
 * @return array
 *   The batch definition.
 */
function farm_install_modules(array &$install_state) {

  // Load the list of farmOS core modules.
  $all = farm_modules();

  // Load the list of modules that should be installed.
  // If provided, use the modules defined in farm.modules profile argument.
  // We assume this is an array of module machine names, unless it is simply a
  // string, which is interpreted as a shortcut for installing a set of modules.
  // Available shortcuts are:
  // - "all" (installs all modules)
  // - "default" (installs default and base modules)
  // - "base" (installs base modules only)
  if (!empty($install_state['forms']['farm']['modules'])) {
    $modules_arg = $install_state['forms']['farm']['modules'];
    $all = farm_modules();
    if ($modules_arg === 'all') {
      $modules = array_merge(array_keys($all['base']), array_keys($all['default']), array_keys($all['optional']));
    }
    elseif ($modules_arg === 'default') {
      $modules = array_merge(array_keys($all['base']), array_keys($all['default']));
    }
    elseif ($modules_arg === 'base') {
      $modules = array_keys($all['base']);
    }
    else {
      $modules = Json::decode($modules_arg);
      if (!is_array($modules)) {
        $modules = [];
      }
    }
  }
  else {
    $modules = \Drupal::state()
      ->get('farm.install_modules') ?: [];
    $modules = array_merge(array_keys($all['base']), $modules);
  }

  // If this is running in the context of a functional test, do not install any
  // additional modules. This is a temporary hack.
  // @see Drupal\Tests\farm_test\Functional\FarmBrowserTestBase::setUp()
  // @todo https://www.drupal.org/project/farm/issues/3183739
  if (!empty($GLOBALS['farm_test'])) {
    $modules = [];
  }

  // Load a list of all available modules, so that we can display their names.
  $module_handler = \Drupal::service('module_handler');

  // Assemble the batch operation for installing modules.
  $operations = [];
  foreach ($modules as $module) {
    $operations[] = [
      '_farm_install_module_batch',
      [
        $module,
        $module_handler
          ->getName($module),
      ],
    ];
  }
  $batch = [
    'operations' => $operations,
    'title' => t('Installing @drupal modules', [
      '@drupal' => drupal_install_profile_distribution_name(),
    ]),
    'error_message' => t('The installation has encountered an error.'),
  ];
  return $batch;
}

/**
 * Implements callback_batch_operation().
 *
 * Performs batch installation of farmOS modules.
 */
function _farm_install_module_batch($module, $module_name, &$context) {
  \Drupal::service('module_installer')
    ->install([
    $module,
  ], TRUE);
  $context['results'][] = $module;
  $context['message'] = t('Installed %module module.', [
    '%module' => $module_name,
  ]);
}

Functions

Name	Description
farm_install	Implements hook_install().
farm_install_modules	Installs farmOS modules via a batch process.
farm_install_tasks	Implements hook_install_tasks().
farm_install_tasks_alter	Implements hook_install_tasks_alter().
_farm_install_module_batch	Implements callback_batch_operation().