WooCommerce Docs

WooCommerce viene fornito con diversi shortcodes che possono essere utilizzati per inserire contenuti all’interno di post e pagine.

Come usare gli shortcodes Back to top

Dove usarli Back to top

Gli shortcodes possono essere usati su pagine e post in WordPress. Se stai usando l’editor di blocchi, c’è un blocco di shortcode che puoi usare per incollare lo shortcode.

Se stai usando l’editor classico, puoi incollare lo shortcode sulla pagina o sul post.

Args (o Arguments) Back to top

Diversi shortcodes sotto menzioneranno “Args”. Questi sono modi per rendere lo shortcode più specifico. Per esempio, aggiungendo id="99" allo shortcode , si creerà un pulsante add-to-cart per il prodotto con ID 99.

Page Shortcodes

WooCommerce non può funzionare correttamente senza che i primi tre shortcodes siano da qualche parte sul vostro sito.

– mostra la pagina del carrello
– mostra la pagina del checkout
– mostra la pagina dell’account utente
– mostra il modulo di tracciamento dell’ordine

Nella maggior parte dei casi, questi shortcodes saranno aggiunti alle pagine automaticamente tramite il nostro wizard di onboarding e non hanno bisogno di essere usati manualmente.

Cart Back to top

Utilizzato nella pagina del carrello, lo shortcode del carrello visualizza il contenuto del carrello e l’interfaccia per i codici dei coupon e altri pezzi del carrello.

Args: none

Checkout Back to top

Usato nella pagina del checkout, lo shortcode del checkout mostra il processo di checkout.

Args: none

My Account Back to top

Mostra la sezione ‘my account’ dove il cliente può vedere gli ordini passati e aggiornare le sue informazioni. Puoi specificare il numero di ordini da mostrare. Per impostazione predefinita, è impostato su 15 (usa -1 per visualizzare tutti gli ordini.)

Args:

array( 'current_user' => '' )

Formulario di monitoraggio dell’ordine Torna all’inizio

Consente all’utente di vedere lo stato di un ordine inserendo i dettagli del suo ordine.

Argini: nessuno

Prodotti Torna all’inizio

Lo shortcode è uno dei nostri shortcode più robusti, che può sostituire varie altre stringhe usate nelle versioni precedenti di WooCommerce.

Lo shortcode consente di visualizzare i prodotti per ID post, SKU, categorie, attributi, con supporto per la paginazione, l’ordinamento casuale e i tag di prodotto, sostituendo la necessità di più shortcode come , , , , e , che sono necessari nelle versioni di WooCommerce inferiori alla 3.2. Esaminate gli esempi qui sotto.

Attributi di prodotto disponibili Torna all’inizio

I seguenti attributi sono disponibili da usare in combinazione con lo shortcode . Sono stati divisi in sezioni per funzione primaria per facilitare la navigazione, con esempi qui sotto.

Visualizza gli attributi dei prodotti

• limit – Il numero di prodotti da visualizzare. Il valore predefinito è e -1 (visualizza tutto) quando si elencano i prodotti, e -1 (visualizza tutto) per le categorie.
• columns – Il numero di colonne da visualizzare. Il valore predefinito è 4.
• paginate – Attiva la paginazione. Da usare insieme a limit. Predefinito a false impostato su true per impaginare .
• orderby – Ordina i prodotti visualizzati in base all’opzione inserita. Una o più opzioni possono essere passate aggiungendo entrambi gli slug con uno spazio tra loro. Le opzioni disponibili sono:
  • date – La data di pubblicazione del prodotto.
  • id – Il post ID del prodotto.
  • menu_order – L’ordine del menu, se impostato (i numeri inferiori vengono visualizzati per primi).
  • popularity – Il numero di acquisti.
  • rand – Ordina casualmente i prodotti al caricamento della pagina (potrebbe non funzionare con siti che usano la cache, in quanto potrebbe salvare un ordine specifico).
  • rating – La valutazione media del prodotto.
  • title – Il titolo del prodotto. Questo è il modo predefinito orderby.
• skus – Elenco separato da virgole di SKU del prodotto.
• category – Elenco separato da virgole di slug di categoria.
• tag – Elenco separato da virgole di slug di tag.
• order – Dichiara se l’ordine del prodotto è crescente (ASC) o decrescente (DESC), usando il metodo impostato in orderby. Il valore predefinito è ASC.
• class – Aggiunge una classe wrapper HTML in modo da poter modificare l’output specifico con CSS personalizzato.
• on_sale – Recupera i prodotti in vendita. Da non usare in combinazione con best_sellingo top_rated.
• best_selling – Recupera i prodotti più venduti. Da non usare in combinazione con on_sale o top_rated.
• top_rated – Recupera i prodotti più venduti. Da non usare insieme a on_sale o best_selling.

Contenuto Attributi prodotto

• attribute – Recupera i prodotti utilizzando lo slug di attributo specificato.
• terms – Elenco separato da virgole di termini di attributo da usare con attribute.
• terms_operator – Operatore per confrontare i termini di attributo. Le opzioni disponibili sono:
  • AND – Visualizza i prodotti di tutti gli attributi scelti.
  • IN – Visualizza i prodotti con l’attributo scelto. Questo è il valore predefinito terms_operator.
  • NOT IN – Mostrerà i prodotti che non sono negli attributi scelti.
• tag_operator – Operatore per confrontare i tag. Le opzioni disponibili sono:
  • AND – Visualizza i prodotti di tutti i tag scelti.
  • IN – Visualizza i prodotti con i tag scelti. Questo è il valore predefinito tag_operator.
  • NOT IN – Mostrerà i prodotti che non sono nei tag scelti.
• visibility – Mostrerà i prodotti in base alla visibilità selezionata. Le opzioni disponibili sono:
  • visible – Prodotti visibili nel negozio e nei risultati di ricerca. Questa è l’opzione predefinita visibility.
  • catalog – Prodotti visibili solo nel negozio, ma non nei risultati di ricerca.
  • search – Prodotti visibili solo nei risultati di ricerca, ma non nel negozio.
  • hidden – Prodotti che sono nascosti sia dal negozio che dalla ricerca, accessibili solo tramite URL diretto.
  • featured – Prodotti che sono contrassegnati come Prodotti in vetrina.

• category – Recupera i prodotti utilizzando lo slug di categoria specificato.
• tag – Recupera i prodotti utilizzando lo slug di tag specificato.
• cat_operator – Operatore per confrontare i termini di categoria. Le opzioni disponibili sono:
  • AND – Visualizza i prodotti che appartengono a tutte le categorie scelte.
  • IN – Visualizza i prodotti della categoria scelta. Questo è il valore predefinito cat_operator.
  • NOT IN – Mostrerà i prodotti che non sono nella categoria scelta.

• ids – Mostrerà i prodotti basati su una lista separata da virgole di Post IDs.
• skus – Visualizzerà i prodotti basati su un elenco separato da virgole di SKUs.

Se il prodotto non viene mostrato, assicurati che non sia impostato su “Nascosto” in “Visibilità catalogo”.

Attributi speciali del prodotto

Questi attributi non possono essere usati con gli “Attributi di contenuto” elencati sopra, in quanto potrebbero causare un conflitto e non essere visualizzati. Dovresti usare solo uno dei seguenti attributi speciali.

• best_selling – Visualizza i tuoi prodotti più venduti. Deve essere impostato su true.
• on_sale – Visualizza i tuoi prodotti in vendita. Deve essere impostato su true.

Esempi di scenari di prodotti Torna all’inizio

Nei seguenti scenari, useremo un esempio di negozio di abbigliamento.

Scenario 1 – Articoli casuali in vendita

Voglio visualizzare quattro prodotti casuali in vendita.

Questo shortcode dichiara esplicitamente quattro prodotti con quattro colonne (che saranno una riga), mostrando gli articoli più popolari in vendita. Aggiunge anche una classe CSS quick-sale, che posso modificare nel mio tema.

Scenario 2 – Prodotti in vetrina

Voglio mostrare i miei prodotti in vetrina, due per riga, con un massimo di quattro articoli.

Questo shortcode dice che fino a quattro prodotti saranno caricati in due colonne, e che devono essere in vetrina. Sebbene non sia esplicitamente dichiarato, usa i default come l’ordinamento per titolo (dalla A alla Z).

Scenario 3 – Prodotti più venduti

Voglio visualizzare i miei tre prodotti più venduti in una riga.

Scenario 4 – Prodotti più nuovi

Voglio visualizzare prima i prodotti più nuovi – quattro prodotti su una riga. Per fare questo, useremo il Post ID (che viene generato quando la pagina del prodotto viene creata), insieme al comando order e orderby. Poiché non puoi vedere l’ID del post dal frontend, i numeri ID sono stati sovrapposti alle immagini.

Scenario 5 – Categorie specifiche

Voglio visualizzare solo felpe e camicie, ma non gli accessori. Userò due righe di quattro.

In alternativa, voglio visualizzare solo i prodotti non appartenenti a queste categorie. Tutto quello che devo cambiare è il cat_operator in NOT IN.

Nota che anche se il limite è impostato su 8, ci sono solo quattro prodotti che corrispondono a quel criterio, quindi vengono visualizzati quattro prodotti.

Scenario 6 – Visualizzazione degli attributi

Ogni articolo di abbigliamento ha un attributo, o “Primavera/Estate” o “Autunno/Inverno” a seconda della stagione appropriata, con alcuni accessori che li hanno entrambi poiché possono essere indossati tutto l’anno. In questo esempio, voglio tre prodotti per riga, visualizzando tutti gli articoli “Primavera/Estate”. Lo slug dell’attributo è season, e gli attributi sono warm e cold. Voglio anche che siano ordinati dai prodotti più nuovi a quelli più vecchi.

In alternativa, se volessi visualizzare esclusivamente i prodotti del freddo, potrei aggiungere NOT IN come mio terms_operator:

Nota che usando NOT IN, escludo i prodotti che sono sia in “Primavera/Estate” che “Autunno/Inverno”. Se volessi mostrare tutti i prodotti adatti al freddo, compresi questi accessori condivisi, cambierei il termine da warm a cold.

Scenario 7 – Mostra solo i prodotti con il tag “hoodie”

Ordinamento dei prodotti per meta campi personalizzati Torna all’inizio

Quando usi lo shortcode Products, puoi scegliere di ordinare i prodotti secondo i valori predefiniti sopra. Puoi anche ordinare i prodotti per campi meta personalizzati usando il codice qui sotto (in questo esempio ordiniamo i prodotti per prezzo):

add_filter( 'woocommerce_shortcode_products_query', 'woocommerce_shortcode_products_orderby' );function woocommerce_shortcode_products_orderby( $args ) { $standard_array = array('menu_order','title','date','rand','id'); if( isset( $args ) && !in_array( $args, $standard_array ) ) { $args = $args; $args = 'meta_value_num'; } return $args;}

Devi mettere questo snippet in functions.php nella cartella del tuo tema e poi personalizzarlo modificando la meta_key.

Product Category Back to top

Questi due shortcodes mostreranno le tue categorie di prodotti su qualsiasi pagina.

• – Mostrerà i prodotti in una categoria di prodotto specificata.
• – Mostrerà tutte le tue categorie di prodotto.

Attributi disponibili per le categorie di prodotto Torna in cima

• ids – Specifica gli id delle categorie specifiche da elencare. Da usare in
• category – Può essere l’id della categoria, il nome o lo slug. Da usare in
• limit – Il numero di categorie da visualizzare
• columns – Il numero di colonne da visualizzare. Il valore predefinito è 4
• hide_empty – Il valore predefinito è “1” che nasconderà le categorie vuote. Imposta a “0” per mostrare le categorie vuote
• parent – Imposta su uno specifico ID di categoria se vuoi visualizzare tutte le categorie figlio. In alternativa, imposta a “0” (come nell’esempio qui sotto) per mostrare solo le categorie di livello superiore.
• orderby – L’impostazione predefinita è di ordinare per “nome”, può essere impostata su “id”, “slug”, o “menu_order”. Se vuoi ordinare in base agli id che hai specificato, allora puoi usare orderby="include"
• order – Dichiara se l’ordine delle categorie è ascendente (ASC) o discendente (DESC), usando il metodo impostato in orderby. Di default a ASC.

Esempi di scenari di categorie di prodotti Torna all’inizio

Scenario 8 – Mostra solo le categorie di livello superiore

Immagina di voler mostrare solo le categorie di livello superiore su una pagina ed escludere le sottocategorie, beh è possibile con il seguente shortcode.

Pagina del prodotto Torna all’inizio

Mostra una pagina completa del singolo prodotto per ID o SKU.

Prodotti correlati Torna all’inizio

Elenco prodotti correlati.

Args:

array( 'limit' => '12', 'columns' => '4', 'orderby' => 'title' )

limit Argument Back to top

Add to Cart Back to top

Mostra il prezzo e il pulsante di aggiunta al carrello di un singolo prodotto per ID.

Args:

array( 'id' => '99', 'style' => 'border:4px solid #ccc; padding: 12px;', 'sku' => 'FOO' 'show_price' => 'TRUE' 'class' => 'CSS-CLASS' 'quantity' => '1'; )

Add to Cart URL Back to top

Mostra l’URL sul pulsante di aggiunta al carrello di un singolo prodotto per ID.

Args:

array( 'id' => '99', 'sku' => 'FOO' )

Visualizza le notifiche di WooCommerce su pagine che non sono WooCommerce Back to top

ti permette di mostrare le notifiche di WooCommerce (come, ‘Il prodotto è stato aggiunto al carrello’) su pagine non di WooCommerce. Utile quando usi altri codici brevi, come , e vuoi che gli utenti ricevano un feedback sulle loro azioni.

Risoluzione dei problemi degli shortcodes Torna su

Se hai incollato correttamente i tuoi shortcodes e la visualizzazione non è corretta, assicurati di non aver incorporato lo shortcode tra i tag <pre>. Questo è un problema comune. Per rimuovere questi tag, modifica la pagina e clicca sulla scheda Testo:

Un altro problema comune è che le virgolette dritte (") vengono visualizzate come virgolette arricciate ("). Affinché i codici brevi funzionino correttamente, hai bisogno di virgolette dritte.