vhad/wordpress-develop
1
0
Fork 0
mirror of https://github.com/gosticks/wordpress-develop.git synced 2026-06-28 14:20:15 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Twenty Fourteen: update comment blocks to match inline docs standards. Props DrewAPicture, see #25837.

Browse Source 
git-svn-id: https://develop.svn.wordpress.org/trunk@26556 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Lance Willett
2013-12-03 17:05:53 +00:00
parent e7522d6413
commit 0bfc7b4d91
21 changed files with 333 additions and 133 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
src/wp-content/themes/twentyfourteen/archive.php
View File

@@ -45,14 +45,22 @@ get_header(); ?>
</header><!-- .page-header -->
<?php
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
endwhile;
// Previous/next page navigation.
twentyfourteen_paging_nav();
else :
// If no content, include the "No posts found" template.
get_template_part( 'content', 'none' );
endif;

12
src/wp-content/themes/twentyfourteen/author.php
View File

@@ -45,14 +45,22 @@ get_header(); ?>
*/
rewind_posts();
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
endwhile;
// Previous/next page navigation.
twentyfourteen_paging_nav();
else :
// If no content, include the "No posts found" template.
get_template_part( 'content', 'none' );
endif;

14
src/wp-content/themes/twentyfourteen/category.php
View File

@@ -29,14 +29,22 @@ get_header(); ?>
</header><!-- .archive-header -->
<?php
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
get_template_part( 'content', get_post_format() );
endwhile;
// Previous/next page navigation.
twentyfourteen_paging_nav();
else :
// If no content, include the "No posts found" template.
get_template_part( 'content', 'none' );
endif;

1
src/wp-content/themes/twentyfourteen/content-featured-post.php
View File

@@ -11,6 +11,7 @@
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<a class="post-thumbnail" href="<?php the_permalink(); ?>" rel="<?php the_ID(); ?>">
<?php
// Output the featured image.
if ( has_post_thumbnail() ) :
if ( 'grid' == get_theme_mod( 'featured_content_layout' ) ) {
the_post_thumbnail();

1
src/wp-content/themes/twentyfourteen/content-page.php
View File

@@ -10,6 +10,7 @@
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<?php
// Page thumbnail and title.
twentyfourteen_post_thumbnail();
the_title( '<header class="entry-header"><h1 class="entry-title">', '</h1></header><!-- .entry-header -->' );
?>

11
src/wp-content/themes/twentyfourteen/featured-content.php
View File

@@ -11,15 +11,26 @@
<div id="featured-content" class="featured-content">
<div class="featured-content-inner">
<?php
/**
* Fires before the Twenty Fourteen featured content.
*
* @since Twenty Fourteen 1.0
*/
do_action( 'twentyfourteen_featured_posts_before' );
$featured_posts = twentyfourteen_get_featured_posts();
foreach ( (array) $featured_posts as $order => $post ) :
setup_postdata( $post );
// Include the featured content template.
get_template_part( 'content', 'featured-post' );
endforeach;
/**
* Fires after the Twenty Fourteen featured content.
*
* @since Twenty Fourteen 1.0
*/
do_action( 'twentyfourteen_featured_posts_after' );
wp_reset_postdata();

39
src/wp-content/themes/twentyfourteen/functions.php
View File

@@ -6,12 +6,13 @@
* theme as custom template tags. Others are attached to action and filter
* hooks in WordPress to change core functionality.
*
* When using a child theme (see http://codex.wordpress.org/Theme_Development
* and http://codex.wordpress.org/Child_Themes), 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.
* 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.
@@ -27,7 +28,7 @@
/**
* Set up the content width value based on the theme's design.
*
* @link twentyfourteen_content_width()
* @see twentyfourteen_content_width()
*
* @since Twenty Fourteen 1.0
*/
@@ -138,6 +139,13 @@ add_action( 'template_redirect', 'twentyfourteen_content_width' );
* @return array An array of WP_Post objects.
*/
function twentyfourteen_get_featured_posts() {
/**
* Filter the featured posts to return in Twenty Fourteen.
*
* @since Twenty Fourteen 1.0
*
* @param array|bool $posts Array of featured posts, otherwise false.
*/
return apply_filters( 'twentyfourteen_get_featured_posts', array() );
}
@@ -149,11 +157,12 @@ function twentyfourteen_get_featured_posts() {
* @return bool Whether there are featured posts.
*/
function twentyfourteen_has_featured_posts() {
/** This filter is documented in functions.php */
return ! is_paged() && (bool) apply_filters( 'twentyfourteen_get_featured_posts', false );
}
/**
* Register two widget areas.
* Register three Twenty Fourteen widget areas.
*
* @since Twenty Fourteen 1.0
*
@@ -214,7 +223,7 @@ function twentyfourteen_font_url() {
}
/**
* Enqueue scripts and styles for front end.
* Enqueue scripts and styles for the front end.
*
* @since Twenty Fourteen 1.0
*
@@ -280,6 +289,18 @@ if ( ! function_exists( 'twentyfourteen_the_attached_image' ) ) :
*/
function twentyfourteen_the_attached_image() {
$post = get_post();
/**
* Filter the default Twenty Fourteen attachment size.
*
* @since Twenty Fourteen 1.0
*
* @param array $dimensions {
* An array of height and width dimensions.
*
* @type int $height Height of the image in pixels. Default 1200.
* @type int $width Width of the image in pixels. Default 1200.
* }
*/
$attachment_size = apply_filters( 'twentyfourteen_attachment_size', array( 1200, 1200 ) );
$next_attachment_url = wp_get_attachment_url();

7
src/wp-content/themes/twentyfourteen/image.php
View File

@@ -7,6 +7,7 @@
* @since Twenty Fourteen 1.0
*/
// Retrieve attachment metadata.
$metadata = wp_get_attachment_metadata();
get_header();
@@ -15,8 +16,10 @@ get_header();
<section id="primary" class="content-area image-attachment">
<div id="content" class="site-content" role="main">
<?php while ( have_posts() ) : the_post(); ?>
<?php
// Start the Loop.
while ( have_posts() ) : the_post();
?>
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<header class="entry-header">
<?php the_title( '<h1 class="entry-title">', '</h1>' ); ?>

26
src/wp-content/themes/twentyfourteen/inc/custom-header.php
View File

@@ -17,6 +17,24 @@
* @uses twentyfourteen_admin_header_image()
*/
function twentyfourteen_custom_header_setup() {
/**
* Filter Twenty Fourteen custom-header support arguments.
*
* @since Twenty Fourteen 1.0
*
* @param array $args {
* An array of custom-header support arguments.
*
* @type bool $header_text Whether to display custom header text. Default false.
* @type int $width Width in pixels of the custom header image. Default 1260.
* @type int $height Height in pixels of the custom header image. Default 240.
* @type bool $flex_height Whether to allow flexible-height header images. Default true.
* @type string $admin_head_callback Callback function used to style the image displayed in
* the Appearance > Header screen.
* @type string $admin_preview_callback Callback function used to create the custom header markup in
* the Appearance > Header screen.
* }
*/
add_theme_support( 'custom-header', apply_filters( 'twentyfourteen_custom_header_args', array(
'header-text' => false,
'width' => 1260,
@@ -30,9 +48,9 @@ add_action( 'after_setup_theme', 'twentyfourteen_custom_header_setup' );
if ( ! function_exists( 'twentyfourteen_admin_header_style' ) ) :
/**
* Style the header image displayed on the Appearance > Header admin panel.
* Style the header image displayed on the Appearance > Header screen.
*
* @link twentyfourteen_custom_header_setup().
* @see twentyfourteen_custom_header_setup()
*
* @since Twenty Fourteen 1.0
*/
@@ -65,9 +83,9 @@ endif; // twentyfourteen_admin_header_style
if ( ! function_exists( 'twentyfourteen_admin_header_image' ) ) :
/**
* Create the custom header image markup displayed on the Appearance > Header admin panel.
* Create the custom header image markup displayed on the Appearance > Header screen.
*
* @link twentyfourteen_custom_header_setup().
* @see twentyfourteen_custom_header_setup()
*
* @since Twenty Fourteen 1.0
*/

25
src/wp-content/themes/twentyfourteen/inc/customizer.php
View File

@@ -72,16 +72,19 @@ function twentyfourteen_customize_preview_js() {
add_action( 'customize_preview_init', 'twentyfourteen_customize_preview_js' );
/**
* Tweak the brightness of a color by adjusting the RGB values by the given interval.
* Tweak the brightness of a color by adjusting the RGB
* values by the given interval.
*
* Use positive values of $steps to brighten the color and negative values to darken the color.
* All three RGB values are modified by the specified steps, within the range of 0-255. The hue
* is generally maintained unless the number of steps causes one value to be capped at 0 or 255.
* Use positive values of $steps to brighten the color and negative
* values to darken the color. All three RGB values are modified by
* the specified steps, within the range of 0-255. The hue is generally
* maintained unless the number of steps causes one value to be capped
* at 0 or 255.
*
* @since Twenty Fourteen 1.0
*
* @param string $color The original color, in 3- or 6-digit hexadecimal form.
* @param int $steps The number of steps to adjust the color by, in RGB units.
* @param int $steps The number of steps to adjust the color by, in RGB units.
* @return string $color The new color, in 6-digit hexadecimal form.
*/
function twentyfourteen_adjust_color( $color, $steps ) {
@@ -109,30 +112,30 @@ function twentyfourteen_adjust_color( $color, $steps ) {
}
/**
* Returns a slightly lighter color than what is set as the theme's
* Return a slightly lighter color than what is set as the theme's
* accent color.
*
* @since Twenty Fourteen 1.0
*
* @return string
* @return string Hex color.
*/
function twentyfourteen_accent_mid() {
return twentyfourteen_adjust_color( get_theme_mod( 'accent_color' ), 29 );
}
/**
* Returns a lighter color than what is set as the theme's accent color.
* Return a lighter color than what is set as the theme's accent color.
*
* @since Twenty Fourteen 1.0
*
* @return string
* @return string Hex color.
*/
function twentyfourteen_accent_light() {
return twentyfourteen_adjust_color( get_theme_mod( 'accent_color' ), 49 );
}
/**
* Caches the generated variants of the theme's accent color.
* Cache the generated variants of the theme's accent color.
*
* @since Twenty Fourteen 1.0
*
@@ -324,7 +327,7 @@ function twentyfourteen_customizer_styles() {
add_action( 'wp_enqueue_scripts', 'twentyfourteen_customizer_styles' );
/**
* Adds contextual help to the Themes and Post edit screens.
* Add contextual help to the Themes and Post edit screens.
*
* @since Twenty Fourteen 1.0
*

186
src/wp-content/themes/twentyfourteen/inc/featured-content.php
View File

@@ -2,37 +2,48 @@
/**
* Twenty Fourteen Featured Content
*
* This module allows you to define a subset of posts to be displayed in the
* theme's Featured Content area.
* This module allows you to define a subset of posts to be displayed
* in the theme's Featured Content area.
*
* For maximum compatibility with different methods of posting users will
* designate a featured post tag to associate posts with. Since this tag now
* has special meaning beyond that of a normal tags, users will have the
* ability to hide it from the front-end of their site.
* For maximum compatibility with different methods of posting users
* will designate a featured post tag to associate posts with. Since
* this tag now has special meaning beyond that of a normal tags, users
* will have the ability to hide it from the front-end of their site.
*/
class Featured_Content {
/**
* The maximum number of posts that a Featured Content area can contain. We
* define a default value here but themes can override this by defining a
* "max_posts" entry in the second parameter passed in the call to
* add_theme_support( 'featured-content' ).
* The maximum number of posts a Featured Content area can contain.
*
* We define a default value here but themes can override
* this by defining a "max_posts" entry in the second parameter
* passed in the call to add_theme_support( 'featured-content' ).
*
* @see Featured_Content::init()
*
* @since Twenty Fourteen 1.0
*
* @static
* @access public
* @var int
*/
public static $max_posts = 15;
/**
* Instantiate
* Instantiate.
*
* All custom functionality will be hooked into the "init" action.
*
* @static
* @access public
* @since Twenty Fourteen 1.0
*/
public static function setup() {
add_action( 'init', array( __CLASS__, 'init' ), 30 );
}
/**
* Conditionally hook into WordPress
* Conditionally hook into WordPress.
*
* Theme must declare that they support this module by adding
* add_theme_support( 'featured-content' ); during after_setup_theme.
@@ -40,7 +51,9 @@ class Featured_Content {
* If no theme support is found there is no need to hook into WordPress.
* We'll just return early instead.
*
* @uses Featured_Content::$max_posts
* @static
* @access public
* @since Twenty Fourteen 1.0
*/
public static function init() {
$theme_support = get_theme_support( 'featured-content' );
@@ -85,6 +98,10 @@ class Featured_Content {
*
* Has to run on wp_loaded so that the preview filters of the customizer
* have a chance to alter the value.
*
* @static
* @access public
* @since Twenty Fourteen 1.0
*/
public static function wp_loaded() {
if ( self::get_setting( 'hide-tag' ) ) {
@@ -94,11 +111,13 @@ class Featured_Content {
}
/**
* Get featured posts
* Get featured posts.
*
* @uses Featured_Content::get_featured_post_ids()
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @return array
* @return array Array of featured posts.
*/
public static function get_featured_posts() {
$post_ids = self::get_featured_post_ids();
@@ -124,7 +143,11 @@ class Featured_Content {
*
* Sets the "featured_content_ids" transient.
*
* @return array Array of post IDs
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @return array Array of post IDs.
*/
public static function get_featured_post_ids() {
// Return array of cached results if they exist.
@@ -170,9 +193,13 @@ class Featured_Content {
}
/**
* Returns an array with IDs of posts maked as sticky.
* Return an array with IDs of posts maked as sticky.
*
* @return array
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @return array Array of sticky posts.
*/
public static function get_sticky_posts() {
$settings = self::get_setting();
@@ -180,25 +207,33 @@ class Featured_Content {
}
/**
* Delete transient
* Delete featured content ids transient.
*
* Hooks in the "save_post" action.
*
* @see Featured_Content::validate_settings().
*
* @static
* @access public
* @since Twenty Fourteen 1.0
*/
public static function delete_transient() {
delete_transient( 'featured_content_ids' );
}
/**
* Exclude featured posts from the home page blog query
* Exclude featured posts from the home page blog query.
*
* Filter the home page posts, and remove any featured post ID's from it. Hooked
* onto the 'pre_get_posts' action, this changes the parameters of the query
* before it gets any posts.
* Filter the home page posts, and remove any featured post ID's from it.
* Hooked onto the 'pre_get_posts' action, this changes the parameters of
* the query before it gets any posts.
*
* @uses Featured_Content::get_featured_post_ids();
* @param WP_Query $query
* @return WP_Query Possibly modified WP_Query
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @param WP_Query $query WP_Query object.
* @return WP_Query Possibly-modified WP_Query.
*/
public static function pre_get_posts( $query ) {
@@ -233,15 +268,20 @@ class Featured_Content {
}
/**
* Reset tag option when the saved tag is deleted
* Reset tag option when the saved tag is deleted.
*
* It's important to mention that the transient needs to be deleted, too.
* While it may not be obvious by looking at the function alone, the transient
* is deleted by Featured_Content::validate_settings().
* It's important to mention that the transient needs to be deleted,
* too. While it may not be obvious by looking at the function alone,
* the transient is deleted by Featured_Content::validate_settings().
*
* Hooks in the "delete_post_tag" action.
*
* @see Featured_Content::validate_settings().
*
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @param int $tag_id The term_id of the tag that has been deleted.
* @return void
*/
@@ -258,13 +298,17 @@ class Featured_Content {
}
/**
* Hide featured tag from displaying when global terms are queried from the front-end
* Hide featured tag from displaying when global terms are queried from the front-end.
*
* Hooks into the "get_terms" filter.
*
* @param array $terms A list of term objects. This is the return value of get_terms().
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @param array $terms List of term objects. This is the return value of get_terms().
* @param array $taxonomies An array of taxonomy slugs.
* @return array $terms
* @return array A filtered array of terms.
*
* @uses Featured_Content::get_setting()
*/
@@ -295,14 +339,19 @@ class Featured_Content {
}
/**
* Hide featured tag from display when terms associated with a post object are queried from the front-end
* Hide featured tag from display when terms associated with a post object
* are queried from the front-end.
*
* Hooks into the "get_the_terms" filter.
*
* @param array $terms A list of term objects. This is the return value of get_the_terms().
* @param int $id The ID field for the post object that terms are associated with.
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @param array $terms A list of term objects. This is the return value of get_the_terms().
* @param int $id The ID field for the post object that terms are associated with.
* @param array $taxonomy An array of taxonomy slugs.
* @return array $terms
* @return array Filtered array of terms.
*
* @uses Featured_Content::get_setting()
*/
@@ -333,10 +382,11 @@ class Featured_Content {
}
/**
* Register custom setting on the Settings -> Reading screen
* Register custom setting on the Settings -> Reading screen.
*
* @uses Featured_Content::render_form()
* @uses Featured_Content::validate_settings()
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @return void
*/
@@ -347,6 +397,10 @@ class Featured_Content {
/**
* Add settings to the Customizer.
*
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @param WP_Customize_Manager $wp_customize Theme Customizer object.
*/
public static function customize_register( $wp_customize ) {
@@ -386,6 +440,8 @@ class Featured_Content {
/**
* Enqueue the tag suggestion script.
*
* @static
* @access public
* @since Twenty Fourteen 1.0
*/
public static function enqueue_scripts() {
@@ -393,16 +449,20 @@ class Featured_Content {
}
/**
* Get settings
* Get featured content settings.
*
* Get all settings recognized by this module. This function will return
* all settings whether or not they have been stored in the database yet.
* This ensures that all keys are available at all times.
* Get all settings recognized by this module. This function
* will return all settings whether or not they have been stored
* in the database yet. This ensures that all keys are available
* at all times.
*
* In the event that you only require one setting, you may pass its name
* as the first parameter to the function and only that value will be returned.
* In the event that you only require one setting, you may pass
* its name as the first parameter to the function and only that
* value will be returned.
*
* @uses Featured_Content::sanitize_quantity()
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @param string $key The key of a recognized setting.
* @return mixed Array of all settings by default. A single value if passed as first parameter.
@@ -429,18 +489,18 @@ class Featured_Content {
}
/**
* Validate settings
* Validate featured content settings.
*
* Make sure that all user supplied content is in an
* expected format before saving to the database. This
* function will also delete the transient set in
* Featured_Content::get_featured_content().
* Make sure that all user supplied content is in an expected
* format before saving to the database. This function will also
* delete the transient set in Featured_Content::get_featured_content().
*
* @uses Featured_Content::self::sanitize_quantity()
* @uses Featured_Content::self::delete_transient()
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @param array $input
* @return array $output
* @param array $input Array of settings input.
* @return array Validated settings output.
*/
public static function validate_settings( $input ) {
$output = array();
@@ -469,18 +529,21 @@ class Featured_Content {
$output['hide-tag'] = isset( $input['hide-tag'] ) && $input['hide-tag'] ? 1 : 0;
// Delete the featured post ids transient.
self::delete_transient();
return $output;
}
/**
* Sanitize quantity
* Sanitize quantity of featured posts.
*
* @static
* @access public
* @since Twenty Fourteen 1.0
*
* @param int $input The value to sanitize.
* @return int A number between 1 and FeaturedContent::$max_posts.
*
* @uses Featured_Content::$max_posts
*/
public static function sanitize_quantity( $input ) {
$quantity = absint( $input );
@@ -493,6 +556,7 @@ class Featured_Content {
return $quantity;
}
}
} // Featured_Content
Featured_Content::setup();

12
src/wp-content/themes/twentyfourteen/inc/template-tags.php
View File

@@ -36,7 +36,8 @@ function twentyfourteen_paging_nav() {
$format = $GLOBALS['wp_rewrite']->using_index_permalinks() && ! strpos( $pagenum_link, 'index.php' ) ? 'index.php/' : '';
$format .= $GLOBALS['wp_rewrite']->using_permalinks() ? user_trailingslashit( 'page/%#%', 'paged' ) : '?paged=%#%';
$links = paginate_links( array(
// Set up paginated links.
$links = paginate_links( array(
'base' => $pagenum_link,
'format' => $format,
'total' => $GLOBALS['wp_query']->max_num_pages,
@@ -109,6 +110,7 @@ function twentyfourteen_posted_on() {
echo '<span class="featured-post">' . __( 'Sticky', 'twentyfourteen' ) . '</span>';
}
// Set up and print post meta information.
printf( __( '<span class="entry-date"><a href="%1$s" rel="bookmark"><time class="entry-date" datetime="%2$s">%3$s</time></a></span> <span class="byline"><span class="author vcard"><a class="url fn n" href="%4$s" rel="author">%5$s</a></span></span>', 'twentyfourteen' ),
esc_url( get_permalink() ),
esc_attr( get_the_date( 'c' ) ),
@@ -149,7 +151,7 @@ function twentyfourteen_categorized_blog() {
}
/**
* Flush out the transients used in twentyfourteen_categorized_blog
* Flush out the transients used in twentyfourteen_categorized_blog.
*
* @since Twenty Fourteen 1.0
*
@@ -163,8 +165,10 @@ add_action( 'edit_category', 'twentyfourteen_category_transient_flusher' );
add_action( 'save_post', 'twentyfourteen_category_transient_flusher' );
/**
* Displays an optional post thumbnail, with an anchor element
* when on index views, and a div element when on a single view.
* Display an optional post thumbnail on a single view.
*
* Adds an anchor element to the post thumbnail, when on
* index views, and a div element when on a single view.
*
* @since Twenty Fourteen 1.0
*

16
src/wp-content/themes/twentyfourteen/inc/widgets.php
View File

@@ -16,6 +16,7 @@ class Twenty_Fourteen_Ephemera_Widget extends WP_Widget {
/**
* The supported post formats.
*
* @access private
* @since Twenty Fourteen 1.0
*
* @var array
@@ -25,6 +26,7 @@ class Twenty_Fourteen_Ephemera_Widget extends WP_Widget {
/**
* Pluralized post format strings.
*
* @access private
* @since Twenty Fourteen 1.0
*
* @var array
@@ -65,9 +67,10 @@ class Twenty_Fourteen_Ephemera_Widget extends WP_Widget {
/**
* Output the HTML for this widget.
*
* @access public
* @since Twenty Fourteen 1.0
*
* @param array $args An array of standard parameters for widgets in this theme.
* @param array $args An array of standard parameters for widgets in this theme.
* @param array $instance An array of settings for this widget instance.
* @return void Echoes its output.
*/
@@ -219,14 +222,15 @@ class Twenty_Fourteen_Ephemera_Widget extends WP_Widget {
}
/**
* Deal with the settings when they are saved by the admin. Here is where
* any validation should happen.
* Deal with the settings when they are saved by the admin.
*
* Here is where any validation should happen.
*
* @since Twenty Fourteen 1.0
*
* @param array $new_instance
* @param array $instance
* @return array
* @param array $new_instance New widget instance.
* @param array $instance Original widget instance.
* @return array Updated widget instance.
*/
function update( $new_instance, $instance ) {
$instance['title'] = strip_tags( $new_instance['title'] );

26
src/wp-content/themes/twentyfourteen/index.php
View File

@@ -2,10 +2,11 @@
/**
* The main template file
*
* This is the most generic template file in a WordPress theme
* and one of the two required files for a theme (the other being style.css).
* It is used to display a page when nothing more specific matches a query.
* E.g., it puts together the home page when no home.php file exists.
* This is the most generic template file in a WordPress theme and one
* of the two required files for a theme (the other being style.css).
* It is used to display a page when nothing more specific matches a query,
* e.g., it puts together the home page when no home.php file exists.
*
* @link http://codex.wordpress.org/Template_Hierarchy
*
* @package WordPress
@@ -18,9 +19,10 @@ get_header(); ?>
<div id="main-content" class="main-content">
<?php
if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
if ( is_front_page() && twentyfourteen_has_featured_posts() ) :
// Include the featured content template.
get_template_part( 'featured-content' );
}
endif;
?>
<div id="primary" class="content-area">
@@ -28,14 +30,22 @@ get_header(); ?>
<?php
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
endwhile;
// Previous/next post navigation.
twentyfourteen_paging_nav();
else :
// If no content, include the "No posts found" template.
get_template_part( 'content', 'none' );
endif;

6
src/wp-content/themes/twentyfourteen/page-templates/contributors.php
View File

@@ -13,6 +13,7 @@ get_header(); ?>
<?php
if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
// Include the featured content template.
get_template_part( 'featured-content' );
}
?>
@@ -20,14 +21,15 @@ get_header(); ?>
<div id="primary" class="content-area">
<div id="content" class="site-content" role="main">
<?php
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
?>
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<?php
the_title( '<header class="entry-header"><h1 class="entry-title">', '</h1></header><!-- .entry-header -->' );
// Output the authors list.
twentyfourteen_list_authors();
edit_post_link( __( 'Edit', 'twentyfourteen' ), '<footer class="entry-meta"><span class="edit-link">', '</span></footer>' );

6
src/wp-content/themes/twentyfourteen/page-templates/full-width.php
View File

@@ -13,6 +13,7 @@ get_header(); ?>
<?php
if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
// Include the featured content template.
get_template_part( 'featured-content' );
}
?>
@@ -20,9 +21,10 @@ get_header(); ?>
<div id="primary" class="content-area">
<div id="content" class="site-content" role="main">
<?php
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
// Include the page content template.
get_template_part( 'content', 'page' );
// If comments are open or we have at least one comment, load up the comment template.

18
src/wp-content/themes/twentyfourteen/page.php
View File

@@ -3,8 +3,8 @@
* The template for displaying all pages
*
* This is the template that displays all pages by default.
* Please note that this is the WordPress construct of pages and that other 'pages'
* on your WordPress site will use a different template.
* Please note that this is the WordPress construct of pages and that
* other 'pages' on your WordPress site will use a different template.
*
* @package WordPress
* @subpackage Twenty_Fourteen
@@ -16,23 +16,25 @@ get_header(); ?>
<div id="main-content" class="main-content">
<?php
if ( is_front_page() && twentyfourteen_has_featured_posts() ) {
if ( is_front_page() && twentyfourteen_has_featured_posts() ) :\
// Include the featured content template.
get_template_part( 'featured-content' );
}
endif;
?>
<div id="primary" class="content-area">
<div id="content" class="site-content" role="main">
<?php
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
// Include the page content template.
get_template_part( 'content', 'page' );
// If comments are open or we have at least one comment, load up the comment template.
if ( comments_open() || get_comments_number() ) {
if ( comments_open() || get_comments_number() ) :
comments_template();
}
endif;
endwhile;
?>

14
src/wp-content/themes/twentyfourteen/search.php
View File

@@ -18,15 +18,23 @@ get_header(); ?>
<h1 class="page-title"><?php printf( __( 'Search Results for: %s', 'twentyfourteen' ), get_search_query() ); ?></h1>
</header><!-- .page-header -->
<?php
while ( have_posts() ) :
the_post();
<?php
// Start the Loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
endwhile;
// Previous/next post navigation.
twentyfourteen_paging_nav();
else :
// If no content, include the "No posts found" template.
get_template_part( 'content', 'none' );
endif;

10
src/wp-content/themes/twentyfourteen/single.php
View File

@@ -12,11 +12,17 @@ get_header(); ?>
<div id="primary" class="content-area">
<div id="content" class="site-content" role="main">
<?php
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
// Previous/next post navigation.
twentyfourteen_post_nav();
// If comments are open or we have at least one comment, load up the comment template.

12
src/wp-content/themes/twentyfourteen/tag.php
View File

@@ -31,14 +31,22 @@ get_header(); ?>
</header><!-- .archive-header -->
<?php
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
endwhile;
// Previous/next page navigation.
twentyfourteen_paging_nav();
else :
// If no content, include the "No posts found" template.
get_template_part( 'content', 'none' );
endif;

12
src/wp-content/themes/twentyfourteen/taxonomy-post_format.php
View File

@@ -53,14 +53,22 @@ get_header(); ?>
</header><!-- .archive-header -->
<?php
while ( have_posts() ) :
the_post();
// Start the Loop.
while ( have_posts() ) : the_post();
/*
* Include the post format-specific template for the content. If you want to
* use this in a child theme, then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/
get_template_part( 'content', get_post_format() );
endwhile;
// Previous/next page navigation.
twentyfourteen_paging_nav();
else :
// If no content, include the "No posts found" template.
get_template_part( 'content', 'none' );
endif;