説明
WP_Post | WP_Error wp_update_custom_css_post( string $css [ , array $args = array() ] )
カスタマイザーの追加CSS情報を更新する。
パラメータ
- $cssCSSを指定。
- $argsスタイルシート名などを含んだ連想配列を指定(省略時はarray())。
返り値
CSSを更新した場合はCSS情報((投稿情報オブジェクト))を返す。更新できなかった場合はWP_Errorオブジェクトを返す。
注意
カスタマイザーでテーマに追加されるCSSは、カスタム投稿タイプ'custom_css'としてスタイルシート名ごとに保存される。テーマに追加CSS情報がある場合は更新となるが、それがない場合は追加される。
各パラメータの内容はCSS情報の各プロパティに格納される。
| プロパティ | パラメータ | 省略時 |
|---|---|---|
| post_title | $args['stylesheet'] | 現在のテーマのスタイルシート名 |
| post_name | sanitize_title( $args['stylesheet'] ) | 上記のスタイルシート名をサニタイズしたもの |
| post_content | $css | - |
| post_content_filtered | $args['preprocessed'] | '' |
使用例
- 現在のテーマの追加CSS情報を更新する。
<?php wp_update_custom_css_post( $css ); ?> - $stylesheetで指定したスタイルシート名の追加CSS情報を更新する。
<?php wp_update_custom_css_post( $css, array( 'stylesheet' => $stylesheet ) ); ?>
フィルター
[4.7.0]追加CSS情報を更新する前に'update_custom_css_data'フィルターを呼び出す。パラメータ$dataには連想配列(キー'css'、'preprocessed')が、$argsには連想配列(キー'css'、'preprocessed'、'stylesheet')が格納されている。$data = apply_filters( 'update_custom_css_data', $data, $args );アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/theme.php最終更新 : 2019年10月18日 11:08
関連
お勧め
任意の名前でエラーログファイルを指定する(2019年2月15日 更新)
来週にはWordPress 5.1がリリース。RC1のソースコードを見ていると、 wp_debug_mode関数が変更されており、興味深かった。
Gutenbergでカスタムフィールドを使う(2018年8月10日 更新)
Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。
Slightly troublesome permalink:プラグイン作ってみました(2021年4月20日 更新)
カテゴリーを含んだパーマリンクを設定している場合、複数のカテゴリーを指定した投稿記事のパーマリンクのURLに目的のカテゴリーとは異なるカテゴリーが適用された経験はないだろうか。このプラグインは、パーマリンクに適用されるカテゴリーをコントロールし、希望通りのパーマリンクを設定します。WP_Postオブジェクトで投稿情報を直感的に使う(2012年10月4日 更新)
WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。テキストエディタの文字を変更する(2018年5月27日 更新)
テキストエディタ(投稿ページの「テキスト」タブのエディタ)に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。