ShopiPress 1.0.0 · 09
Referencia de los 27 shortcodes públicos
Usa el catálogo público exacto shopipress_*, agrupado por responsabilidad de producto, colección y filtrado.
Se aplica a ShopiPress 1.0.0, publicado oficialmente en Freemius.
Flujo verificado
- Empieza por el shortcode completo si basta la composición predeterminada.
- Usa piezas granulares solo con el contexto requerido.
- Valida la página y el paso a Shopify antes de publicar.
Esta guía se aplica a la versión de ShopiPress indicada en la cabecera de la página, publicada oficialmente en Freemius. Confirma la versión instalada antes de aplicar el procedimiento. Las versiones posteriores pueden cambiar pantallas, valores por defecto o fronteras de servicio.
Resultado esperado
Usa el catálogo público exacto shopipress_*, agrupado por responsabilidad de producto, colección y filtrado.
Usa el registro público completo de 27 entradas que aparece abajo como una superficie de API ligada a la versión. Cada entrada recoge su sintaxis mínima, sus atributos y valores por defecto, el contexto requerido, la salida y el límite conocido. WordPress pasa los atributos de shortcode como cadenas antes de que el renderizador normalice los valores admitidos.
Antes de empezar
- Empieza por el shortcode completo si basta la composición predeterminada.
- Usa piezas granulares solo con el contexto requerido.
- Valida la página y el paso a Shopify antes de publicar.
Alcance y límites actuales
Mantén visible el modelo de responsabilidad durante toda la tarea: Shopify sigue siendo la fuente comercial y el sistema de pago; ShopiPress conecta, sincroniza y renderiza el catálogo según los contratos entregados; WordPress es el contexto de publicación. Un resultado correcto en WordPress no debe interpretarse como una transferencia de pedidos, clientes, pagos o autoridad sobre el inventario.
Usa el registro público completo de 27 entradas que aparece abajo como una superficie de API ligada a la versión. Cada entrada recoge su sintaxis mínima, sus atributos y valores por defecto, el contexto requerido, la salida y el límite conocido. WordPress pasa los atributos de shortcode como cadenas antes de que el renderizador normalice los valores admitidos.
Procedimiento
- Empieza por el shortcode completo si basta la composición predeterminada. Consulta el inventario completo ligado a la versión que aparece abajo y prueba el ejemplo representativo más pequeño antes de reutilizarlo.
- Usa piezas granulares solo con el contexto requerido. Consulta el inventario completo ligado a la versión que aparece abajo y prueba el ejemplo representativo más pequeño antes de reutilizarlo.
- Valida la página y el paso a Shopify antes de publicar. Consulta el inventario completo ligado a la versión que aparece abajo y prueba el ejemplo representativo más pequeño antes de reutilizarlo.
Verificar el resultado
Verifica el resultado en la página WordPress renderizada y en la superficie autorizada de Shopify, no solo dentro de la pantalla de administración de ShopiPress. Usa un producto representativo con datos de precio, disponibilidad, variante y colección. Repite la operación segura más pequeña cuando la idempotencia importe y registra cualquier diferencia antes de ampliar la prueba.
- Confirma el nombre exacto o el identificador estable.
- Compara el contexto declarado con la página renderizada.
- Prueba los estados de datos vacíos, largos y no disponibles.
- Compara las salidas de Gutenberg, shortcode, Elementor y WPBakery solo donde la matriz de cobertura declare un componente.
Errores frecuentes
- No deduzcas un atributo, un control de bloque o un componente de constructor a partir de un nombre parecido.
- No cuentes los componentes exclusivos de constructores entre los shortcodes públicos.
- No describas una cobertura conceptual como paridad de controles, de marcado o de comportamiento.
Resolución de problemas
- Reconfirma la versión y la edición del paquete instalado.
- Reduce el problema a un componente, un registro de catálogo conocido y una URL de WordPress.
- Compara el nombre exacto, el identificador estable, el contexto y la salida con el inventario ligado a la versión que aparece abajo.
- Identifica si la responsabilidad que falla corresponde a Shopify, ShopiPress o WordPress.
- Conserva la respuesta renderizada y los ajustes antes de cambiar la configuración, y luego repite una vez la prueba segura más pequeña.
Seguridad y datos
Registra la versión instalada, la edición, las versiones de WordPress y PHP, el constructor o la integración SEO activa, la URL exacta, el viewport y las acciones ordenadas que produjeron el resultado. Captura únicamente datos de catálogo controlados. Oculta el token Storefront, los datos de clientes, la información de pedidos, los dominios privados y cualquier secreto de entorno antes de que un artefacto salga del espacio de validación.
Consecuencias SEO
Los componentes de referencia pueden cambiar encabezados, enlaces, datos de producto y controles interactivos. Inspecciona la semántica renderizada, la accesibilidad, el comportamiento canónico y el traspaso de compra a Shopify en una página representativa.
Evidencia que registrar
Registra la versión instalada, la edición, las versiones de WordPress y PHP, el constructor o la integración SEO activa, la URL exacta, el viewport y las acciones ordenadas que produjeron el resultado. Captura únicamente datos de catálogo controlados. Oculta el token Storefront, los datos de clientes, la información de pedidos, los dominios privados y cualquier secreto de entorno antes de que un artefacto salga del espacio de validación.
Guías relacionadas
Versión y estado del producto
ShopiPress está publicado oficialmente en Freemius. Esta guía describe la versión documentada. Los enlaces de compra y descarga se añadirán a este sitio cuando sus destinos estén configurados.
Superficie de producto
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 de colección
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.
Búsqueda y filtros
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.
Mantén visible la frontera
Shopify gestiona el comercio, ShopiPress transporta el catálogo y WordPress publica.
Shopify · catálogo y pago
ShopiPress · sincronización y renderizado
WordPress · contenido, plantillas y SEO
Verifica antes de continuar
- Confirma el resultado en WordPress.
- Mantén carrito y pago en Shopify.
- Registra la versión al informar un error.