cdbt_assets

(CDBT 2.0.0)

cdbt_assetsWEBフロントエンドに読み込まれるスタイルやJavaScriptを変更するフィルター

Description

array cdbt_assets ( array $assets )
WEBフロントエンドに読み込まれるスタイルやJavaScriptを変更するフィルター。このフィルターはWordPressのアクションフックwp_enqueue_scripts()内のプラグイン用のアセット読み込み定義処理をフィルターします。CDBTプラグインではWEBフロントエンドでのアセット処理はショートコード出力時のみなので、このフィルターはショートコード利用時に有効になります。
Notice:フィルターのタイミングは、管理画面の「プラグイン設定 – インクルードアセット設定」の設定値反映後になります。

Parameters

assets
現在のページで読み込まれるスタイルシートとJavaScriptのインクルードアセット定義配列です。

インクルードアセット定義配列の構成要素は下記のようになります。
array(
  ['styles'] => array(
    [{スタイルシートのハンドル名}] => array(
      `wp_enqueue_style()`用の定義配列
    ), 
    ...
  ), 
  ['scripts'] => array(
    [{スクリプトのハンドル名}] => array(
      `wp_enqueue_script()`用の定義配列
    ), 
    ...
  )
)

History

バージョン 内容
2.0.0 新規追加

Example

1. ショートコード用のアセットをテーマ側で独自に読み込む。

<?php
function my_custom_assets( $assets ) {
  // Include styles via cdn
  $assets['styles']['bootstrap-style'] = array( '//maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css', true, '3.3.5', 'all' );
  $assets['styles']['fuelux-style'] = array( '//www.fuelcdn.com/fuelux/3.13.0/css/fuelux.min.css', array( 'bootstrap-style' ), '3.13.0', 'all' );
  $assets['styles']['cdbt-main-style'][1] = array( 'fuelux-style' );
  // Include script via cdn
  wp_deregister_script( 'underscore' );
  $assets['scripts']['underscore'] = array( 'https://rawgithub.com/jashkenas/underscore/master/underscore-min.js', array( 'jquery' ), '1.8.3', true );
  $assets['scripts']['bootstrap-script'] = array( '//maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js', array( 'jquery' ), '3.3.5', true );
  $assets['scripts']['fuelux-script'] = array( '//www.fuelcdn.com/fuelux/3.13.0/js/fuelux.min.js', array( 'bootstrap-script' ), '3.13.0', true );
  $assets['scripts']['cdbt-main-script'][1] = array( 'fuelux-script' );
  return $assets;
}
add_filter( 'cdbt_assets', 'my_custom_assets' );
上記の例は、あらかじめ「プラグイン設定 – インクルードアセット設定」でフロントエンドのアセット読み込みをすべてOFFにしておいた場合に有効です

2. ショートコード用の独自スタイルを追加で読み込む。

<?php
function my_custom_assets( $assets ) {
  $assets['styles']['my-custom-style'] = array( '/wp-content/theme/my-theme/css/my-custom-style.css', array( 'cdbt-main-style' ), '', 'all' );
  return $assets;
}
add_filter( 'cdbt_assets', 'my_custom_assets' );

Reference

Related Codex

Related Hooks

  • cdbt_admin_assets管理画面に読み込まれるスタイルやJavaScriptを変更するフィルター