# 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… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/page-categorie-visuelle-category-wall/index.md), [en](https://www.datafirefly.com/en/documentation/page-categorie-visuelle-category-wall/index.md), [es](https://www.datafirefly.com/es/documentation/page-categorie-visuelle-category-wall/index.md), [de](https://www.datafirefly.com/de/documentation/page-categorie-visuelle-category-wall/index.md), [it](https://www.datafirefly.com/it/documentation/page-categorie-visuelle-category-wall/index.md), [pl](https://www.datafirefly.com/pl/documentation/page-categorie-visuelle-category-wall/index.md), [nl](https://www.datafirefly.com/nl/documentation/page-categorie-visuelle-category-wall/index.md) - Índice: 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. O módulo é compatível com o PrestaShop 8.0 a 9.x, funciona em multiloja e não acrescenta qualquer override de template. Pode, por isso, ser instalado e desinstalado em segurança. ## 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. Só são contados os produtos ativos e visíveis no catálogo. O cálculo é feito numa única consulta agrupada e guardada em cache: ativar os contadores não tem impacto assinalável no tempo de carregamento. ### 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. Para um melhor resultado, acrescente uma imagem a cada subcategoria em **Catálogo > Categorias**. O módulo utiliza o formato de imagem «category» definido nas definições de imagens da sua loja. ## 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). Precisa de ajuda? Contacte o apoio da DataFirefly a partir da sua área de cliente, indicando a sua versão do PrestaShop e o tema utilizado.