ShopiPress 1.0.0 · 09

Riferimento dei 27 shortcode pubblici

Usa il catalogo pubblico esatto shopipress_*, raggruppato per responsabilità di prodotto, collezione e filtro.

Si applica a ShopiPress 1.0.0, pubblicato ufficialmente su Freemius.

Flusso verificato

Inizia dallo shortcode completo se basta la composizione predefinita.
Usa elementi granulari solo nel contesto richiesto.
Verifica pagina e passaggio a Shopify prima di pubblicare.

Questa guida si applica alla versione di ShopiPress indicata nell’intestazione della pagina, pubblicata ufficialmente su Freemius. Conferma la versione installata prima di applicare la procedura. Le versioni successive possono modificare schermate, valori predefiniti o confini di servizio.

Risultato atteso

Usa il catalogo pubblico esatto shopipress_*, raggruppato per responsabilità di prodotto, collezione e filtro.

Usa il registro pubblico completo di 27 voci riportato più sotto come superficie API legata alla versione. Ogni voce registra sintassi minima, attributi e valori predefiniti, contesto richiesto, output e limite noto. WordPress passa gli attributi degli shortcode come stringhe prima che il renderer normalizzi i valori supportati.

Prima di iniziare

Inizia dallo shortcode completo se basta la composizione predefinita.
Usa elementi granulari solo nel contesto richiesto.
Verifica pagina e passaggio a Shopify prima di pubblicare.

Ambito e limiti attuali

Mantieni visibile il modello di responsabilità per tutta l’attività: Shopify resta la fonte commerciale e il sistema di pagamento; ShopiPress collega, sincronizza e renderizza il catalogo secondo i contratti consegnati; WordPress possiede il contesto di pubblicazione. Un risultato corretto in WordPress non va interpretato come un trasferimento di ordini, clienti, pagamenti o autorità sull’inventario.

Procedura

Inizia dallo shortcode completo se basta la composizione predefinita. Consulta l’inventario completo legato alla versione riportato più sotto e prova l’esempio rappresentativo più piccolo prima di riutilizzarlo.
Usa elementi granulari solo nel contesto richiesto. Consulta l’inventario completo legato alla versione riportato più sotto e prova l’esempio rappresentativo più piccolo prima di riutilizzarlo.
Verifica pagina e passaggio a Shopify prima di pubblicare. Consulta l’inventario completo legato alla versione riportato più sotto e prova l’esempio rappresentativo più piccolo prima di riutilizzarlo.

Verificare il risultato

Verifica il risultato nella pagina WordPress renderizzata e nella superficie autorevole di Shopify, non solo nella schermata di amministrazione di ShopiPress. Usa un prodotto rappresentativo con dati di prezzo, disponibilità, variante e collezione. Ripeti l’operazione sicura più piccola quando l’idempotenza conta e registra ogni differenza prima di ampliare il test.

Conferma il nome esatto o l’identificatore stabile.
Confronta il contesto dichiarato con la pagina renderizzata.
Prova gli stati di dati vuoti, lunghi e non disponibili.
Confronta gli output di Gutenberg, shortcode, Elementor e WPBakery solo dove la matrice di copertura dichiara un componente.

Errori comuni

Non dedurre un attributo, un controllo di blocco o un componente di builder da un nome simile.
Non contare i componenti esclusivi dei builder tra gli shortcode pubblici.
Non descrivere una copertura concettuale come parità di controlli, di markup o di comportamento.

Risoluzione dei problemi

Riconferma la versione e l’edizione del pacchetto installato.
Riduci il problema a un componente, un record di catalogo noto e un URL WordPress.
Confronta nome esatto, identificatore stabile, contesto e output con l’inventario legato alla versione riportato più sotto.
Individua se la responsabilità fallita appartiene a Shopify, ShopiPress o WordPress.
Conserva la risposta renderizzata e le impostazioni prima di modificare la configurazione, poi ripeti una volta il test sicuro più piccolo.

Sicurezza e dati

Registra la versione installata, l’edizione, le versioni di WordPress e PHP, il builder o l’integrazione SEO attiva, l’URL esatto, il viewport e le azioni ordinate che hanno prodotto il risultato. Cattura soltanto dati di catalogo controllati. Oscura il token Storefront, i dati dei clienti, le informazioni sugli ordini, i domini privati e ogni segreto d’ambiente prima che un artefatto lasci lo spazio di validazione.

Conseguenze SEO

I componenti di riferimento possono modificare intestazioni, collegamenti, dati di prodotto e controlli interattivi. Esamina su una pagina rappresentativa la semantica renderizzata, l’accessibilità, il comportamento canonico e il passaggio d’acquisto verso Shopify.

Prove da registrare

Guide correlate

Versione e stato del prodotto

ShopiPress è pubblicato ufficialmente su Freemius. Questa guida descrive la versione documentata. I collegamenti di acquisto e download saranno aggiunti a questo sito quando le loro destinazioni saranno configurate.

Superficie prodotto

Shortcode attributes arrive as WordPress strings and are normalized by the renderer. The values below come from the exact plugin commit; they do not prove control parity across builders.

shopipress_product: [shopipress_product id="123"]Role: complete product composition. Context: a published shopipress_product, or resolve with id or handle. Attributes/defaults: id=empty; handle=empty; show_description=yes; show_collections=yes; show_tags=no; class=empty. Output: product media, title, price and the available product controls. Returns an empty string when no published product resolves.
shopipress_product_title: [shopipress_product_title]Role: product title. Context: product page or builder preview. Attributes/defaults: fallback=Product Title Placeholder; show_fallback_in_editor=yes; tag=h1; font_size, font_weight, color, text_align, margin, padding and css_class=empty. Output: escaped title in the validated text container.
shopipress_product_description: [shopipress_product_description content_type="excerpt"]Role: product description. Context: singular product; otherwise the preview fallback. Attributes/defaults: content_type=full (full|excerpt|custom); word_limit=150; tag=div; fallback=empty; font_size=empty; font_weight=400; color, text_align, line_height, margin_top, margin_bottom, padding, css_class and css_id=empty; debug=false. Output: allowed product HTML passed through WordPress formatting.
shopipress_product_price: [shopipress_product_price type="range"]Role: product price. Context: singular product or preview fallback. Attributes/defaults: type=single (single|range|from); currency=symbol (symbol|code|none); fallback=$29.99; tag=div; font_size, font_weight, color, text_align, margin, padding and css_class=empty; show_compare=no; compare_color=#9ca3af; show_sale_badge=no; badge_color=#ef4444; badge_text_color=#ffffff; badge_text=On Sale. Output: formatted minimum, range or from-price, with optional comparison and sale badge.
shopipress_product_image: [shopipress_product_image link_to="product"]Role: featured product image. Context: singular product or editor preview. Attributes/defaults: size=large; width, height, object_fit and align=empty; link_to=none (none|full_image|product|custom); custom_url=empty; target_blank=empty; border_radius, border, box_shadow, margin, css_class, css_id and alt_text=empty. Output: responsive image markup with an optional validated link.
shopipress_product_url: [shopipress_product_url]Role: Shopify product URL. Context: synchronized product with a valid Shopify handle and configured store. Attributes/defaults: format=url (url|link); text=View on Shopify; target=_blank; class=shopipress-product-url shopipress-d-product-url. Output: escaped URL text or link; empty when the source URL cannot be resolved.
shopipress_product_vendor: [shopipress_product_vendor]Role: product vendor. Context: product data. Attributes/defaults: class=shopipress-product-vendor shopipress-d-product-vendor; prefix=empty; suffix=empty. Output: escaped vendor label or empty string.
shopipress_product_type: [shopipress_product_type]Role: Shopify product type. Context: product data. Attributes/defaults: class=shopipress-product-type shopipress-d-product-type; prefix=empty; suffix=empty. Output: escaped product-type label or empty string.
shopipress_product_tags: [shopipress_product_tags]Role: synchronized product-tag links. Context: product post with shopipress_tags terms. Attributes/defaults: separator=comma-space; limit=0; class=shopipress-product-tags shopipress-d-product-tags; tag_class=shopipress-product-tag shopipress-d-product-tag; style=links (links|badges); prefix=empty; suffix=empty; title=Tags:; wrapper=div; wrapper_class=shopipress-tags-section shopipress-d-tags-section; hide_if_empty=true. Output: linked terms.
shopipress_product_gallery: [shopipress_product_gallery]Role: product gallery. Context: synchronized product media. Attributes/defaults: show=all (all|featured); layout=gallery (gallery|slider); thumbs=bottom (bottom|right|none); size=large (medium|large|original); columns=4; class, main_class and thumb_class use the delivered ShopiPress defaults. Output: main image and optional thumbnails.
shopipress_product_availability: [shopipress_product_availability]Role: availability status. Context: product inventory data. Attributes/defaults: show=status (status|quantity|both); format=text (text|badge); in_stock_text=In Stock; out_of_stock_text=Out of Stock; low_stock_text=Low Stock; low_stock_threshold=5; show_quantity=false; class=shopipress-product-availability shopipress-d-product-availability. Output: status and optionally quantity.
shopipress_product_variants: [shopipress_product_variants]Role: variant selector. Context: product with synchronized variants. Attributes/defaults: style=dropdown (dropdown|buttons|grid); show_prices=false; show_images=false; show_labels=true; delivered class and option_class defaults; hide_default_variant=true. Output: selectable variant controls; default-title variants can be hidden.
shopipress_product_collections: [shopipress_product_collections]Role: product collection links. Context: product with shopipress_collections terms. Attributes/defaults: style=links (links|badges); separator=comma-space; limit=0; delivered class and collection_class defaults; prefix and suffix=empty; title=Collections:; wrapper=div; delivered wrapper_class; hide_if_empty=true. Output: linked collection terms.
shopipress_add_to_cart: [shopipress_add_to_cart]Role: Shopify cart action. Context: resolved product and purchasable variant. Public attributes: none; the shortcode uses the delivered product-design schema. Output: quantity and add-to-cart contract when available; the safe missing-variant action can direct the visitor to view the product. Checkout remains on Shopify.
shopipress_buy_now: [shopipress_buy_now]Role: direct Shopify buying action. Context: resolved product and variant. Attributes/defaults: text=Buy Now; class=shopipress-buy-now-btn shopipress-d-buy-now-btn; target=_blank. Output: escaped buying link that hands commerce back to Shopify.
shopipress_related_products: [shopipress_related_products limit="4"]Role: related product list. Context: a product resolved by current page or id. Attributes/defaults: id=empty; limit=4; title=You may also like; orderby=date; class=empty. Output: a bounded related-product composition; no dedicated builder component exists in the exact candidate.

Superficie collezione

Shortcode attributes arrive as WordPress strings and are normalized by the renderer. The values below come from the exact plugin commit; they do not prove control parity across builders.

shopipress_collection: [shopipress_collection handle="collection-handle"]Role: complete collection composition. Context: collection resolved by id, handle or collection archive. Attributes/defaults: id=empty; handle=empty; limit=24; columns=4; show_title=yes; show_description=yes; pagination=infinite; class=empty. Output: collection heading and product loop, or empty when no collection resolves.
shopipress_products_loop: [shopipress_products_loop collection="collection-handle" limit="12" columns="3"]Role: product grid. Context: any page, optionally filtered to a collection. Attributes/defaults: limit=24; columns=4; collection=empty; class=shopipress-d-products-loop; item_class=shopipress-product-card; pagination=infinite; sort_by=empty. Supported sort mappings include price, title and created-date directions. Output: paginated or infinite catalog cards using local synchronized records and reviewed Storefront data paths.
shopipress_collection_title: [shopipress_collection_title]Role: collection title. Context: collection archive or resolved term. Attributes/defaults: tag=h1; class=shopipress-collection-title shopipress-d-collection-title; prefix=empty; suffix=empty. Output: escaped collection title.
shopipress_collection_description: [shopipress_collection_description]Role: collection description. Context: collection archive or resolved term. Attributes/defaults: class=shopipress-collection-description shopipress-d-collection-description; wrapper=div; hide_if_empty=true. Output: allowed description HTML or nothing when empty.
shopipress_collection_sort: [shopipress_collection_sort]Role: product sort control. Context: a product loop that reads the same public query state. Attributes/defaults: class=shopipress-collection-sort; label=Sort by:; show_label=true; default_option=Sort by...; wrapper=div; wrapper_class=shopipress-sort-wrapper shopipress-d-collection-sort. Output: sort selector preserving compatible query parameters.

Ricerca e filtri

Shortcode attributes arrive as WordPress strings and are normalized by the renderer. The values below come from the exact plugin commit; they do not prove control parity across builders.

shopipress_product_search: [shopipress_product_search]Role: local product-title search control. Context: paired with the products loop. Attributes/defaults: placeholder=Search products...; class, wrapper_class, input_class and button_class use delivered defaults; button_text=Search; show_results_count=yes; search_in=title,description,tags. Current local search implementation is title-only; do not infer full-field parity from the attribute label.
shopipress_collection_filter: [shopipress_collection_filter type="dropdown"]Role: collection filter. Context: product loop or collection navigation. Attributes/defaults: type=dropdown (dropdown|checkbox|list); show_count=yes; delivered class and wrapper_class; title=Collection; show_title=yes; show_all_option=yes; all_text=All Collections; limit=0; orderby=name (name|count|slug); order=ASC; hide_empty=yes; hierarchical=yes; behavior=collection_archive (collection_archive|query).
shopipress_tag_filter: [shopipress_tag_filter type="tags"]Role: product-tag filter. Context: product loop reading tag_filter. Attributes/defaults: saved type, with checkbox, tags, buttons, dropdown, list and cloud render paths; show_count=yes; delivered class and wrapper_class; title=Filter by Tags; show_title=yes; show_all_option=yes; all_text=All Tags; limit=10; orderby=count; order=DESC; hide_empty=yes; multiple=yes; style=badges; max_display=20.
shopipress_filter_sidebar: [shopipress_filter_sidebar]…[/shopipress_filter_sidebar]Role: filter composition wrapper. Context: encloses other ShopiPress filter shortcodes. Attributes/defaults: class=shopipress-filter-sidebar; wrapper_class=filter-sidebar-wrapper; title=Filter Products; show_title=yes; style=sidebar (sidebar|horizontal|accordion); background=#f8f9fa; padding=20px; border_radius=8px; gap=20px. Output: grouped filters and a clear-all action when compatible filters are active.
shopipress_price_filter: [shopipress_price_filter min="0" max="250"]Role: price filter. Context: product loop reading price_min and price_max. Attributes/defaults: min=0; max=1000; default_min=0; default_max=250; step=10; currency=auto; title=Filter by Price. Values are bounded and normalized by the product loop before Storefront requests.
shopipress_availability_filter: [shopipress_availability_filter type="checkbox"]Role: availability filter. Context: product loop reading availability_filter. Attributes/defaults: type comes from the saved display setting; supported paths are checkbox, buttons and dropdown, with radio retained for compatibility; options=in_stock,out_of_stock; title=Availability; show_count=yes; class=availability-filter-container. Output: public query controls.

Mantieni visibile il confine

Shopify gestisce il commercio, ShopiPress trasporta il catalogo e WordPress pubblica.

Shopify · catalogo e checkout

ShopiPress · sincronizzazione e rendering

WordPress · contenuti, template e SEO

Verifica prima di continuare

Conferma il risultato in WordPress.
Lascia carrello e checkout su Shopify.
Annota la versione quando segnali un difetto.