Last_Post_Replies_Widget

The bbP last post Last Post Replies Widget class.

Defined (1)

The class is defined in the following location(s).

/includes/lp-widgets.php  
  1. class Last_Post_Replies_Widget extends WP_Widget { 
  2.  
  3.     /** 
  4.      * Last Post Replies Widget  ------  Amends display to show date not freshness 
  5.      * 
  6.      * Registers the replies widget 
  7.      * 
  8.      * @since bbPress (r2653) 
  9.      * 
  10.      * @uses apply_filters() Calls 'bbp_replies_widget_options' with the 
  11.      *                        widget options 
  12.      */ 
  13.     public function __construct() { 
  14.         $widget_ops = apply_filters( 'last_post_replies_widget_options', array( 
  15.             'classname' => 'widget_display_replies',  
  16.             'description' => __( 'A list of the most recent replies.', 'bbp-last-post' ) 
  17.  ) ); 
  18.  
  19.         parent::__construct( false, __( '(Last Post) Recent Replies', 'bbp-last-post' ), $widget_ops ); 
  20.     } 
  21.  
  22.     /** 
  23.      * Register the widget 
  24.      * 
  25.      * @since bbPress (r3389) 
  26.      * 
  27.      * @uses register_widget() 
  28.      */ 
  29.     public static function register_widget() { 
  30.         register_widget( 'Last_Post_Replies_Widget' ); 
  31.     } 
  32.  
  33.     /** 
  34.      * Displays the output, the replies list 
  35.      * 
  36.      * @since bbPress (r2653) 
  37.      * 
  38.      * @param mixed $args 
  39.      * @param array $instance 
  40.      * @uses apply_filters() Calls 'bbp_reply_widget_title' with the title 
  41.      * @uses bbp_get_reply_author_link() To get the reply author link 
  42.      * @uses bbp_get_reply_id() To get the reply id 
  43.      * @uses bbp_get_reply_url() To get the reply url 
  44.      * @uses bbp_get_reply_excerpt() To get the reply excerpt 
  45.      * @uses bbp_get_reply_topic_title() To get the reply topic title 
  46.      * @uses get_the_date() To get the date of the reply 
  47.      * @uses get_the_time() To get the time of the reply 
  48.      */ 
  49.     public function widget( $args, $instance ) { 
  50.  
  51.         // Get widget settings 
  52.         $settings = $this->parse_settings( $instance ); 
  53.  
  54.         // Typical WordPress filter 
  55.         $settings['title'] = apply_filters( 'widget_title', $settings['title'], $instance, $this->id_base ); 
  56.  
  57.         // bbPress filter 
  58.         $settings['title'] = apply_filters( 'bbp_replies_widget_title', $settings['title'], $instance, $this->id_base ); 
  59.  
  60.         // Note: private and hidden forums will be excluded via the 
  61.         // bbp_pre_get_posts_normalize_forum_visibility action and function. 
  62.         $widget_query = new WP_Query( array( 
  63.             'post_type' => bbp_get_reply_post_type(),  
  64.             'post_status' => array( bbp_get_public_status_id(), bbp_get_closed_status_id() ),  
  65.             'posts_per_page' => (int) $settings['max_shown'],  
  66.             'ignore_sticky_posts' => true,  
  67.             'no_found_rows' => true,  
  68.  ) ); 
  69.  
  70.         // Bail if no replies 
  71.         if ( ! $widget_query->have_posts() ) { 
  72.             return; 
  73.         } 
  74.  
  75.         echo $args['before_widget']; 
  76.  
  77.         if ( !empty( $settings['title'] ) ) { 
  78.             echo $args['before_title'] . $settings['title'] . $args['after_title']; 
  79.         } ?> 
  80.  
  81.         <ul> 
  82.  
  83.             <?php while ( $widget_query->have_posts() ) : $widget_query->the_post(); ?> 
  84.  
  85.                 <li> 
  86.  
  87.                     <?php 
  88.  
  89.                     // Verify the reply ID 
  90.                     $reply_id = bbp_get_reply_id( $widget_query->post->ID ); 
  91.                     $reply_link = '<a class="bbp-reply-topic-title" href="' . esc_url( bbp_get_reply_url( $reply_id ) ) . '" title="' . esc_attr( bbp_get_reply_excerpt( $reply_id, 50 ) ) . '">' . bbp_get_reply_topic_title( $reply_id ) . '</a>'; 
  92.  
  93.                     // Only query user if showing them 
  94.                     if ( ! empty( $settings['show_user'] ) ) : 
  95.                         $author_link = bbp_get_reply_author_link( array( 'post_id' => $reply_id, 'type' => 'both', 'size' => 14 ) ); 
  96.                     else : 
  97.                         $author_link = false; 
  98.                     endif; 
  99.  
  100.                     // Reply author, link, and timestamp 
  101.                     if ( ! empty( $settings['show_date'] ) && !empty( $author_link ) ) : 
  102.  
  103.                         // translators: 1: reply author, 2: reply link, 3: reply timestamp 
  104.                         $date_format = get_option( 'date_format' ); 
  105.                         $time_format = get_option( 'time_format' ); 
  106.                         $date= date( "{$date_format}", get_the_time( 'U' ) ); 
  107.                         $time=date( "{$time_format}", get_the_time( 'U' ) ); 
  108.                         $active_time = sprintf( _x( '%1$s at %2$s', 'date at time', 'bbp-last-post' ), $date, $time );   
  109.                         printf( _x( '%1$s on %2$s %3$s', 'widgets', 'bbp-last-post' ), $author_link, $reply_link, '<div>' .  $active_time  . '</div>' ); 
  110.  
  111.                     // Reply link and timestamp 
  112.                     elseif ( ! empty( $settings['show_date'] ) ) : 
  113.  
  114.                         // translators: 1: reply link, 2: reply timestamp 
  115.                         $date_format = get_option( 'date_format' ); 
  116.                         $time_format = get_option( 'time_format' ); 
  117.                         $date= date( "{$date_format}", get_the_time( 'U' ) ); 
  118.                         $time=date( "{$time_format}", get_the_time( 'U' ) ); 
  119.                         $active_time = sprintf( _x( '%1$s at %2$s', 'date at time', 'bbp-last-post' ), $date, $time );   
  120.                         printf( _x( '%1$s %2$s', 'widgets', 'bbp-last-post' ), $reply_link, '<div>' . $active_time  . '</div>' ); 
  121.  
  122.                     // Reply author and title 
  123.                     elseif ( !empty( $author_link ) ) : 
  124.  
  125.                         // translators: 1: reply author, 2: reply link 
  126.                         printf( _x( '%1$s on %2$s', 'widgets', 'bbp-last-post' ), $author_link, $reply_link ); 
  127.  
  128.                     // Only the reply title 
  129.                     else : 
  130.  
  131.                         // translators: 1: reply link 
  132.                         printf( _x( '%1$s', 'widgets', 'bbp-last-post' ), $reply_link ); 
  133.  
  134.                     endif; 
  135.  
  136.                     ?> 
  137.  
  138.                 </li> 
  139.  
  140.             <?php endwhile; ?> 
  141.  
  142.         </ul> 
  143.  
  144.         <?php echo $args['after_widget']; 
  145.  
  146.         // Reset the $post global 
  147.         wp_reset_postdata(); 
  148.     } 
  149.  
  150.     /** 
  151.      * Update the reply widget options 
  152.      * 
  153.      * @since bbPress (r2653) 
  154.      * 
  155.      * @param array $new_instance The new instance options 
  156.      * @param array $old_instance The old instance options 
  157.      */ 
  158.     public function update( $new_instance = array(), $old_instance = array() ) { 
  159.         $instance = $old_instance; 
  160.         $instance['title'] = strip_tags( $new_instance['title'] ); 
  161.         $instance['show_date'] = (bool) $new_instance['show_date']; 
  162.         $instance['show_user'] = (bool) $new_instance['show_user']; 
  163.         $instance['max_shown'] = (int) $new_instance['max_shown']; 
  164.  
  165.         return $instance; 
  166.     } 
  167.  
  168.     /** 
  169.      * Output the reply widget options form 
  170.      * 
  171.      * @since bbPress (r2653) 
  172.      * 
  173.      * @param $instance Instance 
  174.      * @uses BBP_Replies_Widget::get_field_id() To output the field id 
  175.      * @uses BBP_Replies_Widget::get_field_name() To output the field name 
  176.      */ 
  177.     public function form( $instance = array() ) { 
  178.  
  179.         // Get widget settings 
  180.         $settings = $this->parse_settings( $instance ); ?> 
  181.  
  182.         <p><label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( 'Title:', 'bbp-last-post' ); ?> <input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo esc_attr( $settings['title'] ); ?>" /></label></p> 
  183.         <p><label for="<?php echo $this->get_field_id( 'max_shown' ); ?>"><?php _e( 'Maximum replies to show:', 'bbp-last-post' ); ?> <input class="widefat" id="<?php echo $this->get_field_id( 'max_shown' ); ?>" name="<?php echo $this->get_field_name( 'max_shown' ); ?>" type="text" value="<?php echo esc_attr( $settings['max_shown'] ); ?>" /></label></p> 
  184.         <p><label for="<?php echo $this->get_field_id( 'show_date' ); ?>"><?php _e( 'Show post date:', 'bbp-last-post' ); ?> <input type="checkbox" id="<?php echo $this->get_field_id( 'show_date' ); ?>" name="<?php echo $this->get_field_name( 'show_date' ); ?>" <?php checked( true, $settings['show_date'] ); ?> value="1" /></label></p> 
  185.         <p><label for="<?php echo $this->get_field_id( 'show_user' ); ?>"><?php _e( 'Show reply author:', 'bbp-last-post' ); ?> <input type="checkbox" id="<?php echo $this->get_field_id( 'show_user' ); ?>" name="<?php echo $this->get_field_name( 'show_user' ); ?>" <?php checked( true, $settings['show_user'] ); ?> value="1" /></label></p> 
  186.  
  187.         <?php 
  188.     } 
  189.  
  190.     /** 
  191.      * Merge the widget settings into defaults array. 
  192.      * 
  193.      * @since bbPress (r4802) 
  194.      * 
  195.      * @param $instance Instance 
  196.      * @uses bbp_parse_args() To merge widget settings into defaults 
  197.      */ 
  198.     public function parse_settings( $instance = array() ) { 
  199.         return bbp_parse_args( $instance, array( 
  200.             'title' => __( 'Recent Replies', 'bbp-last-post' ),  
  201.             'max_shown' => 5,  
  202.             'show_date' => false,  
  203.             'show_user' => false 
  204.  ),  
  205.         'replies_widget_settings' ); 
  206.     } 
  207. }