diff --git a/functions.php b/functions.php index ce5145e..8d4e604 100644 --- a/functions.php +++ b/functions.php @@ -15,47 +15,39 @@ 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 post thumbnails. + * 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 + /* + * 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 default posts and comments RSS feed links to head. add_theme_support( 'automatic-feed-links' ); - /** - * Enable support for Post Thumbnails on posts and pages + /* + * 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' ); - /** - * This theme uses wp_nav_menu() in one location. - */ + // This theme uses wp_nav_menu() in one location. register_nav_menus( array( 'primary' => __( 'Primary Menu', '_s' ), ) ); - /** - * Enable support for Post Formats - */ + // Enable support for Post Formats. add_theme_support( 'post-formats', array( 'aside', 'image', 'video', 'quote', 'link' ) ); - /** - * Setup the WordPress core custom background feature. - */ + // Setup the WordPress core custom background feature. add_theme_support( 'custom-background', apply_filters( '_s_custom_background_args', array( 'default-color' => 'ffffff', 'default-image' => '', @@ -65,7 +57,7 @@ endif; // _s_setup add_action( 'after_setup_theme', '_s_setup' ); /** - * Register widgetized area and update sidebar with default widgets + * Register widgetized area and update sidebar with default widgets. */ function _s_widgets_init() { register_sidebar( array( @@ -80,7 +72,7 @@ function _s_widgets_init() { add_action( 'widgets_init', '_s_widgets_init' ); /** - * Enqueue scripts and styles + * Enqueue scripts and styles. */ function _s_scripts() { wp_enqueue_style( '_s-style', get_stylesheet_uri() ); @@ -89,13 +81,11 @@ function _s_scripts() { wp_enqueue_script( '_s-skip-link-focus-fix', get_template_directory_uri() . '/js/skip-link-focus-fix.js', array(), '20130115', true ); - if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) { + if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) wp_enqueue_script( 'comment-reply' ); - } - if ( is_singular() && wp_attachment_is_image() ) { + if ( is_singular() && wp_attachment_is_image() ) wp_enqueue_script( '_s-keyboard-image-navigation', get_template_directory_uri() . '/js/keyboard-image-navigation.js', array( 'jquery' ), '20120202' ); - } } add_action( 'wp_enqueue_scripts', '_s_scripts' ); diff --git a/inc/extras.php b/inc/extras.php index 1f0a043..cbcdb08 100644 --- a/inc/extras.php +++ b/inc/extras.php @@ -9,6 +9,9 @@ /** * Get our wp_nav_menu() fallback, wp_page_menu(), to show a home link. + * + * @param array $args Configuration arguments. + * @return array */ function _s_page_menu_args( $args ) { $args['show_home'] = true; @@ -18,19 +21,22 @@ add_filter( 'wp_page_menu_args', '_s_page_menu_args' ); /** * Adds custom classes to the array of body classes. + * + * @param array $classes Classes for the body element. + * @return array */ function _s_body_classes( $classes ) { - // Adds a class of group-blog to blogs with more than 1 published author - if ( is_multi_author() ) { + // Adds a class of group-blog to blogs with more than 1 published author. + if ( is_multi_author() ) $classes[] = 'group-blog'; - } return $classes; } add_filter( 'body_class', '_s_body_classes' ); /** - * Filter in a link to a content ID attribute for the next/previous image links on image attachment pages + * Filter in a link to a content ID attribute for the next/previous image links + * on image attachment pages. */ function _s_enhanced_image_navigation( $url, $id ) { if ( ! is_attachment() && ! wp_attachment_is_image( $id ) ) @@ -46,6 +52,10 @@ add_filter( 'attachment_link', '_s_enhanced_image_navigation', 10, 2 ); /** * Filters wp_title to print a neat