Rastreador do Ally para sites

O rastreador do Ally para sites incorpora declarações Disallow  no arquivo robots.txt de um site. Essas declarações ajudam a evitar que o rastreador fique preso em loops de rastreamento infinitos em tipos específicos de conteúdo, como páginas de pesquisa, aplicativos de calendário e assim por diante.

O rastreador do Ally para sites segue o Padrão de exclusão de robôs. O agente do usuário específico que o Ally usa é: blackboardally


Desativar formatos alternativos

Se desejar, você poderá desativar os formatos alternativos para itens de conteúdo individuais. Adicione o atributo data-ally-af-disabled ao arquivo vinculado em seu HTML. Este atributo evita que o arquivo apareça no painel Formatos alternativos.

Por exemplo, se você adicioná-la a um arquivo vinculado, esse arquivo não aparecerá na lista:  <a data-ally-af-disabled href:"https://filename.pdf">PDF file</a>.

Remova o atributo a qualquer momento se você quiser que o item de conteúdo seja exibido no painel Formatos alternativos.

Exemplo:

<!doctype html>
<html lang="en">
  <head></head>
  <body>
    <p><a href="/example1.pdf">This link will show up</a></p>
    <p><a data-ally-af-disabled href="/example2.pdf">This link will not show up</a></p>
  </body>
</html>


Excluir partes de uma página da Web

Você pode excluir partes específicas de uma página da Web do conteúdo de formato alternativo. Adicione o atributo data-ally-exclude ao elemento de conteúdo em seu HTML. Este atributo evita que o conteúdo apareça no formato alternativo selecionado.

Por exemplo, se você adicionar o atributo a uma imagem na página, essa imagem não aparecerá no formato alternativo do BeeLine Reader quando você abri-la.

Se houver um elemento <main> no site, apenas o que está dentro desse elemento principal é exibido no conteúdo de formato alternativo. Qualquer coisa fora do elemento principal é excluída automaticamente. Você ainda pode usar o atributo data-ally-exclude para excluir elementos dentro do elemento principal.

Exemplo:

<!doctype html>
<html lang="en">
  <head></head>
  <body>
    <p>This will show up</p>
    <p data-ally-exclude>This will not show up</p>
  </body>
</html>


Configure o ícone de download de formatos alternativos

Decida como você deseja que o ícone de download de formatos alternativos seja exibido. Escolha uma destas opções:

  • Ícone pequeno à esquerda da página: data-ally-af-style="flag_small"
  • Ícone grande à esquerda da página: data-ally-af-style="flag_large"
  • Barra ao longo da parte inferior da página: data-ally-af-style="bar_bottom"

Use este script para personalizar a aparência e a percepção.

<!--
    Script de integração de site do Ally.
    "data-ally-af-style" pode ser um dos valores a seguir para personalizar a aparência e a percepção:
        - flag_small
        - flag_large
        - bar_bottom
-->
<script
  data-ally-loader
  data-ally-platform-name="web"
  data-ally-client-id="8366"
  data-ally-af-style="flag_small"
  src="https://prod.ally.ac/integration/api/ally.ui.js">
</script>


Configurar comentários do editor de conteúdo

Configure seu site para ver exatamente onde estão seus problemas de acessibilidade. Depois de configurar as páginas do site, acesse o relatório de acessibilidade e encontre um domínio com problema. Selecione o indicador de pontuação do item com o problema de acessibilidade para abrir o painel de comentários do conteúdo do editor. Veja os problemas destacados em sua página na janela de visualização.

Caso você queira que o conteúdo da página seja exibido na janela de visualização, as páginas do site precisam ter essas configurações.

  • Compatível com HTTPS
  • Adicione o script AllyJS

    Esse script também é exigido para formatos alternativos. Se você quiser ver os problemas destacados na janela de visualização, mas não quiser adicionar os formatos alternativos ao seu site, use a propriedade data-ally-af-style=none.

  • Permitir que a página seja incorporada em um iframe pelo domínio do Ally
  • Permitir scripts, estilos, imagens e iframes secundários hospedados pelo domínio do Ally

Permitir que o Ally incorpore suas páginas em um iframe

Se você quiser aproveitar totalmente o painel de comentários do editor de conteúdo como um parceiro confiável, o Ally precisará de permissão para incorporar seu conteúdo em um iframe. Essa permissão possibilita que o Ally mostre seu conteúdo na janela de visualização do painel de comentários do editor de conteúdo. O painel só pode ser acessado por meio do Relatório de acessibilidade.

Se você impedir que sua página da Web seja incorporada em iframes (por exemplo, com X-Frame-Options ou títulos Content-Security-Policy), precisará adicionar ou alterar seu título Content-Security-Policy para adicionar https://*.ally.ac à diretriz frame-ancestors.

Exemplos

Exemplos de configuração
Configuração atualAdicionar ou atualizar diretriz frame-ancestors
Título X-Frame-Options com valor DENYContent-Security-Policy: frame-ancestors https://*.ally.ac;
Título X-Frame-Options com valor SAMEORIGINContent-Security-Policy: frame-ancestors 'self' https://*.ally.ac;
Content-Security-Policy com uma diretriz frame-ancestors de 'none'Content-Security-Policy: frame-ancestors https://*.ally.ac;
Content-Security-Policy com uma diretriz frame-ancestors com uma lista de domíniosContent-Security-Policy: frame-ancestors 'self' https://*.anothersite.com https://*.ally.ac;