WordPress.org
Get WordPress

Make WordPress Core

Changeset 25769


Ignore:
Timestamp:
10/11/2013 10:01:14 PM (11 years ago)
Author:
lancewillett
Message:

Twenty Fourteen: first pass for updating code comments to reflect WP inline docs standards, see #25257.

Location:
trunk/src/wp-content/themes/twentyfourteen
Files:
37 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-content/themes/twentyfourteen/404.php

    r25021 r25769  
    11<?php
    22/**
    3  * The template for displaying 404 pages (Not Found).
     3 * The template for displaying 404 pages (Not Found)
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/archive.php

    r25213 r25769  
    11<?php
    22/**
    3  * The template for displaying Archive pages.
     3 * The template for displaying Archive pages
    44 *
    55 * Used to display archive-type pages if nothing more specific matches a query.
    … …  
    1111 * and author.php for Author archives.
    1212 *
    13  * Learn more: http://codex.wordpress.org/Template_Hierarchy
     13 * @link http://codex.wordpress.org/Template_Hierarchy
    1414 *
    1515 * @package WordPress
    1616 * @subpackage Twenty_Fourteen
     17 * @since Twenty Fourteen 1.0
    1718 */
    1819

  • trunk/src/wp-content/themes/twentyfourteen/author.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying Author archive pages.
     3 * The template for displaying Author archive pages
    44 *
    5  * Learn more: http://codex.wordpress.org/Template_Hierarchy
     5 * @link http://codex.wordpress.org/Template_Hierarchy
    66 *
    77 * @package WordPress
    88 * @subpackage Twenty_Fourteen
     9 * @since Twenty Fourteen 1.0
    910 */
    1011
    … …  
    1920                <h1 class="archive-title">
    2021                    <?php
    21                         /* Queue the first post, that way we know what author
     22                        /*
     23                         * Queue the first post, that way we know what author
    2224                         * we're dealing with (if that is the case).
    2325                         *
    … …  
    3739
    3840            <?php
    39                     /* Since we called the_post() above, we need to rewind
     41                    /*
     42                     * Since we called the_post() above, we need to rewind
    4043                     * the loop back to the beginning that way we can run
    4144                     * the loop properly, in full.

  • trunk/src/wp-content/themes/twentyfourteen/category.php

    r25213 r25769  
    11<?php
    22/**
    3  * The template for displaying Category pages.
     3 * The template for displaying Category pages
    44 *
    5  * Learn more: http://codex.wordpress.org/Template_Hierarchy
     5 * @link http://codex.wordpress.org/Template_Hierarchy
    66 *
    77 * @package WordPress
    88 * @subpackage Twenty_Fourteen
     9 * @since Twenty Fourteen 1.0
    910 */
    1011

  • trunk/src/wp-content/themes/twentyfourteen/comments.php

    r25519 r25769  
    11<?php
    22/**
    3  * The template for displaying Comments.
     3 * The template for displaying Comments
    44 *
    55 * The area of the page that contains comments and the comment form.
    … …  
    77 * @package WordPress
    88 * @subpackage Twenty_Fourteen
     9 * @since Twenty Fourteen 1.0
    910 */
    1011

  • trunk/src/wp-content/themes/twentyfourteen/content-aside.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying posts in the Aside post format.
     3 * The template for displaying posts in the Aside post format
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89?>

  • trunk/src/wp-content/themes/twentyfourteen/content-featured-post.php

    r25743 r25769  
    11<?php
    22/**
     3 * The template for displaying featured posts on the front page
     4 *
    35 * @package WordPress
    46 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    58 */
    69?>

  • trunk/src/wp-content/themes/twentyfourteen/content-gallery.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying posts in the Gallery post format.
     3 * The template for displaying posts in the Gallery post format
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/content-image.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying posts in the Image post format.
     3 * The template for displaying posts in the Image post format
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89?>

  • trunk/src/wp-content/themes/twentyfourteen/content-link.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying posts in the Link post format.
     3 * The template for displaying posts in the Link post format
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89?>

  • trunk/src/wp-content/themes/twentyfourteen/content-none.php

    r25213 r25769  
    11<?php
    22/**
    3  * The template for displaying a "No posts found" message.
     3 * The template for displaying a "No posts found" message
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89?>

  • trunk/src/wp-content/themes/twentyfourteen/content-page.php

    r25735 r25769  
    11<?php
    22/**
    3  * The template used for displaying page content.
     3 * The template used for displaying page content
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89?>

  • trunk/src/wp-content/themes/twentyfourteen/content-quote.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying posts in the Quote post format.
     3 * The template for displaying posts in the Quote post format
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89?>

  • trunk/src/wp-content/themes/twentyfourteen/content-recent-formatted-post.php

    r25021 r25769  
    11<?php
    22/**
     3 * The template to display recent Featured Posts
     4 *
    35 * @package WordPress
    46 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    58 */
    69if ( isset( $GLOBALS['content_width'] ) )

  • trunk/src/wp-content/themes/twentyfourteen/content-video.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying posts in the Video post format.
     3 * The template for displaying posts in the Video post format
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89?>

  • trunk/src/wp-content/themes/twentyfourteen/content.php

    r25735 r25769  
    11<?php
    22/**
     3 * The default template for displaying content
     4 *
     5 * Used for both single and index/archive/search.
     6 *
    37 * @package WordPress
    48 * @subpackage Twenty_Fourteen
     9 * @since Twenty Fourteen 1.0
    510 */
    611?>

  • trunk/src/wp-content/themes/twentyfourteen/contributor-page.php

    r25519 r25769  
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/featured-content.php

    r25519 r25769  
    11<?php
    22/**
    3  * The template for displaying featured content.
     3 * The template for displaying featured content
    44 *
    55 * @todo: Add support for featured content.
    … …  
    77 * @package WordPress
    88 * @subpackage Twenty_Fourteen
     9 * @since Twenty Fourteen 1.0
    910 */
    1011?>

  • trunk/src/wp-content/themes/twentyfourteen/footer.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying the footer.
     3 * The template for displaying the footer
    44 *
    55 * Contains footer content and the closing of the #main and #page div elements.
    … …  
    77 * @package WordPress
    88 * @subpackage Twenty_Fourteen
     9 * @since Twenty Fourteen 1.0
    910 */
    1011?>

  • trunk/src/wp-content/themes/twentyfourteen/front-page.php

    r25762 r25769  
    11<?php
    22/**
    3  * The template for displaying the home page.
     3 * The template for displaying the home page
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/full-width-page.php

    r25519 r25769  
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/functions.php

    r25762 r25769  
    11<?php
    22/**
    3  * Twenty Fourteen functions and definitions.
    4  *
    5  * Sets up the theme and provides some helper functions, which are used in the
     3 * Twenty Fourteen functions and definitions
     4 *
     5 * Set up the theme and provides some helper functions, which are used in the
    66 * theme as custom template tags. Others are attached to action and filter
    77 * hooks in WordPress to change core functionality.
    … …  
    1818 *
    1919 * For more information on hooks, actions, and filters,
    20  * see http://codex.wordpress.org/Plugin_API
     20 * @link http://codex.wordpress.org/Plugin_API
    2121 *
    2222 * @package WordPress
    2323 * @subpackage Twenty_Fourteen
    24  */
    25 
    26 /**
    27  * Sets up the content width value based on the theme's design.
    28  * @see twentyfourteen_content_width() for template-specific adjustments.
     24 * @since Twenty Fourteen 1.0
     25 */
     26
     27/**
     28 * Set up the content width value based on the theme's design.
     29 *
     30 * @link twentyfourteen_content_width()
     31 *
     32 * @since Twenty Fourteen 1.0
    2933 */
    3034if ( ! isset( $content_width ) )
    … …  
    3337if ( ! function_exists( 'twentyfourteen_setup' ) ) :
    3438/**
    35  * Sets up theme defaults and registers support for various WordPress features.
     39 * Twenty Fourteen setup.
     40 *
     41 * Set up theme defaults and registers support for various WordPress features.
    3642 *
    3743 * Note that this function is hooked into the after_setup_theme hook, which
    3844 * runs before the init hook. The init hook is too late for some features, such
    3945 * as indicating support post thumbnails.
     46 *
     47 * @since Twenty Fourteen 1.0
    4048 */
    4149function twentyfourteen_setup() {
    4250
    4351    /*
    44      * Makes Twenty Fourteen available for translation.
     52     * Make Twenty Fourteen available for translation.
    4553     *
    4654     * Translations can be added to the /languages/ directory.
    … …  
    5159    load_theme_textdomain( 'twentyfourteen', get_template_directory() . '/languages' );
    5260
    53     /*
    54     * This theme styles the visual editor to resemble the theme style.
    55     */
     61    // This theme styles the visual editor to resemble the theme style.
    5662    add_editor_style( array( 'editor-style.css', twentyfourteen_font_url() ) );
    5763
    58     // Adds RSS feed links to <head> for posts and comments.
     64    // Add RSS feed links to <head> for posts and comments.
    5965    add_theme_support( 'automatic-feed-links' );
    6066
    … …  
    6268    add_theme_support( 'post-thumbnails' );
    6369
    64     // Adding several sizes for Post Thumbnails.
     70    // Add several sizes for Post Thumbnails.
    6571    add_image_size( 'featured-thumbnail-large', 672, 0 );
    6672    add_image_size( 'featured-thumbnail-featured', 672, 336, true );
    … …  
    7480
    7581    /*
    76      * Switches default core markup for search form, comment form, and comments
     82     * Switch default core markup for search form, comment form, and comments
    7783     * to output valid HTML5.
    7884     */
    … …  
    100106
    101107/**
    102  * Adjusts content_width value for full-width and attachment templates.
     108 * Adjust content_width value for full-width and attachment templates.
     109 *
     110 * @since Twenty Fourteen 1.0
    103111 *
    104112 * @return void
    … …  
    112120/**
    113121 * Getter function for Featured Content Plugin.
     122 *
     123 * @since Twenty Fourteen 1.0
    114124 */
    115125function twentyfourteen_get_featured_posts() {
    … …  
    121131 * So that we can use a condition like
    122132 * if ( twentyfourteen_has_featured_posts( 1 ) )
     133 *
     134 * @since Twenty Fourteen 1.0
    123135 */
    124136function twentyfourteen_has_featured_posts( $minimum = 1 ) {
    … …  
    132144
    133145/**
    134  * Registers two widget areas.
     146 * Register two widget areas.
     147 *
     148 * @since Twenty Fourteen 1.0
    135149 *
    136150 * @return void
    … …  
    173187 * Register Lato Google font for Twenty Fourteen.
    174188 *
     189 * @since Twenty Fourteen 1.0
     190 *
    175191 * @return void
    176192 */
    … …  
    188204
    189205/**
    190  * Enqueues scripts and styles for front end.
     206 * Enqueue scripts and styles for front end.
     207 *
     208 * @since Twenty Fourteen 1.0
    191209 *
    192210 * @return void
    … …  
    222240 * Enqueue Google fonts style to admin screen for custom header display.
    223241 *
     242 * @since Twenty Fourteen 1.0
     243 *
    224244 * @return void
    225245 */
    … …  
    230250
    231251/**
    232  * Sets the post excerpt length to 20 words.
     252 * Set the post excerpt length to 20 words.
     253 *
     254 * @since Twenty Fourteen 1.0
    233255 *
    234256 * @param int $length
    … …  
    241263
    242264/**
    243  * Returns a "Continue Reading" link for excerpts
     265 * Return a "Continue Reading" link for excerpts.
     266 *
     267 * @since Twenty Fourteen 1.0
    244268 *
    245269 * @return string
    … …  
    250274
    251275/**
    252  * Replaces "[...]" (appended to automatically generated excerpts) with an
     276 * Replace "[...]" (appended to automatically generated excerpts) with an
    253277 * ellipsis and twentyeleven_continue_reading_link().
     278 *
     279 * @since Twenty Fourteen 1.0
    254280 *
    255281 * @param string $more
    … …  
    262288
    263289/**
    264  * Adds a pretty "Continue Reading" link to custom post excerpts.
     290 * Add a pretty "Continue Reading" link to custom post excerpts.
    265291 *
    266292 * To override this link in a child theme, remove the filter and add your own
    267293 * function tied to the get_the_excerpt filter hook.
     294 *
     295 * @since Twenty Fourteen 1.0
    268296 *
    269297 * @param string $output
    … …  
    280308if ( ! function_exists( 'twentyfourteen_the_attached_image' ) ) :
    281309/**
    282  * Prints the attached image with a link to the next attached image.
     310 * Print the attached image with a link to the next attached image.
     311 *
     312 * @since Twenty Fourteen 1.0
    283313 *
    284314 * @return void
    … …  
    289319    $next_attachment_url = wp_get_attachment_url();
    290320
    291     /**
     321    /*
    292322     * Grab the IDs of all the image attachments in a gallery so we can get the URL
    293323     * of the next adjacent image in a gallery, or the first image (if we're
    … …  
    333363if ( ! function_exists( 'twentyfourteen_list_authors' ) ) :
    334364/**
    335  * Prints a list of all site contributors who published at least one post.
     365 * Print a list of all site contributors who published at least one post.
     366 *
     367 * @since Twenty Fourteen 1.0
    336368 *
    337369 * @return void
    … …  
    373405
    374406/**
    375  * Gets recent formatted posts that are not featured in FC plugin.
    376  *
     407 * Get recent formatted posts that are not featured in FC plugin.
     408 *
     409 * @since Twenty Fourteen 1.0
     410 *
     411 * @return object WP_Query
    377412 */
    378413function twentyfourteen_get_recent( $post_format ) {
    … …  
    403438 * Filter the home page posts, and remove formatted posts visible in the sidebar from it
    404439 *
     440 * @since Twenty Fourteen 1.0
     441 *
     442 * @return void
    405443 */
    406444function twentyfourteen_pre_get_posts( $query ) {
    … …  
    444482
    445483/**
    446  *  Extends the default WordPress body classes.
     484 * Extend the default WordPress body classes.
    447485 *
    448486 * Adds body classes to denote:
    … …  
    452490 * 4. Presence of footer widgets.
    453491 *
     492 * @since Twenty Fourteen 1.0
     493 *
    454494 * @param array $classes A list of existing body class values.
    455495 * @return array The filtered body class list.
    … …  
    476516
    477517/**
    478  * Extends the default WordPress post classes.
     518 * Extend the default WordPress post classes.
    479519 *
    480520 * Adds a post class to denote:
    481521 * Non-password protected page with a featured image.
     522 *
     523 * @since Twenty Fourteen 1.0
    482524 *
    483525 * @param array $classes A list of existing post class values.
    … …  
    493535
    494536/**
    495  * Creates a nicely formatted and more specific title element text for output
     537 * Create a nicely formatted and more specific title element text for output
    496538 * in head of document, based on current view.
     539 *
     540 * @since Twenty Fourteen 1.0
    497541 *
    498542 * @param string $title Default title text for current view.
    … …  
    522566add_filter( 'wp_title', 'twentyfourteen_wp_title', 10, 2 );
    523567
    524 /**
    525  * Implement the Custom Header feature
    526  *
    527  */
     568// Implement Custom Header features.
    528569require get_template_directory() . '/inc/custom-header.php';
    529570
    530 /**
    531  * Custom template tags for this theme.
    532  */
     571// Custom template tags for this theme.
    533572require get_template_directory() . '/inc/template-tags.php';
    534573
    535 /**
    536  * Customizer additions
    537  */
     574// Add Theme Customizer functionality.
    538575require get_template_directory() . '/inc/customizer.php';

  • trunk/src/wp-content/themes/twentyfourteen/header.php

    r25743 r25769  
    11<?php
    22/**
    3  * The Header for our theme.
     3 * The Header for our theme
    44 *
    55 * Displays all of the <head> section and everything up till <div id="main">
    … …  
    77 * @package WordPress
    88 * @subpackage Twenty_Fourteen
     9 * @since Twenty Fourteen 1.0
    910 */
    1011?><!DOCTYPE html>

  • trunk/src/wp-content/themes/twentyfourteen/image.php

    r25743 r25769  
    11<?php
    22/**
    3  * The template for displaying image attachments.
     3 * The template for displaying image attachments
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/inc/custom-header.php

    r25765 r25769  
    11<?php
    22/**
     3 * Implement Custom Header functionality for Twenty Fourteen
     4 *
    35 * @package WordPress
    46 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    58 */
    69
    710/**
    8  * Setup the WordPress core custom header feature.
     11 * Set up the WordPress core custom header settings.
     12 *
     13 * @since Twenty Fourteen 1.0
    914 *
    1015 * @uses twentyfourteen_header_style()
    … …  
    2631if ( ! function_exists( 'twentyfourteen_admin_header_style' ) ) :
    2732/**
    28  * Styles the header image displayed on the Appearance > Header admin panel.
     33 * Style the header image displayed on the Appearance > Header admin panel.
    2934 *
    30  * @see twentyfourteen_custom_header_setup().
     35 * @link twentyfourteen_custom_header_setup().
     36 *
     37 * @since Twenty Fourteen 1.0
    3138 */
    3239function twentyfourteen_admin_header_style() {
    … …  
    5966if ( ! function_exists( 'twentyfourteen_admin_header_image' ) ) :
    6067/**
    61  * Custom header image markup displayed on the Appearance > Header admin panel.
     68 * Create the custom header image markup displayed on the Appearance > Header admin panel.
    6269 *
    63  * @see twentyfourteen_custom_header_setup().
     70 * @link twentyfourteen_custom_header_setup().
     71 *
     72 * @since Twenty Fourteen 1.0
    6473 */
    6574function twentyfourteen_admin_header_image() {

  • trunk/src/wp-content/themes/twentyfourteen/inc/customizer.php

    r25762 r25769  
    11<?php
    22/**
    3  * Twenty Fourteen Theme Customizer
     3 * Twenty Fourteen Theme Customizer support
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89
    910/**
    1011 * Add postMessage support for site title and description for the Theme Customizer.
     12 *
     13 * @since Twenty Fourteen 1.0
    1114 *
    1215 * @param WP_Customize_Manager $wp_customize Theme Customizer object.
    … …  
    3033
    3134/**
    32  * Binds JS handlers to make Theme Customizer preview reload changes asynchronously.
     35 * Bind JS handlers to make Theme Customizer preview reload changes asynchronously.
     36 *
     37 * @since Twenty Fourteen 1.0
    3338 */
    3439function twentyfourteen_customize_preview_js() {
    … …  
    3843
    3944/**
    40  * Generates two variants of the accent color, returns the original, and saves the others as theme mods.
     45 * Generate two variants of the accent color, return the original, and
     46 * save the others as theme mods.
     47 *
     48 * @since Twenty Fourteen 1.0
    4149 *
    4250 * @param string $color The original color.
    … …  
    5361
    5462/**
    55  * Tweaks the brightness of a color by adjusting the RGB values by the given interval.
     63 * Tweak the brightness of a color by adjusting the RGB values by the given interval.
    5664 *
    5765 * Use positive values of $steps to brighten the color and negative values to darken the color.
    … …  
    5967 * is generally maintained unless the number of steps causes one value to be capped at 0 or 255.
    6068 *
     69 * @since Twenty Fourteen 1.0
     70 *
    6171 * @param string $color The original color, in 3- or 6-digit hexadecimal form.
    62  * @param int $steps The number of steps to adjust the color by, in rgb units.
     72 * @param int $steps The number of steps to adjust the color by, in RGB units.
    6373 * @return string $color The new color, in 6-digit hexadecimal form.
    6474 */
    … …  
    8797
    8898/**
    89  * Outputs the css for the Theme Customizer options.
     99 * Output the CSS for the Theme Customizer options.
     100 *
     101 * @since Twenty Fourteen 1.0
     102 *
     103 * @return void
    90104 */
    91105function twentyfourteen_customizer_styles() {

  • trunk/src/wp-content/themes/twentyfourteen/inc/template-tags.php

    r25743 r25769  
    11<?php
    22/**
    3  * Custom template tags for this theme.
     3 * Custom template tags for Twenty Fourteen
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89
    910if ( ! function_exists( 'twentyfourteen_paging_nav' ) ) :
    1011/**
    11  * Displays navigation to next/previous set of posts when applicable.
     12 * Display navigation to next/previous set of posts when applicable.
     13 *
     14 * @since Twenty Fourteen 1.0
    1215 *
    1316 * @return void
    … …  
    5962if ( ! function_exists( 'twentyfourteen_post_nav' ) ) :
    6063/**
    61  * Displays navigation to next/previous post when applicable.
    62 *
    63 * @return void
    64 */
     64 * Display navigation to next/previous post when applicable.
     65 *
     66 * @since Twenty Fourteen 1.0
     67 *
     68 * @return void
     69 */
    6570function twentyfourteen_post_nav() {
    6671    // Don't print empty markup if there's nowhere to navigate.
    … …  
    8792if ( ! function_exists( 'twentyfourteen_posted_on' ) ) :
    8893/**
    89  * Prints HTML with meta information for the current post-date/time and author.
     94 * Print HTML with meta information for the current post-date/time and author.
     95 *
     96 * @since Twenty Fourteen 1.0
    9097 *
    9198 * @return void
    … …  
    106113
    107114/**
    108  * Returns true if a blog has more than 1 category
     115 * Find out if blog has more than one category.
    109116 *
    110  * @return boolean
     117 * @since Twenty Fourteen 1.0
     118 *
     119 * @return boolean true if blog has more than 1 category
    111120 */
    112121function twentyfourteen_categorized_blog() {
    … …  
    135144 * Flush out the transients used in twentyfourteen_categorized_blog
    136145 *
     146 * @since Twenty Fourteen 1.0
     147 *
     148 * @return void
    137149 */
    138150function twentyfourteen_category_transient_flusher() {
    … …  
    144156
    145157/**
    146  * Displays featured image with appropriate html tag.
     158 * Display featured image with appropriate HTML tag.
     159 *
     160 * @since Twenty Fourteen 1.0
    147161 *
    148162 * @return void

  • trunk/src/wp-content/themes/twentyfourteen/inc/widgets.php

    r25743 r25769  
    11<?php
    22/**
    3  * Makes a custom Widget for displaying Aside, Quote, Video, Image, Gallery,
    4  * and Link posts, available with Twenty Fourteen.
     3 * Custom Widget for displaying specific post formats
    54 *
    6  * Learn more: http://codex.wordpress.org/Widgets_API#Developing_Widgets
     5 * Displays posts from Aside, Quote, Video, Image, Gallery, and Link formats.
     6 *
     7 * @link http://codex.wordpress.org/Widgets_API#Developing_Widgets
    78 *
    89 * @package WordPress
    910 * @subpackage Twenty_Fourteen
     11 * @since Twenty Fourteen 1.0
    1012 */
    1113
    … …  
    1517     * The supported post formats.
    1618     *
     19     * @since Twenty Fourteen 1.0
     20     *
    1721     * @var array
    1822     */
    … …  
    2226     * Pluralized post format strings.
    2327     *
     28     * @since Twenty Fourteen 1.0
     29     *
    2430     * @var array
    2531     */
    … …  
    2834    /**
    2935     * Constructor.
     36     *
     37     * @since Twenty Fourteen 1.0
    3038     *
    3139     * @return Twenty_Fourteen_Ephemera_Widget
    … …  
    3745        ) );
    3846
    39         /**
     47        /*
    4048         * @todo http://core.trac.wordpress.org/ticket/23257
    4149         */
    … …  
    5563
    5664    /**
    57      * Outputs the HTML for this widget.
     65     * Output the HTML for this widget.
     66     *
     67     * @since Twenty Fourteen 1.0
    5868     *
    5969     * @param array $args An array of standard parameters for widgets in this theme.
    … …  
    192202
    193203    /**
    194      * Deals with the settings when they are saved by the admin. Here is where
    195      * any validation should be dealt with.
     204     * Deal with the settings when they are saved by the admin. Here is where
     205     * any validation should happen.
     206     *
     207     * @since Twenty Fourteen 1.0
    196208     *
    197209     * @param array $new_instance
    … …  
    211223
    212224    /**
    213      * Deletes the transient.
     225     * Delete the transient.
     226     *
     227     * @since Twenty Fourteen 1.0
    214228     *
    215229     * @return void
    … …  
    220234
    221235    /**
    222      * Displays the form for this widget on the Widgets page of the Admin area.
     236     * Display the form for this widget on the Widgets page of the Admin area.
     237     *
     238     * @since Twenty Fourteen 1.0
    223239     *
    224240     * @param array $instance

  • trunk/src/wp-content/themes/twentyfourteen/index.php

    r25213 r25769  
    11<?php
    22/**
    3  * The main template file.
     3 * The main template file
    44 *
    55 * This is the most generic template file in a WordPress theme
    … …  
    77 * It is used to display a page when nothing more specific matches a query.
    88 * E.g., it puts together the home page when no home.php file exists.
    9  * Learn more: http://codex.wordpress.org/Template_Hierarchy
     9 * @link http://codex.wordpress.org/Template_Hierarchy
    1010 *
    1111 * @package WordPress
    1212 * @subpackage Twenty_Fourteen
     13 * @since Twenty Fourteen 1.0
    1314 */
    1415

  • trunk/src/wp-content/themes/twentyfourteen/page.php

    r25023 r25769  
    11<?php
    22/**
    3  * The template for displaying all pages.
     3 * The template for displaying all pages
    44 *
    55 * This is the template that displays all pages by default.
    6  * Please note that this is the WordPress construct of pages
    7  * and that other 'pages' on your WordPress site will use a
    8  * different template.
     6 * Please note that this is the WordPress construct of pages and that other 'pages'
     7 * on your WordPress site will use a different template.
    98 *
    109 * @package WordPress
    1110 * @subpackage Twenty_Fourteen
     11 * @since Twenty Fourteen 1.0
    1212 */
    1313

  • trunk/src/wp-content/themes/twentyfourteen/search.php

    r25213 r25769  
    11<?php
    22/**
    3  * The template for displaying Search Results pages.
     3 * The template for displaying Search Results pages
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/sidebar-content.php

    r25762 r25769  
    11<?php
    22/**
    3  * The Content Sidebar.
     3 * The Content Sidebar
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89if ( ! is_active_sidebar( 'sidebar-2' ) )

  • trunk/src/wp-content/themes/twentyfourteen/sidebar-footer.php

    r25762 r25769  
    11<?php
    22/**
    3  * The Sidebar containing the main widget area.
     3 * The Footer Sidebar
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/sidebar.php

    r25023 r25769  
    11<?php
    22/**
    3  * The Sidebar containing the main widget area.
     3 * The Sidebar containing the main widget area
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89?>

  • trunk/src/wp-content/themes/twentyfourteen/single.php

    r25088 r25769  
    11<?php
    22/**
    3  * The Template for displaying all single posts.
     3 * The Template for displaying all single posts
    44 *
    55 * @package WordPress
    66 * @subpackage Twenty_Fourteen
     7 * @since Twenty Fourteen 1.0
    78 */
    89

  • trunk/src/wp-content/themes/twentyfourteen/tag.php

    r25213 r25769  
    11<?php
    22/**
    3  * The template for displaying Tag pages.
     3 * The template for displaying Tag pages
    44 *
    55 * Used to display archive-type pages for posts in a tag.
    66 *
    7  * Learn more: http://codex.wordpress.org/Template_Hierarchy
     7 * @link http://codex.wordpress.org/Template_Hierarchy
    88 *
    99 * @package WordPress
    1010 * @subpackage Twenty_Fourteen
     11 * @since Twenty Fourteen 1.0
    1112 */
    1213

  • trunk/src/wp-content/themes/twentyfourteen/taxonomy-post_format.php

    r25213 r25769  
    11<?php
    22/**
    3  * The template for displaying Post Format pages.
     3 * The template for displaying Post Format pages
    44 *
    55 * Used to display archive-type pages for posts with a post format.
    … …  
    77 * new template file for each specific one.
    88 *
    9  * Learn more: http://codex.wordpress.org/Template_Hierarchy
     9 * @link http://codex.wordpress.org/Template_Hierarchy
    1010 *
    1111 * @package WordPress
    1212 * @subpackage Twenty_Fourteen
     13 * @since Twenty Fourteen 1.0
    1314 */
    1415
Note: See TracChangeset for help on using the changeset viewer.