Editoria11y لـ Drupal
الميزات الأساسية
تربط وحدة Drupal مكتبة المدقق بالواجهة الخلفية للتحرير، وتضيف كثيرًا من الأدوات العاملة على الخادم لإعداد التقارير والحوكمة والضبط
تضيف الوحدة الفرعية CSA ما يلي:
- منشئ اختبارات مخصصة
- أكثر من 40 اختبارًا للمطورين
- فحص التباين
- برامج زحف للموقع
- تحليل سهولة القراءة
- إعدادات منفصلة للمطورين والمحررين
التثبيت وخطوات الإعداد الأساسية
يتضمن المثبّت المجمّع على Drupal.org عدة وحدات:
- Editoria11y: المدقق الأساسي للمحتوى ولوحة التحكم.
- Editoria11y CSA: اختبارات المطورين وأدوات صيانة لوحة التحكم.
- Editoria11y Export: أدوات تقارير CSV.
ثبّتها كأي وحدة أخرى، ثم اتبع هذه الخطوات الأساسية:
- تحقق من الصلاحيات. ينبغي أن يمتلك الكتّاب الموثوقون صلاحيات «وضع علامة سليم» و«وضع علامة متجاهَل» و«عرض لوحة التحكم».
- افحص الصفحات الرئيسية بحثًا عن تنبيهات متكررة أو غير مفيدة. إما أن تضع عليها علامة «سليم» من التلميح، وإما أن تعدّل الإعدادات لتجاهل العناصر باستخدام المحددات.
- ابحث عن التلميحات التي يصعب رؤيتها: الواقعة خارج الشاشة، أو المقطوعة، أو المحجوبة خلف عناصر أخرى، أو الموجودة على عناصر مخفية. استعن بالنصائح الواردة في قسم «إصلاح التلميحات المخفية أو الواقعة خارج الشاشة» أدناه لإصلاحها.
- إذا كان الموقع يحتوي على محتوى بالفعل ولديك اشتراك في CSA، فانتقل إلى تبويب «إعادة الفحص» في لوحة التحكم، ثم شغّل الزحف على الموقع لتحميل تقارير الموقع مسبقًا. هذه الخطوة اختيارية، لكن الصفحات الأقدم لن تظهر في التقارير حتى يزحف عليها البرنامج أو يزورها مستخدم مسجّل الدخول.
شاهد مقدمة بالفيديو عن خيارات الإعداد (الإصدار 2.4).
إخفاء التنبيهات غير المفيدة
الإعدادات الجيدة تحجب التنبيهات غير المفيدة، ليتمكن كتّاب المحتوى من التركيز على المشكلات التي ينبغي لهم إصلاحها.
يمكنك إيقاف الاختبارات كليًا، لكن الأفضل عادةً إخفاء التنبيهات على عناصر أو صفحات محددة.
في كل دورة فحص، يجمع Editoria11y مجموعة واحدة من العناصر وفق إعداد «افحص المحتوى في هذه الحاويات»، ثم يصفّيها عدة مرات. هكذا تبدو دورة الفحص:
- إلغاء الفحص إذا كانت الإعدادات تمنع الفحص في هذه الصفحة أو لهذا المستخدم.
- جمع العناصر من مناطق الصفحة المحددة، مثل:
body > *:not('.ed11y-element')
لمستخدمي Editoria11y CSA، هذه هي المناطق الموجودة في تبويب اختبارات المطورين. - استبعاد العناصر التي تطابق محددات التجاهل، مثل:
.widgets, .utility-menu
لمستخدمي Editoria11y CSA، هذه هي المحددات الموجودة في تبويب اختبارات المطورين. - تشغيل الاختبارات ومزامنة النتائج مع لوحة التحكم.
-
إذا كانت الإعدادات المنفصلة مفعّلة وكان المستخدم محرر محتوى، تُصفّى نتائج المطورين:
- استبعاد نتائج الاختبارات المضبوطة على «للمطورين فقط».
- استبعاد النتائج الخاصة بالعناصر الواقعة خارج مناطق المحتوى المحددة، مثل:
main, footer - استبعاد النتائج الخاصة بالعناصر التي تطابق محددات التجاهل الخاصة بـالمحتوى.
- فتح اللوحة وعرض التنبيهات إذا طابقت الإعدادات أحد خيارات الفتح التلقائي.
تجاهل التنبيهات
يمكن ضبط الاختبارات في المكتبة لتكون أخطاءً أو تحذيرات («فحوصات يدوية»). ويمكن تجاهل التحذيرات. ويتوفر نوعان من التجاهل في تذييل كل تلميح:
- يُحفظ «تجاهل» كتفضيل للمستخدم: يُخفى التنبيه عن المستخدم الحالي، وعنه وحده فقط.
- يُخفي «وضع علامة سليم» التنبيه عن جميع المستخدمين.
يُتحكَّم في قدرة المستخدم على تجاهل التنبيهات على مستوى الدور، من خلال صلاحيات المستخدمين في Drupal. ينبغي السماح لمعظم الكتّاب بتجاهل التنبيهات. فلا جدوى من تكليف شخص بفحص يدوي إن لم يكن بإمكانه وضع علامة تفيد بأن العنصر قد فُحص.
تجاهل العناصر
هذان الإعدادان هما الأهم!
اضبط الإعداد الأول ليشمل أي أجزاء من الصفحة يستطيع كتّاب المحتوى تحريرها. على سبيل المثال، إذا كانوا يستطيعون تحرير منطقة المحتوى main و.sidebar و.footer-column-two، فاجعل هذه المحددات منطقة فحص المحتوى.
استخدم الإعداد الثاني «لاستبعاد» أقسام فرعية. على سبيل المثال، إذا كان main يحتوي على عناصر واجهة ومحتويات مضمَّنة متنوعة لا يستطيع تعديلها إلا المطورون، فأدرجها: .widget-1, .social-embed؛
إذا كنت تستخدم الإعدادات المنفصلة، فسترى زوجًا مشابهًا من الإعدادات في تبويب «اختبارات المطورين»:
أهم ما يجب معرفته عن مناطق فحص المطورين أنها ليست مستقلة عن مناطق فحص المحتوى. ففي الإعدادات المنفصلة، تُفحص مناطق المطورين أولًا، ثم تُصفّى تلك النتائج لتطابق مناطق المحتوى. وأي مناطق مستبعدة للمطورين ستُستبعد أيضًا لمحرري المحتوى. لا تستبعد مناطق المحتوى القابلة للتحرير!
تتيح بعض الاختبارات ضبطًا أدق، لإخفاء تنبيهات معينة فقط على العناصر المتأثرة. ابحث عنها ضمن:
- اختبارات المحتوى: الروابط المطلوب فحصها
- اختبارات المحتوى: المحتوى المضمَّن المطلوب فحصه
- اختبارات المحتوى: اكتشاف المحتوى الديناميكي ومحتوى Shadow DOM
- اختبارات المطورين: التباين
الإخفاء في صفحات محددة أو لمستخدمين محددين
أسهل طريقة لذلك هي تمرير أصناف CSS أو معرّفات ID إلى هذه الخيارات:
يمنع الخيار الأول تشغيل الفحوصات، ولن يظهر شريط الأدوات.
أما الخيار الثاني فيشغّل المدقق مصغّرًا، ويضع تلقائيًا (للمستخدم الحالي) علامة «متجاهَل» على جميع المشكلات، حتى لو كانت أخطاءً. وهذا يتيح تشغيل الاختبارات وتحديث لوحة التحكم دون إزعاج المستخدم.
إذا أردت استخدام هذه الخيارات للتحكم في المستخدمين الذين يرون المدقق، فقد تحتاج إلى تعديل قالبك ليُخرج صنفًا، مثل .user-247
إدارة النتائج على مستوى الموقع
الزحف وتحديث النتائج
Editoria11y أداة مراقبة فورية، لا برنامج زحف. تتحدّث تقاريره على مستوى الموقع عندما يعرض الكتّاب الصفحات، لذا لا حاجة عادةً إلى الزحف المنتظم. تتضمن وحدة CSA برنامج زحف بالفعل، لكن لا ينبغي أن تحتاج إليه إلا في هذه الحالات الثلاث:
- عند تثبيت Editoria11y لأول مرة على موقع قائم يضم صفحات كثيرة. يجب أن تُزار الصفحات قبل أن تظهر في لوحة التحكم، لذا يوفّر الزحف الأولي السريع الوقت.
- قد تُصلح التحديثات الكبرى للقوالب أو الوحدات مشكلات في صفحات كثيرة (أو تتسبب فيها)، ولن تظهر هذه المشكلات حتى تُزار الصفحات أو يُزحف عليها.
- تميل الإجراءات الجماعية في واجهة الإدارة، مثل حذف الصفحات أو عمليات إعادة التوجيه، إلى ترك نتائج من صفحات لم تعد موجودة أو نُقلت. وفي هذه الحالات، من المفيد استخدام إجراءات الصيانة في تبويب «التحديث» لتحديث عناوين URL للصفحات، واكتشاف الصفحات المحذوفة واستبعادها.
لا تغادر أي بيانات موقعك في أثناء الزحف. فبرنامج الزحف في CSA ليس أداة سحابية، بل يستخدم متصفحك لتحميل الصفحات وفحصها على موقعك أنت. وعيب هذا الأسلوب أن المتصفحات توقف علامات التبويب الخلفية مؤقتًا. لذا ستحتاج إلى إبقاء حاسوبك قيد التشغيل ومنعه من الدخول في وضع السكون في أثناء الزحف. خطّط لفتح نافذة جديدة لبرنامج الزحف، واتركه في علامة التبويب الأمامية لتلك النافذة في أثناء عمله. ويمكنك مواصلة العمل في نافذة أخرى. سيحدّث برنامج الزحف تقديره للوقت المتبقي بعد كل دفعة من الصفحات.
عرض التقارير
- يتيح تبويب الأحدث الاستكشاف حسب التنبيهات الفردية. فيمكنك مثلًا التصفية للعثور على جميع حالات نوع التنبيه نفسه، أو معرفة التنبيهات التي تتكرر كثيرًا في المحتوى الحديث، أو الكتّاب الذين ما زالوا يقعون في الخطأ نفسه.
- يعرض تبويب الصفحات عدد التنبيهات في كل صفحة، مجمّعةً حسب الصفحة. وهذا يساعدك على العثور على الصفحات التي تضم أكبر عدد من المشكلات، وعلى التصفية حسب خصائص الصفحة مثل نوع المحتوى وحالة النشر.
- يعرض تبويب التنبيهات المشكلات حسب النوع.
- يتيح تبويب حالات التجاهل مراقبة ما إذا كان الكتّاب يتجاهلون التنبيهات على نحو صحيح، ويحتوي على أزرار «إعادة تعيين» لاستعادة التنبيهات المتجاهَلة.
- يحتوي تبويب التصدير على نسخ من تقارير الصفحات والتنبيهات وحالات التجاهل يمكن تصفيتها لتجهيز ملفات CSV للتنزيل. توفره الوحدة الفرعية CSV Export
- يحتوي تبويب التحديث على أدوات صيانة لوحة التحكم، لاستبعاد التنبيهات من الصفحات المحذوفة، واستبعاد التنبيهات من الصفحات الزائفة ذات المعاملات مثل /search?query=example، وتحديث عناوين الصفحات وعناوين URL المخزنة، وتشغيل زحف يدوي. توفره الوحدة الفرعية CSA
إصلاح التلميحات المخفية أو الواقعة خارج الشاشة
توفر الوحدة حقولًا لاثنين من خيارات إعداد المكتبة لتغيير طريقة وضع التلميحات:
تحتوي بعض القوالب على أعمدة أو عناصر واجهة تُخفي المحتوى الفائض أفقيًا أو عموديًا. تكتشف المكتبة تلقائيًا متى يقع زر التنبيه خارج الجزء المرئي من الصفحة. وإخبار المكتبة بأن حاويات معينة تُخفي المحتوى الفائض يعني أنها ستحاول أيضًا وضع تلميحات العناصر الموجودة في تلك الحاويات داخل حدودها.
تحتوي بعض القوالب على عناصر واجهة تبدّل ظهور المحتوى، مثل القوائم القابلة للطي وعلامات التبويب وعروض الشرائح. وتكون التلميحات داخل هذه العناصر مخفية أيضًا. وتقديم قائمة بمحددات هذه العناصر يعني أن Editoria11y سيتوقف لحظة عندما يحاول المستخدم الانتقال إلى تلك التلميحات بزر «التالي» أو «السابق». ويمكن لقوالب Drupal ووحداته بعد ذلك اتباع التعليمات الواردة في قسم المكتبة حول التعامل مع التلميحات في المحتوى المخفي لإظهار المحتوى المخفي.
اكتب إعداداتك الخاصة
في PHP: توفر وحدة Drupal الخطّاف hook_editoria11y_alter_config لتغيير محتوى drupalSettings.editoria11y في وحدة أو قالب. على سبيل المثال:
لا يفيد تعديل drupalSettings إلا إذا كانت شيفرة JS في الوحدة مهيأة بالفعل لتمرير تلك القيمة إلى المكتبة. ولإضافة معاملات أخرى، عليك تعديل كائن options في JS مباشرةً. تتحقق الوحدة من وجود متغير JS عام واحد هو editoria11yOptionsOverride. فإذا كان معيّنًا، فستمرر كائن options إلى دالة editoria11yOptions توفرها أنت في وحدتك أو قالبك. وبذلك يمكنك ضبط أي من معاملات المكتبة.
اكتب اختباراتك الخاصة
أولًا، في إعدادات الوحدة، أضف 1 إلى خيار «الاختبارات المخصصة» لكي تعرف الوحدة أن عليها انتظار الاختبارات.
ثم أنشئ مكتبة Drupal JS تضم اختباراتك في قالبك أو وحدتك، مستعينًا بـدليل المكتبة لكتابة اختبارات مخصصة.
إليك مثالًا عمليًا من Princeton لاختبار مخصص يُطلق تنبيهًا عند وجود روابط Safe Links. لاحظ أنه يصل إلى صنف Editoria11y عبر Drupal.Ed11y.
الحصول على المساعدة
راجع صفحة جهات الاتصال للاطلاع على خيارات الدعم المجتمعي. عادةً ما يكون @itmaybejj متصلًا في Drupal Slack عندما تكون الشمس مشرقة في نصف الكرة الغربي.
تتضمن معظم مستويات المساهمة في CSA جلسة متابعة سنوية، قد تشمل مساعدة مباشرة في الإعداد والضبط