LTI 1.3 aracılığıyla LMS'inize Yorum Ekleme

1. FastComments'a giriş yapın ve LTI 1.3 Yapılandırma sayfanıza gidin.
2. (İsteğe bağlı) Bağlandığınız platformu Platform açılır menüsünden seçin - bu, görüntüleme etiketini ayarlar, ancak Auto-detect iyi çalışır.
3. Generate URL'ye tıklayın. Tek kullanımlık bir Registration URL görünür (30 dakika geçerli, tek kullanımlık).
4. LMS'inizde, LTI 1.3 Dinamik Kayıt ekranını açın ve URL'yi Tool initiation registration endpoint (veya eşdeğeri) alanına yapıştırın. Gönderin.
5. LMS'iniz FastComments'a geri çağrı yapar, anahtarları değiş tokuş eder ve entegrasyonu oluşturur. İşlem tamamlandığında açılır pencere kendiliğinden kapanır.
6. FastComments'e geri döndüğünüzde, yeni yapılandırma Existing Configurations tablosunda görünür. Araç artık LMS derslerinizin içinde kullanılabilir.

FastComments LTI 1.3 şu platformlarda test edilmiştir:

• D2L Brightspace (LTI Advantage içeren herhangi bir sürüm)
• Moodle 4.0+ (External Tool eklentisi, LTI Advantage)
• Blackboard Learn (SaaS ve Ultra)
• Sakai (LTI Advantage desteği olan sürümler)
• Schoology (Enterprise, Dynamic Registration mevcut olduğunda)

IMS LTI 1.3 Advantage spesifikasyonunu Dynamic Registration ile uygulayan diğer herhangi bir LMS de çalışmalıdır - kayıt URL'nizi oluştururken platform açılır menüsünden Other LTI 1.3 platform seçeneğini seçin (buradan edinin).

Canvas LMS farklı bir kurulum akışı kullanır (Dynamic Registration yerine per-developer-key yapılandırma JSON'u). Ayrı Canvas LMS kurulum kılavuzuna bakın.

LTI 1.3 Yapılandırmasına Gidin

FastComments'e giriş yapın ve LTI 1.3 Yapılandırma sayfanıza gidin.

Hesabınızın henüz LTI erişimi yoksa "LTI not enabled for this account" mesajını görürsünüz - planınızda etkinleştirmek için destek ile iletişime geçin.

Bir Platform Seçin (İsteğe Bağlı)

Generate a Dynamic Registration URL altında, FastComments'e hangi LMS'e bağlandığınızı söylemek için Platform açılır menüsünü kullanın:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Diğer LTI 1.3 platformu

Ayrıca Auto-detect olarak bırakabilirsiniz. Platform, kayıt sırasında LMS'inizin openid-configuration'ından okunur; açılır liste yalnızca ortaya çıkan yapılandırma için görüntü etiketini belirler.

URL Oluştur

Generate URL öğesine tıklayın. FastComments tek kullanımlık bir kayıt belirteci oluşturur ve size şu görünüme sahip bir URL gösterir:

https://fastcomments.com/lti/v1p3/register/<long-token>

Kopyalayın. Bu URL:

• Tek kullanımlıktır - LMS'iniz başarılı bir şekilde çağırdığında belirteç tüketilir.
• Kullanılmazsa 30 dakika sonra süresi dolar.
• Gizli tutulmalıdır - URL'e sahip olan herkes bu 30 dakika içinde kiracınıza (tenant) karşı araç kaydı yapabilir.

Mevcut Yapılandırmalar

Kayıt başarıyla tamamlandığında, yeni yapılandırma aynı sayfadaki Existing Configurations tablosunda Platform, Issuer, Client ID ve Status ile görünür. Kayıt iptali yapmanız gerekirse bu tablodan yapılandırmaları silebilirsiniz.

D2L Brightspace, LTI Advantage yönetici arayüzü üzerinden Dinamik Kayıt'ı (Dynamic Registration) sunar. Yönetici erişimine ihtiyacınız olacak.

Kayıt Ekranını Açın

1. Brightspace örneğinize yönetici olarak giriş yapın.
2. Admin Tools > Manage Extensibility > LTI Advantage adresine gidin.
3. Register Tool'a tıklayın. (Doğrudan URL https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

URL'yi Yapıştırın

Bir kayıt formu göreceksiniz. Ana alan Tool initiation registration endpoint'tir (bazı Brightspace sürümleri bunu "Tool Initiation Registration URL" olarak etiketler).

Bu alana FastComments kayıt URL'sini (buradan alın) yapıştırın. Diğer alanları boş bırakın - kayıt el sıkışması sırasında FastComments tarafından otomatik doldurulacaktır.

Register'a tıklayın.

Aracı Onaylayın

Brightspace, FastComments ile iletişim kuran, anahtarları değiştiren ve bir onay ekranı gösteren bir açılır pencere (popup) açar. Kayıt tamamlandığında açılır pencere kendiliğinden kapanır.

Yeni araç LTI Advantage araç listenizde görünür. Varsayılan olarak Brightspace yeni araçları devre dışı olarak işaretler - kurslarınızın kullanabilmesi için anahtarı etkin konuma getirin.

Bir Dağıtım Ekleyin

Brightspace'ta, LTI araçlarının derslerde kullanılabilmesi için bir deployment gereklidir:

1. Yeni kaydedilmiş FastComments aracını açın.
2. View Deployments > New Deployment'a tıklayın.
3. Dağıtıma bir isim verin (örn. "FastComments - All Courses"), kullanılacağı organizasyon birimlerini seçin ve kaydedin.

Bu dağıtım üzerinden ilk başlatmadan sonra FastComments, deployment_id'yi yapılandırma kaydına sabitler - aynı istemci altındaki farklı bir dağıtımdan sonraki başlatmalar, yeniden kayıt yapmadığınız sürece reddedilecektir.

Moodle mı kullanıyorsunuz? Ayrıca FastComments için LTI 1.3'ten daha sıkı bir entegrasyon sunan (not eşitleme kancaları, daha kapsamlı etkinlik raporlaması, yerel Moodle ayarlar kullanıcı arayüzü) özel bir Moodle eklentisi yayımlıyoruz. Moodle eklenti kurulum kılavuzuna bakın. Aşağıdaki LTI 1.3 akışı, diğer LMS'leri de kapsayan tek bir kayıt istiyorsanız veya Moodle yöneticiniz üçüncü taraf eklentileri yüklemeyecekse doğru seçimdir.

Moodle 4.0+ External Tool eklentisi aracılığıyla LTI 1.3 Dinamik Kayıt'ı destekler.

Araç Yönetim Ekranını Açın

1. Moodle'a site yöneticisi olarak giriş yapın.
2. Site yönetimi > Eklentiler > Etkinlik modülleri > External tool > Araçları yönet yolunu izleyin.

URL'yi Yapıştırın

Tool URL başlıklı bir kart göreceksiniz. Metin alanına FastComments kayıt URL'sini (buradan alın) yapıştırın ve Add LTI Advantage'a tıklayın.

Moodle, aracın kimliğini ve talep ettiği izinleri gösteren bir kayıt ekranı açar. İnceleyin ve Moodle sürümüne bağlı olarak Etkinleştir (veya Kaydet) seçeneğine tıklayın.

Kayıt tamamlandığında açılır pencere kapanır; yeni FastComments aracı Araçlar listesinde Etkin durumuyla görünür.

Kullanılabilir Hale Getirin

Varsayılan olarak Moodle yeni araçları "Course tools" listesine ekler ancak etkinlik seçicisinde göstermez. FastComments'ı tüm ders genelinde görünür yapmak için:

1. FastComments kartındaki dişli simgesine tıklayın.
2. Tool configuration usage altında Show in activity chooser and as a preconfigured tool seçeneğini işaretleyin.
3. Kaydet.

Eğitmenler artık herhangi bir derse Etkinlik veya kaynak ekle > FastComments yoluyla FastComments ekleyebilir.

Blackboard Learn SaaS ve Ultra, LTI 1.3 Dinamik Kaydı destekler.

Araç Sağlayıcı Ekranını Açın

1. Blackboard'a sistem yöneticisi olarak giriş yapın.
2. Şuraya gidin: Administrator Panel > Integrations > LTI Tool Providers.
3. Tıklayın Register LTI 1.3 / LTI Advantage Tool.

If you only see "Register LTI 1.1 Provider", your Blackboard version doesn't support LTI 1.3 yet - upgrade or contact Blackboard support.

URL'yi Yapıştırın

FastComments kayıt URL'sini (buradan alın) Client ID / Registration URL alanına yapıştırın (Blackboard'un etiketlendirmesi sürüme göre değişir). Gönderin.

Blackboard, FastComments ile kayıt el sıkışmasını gerçekleştirir ve size bir onay ekranı gösterir.

Onaylayın ve Etkinleştirin

Blackboard varsayılan olarak yeni kaydedilen araçları Approved but excluded olarak işaretler:

1. Araç sağlayıcı listesinde FastComments girdisini bulun.
2. Menüyü açın ve Edit'i seçin.
3. Tool Status'u Approved olarak ayarlayın.
4. Institution Policies altında hangi kullanıcı verilerinin gönderildiğini (name, email, role) gözden geçirin. Kaydedin.

Araç artık eğitmenlerin derslere içerik eklediklerinde kullanılabilir.

Sakai

Sakai, LTI Advantage içeren sürümlerde LTI 1.3 Dinamik Kaydı destekler. Yönetim Çalışma Alanı'ndan:

1. Bir Sakai yöneticisi olarak oturum açın ve Yönetim Çalışma Alanı'nı açın.
2. Harici Araçlar > LTI 1.3 Aracı Yükle seçeneklerini seçin.
3. FastComments kayıt URL'sini yapıştırın (buradan alabilirsiniz) ve gönderin.
4. El sıkışma tamamlandığında aracı onaylayın.

Araç daha sonra Harici Araçlar altında görünür ve site yöneticileri tarafından sitelere eklenebilir.

Schoology

Schoology Enterprise örnekleri LTI 1.3'ü destekler, ancak Dinamik Kayıt kullanılabilirliği dağıtıma göre değişir. Schoology hesap yöneticinizle kontrol edin.

Schoology örneğinizde Dinamik Kayıt kullanılamıyorsa, entegrasyonu manuel olarak şu uç noktaları kullanarak yapılandırmanız gerekir:

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

Schoology size bir Client ID ve Deployment ID verdikten sonra, yapılandırmayı kiracınıza kaydetmek için FastComments destek ekibiyle iletişime geçin.

Other LTI 1.3 Platforms

IMS LTI 1.3 Advantage spesifikasyonunu takip eden herhangi bir LMS, aynı kayıt URL'si ile çalışmalıdır (buradan alabilirsiniz). "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" veya benzeri etiketli bir ayar arayın.

Platformunuz yalnızca manuel LTI 1.3 kurulumu destekliyorsa, yukarıdaki Schoology bölümünde listelenen dört uç noktayı kullanın ve işlemi tamamlamak için destek ile iletişime geçin.

Bu sayfa, bir yönetici aracı kaydettikten ve bir dağıtım oluşturduktan sonra FastComments'ın bir Brightspace dersine nasıl ekleneceğini açıklar. Araç henüz kaydedilmediyse önce D2L kayıt kılavuzuna bakın.

Brightspace'te bir birim konusu olarak gömülü FastComments

Brightspace iki içerik oluşturma deneyimi sunar: Classic Content ve New Content Experience (aynı zamanda Lessons olarak da adlandırılır). Her ikisi de FastComments'ı sunar, ancak menü yolları farklıdır. Aşağıdaki her bölüm, farklılaştıkları yerleri kapsar.

FastComments Araç öğesini Bulma

FastComments aracı, ders içerik düzenleyicisinin içinde iki yerde görünür:

1. Bir modül/birimdeki Add Existing düğmesinden (eski Brightspace sürümlerinde Add Existing Activities olarak etiketlenir) erişilen etkinlik seçicisinde. Güncel Brightspace sürümlerinde FastComments doğrudan seçicide görünür; eski sürümlerde External Learning Tools alt menüsünün altında yer alır. Her iki yol da FastComments'ı bağımsız bir konu olarak ekler.
2. HTML editörü içindeki Insert Stuff iletişim kutusunda, LTI Advantage altında. Bu, LTI derin bağlantı akışı ile FastComments'ı bir HTML konusu içinde satır içi olarak gömer.

FastComments her iki seçicide de görünmüyorsa, dağıtım dersi barındıran örgüt birimi için etkinleştirilmemiş demektir. Brightspace yöneticinize Yönetici Araçları > Uzantıları Yönet > LTI Advantage > FastComments aracı > Dağıtımları Görüntüle yolunu açmasını, dağıtımı açmasını ve dersin org birimini (veya bir üst org birimini) Org Units altında eklemesini isteyin.

Bir Modüle FastComments Konusu Ekleme

Classic Content:

1. Dersi açın ve gezinme çubuğunda Content öğesine tıklayın.
2. Tartışmanın yer alacağı modülü seçin (veya Add a module ile bir tane oluşturun).
3. Add Existing (eski Brightspace: Add Existing Activities > External Learning Tools) öğesine tıklayın.
4. Seçicide FastComments'a tıklayın. Brightspace modülde bir konu oluşturur ve sizi içerik görünümüne geri getirir.
5. Yeni konuya tıklayın. Satır içi başlık düzenleyicisini kullanarak adını FastComments Discussion gibi açıklayıcı bir şeyle değiştirin.

New Content Experience (Lessons):

1. Dersi açın ve Content öğesine tıklayın.
2. Tartışmanın yer alacağı birimi ve dersi açın.
3. Add > Existing Activity öğesine tıklayın ve FastComments'ı seçin (eski Brightspace: External Learning Tools altında iç içe).
4. Etkinlik derse eklenir.
5. Etkinlik başlığına tıklayarak yeniden adlandırın.

Herhangi bir kullanıcı (öğretim üyesi veya öğrenci) konuyu ilk açtığında, FastComments kaynağa ait bağlantı için tartışma dizisini başlatır. Diziler kaynak bağlantı kimliğine bağlıdır, bu yüzden konunun adını değiştirmek veya taşımak hangi dizinin yüklendiğini etkilemez.

Bir HTML Konusunda FastComments'ı Satır İçi Gömme

Okumanın, videonun veya diğer içeriğin altında yorumların aynı konu sayfasında, ayrı bir konu olarak değil de görünmesini istediğinizde bu akışı kullanın.

1. Modülde/derste bir HTML konusu açın veya oluşturun.
2. Brightspace HTML editörünü açmak için Edit HTML'ye tıklayın.
3. Yorum dizisinin görünmesini istediğiniz yere imleci yerleştirin.
4. Insert Stuff düğmesine (editör araç çubuğundaki puzzle-parça simgesi) tıklayın.
5. Insert Stuff iletişim kutusunda LTI Advantage bölümüne kadar kaydırın ve FastComments'a tıklayın.
6. FastComments bir derin bağlantı seçici açar. Yerleşimi onaylayın (varsayılan seçenekler içerik tartışmaları için uygundur); Insert veya Continue'a tıklayın.
7. Brightspace, LTI başlatmasını temsil eden bir yer tutucu bloğu ile HTML editörüne geri döner. Konu üzerinde Save and Close'a tıklayın.

Konu yüklendiğinde, Brightspace yer tutucuyu bir iframe ile değiştirir ve iframe LTI aracılığıyla FastComments'ı otomatik başlatır. Öğrenciler tartışma dizisini satır içinde görür.

Tek bir HTML konu birden fazla derin bağlı FastComments gömmesini barındırabilir. Her gömme kendi dizisini alır çünkü her derin bağlantı ayrı bir kaynak bağlantı kimliği üretir.

Modül Konusu vs Satır İçi Hızlı Bağlantı

Aşağıdaki durumlarda modül konusu yaklaşımını seçin:

• Tartışma, modüldeki adım için birincil etkinlikse.
• Konunun Brightspace içindekiler tablosunda, tamamlanma takibinde ve Sınıf İlerlemesinde görünmesini istiyorsanız.

Aşağıdaki durumlarda satır içi gömme yaklaşımını seçin:

• Yorumların aynı sayfadaki diğer içeriğin altında yer almasını istiyorsanız.
• İçindekiler tablosunda ayrı, tamamlanma takibi yapılabilen bir öğe istemiyorsanız.

Görünürlük, Taslak ve Serbest Bırakma Koşulları

Yeni bir FastComments konusu varsayılan olarak öğrencilere görünür. Kurulum sırasında gizlemek için:

1. İçerik düzenleyicisinde konu başlığına (Classic) veya etkinlikteki üç nokta menüsüne (New Content Experience) tıklayın.
2. Durumu Classic için Draft olarak ayarlayın veya New Content Experience için Visibility'yi kapatın.

Taslak konular öğrencilere görünmez. Öğretim üyeleri ve asistanlar onları "Draft" rozeti ile görmeye devam eder.

Konuyu belirli bir grup veya bölüme sınırlamak için:

1. Konuyu açın.
2. Konu başlığı menüsü > Edit Properties In-place (Classic) veya Edit > Restrictions (New Content Experience) öğesine tıklayın.
3. Release Conditions altında Create'a tıklayın.
4. Group enrollment veya Section enrollment'ı seçin, grup/bölümü seçin ve kaydedin.

Serbest bırakma koşulları, FastComments'ın kendi rol eşlemesi ile üst üste biner. Konuyu göremeyen öğrenciler LTI başlatması almaz.

Öğrencilerin İlk Başlatmada Gördükleri

Bir öğrenci konuya tıkladığında (veya bir gömme içeren bir HTML konusu yüklendiğinde):

1. Brightspace arka planda LTI 1.3 başlatmasını gerçekleştirir.
2. FastComments öğrencinin adını, e-postasını, avatar URL'sini ve LMS rolünü alır ve onları otomatik olarak oturum açtırır. FastComments giriş istemi olmaz.
3. O kaynağa ait yorum dizisi Brightspace iframe'i içinde görüntülenir.

Başlatmadaki rol eşlemesi:

• Brightspace Administrator dizide FastComments üzerinde tam yönetim (tam moderasyon, silme, engelleme ve yapılandırma erişimi) sağlayan bir FastComments admin olur.
• Brightspace Instructor FastComments'ta bir moderator olur (pin, gizle, sil, engelle).
• Diğer tüm roller (Learner, TeachingAssistant, vb.) standart yorumcu olurlar.

Yorumlar öğrencinin Brightspace hesabına atfedilir. Öğrenci Brightspace'te adını veya avatarını düzenlerse, bir sonraki LTI başlatması bu değişikliği senkronize eder.

Genel Erişimi Kapatma (Önerilir)

Varsayılan olarak, FastComments yorum verileri genel olarak okunabilir. Birisi bir dizinin URL'sini veya API uç noktasını tahmin edebilirse, Brightspace dışında bile yorumlarını görebilir. Ders tartışmaları için neredeyse kesinlikle görüntülemeyi yalnızca kayıtlı öğrencilerle sınırlandırmak istersiniz.

widget özelleştirme sayfanızı açın ve Require SSO To View Comments etkin olan bir kural oluşturun, ardından güvenlik düzeyini Secure SSO olarak ayarlayın, böylece diziler yalnızca imzalı LTI başlatması aracılığıyla yüklenebilir.

Tam yürütme için, bir kuralı tek bir alan adı veya sayfayla nasıl sınırlandıracağınızı da içeren Protecting Comment Threads With Single-Sign-On bölümüne bakın.

Iframe Yüksekliği ve Yeniden Boyutlandırma

FastComments her dizin render'ında ve içerik değişikliklerinde (yeni yorum, cevapları genişletme) org.imsglobal.lti.frameResize postMessage'ını yayınlar. Brightspace bu mesajı dinler ve iframe yüksekliğini ayarlar, böylece dizi kesilmez ve iç kaydırma çubuğu göstermez.

Iframe sabit kısa bir yükseklikte kalıyorsa:

• Dersin HTTPS üzerinden yüklendiğini doğrulayın. Brightspace'in postMessage dinleyicisi karışık içerikli frameleri reddeder.
• Hiçbir tarayıcı uzantısının postMessage kanalını engellemediğini doğrulayın.
• Bir HTML konusundaki satır içi gömmeler için, çevreleyen HTML iframe'i sabit yükseklikte bir kapsayıcı içine sarmamalıdır. Ebeveyn öğeden herhangi bir inline style="height: ..." ifadesini kaldırın.

Brightspace'e Özgü Dikkat Edilmesi Gerekenler

Araç Add Existing seçicisinde görünmüyor. Dağıtım bu dersin org birimi için etkinleştirilmemiştir. Bir yönetici dağıtımın Org Units listesine org birimini (veya bir üstünü) eklemelidir. Araç kaydı tek başına yeterli değildir; dağıtım hangi derslerin aracı gördüğünü sınırlar.

Başlatmada deployment_id uyuşmazlığı. FastComments bir kayıt için gördüğü ilk deployment_id'yi TOFU (Trust On First Use) ile sabitler. Bir yönetici orijinal dağıtımı silip yenisini oluşturursa, yeni dağıtımdan yapılan başlatmalar dağıtım uyuşmazlığı hatasıyla reddedilir. Düzeltme, FastComments'ı yeniden kaydetmektir (yeni kayıt URL'si oluşturun (buradan edinin) ve Dinamik Kaydı tekrar çalıştırın); eski yapılandırma kaydı yeni olanla değiştirilir.

Araç başlatılıyor ama "Invalid LTI launch" gösteriyor. Ders, dağıtımın kapsadığı kiracı/örgüt yapısının dışında veya dağıtım kayıt sonrası devre dışı bırakılmış olabilir. Yönetici Araçları > Uzantıları Yönet > LTI Advantage > FastComments > Enabled geçişini ve dağıtımın org birimi listesini tekrar kontrol edin.

FastComments içinde isimler ve roller eksik. Brightspace, NRPS (Names and Role Provisioning Services) iddialarıyla LTI başlatmaları gönderir. Bir ders daha eski bir LTI 1.1 bağlantısından yükseltildiyse, başlatma name ve email iddialarından yoksun olabilir. FastComments konusunu Add Existing ile yeniden ekleyin (eski bağlantıyı migrate etmeyin) ki başlatma LTI 1.3 kullansın.

Gömme, otomatik SSO yerine bir giriş ekranı gösteriyor. HTML konusu, Insert Stuff > LTI Advantage yoluyla değil de doğrudan FastComments'a işaret eden düz bir <iframe> olarak eklenmiş olabilir. Düz iframeler LTI başlatmasını atlar ve kullanıcıları halka açık FastComments sayfasına götürür. Iframe'i silin ve Insert Stuff akışı ile yeniden ekleyin.

Bu kılavuz, bir site yöneticisinin aracı kaydedip etkinlik seçicisinde göstermesinin ardından FastComments'in bir Moodle 4.x dersine nasıl ekleneceğini açıklar. FastComments henüz kaydedilmediyse önce Moodle kayıt kılavuzuna bakın.

Dersi Düzenleme Modunda Açın

1. Ders için Düzenleme Öğretmeni (veya daha üstü) olarak Moodle'a giriş yapın.
2. Dersi açın.
3. Ders başlığının sağ üst köşesindeki anahtar ile Düzenleme modunu açın.

Moodle 4.x, 3.x'te kullanılan eski "Add an activity or resource" açılır menüsünü tam ekran etkinlik seçici dialoguyla değiştirdi. Moodle 4.5 aynı seçiciyi koruyor ancak üstte yıldızlı/favoriler satırı ekliyor; FastComments'i bir kez sabitlemek, sonraki bölümlerde daha hızlı ulaşmanızı sağlar.

FastComments Etkinliğini Ekle

1. Tartışmanın ait olduğu ders bölümüne (konu veya hafta) kaydırın.
2. O bölümün altındaki Add an activity or resource öğesine tıklayın.
3. Seçici dialogunda FastComments'i seçin. Görmüyorsanız aşağıdaki gotchas bölümüne atlayın.

Etkinlik ayarları formu açılır. Önemli alanlar:

• Etkinlik adı (gerekli). Ders sayfasında ve not defterinde gösterilir. Örnek: Week 3 Discussion.
• Etkinlik açıklaması. Yorum dizisinin üstünde görüntülenen isteğe bağlı giriş metni.
• Açıklamayı ders sayfasında göster. Açıklamanın etkinliğe tıklamadan görünmesini istiyorsanız bunu işaretleyin.
• Ön yapılandırılmış araç. FastComments olarak ayarlı (seçiciden başlatıldığında otomatik seçilir). Değiştirmeyin.
• Başlatma kapsayıcısı. Yeni pencerede olarak ayarlayın. Bazı Moodle dağıtımlarında "Aynı pencerede" seçeneğinin neden bozulduğunu görmek için gotchas bölümüne bakın.
• Tool URL, Public key, Shared secret, Custom parameters. Boş bırakın. Dinamik Kayıt bunları site düzeyinde yönetir.

Sayfanın altına kaydırın ve Kaydet ve derse dön (veya etkinliği hemen açmak için Kaydet ve göster) öğesine tıklayın.

Etkinlik, ilgili bölümde FastComments simgesiyle bir satır olarak görünür. Öğrenciler yorum dizisini açmak için bu satıra tıklar.

Düzenleyiciyle Satır İçi Olarak FastComments Gömme

Atto veya TinyMCE düzenleyicisini kullanan bir Page, Book bölümü, Lesson veya diğer herhangi bir kaynaktaki bir konu için:

1. Kaynağı düzenleme modunda açın.
2. İmleci dizinin görünmesini istediğiniz yere yerleştirin.
3. Düzenleyici araç çubuğunda LTI / External tool düğmesine tıklayın. Atto'da "Insert LTI Advantage content" olarak etiketlenmiştir. TinyMCE'de (Moodle 4.3+'te varsayılan) More menüsünün altında External tools olarak bulunur.
4. Araç listesinden FastComments'i seçin.
5. FastComments derin bağlantı seçici açar. Konu başlığını onaylayın ve Embed'e tıklayın.
6. Düzenleyici bir LTI yer tutucu bloğu ekler. Kaynağı kaydedin.

Her gömülü örnek, deep-link content item ID ile anahtarlanmış ayrı bir konu dizisidir, bu nedenle üç FastComments gömülü ögesi olan bir Page üç bağımsız konu dizisi alır.

Erişimi Kısıtlama ve Grup Ayarları

FastComments etkinliklerine Moodle'ın standart etkinlik ayarları uygulanır:

• Common module settings > Group mode. Bunu Separate groups veya Visible groups olarak ayarlamak, FastComments'i otomatik olarak grup başına ayrı konu dizilerine bölmez. Moodle'ın grup modu yalnızca not defterini ve üye listesini filtreler. Grup başına ayrı bir konu dizisi çalıştırmak için her grup için bir FastComments etkinliği ekleyin ve her birini kapsamlamak için Restrict access kullanın.
• Restrict access > Add restriction. Standart Moodle koşullarını destekler: Date, Grade, Group, Grouping, User profile ve iç içe kısıtlama setleri. Bir FastComments etkinliğini tek bir grupla kilitlemek için Group'u kullanın.
• Activity completion. Tamamlanma takibi istiyorsanız Students must view this activity to complete it olarak ayarlayın. FastComments şu anda başlatma dışında Moodle'a bir tamamlanma olayı bildirmez.

Rol Eşlemesi

FastComments, Moodle'ın her başlatmada gönderdiği LTI roles bildirgesini okur ve şu şekilde eşler:

• Moodle Manager veya Site administrator -> FastComments admin
• Moodle Editing teacher veya Non-editing teacher -> FastComments moderator
• Moodle Student -> FastComments commenter
• Moodle Guest -> salt okunur

Yöneticiler herhangi bir yorumu silebilir, kullanıcıları yasaklayabilir ve konu ayarlarını düzenleyebilir. Moderatörler, girdikleri konu dizisi içinde yorumları silebilir ve onaylayabilir. Özel Moodle rolleri, klonlandıkları örnek rolün eşlemesini miras alır.

Öğrencilerin Gördükleri

Öğrenciler FastComments etkinliğine tıklar (veya bir Page ya da Book içindeki gömülü bloğa kaydırır). Moodle, başlatma sırasında kimliklerini FastComments'e LTI aracılığıyla gönderir:

• Giriş ekranı yok. FastComments onları Moodle hesabı kullanarak oturum açtırır.
• Görünen adları, e‑posta adresleri ve avatarları Moodle'dan gelir.
• Konu dizisi (Moodle site, course, resource link ID) ile sınırlandırılmıştır, bu nedenle aynı etkinliğin başka bir derse kopyalanması yeni bir konu dizisi oluşturur.
• Konuya bağlı yanıtlar, oylama ve bildirimler ayrı bir FastComments konu dizisindeki gibi çalışır.

Genel Erişimi Kısıtlayın (Önerilir)

Varsayılan olarak FastComments yorum verileri herkese açık okunabilir. Bir konu dizisinin URL'sini veya API uç noktasını tahmin edebilen herhangi biri, Moodle dışında bile yorumları görüntüleyebilir. Ders tartışmaları için neredeyse kesinlikle görüntülemeyi yalnızca kayıtlı öğrencilere sınırlamak istersiniz.

Widget özelleştirme sayfanızı açın ve Require SSO To View Comments etkin olan bir kural oluşturun, ardından güvenlik düzeyini Secure SSO olarak ayarlayın; böylece konu dizileri yalnızca imzalı LTI başlatması aracılığıyla yüklenebilir.

Tam adım adım kılavuz ve kuralın tek bir alan adı veya sayfaya nasıl kısıtlanacağı dahil ayrıntılar için Protecting Comment Threads With Single-Sign-On bölümüne bakın.

Moodle Uyarıları

Etkinlik seçicisinde FastComments yok. Site yöneticisi aracı kaydetmiş ancak Tool configuration usage'ı Show in activity chooser and as a preconfigured tool olarak ayarlamamış olabilir. Bunu düzeltmek için şu yolu izleyin: Site administration > Plugins > Activity modules > External tool > Manage tools > FastComments kutucuğundaki dişli simgesi.

"Aynı pencerede" olarak ayarlandığında başlatma başarısız oluyor veya boş bir çerçeve gösteriyor. Moodle'ın oturum çerezleri varsayılan olarak SameSite=Lax kullanır ve bazı tarayıcılar LTI 1.3'ün FastComments'ten geri dönmek için kullandığı çapraz site POST sırasında bu çerezleri kaldırır. Etkinlikte Başlatma kapsayıcısı'nı Yeni pencerede olarak ayarlayın. Bu, editöre gömülü FastComments için zorunlu bir gereksinimdir, çünkü düzenleyiciye gömülü başlatma yolu her zaman yeni bir pencere açar.

iss bildirgesi Moodle site URL'sidir, tenant ID değil. FastComments, LTI issuer olarak Moodle site URL'sini (wwwroot konfigürasyon değeri) kullanır. Moodle örneğiniz yeni bir domaine taşınırsa veya wwwroot'u değiştirirseniz, mevcut FastComments konu dizileri eski issuer'a bağlı kalır ve yeni başlatmalarla eşleşmez. Aracı yeni URL için yeniden kaydedin ve gerekirse konu dizilerini FastComments yöneticisi aracılığıyla taşıyın.

Etkinlik yedekleme ve geri yükleme. Bir dersi yedekleyip yeni bir derse geri yüklemek yeni resource link ID'leri oluşturur; bu nedenle geri yüklenen FastComments etkinlikleri boş konu dizileriyle başlar. Orijinal ders orijinal konu dizilerini korur. Bu, kasıtlı bir davranıştır, bir hata değildir.

Moodle 4.5 TinyMCE varsayılanı. Moodle 4.5, yeni kurulumlar için varsayılan düzenleyici olarak TinyMCE ile gelir. External tool düğmesinin yeri ana araç çubuğu yerine More (...) menüsünün altındadır. 4.1'den yükseltilen daha eski siteler, bir yönetici varsayılanı değiştirmedikçe Atto'yu korur.

Once an administrator has registered FastComments as an LTI 1.3 Advantage tool and approved the institution policies, instructors add it to courses through the standard Blackboard placement points. The exact steps differ between Ultra Course View and Original Course View, so both are covered below.

Ultra Course View

Ultra Course View is the default in Blackboard Learn SaaS as of 2026.

1. Open the course and go to the Course Content page.
2. Hover or tap where you want the comment thread to land in the outline and click the purple + (Add content) button.
3. Choose Content Market. The Content Market panel lists every approved LTI tool and Building Block placement for your institution.
4. Find the FastComments tile and click it. Blackboard creates a content item at the position where you opened the + menu.
5. The item lands in the outline as a "Visible to students" entry by default for instructors who have Hide from students off as their personal default. If your default is Hidden, the item is created hidden and you flip the visibility selector on the item row when you're ready.
6. To rename the item, click the title in the outline and type a new label. The title students see in the outline is independent of the FastComments thread identifier, so renaming is safe at any time.

If you don't see Content Market as an option, your institution has the placement hidden. You also reach the same picker through More tools in the same + menu under the LTI Tools group.

Original Course View

Original Course View is still supported in Learn SaaS and remains the primary experience for self-hosted Learn 9.1 sites on the Q4 2024 CU release line.

1. Open the course and enter a Content Area (for example, the default Information or Content area in the course menu).
2. Turn Edit Mode on with the toggle in the top-right of the page.
3. Click Build Content in the action bar.
4. Under the Learning Tools submenu, click FastComments. The Learning Tools submenu is populated from LTI 1.3 tool placements after an administrator registers the tool. If you don't see it, see the gotchas section below.
5. On the Create FastComments form, set:
   • Name: the label students see in the content area.
   • Description: optional text shown above the embedded thread.
   • Permit Users to View this Content: Yes/No availability toggle.
   • Track Number of Views: enable if you want Blackboard's per-item view statistics. FastComments runs its own analytics independently.
   • Date and Time Restrictions: optional Display After / Display Until windows.
6. Submit. The tool appears as a clickable item in the content area.

Embedding Inside an Item or Document

In both course views, instructors embed FastComments inline inside the body of an Item, Document, or any rich-text field through the Content Editor's LTI Advantage button.

Ultra Course View:

1. Create or edit a Document.
2. Click Add content inside the document body where you want the thread to appear.
3. In the editor toolbar, open the Insert content menu and click Content Market (the LTI Advantage / Deep Linking entry point).
4. Pick FastComments. FastComments returns a deep-link payload and Blackboard inserts an embedded block in the document body at the cursor position.
5. Save the document. Students see the thread rendered inline as they scroll past it.

Original Course View:

1. Edit any item with a rich-text body.
2. In the Content Editor toolbar, click the Add Content plus icon and choose Content Market (labeled Add Content from External Tool in older Q4 2024 CUs).
3. Pick FastComments. The editor inserts a placeholder block referencing the deep-linked resource.
4. Submit the item.

Each deep-link embed produces its own FastComments thread, so an Item with two embedded FastComments blocks has two independent comment streams.

Visibility, Release Conditions, and Group Restrictions

FastComments content items behave like any other Blackboard content item for the access control rules layered on top of them.

• Ultra: click the visibility selector on the row (Visible to students, Hidden from students, Conditional availability). Conditional availability supports date/time windows, performance rules against gradebook items, and member rules against course groups.
• Original: open the item's context menu and choose Adaptive Release or Adaptive Release: Advanced to gate the tool by date, membership, grade, or review status. Use Set Group Availability on the item to restrict to specific course groups.

FastComments respects whatever Blackboard's gate decides. If Blackboard hides the item from a student, the LTI launch never happens for that student and they don't appear in the moderator view.

Gradebook Behavior

FastComments does not report grades back over LTI Advantage Assignment and Grade Services. No grade column is auto-created for FastComments content items.

If your Blackboard tenant is configured to auto-create a gradebook column for every new content item regardless of grading metadata, an empty column appears anyway. To hide it:

• Ultra: open the Gradebook, click the column header, choose Edit, and turn off Show to students plus Include in calculations. Or use Delete if your institution permits column deletion for ungraded items.
• Original: open the Grade Center, click the column's chevron, choose Hide from Users (on/off), and optionally Hide from Instructor View under Column Organization.

What Students See

When a student opens the FastComments item or scrolls to an embedded block:

1. Blackboard launches the LTI 1.3 message to FastComments. The student is signed in via SSO using their Blackboard identity (name, email, avatar, role) without seeing a login form.
2. The comment thread renders in the iframe. Threading, replies, mentions, and reactions are all available based on the comment widget settings configured in FastComments.
3. Their comments are attributed to their Blackboard account. If the student edits their name or photo in Blackboard later, the next launch updates the FastComments profile.

Role mapping from Blackboard to FastComments:

• System Administrator and Course Builder map to FastComments admin.
• Instructor and Teaching Assistant map to FastComments moderator.
• Student, Guest, and Observer map to FastComments commenter.

Moderators see moderation controls (pin, hide, ban, delete) inline on every comment in the thread.

Lock Down Public Access (Recommended)

By default, FastComments comment data is publicly readable. Anyone who can guess a thread's URL or API endpoint can view its comments, even outside Blackboard. For course discussions you almost certainly want to restrict viewing to enrolled students only.

Open your widget customization page and create a rule with Require SSO To View Comments enabled, then set the security level to Secure SSO so threads can only be loaded through the signed LTI launch.

See Protecting Comment Threads With Single-Sign-On for the full walkthrough, including how to scope the rule to a single domain or page.

Thread Scoping

FastComments scopes each thread by (Blackboard host, course ID, resource link ID). Two FastComments items in the same course produce two threads. The same item copied across two course shells (for example, through course copy) produces two threads, because Blackboard issues a fresh resource link ID during the copy. To keep a shared thread across course copies, use Deep Linking with an explicit thread URN configured in FastComments before launching the copy.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). The administrator approved the tool but left an institution policy blocking the relevant placement. Go to Administrator Panel > Integrations > LTI Tool Providers, edit the FastComments entry, and confirm both Course Content Tool (Original) and Course Content Tool - allow students / Deep Linking content tool (Ultra) placements are enabled. Save and refresh the course page.

"Tool not configured for this context" or "Tool is not deployed" error on launch. The deployment scope registered during dynamic registration doesn't match the institution context the course belongs to. In Blackboard's tool provider entry, verify the Deployment ID matches what FastComments shows on its LTI 1.3 Configuration page for this tenant. If they differ, delete the placement and re-run dynamic registration from a fresh registration URL (get it here).

Iframe height looks fixed or content gets cut off. Some Blackboard tenants ship with a strict Content Security Policy that blocks the default LTI iframe-resize postMessage. FastComments emits both the Canvas-style lti.frameResize message and the IMS spec-form org.imsglobal.lti.frameResize message to maximize compatibility, but a tenant-level CSP override blocks the parent listener. Ask your administrator to confirm that *.fastcomments.com is on the LTI tool allowlist and that no custom CSP header is stripping postMessage events. Resize then works without further configuration.

Course copy duplicates threads. Blackboard course copy issues new resource link IDs for LTI placements, so copied courses start with empty threads. This is expected. If you need the copied course to inherit the original thread, set up Deep Linking with an explicit thread URN before copying, or contact FastComments support to remap thread IDs in bulk.

Student sees a generic Blackboard error on launch. The cause is a missing or stale email claim. Confirm the institution policy for FastComments has Role, Name, and Email Address enabled under User Fields to Send. Save, then launch again in a fresh browser session.

FastComments platforma kaydedildikten sonra eğitmenler, platformun standart dış araç akışlarını kullanarak onu ders içeriğine ekler. Bu sayfa Sakai 23.x ve Schoology Enterprise'ı kapsar.

Genel Erişimi Kısıtlayın (Önerilen)

Varsayılan olarak, FastComments yorum verileri her iki platformda da herkese açık okunabilir durumdadır. Bir kişi bir konunun URL’sini veya API uç noktasını tahmin edebilirse, Sakai veya Schoology dışında olsalar bile yorumları görebilirler. Ders tartışmaları için görüntülemeyi büyük olasılıkla yalnızca derse kayıtlı öğrencilerle sınırlamak istersiniz.

Widget özelleştirme sayfanızı açın ve Yorumları Görmek İçin SSO Gerekli etkin olan bir kural oluşturun, ardından güvenlik düzeyini Güvenli SSO olarak ayarlayın, böylece konular yalnızca imzalı LTI başlatmasıyla yüklenebilir.

Tam adım adım kılavuz için, kuralı tek bir alan adına veya sayfaya nasıl sınırlayacağınızı da içeren Protecting Comment Threads With Single-Sign-On sayfasına bakın.

Sakai

1. FastComments'i bir siteye ekleyin

Site yöneticisi aracı site bazında etkinleştirir:

1. Siteyi açın ve sol gezinti menüsünde Site Info'ya tıklayın.
2. Manage Tools'a tıklayın.
3. External Tools listesini kaydırın ve FastComments'i açık duruma getirin.
4. Continue'a tıklayın, araç listesini gözden geçirin, ardından Finish'e tıklayın.

FastComments artık sitede sol gezinti öğesi olarak görünür.

2. Sol gezinme girişinin sırasını değiştirme

Site Info > Tool Order bölümüne gidin. FastComments'i istediğiniz konuma sürükleyin ve Save'e tıklayın. Bu ekranda gezinme etiketinin adını da değiştirebilir ve öğrencilerden gizleyebilirsiniz.

3. Lessons sayfasına satır içi gömme

FastComments'i bağımsız bir sol gezinme aracı olarak değil, Lessons sayfasının içine doğrudan yerleştirmek için:

1. Sitede Lessons aracını açın.
2. Add Content > Add External Tool'a tıklayın.
3. Listeden FastComments'i seçin.
4. FastComments kayıt sırasında Deep Linking'i duyurduysa, Sakai aracın içerik seçicisini açar ve konuyu seçmenize veya etiketlemenize olanak tanır. Deep Linking duyurulmadıysa, Sakai varsayılan bir başlatma bağlantısı ekler.
5. Lessons öğesini kaydedin.

Her gömülü örnek, o kaynak bağlantısına yönelik kendi konusu ile ayrı bir konu alır.

4. Öğrenci erişimi için izin ayarları

Sakai, dış araç başlatmalarını Realms üzerinden sınırlar. Öğrencilerin FastComments'i başlatabildiğini doğrulamak için:

1. Sakai yöneticisi olarak oturum açın ve Administration Workspace > Realms'i açın.
2. İlgili realm'i açın (örneğin !site.template.course veya belirli site realm'i).
3. access rolünün lti.launch etkinleştirildiğini ve external.tools grubundaki rol izinlerinin verildiğini onaylayın.
4. Realm'i kaydedin.

Site düzeyinde geçersiz kılmalar için, site yöneticisi Site Info > Tool Order üzerinden rol başına araç görünürlüğünü FastComments'i gizleyerek veya göstererek ayarlayabilir.

5. Öğrencilerin gördükleri

Öğrenciler FastComments sol gezinme öğesine tıklar (veya gömülü Lessons bloğuna kaydırırlar) ve doğrudan dizili yorum görünümüne gelirler. SSO otomatiktir: Sakai, kullanıcının kimliğini LTI başlatmasında gönderir ve FastComments onları Sakai hesaplarıyla oturum açmış şekilde tanımlar.

Rol eşlemesi:

• Sakai Instructor -> FastComments moderator
• Sakai Admin (Administration Workspace yöneticisi) -> FastComments admin
• Sakai Student / access -> FastComments commenter

6. Sakai ile ilgili sorunlar

• Manage Tools içinde araç görünmüyor. FastComments External Tools listesinde görünmüyorsa, Sakai yöneticisi araç kaydını açmalı (Administration Workspace > External Tools > FastComments) ve Stealthed'i false olarak ayarlamalıdır. Stealthed yapılan araçlar site bazlı Manage Tools seçicisinden gizlenir.
• Paylaşılan oturumlu tarayıcılarda başlatmaların bozulması. Sakai portal CSRF belirteci tarayıcı oturumuna bağlıdır. Bir öğrenci farklı sekmelerde iki Sakai sitesine aynı anda oturum açmışsa veya oturum süresi dolmuşsa, başlatma 403 döndürebilir. Çözüm: diğer Sakai sekmelerini kapatın, çıkış yapın, tekrar giriş yapın ve yeniden başlatın. Yöneticiler, bu durum küme genelinde oluyorsa sakai.csrf.token.cache.ttl değerini artırabilir.
• Çerçeve (frame) gömme. Yorum konusunun Lessons sayfası içinde kırpılmaması için sakai.properties içindeki lti.frameheight değerinin yeterince büyük (600 veya daha yüksek) olduğundan emin olun.

Schoology

Schoology Enterprise için iki kurulum senaryosu vardır. Araca eklemeden önce hangisinin geçerli olduğunu doğrulayın.

1. İki kurulum senaryosu

• (a) Kurum düzeyinde kurulum. Schoology Sistem Yöneticisi FastComments'i kuruluş düzeyinde kurdu ve tüm kurslara veya belirli kurs şablonlarına atadı. Eğitmenler kurulumu atlayıp doğrudan "Add Materials" bölümüne geçer.
• (b) Eğitmenin kendi kendine yüklemesi. Eğitmen, aracı tek bir kursa Course Options > External Tools > Install LTI Apps üzerinden kurar. Kendi kendine yükleme, önce Sistem Yöneticisinin FastComments uygulamasını kuruluş düzeyinde onaylamış olmasını gerektirir.

2. FastComments'i kurs materyali olarak ekleme

Kurs içinde:

1. Kursu açın ve Materials'a gidin.
2. Add Materials > Add File/Link/External Tool'a tıklayın.
3. External Tool'u seçin.
4. Kayıtlı araçlar listesinden FastComments'i seçin.
5. Bir Name belirleyin (öğrencilerin materyal listesinde gördüğü ad) ve isteğe bağlı bir Description ekleyin.
6. Enable Grading'i (not geri bildirimi) KAPALI bırakın. FastComments notları Schoology'ye raporlamaz, bu yüzden not geri bildirimi etkinleştirmek boş bir not defteri sütunu oluşturur.
7. Submit'e tıklayın.

Materyal şimdi kurs materyalleri listesinde görünür ve tıklanınca FastComments konusunu açar.

3. Zengin Metin düzenleyici ile satır içi gömme

Sistem Yöneticisi kayıt sırasında FastComments için Deep Linking yerleşimini etkinleştirdiyse, eğitmenler yorum konusunu herhangi bir Zengin Metin alanına (ödev talimatları, sayfa gövdeleri, tartışma yönlendirmeleri) gömebilir:

1. Hedef sayfadaki Zengin Metin düzenleyicisini açın.
2. Araç çubuğunda External Tool (yapboz parçası) simgesine tıklayın.
3. FastComments'i seçin.
4. Deep-linking iletişim kutusunda gömmeyi yapılandırın ve Insert'e tıklayın.
5. Sayfayı kaydedin.

Eğer External Tool düğmesi Zengin Metin düzenleyicisinde görünmüyorsa, bu tenant için Deep Linking devre dışı bırakılmış demektir. Aşağıdaki sorun giderme bölümüne bakın.

4. Görünürlük ve bölüm atamaları

Schoology, araç kullanılabilirliğini Kurs Seçenekleri üzerinden bölüm bazında sınırlar:

1. Kurstan Course Options > External Tools'a tıklayın.
2. Kurulu her LTI uygulaması için, uygulamanın kurstaki tüm bölümlere mi yoksa belirli bölümlere mi açık olacağını kontrol edersiniz.
3. FastComments'i belirli bölümlere sınırlamak için, aracı görmemesi gereken bölümlerin seçimlerini kaldırın.
4. Bölüm düzeyindeki erişim ayrıca hangi bölümlerin Add Materials > External Tool girişini görmesini de sınırlar.

5. Öğrencilerin gördükleri

Öğrenciler FastComments materyaline tıklar (veya satır içi gömülmüş alana kaydırır) ve dizili tartışmaya gelirler. SSO, Schoology LTI başlatması ile onların Schoology hesapları üzerinden otomatik olarak gerçekleştirilir.

Rol eşlemesi:

• Schoology Administrator -> FastComments admin
• Schoology Instructor -> FastComments moderator
• Schoology Student -> FastComments commenter

6. Schoology ile ilgili sorunlar

• Sadece Enterprise. Kişisel ve ücretsiz Schoology hesapları LTI 1.3 araçlarını yükleyemez. Tenantınız ücretsiz plandaysa, External Tools seçeneği Course Options içinde bulunmaz. FastComments kullanmak için Schoology Enterprise'a geçin.
• Tenant varsayılanı olarak Deep Linking devre dışı. Bazı Schoology tenant’ları kuruluş düzeyinde Deep Linking yerleştirmesini kısıtlar. Bu durumda eğitmenler sadece Add Materials > External Tool akışını görür ve Zengin Metin düzenleyicisinde External Tool düğmesini görmezler. Satır içi gömme etkinleştirmek için Sistem Yöneticisi System Settings > Integration > LTI 1.3 > FastComments bölümüne gidip Content Item / Deep Linking yerleşimini etkinleştirip kaydeder.
• Bölüm bazlı atama geçersiz kılma. FastComments kurum düzeyinde atanmışsa ancak eğitmen Add Materials içinde göremiyorsa, kursun bölümü kuruluş düzeyindeki atamada hariç tutulmuştur. Sistem Yöneticisinden FastComments uygulaması atamasına bölümü eklemesini isteyin.
• Materyal adı ile konu kimliği arasındaki fark. Schoology'de materyalin adını değiştirmek yorum konusunu taşımaz. Konular LTI kaynak bağlantı kimliğine göre anahtarlanır, bu nedenle yeniden adlandırma aynı konuyu korur; materyali silip yeniden oluşturmak yeni, boş bir konu oluşturur.

"Kayıt belirteci bulunamadı, süresi doldu veya zaten kullanıldı"

Kayıt URL'nizdeki belirteç (buradan alabilirsiniz) 30 dakika için geçerlidir ve yalnızca bir kez kullanılabilir. LMS'iniz bunun üzerinde sürdüyse veya kayıt başarıyla gerçekleştirildikten sonra yeniden denendiyse, belirteç reddedilir. FastComments LTI 1.3 Yapılandırma sayfasından yeni bir URL oluşturun ve yeniden başlayın.

"Platform kaydı reddetti"

LMS'iniz kayıt el sıkışmasını reddetti. En yaygın nedenler:

• Aynı istemci adıyla araç zaten kayıtlı. Bazı platformlar (özellikle D2L), önceki silinene kadar "FastComments" için yapılan ikinci kaydı reddeder. LMS'inizdeki eski aracı kaldırın, ardından yeniden deneyin.
• LMS'de yanlış alan. URL'yi launch URL veya login URL alanına değil, registration / tool initiation registration endpoint alanına yapıştırdığınızdan emin olun.
• LMS gerçekte Dynamic Registration'ı desteklemiyor. Eski Moodle ve Blackboard sürümleri LTI 1.3'ü ilan eder ancak yalnızca manuel yapılandırmaya izin verir. Platformunuzun belgelerini kontrol edin.

"Platform yapılandırması alınamadı"

FastComments, LMS'inizin openid-configuration belgesini okuyamadı. Bu nadirdir ve genellikle LMS'in hatalı biçimlendirilmiş veya ulaşılamayan bir discovery URL'si sağladığı anlamına gelir. LMS destek ekibinizle iletişime geçin.

Launch shows "Configuration not found"

Ya FastComments içindeki yapılandırma silindi, ya da başlatma bizim tanımadığımız bir iss/client_id çiftinden geldi. Eğer sildiyseniz ve yeniden kaydettiyseniz, LMS'inize eski FastComments aracını kaldırıp yeniden eklemesini söyleyin, böylece yeni client_id alınır.

Launch shows "Deployment not registered"

FastComments'i ilk başlatıldığı dağıtımdan farklı bir Brightspace/Moodle/Blackboard dağıtımından başlattınız. FastComments ilk başlatmada bir güvenlik kontrolü olarak deployment_id'yi sabitler. Aynı client altında yeni bir dağıtım eklemek için destek ile iletişime geçin - yapılandırmaya deployment ID'sini ekleyeceğiz.

Launch shows "Unsupported message_type"

LMS, FastComments'in işleyemediği bir LTI mesajı gönderdi (ör. LtiSubmissionReviewRequest). FastComments yalnızca standart resource-link başlatmasını ve deep-linking akışlarını destekler. Belirli bir mesaj türünün eklenmesini istiyorsanız bize ulaşın.

Iframe doesn't resize

Çoğu LMS, LTI iframe'lerini otomatik boyutlandırır. Eğer sizinki yapmıyorsa, LMS'in başlatma ayarlarının aracın üst çerçeveye postMessage olayları göndermesine izin verdiğini kontrol edin. FastComments hem Canvas tarzı (lti.frameResize) hem de IMS belirtimi (org.imsglobal.lti.frameResize) yeniden boyutlandırma mesajları gönderir.

The FastComments LTI 1.3 entegrasyonu en az ayrıcalık ilkesine göre çalışır: yalnızca kullanıcıyı tanımlamak, yorumları doğru ders ve kaynağa iliştirmek ve rol tabanlı izinleri uygulamak için gereken başlatma taleplerini (launch claims) kullanır.

Bu sayfanın geri kalanı entegrasyonun tükettiği her talebi, talep etmediği her LTI Advantage servisini ve toplamadığı her veri kategorisini listeler. Güvenlik ve tedarik inceleyicileri cevapları doğrudan aşağıdaki tablolardan alabilir.

LMS'den Alınan Veri Öğeleri

Every LTI 1.3 launch carries a signed JWT from the LMS. FastComments extracts the following claims from that JWT and uses nothing else:

Kayıt Sırasında Bildirilen Talepler ve Kapsamlar

During LTI 1.3 Dynamic Registration, FastComments registers itself with scope: "" (no additional OAuth scopes) and declares only these OpenID Connect claims:

iss, sub, name, email, picture

It registers two message types:

• LtiResourceLinkRequest - FastComments'e yapılan standart ders başlatması.
• LtiDeepLinkingRequest - Eğitmenlerin FastComments aracını bir kurs içine yerleştirmesine olanak tanır.

No additional access tokens are requested from the LMS.

LTI Advantage Services Not Requested

Toplanmayan Veriler

Beyond LTI itself, FastComments does not request or receive the following from the LMS or user:

Erişim Sınırları

• FastComments yalnızca LMS'nin kayıtlı anahtarlarıyla imzalanmış yetkili bir LTI 1.3 başlatması içinde veri alır. Entegrasyon ek bilgi için LMS'ye geri çağrı yapmaz.
• Başlatma belirteçleri tek kullanımlık ve kısa ömürlüdür. Tekrar oynatılan veya süresi dolmuş belirteçler reddedilir.
• LMS yöneticileri aracın platform içinde nerelere yerleştirileceğini kontrol eder. Örneğin D2L Brightspace, dağıtım başına org-birim kapsamı ve dağıtıma özel güvenlik ayarlarını destekler; bu, yöneticilerin aracı genel olarak erişilebilir kılmak yerine belirli derslere veya org birimlerine kısıtlamasına olanak tanır. Moodle, Blackboard, Sakai ve Schoology, LTI 1.3 uygulamalarında eşdeğer dağıtım-başı kontroller sunar.

Depolama ve Saklama

FastComments, LTI'den türetilen verileri aktif yorumlama hizmetinin süresi boyunca ve müşteri tarafından yapılandırılmış saklama ayarlarına uygun şekilde tutar. Yorum verileri, dinlenme halindeyken şifrelenmiş üretim depolamada saklanır. Hesap sonlandırıldığında veya yazılı silme talebi alındığında, FastComments ilgili sözleşmeye uygun olarak müşteri verilerini siler veya anonimleştirir.

For full storage and data-handling details, see the FastComments Gizlilik Politikası.

İnceleme Sıklığı

Any new LTI feature that would require additional claims, scopes, or LTI Advantage services is reviewed before release to confirm the requested access is necessary and proportionate to the feature being shipped.

Güvenlik Anketleri için Kısa Açıklama

FastComments, LTI 1.3 entegrasyonunda en az ayrıcalık ve veri minimizasyonu ilkesini uygular. Entegrasyon yalnızca kullanıcıyı kimlik doğrulamak (sub, name, email, picture), rolünü belirlemek ve yorumların ait olduğu ders ve kaynağı tanımlamak için gereken LTI başlatma taleplerini kullanır. FastComments İsim ve Rol Sağlama Servislerini, Ödev ve Not Servislerini, not defteri verilerini, devam kayıtlarını, tam ders listelerini veya LMS yönetici erişimini talep etmez. LMS yöneticileri, aracın hangi org birimlerinde, derslerde ve dağıtımlarda kullanılabilir olduğunu kontrol etmeye devam eder.