# Come creare modelli di prodotto singolo A questo punto, è sicuro presumere che tu sappia già che [Easy Digital Downloads (EDD) è stato sviluppato per funzionare con qualsiasi tema](https://easydigitaledd.com/docs/will-easy-digital-downloads-work-with-my-theme/). Tuttavia, ci sono diverse cose che si possono fare per assicurarsi che il tuo tema ottenga di più da EDD. In questo articolo, tratteremo le basi su come creare modelli di prodotto singolo per il tuo tema. Per essere chiari, un modello di prodotto singolo viene utilizzato per visualizzare la pagina front-end creata quando aggiungi un nuovo Download al tuo sito. ### Gerarchia dei modelli di WordPress Innanzitutto, dobbiamo fare un passo indietro ed esaminare come funziona WordPress stesso. I temi di WordPress non sono altro che una raccolta di file che lavorano insieme per visualizzare il tuo sito. Alcuni di questi file del tema sono modelli e componenti di modelli che si uniscono per creare la struttura HTML del tuo sito. WordPress utilizza una [gerarchia di modelli](https://developer.wordpress.org/themes/basics/template-hierarchy/) per determinare quando e come utilizzare questi file modello. Non entreremo nei dettagli completi dell'intera gerarchia, ma ecco una visualizzazione di come i diversi file modello sono correlati. [](https://developer.wordpress.org/files/2014/10/template-hierarchy.png) Quello che tratteremo qui è il modello di post singolo e come influisce sul modo in cui verranno visualizzate le tue pagine di prodotto singolo. Iniziamo. #### Modello di post singolo (e singolare) Direttamente da *wordpress.org*, ecco la gerarchia dei modelli per i post singoli: 1. `single-{post-type}-{slug}.php` – (Da 4.4) Innanzitutto, WordPress cerca un modello per il post specifico. Ad esempio, se il tipo di post è `product` e lo slug del post è `dmc-12`, WordPress cercherebbe `single-product-dmc-12.php`. 2. `single-{post-type}.php` – Se il tipo di post è `product`, WordPress cercherebbe `single-product.php`. 3. `single.php` – WordPress quindi ripiega su `single.php`. 4. `singular.php` – Quindi ripiega su `singular.php`. 5. `index.php` – Infine, come accennato in precedenza, WordPress ripiega in ultima analisi su `index.php`. Ciò significa che il nome di un file del tema indica a WordPress quando deve essere utilizzato e il suo "rango" nella gerarchia per quel particolare caso d'uso. Il nome del file più comune a questo punto è molto probabilmente `single.php`. Il modello `single.php` viene utilizzato per visualizzare i post del blog singoli. Come puoi immaginare, molti utenti pubblicano più post del blog sui loro siti WordPress rispetto a qualsiasi altra cosa. Quindi, sebbene `single.php` non sia il rango più alto in assoluto, *è* il rango più alto per i modelli di post singoli generici. È molto probabile che il tuo tema attivo (o tema padre, se stai usando un [tema figlio](https://codex.wordpress.org/Child_Themes)) abbia un file `single.php` nella sua cartella principale. In tal caso, viene utilizzato per visualizzare i post del blog singoli. Tuttavia, è anche possibile che tu non abbia un file `single.php` ma invece un file `singular.php`. Questo sta diventando più comune. Il suo scopo di base è essere più un modello "universale" per tutte le pagine front-end che rientrano nella definizione "singolare" di WordPress, come post del blog, pagine e voci per tipi di post personalizzati di base. Vediamo come EDD utilizza questi modelli e come puoi cambiarlo. #### single.php Come accennato in precedenza, il file `single.php` è un modello di base utilizzato per visualizzare i post del blog singoli. Quando viene visitato l'URL di un post del blog, WordPress cercherà nella struttura del tema il file modello appropriato da utilizzare per visualizzare quel post del blog. Il file `single.php` è la risposta comune. Con questa comprensione, devi anche sapere che Post (e Pagine) sono ciò che WordPress chiama "tipi di post". Ci sono alcuni tipi di post predefiniti integrati in WordPress, ma gli sviluppatori possono anche crearne di propri, chiamati Tipi di Post Personalizzati. EDD stesso introduce diversi tipi di post personalizzati nel tuo sistema, uno dei quali è il **Download**. Questo è l'unico che discuteremo qui. Se scorri verso l'alto per dare un'altra occhiata alla gerarchia dei modelli per i post singoli, noterai che `single-{post-type}.php` ha un rango superiore a `single.php`. Ciò implica due cose: 1. Se `single-{post-type}.php` si adatta allo scenario, verrà utilizzato prima di `single.php`. 2. Se non esiste un modello `single-{post-type}.php`, la scelta successiva è `single.php`. A meno che il tuo tema non sia stato scritto specificamente per EDD, la tua situazione rientra per impostazione predefinita nel secondo scenario. Dato che il tipo di post personalizzato Download di EDD è registrato come download, a meno che il tuo tema non includa un file `single-download.php` (o la posizione #1 nella gerarchia dei post singoli, che non discuteremo), WordPress cercherà il file `single.php`. Ciò significa che il modo in cui vengono visualizzati i tuoi post del blog, il tuo download EDD apparirà allo stesso modo. Se i tuoi post del blog includono informazioni sulla riga dell'autore, navigazione da post a post o qualsiasi altra cosa, verranno visualizzati anche per i tuoi download. Per molti utenti, questo non è un problema. Per altri, può aggiungere informazioni indesiderate alla visualizzazione del prodotto. O forse alcuni utenti semplicemente non vogliono che le loro pagine di prodotto vengano visualizzate allo stesso modo dei post del blog, il che è comprensibile. #### single-download.php Per indicare a WordPress che desideri visualizzare le tue pagine di prodotto singolo in modo diverso dai tuoi post del blog singoli, devi attingere alla gerarchia dei modelli di post singoli creando un file `single-download.php` nella cartella principale del tuo tema attivo (il che significherebbe il tuo tema figlio se ne stai usando uno). Una volta che questo file è in posizione nella cartella principale del tuo tema attivo, la visualizzazione della pagina front-end per uno dei tuoi prodotti richiamerà il modello specifico per il download invece del modello del post del blog. A quel punto, hai il controllo del tuo modello `single-download.php` e puoi costruirlo come preferisci. Ecco un consiglio molto utile per creare il tuo modello `single-download.php`: A meno che tu non sia uno sviluppatore di temi che sa già cosa sta facendo, il modo migliore per creare il tuo file `single-download.php` iniziale è duplicare il file `single.php` del tuo tema e quindi rinominare il duplicato in `single-download.php`. A quel punto, nulla cambierà nella visualizzazione delle tue pagine di prodotto. Tuttavia, ora sei libero di modificare il nuovo file modello e influenzerà solo le tue pagine di prodotto. Se stai usando un tema figlio, ciò significa che dovrai copiare il modello di post singolo del tema padre da inserire nella cartella principale del tuo tema figlio. #### singular.php Le cose si complicano un po' qui. Il file `singular.php` è abbastanza nuovo e, sebbene non sia così ampiamente utilizzato come il file `single.php`, è ancora popolare. Come accennato in precedenza, WordPress viene fornito con diversi tipi di post già integrati e supporta la creazione di tipi di post personalizzati. *Tutti* questi tipi di post sono considerati singolari. Ciò significa che un tema non deve includere un file `single.php`, o anche un file `page.php` (il modello utilizzato per visualizzare le Pagine di WordPress). Se è presente un file `singular.php` e nessuno dei modelli più specifici è disponibile, WordPress lo utilizzerà per tutti i tipi di post. Inutile dire che questo file modello spesso deve utilizzare la logica condizionale. Ciò significa: Se l'URL visitato è una pagina, usa questo codice per visualizzare la pagina. Se l'URL visitato è un post, usa quel codice per visualizzare il post. Tutto questo avviene all'interno di un unico file modello. Per i siti con solo post e pagine, questo è semplice. Quando introduci tipi di post personalizzati, questo può diventare complicato poiché lo sviluppatore del tema molto probabilmente non ha creato una condizione per il tipo di post personalizzato Download, cioè se il tema non è stato scritto per considerare EDD. Sebbene questo non sia il posto giusto per entrare nei dettagli su come creare un tema, la stessa cosa vale in questo scenario come per sovrascrivere `single.php` per i modelli di prodotto. Puoi usare il file `singular.php` per creare (tramite duplicazione) un file `single-download.php`. L'unica differenza qui è che dovrai comprendere meglio il codice in questo file per modificarlo per l'uso con i prodotti. ### Modelli di prodotto singolo in sintesi Questo non intende essere una guida sul theming di WordPress. Invece, l'obiettivo è mostrarti come EDD funziona con WordPress in modo che tu possa utilizzare modelli di prodotto singolo per visualizzare le tue pagine di prodotto. Se non sei uno sviluppatore di temi WordPress, questa è una cosa che potresti voler esternalizzare a qualcuno esperto nel settore. La creazione del file necessario è solo un passo. La creazione (o la modifica) del codice nel file è un'attività completamente separata che richiede un po' di esperienza o almeno familiarità con HTML e PHP.