WordPressでサイドバーを作成・取得するPHP関数の説明

register_sidebar() (サイドバーの作成)
ウィジェットを配置するサイドバーを作成します。この関数を使用する場合は関数内に組み込み、「widgets_init」フックにマウントしてください。

使用法

register_sidebar( $args );

引数

$args

(文字列 | 配列) (オプション) 作成するサイドバーの引数。

デフォルト値:

$args = array(
  'name'     => __( 'Sidebar name', 'theme_text_domain' ),
  'id'      => 'unique-sidebar-id',
  'description'  => '',
  'class'     => '',
  'before_widget' => '<li>',
  'after_widget' => '</li>',
  'before_title' => '<h2>',
  'after_title'  => '</h2>'
);

配列パラメータの概要:

• name: サイドバー名
• id: サイドバーID、小文字である必要があり、デフォルトは増加する配列IDです
• description: サイドバーの説明
• class: 追加クラス
• before_widget内のウィジェットの場合:
• after_widget内のウィジェットの先頭のHTMLコード
• before_title内のウィジェットの最後にあるHTMLコード
• before_title内のウィジェットのタイトルの先頭のHTML コード

例

register_sidebar( array(
  'name'     => __( '右边的侧边栏' ),
  'id'      => 'sidebar-1',
  'description' => __( '右侧边栏的小工具。' ),
  'before_title' => '<h3>',
  'after_title' => '</h3>',
));

その他

関数は次の場所にあります: wp-includes/widgets.php

get_sidebar() はサイドバーテンプレートを導入するために使用されます。名前を指定すると、現在のテーマのルート ディレクトリにあるsidebar-{name}.php ファイルがインポートされます。指定しない場合は、現在のテーマのルート ディレクトリにあるsidebar.php ファイルがインポートされます。 , wp-includes/theme-compat/sidebar.php がインポートされます。

Usage

get_sidebar( $name );

Parameters

$name

(文字列) (オプション) テンプレートの名前を導入します。指定すると、現在のテーマのルート ディレクトリにあるsidebar-{$name}.php ファイルが導入されます。 。

デフォルト値: なし

例

以下のコードは、現在のテーマのルートディレクトリにsidebar.phpファイルをインポートします:

<&#63;php get_sidebar(); &#63;>

以下のコードは、ルートにsidebar-left.phpファイルをインポートします現在のテーマのディレクトリ:

<&#63;php get_sidebar( 'left' ); &#63;>

次の例では、左側のサイドバー (sidebar-left.php) と右側のサイドバー (sidebar-right.php) をそれぞれ紹介します:

<?php get_header(); ?>
<&#63;php get_sidebar( 'left' ); &#63;>

<&#63;php get_sidebar( 'right' ); &#63;>
<&#63;php get_footer(); &#63;>

その他

この関数の場所：wp-includes/general-template.php

上記は、WordPress でサイドバーを作成および取得するために使用される PHP 関数の紹介であり、関連コンテンツも含めて、PHP チュートリアルに興味のある友人に役立つことを願っています。