WordPressオリジナルテーマ開発で最初に作るべき便利関数10選

<?php
declare(strict_types=1);

/**
 * テーマ内の画像・CSS・JSなどのURLを返す。
 */
function nines_asset(string $path): string
{
    return esc_url(get_template_directory_uri() . '/' . ltrim($path, '/'));
}

/**
 * テーマ内ファイルの更新日時をバージョンとして返す。
 */
function nines_asset_version(string $path): string
{
    $file = get_template_directory() . '/' . ltrim($path, '/');

    return file_exists($file) ? (string) filemtime($file) : wp_get_theme()->get('Version');
}

/**
 * SVGを安全な場所から読み込む。
 */
function nines_inline_svg(string $path, string $class = ''): string
{
    $file = get_template_directory() . '/' . ltrim($path, '/');

    if (!is_readable($file) || pathinfo($file, PATHINFO_EXTENSION) !== 'svg') {
        return '';
    }

    $svg = file_get_contents($file);
    if ($svg === false) {
        return '';
    }

    if ($class !== '') {
        $svg = preg_replace('/<svg\b(?![^>]*class=)/', '<svg class="' . esc_attr($class) . '"', $svg, 1);
    }

    return $svg;
}

/**
 * アイキャッチがなければデフォルト画像を返す。
 */
function nines_featured_image_url(?int $post_id = null, string $size = 'large'): string
{
    $post_id = $post_id ?: get_the_ID();
    $url = get_the_post_thumbnail_url($post_id, $size);

    return esc_url($url ?: get_template_directory_uri() . '/images/any_eyecatch.png');
}

/**
 * ページ種別に応じたbody classを追加する。
 */
add_filter('body_class', function (array $classes): array {
    if (is_singular('post')) {
        $classes[] = 'is-blog-detail';
    }

    if (is_page()) {
        $classes[] = 'is-page-' . sanitize_html_class((string) get_post_field('post_name'));
    }

    return array_values(array_unique($classes));
});

/**
 * OGPに使う説明文を返す。
 */
function nines_meta_description(?int $post_id = null, int $length = 120): string
{
    $post_id = $post_id ?: get_the_ID();
    $description = has_excerpt($post_id)
        ? get_the_excerpt($post_id)
        : wp_strip_all_tags(get_post_field('post_content', $post_id));

    return esc_attr(wp_html_excerpt(trim($description), $length, '...'));
}

/**
 * パンくず用の配列を返す。
 */
function nines_breadcrumb_items(): array
{
    $items = [
        ['label' => 'HOME', 'url' => home_url('/')],
    ];

    if (is_singular('post')) {
        $items[] = ['label' => 'BLOG', 'url' => home_url('/blog/')];
        $items[] = ['label' => get_the_title(), 'url' => get_permalink()];
    } elseif (is_page()) {
        $items[] = ['label' => get_the_title(), 'url' => get_permalink()];
    }

    return $items;
}

/**
 * titleタグや見出しで使うページタイトルを返す。
 */
function nines_page_title(): string
{
    if (is_home() || is_front_page()) {
        return get_bloginfo('name');
    }

    if (is_archive()) {
        return get_the_archive_title();
    }

    if (is_search()) {
        return '検索結果: ' . get_search_query();
    }

    return get_the_title() ?: get_bloginfo('name');
}

/**
 * メニューを配列で取得する。
 */
function nines_menu_items(string $location): array
{
    $locations = get_nav_menu_locations();
    if (!isset($locations[$location])) {
        return [];
    }

    $items = wp_get_nav_menu_items($locations[$location]);

    return is_array($items) ? $items : [];
}

/**
 * 投稿カード表示に必要な情報をまとめて返す。
 */
function nines_post_card_data(?WP_Post $post = null): array
{
    $post = $post ?: get_post();
    if (!$post instanceof WP_Post) {
        return [];
    }

    return [
        'id' => $post->ID,
        'title' => get_the_title($post),
        'url' => get_permalink($post),
        'date' => get_the_date('Y.m.d', $post),
        'image' => nines_featured_image_url($post->ID, 'medium_large'),
        'excerpt' => get_the_excerpt($post),
    ];
}

<?php echo nines_asset('images/logo.svg'); ?>

wp_enqueue_style('theme-style', nines_asset('style.css'), [], nines_asset_version('style.css'));

<?php echo nines_inline_svg('images/svg2/nines_logo.svg', 'site-logo'); ?>

<img src="<?php echo nines_featured_image_url(); ?>" alt="<?php the_title_attribute(); ?>">

<meta name="description" content="<?php echo nines_meta_description(); ?>">

<h1><?php echo esc_html(nines_page_title()); ?></h1>

<?php foreach ($query->posts as $post) : ?>
  <?php $card = nines_post_card_data($post); ?>
  <a href="<?php echo esc_url($card['url']); ?>">
    <img src="<?php echo esc_url($card['image']); ?>" alt="">
    <span><?php echo esc_html($card['date']); ?></span>
    <strong><?php echo esc_html($card['title']); ?></strong>
  </a>
<?php endforeach; ?>

theme-root/
├── functions.php
├── inc/
│   ├── helpers.php
│   ├── setup.php
│   └── enqueue.php
├── template-parts/
│   ├── card-post.php
│   └── breadcrumb.php
├── css/
├── js/
└── images/