function widget( $args, $instance ) {
extract( $args );
- $title = apply_filters('widget_title', empty( $instance['title'] ) ? __( 'Pages' ) : $instance['title'], $instance, $this->id_base);
+ /**
+ * Filter the widget title.
+ *
+ * @since 2.6.0
+ *
+ * @param string $title The widget title. Default 'Pages'.
+ * @param array $instance An array of the widget's settings.
+ * @param mixed $id_base The widget ID.
+ */
+ $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? __( 'Pages' ) : $instance['title'], $instance, $this->id_base );
+
$sortby = empty( $instance['sortby'] ) ? 'menu_order' : $instance['sortby'];
$exclude = empty( $instance['exclude'] ) ? '' : $instance['exclude'];
if ( $sortby == 'menu_order' )
$sortby = 'menu_order, post_title';
- $out = wp_list_pages( apply_filters('widget_pages_args', array('title_li' => '', 'echo' => 0, 'sort_column' => $sortby, 'exclude' => $exclude) ) );
+ /**
+ * Filter the arguments for the Pages widget.
+ *
+ * @since 2.8.0
+ *
+ * @see wp_list_pages()
+ *
+ * @param array $args An array of arguments to retrieve the pages list.
+ */
+ $out = wp_list_pages( apply_filters( 'widget_pages_args', array(
+ 'title_li' => '',
+ 'echo' => 0,
+ 'sort_column' => $sortby,
+ 'exclude' => $exclude
+ ) ) );
if ( !empty( $out ) ) {
echo $before_widget;
$limit = isset( $instance['limit'] ) ? $instance['limit'] : -1;
$before_widget = preg_replace('/id="[^"]*"/','id="%id"', $before_widget);
- wp_list_bookmarks(apply_filters('widget_links_args', array(
+
+ /**
+ * Filter the arguments for the Links widget.
+ *
+ * @since 2.6.0
+ *
+ * @see wp_list_bookmarks()
+ *
+ * @param array $args An array of arguments to retrieve the links list.
+ */
+ wp_list_bookmarks( apply_filters( 'widget_links_args', array(
'title_before' => $before_title, 'title_after' => $after_title,
'category_before' => $before_widget, 'category_after' => $after_widget,
'show_images' => $show_images, 'show_description' => $show_description,
'category' => $category, 'class' => 'linkcat widget',
'orderby' => $orderby, 'order' => $order,
'limit' => $limit,
- )));
+ ) ) );
}
function update( $new_instance, $old_instance ) {
function __construct() {
$widget_ops = array('classname' => 'widget_search', 'description' => __( "A search form for your site.") );
- parent::__construct('search', __('Search'), $widget_ops);
+ parent::__construct( 'search', _x( 'Search', 'Search widget' ), $widget_ops );
}
function widget( $args, $instance ) {
extract($args);
+
+ /** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
echo $before_widget;
extract($args);
$c = ! empty( $instance['count'] ) ? '1' : '0';
$d = ! empty( $instance['dropdown'] ) ? '1' : '0';
- $title = apply_filters('widget_title', empty($instance['title']) ? __('Archives') : $instance['title'], $instance, $this->id_base);
+
+ /** This filter is documented in wp-includes/default-widgets.php */
+ $title = apply_filters( 'widget_title', empty($instance['title'] ) ? __( 'Archives' ) : $instance['title'], $instance, $this->id_base );
echo $before_widget;
if ( $title )
if ( $d ) {
?>
- <select name="archive-dropdown" onchange='document.location.href=this.options[this.selectedIndex].value;'> <option value=""><?php echo esc_attr(__('Select Month')); ?></option> <?php wp_get_archives(apply_filters('widget_archives_dropdown_args', array('type' => 'monthly', 'format' => 'option', 'show_post_count' => $c))); ?> </select>
+ <select name="archive-dropdown" onchange='document.location.href=this.options[this.selectedIndex].value;'>
+ <option value=""><?php echo esc_attr( __( 'Select Month' ) ); ?></option>
+
+ <?php
+ /**
+ * Filter the arguments for the Archives widget drop-down.
+ *
+ * @since 2.8.0
+ *
+ * @see wp_get_archives()
+ *
+ * @param array $args An array of Archives widget drop-down arguments.
+ */
+ wp_get_archives( apply_filters( 'widget_archives_dropdown_args', array(
+ 'type' => 'monthly',
+ 'format' => 'option',
+ 'show_post_count' => $c
+ ) ) );
+?>
+ </select>
<?php
} else {
?>
<ul>
- <?php wp_get_archives(apply_filters('widget_archives_args', array('type' => 'monthly', 'show_post_count' => $c))); ?>
+<?php
+ /**
+ * Filter the arguments for the Archives widget.
+ *
+ * @since 2.8.0
+ *
+ * @see wp_get_archives()
+ *
+ * @param array $args An array of Archives option arguments.
+ */
+ wp_get_archives( apply_filters( 'widget_archives_args', array(
+ 'type' => 'monthly',
+ 'show_post_count' => $c
+ ) ) );
+?>
</ul>
<?php
}
function widget( $args, $instance ) {
extract($args);
- $title = apply_filters('widget_title', empty($instance['title']) ? __('Meta') : $instance['title'], $instance, $this->id_base);
+
+ /** This filter is documented in wp-includes/default-widgets.php */
+ $title = apply_filters( 'widget_title', empty($instance['title']) ? __( 'Meta' ) : $instance['title'], $instance, $this->id_base );
echo $before_widget;
if ( $title )
<li><?php wp_loginout(); ?></li>
<li><a href="<?php bloginfo('rss2_url'); ?>" title="<?php echo esc_attr(__('Syndicate this site using RSS 2.0')); ?>"><?php _e('Entries <abbr title="Really Simple Syndication">RSS</abbr>'); ?></a></li>
<li><a href="<?php bloginfo('comments_rss2_url'); ?>" title="<?php echo esc_attr(__('The latest comments to all posts in RSS')); ?>"><?php _e('Comments <abbr title="Really Simple Syndication">RSS</abbr>'); ?></a></li>
- <?php echo apply_filters( 'widget_meta_poweredby', sprintf( '<li><a href="%s" title="%s">%s</a></li>',
- esc_url( __( 'http://wordpress.org/' ) ),
+<?php
+ /**
+ * Filter the "Powered by WordPress" text in the Meta widget.
+ *
+ * @since 3.6.0
+ *
+ * @param string $title_text Default title text for the WordPress.org link.
+ */
+ echo apply_filters( 'widget_meta_poweredby', sprintf( '<li><a href="%s" title="%s">%s</a></li>',
+ esc_url( __( 'https://wordpress.org/' ) ),
esc_attr__( 'Powered by WordPress, state-of-the-art semantic personal publishing platform.' ),
_x( 'WordPress.org', 'meta widget link text' )
- ) ); ?>
- <?php wp_meta(); ?>
+ ) );
+
+ wp_meta();
+?>
</ul>
<?php
echo $after_widget;
function widget( $args, $instance ) {
extract($args);
- $title = apply_filters('widget_title', empty($instance['title']) ? '' : $instance['title'], $instance, $this->id_base);
+
+ /** This filter is documented in wp-includes/default-widgets.php */
+ $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
+
echo $before_widget;
if ( $title )
echo $before_title . $title . $after_title;
function widget( $args, $instance ) {
extract($args);
+
+ /** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
+
+ /**
+ * Filter the content of the Text widget.
+ *
+ * @since 2.3.0
+ *
+ * @param string $widget_text The widget content.
+ * @param WP_Widget $instance WP_Widget instance.
+ */
$text = apply_filters( 'widget_text', empty( $instance['text'] ) ? '' : $instance['text'], $instance );
echo $before_widget;
if ( !empty( $title ) ) { echo $before_title . $title . $after_title; } ?>
function widget( $args, $instance ) {
extract( $args );
- $title = apply_filters('widget_title', empty( $instance['title'] ) ? __( 'Categories' ) : $instance['title'], $instance, $this->id_base);
+ /** This filter is documented in wp-includes/default-widgets.php */
+ $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? __( 'Categories' ) : $instance['title'], $instance, $this->id_base );
+
$c = ! empty( $instance['count'] ) ? '1' : '0';
$h = ! empty( $instance['hierarchical'] ) ? '1' : '0';
$d = ! empty( $instance['dropdown'] ) ? '1' : '0';
if ( $d ) {
$cat_args['show_option_none'] = __('Select Category');
- wp_dropdown_categories(apply_filters('widget_categories_dropdown_args', $cat_args));
+
+ /**
+ * Filter the arguments for the Categories widget drop-down.
+ *
+ * @since 2.8.0
+ *
+ * @see wp_dropdown_categories()
+ *
+ * @param array $cat_args An array of Categories widget drop-down arguments.
+ */
+ wp_dropdown_categories( apply_filters( 'widget_categories_dropdown_args', $cat_args ) );
?>
<script type='text/javascript'>
<ul>
<?php
$cat_args['title_li'] = '';
- wp_list_categories(apply_filters('widget_categories_args', $cat_args));
+
+ /**
+ * Filter the arguments for the Categories widget.
+ *
+ * @since 2.8.0
+ *
+ * @param array $cat_args An array of Categories widget options.
+ */
+ wp_list_categories( apply_filters( 'widget_categories_args', $cat_args ) );
?>
</ul>
<?php
}
function widget($args, $instance) {
- $cache = wp_cache_get('widget_recent_posts', 'widget');
+ $cache = array();
+ if ( ! $this->is_preview() ) {
+ $cache = wp_cache_get( 'widget_recent_posts', 'widget' );
+ }
- if ( !is_array($cache) )
+ if ( ! is_array( $cache ) ) {
$cache = array();
+ }
- if ( ! isset( $args['widget_id'] ) )
+ if ( ! isset( $args['widget_id'] ) ) {
$args['widget_id'] = $this->id;
+ }
if ( isset( $cache[ $args['widget_id'] ] ) ) {
echo $cache[ $args['widget_id'] ];
extract($args);
$title = ( ! empty( $instance['title'] ) ) ? $instance['title'] : __( 'Recent Posts' );
+
+ /** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
- $number = ( ! empty( $instance['number'] ) ) ? absint( $instance['number'] ) : 10;
+
+ $number = ( ! empty( $instance['number'] ) ) ? absint( $instance['number'] ) : 5;
if ( ! $number )
- $number = 10;
+ $number = 5;
$show_date = isset( $instance['show_date'] ) ? $instance['show_date'] : false;
- $r = new WP_Query( apply_filters( 'widget_posts_args', array( 'posts_per_page' => $number, 'no_found_rows' => true, 'post_status' => 'publish', 'ignore_sticky_posts' => true ) ) );
+ /**
+ * Filter the arguments for the Recent Posts widget.
+ *
+ * @since 3.4.0
+ *
+ * @see WP_Query::get_posts()
+ *
+ * @param array $args An array of arguments used to retrieve the recent posts.
+ */
+ $r = new WP_Query( apply_filters( 'widget_posts_args', array(
+ 'posts_per_page' => $number,
+ 'no_found_rows' => true,
+ 'post_status' => 'publish',
+ 'ignore_sticky_posts' => true
+ ) ) );
+
if ($r->have_posts()) :
?>
<?php echo $before_widget; ?>
endif;
- $cache[$args['widget_id']] = ob_get_flush();
- wp_cache_set('widget_recent_posts', $cache, 'widget');
+ if ( ! $this->is_preview() ) {
+ $cache[ $args['widget_id'] ] = ob_get_flush();
+ wp_cache_set( 'widget_recent_posts', $cache, 'widget' );
+ } else {
+ ob_flush();
+ }
}
function update( $new_instance, $old_instance ) {
}
function recent_comments_style() {
+
+ /**
+ * Filter the Recent Comments default widget styles.
+ *
+ * @since 3.1.0
+ *
+ * @param bool $active Whether the widget is active. Default true.
+ * @param string $id_base The widget ID.
+ */
if ( ! current_theme_supports( 'widgets' ) // Temp hack #14876
|| ! apply_filters( 'show_recent_comments_widget_style', true, $this->id_base ) )
return;
function widget( $args, $instance ) {
global $comments, $comment;
- $cache = wp_cache_get('widget_recent_comments', 'widget');
-
- if ( ! is_array( $cache ) )
+ $cache = array();
+ if ( ! $this->is_preview() ) {
+ $cache = wp_cache_get('widget_recent_comments', 'widget');
+ }
+ if ( ! is_array( $cache ) ) {
$cache = array();
+ }
if ( ! isset( $args['widget_id'] ) )
$args['widget_id'] = $this->id;
return;
}
- extract($args, EXTR_SKIP);
- $output = '';
+ extract($args, EXTR_SKIP);
+ $output = '';
$title = ( ! empty( $instance['title'] ) ) ? $instance['title'] : __( 'Recent Comments' );
+
+ /** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
+
$number = ( ! empty( $instance['number'] ) ) ? absint( $instance['number'] ) : 5;
if ( ! $number )
- $number = 5;
+ $number = 5;
+
+ /**
+ * Filter the arguments for the Recent Comments widget.
+ *
+ * @since 3.4.0
+ *
+ * @see get_comments()
+ *
+ * @param array $comment_args An array of arguments used to retrieve the recent comments.
+ */
+ $comments = get_comments( apply_filters( 'widget_comments_args', array(
+ 'number' => $number,
+ 'status' => 'approve',
+ 'post_status' => 'publish'
+ ) ) );
- $comments = get_comments( apply_filters( 'widget_comments_args', array( 'number' => $number, 'status' => 'approve', 'post_status' => 'publish' ) ) );
$output .= $before_widget;
if ( $title )
$output .= $before_title . $title . $after_title;
foreach ( (array) $comments as $comment) {
$output .= '<li class="recentcomments">' . /* translators: comments widget: 1: comment author, 2: post link */ sprintf(_x('%1$s on %2$s', 'widgets'), get_comment_author_link(), '<a href="' . esc_url( get_comment_link($comment->comment_ID) ) . '">' . get_the_title($comment->comment_post_ID) . '</a>') . '</li>';
}
- }
+ }
$output .= '</ul>';
$output .= $after_widget;
echo $output;
- $cache[$args['widget_id']] = $output;
- wp_cache_set('widget_recent_comments', $cache, 'widget');
+
+ if ( ! $this->is_preview() ) {
+ $cache[ $args['widget_id'] ] = $output;
+ wp_cache_set( 'widget_recent_comments', $cache, 'widget' );
+ }
}
function update( $new_instance, $old_instance ) {
if ( empty($title) )
$title = empty($desc) ? __('Unknown Feed') : $desc;
- $title = apply_filters('widget_title', $title, $instance, $this->id_base);
+ /** This filter is documented in wp-includes/default-widgets.php */
+ $title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
+
$url = esc_url(strip_tags($url));
$icon = includes_url('images/rss.png');
if ( $title )
if ( empty($title) )
$title = __('Untitled');
- $desc = str_replace( array("\n", "\r"), ' ', esc_attr( strip_tags( @html_entity_decode( $item->get_description(), ENT_QUOTES, get_option('blog_charset') ) ) ) );
- $excerpt = wp_html_excerpt( $desc, 360 );
+ $desc = @html_entity_decode( $item->get_description(), ENT_QUOTES, get_option( 'blog_charset' ) );
+ $desc = esc_attr( strip_tags( $desc ) );
+ $desc = trim( str_replace( array( "\n", "\r" ), ' ', $desc ) );
+ $desc = wp_html_excerpt( $desc, 360 );
- // Append ellipsis. Change existing [...] to […].
- if ( '[...]' == substr( $excerpt, -5 ) )
- $excerpt = substr( $excerpt, 0, -5 ) . '[…]';
- elseif ( '[…]' != substr( $excerpt, -10 ) && $desc != $excerpt )
- $excerpt .= ' […]';
+ $summary = '';
+ if ( $show_summary ) {
+ $summary = $desc;
- $excerpt = esc_html( $excerpt );
+ // Append ellipsis. Change existing [...] to […].
+ if ( '[...]' == substr( $summary, -5 ) ) {
+ $summary = substr( $summary, 0, -5 ) . '[…]';
+ } elseif ( '[…]' != substr( $summary, -10 ) && $desc !== $summary ) {
+ $summary .= ' […]';
+ }
- if ( $show_summary ) {
- $summary = "<div class='rssSummary'>$excerpt</div>";
- } else {
- $summary = '';
+ $summary = '<div class="rssSummary">' . esc_html( $summary ) . '</div>';
}
$date = '';
if ( $link == '' ) {
echo "<li>$title{$date}{$summary}{$author}</li>";
+ } elseif ( $show_summary ) {
+ echo "<li><a class='rsswidget' href='$link'>$title</a>{$date}{$summary}{$author}</li>";
} else {
- echo "<li><a class='rsswidget' href='$link' title='$desc'>$title</a>{$date}{$summary}{$author}</li>";
+ echo "<li><a class='rsswidget' href='$link' title='$desc'>$title</a>{$date}{$author}</li>";
}
}
echo '</ul>';
$title = $tax->labels->name;
}
}
- $title = apply_filters('widget_title', $title, $instance, $this->id_base);
+
+ /** This filter is documented in wp-includes/default-widgets.php */
+ $title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
echo $before_widget;
if ( $title )
echo $before_title . $title . $after_title;
echo '<div class="tagcloud">';
- wp_tag_cloud( apply_filters('widget_tag_cloud_args', array('taxonomy' => $current_taxonomy) ) );
+
+ /**
+ * Filter the taxonomy used in the Tag Cloud widget.
+ *
+ * @since 2.8.0
+ * @since 3.0.0 Added taxonomy drop-down.
+ *
+ * @see wp_tag_cloud()
+ *
+ * @param array $current_taxonomy The taxonomy to use in the tag cloud. Default 'tags'.
+ */
+ wp_tag_cloud( apply_filters( 'widget_tag_cloud_args', array(
+ 'taxonomy' => $current_taxonomy
+ ) ) );
+
echo "</div>\n";
echo $after_widget;
}
if ( !$nav_menu )
return;
+ /** This filter is documented in wp-includes/default-widgets.php */
$instance['title'] = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
echo $args['before_widget'];
register_widget('WP_Nav_Menu_Widget');
- do_action('widgets_init');
+ /**
+ * Fires after all default WordPress widgets have been registered.
+ *
+ * @since 2.2.0
+ */
+ do_action( 'widgets_init' );
}
add_action('init', 'wp_widgets_init', 1);