Apresentação
O Activity Notifications é um plugin de sistema para Joomla, desenvolvido pelo MundoPHPBB, que complementa o mecanismo de notificações do componente Sociable.
Em comunidades com atividades frequentes, é importante que os usuários consigam acompanhar novas interações enquanto navegam pelo site. Dependendo do comportamento da interface, o contador e a lista de notificações podem não refletir imediatamente as novidades sem uma nova atualização da página.
O Activity Notifications foi criado para melhorar essa experiência.
Ele consulta periodicamente os recursos de notificações disponibilizados pelo Sociable e atualiza a interface do módulo de notificações já existente. Também pode mostrar um pequeno aviso na tela quando identifica uma notificação nova.
O funcionamento é automático, mas é importante distinguir: o plugin realiza consultas periódicas (polling), não utiliza comunicação instantânea por push ou WebSocket. Com a configuração padrão, a verificação é realizada a cada 20 segundos enquanto a página está ativa.
Tudo isso é implementado como um plugin independente, sem modificar os arquivos originais do Sociable ou criar novas tabelas no banco de dados.
Principais recursos
1. Atualização automática das notificações
O principal recurso do Activity Notifications é atualizar as informações de notificações durante a navegação, sem exigir que o visitante recarregue a página manualmente.
Quando o membro está autenticado e uma página contém o módulo de notificações do Sociable, o plugin consulta a API do componente em intervalos configuráveis.
A cada verificação bem-sucedida, ele pode atualizar:
- O número de notificações não lidas.
- A lista de notificações recentes.
- A indicação visual de itens ainda não lidos.
- A identificação de notificações novas para eventual exibição de aviso.
Dessa forma, a comunidade ganha uma experiência de acompanhamento mais dinâmica, preservando o sistema de notificações do componente original.
2. Contador de notificações não lidas
O plugin atualiza o contador associado ao sino de notificações disponibilizado pelo Sociable.
Quando existem notificações não lidas, o contador apresenta a quantidade correspondente. Caso a contagem seja zero, o indicador numérico é removido ou ocultado, conforme a área da interface.
Para quantidades superiores a 99, o indicador visual utiliza a representação 99+, evitando que números muito grandes prejudiquem a apresentação.
O contador reflete as informações fornecidas pela API do Sociable; o plugin não cria, por conta própria, novos registros de notificação.
3. Lista de notificações recentes
Além do número de notificações não lidas, o Activity Notifications atualiza a relação de notificações apresentada no módulo já existente.
O plugin solicita até 10 itens por consulta e utiliza os dados retornados para montar a listagem.
Conforme as informações disponíveis em cada registro, a interface pode apresentar:
- O nome de quem realizou a interação.
- Uma mensagem relacionada à notificação.
- Um ícone associado ao tipo de atividade.
- O tempo decorrido desde a ocorrência.
- Uma marca visual para notificações não lidas.
- Um link para acessar o conteúdo relacionado.
Essa listagem ajuda o usuário a identificar as novidades mais recentes sem precisar atualizar a página inteira.
4. Avisos discretos na tela
O Activity Notifications pode exibir um pequeno aviso quando identifica uma nova notificação após a primeira consulta.
Esse aviso aparece no canto inferior direito da tela e inclui uma identificação da notificação e uma mensagem resumida.
O usuário pode clicar no aviso para abrir o conteúdo relacionado. Caso não interaja, o aviso é removido automaticamente após aproximadamente 7 segundos.
A apresentação foi projetada para ser discreta e não substituir a navegação normal do Sociable.
Importante: quando diversas notificações novas são identificadas na mesma verificação, a implementação da versão 1.0.0 pode apresentar somente um aviso nessa atualização. A lista e o contador continuam sendo atualizados com os dados recebidos.
5. Avisos apenas para comentários e respostas
O administrador pode optar por limitar os avisos discretos aos tipos de interação mais relevantes para uma comunidade de conversas.
Com a configuração Avisar somente comentários e respostas habilitada, os avisos na tela são reservados às notificações identificadas como:
- Comentário: alguém comentou uma publicação do usuário.
- Resposta: alguém respondeu a um comentário do usuário.
Essa opção não filtra o sino nem a lista de notificações. Os demais tipos continuam sendo consultados e exibidos normalmente na interface do Sociable.
Assim, a configuração controla somente os avisos adicionais, não o funcionamento geral das notificações.
6. Acesso ao conteúdo relacionado
Cada item da listagem e cada aviso discreto são apresentados como links clicáveis.
Quando a notificação fornece um endereço específico, o plugin utiliza esse endereço para encaminhar o usuário à atividade relacionada.
Nos casos em que não há um link direto, o código possui um mecanismo de retorno à área de atividades ou de notificações do Sociable, conforme os identificadores disponíveis.
O objetivo é facilitar a passagem da notificação para a conversa ou publicação que originou a interação.
7. Intervalo de atualização configurável
O administrador controla a frequência de consulta por meio de uma opção própria do plugin.
A configuração permite valores entre 10 e 300 segundos, com 20 segundos como padrão.
Intervalos menores podem tornar a atualização mais frequente, mas também aumentam a quantidade de requisições feitas ao servidor. Intervalos maiores reduzem essas consultas, embora as novidades possam demorar mais para aparecer.
Essa flexibilidade permite adaptar o comportamento ao volume de acessos e à capacidade do ambiente de hospedagem.
8. Comportamento adaptado à atividade da página
O plugin evita executar consultas de atualização quando a aba do navegador está oculta.
Quando o usuário volta à aba ou a janela recupera o foco, uma nova verificação é solicitada.
Essa estratégia ajuda a evitar consultas desnecessárias enquanto a página não está sendo visualizada e permite atualizar as informações quando o membro retoma a navegação.
Também há proteção contra a execução simultânea de várias consultas pelo mesmo script, reduzindo a possibilidade de verificações sobrepostas.
9. Integração com o módulo existente do Sociable
O Activity Notifications não cria um novo sino independente e não substitui o módulo de notificações do Sociable.
Ele foi desenvolvido para trabalhar com a estrutura do módulo existente, identificada no código pela classe mod-sociable-notifications.
Por isso, é necessário que o módulo de notificações do Sociable esteja presente na página para que o contador e a lista sejam atualizados.
Essa abordagem permite aproveitar a interface e os registros do componente original, acrescentando o comportamento automático sem duplicar o sistema de notificações.
10. Arquivos de idioma em português e inglês
O pacote inclui arquivos de idioma para:
- Português do Brasil (
pt-BR). - Inglês (
en-GB).
Esses arquivos abrangem o nome, a descrição, as opções administrativas e as principais mensagens do plugin.
A tradução da interface geral do Sociable continua dependendo dos próprios arquivos de idioma daquele componente. Alguns elementos gerados diretamente pelo JavaScript também podem exigir ajustes para uma localização integral em outros idiomas.
Requisitos do sistema
| Requisito | Descrição |
|---|---|
| CMS | Joomla, em versão compatível com a arquitetura do plugin |
| Extensão necessária | Sociable (com_sociable) |
| Elemento da interface necessário | Módulo de notificações do Sociable exibido na página |
| Usuários atendidos | Membros autenticados na área pública do site |
| Tipo | Plugin de sistema Joomla |
| Versão do plugin | 1.0.0 |
| Instalação | Gerenciador de extensões Joomla |
| Modificações no core do Sociable | Não necessárias |
| Novas tabelas no banco de dados | Não |
| Idiomas incluídos | Português do Brasil e inglês |
Importante: o pacote não declara uma versão mínima ou uma matriz de compatibilidade específica para Joomla e Sociable. Antes de instalar em produção, confirme o funcionamento no conjunto de versões utilizado em seu site. O código depende das rotas de API de notificações e da estrutura HTML do módulo Sociable disponíveis nesse ambiente.
Como instalar o Activity Notifications
A instalação utiliza o procedimento padrão para plugins do Joomla.
Etapa 1 — Baixar o plugin
Faça o download do pacote de instalação disponibilizado na área de downloads deste site.
Pacote da versão 1.0.0:
plg_system_activitynotifications_1.0.0.zip
O arquivo ZIP deve ser enviado diretamente ao instalador do Joomla. Não é necessário descompactá-lo.
Etapa 2 — Acessar o painel administrativo
Entre na administração do Joomla com uma conta autorizada a instalar extensões.
Acesse:
Sistema → Instalar → Extensões
Etapa 3 — Instalar o pacote
Na tela de instalação:
- Escolha a opção de envio de arquivo.
- Localize o ZIP do Activity Notifications.
- Envie o arquivo ao servidor.
- Aguarde a confirmação do Joomla.
Se o procedimento for concluído corretamente, o sistema deverá apresentar uma mensagem de instalação bem-sucedida.
Etapa 4 — Habilitar o plugin
Depois da instalação, acesse:
Sistema → Gerenciar → Plugins
Pesquise por Notificações de atividade ou Activity Notifications, conforme o idioma utilizado no painel.
Abra a configuração do plugin, altere o estado para Habilitado e clique em Salvar e Fechar.
Etapa 5 — Verificar o módulo do Sociable
Confirme que o módulo de notificações do Sociable está configurado e aparece nas páginas destinadas aos usuários autenticados.
O Activity Notifications trabalha sobre esse módulo. Se ele não estiver presente, o plugin não terá o sino ou a lista sobre os quais aplicar as atualizações.
Etapa 6 — Limpar o cache e testar
Se o Joomla ou o ambiente de hospedagem utilizar cache, limpe-o após a instalação.
Em seguida:
- Acesse a área pública com uma conta de usuário.
- Verifique a presença do sino de notificações do Sociable.
- Confirme se o contador e a lista carregam normalmente.
- Faça uma interação de teste com outra conta, quando possível.
- Aguarde o intervalo configurado e observe a atualização.
O ideal é realizar primeiro esse procedimento em um ambiente de homologação.
Como configurar o plugin
O Activity Notifications oferece três opções administrativas principais.
Intervalo de atualização (segundos)
Define o tempo entre as verificações de novas notificações.
| Propriedade | Valor |
|---|---|
| Configuração | Intervalo de atualização (segundos) |
| Padrão | 20 segundos |
| Mínimo | 10 segundos |
| Máximo | 300 segundos |
| Função | Consultar periodicamente a quantidade e a lista de notificações |
O valor padrão de 20 segundos é um ponto de partida. Em sites com grande número de membros simultaneamente conectados, pode ser conveniente testar intervalos maiores para diminuir o volume de requisições.
Mostrar aviso discreto
Controla a exibição do pequeno aviso na tela quando o plugin identifica uma notificação nova.
- Sim: permite mostrar os avisos discretos.
- Não: desativa esses avisos.
Valor padrão: Sim.
Mesmo com essa opção desativada, o plugin continua atualizando o contador e a lista de notificações do módulo Sociable.
Avisar somente comentários e respostas
Permite limitar os avisos discretos a notificações de comentário e resposta.
- Sim: apresenta avisos somente para essas duas categorias de notificação.
- Não: permite avisos para os tipos de notificação identificados pelo script.
Valor padrão: Não.
Essa opção não desativa outras notificações no sino, não altera os registros armazenados pelo Sociable e não modifica suas regras de geração de notificações.
Configuração recomendada
Para começar a utilizar o plugin em uma comunidade, uma configuração inicial é:
| Configuração | Valor sugerido |
|---|---|
| Plugin habilitado | Sim |
| Intervalo de atualização | 20 segundos |
| Mostrar aviso discreto | Sim |
| Avisar somente comentários e respostas | Conforme a preferência da comunidade |
| Módulo de notificações do Sociable | Publicado nas páginas desejadas |
| Cache | Limpar após a instalação ou atualização |
Em ambientes com muitos usuários simultâneos, avalie o uso de intervalos maiores, como 30 ou 60 segundos, depois de verificar o comportamento e a carga do servidor.
Como utilizar as notificações
Acessar o site com uma conta de usuário
O plugin atua na área pública do Joomla para usuários autenticados.
Ele não executa a atualização para visitantes anônimos nem foi projetado para atualizar notificações no painel administrativo.
Acompanhar o sino de notificações
Ao abrir uma página que contém o módulo de notificações do Sociable, o plugin realiza uma consulta inicial.
Depois, enquanto a página estiver visível, novas verificações ocorrem conforme o intervalo definido pelo administrador.
Quando o servidor retorna uma contagem diferente de notificações não lidas, o indicador do sino é atualizado.
Consultar as últimas notificações
A lista do módulo é atualizada com até 10 registros retornados pela API em cada consulta.
O usuário pode identificar o tipo de interação, verificar o tempo aproximado e clicar no item que deseja consultar.
Receber um aviso de nova atividade
Quando uma notificação é detectada depois da primeira consulta, e os avisos estão habilitados, o plugin pode apresentar uma mensagem discreta.
O aviso permanece visível por aproximadamente sete segundos, a menos que o usuário clique nele para abrir o conteúdo associado.
As notificações já existentes no carregamento inicial são usadas como referência e não devem gerar avisos retroativos.
Retomar a navegação após trocar de aba
Se o usuário permanecer em outra aba, as verificações periódicas ficam suspensas enquanto a página estiver oculta.
Ao retornar, o plugin faz nova consulta para atualizar o estado das notificações.
Qual é a diferença entre o sino e o aviso discreto?
O Activity Notifications utiliza duas formas complementares de apresentar informações ao usuário.
| Sino e lista de notificações | Aviso discreto na tela |
|---|---|
| Integram o módulo existente do Sociable | São acrescentados pelo plugin |
| Exibem informações de notificações recentes | Destacam uma notificação nova identificada |
| Mostram a contagem de não lidas | Apresentam uma mensagem temporária |
| Continuam sendo atualizados com os avisos desligados | Podem ser ativados ou desativados |
| Abrangem os tipos retornados pela API | Podem ser restritos a comentários e respostas |
| Dependem do módulo visível na página | Também dependem da atualização vinculada ao módulo |
Os avisos são opcionais. Desativá-los não impede a atualização automática do sino e da lista.
Vantagens do Activity Notifications
Acompanhamento mais prático das interações
Os membros podem receber informações atualizadas enquanto utilizam o site, sem precisar atualizar a página manualmente para conferir o contador de notificações.
Maior visibilidade para comentários e respostas
Comentários e respostas são interações importantes em comunidades. Os avisos discretos podem chamar a atenção para essas atividades, ajudando o usuário a retomar uma conversa.
Aproveitamento da estrutura do Sociable
O plugin utiliza o sistema de notificações do componente existente, incluindo os dados e os links devolvidos pela API. Não mantém uma estrutura paralela de notificações.
Controle administrativo simples
As três opções do plugin permitem ajustar a frequência das verificações e o comportamento dos avisos sem exigir alterações no código.
Funcionamento independente
Por ser instalado como plugin de sistema do Joomla, pode ser habilitado ou desabilitado separadamente, sem editar arquivos internos do Sociable.
Redução de verificações desnecessárias
A suspensão das consultas durante a ocultação da aba ajuda a reduzir requisições que não seriam úteis naquele momento.
Solução de problemas
O sino de notificações não é atualizado
Verifique se:
- O Activity Notifications foi instalado e habilitado.
- O usuário está autenticado no site.
- O módulo de notificações do Sociable está presente na página.
- O componente Sociable e suas notificações funcionam normalmente sem o plugin.
- As rotas de API utilizadas pelo Sociable respondem corretamente.
- O navegador não está utilizando uma versão antiga do JavaScript em cache.
Se necessário, examine o console e a guia de rede das ferramentas de desenvolvedor do navegador. O plugin foi programado para não apresentar alertas de erro quando uma consulta falha, preservando a operação normal do módulo.
O contador muda, mas nenhum aviso aparece
Confira as configurações:
- Mostrar aviso discreto → Sim.
- Avisar somente comentários e respostas: verifique se o tipo de interação corresponde ao filtro selecionado.
Lembre-se de que o aviso é reservado à detecção de novidades depois da primeira consulta e desaparece após cerca de sete segundos.
Já existem notificações, mas o plugin não mostra um aviso ao abrir a página
Esse comportamento é esperado.
Na primeira consulta, o plugin registra a notificação mais recente como referência. Os avisos são destinados às novidades detectadas depois disso, evitando apresentar mensagens antigas como se tivessem acabado de chegar.
Uma nova notificação demorou a aparecer
O Activity Notifications usa consultas periódicas, não uma conexão instantânea com o servidor.
Verifique o intervalo configurado. Também considere que a atualização é suspensa enquanto a aba está oculta e retomada quando o usuário retorna.
O plugin está habilitado, mas não acontece nada em determinada página
Confirme se o módulo de notificações do Sociable aparece naquela página.
A versão 1.0.0 só executa a consulta de atualização quando encontra a estrutura HTML utilizada por esse módulo. Ela não cria o sino automaticamente em páginas que não o possuem.
O link de uma notificação abre uma página inesperada
O plugin prioriza os endereços fornecidos nos dados da notificação e, quando necessário, utiliza uma rota alternativa para o feed do Sociable.
Verifique o funcionamento dos links gerados pelo componente, as configurações de roteamento e eventuais alterações na estrutura de URLs após atualizações.
O aviso apresenta problemas de aparência
O aviso discreto da versão 1.0.0 utiliza estilos próprios definidos pelo JavaScript, com fundo claro e posição fixa no canto inferior direito.
Em temas muito personalizados ou escuros, sua aparência pode exigir uma adaptação visual. O pacote analisado não inclui uma opção administrativa específica para escolher o tema do aviso.
O plugin deixou de funcionar após uma atualização do Sociable
Atualizações do componente podem modificar as rotas de notificação, o formato da resposta da API ou a estrutura HTML do módulo.
Nesses casos, confirme se a versão utilizada continua oferecendo os recursos esperados pelo Activity Notifications. Teste a integração antes de atualizar o site de produção.
Perguntas frequentes (FAQ)
O Activity Notifications substitui o Sociable?
Não. Ele é um complemento para o sistema de notificações do Sociable. O componente original continua responsável por criar, armazenar e fornecer os registros de notificações.
Posso utilizar o plugin sem o Sociable?
Não para a finalidade para a qual foi desenvolvido. O código depende da API de notificações e do módulo de interface do Sociable.
Ele funciona com o Community Answers?
Esta versão não foi desenvolvida para o Community Answers. A integração analisada é específica para o Sociable, diferentemente de outros plugins publicados no site.
O plugin cria um novo sino de notificações?
Não. Ele atualiza a interface do módulo de notificações já disponibilizado pelo Sociable.
As notificações são realmente instantâneas?
Não no sentido técnico de comunicação instantânea. A atualização ocorre por consultas periódicas, com intervalos configuráveis entre 10 e 300 segundos.
Posso desativar os avisos e continuar atualizando o sino?
Sim. A opção Mostrar aviso discreto controla os avisos temporários. O contador e a lista continuam sendo atualizados.
Posso receber avisos apenas de comentários e respostas?
Sim. Ative Avisar somente comentários e respostas. Essa opção filtra os avisos discretos, não a lista completa de notificações.
O plugin envia e-mails ou notificações push para o celular?
Não. A versão 1.0.0 atua sobre a página aberta no navegador e não implementa envio de e-mails, push do sistema operacional ou notificações por WebSocket.
O plugin funciona para visitantes que não estão conectados?
Não. O código carrega o recurso somente para usuários autenticados na área pública do Joomla.
Ele marca automaticamente notificações como lidas?
Não. O script analisado atualiza os dados apresentados, mas não executa uma operação própria para marcar notificações como lidas. Esse comportamento continua sob responsabilidade do Sociable.
Quantos itens o plugin apresenta na lista?
A versão 1.0.0 solicita até 10 notificações por consulta. O contador de não lidas é consultado separadamente e pode representar uma quantidade maior.
Posso desativar ou desinstalar o plugin sem perder minhas notificações?
O plugin não cria uma base paralela de notificações nem altera as tabelas do Sociable. Desativá-lo interrompe os recursos adicionais de atualização e aviso, sem a intenção de apagar notificações já registradas pelo componente.
O plugin possui tradução para português?
Sim. O pacote inclui arquivos de idioma pt-BR e en-GB para as configurações e mensagens principais do plugin. A tradução completa do próprio Sociable é independente.
Funciona com qualquer versão do Joomla e do Sociable?
Não há essa garantia no pacote. A versão 1.0.0 não especifica uma matriz de compatibilidade nem documenta testes com versões determinadas. Recomenda-se conferir a integração no ambiente de destino.
Histórico de desenvolvimento
Versão 1.0.0 — Lançamento inicial
A versão 1.0.0 reúne os seguintes recursos identificados no pacote:
- Atualização periódica do contador de notificações não lidas.
- Atualização da lista de até 10 notificações recentes.
- Identificação visual de notificações não lidas.
- Avisos discretos para novas notificações detectadas.
- Filtro opcional de avisos para comentários e respostas.
- Intervalo de atualização configurável de 10 a 300 segundos.
- Suspensão das consultas enquanto a aba está oculta.
- Nova verificação ao recuperar a visibilidade ou o foco.
- Aproveitamento dos links de atividades fornecidos pelo Sociable.
- Arquivos de idioma em português do Brasil e inglês.
- Instalação independente, sem alterações no núcleo do componente.
O manifesto de instalação identifica o lançamento como versão 1.0.0, com data de criação indicada como outubro de 2026.
Informações técnicas
| Informação | Valor |
|---|---|
| Nome | Activity Notifications |
| Nome no painel em português | Notificações de atividade |
| Versão | 1.0.0 |
| Desenvolvedor | MundoPHPBB |
| Plataforma | Joomla |
| Tipo | System Plugin |
| Grupo | system |
| Identificador | activitynotifications |
| Componente integrado | Sociable (com_sociable) |
| Estrutura do módulo utilizada | .mod-sociable-notifications |
| Rotas consultadas | notifications.getUnreadCount e notifications.list |
| Limite da lista por consulta | 10 notificações |
| Intervalo padrão | 20 segundos |
| Intervalo permitido | 10 a 300 segundos |
| Avisos discretos | Opcionais; ativados por padrão |
| Filtro de avisos | Comentários e respostas, opcional |
| Área de funcionamento | Site público, para usuários autenticados |
| Idiomas fornecidos | pt-BR e en-GB |
| Formato de distribuição | ZIP |
| Arquivo de distribuição | plg_system_activitynotifications_1.0.0.zip |
| Modificações no core do Sociable | Não |
| Novas tabelas de banco de dados | Não |
| Licença declarada | GNU GPL versão 2 ou posterior |
| Data indicada no manifesto | Outubro de 2026 |
Observação: o Activity Notifications é um complemento independente desenvolvido pelo MundoPHPBB. O pacote analisado não apresenta indicação de que seja parte da distribuição oficial do Sociable.
Recomendações para administradores
Antes de disponibilizar o plugin aos membros da comunidade, confirme que o próprio sistema de notificações do Sociable está instalado, publicado e funcionando corretamente.
Utilize o intervalo padrão como referência inicial, mas acompanhe o comportamento do servidor em períodos de maior acesso. Cada atualização bem-sucedida envolve solicitações à API, e a frequência deve considerar o número de usuários conectados simultaneamente.
Para comunidades que priorizam conversas, vale experimentar a opção de avisos apenas para comentários e respostas. Isso pode tornar os avisos menos intrusivos sem prejudicar a atualização geral das notificações.
Também é recomendável verificar a apresentação visual dos avisos no template utilizado, especialmente em sites com tema escuro ou personalizações extensas.
Como acontece com integrações independentes, teste o plugin em ambiente separado sempre que atualizar o Joomla, o Sociable ou o módulo de notificações.
Considerações finais
O Activity Notifications foi desenvolvido para tornar o acompanhamento das atividades no Sociable mais prático e dinâmico.
Seu principal objetivo é atualizar automaticamente a experiência de notificações já oferecida pelo componente, permitindo que o usuário acompanhe novidades enquanto navega pelo site.
Com contador de não lidas atualizado, lista de notificações recentes, avisos discretos opcionais e controle sobre o intervalo de consultas, o plugin complementa o Sociable sem criar outro sistema de notificações.
Tudo isso por meio de uma instalação independente no Joomla, preservando os arquivos originais do componente.
Facilite o acompanhamento das conversas e mantenha os membros da sua comunidade mais próximos das novas atividades com o Activity Notifications.
Consulte a área de downloads para obter a versão disponível e acompanhar futuras atualizações.