WordPress: creare e gestire i custom post type

Creazione e gestione dei custom post type di WordPress.

WordPress di Gabriele Romanato

WordPress ci permette di creare nuovi tipi di post usando delle impostazioni personalizzate. Questi post vengono chiamati custom post types e rappresentano un'ottima alternativa alla classica tassonomia basata su post e pagine. In questo articolo vedremo come creare e gestire questo tipo di post.

Creare i custom post type

Vogliamo creare un nuovo tipo di post per gestire i libri che abbiamo letto di recente e che ci sono piaciuti di più. Per prima cosa dobbiamo registrare il nuovo tipo di post aggiungendo il seguente codice al file functions.php:


add_action( 'init', 'create_post_type' );

function create_post_type() {
        $args = array(
        'labels' => post_type_labels( 'Libri' ),
        'public' => true,
        'publicly_queryable' => true,
        'show_ui' => true, 
        'show_in_menu' => true, 
        'query_var' => true,
        'rewrite' => true,
        'capability_type' => 'post',
        'has_archive' => true, 
        'hierarchical' => false,
        'menu_position' => null,
        'supports' => array('title',
            'editor',
            'author',
            'thumbnail',
            'excerpt',
            'comments'
        )
    ); 
 
    register_post_type( 'libri', $args );
}

A questo punto il custom post type libri è stato creato, ma mancano le etichette dei menu per gestirlo. Dobbiamo quindi definire queste etichette:

 
function post_type_labels($name) {
    
    return array(
        'name' => _x( $name, 'post type general name' ),
        'singular_name' => _x( 'Libro', 'post type singular name' ),
        'add_new' => __( 'Aggiungi nuovo' ),
        'add_new_item' => __( 'Aggiungi nuovo libro'),
        'edit_item' => __( 'Modifica libro'),
        'new_item' => __( 'Nuovo libro' ),
        'view_item' => __( 'Vedi libro' ),
        'search_items' => __( 'Cerca'. $name ),
        'not_found' =>  __( 'Nessun libro trovato'),
        'not_found_in_trash' => __( 'Non ci sono ' . $name . ' libri nel Cestino' ), 
        'parent_item_colon' => ''
    );
}

Ora dobbiamo fare in modo che il nome del nostro custom post type compaia quando si salva o si aggiorna un post:


add_filter('post_updated_messages', 'post_type_updated_messages');

function post_type_updated_messages( $messages ) {
        global $post, $post_ID;
 
        $messages['libri'] = array(
                0 => '', 
                1 => sprintf( __('Libro aggiornato. <a href="%s">Vedi libro</a>'), esc_url( get_permalink($post_ID) ) ),
                2 => __('Campo personalizzato aggiornato.'),
                3 => __('Campo personalizzato eliminato.'),
                4 => __('Libro aggiornato.'),
                5 => isset($_GET['revision']) ? sprintf( __('Libro salvato dalla revisione da %s'), wp_post_revision_title( (int) $_GET['revision'], false ) ) : false,
                6 => sprintf( __('Libro pubblicato. <a href="%s">Vedi libro</a>'), esc_url( get_permalink($post_ID) ) ),
                7 => __('Libro salvato.'),
                8 => sprintf( __('Libro inviato. <a target="_blank" href="%s">Anteprima libro</a>'), esc_url( add_query_arg( 'preview', 'true', get_permalink($post_ID) ) ) ),
                9 => sprintf( __('Libro programmato per: <strong>%1$s</strong>. <a target="_blank" href="%2$s">Anteprima libro</a>'),
                date_i18n( __( 'M j, Y @ G:i' ), strtotime( $post->post_date ) ), esc_url( get_permalink($post_ID) ) ),
                10 => sprintf( __('Bozza del libro aggiornata. <a target="_blank" href="%s">Anteprima libro</a>'), esc_url( add_query_arg( 'preview', 'true', get_permalink($post_ID) ) ) ),
        );
 
        return $messages;
}

Gestire i custom post type

Per impostazione predefinita i custom post type non vengono inclusi nel Loop di WordPress. Dobbiamo quindi creare un Loop personalizzato che comprenda anche questo nuovo tipo di post:


<?php
$args = array( 'post_type' => 'libri', 'posts_per_page' => 10 );
$loop = new WP_Query( $args );
while ( $loop->have_posts() ) : $loop->the_post();
?>
	<article class="libri" id="libro-<?php the_ID();?>">
		<h2><a href="<?php the_permalink();?>"><?php the_title();?></a></h2>
		<div class="content">
			<?php the_content('Leggi il resto del libro'); ?>
		</div>
	
	</article>
<?php        
endwhile;
?>

Per creare una pagina di archivio o il template di un singolo post, occorre seguire questa nomenclatura dei file nel nostro tema:

  1. archive-{post-type}.php
  2. single-{post-type}.php

Nel nostro caso diventa:

  1. archive-libri.php
  2. single-libri.php

Riferimenti

  1. Documentazione ufficiale di WordPress
  2. La funzione register_post_type()
  3. Custom Post Type UI, un plugin che vi permette di creare i custom post type con una comoda interfaccia grafica