WordPressでパンくずリストを自作する方法：SEOプラグインを使わない軽量化と構造化データ対応の解説

/**
 * WordPress 自作パンくずリスト生成関数
 */
function get_custom_breadcrumbs() {
    // グローバル変数の宣言
    global $post;

    // パンくずのリストを格納する配列
    $breadcrumbs = array();

    // ホーム（トップページ）の情報
    $breadcrumbs[] = array(
        'name' => 'ホーム',
        'url'  => home_url('/')
    );

    // 固定ページの場合
    if ( is_page() && !$post->post_parent ) {
        // 親ページがない固定ページ
        $breadcrumbs[] = array(
            'name' => get_the_title(),
            'url'  => ''
        );
    } elseif ( is_page() && $post->post_parent ) {
        // 親ページがある固定ページ（階層を遡る）
        $ancestors = array_reverse(get_post_ancestors($post->ID));
        foreach ($ancestors as $ancestor) {
            $breadcrumbs[] = array(
                'name' => get_the_title($ancestor),
                'url'  => get_permalink($ancestor)
            );
        }
        $breadcrumbs[] = array(
            'name' => get_the_title(),
            'url'  => ''
        );
    }

    // 投稿ページ（カテゴリー）の場合
    if ( is_single() && !is_attachment() ) {
        if ( get_post_type() != 'post' ) {
            // カスタム投稿タイプの場合
            $post_type = get_post_type_object(get_post_type());
            $breadcrumbs[] = array(
                'name' => $post_type->labels->name,
                'url'  => get_post_type_archive_link(get_post_type())
            );
        } else {
            // 通常の投稿（カテゴリーを表示）
            $category = get_the_category();
            if ( !empty($category) ) {
                $cat = $category[0];
                $cat_ancestors = array_reverse(get_ancestors($cat->term_id, 'category'));
                foreach ($cat_ancestors as $ancestor) {
                    $breadcrumbs[] = array(
                        'name' => get_cat_name($ancestor),
                        'url'  => get_category_link($ancestor)
                    );
                }
                $breadcrumbs[] = array(
                    'name' => $cat->name,
                    'url'  => get_category_link($cat->term_id)
                );
            }
        }
        // 記事タイトル
        $breadcrumbs[] = array(
            'name' => get_the_title(),
            'url'  => ''
        );
    }

    // カテゴリーアーカイブの場合
    if ( is_category() ) {
        $cat = get_queried_object();
        $cat_ancestors = array_reverse(get_ancestors($cat->term_id, 'category'));
        foreach ($cat_ancestors as $ancestor) {
            $breadcrumbs[] = array(
                'name' => get_cat_name($ancestor),
                'url'  => get_category_link($ancestor)
            );
        }
        $breadcrumbs[] = array(
            'name' => $cat->name,
            'url'  => ''
        );
    }

    // タグアーカイブ
    if ( is_tag() ) {
        $breadcrumbs[] = array(
            'name' => single_tag_title('', false),
            'url'  => ''
        );
    }

    // 検索結果ページ
    if ( is_search() ) {
        $breadcrumbs[] = array(
            'name' => '「' . get_search_query() . '」の検索結果',
            'url'  => ''
        );
    }

    // 404ページ
    if ( is_404() ) {
        $breadcrumbs[] = array(
            'name' => '404 Not Found',
            'url'  => ''
        );
    }

    return $breadcrumbs;
}

/**
 * パンくずリストのHTMLとJSON-LDを表示する関数
 */
function render_custom_breadcrumbs() {
    $items = get_custom_breadcrumbs();
    if ( empty($items) ) return;

    echo '<nav class="breadcrumb-container" aria-label="パンくずリスト">';
    echo '<ol class="breadcrumb-list">';

    $json_items = array();
    $count = 1;

    foreach ( $items as $index => $item ) {
        $is_last = ($index === count($items) - 1);
        
        echo '<li class="breadcrumb-item">';
        if ( !$is_last && !empty($item['url']) ) {
            echo '<a href="' . esc_url($item['url']) . '">' . esc_html($item['name']) . '</a>';
        } else {
            echo '<span aria-current="page">' . esc_html($item['name']) . '</span>';
        }
        echo '</li>';

        // JSON-LD用データの生成
        $json_items[] = array(
            "@type" => "ListItem",
            "position" => $count,
            "name" => $item['name'],
            "item" => !empty($item['url']) ? esc_url($item['url']) : home_url($_SERVER['REQUEST_URI'])
        );
        $count++;
    }

    echo '</ol>';
    echo '</nav>';

    // JSON-LDの出力
    $json_data = array(
        "@context" => "https://schema.org",
        "@type" => "BreadcrumbList",
        "itemListElement" => $json_items
    );
    echo '<script type="application/ld+json">' . json_encode($json_data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . '</script>';
}

<?php
// パンくずリストの表示
if ( function_exists('render_custom_breadcrumbs') ) {
    render_custom_breadcrumbs();
}
?>

.breadcrumb-container {
    background-color: #f9f9f9;
    padding: 10px 20px;
    margin-bottom: 20px;
    border-radius: 4px;
}

.breadcrumb-list {
    list-style: none;
    margin: 0;
    padding: 0;
    display: flex;
    flex-wrap: wrap;
    font-size: 0.9rem;
}

.breadcrumb-item {
    display: flex;
    align-items: center;
}

.breadcrumb-item + .breadcrumb-item::before {
    content: "\003E"; /* > 記号 */
    margin: 0 10px;
    color: #999;
}

.breadcrumb-item a {
    color: #0066cc;
    text-decoration: none;
}

.breadcrumb-item a:hover {
    text-decoration: underline;
}

.breadcrumb-item span {
    color: #333;
    font-weight: bold;
}