wp_update_custom_css_post

説明

WP_Post | WP_Error wp_update_custom_css_post( string $css [ , array $args = array() ] )
カスタマイザーの追加CSS情報を更新する。

パラメータ

  • $css
    CSSを指定。
  • $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で追加したテキストエディタのフォント切り替え機能について紹介する。