Ally per siti web - Crawler

Il crawler di Ally per siti web incorpora le dichiarazioni Disallow in un file robots.txt del sito web. Tali dichiarazioni impediscono che il crawler si blocchi in un loop infinito su determinati tipi di contenuti, come pagine di ricerca, applicazioni di calendario e così via.

Il crawler di Ally per siti web aderisce al Protocollo di esclusione robot. L’user agent specifico utilizzato da Ally è: blackboardally


Disabilitare i formati alternativi

Se vuoi, puoi disattivare i formati alternativi per i singoli contenuti. Aggiungi l’attributo data-ally-af-disabled al file collegato nel codice HTML per fare in modo che quel file non appaia nel riquadro Formati alternativi.

Ad esempio, se lo aggiungi a un file collegato, quel file non apparirà nell’elenco:  <a data-ally-af-disabled href:"https://filename.pdf">PDF file</a>.

Rimuovi l’attributo in qualsiasi momento se vuoi che il contenuto sia visibile nel riquadro Formati alternativi.

Esempio:

<!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>


Escludere parti di una pagina web

Puoi escludere delle parti specifiche di una pagina web dai formati alternativi dei contenuti. Aggiungi l’attributo data-ally-exclude nel codice HTML del contenuto per fare in modo che quel contenuto non appaia nel formato alternativo selezionato.

Ad esempio, se aggiungi l’attributo a un’immagine nella pagina, quell’immagine non appare nel formato alternativo BeeLine Reader quando lo apri.

Se è presente un elemento <main> sul sito web, nel formato alternativo appare solo ciò che si trova all’interno dell’elemento principale. Tutto ciò che si trova al di fuori dell’elemento principale viene automaticamente escluso. Puoi comunque utilizzare l’attributo data-ally-exclude per escludere degli elementi all’interno dell’elemento principale.

Esempio:

<!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>


Configurare l’icona di download dei formati alternativi

Scegli che aspetto dare all’icona di download dei formati alternativi. Scegli una delle seguenti opzioni:

  • Icona piccola sul lato sinistro della pagina: data-ally-af-style="flag_small"
  • Icona grande sul lato sinistro della pagina: data-ally-af-style="flag_large"
  • Barra nella parte inferiore della pagina: data-ally-af-style="bar_bottom"

Usa questo script per personalizzare l’aspetto e l’effetto.

<!--
    Ally Website Integration Script.
    "data-ally-af-style" can be one of the following values to customize the look and feel:
        - 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>


Configurare il feedback dell’editor dei contenuti

Configura il sito in modo da individuare esattamente dove si trovano i problemi di accessibilità. Dopo aver configurato le pagine del tuo sito, vai al report di accessibilità e trova un dominio che presenta un problema. Seleziona l’indicatore del punteggio accanto al contenuto che presenta il problema di accessibilità per aprire il riquadro del feedback dell’editor dei contenuti. Visualizza i problemi evidenziati nella pagina dalla finestra di anteprima.

Se vuoi visualizzare il contenuto della pagina nella finestra di anteprima, le pagine del sito devono avere queste impostazioni attive.

  • Supporto HTTPS
  • Aggiungi lo script AllyJS

    Questo script è necessario anche per i formati alternativi. Se vuoi visualizzare i problemi evidenziati nella finestra di anteprima ma non vuoi aggiungere i formati alternativi al sito, usa la proprietà data-ally-af-style=none.

  • Consenti al dominio Ally di incorporare la pagina in un iFrame
  • Consenti script, stili, immagini e iFrame secondari in hosting nel dominio Ally

Consentire ad Ally di incorporare le pagine in un iFrame

Se vuoi sfruttare al 100% i vantaggi del riquadro del feedback dell’editor dei contenuti in qualità di partner fidato, Ally richiede l’autorizzazione per incorporare i tuoi contenuti in un iFrame. Questa autorizzazione consente ad Ally di visualizzare i contenuti nella finestra di anteprima del riquadro del feedback dell’editor dei contenuti. È possibile accedere al riquadro solo dal report di accessibilità.

Se impedisci alla pagina web di essere integrata in iFrame, (ad esempio con le intestazioni X-Frame-Options o Content-Security-Policy), devi aggiungere o modificare l’intestazione Content-Security-Policy per aggiungere https://*.ally.ac alla direttiva frame-ancestors.

Esempi

Esempi di configurazione
Configurazione correnteAggiungi o aggiorna la direttiva frame-ancestors
Intestazione X-Frame-Options con il valore DENYContent-Security-Policy: frame-ancestors https://*.ally.ac;
Intestazione X-Frame-Options con il valore SAMEORIGINContent-Security-Policy: frame-ancestors 'self' https://*.ally.ac;
Content-Security-Policy con una direttiva frame-ancestors di 'none'Content-Security-Policy: frame-ancestors https://*.ally.ac;
Content-Security-Policy con una direttiva frame-ancestors con un elenco di dominiContent-Security-Policy: frame-ancestors 'self' https://*.anothersite.com https://*.ally.ac;

Creare utenti per i gruppi di domini

Gli utenti per i gruppi di domini dispongono di autorizzazioni speciali per visualizzare il report di accessibilità per i domini a cui sono assegnati. Per creare gli utenti per i gruppi di domini e i gruppi di domini, i super amministratori di Ally per siti web devono accedere alla dashboard di configurazione di Ally.

Il link alla dashboard viene fornito durante l’implementazione e appare così: /launchclientconfig/yourclientID. Usa le tue credenziali di amministratore correnti per accedere.

Nella dashboard di configurazione di Ally per siti web, il super amministratore originale può configurare i gruppi di domini e aggiungere nuovi utenti prima di assegnare loro determinati gruppi di domini.

In qualità di amministratore, puoi assegnare un nuovo accesso utente a qualsiasi cosa, compresa la possibilità di effettuare la configurazione. Oppure puoi assegnare un accesso parziale a gruppi di domini specifici. È possibile aggiungere più  gruppi di domini agli accessi degli utenti.

Se il super amministratore assegna numerosi domini, l’utente può scegliere quale report dei gruppi di domini visualizzare quando effettua l’accesso. Se viene assegnato un solo gruppo di domini, l’utente accede direttamente al report di quel gruppo.

Dopo aver creato gli utenti e averli assegnati ai gruppi di domini, devi informare gli utenti che è stato creato un account per loro.

Puoi usare il nostro modello di e-mail per avvisare gli utenti della creazione dell’account.

Modello di e-mail per utenti Google

Gentile [name],

è stato creato un account Ally per te con il tuo indirizzo e-mail: [[email protected]]

Con questo account puoi accedere ad [Ally for Web - Reporting] / [Ally for LMS - Config]/...

Prima di accedere al sito, devi collegare questo indirizzo e-mail a un account GoogleTM. Per accedere è necessario avere un account Google. Solo i super amministratori o gli amministratori root possono usare l’accesso da super amministratore presente nella pagina.

Se il tuo indirizzo e-mail è già collegato, non dovrai fare nulla. Se invece l’e-mail non è collegata, segui questa procedura.

  1. Vai su Crea un account Google.
  2. Compila questi campi. Usa [[email protected]] nel campo Il tuo indirizzo e-mail
  3. Dopo aver compilato i campi con le informazioni, Google invia un’e-mail al tuo indirizzo per verificarlo. Completa il processo di verifica facendo clic sul link nell’e-mail per collegare l’indirizzo all’account Google che hai appena creato.

Una volta collegato l’indirizzo e-mail, puoi usare Google per accedere a [Ally for Web - Reporting] / [Ally for LMS - Config]/.. e visualizzare i report.  

Visita la guida di Blackboard per gli editor dei contenuti per ulteriori informazioni sul report e su come risolvere i problemi di accessibilità.

Modello di email per utenti Microsoft® Office

Gentile [name],

è stato creato un account Ally per te con il tuo indirizzo e-mail: [[email protected]]

Con questo account puoi accedere ad [Ally for Web - Reporting] / [Ally for LMS - Config]/...

  1. Seleziona il link e Accedi con Microsoft. Solo i super amministratori o gli amministratori root possono usare l’accesso da super amministratore presente nella pagina.
  2. Concedi a Microsoft l’autorizzazione a visualizzare il tuo profilo e di gestire i dati a cui ha accesso. Seleziona Accetta.
  3. Accedi con il tuo indirizzo email e la tua password Microsoft.
  4. Dopo aver effettuato l’accesso, viene chiesto di verificare l’indirizzo email. Ally ti invia un’email con un codice. Inserisci il codice per verificare l’indirizzo email. La verifica dell’indirizzo email è necessaria solo al primo accesso.

    Nota: Se non trovi l’email di Ally, prova a controllare nella cartella Posta indesiderata.
  5. Ora puoi accedere al report.

Chiudi la finestra o la scheda del report per scollegarti dal report.

Visita la guida di Blackboard per gli editor dei contenuti per ulteriori informazioni sul report e su come risolvere i problemi di accessibilità.