Accessibility Guardian

Безплатен WordPress плъгин с отворен код

Откривайте и поправяйте проблеми с достъпността направо в админ панела.

Accessibility Guardian проверява всяка страница на WordPress сайта ви по WCAG 2.2 ниво AA с axe-core и ви казва точно какво да поправите, къде и как. Без външни услуги, без регистрация и без нищо допълнително на сървъра.

Изтегли v1.2.0 (zip) Виж в GitHub

Плъгинът е изпратен за преглед в официалната директория на WordPress.org и ще се появи там след одобрение.

  • WCAG 2.2 A и AA
  • WordPress 6.4–7.1
  • PHP 8.0–8.5
  • Multisite
  • GPL-2.0-or-later
Таблото на Accessibility Guardian в WordPress: оценка на сайта 88 от 100 („Добра“), 9 сканирани страници, проблеми по тежест, категории по WCAG и графика на напредъка, която расте от 83 на 88 за три сканирания.

Как работи

От сканиране до поправка в три стъпки

  1. Сканирайте

    Пуснете сканиране на целия сайт от Accessibility Guardian → Run Scan или сканирайте една страница от горната лента, докато я разглеждате. Всяка страница се зарежда в скрита рамка и axe-core проверява реалния, изобразен резултат.

  2. Прегледайте

    Получавате оценка от 0 до 100 и списък с проблеми, подредени по тежест. Всеки от тях показва страницата, елемента, неговия HTML, критерия от WCAG и връзка към документация.

  3. Поправете

    Следвайте препоръчаната поправка за всеки проблем, включете автоматични поправки за често срещаните случаи, сканирайте отново и наблюдавайте как оценката расте.

Възможности

Всичко необходимо за проверка на WordPress сайт

  • Анализ на реалната страница

    axe-core 4.10 проверява напълно изобразената страница, така че се отчитат изчисленият цветови контраст, ARIA състоянията, кодът на темата и резултатът от page builder-ите.

  • WCAG 2.0, 2.1 и 2.2

    Изберете ниво A или AA. Допълнителните проверки за добри практики хващат прескочени нива на заглавия, липсващо основно заглавие и съдържание извън ориентирите (landmarks).

  • Проверки, които axe-core няма

    Общ текст на връзки като „натиснете тук“, полета само с placeholder вместо етикет, връзки, които отварят нов прозорец без предупреждение, и връзки към PDF файлове.

  • Конкретни проблеми

    Тежест, критерий от WCAG, страница, CSS път, HTML фрагмент, препоръчана поправка и документация за всяка находка, с филтър по тежест.

  • Оценка и напредък

    Оценка на сайта от 0 до 100 с нива „Отлична“, „Добра“, „Нужни са подобрения“ и „Слаба“, плюс графика как се променя между сканиранията.

  • Автоматични поправки по избор

    Девет малки поправки, които включвате сами: връзка за прескачане, видим фокус, подчертани връзки, атрибут за език, предупреждение за нов прозорец, мащабиране и още.

  • Експорт в CSV и JSON

    Експортирайте всяко сканиране за екипа си, за клиента или за отчетите си.

  • Multisite и hooks за разработчици

    Активиране за отделен сайт или за цялата мрежа, плюс филтри и действия за промяна на списъка с адреси, настройките на axe-core и нужните права.

Снимки

Вижте го в действие

Реални снимки от WordPress 7.1 на малък демонстрационен сайт с типични проблеми с достъпността. Интерфейсът на плъгина е на английски и може да бъде преведен.

  • Табло с оценка на сайта 88 от 100, карти за сканирани страници, грешки, предупреждения и успешни проверки, проблеми по тежест, разпределение по категории WCAG и графика на напредъка.
    Табло: оценка на сайта, разпределение по тежест, категории по WCAG и напредък във времето.
  • Страницата за сканиране след завършено сканиране на 9 страници: оценка 88 от 100, брой критични, сериозни, леки проблеми и предупреждения, и дневник с броя проблеми за всяка страница.
    Завършено сканиране на целия сайт с обобщение на оценката и дневник по страници.
  • Страница с проблеми и раздели по тежест. Критичен проблем image-alt показва критерия 1.1.1 Нетекстово съдържание, адреса на страницата, елемента, неговия HTML и препоръчаната поправка.
    Проблеми: всяка находка с критерий от WCAG, елемент, HTML и препоръчана поправка.
  • Страница с настройки: типове съдържание за сканиране, архиви на термини, ниво по WCAG, проверки за добри практики и девет автоматични поправки, три от които са включени.
    Настройки: какво да се сканира, ниво по WCAG, добри практики и автоматични поправки.

Оценка

Оценка, която можете да обясните

Всяка сканирана страница започва от 100 и губи точки за всеки проблем, но никога не пада под 0. Оценката на сайта е средната стойност от всички сканирани страници, така че една проблемна страница не скрива иначе добрия сайт.

  • Отлична 95–100
  • Добра 80–94
  • Нужни са подобрения 60–79
  • Слаба под 60
Отнети точки за всеки проблем
ТежестНаказаниеТипични примери
Критичен−10Изображение без алтернативен текст, бутони без име, липсващ език на страницата
Сериозен−5Нисък контраст, полета без етикет, грешна структура на списък
Лек−2Общ текст на връзка, полета само с placeholder
Предупреждение−1За ръчна проверка, добри практики, PDF файлове

Автоматични поправки

Бързи подобрения, само когато ги искате

Всички поправки са изключени по подразбиране. Те използват hooks на WordPress и малки файлове за предната част на сайта; файловете на темата ви никога не се променят. Включвайте ги една по една и проверявайте сайта.

ПоправкаКакво правиWCAG
Атрибут за езикДобавя lang към <html>, когато темата го пропуска3.1.1
Връзка „към съдържанието“Добавя връзка за прескачане при класически теми (блоковите вече имат такава)2.4.1
Видим фокусПоказва ясна рамка около връзки и контроли при работа с клавиатура2.4.7
Подчертани връзкиПодчертава връзките в съдържанието, без да пипа бутони и менюта1.4.1
Нов прозорецДобавя скрит текст „(отваря се в нов прозорец)“ към връзки с target="_blank"3.2.5
МащабиранеПремахва ограниченията user-scalable=no и maximum-scale1.4.4
Положителен tabindexВръща стойности на tabindex над 0 към 0 за естествен ред на фокуса2.4.3
Етикети за търсенеДобавя достъпен етикет към класическата форма за търсене3.3.2
Излишни titleПремахва атрибути title, които повтарят друго достъпно име—

Поверителност

Вашият сайт, вашите данни

  • Сканирането става на вашия сайт и във вашия браузър. Съдържанието и резултатите никога не се изпращат на автора на плъгина или на трети страни.
  • Резултатите се пазят във вашата база данни на WordPress и се изтриват, когато премахнете плъгина, на всеки сайт в мрежата.
  • Нищо не се зарежда за посетителите, освен ако не включите автоматична поправка.
  • Без регистрация, без API ключ, без проследяване.

Честно за автоматичните проверки

Автоматичните инструменти, включително този, откриват бързо голяма част от честите проблеми, но не всички. Някои изисквания на WCAG, като смислен алтернативен текст, логичен ред на четене и субтитри, може да провери само човек.

Accessibility Guardian ви помага да откривате и поправяте проблеми по-бързо. Той не удостоверява, че сайтът е достъпен или че отговаря на законови изисквания като ADA, Европейския акт за достъпността, EN 301 549 или Section 508.

За разработчици

Hooks, с които да го нагодите

HookПредназначение
accg_scan_urlsПромяна на списъка с адреси при пълно сканиране
accg_scan_url_limitМаксимален брой адреси при пълно сканиране (по подразбиране 1000)
accg_axe_optionsНастройки, подавани на axe.run()
accg_required_capabilityКой може да сканира и да вижда докладите (по подразбиране manage_options)
accg_skip_link_targetЦел на връзката за прескачане
accg_scan_completedДействие след завършено сканиране
functions.php 
// Let editors run scans and see reports.
add_filter( 'accg_required_capability', fn () => 'edit_others_posts' );

// Email the site admin when a scan scores below 80.
add_action( 'accg_scan_completed', function ( int $scan_id, array $totals ) {
	if ( $totals['score'] < 80 ) {
		wp_mail(
			get_option( 'admin_email' ),
			'Accessibility score dropped',
			sprintf( 'Scan #%d scored %d/100.', $scan_id, $totals['score'] )
		);
	}
}, 10, 2 );

Пълна документация за разработчици в GitHub (на английски)

Начало

Инсталиране за минута

  1. Изтеглете accessibility-guardian-1.2.0.zip от последното издание.
  2. В WordPress отидете на Разширения → Добавяне на ново → Качване, изберете zip файла и натиснете Инсталиране и Активиране.
  3. Отворете Accessibility Guardian → Run Scan и натиснете Start full site scan. Оставете раздела отворен, докато сканирането приключи.

Използвайте zip файла от изданието, а не зеления бутон „Download ZIP“ в GitHub: той сваля хранилището за разработка и се разархивира в папка с грешно име.

Изисквания

WordPress
6.4 или по-нова, тестван до 7.1
PHP
8.0 или по-нова, тестван с 8.0–8.5
Браузър
Актуален Chrome, Edge, Firefox или Safari
Рамки
Страниците трябва да позволяват вграждане от същия домейн. X-Frame-Options: SAMEORIGIN е наред; DENY спира сканирането.
Сървър
Нищо допълнително: без Node.js, браузър на сървъра или API ключ

Въпроси

Често задавани въпроси

Ще направи ли това сайта ми съвместим с ADA или с Европейския акт за достъпността?

Нито един инструмент не може да направи това сам. Автоматичните проверки откриват бързо много от честите проблеми, но някои изисквания на WCAG може да провери само човек. Използвайте доклада, за да поправите откритото, а след това тествайте основните страници с клавиатура и екранен четец.

Трябва ли да инсталирам нещо на сървъра?

Не. Сканирането става в браузъра на администратора чрез скрита рамка на вашия сайт, така че е достатъчен обикновен WordPress хостинг.

Защо трябва да държа раздела отворен по време на сканиране?

axe-core работи във вашия браузър, страница по страница. Ако затворите раздела, сканирането спира. Можете да го отмените по всяко време; отмененото сканиране пази частичните си резултати, но не заменя последния завършен доклад.

Една страница не беше сканирана. Защо?

Обикновено страницата не може да се покаже в рамка заради X-Frame-Options: DENY или Content-Security-Policy: frame-ancestors 'none', зареждането ѝ е отнело над 30 секунди или много строга политика за сигурност на съдържанието е блокирала axe-core. Останалата част от сканирането продължава нормално.

Ще се появи ли горната лента на WordPress в резултатите?

Не. Страниците се сканират като влязъл администратор, така че лентата присъства, но е изключена от всички проверки.

Забавя ли сайта за посетителите?

Не. Нищо не се зарежда за посетителите, освен ако не включите автоматична поправка. Включените поправки добавят един малък CSS файл и при някои поправки – един малък отложен скрипт.

Работи ли с page builder-и, блокови теми и multisite?

Да. Проверява крайния HTML, без значение какво го е създало, а автоматичните поправки се съобразяват с блоковите теми. При multisite можете да го активирате за отделен сайт или за цялата мрежа; всеки сайт пази своите настройки и резултати.

Какво ново

Версия 1.2.0

  • Тестван с WordPress 6.4–7.1 и PHP 8.0–8.5; Plugin Check не открива грешки и предупреждения.
  • Проверки за добри практики при заглавия, ориентири и структура на страницата.
  • Връзка „Scan accessibility“ в горната лента за сканиране на една страница с едно натискане.
  • Пълна поддръжка на multisite и четири нови hooks за разработчици.
  • Горната лента на WordPress вече не влиза в резултатите; съобщенията пазят имената на елементите като <ul>.
  • Собствените екрани на плъгина минават проверките на axe-core по WCAG 2.2 AA.

Пълен списък с промени (на английски)

Направете WordPress сайта си по-лесен за използване от всички

Безплатно, с отворен код и поверително по замисъл.

Изтегли v1.2.0 (zip) Звезда в GitHub