البرنامج الآلي الباحث لـ Ally الخاص بمواقع الويب

يدمج البرنامج الآلي الباحث لـ Ally الخاص بمواقع الويب عبارات Disallow في ملفrobots.txt . تساعد هذه العبارات في منع البرنامج الآلي الباحث من الوقوع في حلقات بحث لا نهائية على أنواع معينة من المحتوى، مثل صفحات البحث وتطبيقات التقويم وما إلى ذلك.

يلتزم البرنامج الآلي الباحث لـ Ally الخاص بمواقع الويب بمعيار استبعاد أجهزة الروبوت. وكيل المستخدم المحدد الذي يستخدمه Ally هو: blackboardally


تعطيل التنسيقات البديلة

يمكنك إيقاف تشغيل التنسيقات البديلة لعناصر المحتوى الفردية، إذا كنت تريد ذلك. أضف السمة data-ally-af-disabled إلى الملف المرتبط في صفحة HTML. تمنع هذه السمة الملف من الظهور في لوحة التنسيقات البديلة .

على سبيل المثال، إذا قمت بإضافته إلى ملف مرتبط، فلن يظهر هذا الملف المرتبط في القائمة:  <a data-ally-af-disabled href:"https://filename.pdf">PDF file</a>.

قم بإزالة السمة في أي وقت، إذا كنت تريد أن يظهر عنصر المحتوى في لوحة التنسيقات البديلة .

مثال:

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


استبعاد أجزاء من صفحة ويب

يمكنك استبعاد أجزاء بعينها من صفحة الويب من محتوى التنسيق البديل. أضف السمة  data-ally-exclude إلى عنصر المحتوى في HTML لديك. تمنع هذه السمة المحتوى من الظهور بالتنسيق البديل المحدد.

على سبيل المثال، إذا أضفت السمة إلى صورة على الصفحة، فلن تظهر تلك الصورة في التنسيق البديل لـ BeeLine Reader عند فتحها.

إذا كان هناك عنصر <main> موجود على موقع الويب، فسيظهر فقط ما هو موجود داخل هذا العنصر الرئيسي في محتوى التنسيق البديل. يتم استبعاد أي شيء خارج العنصر الرئيسي تلقائيًا. ما زال بإمكانك استخدام السمة data-ally-exclude تقوم السمة في استبعاد العناصر الموجودة داخل ذلك العنصر الرئيسي.

مثال:

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


تكوين رمز تنزيل التنسيقات البديلة

حدد كيفية ظهور رمز تنزيل التنسيقات البديلة. اختر أحد الخيارات التالية:

  • رمز صغير على يمين الصفحة: data-ally-af-style="flag_small"
  • رمز كبير على يمين الصفحة: data-ally-af-style="flag_large"
  • شريط بطول الجزء السفلي للصفحة: data-ally-af-style="bar_bottom"

استخدم هذا البرنامج النصي لتخصيص الشكل العام.

<!--
    البرنامج النصي لتكامل Ally على مواقع الويب.
    "data-ally-af-style" يمكن أن تكون إحدى القيم التالية لتخصيص الشكل العام:
        - 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>


تكوين ملاحظات محرر المحتوى

قم بتكوين موقعك لمعرفة الموضع الدقيق لوجود مشكلات إمكانية وصول ذوي الاحتياجات الخاصة لديك. بعد تكوين الصفحات على موقعك، انتقل إلى تقرير إمكانية وصول ذوي الاحتياجات الخاصة، وابحث عن مجال به مشكلة. حدد مؤشر الدرجة على العنصر الذي به مشكلة إمكانية وصول ذوي الاحتياجات الخاصة لفتح لوحة ملاحظات محتوى المحرر. اطلع على المشكلات التي تم تمييزها على صفحتك في نافذة المعاينة.

تحتاج الصفحات الموجودة على موقعك إلى هذه الإعدادات، إذا كنت تريد أن يظهر محتوى صفحتك في نافذة المعاينة.

  • مواقع HTTPS المدعومة
  • إضافة البرنامج النصي AllyJS

    وهذا البرنامج النصي مطلوب أيضًا للتنسيقات البديلة. إذا كنت ترغب في رؤية المشكلات المميزة في نافذة المعاينة، ولكنك لا تريد إضافة التنسيقات البديلة إلى موقعك، فاستخدم الخاصية data-ally-af-style=none.

  • السماح بتضمين الصفحة في iframe بواسطة مجال Ally
  • السماح بالبرامج النصية، والأنماط، والصور، وiframes الفرعية المستضافة بواسطة مجال Ally

السماح لـ Ally بتضمين صفحاتك في iframe

إذا كنت ترغب في الاستفادة الكاملة من لوحة ملاحظات محرر المحتوى، كشريك موثوق به، يحتاج Ally إلى إذن لتضمين المحتوى الخاص بك في iframe. يسمح هذا الإذن لـ Ally بعرض المحتوى الخاص بك في نافذة المعاينة بلوحة ملاحظات محرر المحتوى. يمكن الوصول إلى اللوحة فقط من تقرير إمكانية وصول ذوي الاحتياجات الخاصة.

إذا قمت بمنع تضمين صفحتك على الويب في iframes (على سبيل المثال، باستخدام رؤوس X-Frame-Options أو Content-Security-Policy)، فستحتاج إلى تغيير رأس Content-Security-Policy لإضافة https://*.ally.ac إلى توجيهات frame-ancestors.

أمثلة

أمثلة على التكوين
التكوين الحاليإضافة أو تحديث توجيهات frame-ancestors
رأس X-Frame-Options بالقيمة DENYContent-Security-Policy: frame-ancestors https://*.ally.ac;
رأس X-Frame-Options بالقيمة SAMEORIGINContent-Security-Policy: frame-ancestors 'self' https://*.ally.ac;
Content-Security-Policy باستخدام توجيهات frame-ancestors 'none'Content-Security-Policy: frame-ancestors https://*.ally.ac;
Content-Security-Policy باستخدام توجيهات frame-ancestors مع قائمة المجالاتContent-Security-Policy: frame-ancestors 'self' https://*.anothersite.com https://*.ally.ac;