Inclure des types de publication personnalisés dans le widget "Publications récentes"
Je peux facilement inclure mes types de publication personnalisés dans ma boucle principale en faisant de petits ajustements avec query_posts(), mais je ne suis pas sûr de savoir comment inclure des types de publication personnalisés dans le widget de barre latérale "Messages récents" ( d'autres widgets, d'ailleurs).
Comment devrais-je élargir la portée de "Publications récentes" pour inclure davantage que le type de publication natif?
Vous devrez éditer le code du widget Recent Posts ou créer votre propre version basée sur la valeur par défaut. Le code se trouve dans le fichier wp-includes/default-widgets.php autour de la ligne 513. Mais comme vous ne devez jamais modifier le noyau, je vous recommande de copier le code pour créer votre propre Mes messages récents personnalisés et l’utiliser sur votre site. Il suffit de déposer la nouvelle classe de widgets dans le fichier functions.php de votre thème ou de l’utiliser dans un plugin.
Les seules modifications réelles que vous devez apporter concernent le nom de classe du widget, ainsi que les fonctions et options encapsulées (afin d'éviter tout conflit d'attribution de nom avec le widget Recent Posts original. Ensuite, vous devrez modifier le appelez WP_Query dans le constructeur widget() pour qu’il inclue votre type de publication personnalisé.
Pour cet exemple, j'ai défini post_type égal à array('post, 'page', 'custom-post-type') ... vous devrez le modifier pour l'adapter à votre cas d'utilisation spécifique.
Voici le code complet du widget pour référence:
/**
* My_Custom_Recent_Posts widget class
*
*/
class WP_Widget_My_Custom_Recent_Posts extends WP_Widget {
function __construct() {
$widget_ops = array('classname' => 'widget_my_custom_recent_entries', 'description' => __( "The most recent posts on your site") );
$this->WP_Widget('my-custom-recent-posts', __('My Custom Recent Posts'), $widget_ops);
$this->alt_option_name = 'widget_my_custom_recent_entries';
add_action( 'save_post', array(&$this, 'flush_widget_cache') );
add_action( 'deleted_post', array(&$this, 'flush_widget_cache') );
add_action( 'switch_theme', array(&$this, 'flush_widget_cache') );
}
function widget($args, $instance) {
$cache = wp_cache_get('widget_my_custom_recent_posts', 'widget');
if ( !is_array($cache) )
$cache = array();
if ( isset($cache[$args['widget_id']]) ) {
echo $cache[$args['widget_id']];
return;
}
ob_start();
extract($args);
$title = apply_filters('widget_title', empty($instance['title']) ? __('My Custom Recent Posts') : $instance['title'], $instance, $this->id_base);
if ( !$number = (int) $instance['number'] )
$number = 10;
else if ( $number < 1 )
$number = 1;
else if ( $number > 15 )
$number = 15;
$r = new WP_Query(array('showposts' => $number, 'nopaging' => 0, 'post_status' => 'publish', 'ignore_sticky_posts' => true, 'post_type' => array('post', 'page', 'custom-post-type')));
if ($r->have_posts()) :
?>
<?php echo $before_widget; ?>
<?php if ( $title ) echo $before_title . $title . $after_title; ?>
<ul>
<?php while ($r->have_posts()) : $r->the_post(); ?>
<li><a href="<?php the_permalink() ?>" title="<?php echo esc_attr(get_the_title() ? get_the_title() : get_the_ID()); ?>"><?php if ( get_the_title() ) the_title(); else the_ID(); ?></a></li>
<?php endwhile; ?>
</ul>
<?php echo $after_widget; ?>
<?php
// Reset the global $the_post as this query will have stomped on it
wp_reset_postdata();
endif;
$cache[$args['widget_id']] = ob_get_flush();
wp_cache_set('widget_my_custom_recent_posts', $cache, 'widget');
}
function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
$instance['number'] = (int) $new_instance['number'];
$this->flush_widget_cache();
$alloptions = wp_cache_get( 'alloptions', 'options' );
if ( isset($alloptions['widget_my_custom_recent_entries']) )
delete_option('widget_my_custom_recent_entries');
return $instance;
}
function flush_widget_cache() {
wp_cache_delete('widget_my_custom_recent_posts', 'widget');
}
function form( $instance ) {
$title = isset($instance['title']) ? esc_attr($instance['title']) : '';
if ( !isset($instance['number']) || !$number = (int) $instance['number'] )
$number = 5;
?>
<p><label for="<?php echo $this->get_field_id('title'); ?>"><?php _e('Title:'); ?></label>
<input class="widefat" id="<?php echo $this->get_field_id('title'); ?>" name="<?php echo $this->get_field_name('title'); ?>" type="text" value="<?php echo $title; ?>" /></p>
<p><label for="<?php echo $this->get_field_id('number'); ?>"><?php _e('Number of posts to show:'); ?></label>
<input id="<?php echo $this->get_field_id('number'); ?>" name="<?php echo $this->get_field_name('number'); ?>" type="text" value="<?php echo $number; ?>" size="3" /></p>
<?php
}
}
À partir d’au moins 3.6, vous pouvez utiliser le code suivant pour modifier la requête utilisée:
add_filter('widget_posts_args', 'widget_posts_args_add_custom_type');
function widget_posts_args_add_custom_type($params) {
$params['post_type'] = array('post','custom_type');
return $params;
}
Ajoutez simplement les types que vous voulez dans le tableau pour post_type et ils devraient apparaître.
Mise à jour: Selon http://core.trac.wordpress.org/ticket/16159 , ceci est disponible depuis la 3.4
Je viens de tomber sur un excellent plug-in où le gros du travail est déjà fait, et qui possède une excellente documentation et un support de la part des auteurs. J'ai vraiment été impressionné.
Il autorise WP_Query à remplacer (vous permettant de filtrer par types de publication personnalisés et tout ce que vous souhaitez) et des instructions claires sur son utilisation.
Documentationhttp://www.pjgalbraith.com/2011/08/recent-posts-plus/
URL du plugin Wordpresshttp://wordpress.org/extend/plugins/recent-posts-plus/
Fait mon travail juste cela beaucoup plus court!
Vous pouvez copier le code du widget (voir /wp-includes/default-widgets.php) et modifier la ligne de requête.
Ce code crée un nouveau widget de publications récentes qui inclut vos CPT
Il y a 2 étapes à suivre lors de l’extension du widget natif de publications récentes:
je. Créez une nouvelle classe pour votre widget de publications récentes personnalisé. Pour ce faire, copiez et renommez le code du widget de publications récentes à partir du dossier defaults-widgets.php du dossier wp-includes.
ii. Ensuite, vous devrez également enregistrer le nouveau widget et vous pourrez choisir de désenregistrer le widget natif de publications récentes ou d'utiliser les deux.
Tout le code peut simplement être copié dans votre fichier de fonctions à l'aide d'un thème enfant ou créer un autre fichier et l'inclure dans votre fichier de fonctions de thèmes enfants.
<?php
class WPSites_Recent_Posts extends WP_Widget {
public function __construct() {
$widget_ops = array('classname' => 'wpsites_recent_posts', 'description' => __( "Latest CPT's & Posts.") );
parent::__construct('wpsites-recent-posts', __('WP Sites Recent Posts'), $widget_ops);
$this->alt_option_name = 'wpsites_recent_posts';
add_action( 'save_post', array($this, 'flush_widget_cache') );
add_action( 'deleted_post', array($this, 'flush_widget_cache') );
add_action( 'switch_theme', array($this, 'flush_widget_cache') );
}
public function widget($args, $instance) {
$cache = array();
if ( ! $this->is_preview() ) {
$cache = wp_cache_get( 'wpsites_widget_recent_posts', 'widget' );
}
if ( ! is_array( $cache ) ) {
$cache = array();
}
if ( ! isset( $args['widget_id'] ) ) {
$args['widget_id'] = $this->id;
}
if ( isset( $cache[ $args['widget_id'] ] ) ) {
echo $cache[ $args['widget_id'] ];
return;
}
ob_start();
$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'] ) : 5;
if ( ! $number )
$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',
'post_type' => array('post', 'portfolio',
'ignore_sticky_posts' => true
) ) ) );
if ($r->have_posts()) :
?>
<?php echo $args['before_widget']; ?>
<?php if ( $title ) {
echo $args['before_title'] . $title . $args['after_title'];
} ?>
<ul>
<?php while ( $r->have_posts() ) : $r->the_post(); ?>
<li>
<a href="<?php the_permalink(); ?>"><?php get_the_title() ? the_title() : the_ID(); ?></a>
<?php if ( $show_date ) : ?>
<span class="post-date"><?php echo get_the_date(); ?></span>
<?php endif; ?>
</li>
<?php endwhile; ?>
</ul>
<?php echo $args['after_widget']; ?>
<?php
wp_reset_postdata();
endif;
if ( ! $this->is_preview() ) {
$cache[ $args['widget_id'] ] = ob_get_flush();
wp_cache_set( 'wpsites_widget_recent_posts', $cache, 'widget' );
} else {
ob_end_flush();
}
}
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
$instance['number'] = (int) $new_instance['number'];
$instance['show_date'] = isset( $new_instance['show_date'] ) ? (bool) $new_instance['show_date'] : false;
$this->flush_widget_cache();
$alloptions = wp_cache_get( 'alloptions', 'options' );
if ( isset($alloptions['wpsites_recent_posts']) )
delete_option('wpsites_recent_posts');
return $instance;
}
public function flush_widget_cache() {
wp_cache_delete('wpsites_widget_recent_posts', 'widget');
}
public function form( $instance ) {
$title = isset( $instance['title'] ) ? esc_attr( $instance['title'] ) : '';
$number = isset( $instance['number'] ) ? absint( $instance['number'] ) : 5;
$show_date = isset( $instance['show_date'] ) ? (bool) $instance['show_date'] : false;
?>
<p><label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( 'Title:' ); ?></label>
<input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo $title; ?>" /></p>
<p><label for="<?php echo $this->get_field_id( 'number' ); ?>"><?php _e( 'Number of posts to show:' ); ?></label>
<input id="<?php echo $this->get_field_id( 'number' ); ?>" name="<?php echo $this->get_field_name( 'number' ); ?>" type="text" value="<?php echo $number; ?>" size="3" /></p>
<p><input class="checkbox" type="checkbox" <?php checked( $show_date ); ?> id="<?php echo $this->get_field_id( 'show_date' ); ?>" name="<?php echo $this->get_field_name( 'show_date' ); ?>" />
<label for="<?php echo $this->get_field_id( 'show_date' ); ?>"><?php _e( 'Display post date?' ); ?></label></p>
<?php
}
}
Enregistrer le nouveau widget de publications récentes personnalisées
function wpsites_widgets_init() {
if ( !is_blog_installed() )
return;
register_widget('WPSites_Recent_Posts');
do_action( 'widgets_init' );
}
add_action( 'init', 'wpsites_widgets_init', 2 );
Le code comprend un WP_Query modifié qui inclut un tableau pour les types de publication, y compris le portefeuille CPT, que vous pouvez renommer pour correspondre à votre type de publication personnalisé.
Voici la ligne de code qui doit être modifiée:
'post_type' => array('post', 'portfolio',
J'ai également créé un plug-in de widget plus personnalisable que le widget Messages récents. Si vous êtes intéressé, vous pouvez le télécharger ici http://new2wp.com/pro/latest-custom-post-type-posts-sidebar-widget/