WordPress 画像の alt が空・未設定のときに記事タイトルを自動で設定する(functions.php)

WordPress 6.5.2
広告WordPress・PHP を学べる本

Amazonのアソシエイトとして、WordPress functions.phpは適格販売により収入を得ています。

概要説明

記事内の画像の alt が空・未設定のとき、記事タイトルを自動で入れる functions.php のコード。alt 属性がない画像や記号を含むタイトルにも対応し、飾りの画像はそのまま残します。WordPress 6.2 以降。

画像の alt に記事タイトルを自動で設定するコード

画像の alt(代替テキスト)は、画像が表示できないときや、読み上げソフトで読むときに使われる説明です。検索エンジンも、画像の内容を知る手がかりにしています。

ふだんはメディアの「代替テキスト」に入力していても、記事が増えると入力忘れが出てきます。このコードは、alt が空、または alt がない画像だけに、その記事のタイトルを自動で設定します。すでに設定している alt は変えません。

functions.php
/*----------------------------------------------------
 記事内の画像の alt が空・ないときに、記事のタイトルを設定する
----------------------------------------------------*/
if ( ! function_exists( 'fs_auto_alt_from_title' ) ) {
    function fs_auto_alt_from_title( $content ) {
        if ( is_admin() || false === strpos( $content, '<img' ) ) {
            return $content;
        }

        // タイトルはタグを外した元の文字で使う(get_the_title() は記号が &#8211; などに変わるため)
        $title = trim( wp_strip_all_tags( get_post_field( 'post_title', get_the_ID() ) ) );
        if ( '' === $title ) {
            return $content;
        }

        // WordPress 6.2 より前は、HTML を書き換える仕組み(WP_HTML_Tag_Processor)がないので何もしない
        if ( ! class_exists( 'WP_HTML_Tag_Processor' ) ) {
            return $content;
        }

        $tags = new WP_HTML_Tag_Processor( $content );
        while ( $tags->next_tag( 'img' ) ) {
            // 飾りの画像の目じるし(role="presentation"・aria-hidden="true")があるものは、わざと alt を空にしているので変えない
            if ( 'presentation' === $tags->get_attribute( 'role' ) || 'true' === $tags->get_attribute( 'aria-hidden' ) ) {
                continue;
            }
            $alt = $tags->get_attribute( 'alt' );
            // alt がない(null)・値なしの alt(true)・空白だけの alt のとき、タイトルを設定する
            if ( null === $alt || true === $alt || '' === trim( (string) $alt ) ) {
                $tags->set_attribute( 'alt', $title );
            }
        }

        return $tags->get_updated_html();
    }
    add_filter( 'the_content', 'fs_auto_alt_from_title', 20 );
}

HTML を安全に書き換える WP_HTML_Tag_Processor を使っています。6.2 より前の WordPress では何もしません。

コードがしていること

  • 記事の本文(the_content)を表示する直前に、本文の中の img タグを 1 つずつ見ます。
  • alt がない・空・空白だけのときに、記事タイトルを設定します。
  • すでに alt が設定されている画像は、そのままにします。
  • role="presentation" や aria-hidden="true" が付いた画像は、飾りとしてわざと alt を空にしているものなので変えません。
  • タイトルは HTML のタグを外して使います。「&」や「"」などの記号も、正しく alt に設定されます。
  • 管理画面では動かしません。

設定前、設定後

WordPress 画像の alt が空・未設定のときに記事タイトルを自動で設定する(functions.php)
WordPress 画像の alt が空・未設定のときに記事タイトルを自動で設定する(functions.php)

確認の方法

  1. コードを追加したあと、alt を設定していない画像がある記事を開きます。
  2. 画像を右クリックして「検証」(Chrome の開発ツール)を開くか、ページのソースを表示します。
  3. img タグの alt に、記事タイトルが設定されていれば成功です。

キャッシュのプラグイン(WP-Optimize など)を使っている場合は、キャッシュを消してから確認してください。

使うときの注意

  • alt は本来、画像ごとの説明を入力するものです。このコードは入力忘れの保険として使い、大事な画像にはメディアの「代替テキスト」で個別の説明を入力するのがおすすめです。
  • 同じ記事の画像には、すべて同じ alt(記事タイトル)が入ります。
  • テーマを更新しても消えないように、子テーマの functions.php か、Code Snippets などのプラグインに追加してください。
  • 記事の本文の中の画像だけが対象です。アイキャッチやウィジェットの画像は変わりません。

前に載せていたコードからの変更点

以前は、本文の中の「alt=""」という文字を置きかえるだけのコードを載せていました。この方法では、次のことができませんでした。

  • alt そのものがない画像(<img src="…"> だけのもの)には設定されない
  • タイトルに記号があると、alt の内容が崩れることがある
  • 飾りの画像(わざと alt を空にしたもの)にもタイトルが入ってしまう

WordPress 6.2 から使える WP_HTML_Tag_Processor で書き直し、これらに対応しました(2026 年 10 月・WordPress 7.1 で動作を確認しました)。

参考

SiteBeacon(サイトビーコン)

サイトが止まったら、すぐに気づける。

ホームページを 5 分ごとにチェックして、止まったとき・エラーが出たとき・SSL やドメインの期限が近いときに、メールでお知らせします。2 サイトまでは、ずっと無料で使えます。

SiteBeacon を見る サイトを直す相談をする

監視で気づいたあとの直す作業も、同じ担当がお受けします。