Добавление файлов JavaScript на административные страницы

Используя модуль, вы можете следовать двум методам:

• Реализация hook_init()
• Реализация hook_form_alter()

Первый метод позволит вам добавлять дополнительные файлы JavaScript (или CSS) на любые страницы администрирования, в то время как второй метод позволит вам добавлять эти файлы только на страницы, содержащие формы.

function mymodule_init() {
  if (arg(0) == 'admin') {
    $path = drupal_get_path('module', 'mymodule');
    drupal_add_js($path . '/mymodule.js');
    drupal_add_css($path . '/mymodule.css');
  }
}

function mymodule_form_alter(&$form, &$form_state, $form_id) {
  if (arg(0) == 'admin') {
    $path = drupal_get_path('module', 'mymodule');  
    $form['#attached']['css'][] = $path . '/mymodule.css';
    $form['#attached']['js'][] = $path . '/mymodule.js';
  }
}

Замените "mymodule" коротким названием вашего модуля; замените"mymodule.js "и "mymodule.css" с фактическими именами файлов JavaScript и CSS.

System_init() содержит следующий код для добавления определенных файлов на административные страницы.

  $path = drupal_get_path('module', 'system');
  // Add the CSS for this module. These aren't in system.info, because they
  // need to be in the CSS_SYSTEM group rather than the CSS_DEFAULT group.
  drupal_add_css($path . '/system.base.css', array('group' => CSS_SYSTEM, 'every_page' => TRUE));

  // Add the system.admin.css file to the administrative pages.
  if (path_is_admin(current_path())) {
    drupal_add_css($path . '/system.admin.css', array('group' => CSS_SYSTEM));
  }

  drupal_add_css($path . '/system.menus.css', array('group' => CSS_SYSTEM, 'every_page' => TRUE));
  drupal_add_css($path . '/system.messages.css', array('group' => CSS_SYSTEM, 'every_page' => TRUE));
  drupal_add_css($path . '/system.theme.css', array('group' => CSS_SYSTEM, 'every_page' => TRUE));

Path_is_admin() - это функция, которая в своей документации описывается как:

Определите, находится ли путь в административном разделе сайта.

Учтите, что некоторые пути, связанные с узлами, такие как node/<nid>/edit, могут быть включены в административный раздел, в зависимости от настроек, найденных в разделе администратор/внешний вид.

Список путей к узлам, которые могут быть включены в административные страницы, возвращается из node_admin_paths().

  if (variable_get('node_admin_theme')) {
    $paths = array(
      'node/*/edit' => TRUE, 
      'node/*/delete' => TRUE, 
      'node/*/revisions' => TRUE, 
      'node/*/revisions/*/revert' => TRUE, 
      'node/*/revisions/*/delete' => TRUE, 
      'node/add' => TRUE, 
      'node/add/*' => TRUE,
    );
    return $paths;

Если по какой-либо причине вам нужно избегать любой страницы с таким путем, как node/*, вам нужно добавить специальный код, чтобы избежать их, если вы используете path_is_admin(). Учтите, что любой модуль может изменить страницы, которые считаются частью административной страницы.

В обоих случаях альтернативой было бы использование библиотеки, если модуль реализует hooks_library() с кодом, аналогичным следующему.

function mymodule_library() {
  $path = drupal_get_path('module', 'mymodule');

  $libraries['mymodule.library'] = array(
    'title' => 'MyModule Library', 
    'version' => '1.0', 
    'js' => array(
      $path . '/mymodule.js' => array(),
    ), 
    'css' => array(
      $path . '/mymodule.css' => array(
        'type' => 'file', 
        'media' => 'screen',
      ),
    ),
  );

  return $libraries;
}

В этом случае предыдущая реализация hook_form_alter() станет следующей.

function mymodule_form_alter(&$form, &$form_state, $form_id) {
  if (arg(0) == 'admin') {
    $form['#attached']['library'][] = array('mymodule', 'mymodule.library');
  }
}

Вместо вызова drupal_add_js() и drupal_add_css() код должен вызывать drupal_add_library('mymodule', 'mymodule.library').

Преимущество использования hook_library() заключается в следующем:

• Зависимости между библиотеками обрабатываются автоматически. То есть что происходит в случае system_library(), которая определяет две библиотеки, используя следующие определения.

    // Drupal's form library.
    $libraries['drupal.form'] = array(
      'title' => 'Drupal form library', 
      'version' => VERSION, 
      'js' => array(
        'misc/form.js' => array(
          'group' => JS_LIBRARY,
          'weight' => 1,
        ),
      ),
    );
  
    // Drupal's collapsible fieldset.
    $libraries['drupal.collapse'] = array(
      'title' => 'Drupal collapsible fieldset', 
      'version' => VERSION, 
      'js' => array(
        'misc/collapse.js' => array('group' => JS_DEFAULT),
      ), 
      'dependencies' => array(
        // collapse.js relies on drupalGetSummary in form.js
        array('system', 'drupal.form'),
      ),
    );
  

  Вызов drupal_add_library('system', 'drupal.collapse'), misc/collapse.js и misc/form.js будут включены оба.

• Файлы CSS, связанные с библиотекой, будут автоматически загружены вместе с файлами JavaScript.

• Всякий раз, когда библиотека будет использовать больше файлов JavaScript или CSS, код для включения библиотеки не изменится; он по-прежнему будет использовать $form['#attached']['library'][] = array('mymodule', 'mymodule.library');, или drupal_add_library('mymodule', 'mymodule.library').

Нет необходимости использовать current_path(), когда вы можете использовать arg(). Если путь к текущей странице - администратор/структура/блок, то

• arg(0) вернется "admin"
• arg(1) вернет "structure"
• arg(2) вернется "block"

Обновление

hook_init() больше не используется с Drupal 8. Альтернативой для Drupal 8 является использование hook_form_alter(), hook_page_attachments(), или hook_page_attachements_alter(). hook_page_build() и hook_page_alter() больше не используются в Drupal 8.
То, что я сказал об использовании библиотеки JavaScript, по-прежнему верно, даже если предлагается использовать #attached чтобы прикрепить библиотеку (или файл Javascript, или файл CSS) к странице. Drupal 8 больше не позволяет прикреплять к странице только файлы JavaScript или CSS; вам всегда нужно прикреплять библиотеку, которая представляет собой набор файлов JavaScript и CSS, в конечном итоге состоящих только из JavaScript или CSS файлы.