Editoria11y pentru Drupal

Funcții principale

Modulul Drupal conectează biblioteca verificatorului la backend-ul editorial, și adaugă multe instrumente server-side pentru raportare, guvernanță și configurare

Instalare și pași cheie de configurare

Instalatorul inclus de pe Drupal.org include mai multe module:

• Editoria11y: verificatorul de conținut principal și panoul de control.
• Editoria11y CSA: teste pentru dezvoltatori și instrumente de întreținere a panoului de control.
• Editoria11y Export: instrumente de raportare CSV.

Instalați-l ca orice alt modul, apoi urmați acești pași esențiali:

1. Verificați permisiunile. Autorii de încredere ar trebui să aibă „Mark OK", „Mark as Ignored" și „View the dashboard".
2. Verificați paginile cheie pentru alerte repetitive sau nefolositoare. Fie marcați-le ca OK în indiciu, fie ajustați configurația pentru a ignora elementele după selector.
3. Căutați indicii care sunt greu de văzut — în afara ecranului, trunchiate, în spatele altor elemente sau pe elemente ascunse. Folosiți indiciile din „Fix tip positioning" de mai jos pentru a remedia.
4. Dacă site-ul are deja conținut și aveți un abonament CSA, vizitați tab-ul „recheck" al panoului de control și parcurgeți site-ul cu crawler-ul pentru a pre-încărca rapoartele de site. Aceasta este opțională, dar paginile mai vechi nu vor apărea în rapoarte până când nu sunt crawlate sau vizitate de un utilizator autentificat.

Vizionați o introducere video la opțiunile de configurare (v2.4).

Ascundeți alertele nefolositoare

Configurațiile bune suprimă alertele nefolositoare, astfel autorii de conținut se pot concentra pe problemele pe care ar trebui să le remedieze.

Deși puteți dezactiva testele complet, este de obicei mai bine să ascundeți alertele pe elemente sau pagini specifice.

În timpul fiecărei rulări de test, Editoria11y adună un singur set de elemente din setarea „Check content in these containers", și apoi îl filtrează de mai multe ori. Iată cum arată o rulare de test:

1. Anulați verificarea dacă configurația împiedică verificarea pe această pagină sau pentru acest utilizator.
2. Adunați elementele din regiunile specificate ale paginii, de ex.:
   body > *:not('.ed11y-element')
   Pentru utilizatorii Editoria11y CSA, acestea sunt regiunile din tab-ul Developer tests.
3. Eliminați elementele care se potrivesc selectorilor de ignorare, de ex.:
   .widgets, .utility-menu
   Pentru utilizatorii Editoria11y CSA, aceștia sunt selectorii din tab-ul Developer tests.
4. Rulați testele și sincronizați rezultatele cu panoul de control.
5. Dacă configurația split este activă și utilizatorul este editor de conținut, filtrați rezultatele pentru dezvoltatori:
   • Eliminați rezultatele din testele setate la „Developer only".
   • Eliminați rezultatele pe elemente din afara regiunilor de conținut specificate, de ex.:
     main, footer
   • Eliminați rezultatele pe elemente care se potrivesc selectorilor de ignorare pentru conținut.
   Rețineți că nu există o a doua fază de „colectare". Regiunile de pagină pentru dezvoltatori trebuie să includă regiunile de conținut.
6. Deschideți panoul și desenați alertele dacă configurația corespunde unei setări de deschidere automată.

Respingeți alertele

Testele pot fi configurate în bibliotecă ca erori sau avertismente („verificări manuale"). Avertismentele pot fi respinse. Există două tipuri de respingeri disponibile din subsolul fiecărui tooltip:

• „Ignorați" este stocat ca preferință de utilizator: alerta este acum ascunsă pentru utilizatorul curent, și numai pentru utilizatorul curent.
• „Mark OK" ascunde alerta pentru toți utilizatorii.

Dacă un utilizator poate respinge o alertă sau nu este controlat la nivel de rol prin permisiunile Drupal. Majorității autorilor ar trebui să li se permită să respingă alerte. Nu are sens să atribuiți cuiva o verificare manuală dacă nu poate marca acel element ca verificat.

Ignorați elementele

Aceste două setări de configurare sunt cele mai importante!

Setați prima pentru a include orice părți ale conținutului paginii pe care autorii le pot edita. De ex., dacă pot edita zona de conținut main, .sidebar și .footer-column-two, setați acele selectori ca zona dvs. de verificare a conținutului.

Folosiți a doua pentru a „elimina" subsecțiunile. De ex., dacă main conține diverse widget-uri și embed-uri pe care doar dezvoltatorii le pot modifica, listați-le: .widget-1, .social-embed;

Dacă utilizați configurația split, veți vedea o pereche similară de setări în tab-ul Developer Tests:

Lucrul cheie de știut despre zonele de verificare pentru dezvoltatori este că ele nu sunt independente de zonele de verificare a conținutului. Într-o configurație split, zonele pentru dezvoltatori sunt verificate, și apoi acele rezultate sunt filtrate pentru a corespunde zonelor de conținut. Orice zone excluse pentru dezvoltatori vor fi, de asemenea, excluse pentru editorii de conținut. Nu excludeți zonele de conținut editabile!

Unele teste permit o configurare mai precisă, pentru a ascunde anumite alerte doar pe elementele afectate. Căutați-le sub:

• Teste de conținut: Linkuri de verificat
• Teste de conținut: Embed-uri de verificat
• Teste de conținut: Detectarea conținutului dinamic și shadow
• Teste pentru dezvoltatori: Contrast

Ascundeți pentru pagini sau utilizatori specifici

Cea mai simplă modalitate de a face acest lucru este prin transmiterea claselor CSS sau ID-urilor la aceste opțiuni:

Prima va împiedica rularea verificărilor, iar bara de instrumente nu va fi afișată.

A doua va porni verificatorul minimizat și va auto-marca (pentru utilizatorul curent) toate problemele ca „Ignorat", chiar dacă sunt erori. Aceasta permite testelor să ruleze și să actualizeze panoul de control fără a deranja utilizatorul.

Dacă doriți să folosiți aceste opțiuni pentru a controla ce utilizatori văd verificatorul, poate fi necesar să ajustați tema pentru a genera o clasă, de exemplu .user-247

Gestionați rezultatele la nivel de site

Remediați sfaturile ascunse sau în afara ecranului

Modulul furnizează câmpuri pentru două dintre opțiunile de configurare ale bibliotecii pentru a schimba modul în care sunt plasate sfaturile:

Unele teme au coloane sau widget-uri care ascund overflow-ul orizontal sau vertical. Biblioteca detectează automat când un comutator ar cădea în afara părții vizibile a paginii. Comunicarea bibliotecii că anumite containere ascund overflow-ul înseamnă că va încerca, de asemenea, să poziționeze sfaturile pentru elementele din acele containere în interiorul granițelor lor.

Unele teme au widget-uri care comută vizibilitatea conținutului, cum ar fi acordeoane, tab-uri și prezentări de diapozitive. Indiciile din interiorul acestor elemente vor fi, de asemenea, ascunse. Furnizarea unei liste de selectori pentru aceste widget-uri înseamnă că Editoria11y va face o pauză scurtă când un utilizator încearcă să sară la acele indicii folosind un buton înainte sau înapoi. Temele și modulele Drupal pot urma apoi instrucțiunile din secțiunea bibliotecii despre gestionarea sfaturilor pe conținut ascuns pentru a dezvălui conținutul ascuns.

Scrieți propria configurație

În PHP: modulul Drupal furnizează un hook_editoria11y_alter_config pentru a schimba conținutul drupalSettings.editoria11y într-un modul sau temă. De exemplu:

Modificarea drupalSettings ajută doar dacă JS-ul modulului este deja configurat să transmită acea valoare bibliotecii. Pentru a adăuga parametri suplimentari, trebuie să modificați direct obiectul JS options. Modulul verifică pentru o variabilă JS globală editoria11yOptionsOverride. Dacă aceasta este setată, va transmite obiectul options unei funcții editoria11yOptions pe care ați furnizat-o în modulul sau tema dvs. Acum puteți seta oricare dintre parametrii bibliotecii.