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



お勧め

Gutenbergでカスタムフィールドを使う(2018年8月10日 更新)

Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。

さくらのVPSでKUSANAGI(2018年5月27日 更新)

請け負っていた業務が一段落したので、「さくらのVPS」で「KUSANAGI」を試してみました。推奨環境はメモリ4GBとなっているが、今回は実験的な利用なので、SSD 2GBプランでトライしました。

ホームディレクトリから過去のファイルを削除する(2013年1月27日 更新)

WordPressで構築したサイトのホームディレクトリには、現在使われていないファイルが残っている時がある。3.5.1もリリースされたことだし、これを機にホームディレクトリを整理整頓した。

「Align widgets horizontally」プラグインのフィルター使用例(2024年5月15日 更新)

ダッシュボードのウィジェットを横並びに変える「Align widgets horizontally」プラグインには緒設定を変更できるフィルターが用意されている。ここではフィルターの使い方と設定できる項目について紹介する。

各投稿記事で設定されているカスタムフィールドの値を取得するには(2011年9月16日 更新)

投稿記事ごとに設定されているカスタムフィールドの値は get_post_meta関数で取得できるが、すべての投稿記事で設定されているカスタムフィールドの値を一覧を取得する関数が見当たらない。カテゴリーや投稿タグのようにそれぞれの値と実際に使用されている投稿記事件数を取得したいのだが、探し方が悪いのか見つからないのだ。