أضف ملفات 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 ، يمكن تضمينها في القسم الإداري ، اعتمادًا على الإعداد الموجود على admin/المظهر.

يتم إرجاع قائمة مسارات العقدة التي يمكن تضمينها في الصفحات الإدارية من 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;

إذا احتجت ، لأي سبب من الأسباب ، إلى تجنب أي صفحة بمسار مثل العقدة/* ، فأنت بحاجة إلى إضافة رمز معين لتجنبها ، إذا كنت تستخدم 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 () . إذا كان مسار الصفحة الحالية هو admin/structure/block ، فحينئذٍ

• 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.
ما قلته عن استخدام مكتبة جافا سكريبت لا يزال صحيحًا ، حتى إذا كان من المقترح استخدام #attached لإرفاق مكتبة (أو ملف جافا سكريبت ، أو CSS ملف) إلى صفحة. Drupal 8 لم يعد يسمح بعد الآن بإرفاق ملفات JavaScript أو CSS إلى الصفحة فقط ؛ فأنت بحاجة دائمًا إلى إرفاق مكتبة ، والتي تكون مجموعة من ملفات JavaScript و CSS ، مصنوعة في النهاية من JavaScript فقط أو ملفات CSS.