Saltar al contenido principal
Los agentes de IA obtienen la misma referencia desde el MCP de temas: la herramienta get_reference (tema app_blocks) y el recurso papelship://reference/app-blocks. El editor de código, validate y save_draft advierten sobre bloques desconocidos, argumentos desconocidos o con un tipo incorrecto, y bloques que un tipo de tema no admite. Bloques de la plataforma ({% app_block %} / data-app-block): argumentos, comportamiento, compatibilidad por tipo; bloques de página bloqueados.
sí*: funciona, con una nota a continuación. En las secciones de código y en los equivalentes extraídos, los bloques del carrito usan el panel del carrito de la plataforma, no el panel propio del tema React; la insignia del carrito del tema se mantiene sincronizada.

add_to_cart

Botón de agregar al carrito para un producto. Agrega al carrito compartido de la tienda y abre el panel del carrito. Si un producto tiene varias variantes y no hay ninguna elegida, el variant_picker que está a su lado lo pregunta; si no lo hay, se abre la página del producto.

buy_now

Botón de compra inmediata para un producto. mode: 'page' (por defecto) lleva al checkout de la plataforma solo con este producto (el carrito se conserva). mode: 'embed' abre la ventana emergente de checkout sobre la página (iframe de la plataforma; los datos de tarjeta nunca pasan por el tema) y recurre a la página cuando el widget no puede cargarse.

cart_count

Botón del carrito con el número de artículos (“Cart <n>”); su propio marcado conserva su aspecto y un hijo [data-ps-count] recibe el número. Al hacer clic se abre el panel del carrito. Sin argumentos.

cart_drawer

Configura el panel deslizante del carrito (líneas, cantidades, descuentos de campaña, barra de envío gratis, venta adicional, checkout). No renderiza nada en su lugar; el primer cart_drawer de la página define las opciones.

checkout_button

Botón de checkout para todo el carrito (deshabilitado mientras el carrito está vacío). mode: 'page' (por defecto) lleva a <store>/checkout; mode: 'embed' abre la ventana emergente de checkout; el carrito se vacía después del pago.

currency_selector

Selector de la moneda de visualización (oculto cuando hay menos de dos monedas). Guarda la moneda de visualización (el checkout siempre cobra en la moneda de la tienda) y emite papelship:currency-change. En las secciones de código y en los equivalentes, pase currencies: esas páginas solo conocen la moneda de la tienda.

language_selector

Selector del idioma de la tienda (oculto cuando la tienda tiene un solo idioma). Define la cookie de idioma y recarga la página. Argumento: label.

newsletter_form

Suscripción al boletín con una casilla de consentimiento explícito. Envía los datos al endpoint de leads de la plataforma; las vistas previas nunca suscriben. Argumentos: label, placeholder, button, consent_text.

powered_by

El crédito “Powered by PapelShip” (oculto en los planes que permiten ocultarlo). Solo para temas Liquid: las páginas de diseño y los pies de página de los temas React reciben el crédito de la plataforma automáticamente.

quick_view

Botón de vista rápida para un producto: abre un diálogo con imágenes, precio, variantes y agregar al carrito. Argumentos: product_id (obligatorio, alias product), label.

recently_viewed

Los productos vistos recientemente por el visitante (desde este navegador); no renderiza nada cuando la lista está vacía. Los productos se registran en las páginas de producto Liquid (las páginas de producto de los temas React no registran visitas). Argumentos: limit (4 por defecto, 1-20), heading.

reviews_widget

Reseñas publicadas: las del producto de la página en las páginas de producto o, si no, las de la tienda. No es compatible con las secciones de código ni con los equivalentes (esas páginas no incluyen datos de reseñas; use la sección de reseñas del tema React). Argumentos: heading, limit (5 por defecto, 1-50), write (true por defecto; false oculta el enlace para escribir una reseña).

variant_picker

Selector de variantes (grupos de opciones) para un producto. Los add_to_cart / buy_now del mismo producto en el contenedor común más cercano (o en un elemento data-ps-scope) usan la variante elegida; los textos data-ps de precio / precio de comparación / inventario la siguen. Argumento: product_id (obligatorio, alias product).

wishlist_button

Interruptor de favorito para un producto (un botón de corazón con aria-pressed). Se guarda en el navegador y se sincroniza con la cuenta del cliente cuando ha iniciado sesión. Argumento: product_id (ID numérico; los hash ID no se guardan en la cuenta).

Bloques de página bloqueados

Cada uno funciona una sola vez, en su propio archivo de reemplazo. Los paquetes de código de los temas React no tienen reemplazos de página.