wpseo_upsert_meta()

WordPressの関数wpseo_upsert_meta()は、Yoast SEOプラグインによるメタ情報の挿入または更新を行うために使用されます。この関数は、特定の投稿またはタクソノミーに関連付けられたSEOメタデータを管理する際に役立ちます。

構文

wpseo_upsert_meta( array $meta_data, int $object_id, string $object_type );

引数の説明:

• $meta_data (array) — メタデータのキーと値のペア。
• $object_id (int) — メタデータが関連付けられる投稿またはタクソノミーのID。
• $object_type (string) — メタデータが関連付けられるオブジェクトの種類（例: 'post', 'term'）。

例1: 投稿のタイトルをSEOメタ情報として追加

投稿のタイトルをSEOメタデータとして保存する例です。

wpseo_upsert_meta( array( 'title' => get_the_title() ), get_the_ID(), 'post' );

例2: カスタムメタ説明を設定

特定の投稿にカスタムメタ説明を設定します。

wpseo_upsert_meta( array( 'metadesc' => 'これはカスタムメタ説明です。' ), get_the_ID(), 'post' );

例3: タクソノミー用のメタ情報を追加

特定のカテゴリにSEOメタ情報を設定します。

wpseo_upsert_meta( array( 'title' => 'カスタムカテゴリタイトル' ), get_term_by( 'slug', 'example-category', 'category' )->term_id, 'term' );

例4: 動的なキーワードの設定

投稿のタグをSEOメタキーワードとして保存します。

wpseo_upsert_meta( array( 'focuskw' => implode( ', ', wp_get_post_tags( get_the_ID(), array( 'fields' => 'names' ) ) ) ), get_the_ID(), 'post' );

例5: メタデータの一括更新

複数のメタデータを一括で更新します。

wpseo_upsert_meta( array(
    'title' => get_the_title(),
    'metadesc' => 'カスタム説明テキスト',
    'focuskw' => 'カスタムキーワード'
), get_the_ID(), 'post' );

注意点

• $meta_dataのキーはYoast SEOがサポートする正しいキーを使用してください。
• $object_idと$object_typeは、正しいオブジェクトと関連付けられる必要があります。
• この関数はYoast SEOプラグインに依存しており、プラグインが有効化されていないと動作しません。