wp-content/themes/twentyfourteen/inc/template-tags.php

   1 <?php
   2 /**
   3  * Custom template tags for Twenty Fourteen
   4  *
   5  * @package WordPress
   6  * @subpackage Twenty_Fourteen
   7  * @since Twenty Fourteen 1.0
   8  */
   9
  10 if ( ! function_exists( 'twentyfourteen_paging_nav' ) ) :
  11 /**
  12  * Display navigation to next/previous set of posts when applicable.
  13  *
  14  * @since Twenty Fourteen 1.0
  15  */
  16 function twentyfourteen_paging_nav() {
  17         // Don't print empty markup if there's only one page.
  18         if ( $GLOBALS['wp_query']->max_num_pages < 2 ) {
  19                 return;
  20         }
  21
  22         $paged        = get_query_var( 'paged' ) ? intval( get_query_var( 'paged' ) ) : 1;
  23         $pagenum_link = html_entity_decode( get_pagenum_link() );
  24         $query_args   = array();
  25         $url_parts    = explode( '?', $pagenum_link );
  26
  27         if ( isset( $url_parts[1] ) ) {
  28                 wp_parse_str( $url_parts[1], $query_args );
  29         }
  30
  31         $pagenum_link = remove_query_arg( array_keys( $query_args ), $pagenum_link );
  32         $pagenum_link = trailingslashit( $pagenum_link ) . '%_%';
  33
  34         $format  = $GLOBALS['wp_rewrite']->using_index_permalinks() && ! strpos( $pagenum_link, 'index.php' ) ? 'index.php/' : '';
  35         $format .= $GLOBALS['wp_rewrite']->using_permalinks() ? user_trailingslashit( 'page/%#%', 'paged' ) : '?paged=%#%';
  36
  37         // Set up paginated links.
  38         $links = paginate_links( array(
  39                 'base'     => $pagenum_link,
  40                 'format'   => $format,
  41                 'total'    => $GLOBALS['wp_query']->max_num_pages,
  42                 'current'  => $paged,
  43                 'mid_size' => 1,
  44                 'add_args' => array_map( 'urlencode', $query_args ),
  45                 'prev_text' => __( '&larr; Previous', 'twentyfourteen' ),
  46                 'next_text' => __( 'Next &rarr;', 'twentyfourteen' ),
  47         ) );
  48
  49         if ( $links ) :
  50
  51         ?>
  52         <nav class="navigation paging-navigation" role="navigation">
  53                 <h1 class="screen-reader-text"><?php _e( 'Posts navigation', 'twentyfourteen' ); ?></h1>
  54                 <div class="pagination loop-pagination">
  55                         <?php echo $links; ?>
  56                 </div><!-- .pagination -->
  57         </nav><!-- .navigation -->
  58         <?php
  59         endif;
  60 }
  61 endif;
  62
  63 if ( ! function_exists( 'twentyfourteen_post_nav' ) ) :
  64 /**
  65  * Display navigation to next/previous post when applicable.
  66  *
  67  * @since Twenty Fourteen 1.0
  68  */
  69 function twentyfourteen_post_nav() {
  70         // Don't print empty markup if there's nowhere to navigate.
  71         $previous = ( is_attachment() ) ? get_post( get_post()->post_parent ) : get_adjacent_post( false, '', true );
  72         $next     = get_adjacent_post( false, '', false );
  73
  74         if ( ! $next && ! $previous ) {
  75                 return;
  76         }
  77
  78         ?>
  79         <nav class="navigation post-navigation" role="navigation">
  80                 <h1 class="screen-reader-text"><?php _e( 'Post navigation', 'twentyfourteen' ); ?></h1>
  81                 <div class="nav-links">
  82                         <?php
  83                         if ( is_attachment() ) :
  84                                 previous_post_link( '%link', __( '<span class="meta-nav">Published In</span>%title', 'twentyfourteen' ) );
  85                         else :
  86                                 previous_post_link( '%link', __( '<span class="meta-nav">Previous Post</span>%title', 'twentyfourteen' ) );
  87                                 next_post_link( '%link', __( '<span class="meta-nav">Next Post</span>%title', 'twentyfourteen' ) );
  88                         endif;
  89                         ?>
  90                 </div><!-- .nav-links -->
  91         </nav><!-- .navigation -->
  92         <?php
  93 }
  94 endif;
  95
  96 if ( ! function_exists( 'twentyfourteen_posted_on' ) ) :
  97 /**
  98  * Print HTML with meta information for the current post-date/time and author.
  99  *
 100  * @since Twenty Fourteen 1.0
 101  */
 102 function twentyfourteen_posted_on() {
 103         if ( is_sticky() && is_home() && ! is_paged() ) {
 104                 echo '<span class="featured-post">' . __( 'Sticky', 'twentyfourteen' ) . '</span>';
 105         }
 106
 107         // Set up and print post meta information.
 108         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>',
 109                 esc_url( get_permalink() ),
 110                 esc_attr( get_the_date( 'c' ) ),
 111                 esc_html( get_the_date() ),
 112                 esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) ),
 113                 get_the_author()
 114         );
 115 }
 116 endif;
 117
 118 /**
 119  * Find out if blog has more than one category.
 120  *
 121  * @since Twenty Fourteen 1.0
 122  *
 123  * @return boolean true if blog has more than 1 category
 124  */
 125 function twentyfourteen_categorized_blog() {
 126         if ( false === ( $all_the_cool_cats = get_transient( 'twentyfourteen_category_count' ) ) ) {
 127                 // Create an array of all the categories that are attached to posts
 128                 $all_the_cool_cats = get_categories( array(
 129                         'hide_empty' => 1,
 130                 ) );
 131
 132                 // Count the number of categories that are attached to the posts
 133                 $all_the_cool_cats = count( $all_the_cool_cats );
 134
 135                 set_transient( 'twentyfourteen_category_count', $all_the_cool_cats );
 136         }
 137
 138         if ( 1 !== (int) $all_the_cool_cats ) {
 139                 // This blog has more than 1 category so twentyfourteen_categorized_blog should return true
 140                 return true;
 141         } else {
 142                 // This blog has only 1 category so twentyfourteen_categorized_blog should return false
 143                 return false;
 144         }
 145 }
 146
 147 /**
 148  * Flush out the transients used in twentyfourteen_categorized_blog.
 149  *
 150  * @since Twenty Fourteen 1.0
 151  */
 152 function twentyfourteen_category_transient_flusher() {
 153         // Like, beat it. Dig?
 154         delete_transient( 'twentyfourteen_category_count' );
 155 }
 156 add_action( 'edit_category', 'twentyfourteen_category_transient_flusher' );
 157 add_action( 'save_post',     'twentyfourteen_category_transient_flusher' );
 158
 159 /**
 160  * Display an optional post thumbnail.
 161  *
 162  * Wraps the post thumbnail in an anchor element on index
 163  * views, or a div element when on single views.
 164  *
 165  * @since Twenty Fourteen 1.0
 166  */
 167 function twentyfourteen_post_thumbnail() {
 168         if ( post_password_required() || is_attachment() || ! has_post_thumbnail() ) {
 169                 return;
 170         }
 171
 172         if ( is_singular() ) :
 173         ?>
 174
 175         <div class="post-thumbnail">
 176         <?php
 177                 if ( ( ! is_active_sidebar( 'sidebar-2' ) || is_page_template( 'page-templates/full-width.php' ) ) ) {
 178                         the_post_thumbnail( 'twentyfourteen-full-width' );
 179                 } else {
 180                         the_post_thumbnail();
 181                 }
 182         ?>
 183         </div>
 184
 185         <?php else : ?>
 186
 187         <a class="post-thumbnail" href="<?php the_permalink(); ?>">
 188         <?php
 189                 if ( ( ! is_active_sidebar( 'sidebar-2' ) || is_page_template( 'page-templates/full-width.php' ) ) ) {
 190                         the_post_thumbnail( 'twentyfourteen-full-width' );
 191                 } else {
 192                         the_post_thumbnail();
 193                 }
 194         ?>
 195         </a>
 196
 197         <?php endif; // End is_singular()
 198 }