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
  79                 echo $before_widget;
  80                 echo $before_title;
  81                 echo $title; // Can set this with a widget option, or omit altogether
  82                 echo $after_title;
  83
  84                 ?>
  85                 <ol>
  86                 <?php while ( $ephemera->have_posts() ) : $ephemera->the_post(); ?>
  87
  88                         <?php if ( 'link' != get_post_format() ) : ?>
  89
  90                         <li class="widget-entry-title">
  91                                 <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>
  92                                 <span class="comments-link">
  93                                         <?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' ) ); ?>
  94                                 </span>
  95                         </li>
  96
  97                         <?php else : ?>
  98
  99                         <li class="widget-entry-title">
 100                                 <?php
 101                                         // Grab first link from the post content. If none found, use the post permalink as fallback.
 102                                         $link_url = twentyeleven_url_grabber();
 103
 104                                         if ( empty( $link_url ) )
 105                                                 $link_url = get_permalink();
 106                                 ?>
 107                                 <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>
 108                                 <span class="comments-link">
 109                                         <?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' ) ); ?>
 110                                 </span>
 111                         </li>
 112
 113                         <?php endif; ?>
 114
 115                 <?php endwhile; ?>
 116                 </ol>
 117                 <?php
 118
 119                 echo $after_widget;
 120
 121                 // Reset the post globals as this query will have stomped on it
 122                 wp_reset_postdata();
 123
 124                 // end check for ephemeral posts
 125                 endif;
 126
 127                 $cache[$args['widget_id']] = ob_get_flush();
 128                 wp_cache_set( 'widget_twentyeleven_ephemera', $cache, 'widget' );
 129         }
 130
 131         /**
 132          * Deals with the settings when they are saved by the admin. Here is
 133          * where any validation should be dealt with.
 134          **/
 135         function update( $new_instance, $old_instance ) {
 136                 $instance = $old_instance;
 137                 $instance['title'] = strip_tags( $new_instance['title'] );
 138                 $instance['number'] = (int) $new_instance['number'];
 139                 $this->flush_widget_cache();
 140
 141                 $alloptions = wp_cache_get( 'alloptions', 'options' );
 142                 if ( isset( $alloptions['widget_twentyeleven_ephemera'] ) )
 143                         delete_option( 'widget_twentyeleven_ephemera' );
 144
 145                 return $instance;
 146         }
 147
 148         function flush_widget_cache() {
 149                 wp_cache_delete( 'widget_twentyeleven_ephemera', 'widget' );
 150         }
 151
 152         /**
 153          * Displays the form for this widget on the Widgets page of the WP Admin area.
 154          **/
 155         function form( $instance ) {
 156                 $title = isset( $instance['title']) ? esc_attr( $instance['title'] ) : '';
 157                 $number = isset( $instance['number'] ) ? absint( $instance['number'] ) : 10;
 158 ?>
 159                         <p><label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php _e( 'Title:', 'twentyeleven' ); ?></label>
 160                         <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>
 161
 162                         <p><label for="<?php echo esc_attr( $this->get_field_id( 'number' ) ); ?>"><?php _e( 'Number of posts to show:', 'twentyeleven' ); ?></label>
 163                         <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>
 164                 <?php
 165         }
 166 }