Sono disponibili shortcode sia per WC Vendors Marketplace che per WC Vendors Pro. Alcuni di questi shortcode sono necessari affinché i nostri plugin funzionino, mentre altri sono disponibili per l'uso sul tuo marketplace se li richiedi.

Prima di iniziare

Questi shortcode funzionano subito dopo l'attivazione di WC Vendors Marketplace (e, ove indicato, WC Vendors Pro). Non è necessario configurare nient'altro in anticipo, ma gli esempi di ciascuno shortcode di seguito utilizzano VENDOR-LOGIN-NAME come segnaposto per il nome utente di un vero venditore, quindi tienilo a portata di mano prima di aggiungere uno shortcode a una pagina o a un post.

Shortcode di WC Vendors Marketplace

I seguenti shortcode sono necessari per il funzionamento di WC Vendors Marketplace. Quando attivi il plugin ed esegui la procedura guidata di configurazione, verranno create anche le pagine richieste. Se non vengono create, dovrai creare le pagine, assegnare gli shortcode e quindi configurare le pagine nelle impostazioni di WC Vendors.

Shortcode richiesti per WC Vendors

I seguenti shortcode sono necessari per garantire il funzionamento di WC Vendors Marketplace. Non inserire questi shortcode in nessun'altra pagina, comprese le pagine di WooCommerce.

Pagina della dashboard del venditore

Mostra la dashboard del venditore sul frontend.

[wcv_vendor_dashboard]

Shortcode generali

Venduto da

Questo è uno shortcode che può essere utilizzato nel tuo tema o nel tuo tema builder per spostare la posizione in cui viene visualizzato "venduto da" nella pagina del singolo prodotto.

[wcv_sold_by]

Altri shortcode

L'elenco seguente di shortcode ti consente di personalizzare l'aspetto del tuo sito e si basa sugli shortcode di WooCommerce con la stessa funzionalità, con l'aggiunta del filtraggio per venditore. Dove è indicato VENDOR-LOGIN-NAME, sostituiscilo con il nome utente del venditore che desideri visualizzare.

Prodotti Recenti

Per mostrare i prodotti recenti di un venditore specifico, puoi utilizzare il seguente shortcode. Le opzioni disponibili includono le seguenti:

• vendor – il venditore di cui desideri visualizzare i prodotti recenti
• per_page – il numero di prodotti per pagina. Il valore predefinito è 12.
• category – imposta su yes per mostrare le categorie di ciascun prodotto sotto il suo titolo. Il valore predefinito è no.
• category_separator – il testo utilizzato tra i nomi delle categorie quando un prodotto ne ha più di uno. Il valore predefinito è ", ".

[wcv_recent_products vendor="VENDOR-LOGIN-NAME" per_page=3 category="yes"]

Prodotti Venditore

Per mostrare tutti i prodotti di un venditore specifico, ad esempio in un post del blog, puoi utilizzare il seguente shortcode. Le opzioni disponibili includono i seguenti parametri.

• vendor – il venditore di cui desideri visualizzare i prodotti
• columns – quanti colonne di prodotti visualizzare per riga. Il valore predefinito è 4.
• orderby – il campo in base al quale ordinare i prodotti. Il valore predefinito è title.
• order – la direzione dell'ordinamento, asc o desc. Il valore predefinito è asc.
• limit – il numero di prodotti da mostrare. Lascia vuoto per mostrare tutti i prodotti del venditore.
• category – imposta su yes per mostrare le categorie di ciascun prodotto sotto il suo titolo. Il valore predefinito è no.
• category_separator – il testo utilizzato tra i nomi delle categorie quando un prodotto ne ha più di uno. Il valore predefinito è ", ".

Ecco un esempio che mostra i prodotti di un venditore in 3 colonne, i più recenti prima, con le categorie visualizzate sotto il titolo di ciascun prodotto. orderby accetta solo campi di query standard di WordPress (title, date, ID, rand, menu_order), non il prezzo del prodotto.

[wcv_products vendor="VENDOR-LOGIN-NAME" columns="3" orderby="date" order="desc" category="yes"]

Shortcode Prodotti in Evidenza

Se hai abilitato i prodotti in primo piano per i tuoi venditori, il seguente shortcode ti consentirà di visualizzare i prodotti in primo piano per un venditore specifico. Le opzioni disponibili includono le seguenti

• vendor – il venditore di cui desideri visualizzare i prodotti in primo piano
• category – imposta su yes per mostrare le categorie di ciascun prodotto sotto il suo titolo. Il valore predefinito è no.
• category_separator – il testo utilizzato tra i nomi delle categorie quando un prodotto ne ha più di uno. Il valore predefinito è ", ".

[wcv_featured_products vendor="VENDOR-LOGIN-NAME" category="yes"]

Prodotti in Saldo

Se desideri mostrare i prodotti in saldo per un venditore specifico, ad esempio in una notizia o promozione, utilizza il seguente shortcode. Le opzioni disponibili includono le seguenti:

• vendor – il venditore di cui desideri visualizzare i prodotti in saldo
• category – imposta su yes per mostrare le categorie di ciascun prodotto sotto il suo titolo. Il valore predefinito è no.
• category_separator – il testo utilizzato tra i nomi delle categorie quando un prodotto ne ha più di uno. Il valore predefinito è ", ".

[wcv_sale_products vendor="VENDOR-LOGIN-NAME" category="yes"]

Prodotti più Votati in Saldo

Se desideri mostrare i prodotti con le migliori valutazioni per un venditore utilizzando il sistema di recensioni integrato di WooCommerce, utilizza il seguente shortcode. Le opzioni disponibili includono i seguenti parametri.

• vendor – il venditore di cui desideri visualizzare i prodotti con le migliori valutazioni
• category – imposta su yes per mostrare le categorie di ciascun prodotto sotto il suo titolo. Il valore predefinito è no.
• category_separator – il testo utilizzato tra i nomi delle categorie quando un prodotto ne ha più di uno. Il valore predefinito è ", ".

[wcv_top_rated_products vendor="VENDOR-LOGIN-NAME" category="yes"]

Prodotti più venduti in offerta

Per mostrare un elenco dei prodotti in vendita più venduti per un fornitore specifico, puoi utilizzare il seguente shortcode. Le opzioni disponibili includono i seguenti parametri.

• vendor – il fornitore di cui vuoi visualizzare i prodotti in vendita più venduti
• category – imposta su yes per mostrare le categorie di ciascun prodotto sotto il suo titolo. Il valore predefinito è no.
• category_separator – il testo utilizzato tra i nomi delle categorie quando un prodotto ne ha più di uno. Il valore predefinito è ", ".

[wcv_best_selling_products vendor="VENDOR-LOGIN-NAME" category="yes"]

Categoria Prodotto e Venditore

Se vuoi mostrare i prodotti di un fornitore in una categoria specifica, puoi utilizzare il seguente shortcode. Le opzioni disponibili includono i seguenti parametri.

• vendor – il fornitore di cui vuoi visualizzare i prodotti
• category – lo slug della categoria che vorresti visualizzare

[wcv_product_category category="category-slug" vendor="VENDOR-LOGIN-NAME"]

Directory dei fornitori

Se desideri mostrare una pagina con tutti i tuoi fornitori, puoi utilizzare il seguente shortcode. Questo può anche essere personalizzato con il modello vendors-list.php che si trova nella seguente posizione.

• /templates/front/vendor-list.php

Questo verrebbe sovrascritto copiandolo nella cartella del tuo tema nella posizione appropriata.

Le opzioni disponibili includono le seguenti

• order by – l'ordinamento con cui desideri visualizzare i fornitori. L'elenco completo delle opzioni di ordinamento è disponibile nel Codex di WordPress.org. L'impostazione predefinita è 'registered'.
• order – l'ordinamento con cui desideri che i fornitori vengano visualizzati, può essere ascendente (ASC) o discendente (DESC). Ascendente (ASC) è l'impostazione predefinita.
• per_page – quanti fornitori per pagina, questo dovrebbe essere un numero. L'impostazione predefinita è 12 fornitori da visualizzare.
• has_products – sì mostrerà i fornitori che hanno prodotti pubblicati. Se imposti questo su no, includerai i fornitori senza prodotti pubblicati. L'impostazione predefinita è sì

[wcv_vendorslist orderby="registered" order="ASC" per_page="12" has_products="yes"]

Nota: Se i fornitori non hanno impostato il nome del loro negozio, non appariranno nei risultati di ricerca, anche se imposti has_products su "no".

Shortcode WC Vendors Pro

Gli shortcode seguenti sono necessari per il funzionamento di WC Vendors Pro. Le pagine per gli shortcode dovrebbero essere state create e impostate al momento dell'installazione e dell'attivazione di WC Vendors Pro e dell'esecuzione della procedura guidata di configurazione. Se hai bisogno di questi shortcode di nuovo per qualsiasi motivo, sono i seguenti.

Shortcode richiesti per WC Vendors Pro

Dashboard Pro

La dashboard di WC Vendors Pro è una pagina completamente nuova che introduce un'interfaccia front-end completa per i tuoi venditori. Questa pagina deve essere impostata oltre alla pagina della dashboard del venditore di WC Vendors. Questo è lo shortcode per questa pagina.

[wcv_pro_dashboard]

Pagina Valutazioni

In WC Vendors Pro, esiste un sistema di valutazione dei fornitori che consente ai clienti di valutare i prodotti dei fornitori dando loro una valutazione a stelle e fornendo un commento. Se hai abilitato questo, dovrai anche configurare la pagina e lo shortcode correlati. Questa pagina dovrebbe essere una sottopagina della pagina WooCommerce > Il mio account, quindi aggiungi lo shortcode qui sotto

[wcv_feedback_form]

Navigazione dashboard Pro

Dalla versione 1.3.3 di WC Vendors Pro, è disponibile un nuovo shortcode che ti consente di inserire la barra di navigazione della dashboard su altre pagine. Questo è utile se hai aggiunto pagine personalizzate alla navigazione e hai bisogno di garantire che la tua interfaccia sia coerente ovunque. Per abilitare la navigazione su un'altra pagina, usa questo shortcode.

[wcv_pro_dashboard_nav]

Se desideri visualizzare le stelle di valutazione del fornitore con un link alla pagina delle valutazioni del negozio del fornitore. Questo accetta un argomento, che è il vendor_id a cui desideri collegarti. L'ID del fornitore è anche il tuo ID utente.

[wcv_feedback vendor="VENDORID"]

Directory dei fornitori (Pro)

Se desideri mostrare una pagina con tutti i tuoi venditori, puoi utilizzare il seguente shortcode. Questo può anche essere personalizzato con il modello pro-vendors-list.php che si trova nella seguente posizione.

• /templates/front/pro-vendors-list.php

Questo verrebbe sovrascritto copiandolo nella cartella del tuo tema nella posizione appropriata.

Le opzioni disponibili includono le seguenti

• orderby – l'ordine in cui desideri visualizzare i venditori. L'elenco completo delle opzioni di ordinamento è disponibile nel Codex di WordPress.org. L'impostazione predefinita è 'registered'.
• order – l'ordinamento con cui desideri che i fornitori vengano visualizzati, può essere ascendente (ASC) o discendente (DESC). Ascendente (ASC) è l'impostazione predefinita.
• per_page – quanti fornitori per pagina, questo dovrebbe essere un numero. L'impostazione predefinita è 12 fornitori da visualizzare.
• has_products – sì mostrerà i fornitori che hanno prodotti pubblicati. Se imposti questo su no, includerai i fornitori senza prodotti pubblicati. L'impostazione predefinita è sì

Nota: I venditori devono aver impostato tutte le informazioni del loro negozio per essere visualizzati nella directory. Se non hanno impostato il nome del negozio o altre informazioni, verranno esclusi dall'elenco.

[wcv_pro_vendorslist orderby="registered" order="ASC" per_page="12" has_products="yes" ]

Dettagli Venditore

Questo shortcode è stato introdotto in WC Vendors Pro versione 1.7.5

Se desideri recuperare i dettagli di un particolare venditore, puoi utilizzare il seguente shortcode.

Se conosci l'ID utente dei venditori, puoi usare vendor_id per determinare il venditore.

[wcv_vendor vendor_id="VENDORUSERID" vendor_detail="DETAIL" ]

Se conosci il nome utente del venditore, puoi usarlo per identificarlo.

[wcv_vendor username="VENDORUSERNAME" vendor_detail="DETAIL"]

Se lo shortcode viene utilizzato in una pagina del negozio del venditore (singola o storefront), il venditore viene rilevato automaticamente.

I seguenti dettagli del venditore sono disponibili per l'uso

• store_name – Il nome del negozio del venditore
• paypal_address – L'indirizzo email Paypal del venditore
• seller_info – Le informazioni del venditore
• store_description – La descrizione del negozio del venditore
• store_banner_id – L'ID del post del banner del negozio del venditore
• store_banner_url – L'URL del banner del negozio del venditore
• store_icon_id – L'ID del post dell'icona del negozio del venditore
• store_icon_url – L'URL dell'icona del negozio del venditore
• address1 – L'indirizzo1 del negozio del venditore
• latitude – La latitudine dell'indirizzo del venditore
• longitude – La longitudine dell'indirizzo del venditore
• city – La città dell'indirizzo del venditore
• state – Lo stato dell'indirizzo del venditore
• country – Il paese dell'indirizzo del venditore
• postcode – Il CAP/codice postale dell'indirizzo del venditore
• company_url – L'URL dell'azienda dell'indirizzo del venditore
• sold_by – Il link 'venduto da' del venditore
• view_store – Il link per il venditore per visualizzare il proprio negozio
• ratings_stars – Le stelle di valutazione del venditore (nessun link)
• ratings_link – Le stelle di valutazione del venditore con link
• social_icons – Le icone dei social media del venditore con link

Per riassumere, dovrai sostituire la sezione Details con uno degli attributi disponibili come visto nell'esempio seguente se conosci l'ID del venditore.

[wcv_vendor vendor_id="4" vendor_detail="store_name,store_phone,store_description"]

Tuttavia, puoi anche utilizzare il seguente shortcode se conosci il nome utente del venditore,

[wcv_vendor username="awesome_vendor" vendor_detail="store_name,store_phone,store_description"]

Ora, se stai chiamando lo shortcode, ad esempio, in una pagina di singolo prodotto o nella loro vetrina/pagina negozio, puoi semplicemente aggiungere lo shortcode qui sotto.

[wcv_vendor vendor_detail="store_name,store_phone,store_description"]

Risoluzione dei problemi

Le categorie non vengono visualizzate dopo aver aggiunto category="yes"

Se aggiungi category="yes" a uno shortcode di elenco prodotti e non appare nulla, verifica che i prodotti mostrati siano effettivamente assegnati a una categoria di WooCommerce. Lo shortcode visualizza solo le categorie che un prodotto ha già, non le crea o le assegna.

Se il tuo tema utilizza un template di loop dei prodotti pesantemente personalizzato, anche le categorie potrebbero non apparire perché il template salta l'hook standard di WooCommerce woocommerce_shop_loop_item_title su cui questi shortcode si basano per inserire l'elenco delle categorie. Passare temporaneamente a un tema WooCommerce predefinito può aiutare a confermare se questa è la causa.

Domande frequenti

Quali shortcode supportano l'opzione di visualizzazione delle categorie?
Prodotti Recenti, Prodotti del Venditore, Shortcode Prodotti in Evidenza, Prodotti in Saldo, Prodotti in Saldo con Valutazione Più Alta e Prodotti in Saldo Più Venduti supportano tutti gli attributi category e category_separator con lo stesso comportamento e impostazioni predefinite.

Come funziona category_separator se un prodotto ha più di una categoria?
Imposta category_separator su qualsiasi testo che desideri appaia tra i nomi delle categorie, ad esempio category_separator=" | ". Ha un effetto visibile solo quando un prodotto appartiene a due o più categorie, poiché una singola categoria non ha nulla da separare.

Serve aiuto?

• Utenti Premium: Apri un ticket di supporto
• Utenti Gratuiti: Visita il nostro forum della community