Banners
O plugin Banners gerencia os banners, os anunciantes e as categorias do componente Banners do Joomla, além de fornecer estatísticas de impressões e cliques.
Estas ferramentas dizem respeito ao componente Banners (com_banners). Elas só são disponibilizadas ao assistente se esse componente estiver ativado no site: geralmente ele vem desativado por padrão; se necessário, ative-o em Sistema → Gerenciar → Extensões. Toda ação exige acesso ao gerenciador de banners (core.manage), assim como na administração, além da permissão indicada na coluna “Direitos necessários”. Para os banners, as permissões são verificadas na categoria correspondente.
Banners
Criar e manter banners atualizados: imagem ou código personalizado, link, cliente, limite de impressões, datas de exibição.
| Ferramenta | Função | Direitos necessários (ACL) |
|---|---|---|
get_banners_status | Visão geral: opções, banners por estado, banners expirados ou que atingiram o limite, módulos Banners publicados | Acesso administrativo — core.manage |
list_banners | Listar os banners com impressões, limite, cliques e taxa de cliques | Acesso administrativo — core.manage |
get_banner | Ler um banner, incluindo o rastreamento efetivamente aplicado | Acesso administrativo — core.manage |
create_banner | Criar um banner de imagem ou personalizado | Acesso administrativo + Criar na categoria — core.manage + core.create |
update_banner | Editar um banner (somente os campos fornecidos serão alterados) | Acesso administrativo + Editar — core.manage + core.edit (ou core.edit.own para o próprio autor) |
set_banner_state | Publicar, despublicar, arquivar, mover para a lixeira, fixar | Acesso administrativo + Editar estado — core.manage + core.edit.state |
delete_banners | Excluir permanentemente os banners enviados para a lixeira | Acesso administrativo + Excluir — core.manage + core.delete |
Estatísticas
Acompanhar a veiculação e a eficácia das campanhas.
| Ferramenta | Função | Permissões necessárias (ACL) |
|---|---|---|
get_banner_stats | Impressões e cliques por dia, por mês ou no total, por banner, cliente ou categoria | Acesso administrativo — core.manage |
reset_banner_stats | Zerar os contadores de impressões e cliques e, opcionalmente, o histórico | Acesso administrativo + Editar — core.manage + core.edit |
As estatísticas detalhadas contabilizam apenas o que o Joomla registrou : o acompanhamento de impressões e cliques é configurado por banner, depois por cliente ou, por fim, nas opções do componente. A resposta de get_banner_stats informa quais banners estão com o acompanhamento desativado.
Clientes e categorias
Gerenciar anunciantes e a organização das campanhas.
| Ferramenta | Função | Permissões necessárias (ACL) |
|---|---|---|
list_banner_clients | Listar os clientes, com seus banners e totais | Acesso administrativo — core.manage |
create_banner_client | Criar um cliente anunciante | Acesso administrativo + Criar — core.manage + core.create |
update_banner_client | Editar um cliente | Acesso administrativo + Editar — core.manage + core.edit |
list_banner_categories | Listar as categorias de banners | Acesso administrativo — core.manage |
create_banner_category | Criar uma categoria de banners | Acesso administrativo + Criar — core.manage + core.create |
Bom saber
- Um banner só é exibido onde houver um módulo Banners publicado :
get_banners_statusos lista e avisa caso não haja nenhum. - O código personalizado de um banner é inserido tal como está nas páginas. Por segurança, ele só é aceito para usuários autorizados a publicar HTML sem filtragem (filtros de texto da configuração global) ; os demais devem usar um banner de imagem.
- As datas de início e término da veiculação são expressas no fuso horário do site.
- A exclusão definitiva e a zeragem das estatísticas são feitas em duas etapas : primeiro uma prévia, depois a execução após sua confirmação.
- Criações, edições, alterações de estado e exclusões aparecem no registro de ações do Joomla.
Exemplos de prompts
“Quais banners receberam mais cliques no mês passado?”
“Crie um banner para a promoção de primavera com a imagem images/banners/printemps.jpg, veiculado até 30 de abril, para o cliente Garage Martin.”