1. Documentation /
  2. Shortcodes incluídos no WooCommerce

Shortcodes incluídos no WooCommerce

O WooCommerce tem vários shortcodes que podem ser usados ​​para inserir conteúdos em posts e páginas.

Como usar os shortcodes

↑ Back to top

Onde usar

↑ Back to top

Os shortcodes podem ser usados ​​em páginas e posts.

Se você estiver usando o editor de blocos, encontre o bloco do Shortcode:

Em seguida, cole o shortcode no bloco:

Se você estiver usando o editor clássico, cole o shortcode na página ou no post.

Args (ou Argumentos)

↑ Back to top

Vários dos shortcodes abaixo mencionarão “Args”. Estas são maneiras de tornar o shortcode mais específico. Por exemplo, adicionando id=”99″ ao shortcode [add_to_cart], criará um botão comprar para o produto com o ID 99.

Shortcodes de página

↑ Back to top

O WooCommerce não pode funcionar adequadamente sem que os três primeiros shortcodes estejam em algum lugar do seu site.

[woocommerce_cart] – exibe a página do carrinho
[woocommerce_checkout] – exibe a página de finalizar compra
[woocommerce_my_account] – exibe a página da conta do usuário
[woocommerce_order_tracking] – exibe o formulário de rastreamento do pedido

Na maioria dos casos, estes shortcodes serão automaticamente adicionados às páginas através do nosso assistente de integração e não precisam ser usados ​​manualmente.

Carrinho

↑ Back to top

Usado na página do carrinho, o shortcode do carrinho exibe o conteúdo do carrinho e a interface para os códigos de cupons e outros itens do carrinho.

Args: nenhum

[woocommerce_cart]

Finalizar compra

↑ Back to top

Usado na página de finalizar compra, o shortcode de finalizar compra exibe o processo de finalização de compra.

Args: nenhum

[woocommerce_checkout]

Minha conta

↑ Back to top

Exibe a seção “minha conta”, onde o cliente pode visualizar os pedidos anteriores e atualizar suas informações. Você pode especificar o número de pedidos a serem exibidos. Por padrão, é definido como 15 (use -1 para exibir todos os pedidos.)

Args:

array(
     'current_user' => ''
 )
[woocommerce_my_account]

O argumento do usuário atual é automaticamente definido usando get_user_by( 'id', get_current_user_id() ).

Formulário de rastreamento do pedido

↑ Back to top

Permite que um usuário visualize o status de um pedido, digitando os detalhes do pedido.

Args: nenhum

[woocommerce_order_tracking]

Produtos

↑ Back to top

Nota: Desde a versão 3.6, o WooCommerce básico inclui vários blocos de produtos. Eles são mais fáceis de configurar do que os shortcodes, portanto, caso você estiver usando o editor de blocos do WordPress, poderá obter mais informações sobre os Blocos do WooCommerce.

O shortcode [products] é um dos nossos shortcodes mais robustos, no qual pode substituir várias outras strings usadas nas versões anteriores do WooCommerce.

O shortcode [products] permite que você exiba produtos por ID dos posts, REF, categorias, atributos, com suporte para paginação, classificação aleatória e tags dos produtos, substituindo a necessidade de vários shortcodes, tais como [featured_products], [sale_products], [best_selling_products], [recent_products], [product_attribute] e [top_rated_products], que são necessários nas versões do WooCommerce anteriores a versão 3.2. Veja os exemplos abaixo.

Atributos de produtos disponíveis

↑ Back to top

Os seguintes atributos estão disponíveis para uso em conjunto com o shortcode [products]. Eles foram divididos em seções para a função principal com a finalidade de facilitar a navegação, conforme exemplos abaixo.

Atributos de exibição dos produtos

  • limit – O número de produtos a serem exibidos. O valor padrão é -1 (exibir todos) ao listar os produtos, e -1 (exibir todas) para as categorias.
  • columns – O número de colunas a serem exibidas. O padrão é 4.
  • paginate – Habilita a paginação. Use em conjunto com o limit. O padrão é false, definido como true para paginar.
  • orderby – Classifica os produtos exibidos pela opção inserida. Uma ou mais opções podem ser selecionadas adicionando ambos os slugs com um espaço entre eles. As opções disponíveis são:
    • date – A data em que o produto foi publicado.
    • id – O ID do post do produto.
    • menu_order – A ordem do menu, se definida (os números menores são exibidos primeiro).
    • popularity – O número de compras.
    • rand – Ordena aleatoriamente os produtos no carregamento da página (pode não funcionar com sites que usam cache, pois podem salvar uma ordem específica).
    • rating – A classificação média do produto.
    • title – O título do produto. Este é o modo padrão do orderby.
  • skus – Lista separada, por vírgula, de REFs dos produtos.
  • category – Lista, separada por vírgula, de slugs de categoria.
  • tag – Lista, separada por vírgula, de slugs de tag.
  • order – Define se a ordem do produto é crescente (ASC) ou decrescente (DESC), usando o método definido em orderby. O padrão é ASC.
  • class – Adiciona uma classe wrapper em HTML para que você possa modificar a saída específica com CSS personalizado.
  • on_sale – Exibe os produtos em promoção. Não deve ser usado em conjunto com best_selling ou top_rated.
  • best_selling – Exibe os produtos mais vendidos. Não deve ser usado em conjunto com on_sale ou top_rated.
  • top_rated – Exibe os produtos com a melhor classificação. Não deve ser usado em conjunto com on_sale ou best_selling.

Atributos de conteúdo dos produtos

  • attribute – Exibe os produtos usando o slug do atributo especificado.
  • terms – Lista, separada por vírgula, de termos do atributo a serem usados ​​com o attribute.
  • terms_operator – Operador para comparar os termos do atributo. As opções disponíveis são:
    • AND – Exibirá os produtos de todos os atributos escolhidos.
    • IN – Exibirá os produtos com o atributo escolhido. Este é o valor padrão para terms_operator.
    • NOT IN – Exibirá os produtos que não estão nos atributos escolhidos.
  • tag_operator – Operador para comparar as tags. As opções disponíveis são:
    • AND – Exibirá os produtos de todas as tags escolhidas.
    • IN – Exibirá os produtos com as tags escolhidas. Este é o valor padrão para tag_operator.
    • NOT IN – Exibirá os produtos que não estão nas tags escolhidas.
  • visibility – Exibirá os produtos com base na visibilidade selecionada. As opções disponíveis são:
    • visible – Produtos visíveis na loja e nos resultados de pesquisa. Esta é a opção padrão para visibility.
    • catalog – Produtos visíveis somente na loja, mas não são visíveis nos resultados de pesquisa.
    • search – Produtos visíveis somente nos resultados de pesquisa, mas não são visíveis na loja.
    • hidden – Produtos que estão ocultos na loja e na pesquisa, somente acessíveis diretamente pelo URL.
    • featured – Produtos que estão marcados como Produtos em destaque.
  • category – Exibe os produtos usando o slug da categoria especificada.
  • tag – Exibe os produtos usando o slug da tag especificada.
  • cat_operator – Operador para comparar os termos da categoria. As opções disponíveis são:
    • AND – Exibirá os produtos que pertencem a todas as categorias escolhidas.
    • IN – Exibirá os produtos dentro da categoria escolhida. Este é o valor padrão para o cat_operator.
    • NOT IN – Exibirá os produtos que não estão na categoria escolhida.
  • ids – Exibirá os produtos com base em uma lista, separada por vírgula, de IDs dos Posts.
  • skus – Exibirá os produtos com base em uma lista, separada por vírgula, de REFs.

Caso o produto não estiver sendo exibido, certifique-se de que ele não esteja definido como “Oculto” na “Visibilidade do catálogo”.

Para encontrar o ID do produto, vá para a tela Produtos, posicione o mouse sobre o produto e o ID aparecerá conforme mostrado abaixo.

Atributos especiais de produtos

Estes atributos não podem ser usados ​​com os “Atributos de conteúdo” listados acima, pois eles provavelmente causarão um conflito e não serão exibidos. Você deve usar somente um dos seguintes atributos especiais.

  • best_selling – Exibirá os seus produtos mais vendidos. Deve ser definido como true.
  • on_sale – Exibirá os seus produtos em promoção. Deve ser definido como true.

Exemplos de cenários de produtos

↑ Back to top

Nos seguintes cenários, usaremos um exemplo de loja de roupas.

Cenário 1 – Itens em promoção aleatórios

Quero exibir quatro produtos em promoção aleatórios.

[products limit="4" columns="4" orderby="popularity" class="quick-sale" on_sale="true" ]

Este shortcode define explicitamente quatro produtos com quatro colunas (ou seja, serão exibidos em uma linha), exibindo os itens em promoção mais populares. Ele também adiciona uma classe CSS quick-sale, na qual pode ser modificada com o tema.

Cenário 2 – Produtos em destaque

Quero exibir meus produtos em destaque, dois por linha, com no máximo quatro itens.

[products limit="4" columns="2" visibility="featured" ]

Este shortcode informa que até quatro produtos serão carregados em duas colunas e que eles devem ser produtos em destaques. Embora não seja definido explicitamente, ele usa os padrões, como a classificação por nome (A a Z).

Cenário 3 – Produtos mais vendidos

Quero exibir meus três produtos mais vendidos em uma linha.

[products limit="3" columns="3" best_selling="true" ]

Cenário 4 – Produtos mais novos

Quero exibir os produtos mais novos primeiro – quatro produtos em uma linha. Para realizar isso, usaremos o ID do post (que é gerado quando a página do produto é criada), juntamente com os comandos order e orderby. Uma vez que você não pode visualizar o ID do post no site, os nº dos IDs foram sobrepostos sobre as imagens.

[products limit="4" columns="4" orderby="id" order="DESC" visibility="visible"]

Cenário 5 – Categorias específicas

Eu quero exibir somente os moletons e camisetas, mas não quero exibir os acessórios. Usarei duas linhas de quatro.

[products limit="8" columns="4" category="moletons, camisetas" cat_operator="AND"]

Como outra opção, quero exibir somente os produtos que não estão nestas categorias. Para isso, você precisa alterar somente o cat_operator para NOT IN.

[products limit="8" columns="4" category="moletons, camisetas" cat_operator="NOT IN"]

Observe que, embora o limite esteja definido como 8, existem somente quatro produtos que atendem a esse critério, portanto, somente quatro produtos serão exibidos.

Cenário 6 – Exibição de atributos

Cada um dos itens de roupas tem um atributo, “Primavera/Verão” ou “Outono/Inverno” dependendo da estação apropriada, com alguns acessórios tendo ambas, pois podem ser usados ​​o ano todo. Neste exemplo, quero três produtos por linha, exibindo todos os itens “Primavera/Verão”. Este slug de atributo é estação, e os atributos são quente e fria. Também quero que eles sejam classificados dos produtos mais novos para os mais antigos.

[products columns="3" attribute="estação" terms="quente" orderby="date"]

Como outra opção, se quisesse exibir exclusivamente os produtos para clima frio, poderia adicionar NOT IN como terms_operator:

[products columns="3" attribute="estação" terms="quente" terms_operator="NOT IN"]

Observe que, ao usar NOT IN, são excluídos os produtos que são “Primavera/Verão” e “Outono/Inverno”. Se quisesse mostrar todos os itens apropriados para o clima frio, incluindo os produtos que compartilham os termos, deveria alterar o termo quente para fria.

Cenário 7 – Exibir somente os produtos com a tag “moletom”

[products tag="moletom"]

Classificação de produtos por metacampos personalizados

↑ Back to top

Nota: Não podemos fornecer suporte para personalizações de acordo com nossa Política de Suporte. Caso você não estiver familiarizado com o código/modelos e com a resolução de possíveis conflitos, entre em contato com um WooExpert.

Ao usar o shortcode de Produtos, você pode optar por ordenar os produtos pelos valores pré definidos acima. Você também pode classificar os produtos por metacampos personalizados, usando o código abaixo (neste exemplo, ordenamos os produtos por preço):

add_filter( 'woocommerce_shortcode_products_query', 'woocommerce_shortcode_products_orderby' );

function woocommerce_shortcode_products_orderby( $args ) {

    $standard_array = array('menu_order','title','date','rand','id');

    if( isset( $args['orderby'] ) && !in_array( $args['orderby'], $standard_array ) ) {
        $args['meta_key'] = $args['orderby'];
        $args['orderby']  = 'meta_value_num'; 
    }

    return $args;
}

Você precisa inserir este trecho em functions.php na pasta do seu tema e, em seguida, personalizá-lo editando a meta_key.

Categoria de produto

↑ Back to top

Estes dois shortcodes exibirão suas categorias de produtos em qualquer página.

  • [product_category] – Exibirá os produtos em uma categoria de produtos especificada.
  • [product_categories] – Exibirá todas as categorias de produtos.

Atributos de categoria de produtos disponíveis

↑ Back to top
  • ids – Especifica os IDs de categorias específicas a serem listadas
  • limit – O número de categorias a serem exibidas
  • columns – O número de colunas a serem exibidas. O padrão é 4
  • hide_empty – O padrão é “1”, para ocultar as categorias vazias. Defina como “0” para exibir as categorias vazias
  • parent – Defina um ID de categoria específica caso desejar exibir todas as categorias ascendentes
  • orderby – O padrão é ordenar por “nome”, pode ser definido por “id”, “slug”, ou “menu_order”. Caso deseje ordenar pelos IDs especificados, use orderby="include"
  • order – Define se a ordenação da categoria é crescente (ASC) ou decrescente (DESC), usando o método definido em orderby. O padrão é ASC.

Exemplos de cenários de categoria do produto

↑ Back to top

Cenário 8 – Exibir somente as categorias principais

Imagine que você deseja somente exibir as categorias principais em uma página e excluir as subcategorias, isto é possível com o seguinte shortcode.

[product_categories number="0" parent="0"]

Página do produto

↑ Back to top

Exibe uma página inteira com somente um produto, por ID ou REF.

[product_page id="99"]
[product_page sku=”FOO”]

Produtos relacionados

↑ Back to top

Lista os produtos relacionados.

Args:

array(
     'limit' => '12',
     'columns' => '4',
     'orderby' => 'title'
 )
[related_products limit=”12″]

Argumento limit

↑ Back to top

Nota: O argumento de shortcode ‘limit’ determinará quantos produtos serão exibidos em uma página. Isto não adicionará uma paginação ao shortcode.

Adicionar ao carrinho

↑ Back to top

Exibe o preço e o botão comprar de um único produto por ID.

Args:

array(
      'id' => '99',
      'style' => 'border:4px solid #ccc; padding: 12px;',
      'sku' => 'FOO'
      'show_price' => 'TRUE'
      'class' => 'CSS-CLASS'
      'quantity' => '1';
 )
[add_to_cart id="99"]

URL para adicionar ao carrinho

↑ Back to top

Exibe o URL no botão comprar de um único produto por ID.

Args:

array(
      'id' => '99',
      'sku' => 'FOO'
 )
[add_to_cart_url id="99"]

Exibir notificações do WooCommerce em páginas que não são do WooCommerce

↑ Back to top

[shop_messages] permite exibir notificações do WooCommerce (como, ‘O produto foi adicionado ao carrinho’) em páginas que não são do WooCommerce. Útil ao usar outros shortcodes, como [add_to_cart], e desejar que os usuários obtenham alguma resposta sobre suas ações.

Soluções para os shortcodes

↑ Back to top

Caso você colou corretamente seus shortcodes e a exibição parece incorreta, certifique-se de que não inseriu o shortcode entre as tags <pre>. Este é um problema comum. Para remover estas tags, edite a página e clique na guia Text:

Remove Pre Tags from Shortcode

Outro problema comum é que as aspas retas (") são exibidas como aspas inclinadas (). Para que os shortcodes funcionem corretamente, você precisa usar aspas retas.

WooCommerce

The most customizable eCommerce platform for building your online business.

  • 30-day money-back guarantee
  • Support teams across the world
  • Safe and secure online payment