Fy2Press 1.0.0 · 09

Référencer les 27 shortcodes publics

Utiliser le catalogue exact fy2press_*, regroupé par responsabilités produit, collection et filtrage.

Documentation de Fy2Press 1.0.0. Le plugin gratuit est disponible sur WordPress.org. La version PRO est vendue séparément via Freemius, notre prestataire de licences et de paiement.

En trois étapes

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 décrit Fy2Press 1.0.0. Les écrans peuvent changer dans les versions ultérieures : vérifiez la version affichée sur l’écran Extensions avant de le suivre.

Résultat attendu

Utiliser le catalogue exact fy2press_*, 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.

Ce que couvre ce guide

Retenez qui fait quoi : Shopify conserve les produits, les stocks, les commandes, les paiements et le passage à la caisse ; Fy2Press intègre le catalogue à WordPress et l’affiche ; WordPress héberge vos pages et vos contenus éditoriaux. Rien dans ce guide ne transfère les commandes, les clients ou les paiements vers WordPress.

Étapes

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 là où vos visiteurs le verront : ouvrez la page WordPress publique, et pas seulement l’écran de Fy2Press, puis comparez un produit représentatif avec Shopify, notamment son prix, sa disponibilité, ses variantes et sa collection. Refaites une fois une petite modification pour confirmer que le comportement est stable.

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.

Problèmes fréquents

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, Fy2Press 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

Si vous demandez de l’aide, notez la version du plugin, les versions de WordPress et de PHP, votre thème ou constructeur de pages, l’adresse de la page et les étapes suivies. Utilisez des produits de test et retirez des captures d’écran les jetons, les données clients, les détails de commande et les adresses privées avant de les partager.

Effet sur le référencement

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.

Informations pour l’assistance

Guides connexes

Version et disponibilité

Documentation de Fy2Press 1.0.0. Le plugin gratuit est disponible sur WordPress.org. La version PRO est vendue séparément via Freemius, notre prestataire de licences et de paiement.

Pour aller plus loin : Construire avec les blocs et les codes courts (FR-CA)

Surface produit

Les attributs de codes courts arrivent comme chaînes WordPress, puis le renderer les normalise. Les valeurs ci-dessous proviennent du code source de Fy2Press pour la version présentée ; elles ne prouvent pas une parité de contrôles entre constructeurs.

fy2press_product: [fy2press_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.
fy2press_product_title: [fy2press_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.
fy2press_product_description: [fy2press_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.
fy2press_product_price: [fy2press_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.
fy2press_product_image: [fy2press_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.
fy2press_product_url: [fy2press_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.
fy2press_product_vendor: [fy2press_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.
fy2press_product_type: [fy2press_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.
fy2press_product_tags: [fy2press_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.
fy2press_product_gallery: [fy2press_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 built-in Fy2Press defaults. Output: main image and optional thumbnails.
fy2press_product_availability: [fy2press_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.
fy2press_product_variants: [fy2press_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; built-in class and option_class defaults; hide_default_variant=true. Output: selectable variant controls; default-title variants can be hidden.
fy2press_product_collections: [fy2press_product_collections]Role: product collection links. Context: product with shopipress_collections terms. Attributes/defaults: style=links (links|badges); separator=comma-space; limit=0; built-in class and collection_class defaults; prefix and suffix=empty; title=Collections:; wrapper=div; built-in wrapper_class; hide_if_empty=true. Output: linked collection terms.
fy2press_add_to_cart: [fy2press_add_to_cart]Role: Shopify cart action. Context: resolved product and purchasable variant. Public attributes: none; the shortcode uses the built-in 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.
fy2press_buy_now: [fy2press_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.
fy2press_related_products: [fy2press_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 version shown.

Surface collection

fy2press_collection: [fy2press_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.
fy2press_products_loop: [fy2press_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.
fy2press_collection_title: [fy2press_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.
fy2press_collection_description: [fy2press_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.
fy2press_collection_sort: [fy2press_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

fy2press_product_search: [fy2press_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 built-in 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.
fy2press_collection_filter: [fy2press_collection_filter type="dropdown"]Role: collection filter. Context: product loop or collection navigation. Attributes/defaults: type=dropdown (dropdown|checkbox|list); show_count=yes; built-in 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).
fy2press_tag_filter: [fy2press_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; built-in 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.
fy2press_filter_sidebar: [fy2press_filter_sidebar]…[/shopipress_filter_sidebar]Role: filter composition wrapper. Context: encloses other Fy2Press 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.
fy2press_price_filter: [fy2press_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.
fy2press_availability_filter: [fy2press_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; Fy2Press transporte les fiches et les contrats de rendu; WordPress gère la publication.

Shopify · catalogue source et paiement

Fy2Press · 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 Fy2Press.
Gardez le panier et le paiement sur Shopify.
Notez la version installée lorsque vous signalez un défaut.