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 (até 4.4), utilize o plugin atualizado:
Baixar Plugin - Moodle 4 (até 4.4)
Este plugin foi desenvolvido para funcionar com a nova arquitetura de plugins do Moodle 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.