_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ファイルを読み込んでいます。 読み込んでいる各種ファイルの内容は、それぞれまた別個確認しようと思います。