[_s] functions.php

_sのfunctions.phpの内容を確認していきます。

functions.php

<?php
/**
 * _s functions and definitions
 *
 * @link https://developer.wordpress.org/themes/basics/theme-functions/
 *
 * @package _s
 */

if ( ! function_exists( '_s_setup' ) ) :
	/**
	 * Sets up theme defaults and registers support for various WordPress features.
	 *
	 * Note that this function is hooked into the after_setup_theme hook, which
	 * runs before the init hook. The init hook is too late for some features, such
	 * as indicating support for post thumbnails.
	 */
	function _s_setup() {
		/*
		 * Make theme available for translation.
		 * Translations can be filed in the /languages/ directory.
		 * If you're building a theme based on _s, use a find and replace
		 * to change '_s' to the name of your theme in all the template files.
		 */
		load_theme_textdomain( '_s', get_template_directory() . '/languages' );

		// Add default posts and comments RSS feed links to head.
		add_theme_support( 'automatic-feed-links' );

		/*
		 * Let WordPress manage the document title.
		 * By adding theme support, we declare that this theme does not use a
		 * hard-coded <title> tag in the document head, and expect WordPress to
		 * provide it for us.
		 */
		add_theme_support( 'title-tag' );

		/*
		 * Enable support for Post Thumbnails on posts and pages.
		 *
		 * @link https://developer.wordpress.org/themes/functionality/featured-images-post-thumbnails/
		 */
		add_theme_support( 'post-thumbnails' );

		// This theme uses wp_nav_menu() in one location.
		register_nav_menus( array(
			'menu-1' => esc_html__( 'Primary', '_s' ),
		) );

		/*
		 * Switch default core markup for search form, comment form, and comments
		 * to output valid HTML5.
		 */
		add_theme_support( 'html5', array(
			'search-form',
			'comment-form',
			'comment-list',
			'gallery',
			'caption',
		) );

		// Set up the WordPress core custom background feature.
		add_theme_support( 'custom-background', apply_filters( '_s_custom_background_args', array(
			'default-color' => 'ffffff',
			'default-image' => '',
		) ) );

		// Add theme support for selective refresh for widgets.
		add_theme_support( 'customize-selective-refresh-widgets' );

		/**
		 * Add support for core custom logo.
		 *
		 * @link https://codex.wordpress.org/Theme_Logo
		 */
		add_theme_support( 'custom-logo', array(
			'height'      => 250,
			'width'       => 250,
			'flex-width'  => true,
			'flex-height' => true,
		) );
	}
endif;
add_action( 'after_setup_theme', '_s_setup' );

/**
 * Set the content width in pixels, based on the theme's design and stylesheet.
 *
 * Priority 0 to make it available to lower priority callbacks.
 *
 * @global int $content_width
 */
function _s_content_width() {
	// This variable is intended to be overruled from themes.
	// Open WPCS issue: {@link https://github.com/WordPress-Coding-Standards/WordPress-Coding-Standards/issues/1043}.
	// phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound
	$GLOBALS['content_width'] = apply_filters( '_s_content_width', 640 );
}
add_action( 'after_setup_theme', '_s_content_width', 0 );

/**
 * Register widget area.
 *
 * @link https://developer.wordpress.org/themes/functionality/sidebars/#registering-a-sidebar
 */
function _s_widgets_init() {
	register_sidebar( array(
		'name'          => esc_html__( 'Sidebar', '_s' ),
		'id'            => 'sidebar-1',
		'description'   => esc_html__( 'Add widgets here.', '_s' ),
		'before_widget' => '<section id="%1$s" class="widget %2$s">',
		'after_widget'  => '</section>',
		'before_title'  => '<h2 class="widget-title">',
		'after_title'   => '</h2>',
	) );
}
add_action( 'widgets_init', '_s_widgets_init' );

/**
 * Enqueue scripts and styles.
 */
function _s_scripts() {
	wp_enqueue_style( '_s-style', get_stylesheet_uri() );

	wp_enqueue_script( '_s-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '20151215', true );

	wp_enqueue_script( '_s-skip-link-focus-fix', get_template_directory_uri() . '/js/skip-link-focus-fix.js', array(), '20151215', true );

	if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
		wp_enqueue_script( 'comment-reply' );
	}
}
add_action( 'wp_enqueue_scripts', '_s_scripts' );

/**
 * Implement the Custom Header feature.
 */
require get_template_directory() . '/inc/custom-header.php';

/**
 * Custom template tags for this theme.
 */
require get_template_directory() . '/inc/template-tags.php';

/**
 * Functions which enhance the theme by hooking into WordPress.
 */
require get_template_directory() . '/inc/template-functions.php';

/**
 * Customizer additions.
 */
require get_template_directory() . '/inc/customizer.php';

/**
 * Load Jetpack compatibility file.
 */
if ( defined( 'JETPACK__VERSION' ) ) {
	require get_template_directory() . '/inc/jetpack.php';
}

/**
 * Load WooCommerce compatibility file.
 */
if ( class_exists( 'WooCommerce' ) ) {
	require get_template_directory() . '/inc/woocommerce.php';
}

_s_setup

if ( ! function_exists( '_s_setup' ) ) :
	/**
	 * Sets up theme defaults and registers support for various WordPress features.
	 *
	 * Note that this function is hooked into the after_setup_theme hook, which
	 * runs before the init hook. The init hook is too late for some features, such
	 * as indicating support for post thumbnails.
	 */
	function _s_setup() {

	}
endif;
add_action( 'after_setup_theme', '_s_setup' );

_s_setup()が、’after_setup_theme’というアクションにフックされています。’after_setup_theme’は、テーマから最初に利用可能になるアクションでした。また、if ( ! function_exists( ‘_s_setup’ ) ) で同名の関数の有無を確認しています。

_s_setup() の中で行われている処理を確認します。

load_theme_textdomain( ‘_s’, get_template_directory() . ‘/languages’ )

テクストドメインを読み込みます。 テクストドメインは翻訳に関するファイルを設定するもので、_sではほとんどのテンプレートファイルで使われています。

add_theme_support( ‘automatic-feed-links’ )

RSSフィード へのリンクを<head></head>の中に自動で追加します。

add_theme_support( ‘title-tag’ )

タイトルタグの中身を自動的に追加します。

add_theme_support( ‘post-thumbnails’ )

サムネイル機能を有効にします。

register_nav_menus()

テンプレートで、wp_nav_menu()を使ってナビゲーション用のメニューを表示できるようにします。

add_theme_support( ‘html5’, array(…) );

ordPressコアから出力されるHTMLタグをHTML5のフォーマットにしてくれるそうです。 <!DOCTYPE html> で文書宣言するとき使います。

add_theme_support( ‘custom-background’, … );

カスタム背景機能を有効にします。管理画面から背景の設定ができるようになります。

この部分で、わざわざapply_filters()を使って、’_s_custom_background_args’というアクションに配列をフックさせています。直接配列を渡さない理由が私にはちょっとよくわかりませんが、テーマ開発者が独自にフックできるようにしているでしょうか?

add_theme_support( ‘customize-selective-refresh-widgets’ );

テーマカスタマイザーでウィジェットを設置した際に、自動でリフレッシュをしてくれるようになります。

add_theme_support( ‘custom-logo’);

カスタムロゴが設定できるようになります。

_s_content_width()

content_widthというグローバル変数を設定します。テーマ内のすべてのコンテントの最大幅を設定して、テーマで幅を統一できるようにします。

https://codex.wordpress.org/Content_Width

ここでもapply_filters()を使っています。使う場合、使わない場合の場合分けが良くわかりません。

_s_widgets_init()

ウィジェットが使えるようになります。

_s_scripts()

cssとjavascriptの読み込みを設定しています。_sでは、wp_enqueue_style()とwp_enqueue_script()をまとめて_s_scripts()という関数にして、’wp_enqueue_scripts’アクションにフックしています。

require get_template_directory()

/inc/のphpファイルを読み込んでいます。 読み込んでいる各種ファイルの内容は、それぞれまた別個確認しようと思います。