Integração com Moodle
A Rybená pode ser integrada ao Moodle através da seção de HTML Adicional, permitindo que a solução seja aplicada a todas as páginas do ambiente de aprendizagem automaticamente.
Visão Geral
A integração com Moodle consiste em:
- HTML Adicional: Adição do script da Rybená através do painel administrativo
- Plugin de PDF: Instalação de visualizadores específicos para diferentes versões do Moodle
- Limpeza de Cache: Procedimento necessário para aplicar as alterações
Instalação Principal
Acessar o painel administrativo Faça login no painel administrativo do Moodle.
Geralmente, o painel está acessível em www.seusite.com.br/admin
Navegar até Aparência No menu lateral, vá em: Painel → Administração do site → Aparência → HTML Adicional
Adicionar o script da Rybená Inclua o seguinte código JavaScript entre as
tags <head></head> do website:
<script
type="text/javascript"
src="https://cdn.rybena.com.br/dom/master/latest/rybena.js"
></script>Verificar o protocolo
Caso a página onde está sendo feita a instalação não utilize protocolo
HTTPS, é necessário substituir no código acima o protocolo https por
http.
Exemplo para HTTP:
<script
type="text/javascript"
src="http://cdn.rybena.com.br/dom/master/latest/rybena.js"
></script>Salvar as alterações Clique no botão Salvar mudanças para aplicar as configurações.
Limpar o cache do Moodle Para que as alterações entrem em vigor, é necessário limpar o cache:
Painel → Administração do site → Desenvolvimento → Excluir tudo que estiver em caches
Verificar a instalação Recarregue a página e a Rybená deverá estar instalada e funcionando.
Nesta nova versão da Rybená, não é mais necessário incluir a função
load() entre as tags <body></body> do website.
Plugin de PDF
A Rybená não traduz PDFs do Moodle por padrão devido a políticas de segurança dos navegadores. Para habilitar a tradução de PDFs, é necessário instalar um plugin customizado específico para a versão do Moodle.
Por que é necessário?
- Navegadores modernos bloqueiam scripts de acessarem eventos de seleção em iframes
- Plugins de PDF padrão do Moodle utilizam iframes para renderizar PDFs
- O plugin customizado da Rybená permite contornar essa limitação
Escolha do Plugin
Para versões do Moodle 2.x e 3.x, utilize o plugin específico:
Baixar Plugin - Moodle 2 e 3
Este plugin foi desenvolvido para funcionar com a arquitetura de plugins das versões mais antigas do Moodle.
Para versões do Moodle 4.x, utilize o plugin atualizado:
Baixar Plugin - Moodle 4
Este plugin foi desenvolvido para funcionar com a nova arquitetura de plugins do Moodle 4.
Para versões do Moodle 4.5, utilize o plugin atualizado:
Baixar Plugin - Moodle 4.5
Este plugin foi desenvolvido para funcionar com a arquitetura atualizada do Moodle 4.5.
Vai atualizar para o Moodle 5.x? Antes de rodar o upgrade, veja o aviso na aba Moodle 5 e substitua o plugin pelo zip 5.3.0.
Para versões do Moodle 5.x (incluindo o 5.3 LTS), utilize o plugin mais recente:
Baixar Plugin - Moodle 5
Este plugin é compatível com o Moodle 5.0 ao 5.3 LTS — validado no Moodle 5.0.10+ e no Moodle 5.3 (Build: 20261013).
Atualizando o Moodle para o 5.3: substitua o conteúdo de
mod/pdfjsfolder pelo conteúdo deste zip antes de
rodar a atualização do Moodle. Versões anteriores do plugin (5.0.0 e
anteriores) bloqueiam a atualização do core para o 5.3.
Versão do Plugin: A versão 5.3.0 do plugin requer Moodle 5.0 ou superior (versão 2025041400+). O Moodle 5.3 requer PHP 8.3+ e MariaDB 11.4+.
Instalação do Plugin de PDF
Baixar o plugin correto Selecione e baixe o plugin correspondente à versão do seu Moodle (veja as abas acima).
Acessar a página de instalação Navegue até: Painel → Administração do site → Plugins → Instalar Plugin
Fazer upload do arquivo Insira o arquivo ZIP baixado no local devido e clique em Instalar plugin de arquivo ZIP.
Seguir as instruções Siga as instruções de instalação mostradas pelo Moodle.
Recomendamos deixar os valores sugeridos na página de configuração do plugin.
Verificar a instalação Após a instalação, verifique se o plugin aparece na lista de plugins instalados e está ativo.
Ao disponibilizar PDFs para os usuários, deve-se escolher o plugin instalado. PDFs inseridos de outras maneiras não terão a integração com a Rybená.
Customização
Você pode customizar o comportamento da Rybená adicionando parâmetros ao script. Para mais detalhes, consulte a documentação de customização.
Exemplo de customização:
<script
type="text/javascript"
src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?positionPlayer=right&size=300"
></script>Procedimento de Limpeza de Cache
Após qualquer alteração na configuração do Moodle, é importante limpar o cache para garantir que as mudanças entrem em vigor.
Tipos de Cache
Para limpar o cache do Moodle: 1. Vá em Administração do site → Desenvolvimento → Excluir tudo que estiver em caches 2. Clique em Excluir tudo
Para limpar o cache do tema: 1. Vá em Administração do site → Aparência → Temas → Seleção de tema 2. Clique em Limpar cache de temas
Solução de Problemas
Recursos Adicionais
Conteúdo Relacionado
Integração com Joomla
A Rybená pode ser integrada ao Joomla através de uma modificação simples no template do site. Esta abordagem aplica a Rybená a todas as páginas automaticamente, garantindo uma experiência consistente para os usuários.
Integração com Wix
A Rybená pode ser integrada ao Wix através da funcionalidade de código personalizado, permitindo que a solução seja aplicada a todas as páginas do site automaticamente.