Ally araçlarının, filtresinin ve rapor eklentilerinin kurulumu

Eklentilerin 3.3 sürümleri Moodle 3.2 ile uyumludur.

  1. Github'dan Ally yönetici aracının gereken sürümünü indirin veya kopyalayın.

    1. ZIP dosyası olarak indirme
      1. Gerekirse şube sürümünü değiştirin.
      2. Gereken Moodle sürüm ("gerekli") numarasının ve sürümünün Moodle sürümünüze uygun olup olmadığını öğrenmek için version.php dosyasına göz atın. Yani Moodle 3.4 için

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        "3.4.3" sürümü Moodle 3.4 kurulumlarıyla çalışabilir. Bu parametreler Moodle kurulumunuzla eşleşmiyorsa şubeyi tekrar değiştirmeniz gerekebilir.

        İlgili Moodle sürümleri ve versiyon numaralarına ilişkin daha fazla bilgi

      3. "Kopyala veya indir > ZIP İndir"i kullanarak depoyu indirin
    2. Git deposunu kopyalama
      1. Araçlar klasörüne erişin.

        cd [moodle location]/admin/tool

      2. Depoyu kopyala
        • SSH kullanarak

          git clone [email protected]:blackboard-open-source/moodle-tool_ally ally

        • HTTP kullanarak

          git clone https://github.com/blackboard-open-source/moodle-tool_ally.git ally

      3. İlgili şubeyi kontrol edin, yani Moodle 3.4 için MOODLE_34_STABLE olmalıdır

        git checkout MOODLE_34_STABLE

        Güncelleştirmeleri almak için de şube kontrol edilebilir, dolayısıyla Moodle kurulumunuzu güncelleştirdiyseniz sadece ilgili şubeyi kontrol edebilirsiniz. Şube yoksa deponuz eski olabilir, getirme işlemi yaparak bu durum düzeltilebilir:

        git fetch

  2. Github'dan Ally filtresinin gereken sürümünü indirin veya kopyalayın.

    1. ZIP dosyası olarak indirme
      1. Gerekirse şube sürümünü değiştirin
      2. Gereken Moodle sürüm ("gerekli") numarasının ve sürümünün Moodle sürümünüze uygun olup olmadığını öğrenmek için version.php dosyasına göz atın. Yani Moodle 3.4 için

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        "3.4.3" sürümü Moodle 3.4 kurulumlarıyla çalışabilir. Bu parametreler Moodle kurulumunuzla eşleşmiyorsa şubeyi tekrar değiştirmeniz gerekebilir.

        İlgili Moodle sürümleri ve sürüm numaralarına ilişkin daha fazla bilgi.

      3. "Kopyala veya indir > ZIP İndir"i kullanarak depoyu indirin
    2. Git deposunu kopyalama
      1. Filtreler klasörüne erişin.

        cd [moodle location]/filter

      2. Depoyu kopyala
        • SSH kullanarak

          git clone [email protected]:blackboard-open-source/moodle-filter_ally ally

        • Http kullanarak

          git clone https://github.com/blackboard-open-source/moodle-filter_ally.git ally

      3. İlgili şubeyi kontrol edin, yani Moodle 3.4 için MOODLE_34_STABLE olmalıdır

        git checkout MOODLE_34_STABLE

        Güncelleştirmeleri almak için de şube kontrol edilebilir, dolayısıyla Moodle kurulumunuzu güncelleştirdiyseniz sadece ilgili şubeyi kontrol edebilirsiniz. Şube yoksa deponuz eski olabilir, getirme işlemi yaparak bu durum düzeltilebilir:

        git fetch

  3. Github'dan Ally rapor LTI aracının gereken sürümünü indirin.

    1. ZIP dosyası olarak indirme
      1. Gerekirse şube sürümünü değiştirin
      2. Gereken Moodle sürüm ("gerekli") numarasının ve sürümünün Moodle sürümünüze uygun olup olmadığını öğrenmek için version.php dosyasına göz atın. Yani Moodle 3.4 için

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        "3.4.3" sürümü Moodle 3.4 kurulumlarıyla çalışabilir. Bu parametreler Moodle kurulumunuzla eşleşmiyorsa şubeyi tekrar değiştirmeniz gerekebilir.

        İlgili Moodle sürümleri ve sürüm numaralarına ilişkin daha fazla bilgi.

      3. "Kopyala veya indir > ZIP İndir"i kullanarak depoyu indirin
    2. Git deposunu kopyalama
      1. Raporlar klasörüne erişin.

        cd [moodle location]/report

      2. Depoyu kopyala
        • SSH kullanarak

          git clone [email protected]:blackboard-open-source/moodle-report_allylti ally

        • HTTP kullanarak

          git clone https://github.com/blackboard-open-source/moodle-report_allylti.git ally

      3. İlgili şubeyi kontrol edin, yani Moodle 3.4 için MOODLE_34_STABLE olmalıdır

        git checkout MOODLE_34_STABLE

        Güncelleştirmeleri almak için de şube kontrol edilebilir, dolayısıyla Moodle kurulumunuzu güncelleştirdiyseniz sadece ilgili şubeyi kontrol edebilirsiniz. Şube yoksa deponuz eski olabilir, getirme işlemi yaparak bu durum düzeltilebilir:

        git fetch

  4. Klasör yapısını doğrulayın.

    Yönetici aracı dizininin adı ally yapılmalıdır. Aşağıdaki gibi bir yolu olmalıdır:

    [yourmoodledir]/admin/tool/ally

    Filtre dizininin adı ally yapılmalıdır. Aşağıdaki gibi bir yolu olmalıdır:

    [yourmoodledir]/filter/ally

    Rapor dizininin adı allylti yapılmalıdır. Aşağıdaki gibi bir yolu olmalıdır:

    [yourmoodledir]/report/allylti

  5. Her klasörün ve içeriğinin web sunucunuzda okunabilir olduğundan emin olun.
  6. Moodle sitenizde yönetici kullanıcı olarak oturum açın, ardından yönetici sayfasını açın. Böylece yeni eklentiler kontrol edilir ve size Moodle veritabanını şimdi yükselt seçeneği sunulur. Eklentileri yüklemek için bu düğmeyi seçin.
  7. Eklentileri yükledikten sonra Sistem Yönetimi > Eklentiler > Yönetici araçları > Ally öğesine gidin.
  8. Ally web hizmetini otomatik olarak yapılandır'ı seçin.

    Bir sonraki ekranda bir web hizmeti belirteci ve Ally web hizmetini test etmek için bir URL göreceksiniz.

    Bu URL'yi Ally'ın kullanabilmesi için internette doğrudan erişilebilmesi gerekir.

    Bu başarıyla yapıldığında, Ally web hizmet belirtecini ve web hizmeti bağlantısını kopyalamanız ve IronBox paylaşımı üzerinden Ally teknik danışmanınıza vermeniz gerekir. Bu paylaşımı teknik danışmanınız oluşturur ve erişim bağlantısını size e-posta ile sağlar. Kendi tarafında her şey kurulduğunda sizinle iletişime geçerek size "anahtarı", "parolayı" "başlatma URL'sini", "dosya güncelleştirme URL'sini ve "istemci kimliğini" verir.

    Moodle örneğinizde kullanıcı hesapları için özel, gerekli alanlar kullanılıyorsa söz konusu özel alanların doldurulması ve kaydedilmesi için eklenti otomatik yapılandırması tarafından oluşturulan Ally Web Hizmeti kullanıcısı olarak “Farklı oturum açın”.


Moodle eklentisini yapılandırma

Ally teknik danışmanı, önceki ekranda oluşturulan Moodle Web Hizmeti Belirtecini kullanarak Ally istemcisini oluşturur ve size Ally Eklentisinin yapılandırılmasıyla ilgili ayrıntıları verir.

  1. Moodle yöneticisi olarak giriş yapın.
  2. Site yönetimi bölümünden Eklentiler'i ve Yönetici araçları'nı seçin. Ally Yapılandırması'nı seçin.
  3. Aşağıdaki bilgileri girin
    • İçerik Yazarları: İçerik yazarı olan kullanıcı rolleri. Şunlar olmalıdır: Yönetici, Kursu oluşturan, Öğretmen (varsayılanlar).

      Normalde bunun değiştirilmesi gerekmez, lütfen Ally teknik danışmanının fikrini almadan bunu değiştirmeyin.

    • Anahtar: Ally teknik danışmanının sağladığı LTI Kodu
    • Parola: Ally teknik danışmanının sağladığı LTI Parolası
    • Başlatma URL'si: Ally teknik danışmanının sağladığı LTI Başlatma URL'si
    • Dosya Güncelleştirme URL'si: Ally teknik danışmanının sağladığı Dosya Güncelleştirme/Etkinlik URL'si https://[AllyEnvironment].ally.ac/api/v1/events
    • İstemci Kimliği: Ally teknik danışmanının sağladığı İstemci Kimliği
  4. Değişiklikleri kaydedin.

Ally Kurum Raporu

Ally eklentisi yapılandırıldıktan sonra, Ally Kurum Raporu'na erişebilirsiniz.

Ally kurs senkronizasyonu yapılıncaya ve ilk rapor oluşturuluncaya kadar raporda herhangi bir veri bulunmaz.

Ally Kurum Raporu'na erişmek için Site yönetimi'ne gidin ve Raporlar'ı seçin. Erişilebilirlik'i seçin.

Ally'ın Kurum raporu hakkında daha fazla bilgi


Ally Filtresi

Ally erişilebilirlik puanı göstergelerini ve Moodle'da kullanıma sunulan Alternatif Erişilebilir sürüm indirme seçeneğini almaya hazır olduğunuzda Ally filtresini etkinleştirmeniz gerekir.

Ally filtresini etkinleştirme

  1. Site yönetimi  bölümünden Eklentiler 'i ve Eklentilere genel bakış'ı seçin.
  2. Metin filtreleri bölümüne inin ve Ally filtresini etkinleştirin.
  3. Ally filtresini Filtre listesinin en üstüne taşıyın.

Ally Yapılandırması kullanıcı arayüzüne erişme

Kurulum sırasında Ally Yapılandırması'na nasıl erişeceğinize ilişkin talimatları size sağlarız. Erişiminiz yoksa Behind the Blackboard'dan bir istek gönderin.

Ally Configure Courses


Configure courses

Go to your Ally Configuration page and turn Ally on for all courses or decide course-by-course. It's up to you.

  1. View how many of your courses use Ally.
  2. Turn Ally on or off for all existing courses. Decide ahead of time if you want it enabled for all future courses as well.
  3. Search for individual courses or filter all course by enabled, disabled, and term.
  4. Turn Ally on or off for individual courses.

Turn Ally on or off for a single course

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

From Ally Configuration, find the course you want to update. Use the Search field and filters to search by course title, course ID and course code.

Select Enable or Disable under the Enabled column to turn Ally on or off.

  • Ally is off: Select Enable course UI integration to turn on
  • Ally is on: Select Disable course UI integration to turn off

Turn Ally on or off for all courses

Not sure if all courses are using Ally or not? At the top of the Ally Configuration page, see how many of your courses are currently using Ally.

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

You can turn Ally on or off in every existing course from the Ally Configuration page. Select Disable/enable all courses and select Disable or Enable.

Select Enable in future courses if you want Ally automatically on in all new courses.

If you don't select this, new courses will not have Ally enabled. If you want Ally on at a later date, turn Ally on for single courses.

After you choose to disable or enable in all courses, you need to confirm your choice. Select Enable or Disable, depending on your choice. Select Cancel if you changed your mind and don't want to change anything.


Turn Ally on for all new courses only

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

Select Enable in future courses if you want Ally automatically on in all new courses.

If you don't select this, new courses will not have Ally enabled. If you want Ally on at a later date, turn Ally on for single courses.

Ally Configure Help Settings


Configure Ally user help settings

Configure custom help messages that display in the Alternative formats and Instructor feedback modals. The custom help messages can be used to point students and instructors to existing institutional documentation, share contact information, and so on. The custom help content can be configured in the Ally Configuration UI, and uses the Markdown format to help provide a structured (and accessible) message.

When no custom message has been configured, the Help links point to these pages in Blackboard help:

  • Alternative formats: This page explains how and when the different alternative formats can be used
  • Instructor help: Everything instructors need to know about Ally in their courses
  1. Go to your Ally Configuration and select Help settings.
  2. Choose the default or custom help option for both the Instructor feedback help and Alternative formats help.
  3. If you choose the custom option, edit the Custom message.

    Use the Markdown format to help provide a structured (and accessible) message.

  4. Select Save changes.

Configure expert help

Give your instructors and students easy access to your team of accessibility experts. Enable expert help to add a way for your users to request more help directly from in the alternative formats and instructor feedback panels.

When a request is made, an email containing the help request and details about the current course, content item and user is sent to the email address you configure.

  1. Go to your Ally Configuration and select Help settings.
  2. Choose Provide custom help for both the Instructor feedback help and Alternative formats help.
  3. Select Enable expert help.
  4. Type the email address for your team of accessibility experts.
  5. Select Save changes.

The Ally API user for the Blackboard Learn integration needs to be given the "Administrator Panel (Users) > Users" or "system.user.view" permission to allow Ally to include the student name and email address in the help request email. The Ally API user for the Moodle integration needs to be given the “moodle/user:viewalldetails” permission to allow Ally to include the student name and email address in the help request email.

Request alternative formats help

Request instructor feedback help