Ligação Interna Automática para Shopware 6

Apresentação

O DfInternalLinking automatiza a ligação interna da sua loja Shopware 6. Define regras que associam uma palavra-chave a uma página de destino (produto, categoria ou URL livre), e a extensão transforma as ocorrências dessa palavra-chave em ligações contextuais nas suas descrições de produtos e nos seus blocos de conteúdo CMS.

Compatibilidade

• Shopware 6.5.x, 6.6.x e 6.7.x
• PHP 8.1 ou superior, consoante os pré-requisitos da sua versão do Shopware
• Multicanal: configuração independente por canal de venda
• Administração traduzida em inglês, alemão, francês, espanhol e italiano

Instalação

A partir da administração

1. Vá a Extensões > As minhas extensões.
2. Clique em Carregar a extensão e selecione o ficheiro ZIP da extensão.
3. Clique em Instalar e ative a extensão com o interruptor.

Por linha de comandos

Descomprima a pasta da extensão em custom/plugins/ e execute:

bin/console plugin:refresh
bin/console plugin:install --activate DfInternalLinking
bin/console cache:clear

Se instalar a partir das fontes em vez de um ZIP pré-compilado, reconstrua a administração:

./bin/build-administration.sh

Configuração geral

Abra Definições > Sistema > Extensões, e depois as definições do DfInternalLinking. Cada opção pode ser definida globalmente ou por canal de venda.

• Ativar a ligação interna: ativa ou desativa a injeção das ligações. Valor predefinido: ativo.
• Número máximo de ligações por página: orçamento global de ligações injetadas numa mesma página, somando todas as regras. Valor predefinido: 5.
• Modo silo: só aplica uma regra se o seu destino partilhar um ramo de categoria com a página atual. Valor predefinido: desativado.
• Acrescentar nofollow: acrescenta o atributo rel nofollow às ligações geradas. Valor predefinido: desativado.
• Classe CSS das ligações: classe aplicada a cada ligação gerada, para a estilizar no seu tema. Valor predefinido: df-internal-link.

Criar uma regra de palavra-chave

A extensão acrescenta uma entrada Ligação interna no menu Marketing da administração. Clique em Acrescentar uma regra para abrir o formulário.

• Palavra-chave: a expressão a detetar nos seus conteúdos. A deteção não distingue maiúsculas de minúsculas e respeita as fronteiras de palavra.
• Tipo de destino: Produto, Categoria ou URL personalizado.
• Produto / Categoria de destino: o seletor apresentado depende do tipo escolhido. O URL SEO canónico é gerado automaticamente pelo Shopware para o canal em curso.
• URL de destino: campo apresentado apenas para o tipo URL personalizado. Aceita um URL absoluto ou um caminho relativo.
• Número máximo de ligações por página: limite próprio desta regra, aplicado além do orçamento global.
• Prioridade: as regras são tratadas por prioridade crescente. Com a mesma prioridade, a palavra-chave mais longa é aplicada primeiro.
• Idioma: restringe a regra a um único idioma. Deixe vazio para a aplicar a todos.
• Canal de venda: restringe a regra a um único canal. Deixe vazio para a aplicar a todos.
• Ativa: desative temporariamente uma regra sem a eliminar.

Onde as ligações são injetadas

A extensão trata os seguintes conteúdos:

• A descrição do produto nas páginas de produto
• Os blocos de conteúdo do tipo texto e HTML das páginas de produto, das páginas de navegação (categorias) e das landing pages

A análise é feita sobre a árvore HTML e trata apenas os nós de texto. As seguintes zonas são sistematicamente ignoradas:

• O interior das ligações existentes
• Os títulos de nível 1 a 6
• As etiquetas de script e de estilo
• Os botões

Duas salvaguardas completam este comportamento: as fronteiras de palavra Unicode impedem qualquer substituição dentro de uma palavra, e uma página nunca liga a si própria.

O modo silo

O modo silo destina-se aos catálogos estruturados em universos temáticos. Quando está ativo, uma regra só é aplicada se o seu destino partilhar pelo menos um ramo de categoria com a página que está a ser renderizada.

Na prática, numa página de produto arrumada no ramo Caminhadas, só as regras que apontam para outros produtos ou categorias desse ramo serão aplicadas. As regras que apontam para outro ramo são ignoradas. Isto concentra a força das ligações dentro de cada silo e reforça a coerência temática percebida pelos motores de pesquisa.

O relatório de páginas órfãs

A partir da lista de regras, clique em Relatório de páginas órfãs. O relatório lista:

• Os produtos ativos que não são visados por qualquer regra ativa
• As categorias ativas do tipo página que não são visadas por qualquer regra ativa

Três estatísticas acompanham cada tabela: o número total de elementos ativos, o número de elementos com ligações e o número de órfãos. Use este relatório como roteiro: cada página órfã é uma página que não recebe qualquer ligação interna do seu catálogo.

Cache e passagem a produção

Limpe a cache depois de uma sessão de alteração das regras:

bin/console cache:clear

Também pode usar o botão de limpeza da cache disponível na administração do Shopware.

Resolução de problemas

Não aparece qualquer ligação na loja

• Verifique que a ligação interna está ativa na configuração, para o canal de venda em causa.
• Verifique que a regra está ativa e que o seu idioma e o seu canal correspondem mesmo à página consultada.
• Limpe a cache do storefront.
• Confirme que a palavra-chave está realmente presente na descrição, fora de uma ligação ou de um título.

Menos ligações do que o previsto

O orçamento global por página foi atingido. Aumente o valor na configuração, ou reduza o limite das regras menos prioritárias.

Uma regra é ignorada em certas páginas

O modo silo está provavelmente ativo e o destino da regra pertence a outro ramo de categoria. Desative o modo silo ou associe o destino ao ramo certo.

Uma palavra-chave é ligada no sítio errado

Duas regras concorrentes visam o mesmo texto. Ajuste a prioridade: o valor mais baixo é tratado primeiro.

Desinstalação

Na desinstalação, se não marcar a opção de conservação dos dados, a tabela das regras é eliminada. As suas descrições de produtos e os seus conteúdos CMS ficam intactos, uma vez que nunca foram alterados.