Docs › Para clientes › Requisitos e instalação

Requisitos e instalação

O que o site precisa ter, como instalar e atualizar o plugin e o que fazer logo depois.

1. Requisitos

Moodle 5.0 ou superior e PHP 8.2 ou superior.
Nada além do Moodle: as mensagens chegam por consultas curtas e repetidas do navegador, sem servidor ou serviço extra.
O cron do Moodle precisa estar funcionando (veja a seção 7).
Para enviar emojis, o banco de dados do site precisa guardar caracteres de quatro bytes (no MySQL/MariaDB, uma collation utf8mb4). Sem isso, o seletor de emojis não aparece e uma mensagem com emoji é recusada com o aviso "Este site não consegue gravar emojis. Remova-os e tente novamente."

2. Instalação

Copie a pasta do plugin para local/tutorchat dentro da instalação do Moodle.
Acesse Administração do site → Notificações (ou rode php admin/cli/upgrade.php) e confirme a instalação.

3. Atualização

Faça backup do banco de dados e da pasta do plugin.
Substitua a pasta local/tutorchat pela nova versão.
Acesse Administração do site → Notificações (ou php admin/cli/upgrade.php).

Cada versão pode criar uma tabela nova ou alterar uma existente durante a atualização:

Versão	Passo de atualização
2026100901	Cria `local_tutorchat_availlog` (histórico de disponibilidade dos tutores)
2026100902	Cria `local_tutorchat_rating` (avaliações dos atendimentos)
2026100903	Cria `local_tutorchat_stat` (resumo de estatísticas da supervisão)
2026101001	Acrescenta campos e índices a `local_tutorchat_session` (contadores de mensagens não lidas, marcas de leitura, última mensagem, `timechanged` e `timepurged`) e calcula esses valores para os atendimentos já existentes. Em sites com muitos atendimentos esse passo pode levar alguns minutos (no teste do desenvolvimento, 20 mil atendimentos e 200 mil mensagens levaram cerca de 2 minutos); faça-o fora do horário de uso

A versão 2026101100 (entrega E, ativação por curso e categoria) não altera o banco: não há passo de atualização, só as configurações e os textos novos.

A versão 2026101200 (entrega B2, cartões de atividade) acrescenta duas colunas à tabela de mensagens, cardtype e cardid. O passo é instantâneo (não percorre as mensagens) e as mensagens existentes ficam sem cartão. Nada novo para configurar.

O histórico completo está em histórico de versões.

4. Primeiros passos depois de instalar

Em Administração do site → Plugins → Plugins locais → Chat com tutor, escolha os papéis de tutor (veja o guia do administrador).
Em Onde o chat funciona, marque as categorias ou os cursos em que o chat deve aparecer. Sem isso, o chat não aparece em nenhum curso.
Atribua o papel de tutor a quem vai atender, nos cursos escolhidos.
Abra a página Licença e cole a chave recebida do fornecedor. Sem chave, o plugin funciona por 30 dias de teste. Veja licença.
Confirme que o cron do Moodle está rodando: o encerramento automático, as estatísticas e o envio de diagnóstico dependem dele.
Entre como aluno de um curso ativado e confira se o botão do chat aparece.

Atenção: em sites que já têm muitos atendimentos, a atualização que acrescenta campos pode levar alguns minutos. Faça-a fora do horário de uso e com backup.