Documentação do utilizador
É assim que funciona o Agente de tradução na vossa loja Shopware 6
Nesta documentação, aprenderá a utilizar o Reqser para traduzir automaticamente a sua loja para várias línguas. Desde o reconhecimento automático de conteúdos e o editor de tradução até ao dicionário - encontrará aqui tudo o que precisa para começar.
O que deve ter em conta após a conclusão do curso
Não edite o conteúdo de línguas estrangeiras diretamente no Shopware - utilize o nosso editor de tradução para que as suas alterações não sejam substituídas pela próxima recolha.
Testar a encomenda em todas as línguas estrangeiras - esta é a forma de garantir que todo o processo de encomenda e de checkout funciona corretamente em todas as línguas.
Verificar o conteúdo em línguas estrangeiras e comunicar erros - examine a sua loja em cada uma das línguas e comunique quaisquer anomalias diretamente a nós ou à sua agência.
1. visão geral
Parabéns - a sua loja está agora totalmente automatizada! O Reqser encarrega-se agora da tradução do conteúdo da sua loja para todas as línguas configuradas. Nesta documentação, pode descobrir em pormenor como funcionam as funções mais importantes e como pode intervir, se necessário.
Sempre atualizado
O Reqser mantém o seu conteúdo em língua estrangeira sempre atualizado. Novos produtos, textos alterados e categorias actualizadas são automaticamente reconhecidos e traduzidos.
Controlo total
Pode aceder às traduções em qualquer altura através do editor de tradução e do dicionário - desde adaptações individuais a regras globais do dicionário.
Redireccionamento com base na língua
Os visitantes de línguas estrangeiras são automaticamente redireccionados para a versão linguística correta da sua loja, com base na língua do browser.
2. reconhecimento automático de conteúdos
O reconhecimento automático de conteúdos está no centro do Reqser. O agente analisa regularmente a sua loja através da API e reconhece todo o conteúdo traduzível - desde nomes e descrições de produtos a categorias, páginas CMS e informações do fabricante.
Assim que o agente encontra um conteúdo novo ou alterado, este é automaticamente assinalado para tradução e processado no passo seguinte.
Intervalo de rastejamento
Pode especificar a frequência com que o agente deve procurar novos conteúdos na sua loja. Nossa recomendação: Diariamente. Esta é a única forma de garantir que as suas traduções estão sempre actualizadas em todas as línguas - especialmente se actualiza regularmente os produtos, cria novos artigos ou altera textos.
Se a frequência for mais baixa (semanal, mensal, etc.), os conteúdos novos ou alterados podem aparecer nas línguas estrangeiras com um atraso. Para a maioria das lojas, "Diariamente" é, portanto, a melhor escolha.
- Daily (recomendado) - Garante que todas as versões linguísticas estão sempre actualizadas
- Semanal / Mensal / Anual - Possível, mas os conteúdos novos e alterados aparecem em línguas estrangeiras com um atraso
- Nunca - A pesquisa automática está desactivada. Os novos conteúdos não são reconhecidos automaticamente
Iniciar o rastreamento agora
Podes iniciar uma varredura fora do intervalo regular a qualquer momento – por exemplo, se tiverem acabado de importar muitos produtos novos e não quiserem esperar pela próxima varredura automática.
Para tal, nas definições de ligação, encontrarás o botão «Iniciar rastreio agora». Se já houver um rastreio ativo, o botão fica temporariamente desativado.
Exclusões
Se um determinado conteúdo não deve ser traduzido, pode excluí-lo especificamente de ser reconhecido. Isto é útil, por exemplo, para tabelas técnicas ou conteúdos que devem permanecer na língua original.
Pode utilizar as exclusões para excluir tabelas ou entradas individuais do reconhecimento.
3. o editor de tradução
No editor de tradução, pode ver todas as traduções da sua loja num relance. Aqui pode procurar, filtrar, editar manualmente e confirmar traduções.
Pode aceder ao editor através das definições do seu sítio Web - existe um acesso separado ao editor para cada língua estrangeira.
Pesquisar e filtrar
Utiliza a função de pesquisa para encontrar rapidamente traduções específicas. Podes filtrar por tabela, campo, origem e estado da tradução – por exemplo, apenas entradas confirmadas ou textos para os quais ainda não existe tradução. Com a opção «Atualizado recentemente», podes ordenar as traduções por data de última alteração.
Mudar a vista HTML
Algumas traduções contêm formatação HTML (por exemplo, letras a negrito ou hiperligações). Pode alternar entre a vista de texto simples e a vista HTML renderizada para ver o conteúdo tal como aparece na loja.
Editar traduções
Clica em «Editar» para abrir uma tradução no modal de edição. Em alternativa, podes clicar diretamente em «Traduzir novamente» na visão geral para iniciar uma nova tradução automática.
No modal de edição, tens duas opções à tua disposição:
• Smart Edit – Selecione termos específicos do texto original e defina como devem ser traduzidos. As regras são automaticamente incorporadas no dicionário. Pode escolher se apenas esta entrada ou todas as entradas com esses termos devem ser traduzidas novamente.
• Edição manual – Ajusta o texto traduzido diretamente no campo de texto. A alteração afeta apenas esta entrada específica.
Após guardar, a alteração é automaticamente aplicada na tua loja.
Confirmar traduções
Se utilizar um revisor, por exemplo, pode marcar as traduções verificadas como "confirmadas". Isto permite-lhe manter um registo das traduções que já foram verificadas. Importante: Se o texto de partida for alterado na língua base, a tradução será automaticamente recriada.
Retradução automática em caso de alterações
Se um texto na língua de base for alterado, o agente reconhece-o automaticamente e retraduz todas as entradas de língua estrangeira associadas. Assim, não tem de se preocupar com isso - o conteúdo alterado é automaticamente atualizado em todas as línguas após o ciclo de verificação seguinte.
Compreender a origem
Cada tradução indica a sua origem. As origens mais importantes são: «Retirado da vossa loja» (já existente na loja), «Editado manualmente» (adaptada no editor), «Traduzida pelo Reqser» (traduzida automaticamente) e «Aplicação do dicionário» (adaptada através de uma regra do dicionário). Ao clicar no ícone de informação ao lado da origem, encontrarás uma breve explicação de todos os valores.
Importar textos existentes em línguas estrangeiras
Se já tiverem traduções de alta qualidade na vossa loja, podem ativar nas definições a opção «Utilizar textos em línguas estrangeiras existentes». O Reqser irá então utilizar os vossos textos em línguas estrangeiras já existentes, em vez de os traduzir de novo – o que poupa custos por caractere.
É importante compreender quando esta opção se aplica:
• Apenas no registo inicial: Um texto existente na loja só será importado se, no Reqser, para essa entrada, ainda não existir nenhuma tradução para línguas estrangeiras. A opção destina-se, portanto, principalmente ao preenchimento inicial.
• Em caso de alteração do texto original: Se o texto na língua original for alterado posteriormente, a tradução para a língua estrangeira será deliberadamente traduzida de novo – independentemente de esta opção estar ativa. Desta forma, as vossas traduções mantêm-se corretas em termos de conteúdo e não se desviam do texto original.
• Pode reconhecer esta importação no editor pela indicação de origem «Importado da vossa loja».
Por que não se deve editar textos em língua estrangeira diretamente no Shopware
O Reqser é a principal fonte para todos os conteúdos registados. Se editares um texto numa língua estrangeira diretamente no Shopware, essa alteração poderá ser substituída na próxima indexação – especialmente se o texto original for alterado ou se for desencadeada uma nova tradução.
Por isso, efetua sempre as alterações no Editor de tradução (edição manual ou Smart Edit). A partir daí, serão corretamente transferidas para a tua loja e permanecerão guardadas.
4. o dicionário (glossário)
O dicionário é uma das ferramentas mais poderosas do Reqser. É aqui que define as regras para a tradução de determinados termos - ou se não devem ser traduzidos de todo.
As regras do dicionário garantem que a sua marca, os nomes dos produtos e os termos técnicos são apresentados de forma consistente e correta em todas as línguas.
Traduzir sempre como...
Especifica que um determinado termo deve ser sempre traduzido de uma determinada forma. Isto é ideal para nomes de marcas, termos técnicos ou expressões específicas do sector.
Exemplo: "Weidezaun" deve ser sempre traduzido para inglês como "electric fence" (cerca eléctrica).
Nunca traduzir
Especifica que um termo deve ser mantido na língua original e não traduzido. Útil para nomes próprios, marcas registadas ou termos técnicos.
Exemplo: "Patura" é um nome de marca e não deve ser traduzido para nenhuma língua.
Adicionar regras
Ao criar uma nova regra, introduza as seguintes informações:
- Palavra de origem - O termo na sua língua de base
- Palavra de destino - A tradução pretendida (apenas para "Traduzir sempre como...")
- Idiomas - As línguas estrangeiras às quais a regra se deve aplicar
Ao guardar, também pode especificar se as traduções existentes devem ser retraduzidas diretamente com a nova regra.
Nova tradução para as alterações às regras
Se alterar ou eliminar uma regra de dicionário, tem a opção de ter todas as traduções afectadas automaticamente re-traduzidas. O Reqser mostra-lhe uma estimativa das entradas afectadas e os custos de caracteres associados.
Isto assegura que as suas traduções estão sempre em conformidade com as regras de dicionário actuais.
5. tratamento de ligações
O tratamento de links garante que os links internos nas suas traduções apontam corretamente para a respectiva versão linguística da sua loja. Sem esta função, os conteúdos traduzidos apontariam para os URLs em alemão - pelo que os seus visitantes mudariam inesperadamente de língua quando clicassem.
O tratamento de hiperligações funciona de forma totalmente automática em segundo plano e não requer configuração manual.
- O Reqser identifica links internos no conteúdo da vossa loja (por exemplo, nas descrições dos produtos ou no front-end)
- Para cada língua estrangeira, as ligações são automaticamente reescritas para o URL específico da língua correspondente
-
Os domínios e os caminhos são atribuídos corretamente para cada língua (por exemplo,
/en/category/passa a/en/category/) - O tratamento das ligações é efectuado automaticamente após cada tradução
Regras de ligação
Se o processamento automático de links não conseguir traduzir um link corretamente ou se pretenderem definir uma atribuição fixa, podem criar Regras de links. Uma regra define: «Se este link original aparecer num determinado idioma estrangeiro, substitua-o sempre por este link traduzido.»
As regras de links encontram-se nas definições, em Gestão de links. Aí, poderá ver todos os links processados e editá-los na visão geral. Através de Adicionar regra, pode criar uma regra também para um link que ainda não conste na visão geral.
- As regras são definidas por língua - a mesma ligação pode ser traduzida de forma diferente em línguas diferentes
- As regras aplicam-se na respetiva língua em todos os locais onde o link aparece – nas descrições de produtos, nas páginas do front-end ou nos campos de URL
-
Sem nenhuma outra opção, uma regra aplica-se apenas ao link original exato, incluindo a âncora (
#page=14) e os parâmetros (?ts=…) -
Com Para todas as variantes deste caminho, a regra aplica-se a cada ocorrência do mesmo caminho. As âncoras como
#page=14permanecem na respetiva ocorrência, enquanto os parâmetros de cache como?ts=…são removidos - Ao guardar ou alterar uma regra, as traduções em causa são atualizadas em segundo plano no Reqser; a vossa loja online recebe normalmente os textos alterados na próxima indexação
- Ao eliminar uma regra, apenas a regra é removida – os textos de tradução existentes não são automaticamente repostos
- As regras têm prioridade sobre a resolução automática de links – se existir uma regra, esta será aplicada
Utilizar traduções de imagens já existentes
Se já estiverem a gerir as vossas imagens em vários idiomas na loja, o Reqser reconhece essas versões linguísticas, associa-as às entradas nos idiomas estrangeiros e não as cria novamente. A sincronização é efetuada automaticamente em cada execução, verificando conteúdos novos e alterados. Para tal, as imagens têm de seguir um esquema de nomenclatura fixo:
-
Idioma base: nome do ficheiro sem sufixo de idioma ou, opcionalmente, com sufixo de idioma base, por exemplo,
SD-Feb-2026_Kuechen_1440x480ouSD-Feb-2026_Kuechen_1440x480_DE -
Língua estrangeira: o mesmo nome base mais
_{código da língua}, por exemplo,SD-Feb-2026_Kuechen_1440x480_FRpara o francês -
Se a imagem da língua principal tiver um sufixo de idioma (por exemplo,
_DE), este é reconhecido automaticamente e substituído pelo sufixo da língua estrangeira - A pasta onde se encontram as imagens em língua estrangeira no Shopware não tem importância – a atribuição é feita através do nome do ficheiro
- O tipo de ficheiro também não tem importância – a imagem de origem e a imagem de destino podem ter formatos de ficheiro diferentes
6. redireccionamentos baseados na língua
Por predefinição, o Reqser configura redirecionamentos baseados no idioma para a vossa loja online. Os visitantes cujo idioma do navegador corresponda a um dos vossos idiomas estrangeiros são redirecionados para o domínio no idioma adequado – sem terem de alterar manualmente o idioma. Isto melhora a experiência do utilizador e pode aumentar significativamente a conversão nos vossos idiomas estrangeiros.
A deteção baseia-se no idioma do navegador (Accept-Language), e não na localização do visitante. Assim, o Reqser não redireciona com base no Geo-IP – um visitante de língua alemã nos EUA deverá ver a versão em alemão, tal como alguém na Suíça.
- Na página inicial do domínio da vossa língua principal, o plugin Reqser verifica o idioma do navegador do visitante
- Se o idioma corresponder a uma língua estrangeira ativa, o Reqser redireciona para o domínio de idioma correspondente do vosso canal de vendas
- Se o idioma não corresponder a uma língua estrangeira, o visitante permanece no idioma principal
- Se alguém aceder diretamente a uma subpágina (por exemplo, um URL de produto a partir do Google), não ocorre qualquer redirecionamento automático – o link leva diretamente à página acedida
- Os visitantes que serão redirecionados posteriormente dependem do modo de redirecionamento selecionado (ver abaixo)
Requisitos
Para que o reencaminhamento entre em vigor em ambiente de produção, é necessário que os seguintes requisitos sejam cumpridos:
- O plugin Reqser está instalado e ativo no Shopware (versão 1.1.0 ou superior)
- O redirecionamento automático está ativado no Reqser em Redirect (por predefinição: ativado)
- A vossa subscrição está ativa – no modo de demonstração, o redirecionamento está desativado
- Para cada língua estrangeira existe um domínio de canal de vendas adequado, gerido pela Reqser
Modos de reencaminhamento
Em Redirect, nas definições do site, podem definir com que frequência e com que rigor o Reqser redireciona os visitantes para o idioma adequado. O modo padrão é frequentemente (recomendado). As opções avançadas (períodos de tolerância, limites, idioma alternativo) estão disponíveis a partir da versão 1.5.3 do plugin.
frequentemente (recomendado)
Redireciona para a página inicial se o idioma do navegador não corresponder ao domínio atual. Após uma alteração manual do idioma na loja, a escolha do visitante é respeitada – durante uma hora, não haverá novo redirecionamento automático. Passado esse tempo, o visitante poderá ser redirecionado novamente para o idioma adequado na página inicial. Recomendado para a maioria das lojas.
às vezes
Reencaminhamento com limites de sessão: o número e a frequência dos reencaminhamentos por sessão do visitante são limitados. Após a mudança manual de idioma, o idioma selecionado permanece protegido por mais tempo (até 24 horas). É útil se pretenderem reencaminhamentos menos frequentes.
raramente
No máximo um redirecionamento por sessão. Para lojas que pretendem dar aos visitantes o máximo de controlo possível sobre a escolha do idioma.
sempre (aviso)
Reencaminha de forma muito rígida – uma alteração manual do idioma pode ser imediatamente substituída. Dependendo da configuração da loja, isto pode levar a um ciclo infinito. Recomendado apenas para fins de teste, não para utilização em produção.
Mudança manual de idioma
Se um visitante alterar ele próprio o idioma na loja (Language Switcher), o Reqser guarda essa escolha – dependendo do modo, por um período limitado ou durante toda a sessão. No modo frequentemente, a escolha manual é válida normalmente durante uma hora; depois disso, é possível ser redirecionado novamente na página inicial com base no idioma do navegador.
No modo frequentemente, o Reqser também pode redirecionar os visitantes permanentemente para o idioma selecionado pela última vez, enquanto a sessão estiver ativa – independentemente do idioma do navegador.
SEO e links profundos
Os redirecionamentos só funcionam na página inicial. Por isso, os motores de busca e os links partilhados devem apontar sempre diretamente para o URL na língua correta – e não para a página inicial da língua principal, com o consequente redirecionamento.
- Sem redirecionamento por Geo-IP: O idioma segue o idioma do navegador, e não o país do visitante
- Os deep links permanecem estáveis: Quem abrir um URL de produto ou categoria a partir dos resultados de pesquisa é direcionado exatamente para esse URL, sem passar pela página inicial
- O hreflang continua a ser importante: Os redirecionamentos não substituem as etiquetas hreflang corretas nem as versões linguísticas – ambos se complementam
Ajustar as definições
Podes encontrar todas as opções em Definições do site → Redirecionamento no Reqser. Aí, podes ativar e desativar o redirecionamento, selecionar o modo e – a partir da versão 1.5.3 do plugin – ajustar com precisão os parâmetros avançados. Abaixo das definições, podes ver o teste de redirecionamento com os resultados por idioma.
O redirecionamento está ativado por predefinição. Se o desativares, os visitantes permanecerão no domínio que acederam – sem atribuição automática de idioma.
8 Perguntas mais frequentes
As respostas às perguntas mais frequentes sobre o Reqser, a ligação, as traduções e as descrições de imagens podem ser encontradas na nossa página de FAQ.
Para a página de FAQTem mais perguntas ou precisa de apoio? Contacte-nos ou contacte a sua agência em qualquer altura - teremos todo o gosto em ajudá-lo.