この記事は最後に更新してから1年以上経過しています。
説明
ダッシュボードのウィジェットを横並びに変える「Align widgets horizontally」プラグインには緒設定を変更できるフィルターが用意されている。ここではフィルターの使い方と設定できる項目について紹介する。
フィルター名はネームスペース付き
「Align widgets horizontally」プラグインのフィルターの使い方は次の通りで、フィルター名は「ネームスペース\プラグイン名\settings」になっている。
add_filter( 'jp12net\align_widgets_horizontally\settings', 'align_widgets_settings' );
function align_widgets_settings( $settings ) {
// ここで$settingsの内容を変更
return $settings;
}
フィルター名にネームスペースを付けた理由は、今回プラグインを公開するにあたりプラグインレビューチームから他のプラグインとの衝突を避ける目的でネームスペースを使用するように指摘されたため。今後は他のプラグインでもネームスペースを使用していくことになりそう。
変更可能な項目
次の表は、上記の$settingsに指定できるキーの一覧になる。
| キー | デフォルト値 | 内容 |
|---|---|---|
| 'upper_grow_number' | 5 | flex伸長係数の上限 |
| 'gap_number' | 20 | ギャップ数 |
| 'unit_gap_number' | 'px' | ギャップ数の単位('px'、'em'、'rem'、'%'のいずれか) |
| 'height_empty_container' | 300 | 空のコンテナの高さ(単位はpx) |
| 'upper_height_helper' | 300 | ドラッグ中のウィジェットの高さ(高さはpx) |
| 'gray_border_color' | '#c3c4c7' | 境界線の色指定 |
| 'dark_border_color' | '#646970' | 暗い境界線の色指定 |
| 'prefix_text_grow' | '\02715' | flex伸長係数入力ボックス内のプレフィックス |
| 'always_show_emptystring' | true | 空のコンテナにテキストを表示する場合はtrueを指定 |
| 'emphasize_placeholders' | true | ドラッグ中のウィジェットがあった場所を強調表示する場合はtrueを指定 |
例えば、flex伸長係数入力ボックス内のプレフィックスを変更する場合、フィルターのコールバック関数は次のようになる。
function align_widgets_settings( $settings ) {
$settings['prefix_text_grow'] = '幅';
return $settings;
}
プラグインで気になることがあったら、こんな感じで調整してほしい。
最終更新 : 2024年05月15日 15:58
お勧め
wp_revisions_to_keep(2023年4月4日 更新)
int wp_revisions_to_keep( WP_Post $post )
投稿情報のリビジョン数を取得する。
get_month_link(2012年2月2日 更新)
string get_month_link( mixed $year, mixed $month )
月アーカイブのURLを取得する。
get_site_icon_url(2020年4月2日 更新)
string get_site_icon_url( [ int $size = 512 [ , string $url = '' [ , int $blog_id = 0 ] ] ] )
サイトアイコンのURLを取得する。
is_singular(2026年8月20日 更新)
bool is_singular( [ mixed $post_types = '' ] )
要求されているページが、投稿またはページか調べる。
wp_strip_all_tags(2018年5月27日 更新)
string wp_strip_all_tags( string $string [ , bool $remove_breaks = false ] )
文字列からHTMLタグを取り除く。