BBP_Replies_Widget::widget( array $args, array $instance )
Displays the output, the replies list
Description Description
Parameters Parameters
- $args
-
(Required)
- $instance
-
(Required)
Source Source
File: includes/common/widgets.php
public function widget( $args, $instance ) { // Get widget settings $settings = $this->parse_settings( $instance ); // Typical WordPress filter $settings['title'] = apply_filters( 'widget_title', $settings['title'], $instance, $this->id_base ); // bbPress filter $settings['title'] = apply_filters( 'bbp_replies_widget_title', $settings['title'], $instance, $this->id_base ); // Note: private and hidden forums will be excluded via the // bbp_pre_get_posts_normalize_forum_visibility action and function. $widget_query = new WP_Query( array( // What and when 'post_type' => bbp_get_reply_post_type(), 'post_status' => bbp_get_public_reply_statuses(), 'posts_per_page' => (int) $settings['max_shown'], // Performance 'ignore_sticky_posts' => true, 'no_found_rows' => true, 'update_post_term_cache' => false, 'update_post_meta_cache' => false ) ); // Bail if no replies if ( ! $widget_query->have_posts() ) { return; } // Start an output buffer ob_start(); echo $args['before_widget']; if ( ! empty( $settings['title'] ) ) { echo $args['before_title'] . $settings['title'] . $args['after_title']; } ?> <ul class="bbp-replies-widget"> <?php while ( $widget_query->have_posts() ) : $widget_query->the_post(); ?> <li> <?php // Verify the reply ID $reply_id = bbp_get_reply_id( $widget_query->post->ID ); $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 ) ) . '">' . esc_html( bbp_get_reply_topic_title( $reply_id ) ) . '</a>'; $time = get_the_time( 'U', $reply_id ); $show_date = '<time datetime="' . gmdate( 'Y-m-d H:i:s', $time ) . '">' . esc_html( bbp_get_time_since( $time ) ) . '</time>'; // Only query user if showing them if ( ! empty( $settings['show_user'] ) ) : $author_link = bbp_get_reply_author_link( array( 'post_id' => $reply_id, 'type' => 'both', 'size' => 14 ) ); else : $author_link = false; endif; // Reply author, link, and timestamp if ( ! empty( $settings['show_date'] ) && ! empty( $author_link ) ) : // translators: 1: reply author, 2: reply link, 3: reply timestamp printf( esc_html_x( '%1$s on %2$s %3$s', 'widgets', 'bbpress' ), $author_link, $reply_link, $show_date ); // Reply link and timestamp elseif ( ! empty( $settings['show_date'] ) ) : echo $reply_link . ' ' . $show_date; // Reply author and title elseif ( ! empty( $author_link ) ) : // translators: 1: reply author, 2: reply link printf( esc_html_x( '%1$s on %2$s', 'widgets', 'bbpress' ), $author_link, $reply_link ); // Only the reply title else : echo $reply_link; endif; ?> </li> <?php endwhile; ?> </ul> <?php echo $args['after_widget']; // Reset the $post global wp_reset_postdata(); // Output the current buffer echo ob_get_clean(); }
Changelog Changelog
Version | Description |
---|---|
2.0.0 | Introduced. |