Como posso alterar o JavaScript de um módulo?

11

Preciso alterar o código JavaScript do módulo "Webform AJAX". Isso é possível sem invadir o módulo e correr o risco de perder tudo com as atualizações do módulo?

dibs
fonte

Respostas:

19

Você pode usar hook_js_alter () em um módulo. Por exemplo, esse código substitui a biblioteca jQuery usada pelo Drupal pelo arquivo presente no diretório jquery_update.

function jquery_update_js_alter(&$javascript) {
  // Swap out jQuery to use an updated version of the library.
  $javascript['misc/jquery.js']['data'] = drupal_get_path('module', 'jquery_update') . '/jquery.js';
} 

O mesmo pode ser feito para o código JavaScript embutido. As diferenças são:

  • Em vez de 'misc/jquery.js', o primeiro índice é um número
  • $javascript[$index]['data'] conterá o código JavaScript

Isso significa que primeiro você precisa encontrar a entrada para o código JavaScript substituir e depois alterá-lo. O código a seguir deve funcionar nesse caso.

function mymodule_js_alter(&$javascript) {
  $old_code = 'The code to alter';
  $new_code = 'The new code';

  foreach ($javascript as $index => $info) {
    if (is_numeric($index) && $info['data'] == $old_code) {
      $javascript[$index]['data'] = $new_code;
      break;
    }
  }
}

Como alternativa, se você precisar alterar a biblioteca implementada por um módulo, poderá implementar hook_library_alter () . Por exemplo, esse é o código implementado pela versão mais recente do módulo jQuery Update .

function jquery_update_library_alter(&$javascript, $module) {

  // We are updating just the system module. For all other cases we return.
  if ($module != 'system') {
    return;
  }

  $path = drupal_get_path('module', 'jquery_update');

  // Make sure we inject either the minified or uncompressed version as desired.
  $min = variable_get('jquery_update_compression_type', 'min') == 'none' ? '' : '.min';
  $cdn = variable_get('jquery_update_jquery_cdn', 'none');

  // Replace jQuery with the latest version.
  $version = variable_get('jquery_update_jquery_version', '1.5');
  jquery_update_jquery_replace($javascript, $cdn, $path, $min, $version);

  // Replace jQuery UI with CDN or local files. If from a CDN include all of jQuery UI.
  jquery_update_jqueryui_replace($javascript, $cdn, $path, $min);

  // Replace the jQuery Cookie plugin.
  $javascript['cookie']['js']['misc/jquery.cookie.js']['data'] = $path . '/replace/ui/external/jquery.cookie.js';
  // Noting the version based on git commit as no version number is available.
  $javascript['cookie']['version'] = '67fb34f6a866c40d0570';

  // Replace jQuery Form plugin.
  $javascript['jquery.form']['js']['misc/jquery.form.js']['data'] = $path . '/replace/misc/jquery.form' . $min . '.js';
  $javascript['jquery.form']['version'] = '2.69';

  // Replace files for jQuery 1.7 and up
  if (version_compare($version, '1.7', '>=')) {
    $javascript['drupal.states']['js']['misc/states.js']['data'] = $path . '/replace/misc/1.7/states.js';
  }
}

Isso também é válido para o código JavaScript usado pelo núcleo do Drupal, pois para esses arquivos JavaScript, o módulo System implementa hook_library () . (Consulte system_library () .)

hook_js_alter()pode ser usado para qualquer arquivo / código JavaScript, mesmo para arquivos usados ​​pelo núcleo do Drupal. Entre hook_js_alter()e hook_library_alter(), é preferível implementar o último, quando os arquivos JavaScript são expostos como biblioteca.

kiamlaluno
fonte