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.
Visão Geral
A integração com Joomla consiste em:
- Modificação do Template: Adição do script da Rybená ao arquivo
index.php - Plugin de PDF: Instalação de um visualizador de PDF customizado para habilitar tradução
Instalação Principal
Acessar o painel administrativo
Faça login no painel administrativo do Joomla.
Geralmente, o painel está acessível em www.seusite.com.br/administrator
Acessar a aba Sistema
No menu lateral, clique em Sistema.
Acessar Site Templates
Na seção Templates, clique em Site Templates.
Selecionar o tema ativo
Clique no tema que está atualmente em uso no seu site.
Editar o arquivo index.php
Clique no arquivo index.php para editá-lo.
Adicionar o script da Rybená
Cole o seguinte trecho de código entre as tags <head> e </head>:
<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js"></script>Certifique-se de adicionar o script dentro da seção <head> do documento HTML.
Exemplo de onde adicionar:
<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<!-- Adicione o script da Rybená aqui -->
<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js"></script>
<jdoc:include type="head" />
</head>
<body>
<!-- Resto do conteúdo -->
</body>
</html>Salvar as alterações
Clique no botão Salvar para aplicar as mudanças.
Verificar a instalação
Acesse qualquer página do seu site para verificar se a Rybená está aparecendo corretamente.
Agora a Rybená estará aparecendo em todas as páginas do site. Caso queira alterar algum comportamento, verifique a página de customizações e altere o trecho de código inserido no Passo 6.
Plugin de PDF
A Rybená não traduz PDFs do Joomla 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.
Por que é necessário?
- Navegadores modernos bloqueiam scripts de acessarem eventos de seleção em iframes
- Plugins de PDF padrão do Joomla utilizam iframes para renderizar PDFs
- O plugin customizado da Rybená permite contornar essa limitação
Sobre o Plugin
Este é um plugin de conteúdo Joomla que torna possível mostrar arquivos PDF acessíveis em conteúdo baseado. Foi construído baseando-se no Mozilla PDF.js.
No Joomla! 2.5, o recurso PDF não está mais incluído por padrão. Por isso, não é possível inserir PDFs nos artigos de forma muito intuitiva, como por exemplo com um botão no criador de artigos de "Criar PDF".
Instalação do Plugin de PDF
Baixar o plugin
Baixar plugin PDF Viewer para Joomla
Acessar o Gerenciador de Extensões Vá em Extensões → Gerenciador de extensões → Instalar.
Fazer upload do arquivo Acesse a aba Upload & Install Joomla Extension. Selecione o arquivo ZIP baixado e faça o upload do mesmo.
Habilitar o plugin Acesse o Gerenciador de extensões e habilite o plugin Content - pdfviewer.
Utilização do Plugin de PDF
Para exibir PDFs acessíveis com a Rybená:
Fazer upload do PDF
Primeiro, faça o upload dos seus PDFs para o Gerenciador de Mídias do Joomla.
Vá em Conteúdo → Mídias.
Copiar o link do PDF
Clique no PDF que deseja disponibilizar e copie o link do mesmo.
Inserir no artigo
Navegue até o artigo onde deseja disponibilizar o PDF e cole o seguinte comando:
{pdfviewer file=COLE-AQUI-O-LINK-DO-PDF}Exemplo:
{pdfviewer file=/images/documentos/manual.pdf}Salvar e verificar
Salve o artigo e verifique se o PDF está sendo exibido corretamente com a Rybená.
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>Solução de Problemas
Recursos Adicionais
Conteúdo Relacionado
Integração com WordPress
A Rybená oferece integração nativa com o WordPress através de um plugin oficial que simplifica o processo de instalação e configuração. O plugin adiciona a Rybená a todas as páginas do seu site automaticamente.
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.