# dfbulkcategory: atribuição de categorias em massa > Apresentação O dfbulkcategory acrescenta duas ações em massa à lista de produtos do back-office PrestaShop: Adicionar a uma categoria e Remover de uma categoria. Selecione os seus produtos com as… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfbulkcategory/index.md), [en](https://www.datafirefly.com/en/documentation/dfbulkcategory/index.md), [es](https://www.datafirefly.com/es/documentation/dfbulkcategory/index.md), [de](https://www.datafirefly.com/de/documentation/dfbulkcategory/index.md), [it](https://www.datafirefly.com/it/documentation/dfbulkcategory/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfbulkcategory/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfbulkcategory/index.md) - Índice: ## Apresentação O dfbulkcategory acrescenta duas ações em massa à lista de produtos do back-office PrestaShop: **Adicionar a uma categoria** e **Remover de uma categoria**. Selecione os seus produtos com as caixas de seleção nativas, escolha uma ou várias categorias numa janela modal com árvore e pesquisa, confirme: a operação é executada em AJAX sem recarregar a página. O módulo é compatível com **PrestaShop 8.0.0 a 9.99.99** e funciona em multiloja. Não cria nenhuma tabela SQL nem modifica nenhum ficheiro do núcleo. ## Instalação 1. Descarregue o ficheiro ZIP do módulo a partir da sua conta DataFirefly. 2. No back-office PrestaShop, vá a **Módulos → Gestor de módulos → Instalar um módulo**. 3. Arraste e largue o ficheiro `dfbulkcategory.zip` e valide. 4. O módulo está pronto imediatamente: não é necessária nenhuma configuração. Na instalação, o módulo regista um separador de administração oculto necessário aos controlos de acesso do PrestaShop 9. Nenhuma entrada visível é acrescentada ao seu menu do back-office. ### Atualização a partir da versão 1.0.0 Substitua simplesmente o módulo pela nova versão através de **Instalar um módulo** (ou do botão Atualizar). Um script de upgrade é executado automaticamente e instala o separador de administração exigido pelo PrestaShop 9 nas instalações existentes. Não é necessária nenhuma ação manual. ## Utilização ### Adicionar produtos a categorias 1. Abra **Catálogo → Produtos**. 2. Marque os produtos a modificar (a caixa do cabeçalho seleciona toda a página). 3. Abra o menu **Ações em massa** e clique em **Adicionar a uma categoria**. 4. Na janela modal, marque uma ou várias categorias na árvore e clique em **Aplicar**. As categorias marcadas são acrescentadas às categorias existentes de cada produto: nada é sobrescrito. ### Remover produtos de categorias Mesmo princípio com o separador **Remover de uma categoria** da janela modal. As categorias marcadas são removidas de cada produto selecionado. A categoria por defeito de um produto nunca é removida: se fizer parte das categorias a remover, o módulo conserva-a automaticamente para que o produto mantenha sempre uma categoria principal. ### Modo combinado (adicionar e remover numa só operação) O separador **Ambos** mostra dois painéis lado a lado: à esquerda as categorias a adicionar, à direita as a remover. É o modo ideal para mover produtos de uma categoria para outra numa única confirmação. ### Pesquisa e navegação na árvore O campo de pesquisa filtra a árvore em tempo real e expande automaticamente os ramos que contêm resultados. Os botões **Expandir tudo** e **Recolher tudo** permitem navegar rapidamente nas grandes árvores. ### Categorias desativadas Por defeito, só são apresentadas as categorias ativas. Ative o interruptor **Mostrar as categorias desativadas** no topo da janela modal para as incluir, útil durante uma reestruturação de catálogo. As categorias desativadas são assinaladas por um badge. ## Multiloja Cada operação é executada no contexto da loja ativa no back-office: - A árvore de categorias apresentada é a da loja atual. - O módulo verifica que cada produto selecionado pertence de facto a essa loja antes da modificação. - As associações de categorias das outras lojas não são afetadas. Em contexto « Todas as lojas », selecione primeiro uma loja precisa no seletor multiloja para visar corretamente as associações. ## Compatibilidade PrestaShop 9 Desde a versão 1.1.0, o módulo é inteiramente compatível com o PrestaShop 9: - Os URLs AJAX são gerados do lado do servidor segundo o mecanismo esperado pelo PrestaShop 9 (token incluído). - É registado um separador de administração oculto para satisfazer os controlos de acesso reforçados: os colaboradores que não são superadministradores podem usar o módulo desde que tenham acesso ao catálogo. - O funcionamento no PrestaShop 8.0, 8.1 e 8.2 mantém-se inalterado. ## Resolução de problemas ### Os botões não aparecem no menu Ações em massa Limpe a cache do PrestaShop (**Parâmetros avançados → Desempenho → Limpar a cache**) e recarregue a página de produtos com Ctrl+F5. Verifique também que o módulo está instalado e ativado no Gestor de módulos. ### Erro « Acesso negado » ao aplicar No PrestaShop 9, este erro indica geralmente que o separador de administração do módulo está em falta (instalação anterior à 1.1.0). Reinstale o módulo ou aplique a atualização: o script de upgrade recria o separador automaticamente. ### Um produto não foi modificado A mensagem de resultado detalha os produtos ignorados. As causas habituais: o produto não está associado à loja ativa (multiloja), ou foi eliminado entre a seleção e a confirmação. ## Changelog ### 1.1.0 (2 de julho de 2026) - Compatibilidade PrestaShop 9 (intervalo suportado: 8.0.0 a 9.99.99) - URLs AJAX gerados do lado do servidor (conformes PS9) - Separador de administração oculto registado na instalação para os controlos de acesso do PrestaShop 9 - Script de atualização automática para as instalações 1.0.0 existentes - Etiquetas de categorias sistematicamente filtradas por loja - Apresentação segura das mensagens de erro na janela modal ### 1.0.0 (11 de fevereiro de 2026) - Primeira versão pública - Ações em massa Adicionar / Remover na lista de produtos - Janela modal com árvore de categorias, pesquisa em tempo real, modo combinado - Opção de categorias desativadas, gestão multiloja, preservação da categoria por defeito