I Custom Post Type (CPT) sono uno dei meccanismi pi\u00f9 potenti di WordPress. Mentre WordPress nativamente gestisce due tipi di contenuto (post e pagine), i CPT permettono di crearne di nuovi con caratteristiche, comportamenti e interfacce completamente personalizzate. Un CPT non \u00e8 altro che un tipo di contenuto aggiuntivo registrato nel sistema, con proprie voci di menu, tassonomie, permalink e template.<\/p>\n
WordPress tratta ogni CPT come un contenuto di prima classe: supporta l’editor Gutenberg, la REST API, le revisioni, gli excerpt, i campi personalizzati e qualsiasi funzionalit\u00e0 tu voglia attivare.<\/p>\n
Un portfolio \u00e8 il caso d’uso classico per un CPT. Invece di utilizzare post standard con categorie, crei un CPT “Progetti” o “Portfolio” con campi specifici come cliente, anno, tecnologie usate e URL del progetto live. Ogni progetto ha il proprio template di visualizzazione e le proprie pagine di archivio.<\/p>\n
Le recensioni dei clienti meritano un tipo di contenuto dedicato. Un CPT “Testimonianze” pu\u00f2 includere campi per il nome del cliente, la sua azienda, la valutazione in stelle e la foto. Puoi visualizzarle in slider, griglia o singole citazioni in qualsiasi parte del sito tramite shortcode o blocchi Gutenberg.<\/p>\n
Anche senza WooCommerce, puoi creare un CPT “Prodotti” per cataloghi semplici. Registra campi come prezzo, scheda tecnica, disponibilit\u00e0 e galleria immagini. Per funzionalit\u00e0 e-commerce complete, WooCommerce registra gi\u00e0 il proprio CPT “product”, ma un CPT personalizzato \u00e8 utile per cataloghi senza carrello o listini prezzi.<\/p>\n
Un CPT “Eventi” \u00e8 ideale per conferenze, workshop, webinar e appuntamenti. Puoi aggiungere campi per data, ora, luogo, relatori e biglietti. Combinato con plugin come The Events Calendar, ottieni un sistema completo di gestione eventi perfettamente integrato.<\/p>\n
La registrazione di un CPT avviene tramite la funzione register_post_type(), chiamata all’interno dell’hook init del tema. Ecco un esempio completo:<\/p>\n
function crea_cpt_portfolio() {
\n$labels = array(
\n‘name’ => ‘Portfolio’,
\n‘singular_name’ => ‘Progetto’,
\n‘add_new’ => ‘Aggiungi Progetto’,
\n‘add_new_item’ => ‘Aggiungi Nuovo Progetto’,
\n‘edit_item’ => ‘Modifica Progetto’,
\n‘view_item’ => ‘Vedi Progetto’,
\n‘search_items’ => ‘Cerca Progetti’,
\n‘not_found’ => ‘Nessun progetto trovato’,
\n‘not_found_in_trash’ => ‘Nessun progetto nel cestino’
\n);
\n$args = array(
\n‘labels’ => $labels,
\n‘public’ => true,
\n‘has_archive’ => true,
\n‘rewrite’ => array(‘slug’ => ‘portfolio’),
\n‘menu_icon’ => ‘dashicons-portfolio’,
\n‘supports’ => array(‘title’, ‘editor’, ‘thumbnail’, ‘excerpt’, ‘custom-fields’, ‘revisions’),
\n‘show_in_rest’ => true,
\n);
\nregister_post_type(‘portfolio’, $args);
\n}
\nadd_action(‘init’, ‘crea_cpt_portfolio’);
\nQuesto codice va inserito nel file functions.php del tema. Per maggiore sicurezza e organizzazione, \u00e8 consigliabile creare un plugin site-specific (mu-plugin) anzich\u00e9 modificare il tema.<\/p>\n
L’array labels definisce tutte le etichette testuali visibili nell’interfaccia di amministrazione. Personalizzarle rende l’esperienza utente pi\u00f9 coerente e professionale, soprattutto se il sito viene gestito da clienti che non parlano inglese.<\/p>\n
L’array supports attiva le funzionalit\u00e0 dell’editor per il CPT: title (titolo), editor (contenuto), thumbnail (immagine in evidenza), excerpt (riassunto), custom-fields (campi personalizzati), revisions (cronologia revisioni), page-attributes (ordine e pagina padre), post-formats (formati post) e comments (commenti).<\/p>\n
Il parametro rewrite controlla la struttura degli URL del CPT. L’opzione slug definisce la base dell’URL (es. \/portfolio\/nome-progetto). with_front gestisce la presenza della base dei permalink, e pages\/front abilitano la paginazione dell’archivio.<\/p>\n
menu_icon accetta il nome di una dashicon (es. dashicons-portfolio, dashicons-cart, dashicons-testimonial) o l’URL di un’icona personalizzata. Le dashicons sono la libreria di icone integrata di WordPress e offrono centinaia di opzioni.<\/p>\n
public => true rende il CPT visibile nel frontend e nel backend, con pagine pubbliche e permalink. show_in_rest => true abilita il CPT nella REST API di WordPress, permettendo l’utilizzo dell’editor a blocchi e l’accesso ai dati tramite API.<\/p>\n
Oltre ai CPT, puoi creare tassonomie personalizzate per organizzare i contenuti in modo specifico. register_taxonomy() segue la stessa logica di register_post_type():<\/p>\n
function crea_tassonomia_settore() {
\n$labels = array(
\n‘name’ => ‘Settori’,
\n‘singular_name’ => ‘Settore’,
\n‘search_items’ => ‘Cerca Settori’,
\n‘all_items’ => ‘Tutti i Settori’,
\n‘edit_item’ => ‘Modifica Settore’,
\n‘add_new_item’ => ‘Aggiungi Nuovo Settore’
\n);
\nregister_taxonomy(‘settore’, ‘portfolio’, array(
\n‘labels’ => $labels,
\n‘hierarchical’ => true,
\n‘show_in_rest’ => true,
\n‘rewrite’ => array(‘slug’ => ‘settore’)
\n));
\n}
\nadd_action(‘init’, ‘crea_tassonomia_settore’);
\nCon hierarchical => true la tassonomia si comporta come le categorie (con padre-figlio); con false, come i tag.<\/p>\n
Se preferisci un’interfaccia grafica al codice, il plugin Custom Post Type UI (CPT UI) permette di registrare CPT e tassonomie senza scrivere una riga di PHP. L’interfaccia \u00e8 chiara e offre tutti gli stessi parametri di register_post_type(). Il plugin esporta anche il codice PHP generato, che puoi copiare nel tema se decidi di rimuovere il plugin.<\/p>\n
WordPress segue una gerarchia di template ben definita. Per un CPT chiamato “portfolio”, puoi creare:
\n– single-portfolio.php per il template del singolo progetto
\n– archive-portfolio.php per l’archivio dei progetti
\n– taxonomy-settore.php per l’archivio filtrato per tassonomia
\nSenza questi file, WordPress usa single.php e archive.php del tema. La gerarchia garantisce che il template pi\u00f9 specifico venga sempre caricato per primo.<\/p>\n
Con show_in_rest => true, il CPT \u00e8 accessibile tramite REST API all’endpoint \/wp\/v2\/portfolio. Puoi personalizzare i campi restituiti con register_rest_field() o creare endpoint personalizzati con register_rest_route(). I dati in JSON includono titolo, contenuto, excerpt, meta, tassonomie e URL delle thumbnail. Questo rende i CPT perfetti per architetture headless con frontend React, Vue.js o Next.js.<\/p>\n
I Custom Post Type sono fondamentali per trasformare WordPress da semplice blog in un CMS enterprise in grado di gestire qualsiasi tipo di contenuto. La registrazione tramite functions.php o plugin d\u00e0 il controllo completo su comportamento e aspetto. Combina CPT con tassonomie personalizzate, campi avanzati (ACF) e template dedicati per creare architetture di contenuto professionali, scalabili e perfettamente integrate con l’editor a blocchi e la REST API.<\/p>","protected":false},"excerpt":{"rendered":"
Cosa sono i Custom Post Type I Custom Post Type (CPT) sono uno dei meccanismi pi\u00f9 potenti di WordPress. Mentre WordPress nativamente gestisce due tipi di contenuto (post e pagine), i CPT permettono di crearne di nuovi con caratteristiche, comportamenti e interfacce completamente personalizzate. Un CPT non \u00e8 altro che un tipo di contenuto aggiuntivo […]<\/p>\n","protected":false},"author":1,"featured_media":2041,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_gspb_post_css":"","ai_primary_source":"Studio Immens Blog","visibility_scope":"both","ai_summary":"Cosa sono i Custom Post Type I Custom Post Type (CPT) sono uno dei meccanismi pi\u00f9 potenti di WordPress. Mentre WordPress nativamente gestisce due tipi di contenuto (post e pagine), i CPT permettono di crearne di nuovi con caratteristiche, comportamenti e interfacce completamente personalizzate. U...","ai_intent":"informative","ai_related_resources":"","ai_priority":5,"ai_entity_type":"Article","ai_is_based_on":"https:\/\/blog.studioimmens.com\/custom-post-type-in-wordpress\/","ai_citations":"","ai_mentions":"","ai_speakable_selector":"","ai_chunk_hints":"Custom, Post, Type, in","footnotes":""},"categories":[133],"tags":[277],"ai_visibility":[],"class_list":["post-1951","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-wordpress","tag-custom-post-type"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/posts\/1951","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/comments?post=1951"}],"version-history":[{"count":1,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/posts\/1951\/revisions"}],"predecessor-version":[{"id":2242,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/posts\/1951\/revisions\/2242"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/media\/2041"}],"wp:attachment":[{"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/media?parent=1951"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/categories?post=1951"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/tags?post=1951"},{"taxonomy":"ai_visibility","embeddable":true,"href":"https:\/\/studioimmens.com\/en\/wp-json\/wp\/v2\/ai_visibility?post=1951"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}