Barra Admin no Front-Office: documentação
Instalar e utilizar a barra de administração no front-office: ligações de edição contextuais, limpeza da cache e restrição a SuperAdmin.
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
- No back-office, abra Módulos e depois o Gestor de módulos.
- Clique em Instalar um módulo e selecione o ficheiro dfadminbar.zip.
- 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.