=== F5HLive Chat ===
Contributors: f5hlive
Tags: chat, live chat, websocket, realtime, pusher
Requires at least: 5.8
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Chat em tempo real para WordPress usando o servidor WebSocket F5HLive.

== Description ==

O **F5HLive Chat** adiciona um chat em tempo real ao seu site WordPress usando a infraestrutura de alta performance da F5HLive.

Todo o processamento de mensagens ocorre em nossos servidores via WebSockets ou Server-Sent Events (SSE), garantindo que o seu servidor WordPress permaneça leve e sem sobrecarga no banco de dados. 
Ideal para comunidades movimentadas!

O plugin oferece suporte tanto para visitantes quanto para usuários registrados, com controles administrativos avançados e uma experiência de usuário moderna.

= Funcionalidades v1 =
* ⚡ Chat público em tempo real via WebSocket e SSE
* 💬 Botão flutuante configurável para todas as páginas
* 🔑 Painel administrativo simplificado para credenciais (API Key, App ID, Secret Key, Cluster)
* 🔒 Suporte completo a TLS (WSS) — funciona perfeitamente em HTTP e HTTPS
* 👤 Integração nativa com usuários logados do WordPress e suporte a visitantes
* 🎨 Avatares modernos gerados automaticamente
* 📋 Shortcode flexível para incorporar o chat onde quiser
* 📱 Design responsivo otimizado para dispositivos móveis

== Recursos ==
* Chat público em tempo real 
* Acesso opcional ao chat para convidados/visitantes 
* Modo somente para usuários registrados 
* Mensagens privadas entre usuários 
* Modos de disponibilidade do usuário (Disponível, Ocupado, Não perturbe)
* Controles de privacidade do usuário 
* Janela de chat flutuante 
* Interface de chat expansível 
* Suporte a chat em linha 
* Modo claro e escuro 
* Cores personalizáveis 
* Exibição opcional de rodapé 
* Indicador de digitação em tempo real 
* Interface rápida e leve 
* Suporte estável a várias abas do navegador

== Controles de administração ==
Os administradores podem: 
* Habilitar ou desabilitar o acesso de visitantes 
* Habilitar o modo somente para usuários registrados 
* Personalizar as cores e a aparência do chat 
* Controlar a visibilidade do rodapé 
* Configurar o modo flutuante ou em linha 
* Gerenciar as credenciais da API diretamente do painel de administração do WordPress

== Configuração fácil ==
Para usar o plugin, você só precisa de: 
* Um site WordPress 
* Um aplicativo de API F5HLIVE gratuito

Basta gerar suas credenciais de API no painel do F5HLIVE, colá-las nas configurações do plugin e seu chat em tempo real estará pronto para uso. Não requer configuração manual do servidor.

== Ideal para ==
* Sites de anime e mangás
* Portais de comunidades 
* Blogs e portais de notícias
* Sites de streaming e web TVs
* Plataformas de entretenimento 
* Comunidades de fãs (Fandoms)
* Comunidades de jogos e clãs (Gaming)
* Redes sociais em WordPress
* Comunidades de criadores de conteúdo

== Installation ==

1. Faça o upload da pasta `f5hlive-chat` para o diretório `/wp-content/plugins/` ou instale diretamente pelo painel do WordPress.
2. Ative o plugin através do menu **Plugins**.
3. Acesse o menu **F5HLive Chat** no painel lateral para configurar suas credenciais.

== Frequently Asked Questions ==

= Preciso de uma conta na F5HLive? =
Sim. O plugin funciona de forma desacoplada para garantir a velocidade do seu site. Crie sua conta em f5hlive.com.br para obter suas credenciais de acesso à API.

Configurar API!

No painel da F5HLIVE, vá para as seguintes etapas.

Menu API WebSocket

Clique no botão Criar API.

Dependendo do plano, é possível criar mais de uma API.

Em "Plano/pedido", selecione o plano contratado, caso tenha mais de uma API.

Opção Cluster/Servidor: essa é a geolocalização do servidor da API.

Status inicial: mantenha ativo. O status inativo, caso queira pôr a API em manutenção. O modo inativo não consome recursos da API, porém ela ficará desconectada.

Modo de segurança por URL

Domínios permitidos: aqui você pode informar as URLS que terão acesso à sua API, ex.: seusite.com. Se ativado, algum domínio qualquer, outro domínio terá conexão recusada.

Você poderá informar mais de uma URL; essa função é opcional e ajuda na proteção de filtragem de dados da sua API, como conversas e informações enviadas.

Recomendado, caso o modo Autenticação Completa esteja desativado e o Modo de Autenticação Simples esteja ativado, pois as APIs suportam eventos simples sem autenticação completa.

Modo de Autenticação Completa  

Esse modo exige todas as credenciais para enviar mensagens/eventos.

auth_key

auth_signature (HMAC SHA256)

auth_timestamp

Validação completa do payload.

Modo de Autenticação Simples

Permite envios de mensagens/eventos sem a necessidade de todas as credenciais, usando apenas api_key.

Configuração Recomendada

Usar URL do seu projeto.

Habilitar o modo de Autenticação Completa. 

Achou complicado? 

Não se preocupe. Após realizar o pedido no site, na opção "Meus Serviços", o painel é gerenciado de forma visual, simples e fácil de entender, apenas selecionando opções e salvando, e tudo estará pronto.

= Funciona em ambientes locais sem SSL (HTTPS)? =
Sim. Basta desativar a opção **Forçar TLS** nas configurações do painel administrativo do plugin durante seus testes em localhost.

= Posso usar apenas o shortcode? =
Sim. Você pode desativar o botão flutuante global no painel e exibir o chat apenas nas páginas onde inserir o shortcode.

== Shortcode ==

Você pode usar o shortcode padrão:
`[f5hlive_chat]`

Ou customizar a exibição usando os parâmetros aceitos:
* `title` — Altera o título da janela (Ex: `[f5hlive_chat title="Chat da Comunidade"]`)
* `height` — Define a altura em pixels (Ex: `[f5hlive_chat height="600"]`)

== Changelog ==

= 1.3.0 =
* Versão inicial (MVP) com chat em tempo real, suporte a visitantes, botão flutuante e painel de controle TLS.

== Upgrade Notice ==

= 1.3.0 =
Versão inicial de lançamento.
