Suporte e documentação

Tudo que você precisa para instalar, configurar e resolver problemas do plugin.

Um guia completo para instalar os swatches de produtos ligados, escolher o modo certo, ajustar o estilo e resolver compatibilidades de tema.

Comece aqui

Instale, escolha um modo, teste uma página de produto.

A maioria das lojas só precisa dos passos essenciais: ativar o plugin, escolher Produtos de categoria automática ou Produtos ligados e verificar a saída na loja.

Documentação

Definições práticas, não texto de ajuda genérico.

O guia abaixo foca decisões reais de WooCommerce: famílias de produtos, posição do shortcode, estilo e compatibilidade do tema.

Suporte por email

Precisa de ajuda com a configuração?

Envie email ao suporte com a URL do site, nome do tema e uma breve descrição do que quer configurar.

support@sweetplugins.com

Suporte by email

Se precisar de ajuda para instalar o plugin, escolher o modo de swatch ou resolver compatibilidade do tema, contacte diretamente o suporte Sweet Plugins.

support@sweetplugins.com Enviar email

Para suporte mais rápido, inclua a URL do produto, o tema WooCommerce, a versão do plugin e uma breve descrição do comportamento esperado.

Instalação

  1. Carregar e ativar Swatches de produtos ligados para WooCommerce.
  2. Open Swatches de produtos ligados no menu de administração do WordPress.
  3. Escolha Produtos de categoria automática ou Produtos ligados.
  4. Guarde as definições e abra um produto WooCommerce para testar a saída na loja.
Captura geral do admin

Página principal de definições com secções de comportamento, posicionamento, estilo, compatibilidade e licença.

Escolha um modo de swatch

Produtos de categoria automática

Use quando cada produto de uma categoria deve aparecer como swatch relacionado. É a configuração mais rápida para famílias de produtos como cores, materiais ou acabamentos.

  • Os swatches são obtidos da categoria atual do produto.
  • As definições de categoria podem desativar swatches para toda a categoria.
  • As definições de produto podem excluir produtos individuais.

Linked Produtos

Use quando a relação exata precisa ser controlada manualmente no editor do produto.

  • Os editores escolhem os produtos ligados por produto.
  • Os controlos de categoria são ignorados.
  • Ideal para coleções curadas ou opções entre categorias.

Definições globais

A página de definições controla a saída na loja para cada produto que usa o plugin.

Método de visualizaçãoEscolha posicionamento automático por hook WooCommerce ou posicionamento manual por shortcode.
Posição automáticaEscolha o hook WooCommerce usado quando o posicionamento automático está ativo.
Efeitos de pré-visualizaçãoAtive pré-visualizações hover para imagem, título e preço no desktop.
Swatches sem stockEscolha se produtos sem stock ainda devem aparecer como opções.
Ordem dos íconesOrdene produtos por data, título, ordem de menu ou aleatório.

Produto settings

Cada produto tem um painel de swatches no editor de produto.

Produto swatch panel screenshot

Escolha imagem de produto, ícone personalizado ou cor. Adicione tooltip, atributo title e texto alt.

  • Produto Image: usa a imagem destacada do produto como swatch.
  • Ícone personalizado: envie um ícone quadrado dedicado.
  • Color: gera um swatch de cor simples.
  • Texto de tooltip: controla o tooltip no desktop.
  • Desativar swatch: oculta um produto dos grupos automáticos de swatches.
  • Linked Produtos: aparece no modo Ligados para escolher produtos relacionados exatos.

Definições de categoria

No modo automático, categorias de produto podem ativar ou desativar swatches para toda a categoria. Assim categorias não relacionadas ficam limpas sem editar cada produto.

Posicionamento do shortcode

Use o shortcode quando um builder ou template personalizado precisa controlar onde os swatches aparecem.

[lpswc]

Set Método de visualização to Posicionamento manual por shortcode quando o shortcode é responsável pela saída.

Swatch style

O plugin oferece controlos visuais para que a maioria das lojas não precise de CSS personalizado.

Tamanho do swatchLargura e altura em pixels.
Espaçamento de íconesEspaçamento à direita entre swatches. Deixe vazio para usar o valor CSS padrão.
Largura e cor da bordaEstilo da borda do swatch inativo.
Borda selecionadaContorno do swatch ativo. Deixe vazio para desativar o contorno padrão.
Raio da bordaSwatches quadrados, arredondados ou circulares.
SombraSombras predefinidas de nenhuma a forte.

Compatibilidade de galeria

O assistente de compatibilidade controla como o plugin encontra imagem principal, título e preço para pré-visualizações.

  • Deteção automática: tenta seletores comuns do WooCommerce, Elementor e do tema.
  • Seletores avançados manuais: define seletores CSS exatos para templates personalizados.
  • Mobile: as pré-visualizações hover são ignoradas em dispositivos táteis para que os toques naveguem diretamente.

Licenças e atualizações privadas

A chave de licença é guardada no site cliente na opção do WordPress wcpvs_license_key. Durante verificações de atualização, o plugin envia a chave, URL do site e versão instalada para o endpoint de atualização da Sweet Plugins.

O servidor de atualização valida a licença antes de devolver uma URL de pacote. O ZIP deve ser servido através de download.php, not as a public direct file.

Resolução de problemas

As atualizações não aparecem

Certifique-se de que a versão remota é superior à versão instalada, que a licença é válida e que os transients de atualização do WordPress foram atualizados.

No mobile requer toque duplo

Limpe primeiro a otimização de página/cache. O plugin injeta um bootstrap táctil sem otimização, mas o HTML em cache ainda pode servir uma versão antiga.

A pré-visualização atualiza a imagem errada

Mude o assistente de compatibilidade para modo manual e defina um seletor de imagem mais preciso.

O contorno ativo do swatch entra em conflito com CSS personalizado

Leave the Borda selecionada field empty to disable the default selected outline.