Cliente
tandembaits.com é uma loja online que opera no setor da pesca. A oferta da loja baseia-se num sortido especializado, em que os nomes corretos das categorias, descrições precisas e URLs bem preparadas têm impacto direto na usabilidade da loja, no SEO e na comunicação com os clientes em diferentes países.
Desafio
No âmbito da expansão da loja com novas versões linguísticas, o cliente precisava de uma forma eficaz de gerir categorias no Magento 2.
O maior problema era a especificidade do setor da pesca. Os nomes das categorias não são etiquetas simples e universais. Referem-se frequentemente a técnicas específicas de pesca, tipos de iscos, acessórios, séries de produtos ou conceitos usados apenas por pescadores experientes.
Com 10 versões linguísticas, a gestão manual das categorias no painel do Magento era demasiado morosa e propensa a erros. O cliente precisava de ter controlo total sobre:
- nomes das categorias,
- URLs das categorias,
- descrições das categorias,
- metadados SEO,
- valores específicos de cada store view,
- coerência da estrutura de categorias entre versões linguísticas.
A escala do trabalho abrangia várias dezenas de categorias em 10 versões linguísticas. Isto significava centenas de valores de texto para preparar, verificar, corrigir e importar.
Problema de negócio
O trabalho padrão no painel do Magento exigiria a edição de cada categoria separadamente para cada store view. Com várias dezenas de categorias e 10 línguas, esse processo seria lento e difícil de controlar.
Os riscos mais importantes no trabalho manual:
- erros na seleção da store view,
- traduções incoerentes dos nomes das categorias,
- sobrescrita acidental dos valores predefinidos,
- URLs incorretos ou duplicados,
- falta de uma visão prática de todas as categorias num só local,
- dificuldade em transmitir os dados a tradutores ou a pessoas responsáveis por SEO,
- falta de uma forma simples de validar alterações antes de guardar.
O cliente precisava de um processo que permitisse preparar os dados em lote, verificá-los antes da importação e guardar com segurança apenas os atributos selecionados para uma store view específica.
Solução
Para este cenário, foi utilizado o módulo Export Import Categories para Magento 2.
O módulo permitiu exportar categorias para um ficheiro CSV, preparar os dados linguísticos fora do painel do Magento e voltar a importar os valores para a store view selecionada.
O processo baseou-se no modo update, porque a estrutura de categorias já existia na loja. O objetivo não era criar uma nova árvore de categorias, mas complementar e corrigir os dados para versões linguísticas seguintes.
Âmbito de utilização do módulo
No projeto, foram essenciais as seguintes funcionalidades do módulo:
- exportação de categorias a partir da store view base,
- manutenção de
entity_id como identificador estável da categoria, - alteração de
store_view_code para o código da versão linguística de destino, - importação em modo
update, - seleção de atributos específicos para importação,
- gestão dos nomes das categorias,
- gestão de
url_key, - gestão das descrições das categorias,
- controlo de valores vazios,
- validação do ficheiro antes da importação propriamente dita,
- relatório de importação.
Processo implementado no projeto
1. Exportação de categorias
Primeiro, foi realizada a exportação das categorias a partir da store view base. O ficheiro CSV continha colunas de sistema e os atributos selecionados necessários para preparar as versões linguísticas.
As colunas de sistema mais importantes:
store_view_code,entity_id,category_path,parent_path.
Os atributos de trabalho mais importantes:
name,url_key,description,meta_title,meta_description.
2. Preparação dos dados linguísticos
Com base no CSV exportado, foram preparados dados separados para cada versão linguística.
Graças a isso, as pessoas responsáveis pelos conteúdos puderam trabalhar na folha de cálculo, vendo várias categorias ao mesmo tempo. Isto foi particularmente importante no setor da pesca, onde os nomes das categorias têm de estar alinhados com a terminologia local e com a forma real como os clientes procuram produtos.
3. Manutenção dos identificadores das categorias
Nos ficheiros de importação, foi mantido o entity_id, para que o módulo pudesse associar de forma inequívoca as linhas do CSV às categorias existentes no Magento.
Isto permitiu importar traduções sem risco de criar categorias duplicadas.
4. Alteração da store view
Para cada versão linguística, era definido o respetivo store_view_code no CSV e era selecionada a mesma store view no formulário de importação.
O módulo validava a conformidade destes dados. Graças a isso, foi reduzido o risco de importar traduções acidentalmente para a vista de loja errada.
5. Importação em modo update
A importação era realizada no modo update, selecionando apenas os atributos que deviam ser alterados para essa versão linguística.
Graças a isso, o módulo não interferia com os restantes dados da categoria.
6. Validação e dry-run
Antes da importação propriamente dita, era possível executar a validação sem guardar os dados.
O modo dry-run permitia verificar:
- se o ficheiro CSV tinha as colunas corretas,
- se
store_view_code correspondia à store view selecionada, - se
entity_id apontava para categorias existentes, - se os atributos selecionados existiam no Magento,
- se a importação não continha erros que bloqueassem a gravação.
7. Relatório após a importação
Após a importação, o módulo gerava um relatório que permitia verificar o estado de cada linha.
O relatório era particularmente útil ao trabalhar com muitos idiomas, porque permitia detetar rapidamente eventuais erros num ficheiro específico ou numa categoria específica.
O CSV era um formato prático para este projeto, porque:
- pode ser facilmente editado numa folha de cálculo,
- pode ser enviado para tradutores,
- permite comparar valores entre idiomas,
- permite preparar várias versões linguísticas com base numa única exportação,
- permite trabalhar em colunas específicas sem clicar manualmente no painel do Magento,
- permite manter o controlo sobre
entity_id e store_view_code.
Efeito
O módulo permitiu ao cliente gerir categorias em 10 versões linguísticas de forma organizada e repetível.
Em vez da edição manual de cada categoria no painel do Magento, a equipa pôde trabalhar com ficheiros CSV, preparar traduções em lote e importar apenas os atributos selecionados para uma store view específica.
As principais vantagens:
- preparação mais rápida de novas versões linguísticas,
- maior controlo sobre os nomes das categorias,
- controlo total sobre os URLs,
- gestão mais fácil das descrições das categorias,
- possibilidade de trabalhar fora do painel do Magento,
- menor risco de erros com várias store view,
- validação dos dados antes de guardar,
- relatórios dos resultados da importação.
Importância para o SEO
No projeto, foi particularmente importante a possibilidade de controlar url_key, os nomes das categorias e as descrições.
Para uma loja que opera em vários idiomas, a tradução automática ou a cópia acidental dos nomes das categorias não é suficiente. Cada mercado pode usar termos setoriais diferentes, e na pesca as diferenças terminológicas são particularmente relevantes.
O módulo permitiu preparar conscientemente valores de SEO para cada versão linguística:
- nomes de categorias locais,
- URLs locais,
- descrições adaptadas ao idioma,
- meta títulos,
- meta descrições.
Resumo
A expansão de tandembaits.com para 10 versões linguísticas exigia uma ferramenta que permitisse gerir eficazmente as categorias do Magento 2 ao nível da store view.
Export Import Categories resolveu este problema, transferindo o trabalho da edição manual no painel do Magento para um processo controlado baseado em CSV, validação e importação de atributos selecionados.
Como resultado, o cliente passou a poder gerir comodamente nomes especializados de categorias, URLs e descrições para vários idiomas, sem o risco de sobrescrever acidentalmente toda a estrutura de categorias.
