WP customizer frameworkの使い方について

0
いいねをした人: 居ません
  • このトピックには5件の返信、2人の参加者があり、最後にOlein_jpにより6年前に更新されました。
6件の投稿を表示中 - 1 - 6件目 (全6件中)
  • 投稿者
    投稿
  • #6784
    Olein_jp
    参加者
    566

    いつも便利にSnow Monkeyを使わせていただいております。

    Snow Monkeyのカスタマイズに直接関係する質問ではないことをお許しください。
    現在、個人的に100%GPL無償配布テーマを作成しておりまして、そちらでのカスタマイザー機能構築にキタジマ様が公開されているWP Customizer Frameworkを使ってみようと導入してみたところです。

    色々と小手先で触っている程度なのですが、パネルを作成し、セクション、コントロールと追加し、ソースをwp_loaded()経由でインライン書き出しするところまでテストすることができました。

    今後、パネルやセクション等々増やしてカスタマイザー構築を進めようと考えているのですが、スタイルの書き出し部分をSnow Monkeyではどのように処理されているのか知りたくGitHub上でソースコードを探求しておりましたが、その箇所は発見できず…でした。

    下に私のGitHubにも上げている該当箇所部分のコードを掲載させていただきます。

    functions.php

    
    /**
     * Load Customizer
     */
    require_once get_template_directory() . '/inc/customizer/customizer.php';
    
    require_once get_template_directory() . '/inc/customizer/output-style.php';
    

    inc/customizer/customizer.php(ほぼ公式ドキュメントのコピー)

    /**
     * Load WP Customizer Framework
     */
    $customizer = \Inc2734\WP_Customizer_Framework\Customizer_Framework::init();
    
    $customizer->panel( 'design', [
    	'title' => 'sample',
    	'priority' => 1000,
    ] );
    
    $customizer->section(
    	'base-design',
    	[
    		'title'    => __( 'Base design settings', 'snow-monkey' ),
    		'priority' => 100,
    	]
    );
    
    $customizer->control(
    	'color',
    	'accent-color',
    	[
    		'label'    => __( 'Accent color', 'snow-monkey' ),
    		'default'  => '#bd3c4f',
    		'priority' => 100,
    	]
    );
    
    if ( ! is_customize_preview() ) {
    	return;
    }
    
    $panel   = $customizer->get_panel( 'design' );
    $section = $customizer->get_section( 'base-design' );
    $control = $customizer->get_control( 'accent-color' );
    $control->join( $section )->join( $panel );
    

    output-style.php

    
    add_action( 'wp_loaded', function() {
    	$customizer = \Inc2734\WP_Customizer_Framework\Customizer_Framework::init();
    	$cfs = $customizer->styles();
    
    	$accent_color = get_theme_mod( 'accent-color' );
    
    	$cfs->register(
    		[
    			'.c-site-title > a',
    			'.c-site-description',
    		],
    		[
    			"color: {$accent_color}",
    			"border-bottom-color: {$accent_color}",
    		],
    		'@media (min-width: 768px)' // Optional
    	);
    });
    

    このoutput-style.phpファイルでの書き出し処理部分をどのように増築したら良いのか困っております。

    https://github.com/Olein-jp/OleinPress-Media/tree/master/inc/customizer

    御指南いただければ幸いです。よろしくお願いいたします。

    0
    いいねをした人: 居ません
    #6785
    アバター画像キタジマ タカシ
    参加者
    2421

    項目を増やしていく方法には、大きく分けて2パターンあると思います。1つは単純に1ファイルに追加していく方法、もう一つは Snow Monkey のように項目ごとに分割する方法です。それぞれにサンプルを書いてみますね。

    基本的な考え方

    あえて書く必要はないのかもしれませんが、理解しておいたほうがわかりやすいかなと思いますので、まず基本的な考え方を書いておきます。

    「パネルの中のセクションの中のコントロール」という考え方ではなくて、「独立したコントロール、セクション、パネルがそれぞれあり、コントロールをどのセクションに属させるか、セクションをどのパネルに属させるかを定義する」と考えてください。

    単純な方法

    では、まず1ファイルに書いていく方法です。

    $customizer = \Inc2734\WP_Customizer_Framework\Customizer_Framework::init();
    
    $customizer->panel( 'design', [ ... ] );
    $customizer->section( 'base-design', [ ... ] );
    $customizer->control( 'color', 'accent-color', [ ... ] );
    $customizer->control( 'number', 'base-font-size', [ ... ] );
    
    if ( is_customize_preview() ) {
    	$panel_design           = $customizer->get_panel( 'design' );
    	$section_base_design    = $customizer->get_section( 'base-design' );
    	
    	$control_accent_color = $customizer->get_control( 'accent-color' );
    	$control_accent_color->join( $section_base_design )->join( $panel_design );
    	
    	$control_base_font_size = $customizer->get_control( 'base-font-size' );
    	$control_base_font_size->join( $section_base_design )->join( $panel_design );
    }
    
    $customizer->panel( 'layout', [ ... ] );
    $customizer->section( 'header', [ ... ] );
    $customizer->control( 'select', 'header-layout', [ ... ] );
    
    if ( is_customize_preview() ) {
    	$panel_layout   = $customizer->get_panel( 'layout' );
    	$section_header = $customizer->get_section( 'header' );
    	
    	$control_header_layout = $customizer->get_control( 'header-layout' );
    	$control_header_layout->join( $section_header )->join( $panel_layout );
    }
    add_action( 'wp_loaded', function() {
    	$customizer = \Inc2734\WP_Customizer_Framework\Customizer_Framework::init();
    	$cfs = $customizer->styles();
    
    	$accent_color = get_theme_mod( 'accent-color' );
    
    	// accent-color を使ったスタイルの定義を書く
    	$cfs->register( ... );
    
    	// base-font-size を使ったスタイル定義を書く
    	$cfs->register( ... );
    });

    移動中に書いていて実際に試せていないので構文エラーなどがあるかもしれません、その際は適宜修正してください…(すみません><)。

    0
    いいねをした人: 居ません
    #6787
    アバター画像キタジマ タカシ
    参加者
    2421

    項目ごとに分割する方法

    Snow Monkey がとっている方法です。項目が多くて1ファイルだとすごく長くなってしまうので、各パネル、各セクション、各コントロールごとにファイルを分割し、それぞれ include する、という方法をとっています。

    // snow-monkey/functions.php
    
    use Inc2734\Mimizuku_Core\Helper;
    
    $includes = [
    	'/app/customizer',
    ];
    foreach ( $includes as $include ) {
    	Helper\load_theme_files( __DIR__ . $include );
    }

    上記のコードが app/customizer の中にある各カスタマイザーの項目(パネル、セクション、コントロール)を読み込む、という処理になります。Inc2734\Mimizuku_Core\Helper\load_theme_files というメソッドで読み込んでいますが、これは inc2734/mimizuku-core というライブラリの中で定義された関数なので、WP Customizer Framework だけを使いたい場合は使用できません。なので、うーん、ちょっとめんどうですが、1ファイルずつ include させるのが簡単かもしれません。こんな感じ。読み込み順番は、パネル、セクション、コントロールになるようにする必要があります(多分そうしないと未定義でコケちゃう)。

    include_once ( get_template_directory() . '/app/customizer/design/panel.php' );
    include_once ( get_template_directory() . '/app/customizer/design/sections/base-design/section.php' );
    include_once ( get_template_directory() . '/app/customizer/design/sections/base-design/controls/accent-color.php' );
    include_once ( get_template_directory() . '/app/customizer/design/sections/base-design/controls/base-font-size.php' );
    include_once ( get_template_directory() . '/app/customizer/layout/panel.php' );
    include_once ( get_template_directory() . '/app/customizer/layout/sections/header/section.php' );
    include_once ( get_template_directory() . '/app/customizer/layout/sections/header/controls/header-layout.php' );

    あとは、Snow Monkey のファイルを参考に見てもらえればと思います。

    次に、スタイルの定義についてです。これは snow-monkey/app/setup/customizer-styles.php で各スタイル定義用のファイルを読み込んでいます。こちらも inc2734/mimizuku-core のメソッドを使ったりしているので、単純化すると下記のような感じです。

    add_action(
    	'wp_loaded',
    	function() {
    		include_once( get_template_directory() . '/assets/css/foundation/_body/_body.php' );
    		include_once( get_template_directory() . '/assets/css/object/component/_btn/_btn.php' );
    		...
    	},
    	11 // この数字は Snow Monkey デザインスキンを動作させる都合で必要なものなので、なくても構いません
    );

    /assets/css/foundation/_body/_body.php などのコードは Snow Monkey のファイルを参考にしてみてください。


    わからない、動かない、などあればお気軽に書き込みどうぞ!

    0
    いいねをした人: 居ません
    #6788
    Olein_jp
    参加者
    566

    「パネルの中のセクションの中のコントロール」という考え方ではなくて、「独立したコントロール、セクション、パネルがそれぞれあり、コントロールをどのセクションに属させるか、セクションをどのパネルに属させるかを定義する」と考えてください

    この考え方、全然できておらず目から鱗でした。ありがとうございます。

    結果的に、前者の「単純な方法」で試してみて、うまい具合にコントロールを新規追加し、プレビューも問題なく、スタイルをページに書き出すことができました。

    
    /**
     * Load WP Customizer Framework
     */
    $customizer = \Inc2734\WP_Customizer_Framework\Customizer_Framework::init();
    
    $customizer->panel( 'design', [
    	'title' => 'sample',
    	'priority' => 1000,
    ] );
    
    $customizer->section(
    	'base-design',
    	[
    		'title'    => __( 'Base design settings', 'snow-monkey' ),
    		'priority' => 100,
    	]
    );
    
    $customizer->control(
    	'color',
    	'accent-color',
    	[
    		'label'    => __( 'Accent color', 'snow-monkey' ),
    		'default'  => '#bd3c4f',
    		'priority' => 100,
    	]
    );
    
    $customizer->control(
    	'color',
    	'description-color',
    	[
    		'label'    => __( 'Descriptioncolor', 'snow-monkey' ),
    		'default'  => '#bd3c4f',
    		'priority' => 110,
    	]
    );
    

    このような感じです。

    この後に

    
    if ( ! is_customize_preview() ) {
    	return;
    }
    
    $panel_design              = $customizer->get_panel( 'design' );
    $section_base_design       = $customizer->get_section( 'base-design' );
    $control_accent_color      = $customizer->get_control( 'accent-color' );
    $control_description_color = $customizer->get_control( 'description-color' );
    
    $control_accent_color->join( $section_base_design )->join( $panel_design );
    $control_description_color->join( $section_base_design )->join( $panel_design );
    

    とありますが、

    
    if ( ! is_customize_preview() ) {
    	return;
    } else {
    
    	$panel_design              = $customizer->get_panel( 'design' );
    	$section_base_design       = $customizer->get_section( 'base-design' );
    	$control_accent_color      = $customizer->get_control( 'accent-color' );
    	$control_description_color = $customizer->get_control( 'description-color' );
    
    	$control_accent_color->join( $section_base_design )->join( $panel_design );
    	$control_description_color->join( $section_base_design )->join( $panel_design );
    
    }
    

    こうする必要は特にありませんか?特段、挙動が変わるわけではないようですが、いただきましたコードに、

    
    if ( is_customize_preview() ) {
    	$panel_layout   = $customizer->get_panel( 'layout' );
    	$section_header = $customizer->get_section( 'header' );
    	
    	$control_header_layout = $customizer->get_control( 'header-layout' );
    	$control_header_layout->join( $section_header )->join( $panel_layout );
    }
    

    という記述箇所があったので、こういう処理にした方が良いのかな?とか、素人的に思いましたので…(間違っていると思います…

    —–

    重ねてお聞きしたいのですが、上記の流れでカスタマイザーを実装していくつもりなのですが、例えばレイアウトの変更などはスタイルの書き出しではなく、条件分岐で読み込むファイルを変える、もしくはCSSクラスを切り替えるなどの処理が必要になってくると思いますが、そちらの方法に関して何かアドバイスいただければ幸いです。

    よろしくお願いいたします。

    0
    いいねをした人: 居ません
    #6789
    アバター画像キタジマ タカシ
    参加者
    2421

    こうする必要は特にありませんか?

    PHPMD で「else 使うな!」と怒られるんで、必要ないときは使わないクセがつきました^^; 挙動は変わらないのでどちらでも好きなほうで良いと思います。

    例えばレイアウトの変更などはスタイルの書き出しではなく、条件分岐で読み込むファイルを変える、もしくはCSSクラスを切り替えるなどの処理が必要になってくると思いますが、そちらの方法に関して何かアドバイスいただければ幸いです。

    カスタマイザーの設定値は get_theme_mod( 'xxx' ); で取得できるので、その値で分岐させたりすることになりますね。例えば、

    $output_description = get_theme_mod( 'output-description' );
    if ( true === $output_description ) {
      // description を出力
    }

    みたいな。

    0
    いいねをした人: 居ません
    #6790
    Olein_jp
    参加者
    566

    ありがとうございます!!

    分岐も問題なく動かすことができました!!
    あとはもう少しWP Costomizer Frameworkの内部を覗いてどんなことできるのか研究して見たいと思います。

    ご指南いただきましてありがとうございました!!

    0
    いいねをした人: 居ません
6件の投稿を表示中 - 1 - 6件目 (全6件中)
  • トピック「WP customizer frameworkの使い方について」には新しい返信をつけることはできません。

ドキュメント

Snow Monkey の設定方法やマニュアルを掲載しています。

ドキュメント

フォーラム

Snow Monkey の使い方やカスタマイズについてのご質問・ご要望等はサポートフォーラムで行っています。サポートフォーラムは誰でも閲覧できますが、書き込みできるのは Snow Monkey 購入者のみとなります。

サポートフォーラム

よくあるご質問

Snow Monkey のサービスについて不明な点がある場合は、まずはよくあるご質問をご確認ください。

よくあるご質問

お問い合わせ

よくあるご質問を見ても解決しなかった場合、試用版の申請については問い合わせフォームからお願いいたします。

お問い合わせ

Snow Monkey は Gutenberg ブロックエディターに対応した 100%GPL の WordPress テーマです。拡張性を意識した開発をおこなっており、カスタマイザーとブロックでスピーディーにサイトを立ち上げるだけでなく、CSS やフックを駆使した高度なカスタマイズにも柔軟に対応できます。