wp_set_unique_slug_on_create_template_part()


WordPressのwp_set_unique_slug_on_create_template_part()関数は、テンプレートパーツを作成する際にユニークなスラッグを自動的に設定するために使用されます。これにより、同じ名前のテンプレートパーツが存在する場合でも、重複を避けることができます。

構文

wp_set_unique_slug_on_create_template_part( string $slug, string $theme, string $type );

引数の説明:

  • $slug (string) — テンプレートパーツのスラッグ。
  • $theme (string) — テンプレートパーツが属するテーマの名前。
  • $type (string) — テンプレートパーツのタイプ（例: ‘header’, ‘footer’）。

例1: 基本的なテンプレートパーツの作成

この例では、ヘッダーテンプレートパーツを作成し、ユニークなスラッグを設定します。

wp_set_unique_slug_on_create_template_part( 'my-header', 'my-theme', 'header' );

例2: フッターテンプレートパーツの作成

フッターテンプレートパーツを作成し、ユニークなスラッグを設定します。

wp_set_unique_slug_on_create_template_part( 'my-footer', 'my-theme', 'footer' );

例3: カスタムタイプのテンプレートパーツ

カスタムタイプのテンプレートパーツを作成し、ユニークなスラッグを設定します。

wp_set_unique_slug_on_create_template_part( 'custom-part', 'my-theme', 'custom' );

例4: 既存のスラッグを確認

既存のスラッグが存在する場合、新しいスラッグを自動的に生成します。

wp_set_unique_slug_on_create_template_part( 'existing-slug', 'my-theme', 'header' );

例5: 異なるテーマでの使用

異なるテーマでテンプレートパーツを作成し、ユニークなスラッグを設定します。

wp_set_unique_slug_on_create_template_part( 'another-header', 'another-theme', 'header' );

例6: タイプを指定しない場合

タイプを指定しない場合、デフォルトのタイプが使用されます。

wp_set_unique_slug_on_create_template_part( 'no-type-part', 'my-theme', '' );

例7: スラッグのみを指定

スラッグのみを指定し、テーマとタイプはデフォルト値を使用します。

wp_set_unique_slug_on_create_template_part( 'slug-only', '', '' );

注意点

  • この関数は、テンプレートパーツを作成する際にのみ使用されます。既存のテンプレートパーツのスラッグを変更する場合は、別の方法を使用する必要があります。
  • スラッグが既に存在する場合、自動的にユニークなスラッグが生成されますが、スラッグの長さや形式に注意が必要です。

関連機能：