mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-05 18:32:23 +01:00
affa411402
It's good for posts, it's good for pages, it might be good for you. Development will occur in trunk. Have at it. Props matt, iandstewart, iamtakashi, obenland, cainm, kristastevens, karmatosed, chellycat, lancewillett, kwight, davidakennedy. See #29799 Built from https://develop.svn.wordpress.org/trunk@29892 git-svn-id: http://core.svn.wordpress.org/trunk@29648 1a063a9b-81f0-0310-95a4-ce76da25c4cd
333 lines
11 KiB
PHP
333 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* Twenty Fifteen functions and definitions
|
|
*
|
|
* Set up the theme and provides some helper functions, which are used in the
|
|
* theme as custom template tags. Others are attached to action and filter
|
|
* hooks in WordPress to change core functionality.
|
|
*
|
|
* When using a child theme you can override certain functions (those wrapped
|
|
* in a function_exists() call) by defining them first in your child theme's
|
|
* functions.php file. The child theme's functions.php file is included before
|
|
* the parent theme's file, so the child theme functions would be used.
|
|
*
|
|
* @link http://codex.wordpress.org/Theme_Development
|
|
* @link http://codex.wordpress.org/Child_Themes
|
|
*
|
|
* Functions that are not pluggable (not wrapped in function_exists()) are
|
|
* instead attached to a filter or action hook.
|
|
*
|
|
* For more information on hooks, actions, and filters,
|
|
* @link http://codex.wordpress.org/Plugin_API
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Twenty_Fifteen
|
|
* @since Twenty Fifteen 1.0
|
|
*/
|
|
|
|
/**
|
|
* Set the content width based on the theme's design and stylesheet.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*/
|
|
if ( ! isset( $content_width ) ) {
|
|
$content_width = 660;
|
|
}
|
|
|
|
if ( ! function_exists( 'twentyfifteen_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.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*/
|
|
function twentyfifteen_setup() {
|
|
|
|
/*
|
|
* Make theme available for translation.
|
|
* Translations can be filed in the /languages/ directory.
|
|
* If you're building a theme based on twentyfifteen, use a find and replace
|
|
* to change 'twentyfifteen' to the name of your theme in all the template files
|
|
*/
|
|
load_theme_textdomain( 'twentyfifteen', get_template_directory() . '/languages' );
|
|
|
|
// Add default posts and comments RSS feed links to head.
|
|
add_theme_support( 'automatic-feed-links' );
|
|
|
|
/*
|
|
* Enable support for Post Thumbnails on posts and pages.
|
|
*
|
|
* @link http://codex.wordpress.org/Function_Reference/add_theme_support#Post_Thumbnails
|
|
*/
|
|
add_theme_support( 'post-thumbnails' );
|
|
set_post_thumbnail_size( 825, 510, true );
|
|
|
|
// This theme uses wp_nav_menu() in one location.
|
|
register_nav_menus( array(
|
|
'primary' => __( 'Primary Menu', 'twentyfifteen' ),
|
|
'social' => __( 'Social Links Menu', 'twentyfifteen' ),
|
|
) );
|
|
|
|
/*
|
|
* 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'
|
|
) );
|
|
|
|
/*
|
|
* Enable support for Post Formats.
|
|
* See http://codex.wordpress.org/Post_Formats
|
|
*/
|
|
add_theme_support( 'post-formats', array(
|
|
'aside', 'image', 'video', 'quote', 'link', 'gallery', 'status', 'audio', 'chat'
|
|
) );
|
|
|
|
$color_scheme = twentyfifteen_get_color_scheme();
|
|
$default_color = trim( $color_scheme[0], '#' );
|
|
|
|
// Setup the WordPress core custom background feature.
|
|
add_theme_support( 'custom-background', apply_filters( 'twentyfifteen_custom_background_args', array(
|
|
'default-color' => $default_color,
|
|
'default-attachment' => 'fixed',
|
|
) ) );
|
|
|
|
/*
|
|
* This theme styles the visual editor to resemble the theme style,
|
|
* specifically font, colors, icons, and column width.
|
|
*/
|
|
add_editor_style( array( 'css/editor-style.css', 'genericons/genericons.css', twentyfifteen_fonts_url() ) );
|
|
}
|
|
endif; // twentyfifteen_setup
|
|
add_action( 'after_setup_theme', 'twentyfifteen_setup' );
|
|
|
|
/**
|
|
* Register widget area.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*
|
|
* @link http://codex.wordpress.org/Function_Reference/register_sidebar
|
|
*/
|
|
function twentyfifteen_widgets_init() {
|
|
register_sidebar( array(
|
|
'name' => __( 'Widget Area', 'twentyfifteen' ),
|
|
'id' => 'sidebar-1',
|
|
'description' => __( 'Add widgets here to appear in your sidebar.', 'twentyfifteen' ),
|
|
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
|
|
'after_widget' => '</aside>',
|
|
'before_title' => '<h1 class="widget-title">',
|
|
'after_title' => '</h1>',
|
|
) );
|
|
}
|
|
add_action( 'widgets_init', 'twentyfifteen_widgets_init' );
|
|
|
|
if ( ! function_exists( 'twentyfifteen_fonts_url' ) ) :
|
|
/**
|
|
* Register Google fonts for Twenty Fifteen.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*
|
|
* @return string
|
|
*/
|
|
function twentyfifteen_fonts_url() {
|
|
$fonts = array();
|
|
$subsets = 'latin,latin-ext';
|
|
|
|
/*
|
|
* Translators: If there are characters in your language that are not supported
|
|
* by Noto Sans, translate this to 'off'. Do not translate into your own language.
|
|
*/
|
|
if ( 'off' !== _x( 'on', 'Noto Sans font: on or off', 'twentyfifteen' ) ) {
|
|
$fonts[] = 'Noto Sans:400italic,700italic,400,700';
|
|
}
|
|
|
|
/*
|
|
* Translators: If there are characters in your language that are not supported
|
|
* by Noto Serif, translate this to 'off'. Do not translate into your own language.
|
|
*/
|
|
if ( 'off' !== _x( 'on', 'Noto Serif font: on or off', 'twentyfifteen' ) ) {
|
|
$fonts[] = 'Noto Serif:400italic,700italic,400,700';
|
|
}
|
|
|
|
/*
|
|
* Translators: If there are characters in your language that are not supported
|
|
* by Inconsolata, translate this to 'off'. Do not translate into your own language.
|
|
*/
|
|
if ( 'off' !== _x( 'on', 'Inconsolata font: on or off', 'twentyfifteen' ) ) {
|
|
$fonts[] = 'Inconsolata:400,700';
|
|
}
|
|
|
|
/*
|
|
* Translators: To add an additional character subset specific to your language,
|
|
* translate this to 'greek', 'cyrillic', 'devanagari' or 'vietnamese'. Do not translate into your own language.
|
|
*/
|
|
$subset = _x( 'no-subset', 'Add new subset (greek, cyrillic, devanagari, vietnamese)', 'twentyfifteen' );
|
|
|
|
if ( 'cyrillic' == $subset ) {
|
|
$subsets .= ',cyrillic,cyrillic-ext';
|
|
} elseif ( 'greek' == $subset ) {
|
|
$subsets .= ',greek,greek-ext';
|
|
} elseif ( 'devanagari' == $subset ) {
|
|
$subsets .= ',devanagari';
|
|
} elseif ( 'vietnamese' == $subset ) {
|
|
$subsets .= ',vietnamese';
|
|
}
|
|
|
|
return add_query_arg( array(
|
|
'family' => urlencode( implode( '|', $fonts ) ),
|
|
'subset' => urlencode( $subsets ),
|
|
), '//fonts.googleapis.com/css' );
|
|
}
|
|
endif;
|
|
|
|
/**
|
|
* Enqueue scripts and styles.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*/
|
|
function twentyfifteen_scripts() {
|
|
// Add custom fonts, used in the main stylesheet.
|
|
wp_enqueue_style( 'twentyfifteen-fonts', twentyfifteen_fonts_url(), array(), null );
|
|
|
|
// Add Genericons, used in the main stylesheet.
|
|
wp_enqueue_style( 'genericons', get_template_directory_uri() . '/genericons/genericons.css', array(), '3.2' );
|
|
|
|
// Load our main stylesheet.
|
|
wp_enqueue_style( 'twentyfifteen-style', get_stylesheet_uri() );
|
|
|
|
// Load the Internet Explorer specific stylesheet.
|
|
wp_enqueue_style( 'twentyfifteen-ie', get_template_directory_uri() . '/css/ie.css', array( 'twentyfifteen-style', 'genericons' ), '20141010' );
|
|
wp_style_add_data( 'twentyfifteen-ie', 'conditional', 'lt IE 9' );
|
|
|
|
// Load the Internet Explorer 7 specific stylesheet.
|
|
wp_enqueue_style( 'twentyfifteen-ie7', get_template_directory_uri() . '/css/ie7.css', array( 'twentyfifteen-style' ), '20141010' );
|
|
wp_style_add_data( 'twentyfifteen-ie7', 'conditional', 'lt IE 8' );
|
|
|
|
wp_enqueue_script( 'twentyfifteen-skip-link-focus-fix', get_template_directory_uri() . '/js/skip-link-focus-fix.js', array(), '20141010', true );
|
|
|
|
if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
|
|
wp_enqueue_script( 'comment-reply' );
|
|
}
|
|
|
|
if ( is_singular() && wp_attachment_is_image() ) {
|
|
wp_enqueue_script( 'twentyfifteen-keyboard-image-navigation', get_template_directory_uri() . '/js/keyboard-image-navigation.js', array( 'jquery' ), '20141010' );
|
|
}
|
|
|
|
wp_enqueue_script( 'twentyfifteen-script', get_template_directory_uri() . '/js/functions.js', array( 'jquery' ), '20141010', true );
|
|
wp_localize_script( 'twentyfifteen-script', 'screenReaderText', array(
|
|
'expand' => '<span class="screen-reader-text">' . esc_html__( 'Expand', 'twentyfifteen' ) . '</span>',
|
|
'collapse' => '<span class="screen-reader-text">' . esc_html__( 'Collapse', 'twentyfifteen' ) . '</span>',
|
|
) );
|
|
}
|
|
add_action( 'wp_enqueue_scripts', 'twentyfifteen_scripts' );
|
|
|
|
/**
|
|
* Filters wp_title to print a neat <title> tag based on what is being viewed.
|
|
*
|
|
* @param string $title Default title text for current view.
|
|
* @param string $sep Optional separator.
|
|
* @return string The filtered title.
|
|
*/
|
|
function twentyfifteen_wp_title( $title, $sep ) {
|
|
if ( is_feed() ) {
|
|
return $title;
|
|
}
|
|
|
|
global $page, $paged;
|
|
|
|
// Add the blog name
|
|
$title .= get_bloginfo( 'name', 'display' );
|
|
|
|
// Add the blog description for the home/front page.
|
|
$site_description = get_bloginfo( 'description', 'display' );
|
|
if ( $site_description && ( is_home() || is_front_page() ) ) {
|
|
$title .= " $sep $site_description";
|
|
}
|
|
|
|
// Add a page number if necessary:
|
|
if ( ( $paged >= 2 || $page >= 2 ) && ! is_404() ) {
|
|
$title .= " $sep " . sprintf( __( 'Page %s', 'twentyfifteen' ), max( $paged, $page ) );
|
|
}
|
|
|
|
return $title;
|
|
}
|
|
add_filter( 'wp_title', 'twentyfifteen_wp_title', 10, 2 );
|
|
|
|
/**
|
|
* Add featured image as background image to post navs.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*/
|
|
function twentyfifteen_post_nav_background() {
|
|
if ( ! is_single() ) {
|
|
return;
|
|
}
|
|
|
|
$previous = ( is_attachment() ) ? get_post( get_post()->post_parent ) : get_adjacent_post( false, '', true );
|
|
$next = get_adjacent_post( false, '', false );
|
|
$css = '';
|
|
|
|
if ( is_attachment() && 'attachment' == $previous->post_type ) {
|
|
return;
|
|
}
|
|
|
|
if ( $previous && has_post_thumbnail( $previous->ID ) ) {
|
|
$prevthumb = wp_get_attachment_image_src( get_post_thumbnail_id( $previous->ID ), 'post-thumbnail' );
|
|
$css .= '.post-navigation .nav-previous { background-image: url(' . esc_url( $prevthumb[0] ) . '); }';
|
|
}
|
|
|
|
if ( $next && has_post_thumbnail( $next->ID ) ) {
|
|
$nextthumb = wp_get_attachment_image_src( get_post_thumbnail_id( $next->ID ), 'post-thumbnail' );
|
|
$css .= '.post-navigation .nav-next { background-image: url(' . esc_url( $nextthumb[0] ) . '); }';
|
|
}
|
|
|
|
wp_add_inline_style( 'twentyfifteen-style', $css );
|
|
}
|
|
add_action( 'wp_enqueue_scripts', 'twentyfifteen_post_nav_background' );
|
|
|
|
/**
|
|
* Display descriptions in main navigation.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*
|
|
* @param string $item_output The menu item output.
|
|
* @param WP_Post $item Menu item object.
|
|
* @param int $depth Depth of the menu.
|
|
* @param array $args wp_nav_menu() arguments.
|
|
*
|
|
* @return string Menu item with possible description.
|
|
*/
|
|
function twentyfifteen_nav_description( $item_output, $item, $depth, $args ) {
|
|
if ( 'primary' == $args->theme_location && $item->description ) {
|
|
$item_output = str_replace( $args->link_after . '</a>', '<span class="menu-item-description">' . $item->description . '</span>' . $args->link_after . '</a>', $item_output );
|
|
}
|
|
|
|
return $item_output;
|
|
}
|
|
add_filter( 'walker_nav_menu_start_el', 'twentyfifteen_nav_description', 10, 4 );
|
|
|
|
/**
|
|
* Implement the Custom Header feature.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*/
|
|
require get_template_directory() . '/inc/custom-header.php';
|
|
|
|
/**
|
|
* Custom template tags for this theme.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*/
|
|
require get_template_directory() . '/inc/template-tags.php';
|
|
|
|
/**
|
|
* Customizer additions.
|
|
*
|
|
* @since Twenty Fifteen 1.0
|
|
*/
|
|
require get_template_directory() . '/inc/customizer.php';
|