-
+
diff --git a/footer.php b/footer.php
index 91ca7927f..79848d342 100644
--- a/footer.php
+++ b/footer.php
@@ -1,9 +1,8 @@
'e6e6e6',
@@ -78,12 +80,12 @@ function twentytwelve_setup() {
add_action( 'after_setup_theme', 'twentytwelve_setup' );
/**
- * Adds support for a custom header image.
+ * Add support for a custom header image.
*/
require( get_template_directory() . '/inc/custom-header.php' );
/**
- * Returns the Google font stylesheet URL if available.
+ * Return the Google font stylesheet URL if available.
*
* The use of Open Sans by default is localized. For languages that use
* characters not supported by the font, the font can be disabled.
@@ -95,13 +97,17 @@ require( get_template_directory() . '/inc/custom-header.php' );
function twentytwelve_get_font_url() {
$font_url = '';
- /* translators: If there are characters in your language that are not supported
- by Open Sans, translate this to 'off'. Do not translate into your own language. */
+ /**
+ * translators: If there are characters in your language that are not supported
+ * by Open Sans, translate this to 'off'. Do not translate into your own language.
+ */
if ( 'off' !== _x( 'on', 'Open Sans font: on or off', 'twentytwelve' ) ) {
$subsets = 'latin,latin-ext';
- /* translators: To add an additional Open Sans character subset specific to your language, translate
- this to 'greek', 'cyrillic' or 'vietnamese'. Do not translate into your own language. */
+ /**
+ * translators: To add an additional Open Sans character subset specific to your language,
+ * translate this to 'greek', 'cyrillic' or 'vietnamese'. Do not translate into your own language.
+ */
$subset = _x( 'no-subset', 'Open Sans font: add new subset (greek, cyrillic, vietnamese)', 'twentytwelve' );
if ( 'cyrillic' == $subset )
@@ -123,21 +129,23 @@ function twentytwelve_get_font_url() {
}
/**
- * Enqueues scripts and styles for front-end.
+ * Enqueue scripts and styles for front-end.
*
* @since Twenty Twelve 1.0
+ *
+ * @return void
*/
function twentytwelve_scripts_styles() {
global $wp_styles;
- /*
+ /**
* Adds JavaScript to pages with the comment form to support
* sites with threaded comments (when in use).
*/
if ( is_singular() && comments_open() && get_option( 'thread_comments' ) )
wp_enqueue_script( 'comment-reply' );
- /*
+ /**
* Adds JavaScript for handling the navigation menu hide-and-show behavior.
*/
wp_enqueue_script( 'twentytwelve-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0', true );
@@ -146,12 +154,12 @@ function twentytwelve_scripts_styles() {
if ( ! empty( $font_url ) )
wp_enqueue_style( 'twentytwelve-fonts', esc_url_raw( $font_url ), array(), null );
- /*
+ /**
* Loads our main stylesheet.
*/
wp_enqueue_style( 'twentytwelve-style', get_stylesheet_uri() );
- /*
+ /**
* Loads the Internet Explorer specific stylesheet.
*/
wp_enqueue_style( 'twentytwelve-ie', get_template_directory_uri() . '/css/ie.css', array( 'twentytwelve-style' ), '20121010' );
@@ -160,6 +168,8 @@ function twentytwelve_scripts_styles() {
add_action( 'wp_enqueue_scripts', 'twentytwelve_scripts_styles' );
/**
+ * Filter TinyMCE CSS path to include Google Fonts.
+ *
* Adds additional stylesheets to the TinyMCE editor if needed.
*
* @uses twentytwelve_get_font_url() To get the Google Font stylesheet URL.
@@ -167,7 +177,7 @@ add_action( 'wp_enqueue_scripts', 'twentytwelve_scripts_styles' );
* @since Twenty Twelve 1.2
*
* @param string $mce_css CSS path to load in TinyMCE.
- * @return string
+ * @return string Filtered CSS path.
*/
function twentytwelve_mce_css( $mce_css ) {
$font_url = twentytwelve_get_font_url();
@@ -185,6 +195,8 @@ function twentytwelve_mce_css( $mce_css ) {
add_filter( 'mce_css', 'twentytwelve_mce_css' );
/**
+ * Filter the page title.
+ *
* Creates a nicely formatted and more specific title element text
* for output in head of document, based on current view.
*
@@ -217,6 +229,8 @@ function twentytwelve_wp_title( $title, $sep ) {
add_filter( 'wp_title', 'twentytwelve_wp_title', 10, 2 );
/**
+ * Filter the page menu arguments.
+ *
* Makes our wp_nav_menu() fallback -- wp_page_menu() -- show a home link.
*
* @since Twenty Twelve 1.0
@@ -229,6 +243,8 @@ function twentytwelve_page_menu_args( $args ) {
add_filter( 'wp_page_menu_args', 'twentytwelve_page_menu_args' );
/**
+ * Register sidebars.
+ *
* Registers our main widget area and the front page widget areas.
*
* @since Twenty Twelve 1.0
@@ -297,6 +313,8 @@ if ( ! function_exists( 'twentytwelve_comment' ) ) :
* Used as a callback by wp_list_comments() for displaying the comments.
*
* @since Twenty Twelve 1.0
+ *
+ * @return void
*/
function twentytwelve_comment( $comment, $args, $depth ) {
$GLOBALS['comment'] = $comment;
@@ -353,11 +371,15 @@ endif;
if ( ! function_exists( 'twentytwelve_entry_meta' ) ) :
/**
+ * Set up post entry meta.
+ *
* Prints HTML with meta information for current post: categories, tags, permalink, author, and date.
*
* Create your own twentytwelve_entry_meta() to override in a child theme.
*
* @since Twenty Twelve 1.0
+ *
+ * @return void
*/
function twentytwelve_entry_meta() {
// Translators: used between list items, there is a space after the comma.
@@ -399,6 +421,8 @@ function twentytwelve_entry_meta() {
endif;
/**
+ * Extend the default WordPress body classes.
+ *
* Extends the default WordPress body class to denote:
* 1. Using a full-width layout, when no active widgets in the sidebar
* or full-width template.
@@ -410,7 +434,7 @@ endif;
*
* @since Twenty Twelve 1.0
*
- * @param array Existing class values.
+ * @param array $classes Existing class values.
* @return array Filtered class values.
*/
function twentytwelve_body_class( $classes ) {
@@ -447,10 +471,14 @@ function twentytwelve_body_class( $classes ) {
add_filter( 'body_class', 'twentytwelve_body_class' );
/**
+ * Adjust content width in certain contexts.
+ *
* Adjusts content_width value for full-width and single image attachment
* templates, and when there are no active widgets in the sidebar.
*
* @since Twenty Twelve 1.0
+ *
+ * @return void
*/
function twentytwelve_content_width() {
if ( is_page_template( 'page-templates/full-width.php' ) || is_attachment() || ! is_active_sidebar( 'sidebar-1' ) ) {
@@ -461,11 +489,13 @@ function twentytwelve_content_width() {
add_action( 'template_redirect', 'twentytwelve_content_width' );
/**
- * Add postMessage support for site title and description for the Theme Customizer.
+ * Register postMessage support.
+ *
+ * Add postMessage support for site title and description for the Customizer.
*
* @since Twenty Twelve 1.0
*
- * @param WP_Customize_Manager $wp_customize Theme Customizer object.
+ * @param WP_Customize_Manager $wp_customize Customizer object.
* @return void
*/
function twentytwelve_customize_register( $wp_customize ) {
@@ -476,9 +506,13 @@ function twentytwelve_customize_register( $wp_customize ) {
add_action( 'customize_register', 'twentytwelve_customize_register' );
/**
- * Binds JS handlers to make Theme Customizer preview reload changes asynchronously.
+ * Enqueue Javascript postMessage handlers for the Customizer.
+ *
+ * Binds JS handlers to make the Customizer preview reload changes asynchronously.
*
* @since Twenty Twelve 1.0
+ *
+ * @return void
*/
function twentytwelve_customize_preview_js() {
wp_enqueue_script( 'twentytwelve-customizer', get_template_directory_uri() . '/js/theme-customizer.js', array( 'customize-preview' ), '20130301', true );
diff --git a/header.php b/header.php
index 2d3dfa630..a1deb4edc 100644
--- a/header.php
+++ b/header.php
@@ -1,6 +1,6 @@
section and everything up till
*
diff --git a/image.php b/image.php
index b2fcb428a..44e2f8c03 100644
--- a/image.php
+++ b/image.php
@@ -1,8 +1,8 @@
ID, $attachment_size );
?>
diff --git a/inc/custom-header.php b/inc/custom-header.php
index 595bf98f5..32fea17f7 100644
--- a/inc/custom-header.php
+++ b/inc/custom-header.php
@@ -1,6 +1,7 @@
Header admin panel.
+ * Style the header image displayed on the Appearance > Header admin panel.
*
* @since Twenty Twelve 1.0
*/
@@ -141,7 +142,8 @@ function twentytwelve_admin_header_style() {
}
/**
- * Outputs markup to be displayed on the Appearance > Header admin panel.
+ * Output markup to be displayed on the Appearance > Header admin panel.
+ *
* This callback overrides the default markup displayed there.
*
* @since Twenty Twelve 1.0
diff --git a/index.php b/index.php
index 91201b447..74b574ec1 100644
--- a/index.php
+++ b/index.php
@@ -1,13 +1,13 @@
/* Start the Loop */
while ( have_posts() ) : the_post();
- /* Include the post format-specific template for the content. If you want to
+ /**
+ * Include the post format-specific template for the content. If you want to
* this in a child theme then include a file called called content-___.php
* (where ___ is the post format) and that will be used instead.
*/