Category Wall: página de categoria visual

O Category Wall substitui a lista de subcategorias nativa do PrestaShop por um mural de mosaicos com imagens, com contadores de produtos e três disposições à escolha. Este guia cobre a instalação, a configuração e a utilização avançada do módulo.

Instalação

O módulo instala-se como qualquer outro módulo PrestaShop, sem dependências externas nem Composer.

1. No back-office, abra Módulos > Gestor de módulos e clique em Instalar um módulo (botão no canto superior direito).
2. Selecione o ficheiro dfcategorywall.zip e inicie a instalação.
3. Depois de instalado, clique em Configurar para aceder às definições.

Como funciona a apresentação

Em cada página de categoria, o módulo apresenta automaticamente o mural de subcategorias por cima da listagem de produtos. Apoia-se no hook displayContentWrapperTop, presente no tema Classic e na maioria dos temas que dele derivam.

Se não existir nenhuma subcategoria ativa na categoria consultada, o mural não aparece: o módulo mantém-se totalmente invisível nas categorias sem filhos.

Opções de configuração

Todas as opções se definem no ecrã de configuração do módulo.

Disposição (layout)

Estão disponíveis três apresentações:

• Grelha — uma grelha regular de mosaicos do mesmo tamanho, ideal para um resultado limpo e estruturado.
• Mosaico — uma disposição dinâmica em que a primeira subcategoria ocupa um bloco ampliado, para chamar a atenção para uma secção de destaque.
• Carrossel — um deslocamento horizontal fluido, tátil no telemóvel e com setas de navegação no computador.

Colunas

Defina o número de colunas apresentadas no computador, de 2 a 6. Este valor aplica-se às disposições em grelha e em carrossel. A apresentação adapta-se automaticamente a 3 e depois a 2 colunas em tablet e telemóvel.

Contadores de produtos

Ative Apresentar os contadores de produtos para fazer aparecer, em cada mosaico, o número de produtos da subcategoria sob a forma de etiqueta.

• Contar os produtos recursivamente — soma os produtos de toda a árvore de filhos (subsubcategorias incluídas), e não apenas os produtos ligados diretamente.
• Ocultar as subcategorias vazias — retira do mural as subcategorias sem qualquer produto visível, para apresentar apenas secções realmente compostas.

Descrição e título

• Apresentar a descrição das subcategorias — apresenta um extrato curto por baixo do nome de cada mosaico (truncado a 120 caracteres).
• Apresentar o título da secção e Título da secção — um texto personalizável e multilingue apresentado por cima do mural (por exemplo, «Percorrer as subcategorias»). Deixe o campo vazio para ocultar o título.

Ocultar a lista nativa

A opção Ocultar a lista nativa das subcategorias acrescenta uma regra CSS discreta que oculta o bloco de subcategorias predefinido do tema, para evitar qualquer duplicação com o mural. Esta opção não tem efeito se o seu tema não apresentar esse bloco.

Mosaicos sem imagem

Quando uma subcategoria não tem imagem de capa, o módulo gera automaticamente um mosaico alternativo: um gradiente de cor estável, derivado do identificador da categoria, com a inicial do seu nome. A grelha mantém-se assim sempre homogénea, sem espaços vazios.

Utilização como widget

Para além da página de categoria, o mural pode ser inserido em qualquer ponto de um template, graças à interface de widget do PrestaShop.

{widget name='dfcategorywall'}

Para visar uma categoria específica, passe o seu identificador:

{widget name='dfcategorywall' id_category=12}

Resolução de problemas

O mural não aparece

• Verifique se a categoria consultada tem mesmo subcategorias ativas.
• Certifique-se de que o seu tema despoleta o hook displayContentWrapperTop. Caso contrário, use a inserção por widget descrita acima.

As subcategorias aparecem em duplicado

Ative a opção Ocultar a lista nativa das subcategorias para eliminar o bloco original do tema.

As setas do carrossel não aparecem

As setas só aparecem quando há mosaicos suficientes para ultrapassar a largura visível. No telemóvel, a navegação faz-se apenas com o dedo (deslocamento tátil).