Lompat ke konten

Puzzel.org di Canvas

Tambahkan satu aktivitas Puzzel ke kursus Canvas, dan skor tiap siswa akan otomatis masuk ke buku nilai kursus itu. Adminmu menghubungkan Puzzel.org ke Canvas satu kali; setelah itu, setiap guru di sekolah bisa langsung menggunakannya.

Canvas

LTI 1.3 · Assignment and Grade Services
Siap dihubungkan

Canvas mendaftarkan Puzzel.org sendiri: adminmu menempelkan satu URL dan menjawab wizard singkat. Setelah itu, guru bisa menambahkan aktivitas langsung dari kursus mereka sendiri, dan siswa bermain tanpa perlu akun Puzzel.org.

Untuk admin IT

Hubungkan Canvas satu kali

Canvas menyebutnya Dynamic Registration: kamu memberikan satu URL, dan Canvas mengambil semua yang dibutuhkannya dari Puzzel.org. Tidak ada kunci atau rahasia yang perlu dipertukarkan, tidak ada yang perlu diunduh.

  1. Buka Apps di akun Canvas-mu Di Global Navigation, pilih Admin, lalu nama akunmu, kemudian Apps. Pada tab Manage, tekan Install a New App. Admin → akunmu → Apps → Manage → Install a New App
  2. Pilih LTI 1.3 dan Dynamic Registration Pilih LTI version 1.3, atur Install Method ke Dynamic Registration, tempelkan URL di atas, lalu tekan Next. LTI version 1.3 → Install Method: Dynamic Registration
  3. Biarkan izin tetap aktif Izin ini yang memungkinkan Puzzel.org membuat kolom buku nilai untuk aktivitas yang ditambahkan guru, lalu menuliskan skor ke dalamnya. Jika dimatikan, aplikasi tetap terinstal, tapi skor tidak akan pernah sampai ke Canvas. Set Permissions
  4. Bagikan nama siswa “User's name only” sudah cukup. Skor tetap masuk dengan benar meski memilih “None (Anonymized)”, tapi guru akan melihat pemain anonim di hasil Puzzel.org mereka, bukan nama. Puzzel.org tidak pernah meminta daftar kelas ke Canvas. User Data Shared With This App
  5. Pilih di mana guru akan menemukannya Aktifkan placement tempat guru akan menemukan Puzzel.org: yang untuk memilih konten dalam tugas, dan tombol editor teks jika kamu ingin itu juga ada di sana. Setiap placement punya ikon informasi yang menunjukkan persis di mana ia muncul di Canvas. Set Placements
  6. Tinjau, instal, lalu atur siapa yang boleh menggunakannya Beri nama panggilan jika kamu mau, lalu tekan Install App. Puzzel.org akan muncul di tab Manage, dan di situ juga kamu bisa memilih apakah aplikasi ini tersedia untuk seluruh akun atau hanya di kursus tertentu. Review and install → Manage
URL Dynamic Registration
https://puzzel.org/lti/register

Ini satu-satunya hal yang perlu kamu tempel. Ini bukan halaman yang dibuka di browser: ini yang memberikan konfigurasi ke Canvas.

Yang kamu butuhkan

Kamu memerlukan admin akun Canvas dengan izin “LTI Registrations - Manage”, dan satu akun Puzzel.org untuk masuk di tengah proses — buat akun itu di puzzel.org sebelum kamu mulai, bukan di tengah wizard. Akun Canvas Free-for-Teacher tidak bisa membuat developer key yang dibutuhkan untuk ini, sehingga LTI 1.3 tidak tersedia bagi mereka — rute yang lebih sederhana di bagian bawah halaman ini adalah jawabannya.

Di tengah proses, Puzzel.org menanyakan siapa kamu

Setelah kamu menempelkan URL, Canvas membuka sebuah jendela Puzzel.org di dalam wizard — ini layar kami, bukan salah satu layar Canvas. Jendela ini menyebutkan nama Canvas yang akan dihubungkan: masuk, tekan Hubungkan, dan Canvas melanjutkan dari situ. Status masuk ke Puzzel.org di tab lain tidak terbawa ke jendela ini, jadi email dan kata sandi adalah cara masuk yang paling bisa diandalkan.

Akun Puzzel.org yang mana?

Akun mana saja — milik sekolah sendiri, atau guru yang memintamu melakukan ini. Akun ini hanya dicatat supaya kami tahu siapa yang mengatur koneksinya. Akun ini tidak pernah menjadi akun bersama dan tidak memiliki apa pun: setiap guru masuk dengan akunnya sendiri, nanti, di kursusnya masing-masing.

Tambahkan aktivitas
Canvas menampilkan “Invalid XML Configuration”?

Itu artinya URL tersebut dimasukkan ke layar LTI 1.1 yang lebih lama — External Apps, + App, By URL — yang hanya menerima file XML, tidak ada yang lain. URL registrasi ini bukan XML, jadi Canvas menolaknya. Tidak ada yang rusak di kedua sisi; ini cuma soal salah layar.

Gunakan Apps → Manage → Install a New App seperti di atas. Jika yang kamu maksud memang rute yang lebih sederhana tanpa buku nilai, ambil config URL dari bagian bawah halaman ini.

Panduan resmi dari Canvas

Instructure mendokumentasikan wizard ini layar demi layar, lengkap dengan gambar tiap langkahnya. Langkah yang sama, dari sisi mereka.

Baca panduan Canvas
Jika Canvas-mu meminta tiap URL secara terpisah

Instalasi yang lebih lama mendaftarkan tool secara manual. Berikut tiga URL yang akan diminta. Baik redirect URI maupun target link URI adalah launch URL yang sama, dan kunci publik diambil dari JWKS URL — tidak ada rahasia yang perlu ditempel di mana pun.

URL masuk https://puzzel.org/lti/login
URL peluncuran https://puzzel.org/lti/launch
Kunci publik (JWKS) https://puzzel.org/api/lti/jwks
Untuk guru

Tambahkan aktivitas ke kursusmu

Begitu adminmu menghubungkan Canvas, Puzzel.org akan tersedia di setiap kursus. Kamu masuk satu kali dengan akun Puzzel.org milikmu sendiri, memilih aktivitas dan poinnya, lalu Canvas sendiri yang membuat kolom buku nilainya.

  1. Jadikan sebagai tugas Di kursusmu, buka Assignments lalu tambahkan satu. Atur Submission Type ke External Tool, lalu tekan Find. Assignments → + Assignment → Submission Type: External Tool → Find
  2. Pilih Puzzel.org dari daftar Canvas membuka sebuah jendela Puzzel.org di dalam tugas tersebut. Ini adalah jendela milik Puzzel sendiri, bukan layar Canvas, itulah sebabnya jendela ini menanyakan siapa kamu. Find → Puzzel.org
  3. Masuk dengan akunmu sendiri Hanya di kali pertama, dan di sinilah dua proses masuk itu berbeda: akun di sini adalah akunmu sendiri, bukan akun yang dipakai adminmu untuk menghubungkan Canvas. Setiap guru masuk sebagai dirinya sendiri dan melihat aktivitasnya masing-masing. Belum punya akun? Jendela ini punya tautan untuk membuat akun — buat akun di tab yang terbuka, lalu kembali dan masuk.
  4. Pilih aktivitas dan poinnya Pilih salah satu aktivitasmu, lalu konfirmasi. Apa pun yang kamu masukkan di Points menjadi nilai aktivitas itu, dan kolom buku nilai dibuat saat kamu menyimpan tugas.
  5. Siswa membukanya di Canvas Mereka menekan tugas itu dan langsung bermain: tidak perlu membuat akun Puzzel.org, tidak perlu mengetik nama, tidak perlu kode. Skor langsung masuk ke buku nilai begitu mereka selesai, dan jika mereka bermain lagi, percobaan terbaik merekalah yang dihitung.
Yang perlu diketahui

Percobaanmu sendiri tidak pernah dinilai: buka aktivitas itu sebagai guru dan mainkan dengan cara yang sama, tapi tidak ada yang ditulis ke buku nilai. Aktivitas apa pun dengan skor per siswa akan berfungsi; mode tim dan mode ruangan tidak. Pengiriman skor adalah bagian dari paket berbayar pada akun pemilik aktivitas — tanpa itu, aktivitas tetap berfungsi di Canvas, hanya saja tidak dinilai.

Tidak punya akses admin?

Rute yang lebih sederhana, satu kursus dalam satu waktu

Canvas memungkinkan guru menambahkan external app ke satu kursus tanpa perlu meminta IT. Puzzel.org kemudian akan muncul di editor teks kursus itu: tekan ikonnya, pilih salah satu aktivitasmu, dan aktivitas itu akan ditempatkan di halaman untuk siswamu. Ini cara LTI 1.1 yang lebih lama, dan tidak punya buku nilai.

Config URL
https://puzzel.org/lti.xml
Di kursus: Settings → Apps → View App Configurations → + App → Configuration Type: By URL

Beri nama Puzzel.org, biarkan Consumer Key dan Shared Secret kosong, lalu tempelkan config URL. Ini satu-satunya layar tempat config URL berbentuk XML memang jawaban yang benar.

Semua yang kamu tambahkan lewat cara ini akan tetap berfungsi setelah adminmu menghubungkan sekolah, dan apa pun yang kamu tambahkan sejak saat itu juga akan mengirim skornya.

Yang kamu dapatkan
  • Aktivitas dimainkan langsung di halaman kursus
  • Hasil tetap tersimpan di Puzzel.org, di akunmu sendiri
Yang tidak kamu dapatkan
  • Tidak ada kolom buku nilai, tidak ada skor di Canvas
  • Canvas tidak memberi tahu Puzzel.org siapa siswanya
Privasi siswa

Data siswa apa yang diterima dan disimpan Puzzel.org untuk nilai?

Baca kebijakan privasi
  • Yang masuk cuma yang diperlukan

    ID siswa di Google Classroom atau sistem sekolahmu — dengan nama dan alamat email hanya jika sistem itu membagikannya. Tidak pernah daftar kelas, siswa lain, atau tugas kelas lain.

  • Yang keluar cuma skor

    Dihitung di server kami dari jawaban yang diberikan, dan dikirim ke entri buku nilai siswa itu saja. Tidak ada yang lain.

  • Dihapus saat kamu berhenti

    Catatan siswa terhapus saat guru menghentikan sinkronisasi aktivitas atau menghapusnya. Skor yang sudah terkirim tetap ada di buku nilai sekolah.

  • Sekolah tetap yang memegang kendali

    Sekolahmu yang menentukan apa yang terjadi dengan data siswanya; Puzzel.org hanya memprosesnya atas nama sekolah.

Terjebak di suatu langkah?

Beri tahu kami di langkah mana dan apa yang ditampilkan Canvas, dan kami akan bantu selesaikan bersamamu — tangkapan layar sangat membantu.

Sistem lain