ShopiPress.
Explorar

PT-BR

ShopiPress 1.0.0 · 09

Referência dos 27 shortcodes públicos

Use o catálogo público exato shopipress_*, agrupado por responsabilidade de produto, coleção e filtragem.

Aplica-se ao ShopiPress 1.0.0, publicado oficialmente no Freemius.

Fluxo verificado

  1. Comece pelo shortcode completo quando a composição padrão bastar.
  2. Use peças granulares apenas no contexto necessário.
  3. Valide a página e a passagem à Shopify antes de publicar.

Este guia se aplica à versão do ShopiPress indicada no cabeçalho da página, publicada oficialmente no Freemius. Confirme a versão instalada antes de aplicar o procedimento. Versões posteriores podem alterar telas, valores padrão ou fronteiras de serviço.

Resultado esperado

Use o catálogo público exato shopipress_*, agrupado por responsabilidade de produto, coleção e filtragem.

Use o registro público completo de 27 entradas apresentado abaixo como uma superfície de API vinculada à versão. Cada entrada registra sua sintaxe mínima, atributos e valores padrão, contexto exigido, saída e limite conhecido. O WordPress passa os atributos de shortcode como strings antes que o renderizador normalize os valores suportados.

Antes de começar

  • Comece pelo shortcode completo quando a composição padrão bastar.
  • Use peças granulares apenas no contexto necessário.
  • Valide a página e a passagem à Shopify antes de publicar.

Escopo e limites atuais

Mantenha o modelo de responsabilidade visível durante toda a tarefa: a Shopify continua sendo a fonte comercial e o sistema de pagamento; o ShopiPress conecta, sincroniza e renderiza o catálogo conforme os contratos entregues; o WordPress detém o contexto de publicação. Um resultado bem-sucedido no WordPress não deve ser interpretado como transferência de pedidos, clientes, pagamentos ou autoridade sobre o estoque.

Use o registro público completo de 27 entradas apresentado abaixo como uma superfície de API vinculada à versão. Cada entrada registra sua sintaxe mínima, atributos e valores padrão, contexto exigido, saída e limite conhecido. O WordPress passa os atributos de shortcode como strings antes que o renderizador normalize os valores suportados.

Procedimento

  1. Comece pelo shortcode completo quando a composição padrão bastar. Consulte o inventário completo vinculado à versão apresentado abaixo e teste o menor exemplo representativo antes de reutilizá-lo.
  2. Use peças granulares apenas no contexto necessário. Consulte o inventário completo vinculado à versão apresentado abaixo e teste o menor exemplo representativo antes de reutilizá-lo.
  3. Valide a página e a passagem à Shopify antes de publicar. Consulte o inventário completo vinculado à versão apresentado abaixo e teste o menor exemplo representativo antes de reutilizá-lo.

Verificar o resultado

Verifique o resultado na página WordPress renderizada e na superfície autoritativa da Shopify, não apenas na tela de administração do ShopiPress. Use um produto representativo com dados de preço, disponibilidade, variante e coleção. Repita a menor operação segura quando a idempotência importar e registre qualquer diferença antes de ampliar o teste.

  • Confirme o nome exato ou o identificador estável.
  • Compare o contexto declarado com a página renderizada.
  • Teste os estados de dados vazios, longos e indisponíveis.
  • Compare as saídas do Gutenberg, do shortcode, do Elementor e do WPBakery apenas onde a matriz de cobertura declarar um componente.

Erros frequentes

  • Não deduza um atributo, um controle de bloco ou um componente de construtor a partir de um nome parecido.
  • Não conte os componentes exclusivos de construtores entre os shortcodes públicos.
  • Não descreva uma cobertura conceitual como paridade de controles, de marcação ou de comportamento.

Solução de problemas

  1. Reconfirme a versão e a edição do pacote instalado.
  2. Reduza o problema a um componente, um registro de catálogo conhecido e uma URL do WordPress.
  3. Compare o nome exato, o identificador estável, o contexto e a saída com o inventário vinculado à versão apresentado abaixo.
  4. Identifique se a responsabilidade que falha é da Shopify, do ShopiPress ou do WordPress.
  5. Preserve a resposta renderizada e as configurações antes de alterar a configuração e, em seguida, repita uma vez o menor teste seguro.

Segurança e dados

Registre a versão instalada, a edição, as versões do WordPress e do PHP, o construtor ou a integração de SEO ativa, a URL exata, o viewport e as ações ordenadas que produziram o resultado. Capture apenas dados de catálogo controlados. Oculte o token Storefront, dados de clientes, informações de pedidos, domínios privados e qualquer segredo de ambiente antes que um artefato saia do espaço de validação.

Consequências de SEO

Componentes de referência podem alterar títulos, links, dados de produto e controles interativos. Em uma página representativa, inspecione a semântica renderizada, a acessibilidade, o comportamento canônico e a passagem da compra para a Shopify.

Evidências a registrar

Registre a versão instalada, a edição, as versões do WordPress e do PHP, o construtor ou a integração de SEO ativa, a URL exata, o viewport e as ações ordenadas que produziram o resultado. Capture apenas dados de catálogo controlados. Oculte o token Storefront, dados de clientes, informações de pedidos, domínios privados e qualquer segredo de ambiente antes que um artefato saia do espaço de validação.

Guias relacionados

Versão e estado do produto

O ShopiPress está publicado oficialmente no Freemius. Este guia descreve a versão documentada. Os links de compra e download serão adicionados a este site quando seus destinos estiverem configurados.

Superfície de produto

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.

Superfície de coleção

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.

Busca e 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.

Mantenha a fronteira visível

A Shopify controla o comércio, o ShopiPress transporta o catálogo e o WordPress publica.

Shopify · catálogo e checkout

ShopiPress · sincronização e renderização

WordPress · conteúdo, templates e SEO

Verifique antes de continuar

  • Confirme o resultado no WordPress.
  • Mantenha carrinho e checkout na Shopify.
  • Registre a versão ao relatar falhas.