Primeiros passos
Visão geral
O Definitivo Commerce Studio é um plugin gratuito para WordPress e WooCommerce. Ele acrescenta treze blocos ao editor de blocos, feitos para vender os produtos de uma loja, e landing pages inteiras montadas com eles.
O que todos os blocos têm em comum:
Desenhados pelo servidor
A página funciona sem JavaScript; o script de um bloco só melhora o que a página já faz.
Cores do seu tema
O bloco segue o tema até você escolher outras cores, e tem um esquema de cores claro e um escuro.
Conteúdo na barra lateral
Você escreve os textos, escolhe as fotos e define os estilos na barra lateral do editor. A área de edição mostra o bloco como o site vai desenhá-lo.
Um painel para cada elemento
O título, o texto, os botões e os demais elementos têm um painel próprio na aba Estilos, com cor, tamanho, alinhamento e arredondamento dos cantos.
Acessibilidade
Os blocos seguem a WCAG 2.2 como referência: funcionam pelo teclado, são lidos por leitores de tela e têm as cores padrão conferidas quanto ao contraste.
Primeiros passos
Requisitos
| Componente | Versão mínima |
|---|---|
| WordPress | 7.0 |
| WooCommerce | 11.0 |
| PHP | 7.4 |
O WooCommerce precisa estar ativo: sem ele o plugin não é ativado. O plugin é feito para temas de blocos e funciona com temas clássicos.
Primeiros passos
Instalação
- Instale e ative o WooCommerce.
- Em Plugins > Adicionar plugin, procure por “Definitivo Commerce Studio”, instale e ative. Também é possível enviar o arquivo ZIP em Plugins > Adicionar plugin > Enviar plugin.
- Abra uma página no editor de blocos.
A partir daí há duas formas de começar:
Uma landing page inteira
Clique no botão Definitivo Commerce Studio, na barra superior do editor, ou abra Commerce Studio > Landing pages no painel.
Um bloco
Abra o inseridor e procure a categoria Definitivo Commerce Studio.
Como usar
Landing pages
Uma landing page é uma página inteira para um produto, pronta para receber os seus textos e as suas fotos. O plugin vem com duas:
- Landing Page Clara
- Landing Page Escura
São a mesma página nos dois esquemas de cores: uma barra com links para as seções, o produto no topo, as fotos, a história, os detalhes, o produto ponto a ponto e ao lado dos concorrentes, o que os compradores dizem, as perguntas deles, mais produtos e um rodapé.
Criar uma página pelo painel
- Abra Commerce Studio > Landing pages.
- Escolha uma landing page. A prévia mostra a página com os produtos da sua loja, na largura de um computador, de um tablet ou de um telefone.
- Clique em Criar uma página com esta landing page.
- Escolha o produto da página, ou clique em Decidir depois.
Acrescentar uma landing page à página que você está editando
- Clique no botão Definitivo Commerce Studio, na barra superior do editor.
- Escolha uma landing page e clique em Usar esta landing page.
- Escolha o produto, ou clique em Decidir depois.
Depois de criar a página
- Troque os textos de exemplo. Todo texto de uma landing page é um exemplo que diz o que escrever no lugar. A nota média, o número de avaliações e os fatos sobre a loja vêm vazios ou como marcadores: escreva os verdadeiros antes de publicar.
- Escolha as fotos. O bloco que mostra uma foto e ainda não tem nenhuma desenha o lugar dela, no editor e no site. Escolha a foto na barra lateral, ou desligue a foto nos blocos que oferecem esse interruptor.
- Use um modelo de página sem cabeçalho e rodapé. A landing page tem a sua própria barra e o seu próprio rodapé. Escolha um modelo do tema que não tenha nenhum dos dois, para a página não mostrar tudo em dobro.
Como usar
Como trabalhar com os blocos
Conteúdo e estilos
Selecione um bloco para ver a barra lateral dele. Ela tem duas abas:
- Configurações: o conteúdo. Textos, fotos, listas, botões e o que o bloco mostra.
- Estilos: a aparência. O esquema de cores, as larguras, as cores e um painel para cada elemento.
Nos blocos de conteúdo escrito à mão, a área de edição é uma prévia: clique num elemento e a barra lateral abre o painel dele. A exceção é o bloco Pontos do Produto, em que os pontos também são arrastados sobre a foto.
Esquema de cores
Todo bloco tem dois esquemas, no primeiro painel da aba Estilos:
- Claro: o tema como ele é. É o padrão.
- Escuro: fundo escuro, texto claro e destaque claro.
O esquema muda todos os elementos que não têm cor própria. A cor que você escolher para o bloco ou para um elemento sempre prevalece.
Larguras e cantos
Todo bloco tem a largura do bloco e a largura do conteúdo:
- Largura do bloco: Largura total vai de uma borda da tela à outra. Card tem a largura que você definir, centralizado.
- Largura do conteúdo: a largura do conteúdo dentro do bloco. Começa em 1280 px e pode ficar sem limite.
- Arredondamento dos cantos: nenhum, pequeno (8 px), médio (16 px) ou grande (24 px). O card começa com cantos grandes. O bloco em largura total começa reto; escolha um arredondamento quando o bloco tiver margem nas laterais.
Cores
Uma cor pode ser uma da paleta do tema ou uma cor exata, pelo seletor de cores. As cores do bloco valem para todo elemento que não tem cor própria.
Imagem de fundo
O bloco pode ter uma foto atrás de tudo, com a parte da foto a manter à vista e uma cor sobre ela. Você escolhe a cor e a intensidade, para o texto continuar legível.
O lugar da foto
O bloco que mostra uma foto e ainda não tem nenhuma desenha um lugar para ela. O visitante vê o que foi publicado, então troque o lugar por uma foto, ou desligue a foto, antes de a página ir ao ar. Um bloco sem nada escrito não desenha lugar nenhum.
Blocos de produtos
Product Hero
O produto no topo da página: a foto, o nome, o preço, os botões de compra e o que dá confiança ao visitante.
O produto pode ser:
- um que você escolhe;
- o produto da página em que o bloco está (num modelo de produto);
- escolhido pela loja: um produto em destaque ou um em promoção.
O que ele pode mostrar, cada item ligado na aba Configurações:
- um rótulo acima do título;
- o título, um subtítulo e um resumo (a descrição curta do produto, ou um texto seu);
- a avaliação do produto;
- o preço, com o desconto do produto em promoção;
- uma contagem regressiva;
- até dois botões: adicionar ao carrinho, ver o produto ou um link seu;
- uma linha de confiança e uma prova social;
- uma lista de benefícios e uma lista de garantias.
A imagem pode ser a foto do produto ou outra imagem, e é apresentada de uma de quatro formas:
| Apresentação | O que faz |
|---|---|
| Automático | A foto com fundo transparente aparece recortada; qualquer outra aparece com moldura. |
| Recortada | O produto sem fundo, sobre um pódio. |
| Com moldura | A foto com o fundo dela, numa moldura com sombra. |
| Preencher a coluna | A foto ocupa a metade dela no bloco, de borda a borda. |
Também dá para definir o tamanho da imagem, o ponto focal em cada dispositivo, o lado em que ela fica e o arredondamento dos cantos.
Na aba Estilos: a altura do bloco em cada dispositivo, a intensidade do fundo, o espaçamento, a cor de destaque e um painel para cada elemento.
O produto esgotado mantém o botão principal, com o que o WooCommerce diz sobre ele.
Blocos de produtos
Grade de produtos
Produtos em grade.
Fontes de produtos:
- Produtos mais recentes
- Produtos escolhidos manualmente
- Categorias
- Tags
- Produtos em destaque
- Produtos em promoção
Layouts: Vitrine, Clássico, Minimalista, Editorial, Compacto, Cards Suaves, Sobreposto, Horizontal e Destaque Primeiro. O layout define a forma e a aparência da grade; os produtos, os textos e as cores que você escolheu continuam como estão.
Para o visitante, cada recurso opcional:
- Abas de categorias, para ver os produtos de uma categoria.
- Ordenação, por data, nome ou preço.
- Carregar mais, para trazer mais produtos sem sair da página.
- Compra rápida, para adicionar um produto ao carrinho sem recarregar a página.
Sem JavaScript, as abas e a ordenação são links e um formulário, e funcionam do mesmo jeito.
O cartão pode mostrar a foto, o nome, a avaliação, o preço, a economia do produto em promoção, a descrição curta, o selo de promoção, o selo de estoque e o botão. Cada um tem o seu painel na aba Estilos. Você também escolhe a proporção da foto (1:1, 4:5, 3:4, 4:3 ou 16:9), o estilo do cartão (elevado, simples, com contorno ou suave) e o número de colunas em cada dispositivo.
O primeiro produto pode ficar em destaque, maior que os outros, com descrição e botão próprios.
A descrição curta de um produto protegido por senha nunca é mostrada.
Blocos de produtos
Carrossel de Produtos
Produtos numa fileira que desliza.
Fontes de produtos: as seis da Grade de produtos, e também:
- Mais vendidos
- Produtos mais bem avaliados
- Produtos relacionados
- Upsells
- Vistos recentemente
Produtos relacionados e Upsells seguem o produto da página, ou um que você escolhe. Quando a fonte não tem nada a mostrar, o bloco pode ficar oculto ou mostrar outra fonte no lugar.
Layouts: Vitrine, Clássico, Compacto, Minimalista, Cards Suaves, Sobreposto, Horizontal, Editorial, Destaque único, Centralizado, Duas Linhas e Destaque Primeiro.
A fileira
- setas, mostradas ou ocultas em cada dispositivo, sempre ou só sob o ponteiro;
- arrastar com o mouse ou com o dedo;
- como a fileira anda: um produto por vez ou uma página por vez;
- o que acontece no fim: parar, voltar ao início, mostrar um cartão que leva a todos os produtos, ou girar em laço;
- rotação automática, que o visitante pode pausar;
- um pedaço do próximo cartão à vista, para mostrar que há mais;
- as bordas esmaecidas e os cartões com a mesma altura.
Outras opções: um cabeçalho com rótulo, título e subtítulo; um link para ver todos os produtos; uma segunda foto do produto sob o ponteiro; produtos esgotados como a loja mostra, por último ou ocultos; e compra rápida.
Sem JavaScript, a fileira rola com o dedo, o mouse ou o teclado.
Vistos recentemente
Essa fonte mostra a cada visitante os produtos que ele abriu. O histórico fica no navegador do visitante, não no seu site: até 24 produtos, cada um por 30 dias. Veja os detalhes em Privacidade.
Blocos de conteúdo
Sobre o Produto
A história do produto: um rótulo, um título, um texto, até quatro destaques, um fato em evidência e até dois botões, ao lado de uma foto ou sobre ela. O texto pode ser copiado da descrição de um produto. A foto pode ser desligada.
Blocos de conteúdo
Recursos do Produto
Cartões com uma foto, um número ou um ícone, um título e um texto. Os cartões ficam com um em destaque ao lado dos outros, ou numa grade uniforme. Cada cartão tem a sua foto, com uma cor sobre ela e a intensidade, e a foto pode ser desligada.
Blocos de conteúdo
Pontos do Produto
Pontos numerados sobre uma foto do produto. Cada ponto abre um painel com título, subtítulo, texto e uma foto própria.
- Arraste o ponto sobre a foto para posicioná-lo, ou defina a posição na barra lateral, pelo teclado.
- A foto pode ficar no início ou no fim, e você define a largura e o arredondamento dos cantos dela.
- Os pontos podem pulsar e mostrar os números.
Sem JavaScript, todos os pontos aparecem como lista, cada um com o seu painel.
Blocos de conteúdo
Tabela de Comparação
O seu produto ao lado das alternativas, recurso por recurso. Uma coluna fica em destaque, com um selo. Cada célula tem um texto e uma marca (sim, não ou nenhuma). Um botão vai abaixo da tabela.
Numa tela estreita, cada recurso vira uma linha própria, com o nome dele acima do que cada coluna diz.
Blocos de conteúdo
Depoimentos
O que os compradores dizem, numa fileira de cartões que desliza: uma foto, um nome, estrelas e uma citação, sob um cabeçalho com a nota média e uma faixa de fatos curtos.
Os depoimentos podem ser escritos à mão ou vir das avaliações aprovadas de um produto.
O depoimento escrito à mão só mostra o selo “Compra verificada” quando você liga essa opção. Use-o para compras que você consegue comprovar. A nota média e o número de avaliações de um bloco escrito à mão são o texto que você escreve: não são lidos da loja.
Blocos de conteúdo
FAQ
Perguntas que abrem para mostrar as respostas, em uma ou duas colunas, com um cabeçalho, uma foto opcional e uma faixa de fatos curtos.
- Cada pergunta pode começar aberta ou fechada, e o bloco pode manter só uma aberta por vez.
- O bloco acrescenta os dados estruturados de FAQ para os buscadores. Dá para desligar.
A pergunta é aberta pelo próprio navegador, sem script.
Blocos de conteúdo
Galeria em Carrossel
Uma foto grande que desliza, as duas seguintes ao lado dela e uma fileira de miniaturas, sob um cabeçalho. As fotos são as que você escolhe ou a galeria de um produto.
Com uma ou duas fotos, a foto grande mantém a largura que tem numa galeria com mais fotos, centralizada.
Blocos de conteúdo
Galeria em Grade
Fotos em grade, cada uma com a sua legenda, ou num mosaico de fotos de tamanhos diferentes, sob um cabeçalho. Você escolhe duas, três ou quatro colunas e a proporção das fotos.
Blocos de conteúdo
Cabeçalho de Página
A barra no topo de uma landing page: a marca (um texto, um ícone ou uma imagem), os links para as seções da página e um botão. Ela pode ficar fixa no topo enquanto a página rola. No telefone, os links ficam num menu.
É feito para uma página cujo modelo não tem cabeçalho.
Blocos de conteúdo
Rodapé de Página
O fim de uma landing page: a marca e uma descrição, colunas de links, um formulário para receber novidades, as formas de falar com a loja, fatos curtos, links para redes sociais e uma última linha com os direitos.
O formulário envia o endereço ao serviço que você configurar no bloco. O plugin em si não guarda endereço nenhum.
Blocos de conteúdo
Ligar a barra às seções
O Cabeçalho de Página leva a seções da mesma página. Para um link funcionar:
- Selecione o bloco ao qual o link deve levar.
- Na barra lateral, abra Avançado e escreva um nome em Âncora HTML, como
galeria. - No Cabeçalho de Página, use o endereço
#galerianesse link.
Referência
Privacidade
- Nenhuma requisição a outro servidor. O plugin não carrega nada de fora do seu site.
- Nenhum dado de visitante no seu site. O plugin não guarda opção, tabela ou cookie com dados dos seus visitantes.
- Vistos recentemente. Com essa fonte em uso, o navegador de cada visitante guarda os produtos que ele abriu: IDs de produtos e datas, até 24 produtos, cada um por 30 dias, no armazenamento do navegador. A lista é enviada ao seu site só para desenhar os cartões, e nada no servidor a guarda.
- Consentimento. Com um plugin de consentimento compatível com a WP Consent API, o histórico só é gravado e lido quando o visitante permite a categoria “preferências”. Quando o consentimento é retirado, o histórico é removido do navegador. Sem um plugin assim no site, o histórico é gravado.
- Formulário do Rodapé de Página. Ele envia o endereço que o visitante escreve ao serviço que você configurar. Informe isso na sua política de privacidade.
Referência
Idiomas
O plugin é escrito em inglês e vem com tradução para o português do Brasil. Está pronto para ser traduzido para outros idiomas.
Referência
Desempenho
- A página carrega os estilos e os scripts só dos blocos que usa. Uma página sem blocos do plugin não carrega nada dele.
- As listas ordenadas por vendas ou por avaliação, que são as mais pesadas de calcular, ficam guardadas por até uma hora e são renovadas quando um produto é salvo ou muda de estoque. As vendas feitas depois disso aparecem em até uma hora.
- O Product Hero no topo da página carrega a imagem dele primeiro, para ser a primeira coisa que o visitante vê.
Referência
Excluir o plugin
Quando o plugin é excluído pela tela de Plugins, os dados em cache que ele guarda (transients cujo nome começa com wpdefcs_) são removidos. Os blocos continuam no conteúdo das suas páginas e voltam a aparecer se você instalar o plugin de novo.
O histórico de “Vistos recentemente” no navegador de cada visitante expira sozinho em no máximo 30 dias.
Referência
Solução de problemas
Os blocos não aparecem no inseridor.
Confira se o WooCommerce está ativo e se as versões do WordPress, do WooCommerce e do PHP atendem aos requisitos.
Um bloco em largura total não chega às bordas da tela.
O modelo da página limita a largura do conteúdo. Escolha um modelo de largura total do tema.
A landing page mostra dois cabeçalhos ou dois rodapés.
O modelo da página tem o cabeçalho e o rodapé do tema. Escolha um modelo sem eles, ou remova o Cabeçalho de Página e o Rodapé de Página da landing page.
Uma lista de produtos está vazia.
A fonte não tem produto para mostrar: nenhum naquela categoria, nenhum em destaque, nenhum em promoção. Escolha outra fonte, ou defina o que o bloco mostra no lugar.
A foto do bloco Pontos do Produto está pequena demais.
A foto aparece no tamanho em que foi enviada. Defina a largura dela na aba Estilos, no painel Foto.
Um produto que eu alterei ainda mostra o preço antigo numa lista.
Os blocos leem o preço da loja toda vez que a página é desenhada. Se o seu site tem cache de página, limpe-o.
A tela do painel está em inglês.
O plugin segue o idioma do seu usuário. Defina em Usuários > Perfil > Idioma.
Referência
Para desenvolvedores
Os blocos se chamam wpdefcs/… e as classes CSS deles começam com wpdefcs-. O código-fonte dos scripts e dos estilos vem com o plugin, na pasta src; para compilar, rode npm install e npm run build na pasta do plugin.
| Filtro | O que faz |
|---|---|
wpdefcs_max_products | O máximo de produtos que um bloco pode mostrar. |
wpdefcs_load_more_max_products | O máximo de produtos que “Carregar mais” pode trazer. |
wpdefcs_random_seed | Fixa a semente da ordem aleatória (um inteiro positivo). |
wpdefcs_recently_viewed_tracking | Liga ou desliga a gravação das visitas. |
wpdefcs_recently_viewed_consent_category | A categoria da WP Consent API que o histórico exige. |
Referência
Créditos e licença
O Definitivo Commerce Studio é software livre, sob a GPL versão 2 ou posterior.
Os ícones são um subconjunto do Lucide, sob a licença ISC (com a licença MIT dos ícones Feather que ele mantém).