ShopiPress 1.0.0 · 09
Référencer les 27 shortcodes publics
Utiliser le catalogue exact shopipress_*, regroupé par responsabilités produit, collection et filtrage.
S’applique à ShopiPress 1.0.0, officiellement publié sur Freemius.
Parcours vérifié
- Commencez par le shortcode de produit ou de collection complet si le rendu composé convient.
- Utilisez les codes granulaires seulement dans un contexte qui fournit le produit ou la collection requis.
- Validez la page rendue et le passage vers Shopify avant publication.
Ce guide s’applique à la version de ShopiPress indiquée dans l’en-tête, officiellement publiée sur Freemius. Confirmez la version installée avant d’appliquer la procédure. Les versions ultérieures peuvent modifier les écrans, les valeurs par défaut ou les frontières de services.
Résultat attendu
Utiliser le catalogue exact shopipress_*, regroupé par responsabilités produit, collection et filtrage.
Utilisez le registre public complet de 27 entrées ci-dessous comme une surface d’API liée à la version. Chaque entrée consigne sa syntaxe minimale, ses attributs et valeurs par défaut, son contexte requis, sa sortie et sa limite connue. WordPress transmet les attributs comme chaînes avant que le renderer normalise les valeurs prises en charge.
Avant de commencer
- Commencez par le shortcode de produit ou de collection complet si le rendu composé convient.
- Utilisez les codes granulaires seulement dans un contexte qui fournit le produit ou la collection requis.
- Validez la page rendue et le passage vers Shopify avant publication.
Portée et limites actuelles
Gardez le modèle de responsabilité visible pendant toute la tâche : Shopify reste la source commerciale et le système de paiement; ShopiPress connecte, synchronise et rend le catalogue selon les contrats livrés; WordPress gère le contexte de publication. Un résultat WordPress réussi ne signifie pas un transfert des commandes, clients, paiements ou de l’autorité d’inventaire.
Utilisez le registre public complet de 27 entrées ci-dessous comme une surface d’API liée à la version. Chaque entrée consigne sa syntaxe minimale, ses attributs et valeurs par défaut, son contexte requis, sa sortie et sa limite connue. WordPress transmet les attributs comme chaînes avant que le renderer normalise les valeurs prises en charge.
Procédure
- Commencez par le shortcode de produit ou de collection complet si le rendu composé convient. Consultez l’inventaire complet lié à la version rendu ci-dessous et testez le plus petit exemple représentatif avant de le réutiliser.
- Utilisez les codes granulaires seulement dans un contexte qui fournit le produit ou la collection requis. Consultez l’inventaire complet lié à la version rendu ci-dessous et testez le plus petit exemple représentatif avant de le réutiliser.
- Validez la page rendue et le passage vers Shopify avant publication. Consultez l’inventaire complet lié à la version rendu ci-dessous et testez le plus petit exemple représentatif avant de le réutiliser.
Vérifier le résultat
Vérifiez le résultat dans la page WordPress rendue et dans la surface Shopify d’autorité, pas seulement dans l’administration ShopiPress. Utilisez un produit représentatif avec prix, disponibilité, variante et collection. Répétez la plus petite opération sûre lorsque l’idempotence importe et consignez toute différence avant d’élargir le test.
- Confirmez le nom exact ou l’identifiant stable.
- Comparez le contexte déclaré à la page rendue.
- Testez les états de données vides, longues et indisponibles.
- Comparez les sorties Gutenberg, shortcode, Elementor et WPBakery seulement lorsque la matrice de couverture déclare un composant.
Erreurs fréquentes
- Ne déduisez aucun attribut, contrôle de bloc ni composant de constructeur à partir d’un nom similaire.
- Ne comptez pas les composants propres aux constructeurs parmi les shortcodes publics.
- Ne décrivez pas une couverture conceptuelle comme une parité de contrôles, de balisage ou de comportement.
Dépannage
- Reconfirmez la version et l’édition du paquet installé.
- Réduisez le problème à un composant, une fiche de catalogue connue et une URL WordPress.
- Comparez le nom exact, l’identifiant stable, le contexte et la sortie avec l’inventaire lié à la version ci-dessous.
- Déterminez si la responsabilité en échec appartient à Shopify, ShopiPress ou WordPress.
- Conservez la réponse rendue et les réglages avant toute modification, puis répétez une fois le plus petit test sûr.
Sécurité et données
Consignez la version installée, l’édition, les versions WordPress et PHP, le constructeur ou l’intégration SEO active, l’URL exacte, le viewport et les actions ordonnées qui produisent le résultat. Capturez seulement des données contrôlées. Masquez le jeton Storefront, les données clientes, commandes, domaines privés et secrets avant qu’un artefact quitte l’espace de validation.
Conséquences SEO
Les composants de référence peuvent modifier les titres, liens, données produit et contrôles interactifs. Examinez la sémantique rendue, l’accessibilité, le comportement canonique et le transfert d’achat vers Shopify sur une page représentative.
Preuves à consigner
Consignez la version installée, l’édition, les versions WordPress et PHP, le constructeur ou l’intégration SEO active, l’URL exacte, le viewport et les actions ordonnées qui produisent le résultat. Capturez seulement des données contrôlées. Masquez le jeton Storefront, les données clientes, commandes, domaines privés et secrets avant qu’un artefact quitte l’espace de validation.
Guides connexes
Version et état du produit
ShopiPress est officiellement publié sur Freemius. Ce guide décrit la version documentée. Les liens d’achat et de téléchargement seront ajoutés au site lorsque leurs destinations seront configurées.
Surface produit
Les attributs de codes courts arrivent comme chaînes WordPress, puis le renderer les normalise. Les valeurs ci-dessous proviennent du commit plugin exact; elles ne prouvent pas une parité de contrôles entre constructeurs.
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.
Surface collection
Les attributs de codes courts arrivent comme chaînes WordPress, puis le renderer les normalise. Les valeurs ci-dessous proviennent du commit plugin exact; elles ne prouvent pas une parité de contrôles entre constructeurs.
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.
Recherche et filtres
Les attributs de codes courts arrivent comme chaînes WordPress, puis le renderer les normalise. Les valeurs ci-dessous proviennent du commit plugin exact; elles ne prouvent pas une parité de contrôles entre constructeurs.
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.
Conserver la frontière système visible
Shopify reste la source commerciale; ShopiPress transporte les fiches et les contrats de rendu; WordPress gère la publication.
Shopify · catalogue source et paiement
ShopiPress · synchronisation manuelle et rendu
WordPress · contenu, modèles et surface SEO
Vérifier avant de poursuivre
- Confirmez le résultat dans WordPress, pas seulement dans l’interface ShopiPress.
- Gardez le panier et le paiement sur Shopify.
- Notez la version installée lorsque vous signalez un défaut.