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. Tuttavia, ci sono diverse cose che si possono fare per assicurarsi che il tuo tema ottenga di più da EDD.

In questo articolo, copriremo 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 per determinare quando e come utilizzare questi file di modelli. Non entreremo nei dettagli dell'intera gerarchia, ma ecco una visualizzazione di come i diversi file di modelli sono correlati.

Ciò che copriremo 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 – (Dal 4.4) Per prima cosa, 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 dovrebbe 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 singoli post del blog. 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 generale,
è il rango più alto per i modelli generici di post singoli.

È molto probabile che il tuo tema attivo (o tema genitore, se stai usando un
tema figlio) abbia un file single.php nella sua cartella principale. In tal caso, viene utilizzato per visualizzare i singoli post del blog. Tuttavia, è anche probabile che tu non abbia un file single.php ma invece un file singular.php. Questo sta diventando sempre più comune. Il suo scopo di base è essere più un modello "universale" per tutte le pagine front-end che rientrano nella definizione di "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 singoli post del blog. 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 una priorità maggiore rispetto a single.php. Ciò implica due cose:

1. Se single-{post-type}.php corrisponde 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 firma, navigazione 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 dire a WordPress che desideri visualizzare le tue pagine di prodotto singole in modo diverso dai tuoi post del blog singoli, devi accedere 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 è al suo posto nella cartella principale del tuo tema attivo, la visualizzazione della pagina front-end di uno dei tuoi prodotti richiamerà il template specifico per il download invece del template del post del blog. A quel punto, hai il controllo del tuo template single-download.php e puoi costruirlo come preferisci.

Ecco un consiglio molto utile per creare il tuo template 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 iniziale single-download.php è duplicare il file single.php del tuo tema e poi rinominare il duplicato in single-download.php. A quel punto, nulla cambierà nella visualizzazione delle tue pagine prodotto. Tuttavia, ora sei libero di modificare il nuovo file del template e questo influenzerà solo le tue pagine prodotto.

Se stai usando un tema child, ciò significa che dovresti copiare il template del post singolo del tema genitore per metterlo nella cartella principale del tuo tema child.

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 template utilizzato per visualizzare le Pagine di WordPress). Se è presente un file singular.php e nessuno dei template più specifici è disponibile, WordPress lo utilizzerà per tutti i tipi di post.

Inutile dire che questo file del template 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 accade all'interno di un unico file del template. 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 Download, cioè se il tema non è stato scritto per considerare EDD.

Sebbene questo non sia il posto giusto per entrare nei dettagli su come costruire un tema, la stessa cosa vale in questo scenario come per sovrascrivere il single.php per i template prodotto. Puoi usare il file singular.php per creare (attraverso la 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.

Template Prodotto Singolo in Sintesi

Questo non intende essere una guida al theming di WordPress. Invece, l'obiettivo è mostrarti come EDD funziona con WordPress in modo che tu possa usare i template di prodotto singolo per visualizzare le tue pagine prodotto.

Se non sei uno sviluppatore di temi WordPress, questo "." qualcosa che potresti voler esternalizzare a qualcuno esperto nel settore. La creazione del file necessario "." solo un passaggio. 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.