{"id":1993,"date":"2014-02-16T22:27:49","date_gmt":"2014-02-16T21:27:49","guid":{"rendered":"http:\/\/www.manuelmarangoni.it\/sir-bit\/?p=1993"},"modified":"2014-02-17T08:58:02","modified_gmt":"2014-02-17T07:58:02","slug":"wordpress-3-0-post-personalizzati-custom-post-type-esempio-completo","status":"publish","type":"post","link":"https:\/\/www.manuelmarangoni.it\/sir-bit\/1993\/wordpress-3-0-post-personalizzati-custom-post-type-esempio-completo\/","title":{"rendered":"WordPress 3.0 – Post personalizzati (Custom Post Type) – Esempio completo"},"content":{"rendered":"

Una delle funzionalit\u00e0 pi\u00f9 utili e potenti messe a disposizione da WordPress \u00e8 la possibilit\u00e0 di personalizzare a piacere l’uso degli articoli e delle categorie.<\/p>\n

Faccio una premessa.
\nGli articoli che siamo abituati a usare hanno in realt\u00e0 un \u00abtipo\u00bb associato: il tipo “post”<\/strong>. Allo stesso modo, le pagine hanno associato il tipo “page”. Di default troviamo poi altri tre tipi: “attachment”, “revision” e “nav_menu_item”.<\/p>\n

WordPress ci d\u00e0 la possibilit\u00e0 di creare dei nuovi tipi, in pratica delle aree separate in cui possiamo inserire articoli e categorie senza intaccare quelli principali.
\nSe, per esempio, abbiamo un sito che si occupa di musica e a un certo punto decidiamo di inserire una sezione per i film, ci sar\u00e0 utile creare una nuova area per i film<\/strong>, i cui articoli saranno tenuti ben distinti da quelli della musica.
\nI tipi personalizzati vengono denominati tecnicamente Custom Post Type<\/em> (CPT).<\/p>\n

In questo articolo vedremo un esempio completo e minimale su come realizzare i CPT<\/strong>.
\nNello specifico, il nostro cliente immaginario ci ha commissionato la realizzazione di un’area per inserire i calendari delle partite di andata e ritorno di una squadra di pallavolo.
\nQuello di cui abbiamo bisogno \u00e8 di creare un’area personalizzata chiamata “Calendario”, che si occupa esattamente come un qualsiasi post ma che in lato sito sar\u00e0 visualizzata in una sezione a parte.<\/p>\n

I file completi sono scaricabili gratuitamente al seguente link<\/strong>. All’interno troverete un txt contenente la descrizione generale con i passi da seguire.<\/p>\n

\n
\"Wordpress<\/div>\n
Scarica gli script di questo articolo in formato zip<\/a><\/strong><\/div>\n<\/div>\n

Il plugin “MM Custom Type Calendario” [mm_custom_types.php]<\/h3>\n

Le basi del CPT le costruiremo attraverso un comodo plugin<\/strong>, che potr\u00e0 quindi essere esportato facilmente in altri progetti.
\nIl file “mm_custom_types.php<\/strong>” nello zip va inserito cos\u00ec com’\u00e8 nella cartella dei plugin di WordPress. Il plugin va poi attivato come al solito nell’apposita area dell’admi.<\/p>\n

Vediamo il contenuto del plugin.
\nHo cercato di introdurre quanti pi\u00f9 parametri possibili nella funzione, cos\u00ec da averli sottomano. Ogni parametro \u00e8 commentato. In realt\u00e0, i valori attributi a gran parte di questi parametri sono quelli di default e quindi potevano essere omessi.
\nPer personalizzare i parametri vedete la documentazione ufficiale della funzione “register_post_type()” di WordPress (a fondo articolo trovate il link diretto).
\n<\/p>\n

Per prima cosa creiamo la funzione crea_calendari()<\/em>.<\/strong> Sar\u00e0 questa a definire i parametri per comporre il nostro CPT.
\nAll’interno della funzione richiameremo register_post_type()<\/em>, facendogli passare il riferimento (“calendario”, che in pratica sar\u00e0 il nome univoco che identificher\u00e0 il nostro CPT) e l’array contenente tutti i parametri definiti.<\/p>\n

\n\n\n\n
\n
1\r\n2\r\n3\r\n4\r\n5\r\n6\r\n7\r\n8\r\n9\r\n10\r\n11\r\n12\r\n13\r\n14\r\n15\r\n16\r\n17\r\n18\r\n19\r\n20\r\n21\r\n22\r\n23\r\n24\r\n25\r\n26\r\n27\r\n28\r\n29\r\n30\r\n31\r\n32\r\n33\r\n34\r\n35\r\n36\r\n37\r\n38\r\n39\r\n40\r\n41\r\n42\r\n43\r\n44\r\n45\r\n46\r\n47\r\n48\r\n49\r\n50\r\n51\r\n52\r\n53\r\n54\r\n55\r\n56\r\n57\r\n58\r\n59\r\n60<\/pre>\n<\/td>\n
\n
function<\/span> crea_calendari(<\/span>)<\/span>{<\/span>\r\n\r\n    $labels<\/span> =<\/span> array<\/span>(<\/span>\r\n        'name'<\/span>               =><\/span> __(<\/span>'Calendari'<\/span>)<\/span>,<\/span> \/\/nome plurale dell'etichetta<\/span>\r\n        'singular_name'<\/span>      =><\/span> __(<\/span>'Calendario'<\/span>)<\/span>,<\/span> \/\/nome singolare dell'etichetta<\/span>\r\n\t'menu_name'<\/span>\t     =><\/span> __(<\/span>'Calendari Menu'<\/span>)<\/span>,<\/span> \/\/nome del menu<\/span>\r\n\t'all_items'<\/span>          =><\/span> __(<\/span>'Elenco Calendari'<\/span>)<\/span>,<\/span> \/\/testo per mostrare tutti gli elementi<\/span>\r\n        'add_new'<\/span>            =><\/span> __(<\/span>'Aggiungi Calendario'<\/span>)<\/span>,<\/span> \/\/testo del pulsante di aggiunta nuovo elemento<\/span>\r\n        'add_new_item'<\/span>       =><\/span> __(<\/span>'Nuovo Calendario'<\/span>)<\/span>,<\/span> \/\/testo da mostrare quando siamo all'interno di un nuovo elemento<\/span>\r\n        'edit_item'<\/span>          =><\/span> __(<\/span>'Modifica Calendario'<\/span>)<\/span>,<\/span> \/\/testo di modifica dell'elemento<\/span>\r\n        'new_item'<\/span>           =><\/span> __(<\/span>'Nuovo Calendario'<\/span>)<\/span>,<\/span> \/\/testo del nuovo elemento<\/span>\r\n        'view_item'<\/span>          =><\/span> __(<\/span>'Visualizza Calendario'<\/span>)<\/span>,<\/span> \/\/testo di visualizzazione dell'elemento<\/span>\r\n        'search_items'<\/span>       =><\/span> __(<\/span>'Cerca Calendario'<\/span>)<\/span>,<\/span> \/\/testo per la ricerca degli elementi<\/span>\r\n        'not_found'<\/span>          =><\/span> __(<\/span>'Calendario non trovato'<\/span>)<\/span>,<\/span> \/\/testo quando non esistono elementi nell'elenco<\/span>\r\n        'not_found_in_trash'<\/span> =><\/span> __(<\/span>'Calendario non trovato nel cestino'<\/span>)<\/span>,<\/span> \/\/testo quando non esistono elementi nel cestino<\/span>\r\n    )<\/span>;<\/span>\r\n\r\n    $args<\/span> =<\/span> array<\/span>(<\/span>\r\n                'labels'<\/span>             =><\/span> $labels<\/span>,<\/span>\r\n\t\t'description'<\/span>\t     =><\/span> 'Raccolta dei Calendari'<\/span>,<\/span> \/\/breve descrizione del post type<\/span>\r\n                'public'<\/span>             =><\/span> true<\/span>,<\/span> \/\/se =true, viene visto sia da admin che in front-end<\/span>\r\n\t\t'exclude_from_search'<\/span> =><\/span> false<\/span>,<\/span> \/\/se =true gli elementi sono esclusi dalla ricerca front-end<\/span>\r\n\t\t'publicly_queryable'<\/span> =><\/span> true<\/span>,<\/span> \/\/indica se possono essere eseguite query lato front-end<\/span>\r\n\t\t'show_ui'<\/span>\t\t=><\/span> true<\/span>,<\/span> \/\/se =false, in admin non sar\u00e0 mostrare l'interfaccia per la gestione del post type<\/span>\r\n\t\t'show_in_nav_menus'<\/span>\t =><\/span> true<\/span>,<\/span> \/\/indica se il post type pu\u00f2 essere inserito nel nav menu<\/span>\r\n\t\t'show_in_admin_bar'<\/span>\t =><\/span> true<\/span>,<\/span> \/\/se =false, il post type non viene mostrato nel menu superiore \"Nuovo\" dell'admin<\/span>\r\n\r\n\t\t\/\/indica la posizione nei confronti degli altri elementi nel menu dell'admin.<\/span>\r\n\t\t\/\/ 5 = sotto a Posts; 10 = a Media; 15 = a Links; 20 = a Pages; 25 = a Comments; 60 = al primo separatore;<\/span>\r\n\t\t\/\/ 65 = a Plugins; 70 = a Users; 75 = a Tools; 80 = a Settings; 100 = al secondo separatore<\/span>\r\n\t\t'menu_position'<\/span>      =><\/span> 5<\/span>,<\/span>\r\n\r\n\t\t'hierarchical'<\/span>       =><\/span> false<\/span>,<\/span> \/\/indica se il post type ha un genitore (in genere usato solo per le pagine)<\/span>\r\n\r\n\t\t\/\/indica i valori del add_post_type_support() , ovvero quali elementi standard associare al post type<\/span>\r\n                'supports'<\/span>      =><\/span> array<\/span>(<\/span>\r\n                                'title'<\/span>,<\/span>\r\n                                'editor'<\/span>,<\/span>\r\n                                'thumbnail'<\/span>,<\/span>\r\n\t\t\t\t'excerpt'<\/span>\r\n                                )<\/span>,<\/span>\r\n\r\n\t\t\/\/indica quali taxonomies associare al post type<\/span>\r\n\t\t\/\/il seguente, per esempio, permette di inserire categorie a cui associare i post type<\/span>\r\n\t\t\/\/in mancanza non sar\u00e0 possibile creare categorie di post<\/span>\r\n\t\t'taxonomies'<\/span>\t\t =><\/span> array<\/span>(<\/span>'category'<\/span>)<\/span>,<\/span>\r\n\r\n\t\t'has_archive'<\/span>        =><\/span> true<\/span>,<\/span> \/\/abilita la pagina di archivio per il post type<\/span>\r\n\r\n\t\t\/\/permette di riscrivere alcuni parametri per il post type, che altrimenti sarebbero uguali a quelli standard<\/span>\r\n\t\t\/\/<\/span>\r\n\t\t'rewrite'<\/span>            =><\/span> array<\/span>(<\/span>\r\n\t\t\t\t\t'slug'<\/span> =><\/span> 'calendari'<\/span> \/\/il post type \u00e8 raggiungibile all'indirizzo \"mio_sito.it\/calendari\"<\/span>\r\n\t\t\t\t\t)<\/span>\r\n    )<\/span>;<\/span>\r\n\r\n\t\/\/registra l'elemento \"calendario\" come post type, con gli argomenti definiti sopra<\/span>\r\n\tregister_post_type(<\/span>'calendario'<\/span>,<\/span> $args<\/span>)<\/span>;<\/span>\r\n\r\n}<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
La nostra funzione sar\u00e0 poi inizializzata con questa riga:<\/p>\n
\n\n\n\n
\n
1<\/pre>\n<\/td>\n
\n
add_action(<\/span>'init'<\/span>,<\/span> 'crea_calendari'<\/span>)<\/span>;<\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Una volta attivato il plugin, nel menu laterale dell’admin avremo una nuova area: “Calendari Menu”<\/strong>. Da qui sar\u00e0 possibile visualizzare l’elenco dei calendari, aggiungere un nuovo calendario e associare a ognuno di essi una categoria da creare. Proprio come nei normali post.<\/p>\n