get_reference (sujet app_blocks) et la ressource papelship://reference/app-blocks. L’éditeur de code, validate et save_draft signalent les blocs inconnus, les arguments inconnus ou mal typés, ainsi que les blocs qu’un type de thème ne prend pas en charge.
Blocs de la plateforme ({% app_block %} / data-app-block) : arguments, comportement, prise en charge par type ; blocs de page verrouillés.
oui* : fonctionne, avec une remarque ci-dessous. Dans les sections de code et les jumeaux extraits, les blocs de panier utilisent le tiroir du panier de la plateforme, et non le tiroir propre au thème React ; le badge du panier du thème reste synchronisé.
add_to_cart
Bouton d’ajout au panier pour un produit. Ajoute au panier partagé de la vitrine et ouvre le tiroir du panier. Pour un produit comportant plusieurs variantes sans choix effectué : le variant_picker situé à côté demande la variante, sinon la page produit s’ouvre.buy_now
Bouton d’achat immédiat pour un produit.mode: 'page' (par défaut) mène au paiement de la plateforme avec uniquement ce produit (le panier est conservé). mode: 'embed' ouvre la fenêtre de paiement par-dessus la page (iframe de la plateforme ; les données de carte ne transitent jamais par le thème) et bascule sur la page lorsque le widget ne peut pas se charger.
cart_count
Bouton du panier avec le nombre d’articles (“Cart<n>”) ; votre propre balisage conserve son apparence et un enfant [data-ps-count] reçoit le nombre. Un clic ouvre le tiroir du panier. Aucun argument.
cart_drawer
Configure le tiroir coulissant du panier (lignes, quantités, réductions de campagne, barre de livraison gratuite, vente additionnelle, paiement). N’affiche rien à son emplacement ; le premiercart_drawer de la page définit les options.
checkout_button
Bouton de paiement pour l’ensemble du panier (désactivé tant que le panier est vide).mode: 'page' (par défaut) mène à <store>/checkout ; mode: 'embed' ouvre la fenêtre de paiement ; le panier est vidé après le paiement.
currency_selector
Sélecteur de devise d’affichage (masqué s’il y a moins de deux devises). Enregistre la devise d’affichage (le paiement est toujours débité dans la devise de la boutique) et émetpapelship:currency-change. Dans les sections de code et les jumeaux, transmettez currencies : ces pages ne connaissent que la devise de la boutique.
language_selector
Sélecteur de langue de la boutique (masqué lorsque la boutique n’a qu’une seule langue). Définit le cookie de langue et recharge la page. Argument :label.
newsletter_form
Inscription à la newsletter avec une case de consentement explicite. Envoie les données au point de terminaison de prospects de la plateforme ; les aperçus n’inscrivent jamais personne. Arguments :label, placeholder, button, consent_text.
powered_by
La mention “Powered by PapelShip” (masquée sur les offres qui permettent de la masquer). Thèmes Liquid uniquement : les pages de design et les pieds de page des thèmes React reçoivent automatiquement la mention de la plateforme.quick_view
Bouton d’aperçu rapide pour un produit : ouvre une boîte de dialogue avec les images, le prix, les variantes et l’ajout au panier. Arguments :product_id (obligatoire, alias product), label.
recently_viewed
Les produits récemment consultés par le visiteur (dans ce navigateur) ; n’affiche rien lorsque la liste est vide. Les produits sont enregistrés sur les pages produit Liquid (les pages produit des thèmes React n’enregistrent pas les consultations). Arguments :limit (4 par défaut, de 1 à 20), heading.
reviews_widget
Avis publiés : ceux du produit de la page sur les pages produit, sinon ceux de la boutique. Non pris en charge dans les sections de code ni dans les jumeaux (ces pages ne contiennent pas de données d’avis ; utilisez la section d’avis du thème React). Arguments :heading, limit (5 par défaut, de 1 à 50), write (true par défaut ; false masque le lien pour rédiger un avis).
variant_picker
Sélecteur de variante (groupes de boutons radio) pour un produit. Les blocsadd_to_cart / buy_now du même produit dans le conteneur commun le plus proche (ou dans un élément data-ps-scope) utilisent la variante choisie ; les textes data-ps price / compare-price / stock la suivent. Argument : product_id (obligatoire, alias product).
wishlist_button
Bascule de favori pour un produit (un bouton en forme de cœur avecaria-pressed). Enregistré dans le navigateur et synchronisé avec le compte client lorsque celui-ci est connecté. Argument : product_id (identifiant numérique ; les hash ID ne sont pas enregistrés dans le compte).
Blocs de page verrouillés
Chacun ne fonctionne qu’une seule fois, dans son propre fichier de remplacement. Les paquets de code des thèmes React n’ont pas de remplacement de page.