wp-content/themes/twentyeleven/inc/widgets.php

   1 <?php
   2 /**
   3  * Makes a custom Widget for displaying Aside, Link, Status, and Quote Posts available with Twenty Eleven
   4  *
   5  * Learn more: http://codex.wordpress.org/Widgets_API#Developing_Widgets
   6  *
   7  * @package WordPress
   8  * @subpackage Twenty_Eleven
   9  * @since Twenty Eleven 1.0
  10  */
  11 class Twenty_Eleven_Ephemera_Widget extends WP_Widget {
  12
  13         /**
  14          * Constructor
  15          *
  16          * @return void
  17          **/
  18         function Twenty_Eleven_Ephemera_Widget() {
  19                 $widget_ops = array( 'classname' => 'widget_twentyeleven_ephemera', 'description' => __( 'Use this widget to list your recent Aside, Status, Quote, and Link posts', 'twentyeleven' ) );
  20                 $this->WP_Widget( 'widget_twentyeleven_ephemera', __( 'Twenty Eleven Ephemera', 'twentyeleven' ), $widget_ops );
  21                 $this->alt_option_name = 'widget_twentyeleven_ephemera';
  22
  23                 add_action( 'save_post', array(&$this, 'flush_widget_cache' ) );
  24                 add_action( 'deleted_post', array(&$this, 'flush_widget_cache' ) );
  25                 add_action( 'switch_theme', array(&$this, 'flush_widget_cache' ) );
  26         }
  27
  28         /**
  29          * Outputs the HTML for this widget.
  30          *
  31          * @param array An array of standard parameters for widgets in this theme
  32          * @param array An array of settings for this widget instance
  33          * @return void Echoes it's output
  34          **/
  35         function widget( $args, $instance ) {
  36                 $cache = wp_cache_get( 'widget_twentyeleven_ephemera', 'widget' );
  37
  38                 if ( !is_array( $cache ) )
  39                         $cache = array();
  40
  41                 if ( ! isset( $args['widget_id'] ) )
  42                         $args['widget_id'] = null;
  43
  44                 if ( isset( $cache[$args['widget_id']] ) ) {
  45                         echo $cache[$args['widget_id']];
  46                         return;
  47                 }
  48
  49                 ob_start();
  50                 extract( $args, EXTR_SKIP );
  51
  52                 $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? __( 'Ephemera', 'twentyeleven' ) : $instance['title'], $instance, $this->id_base);
  53
  54                 if ( ! isset( $instance['number'] ) )
  55                         $instance['number'] = '10';
  56
  57                 if ( ! $number = absint( $instance['number'] ) )
  58                         $number = 10;
  59
  60                 $ephemera_args = array(
  61                         'order' => 'DESC',
  62                         'posts_per_page' => $number,
  63                         'no_found_rows' => true,
  64                         'post_status' => 'publish',
  65                         'post__not_in' => get_option( 'sticky_posts' ),
  66                         'tax_query' => array(
  67                                 array(
  68                                         'taxonomy' => 'post_format',
  69                                         'terms' => array( 'post-format-aside', 'post-format-link', 'post-format-status', 'post-format-quote' ),
  70                                         'field' => 'slug',
  71                                         'operator' => 'IN',
  72                                 ),
  73                         ),
  74                 );
  75                 $ephemera = new WP_Query( $ephemera_args );
  76
  77                 if ( $ephemera->have_posts() ) :
  78                         echo $before_widget;
  79                         echo $before_title;
  80                         echo $title; // Can set this with a widget option, or omit altogether
  81                         echo $after_title;
  82                         ?>
  83                         <ol>
  84                         <?php while ( $ephemera->have_posts() ) : $ephemera->the_post(); ?>
  85
  86                                 <?php if ( 'link' != get_post_format() ) : ?>
  87
  88                                 <li class="widget-entry-title">
  89                                         <a href="<?php echo esc_url( get_permalink() ); ?>" title="<?php printf( esc_attr__( 'Permalink to %s', 'twentyeleven' ), the_title_attribute( 'echo=0' ) ); ?>" rel="bookmark"><?php the_title(); ?></a>
  90                                         <span class="comments-link">
  91                                                 <?php comments_popup_link( __( '0 <span class="reply">comments &rarr;</span>', 'twentyeleven' ), __( '1 <span class="reply">comment &rarr;</span>', 'twentyeleven' ), __( '% <span class="reply">comments &rarr;</span>', 'twentyeleven' ) ); ?>
  92                                         </span>
  93                                 </li>
  94
  95                                 <?php else : ?>
  96
  97                                 <li class="widget-entry-title">
  98                                         <?php
  99                                                 // Grab first link from the post content. If none found, use the post permalink as fallback.
 100                                                 $link_url = twentyeleven_url_grabber();
 101
 102                                                 if ( empty( $link_url ) )
 103                                                         $link_url = get_permalink();
 104                                         ?>
 105                                         <a href="<?php echo esc_url( $link_url ); ?>" title="<?php printf( esc_attr__( 'Link to %s', 'twentyeleven' ), the_title_attribute( 'echo=0' ) ); ?>" rel="bookmark"><?php the_title(); ?>&nbsp;<span>&rarr;</span></a>
 106                                         <span class="comments-link">
 107                                                 <?php comments_popup_link( __( '0 <span class="reply">comments &rarr;</span>', 'twentyeleven' ), __( '1 <span class="reply">comment &rarr;</span>', 'twentyeleven' ), __( '% <span class="reply">comments &rarr;</span>', 'twentyeleven' ) ); ?>
 108                                         </span>
 109                                 </li>
 110
 111                                 <?php endif; ?>
 112
 113                         <?php endwhile; ?>
 114                         </ol>
 115                         <?php
 116
 117                         echo $after_widget;
 118
 119                         // Reset the post globals as this query will have stomped on it
 120                         wp_reset_postdata();
 121
 122                 // end check for ephemeral posts
 123                 endif;
 124
 125                 $cache[$args['widget_id']] = ob_get_flush();
 126                 wp_cache_set( 'widget_twentyeleven_ephemera', $cache, 'widget' );
 127         }
 128
 129         /**
 130          * Deals with the settings when they are saved by the admin. Here is
 131          * where any validation should be dealt with.
 132          **/
 133         function update( $new_instance, $old_instance ) {
 134                 $instance = $old_instance;
 135                 $instance['title'] = strip_tags( $new_instance['title'] );
 136                 $instance['number'] = (int) $new_instance['number'];
 137                 $this->flush_widget_cache();
 138
 139                 $alloptions = wp_cache_get( 'alloptions', 'options' );
 140                 if ( isset( $alloptions['widget_twentyeleven_ephemera'] ) )
 141                         delete_option( 'widget_twentyeleven_ephemera' );
 142
 143                 return $instance;
 144         }
 145
 146         function flush_widget_cache() {
 147                 wp_cache_delete( 'widget_twentyeleven_ephemera', 'widget' );
 148         }
 149
 150         /**
 151          * Displays the form for this widget on the Widgets page of the WP Admin area.
 152          **/
 153         function form( $instance ) {
 154                 $title = isset( $instance['title']) ? esc_attr( $instance['title'] ) : '';
 155                 $number = isset( $instance['number'] ) ? absint( $instance['number'] ) : 10;
 156 ?>
 157                         <p><label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php _e( 'Title:', 'twentyeleven' ); ?></label>
 158                         <input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'title' ) ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" /></p>
 159
 160                         <p><label for="<?php echo esc_attr( $this->get_field_id( 'number' ) ); ?>"><?php _e( 'Number of posts to show:', 'twentyeleven' ); ?></label>
 161                         <input id="<?php echo esc_attr( $this->get_field_id( 'number' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'number' ) ); ?>" type="text" value="<?php echo esc_attr( $number ); ?>" size="3" /></p>
 162                 <?php
 163         }
 164 }