# Barra Admin no Front-Office: documentação > Apresentação A Barra Admin no Front-Office acrescenta uma barra de administração preta, ao estilo do WordPress, no topo da sua loja PrestaShop 8 ou 9. Só é apresentada aos colaboradores… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/admin-bar-front-office-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/admin-bar-front-office-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/admin-bar-front-office-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/admin-bar-front-office-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/admin-bar-front-office-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/admin-bar-front-office-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/admin-bar-front-office-prestashop/index.md) - Índice: ## Apresentação A Barra Admin no Front-Office acrescenta uma barra de administração preta, ao estilo do WordPress, no topo da sua loja PrestaShop 8 ou 9. Só é apresentada aos colaboradores com sessão iniciada no back-office e dá acesso direto à edição do produto, da categoria ou da página CMS que está a ser consultada, além de um botão para limpar a cache. A barra é invisível para os seus visitantes: nenhum ficheiro CSS ou JavaScript do módulo é carregado para eles. ## Instalação 1. No back-office, abra Módulos e depois o Gestor de módulos. 2. Clique em Instalar um módulo e selecione o ficheiro dfadminbar.zip. 3. O módulo instala-se e regista automaticamente o nome da sua pasta de administração. A barra fica ativa de imediato: abra a sua loja no mesmo navegador da sua sessão de back-office e ela aparece no topo da página. ## Configuração Estão disponíveis quatro definições em Módulos, Gestor de módulos, Barra Admin no Front-Office, Configurar: - **Ativar a barra de administração**: interruptor geral do módulo. - **Apresentar o botão de limpeza da cache**: mostra ou oculta o botão Limpar a cache na barra. - **Restringir ao perfil SuperAdmin**: com esta opção ativa, só os colaboradores do perfil SuperAdmin veem a barra. Desativada, qualquer colaborador com sessão iniciada a vê. - **Apresentar os botões Ver no back-office**: acrescenta um botão Ver o produto ou Ver a categoria no cabeçalho do back-office, nas páginas de edição correspondentes. ## Utilização ### A barra A barra apresenta permanentemente três ligações para o back-office: Painel, Catálogo e Encomendas. O nome próprio do colaborador com sessão iniciada aparece à direita. As ligações incluem um token de back-office válido: chega diretamente à página de destino, sem página de início de sessão pelo meio. ### Ligações contextuais Consoante a página consultada, acrescenta-se uma ligação de edição à barra: - Ficha de produto: Editar este produto abre a página de edição do produto. - Página de categoria: Editar esta categoria abre a edição da categoria. - Página CMS: Editar esta página abre a edição da página CMS. No PrestaShop 8 e 9, o URL gerado é convertido automaticamente para a página de edição moderna do back-office. ### Botões Ver no back-office Na página de edição de um produto ou de uma categoria, um botão Ver o produto ou Ver a categoria é acrescentado ao cabeçalho preto do back-office, ao lado de Ver a minha loja. Abre a página correspondente do front-office num novo separador. Se o cabeçalho não contiver essa ligação (contexto multiloja com seletor de lojas), o botão aparece como um selo flutuante no canto inferior direito. ### Limpeza da cache O botão Limpar a cache despoleta uma chamada AJAX que limpa as caches Smarty e XML, a cache de Media (CCC) e regenera o índice de classes. A legenda do botão confirma a operação (Cache limpa). A cache do Symfony não é abrangida: limpá-la a partir do front-office provocaria tempos de resposta demasiado longos. ## Funcionamento técnico ### Deteção do colaborador O módulo lê o cookie de colaborador psAdmin do PrestaShop, valida o hash da palavra-passe com Employee::checkPassword() e verifica se a conta está ativa. Não é criada qualquer sessão adicional e o módulo não guarda nenhuma credencial. ### Ligações do back-office e tokens Cada ligação é construída com um token legacy calculado para o colaborador com sessão iniciada (Tools::getAdminToken). O PrestaShop converte depois o URL legacy para a rota moderna correspondente. A chamada AJAX de limpeza da cache está protegida por um token dedicado, associado ao identificador do colaborador. ### Pasta de administração O nome da pasta de administração é registado na instalação e depois atualizado sempre que a página de configuração é aberta. Se mudar o nome da pasta de administração, basta reabrir a configuração do módulo. ## Resolução de problemas - **A barra não aparece**: verifique se tem sessão iniciada no back-office no mesmo navegador, se o módulo está ativado na sua configuração e se a opção SuperAdmin não o exclui. - **A barra deixou de aparecer depois de mudar o nome da pasta de administração**: abra a página de configuração do módulo para voltar a registar o novo nome. - **Back-office noutro domínio**: o cookie de colaborador tem de ser partilhado entre a loja e o back-office, o que corresponde à instalação padrão do PrestaShop. Um back-office alojado num domínio diferente não é suportado. - **Tema personalizado sem o hook displayAfterBodyOpeningTag**: a barra é injetada por este hook. Se estiver ausente do seu tema, acrescente a respetiva chamada ao template principal. ## Registo de alterações - **1.1.0 (2026-08-22)**: botão Ver o produto e Ver a categoria no cabeçalho do back-office, nas páginas de edição correspondentes. Nova opção de configuração para ativar ou desativar estes botões. - **1.0.0 (2026-08-12)**: primeira versão pública. Barra de administração no front-office, ligações de edição contextuais de produto, categoria e CMS, limpeza da cache por AJAX, restrição a SuperAdmin, traduções FR, EN, ES, DE, IT e PL.