---
title: "Panduan pentadbir"
description: "Sediakan sebuah organisasi Quire: orang, peranan, log masuk, jenama, bahasa, e-mel dan rekod."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/ms/llms.txt
> Use this file to discover all available pages before exploring further.

# Panduan pentadbir

<span id="administrator-guide"></span>

Sebelum anda bermula, log masuk ke organisasi anda dan semak bahawa peranan anda
boleh menguruskan tetapan yang anda perlukan. Halaman dan tindakan yang tersedia
kepada anda bergantung pada keizinan yang ditetapkan kepada anda.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-overview.webp" alt="Site administration overview: the settings grouped into cards for users, courses and appearance, each link with a one line description." width="944" height="700" loading="lazy" decoding="async"><figcaption>Site administration at /admin groups every setting and links to it.</figcaption></figure>

Anda menjalankan sebuah organisasi dalam Quire: orangnya, cara mereka log masuk,
apa yang mereka lihat dan apa yang disimpan. Setiap halaman di sini berada di
bawah `/admin`, dan setiap perubahan yang anda buat di sana ditulis ke dalam log
audit berserta nama anda dan masanya.

## Langkah pertama <!--quire:first-steps-->

1. Log masuk dengan akaun pentadbir yang dicipta semasa organisasi ditetapkan,
   dan tukar kata lalunya di `/account/security`. Hidupkan pengesahan dua langkah
   di sana juga.
2. Tetapkan logo organisasi, warnan aksen, fon pengepala dan favicon di
   `/admin/appearance/branding`, serta namanya, alamat, bahasa lalai dan suis di
   `/admin/settings` (lihat [tetapan organisasi](/ms/admin/organisation/)).
   Quire menyemak warna aksen terhadap latar halaman dan melaraskannya jika teks
   di atasnya akan sukar dibaca. Anda boleh memuat naik fon pengepala WOFF2 anda
   sendiri sehingga 200 KB, dipotong kepada huruf Latin; ia terpakai pada pengepala
   sahaja.
3. Tentukan cara orang log masuk di `/admin/security/auth` (di bawah).
4. Tambah orang di `/admin/users`: satu demi satu, atau daripada satu himpunan data
   di `/admin/users/upload`.
5. Cipta kategori kursus pertama di `/admin/categories`, kemudian sebuah kursus.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-branding.webp" alt="The Branding page with an accent colour field, a live preview and a table of contrast checks." width="944" height="760" loading="lazy" decoding="async"><figcaption>Branding previews your colours and checks their contrast before you save.</figcaption></figure>

## Orang dan peranan <!--quire:people-and-roles-->

- **Pengguna** (`/admin/users`): carian, tapis mengikut status, gantung dan
  pulihkan. Menggantung menghentikan setiap sesi serentak; kerja dan gred orang
  itu dikekalkan.
- **Peranan** (`/admin/roles`): satu peranan ialah satu set keupayaan. Mulakan
  daripada peranan terbina dalam (pentadbir organisasi, pengurus, pencipta kursus,
  guru, guru pembantu, pelajar dan tetamu) dan salin salah satunya untuk
  mengubahnya, supaya yang asal kekal sebagai rujukan. Setiap orang yang log masuk
  juga memegang peranan terbina dalam untuk mana-mana orang yang log masuk, yang
  membawa apa yang semua orang boleh lakukan, seperti mencari dan mengurus pelan
  pembelajaran mereka sendiri. Setiap keupayaan boleh menjadi tidak ditetapkan,
  dibenarkan, dicegah atau dilarang; satu larangan tidak boleh ditimpa oleh
  mana-mana peranan lain. Peranan mana yang dikira sebagai pelajar dalam buku gred
  ialah satu tetapan berasingan, iaitu **peranan bergred** dalam
  [tetapan organisasi](/ms/admin/organisation/#graded-roles).
- **Kohort** (`/admin/cohorts`): kumpulan yang merentas kursus, seperti satu
  jabatan atau satu kemasukan. Sebuah kohort boleh dikekalkan terkini oleh satu
  peraturan pada medan profil, dan kursus boleh mendaftarkan sebuah kohort supaya
  ahlinya datang dan pergi secara automatik.
- **Struktur organisasi** (`/admin/org`): jabatan dan jawatan, digunakan untuk
  pengurus, laporan dan kelulusan.
- **Medan profil** (`/admin/profile-fields`): medan tambahan pada setiap pengguna,
  seperti nombor pekerja. Sebuah medan ialah teks pendek atau panjang, teks
  berformat, satu menu pilihan, ya atau tidak, satu tarikh, satu nombor, satu alamat
  web atau satu profil sosial. Ia muncul pada borang pengguna baharu dan pada
  kohort, serta dalam muat naik CSV, di mana satu sel untuk medan menu
  dipadankan dengan pilihan yang diisytiharkan apa sahaja huruf besar kecilnya.
  Teks berformat dibersihkan sebelum ia disimpan.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-users.webp" alt="The Users page with filters and a table of people, their email, status and last access." width="944" height="700" loading="lazy" decoding="async"><figcaption>Users: search, filter, suspend and reinstate.</figcaption></figure>

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-roles.webp" alt="The Roles and permissions page listing each built-in role and how many people hold it." width="944" height="700" loading="lazy" decoding="async"><figcaption>Roles: the built-in roles and how many people hold each.</figcaption></figure>

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-cohorts.webp" alt="The Cohorts page listing two cohorts with their members, and a form to add a new one." width="944" height="700" loading="lazy" decoding="async"><figcaption>Cohorts group people across courses, by hand or by rule.</figcaption></figure>

## Log masuk dan keselamatan <!--quire:sign-in-and-security-->

`/admin/security/auth` mengawal:

- **Kaedah log masuk**: e-mel dan kata laluan, satu pautan log masuk e-mel, passkey,
  akaun sosial, log masuk tunggal (OpenID Connect dan SAML) dan satu direktori
  LDAP. Lihat [panduan log masuk tunggal](/ms/integrations/sso/) untuk menyambungkan
  pembekal identiti anda, dan untuk penyediaan SCIM.
- **Peraturan kata laluan** dan **pengesahan dua langkah**: satu aplikasi pengesah,
  satu kod melalui e-mel, dan kod sandaran. Pengesahan dua langkah boleh dimatikan,
  pilihan, diwajibkan untuk semua orang, atau diwajibkan untuk peranan yang anda
  pilih.
- **Sesi**: berapa lama satu sesi bertahan dan berapa lama ia boleh dibiarkan
  tanpa aktiviti.
- **Tetamu dan pendaftaran kendiri**: sama ada orang boleh mencipta akaun mereka
  sendiri, dan daripada domain e-mel mana.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-sign-in.webp" alt="The Sign-in and security page with checkboxes for each sign-in method, password rules and two-step verification." width="944" height="760" loading="lazy" decoding="async"><figcaption>Sign-in methods, password rules and two-step verification.</figcaption></figure>

## Bahasa dan pemilihan kata <!--quire:languages-and-wording-->

- **Pek bahasa** (`/admin/languages`): bahasa mana yang boleh dipilih orang, dan
  bahasa lalai organisasi. Setiap pek menunjukkan berapa banyak daripada Quire
  yang diliputinya. Dua puluh bahasa (Arab, Ibrani, Parsi, Urdu, Sepanyol,
  Perancis, Jerman, Portugis Brazil, Cina Ringkas, Jepun, Korea, Hindi, Rusia,
  Itali, Turki, Belanda, Poland, Indonesia, Finland dan Sweden) meliputi setiap
  mesej dalam Quire. Pek yang lain meliputi rangka aplikasi dan memaparkan Bahasa
  Inggeris di mana-mana sahaja mereka tiada terjemahan. Pek yang dilabel
  **diterjemah mesin** dihasilkan secara automatik dan tidak disemak oleh seorang
  penerjemah; orang melihat label itu bersebelahan bahasa semasa mereka memilihnya.
  Arab, Ibrani, Parsi dan Urdu dipaparkan kanan-ke-kiri di mana-mana.
- **Pemilihan kata** (`/admin/strings`): ubah sebarang bahagian teks Quire untuk
  organisasi anda, dalam mana-mana bahasa. Cari mengikut teks yang anda lihat atau
  mengikut pengenalnya, tulis versi anda, dan simpan. Versi anda menggantikan teks
  Quire di mana-mana sahaja ia muncul, dalam masa setengah minit. **Kembalikan**
  kembali kepada teks Quire sendiri. **Eksport** memuat turun setiap aturan luar
  sebagai satu fail, dan **Import** memuatkan satu, jadi anda boleh memindahkan
  pemilihan kata antara organisasi atau menyimpannya untuk disemak. Pemegang tempat
  dalam kurungan, seperti `{count}`, mesti dikekalkan; Quire menolak satu aturan
  luar yang membuang atau mencipta satu, dan menyemak bentuk jamak bagi bahasa
  tersebut.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-languages.webp" alt="The Language packs page, a table of languages with their direction, translation state and override counts." width="944" height="700" loading="lazy" decoding="async"><figcaption>Language packs show how much of Quire each language covers.</figcaption></figure>

## E-mel <!--quire:email-->

`/admin/email` menetapkan perkhidmatan penghantaran, nama penghantar dan alamat
balas, domain penghantaran anda sendiri dengan rekod DNSnya, penjejakan, dan sama
ada orang boleh membalas catatan forum dan mesej melalui e-mel. Templat, kempen,
penindasan dan log penghantaran berada di bawahnya.

- **Templat** (`/admin/email/templates`): mesej yang dihantar Quire bagi setiap
  peristiwa, dalam mana-mana bahasa. Ubah satu untuk seluruh organisasi, satu
  kategori, satu kursus atau satu aktiviti. Apa sahaja yang anda biarkan kekal
  menggunakan lalai Quire dan terus menerima pembetulannya. Setiap templat boleh
  dipratinjau dengan data contoh sebelum disimpan, dan menyenaraikan pemboleh ubah
  yang boleh digunakannya.
- **Setiap mesej sistem ialah satu templat**, termasuk yang membawa satu kelayakan:
  pautan log masuk, kod pengesahan, jemputan, set semula kata laluan, alu-aluan,
  pendaftaran diterima, diluluskan dan sudah didaftarkan, persetujuan penjaga dan
  pengesahan permintaan privasi. Semuanya disunting dalam penyunting yang sama.
  Mesej-mesej ini adalah penting, jadi ia dihantar serta-merta dan bukannya
  dijadualkan, dan jika satu tidak dapat dihantar, orang itu diberitahu serta-merta.
- **Log penghantaran** (`/admin/email/log`): setiap e-mel yang dihantar oleh
  organisasi, yang terbaharu dahulu, dengan apa yang berlaku kepadanya (dijadualkan,
  dihantar, disampaikan, melantun dan sebagainya). Log itu tidak pernah menyimpan
  satu pautan atau kod yang dibawa oleh sesebuah mesej.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-email.webp" alt="The Email delivery page with tabs for delivery, sending domains, templates, campaigns, delivery log and suppressions." width="944" height="700" loading="lazy" decoding="async"><figcaption>Email delivery: the sending service, and tabs for the rest.</figcaption></figure>

## Integrasi <!--quire:integrations-->

- **Sambungan** (`/admin/extensions`): hidupkan atau matikan jenis aktiviti
  terbina dalam, kaedah log masuk, laporan dan bahagian lain untuk organisasi anda.
  Lihat [sambungan](/ms/admin/extensions/).
- **Sesi langsung dan video** (`/admin/integrations/meetings`,
  `/admin/integrations/video`): gunakan akaun BigBlueButton, Zoom, Teams, Google
  Meet atau Jitsi anda sendiri, dan akaun Cloudflare Stream, Mux atau Bunny Stream
  anda sendiri. Lihat [pembekal sesi langsung dan video](/ms/admin/providers/).
- **HubSpot** (`/admin/integrations/hubspot`): lihat [panduan HubSpot](/ms/integrations/hubspot/).
- **Kunci API** (`/admin/integrations/api-keys`): kunci untuk skrip dan integrasi.
  Sebuah kunci dipaparkan sekali, apabila ia dicipta; Quire hanya menyimpan satu
  hash. Berikan setiap integrasi kuncinya sendiri dengan hanya skop yang ia
  perlukan, supaya anda boleh membatalkan satu tanpa merosakkan yang lain.
- **Pelanggan OAuth** (`/admin/integrations/oauth-clients`): untuk aplikasi yang
  bertindak bagi pihak seseorang yang log masuk, seperti Zapier atau Make.
- **MCP** (`/admin/integrations/mcp`): pembantu AI mana yang boleh bersambung ke
  pelayan MCP Quire, dan alat mana yang boleh mereka gunakan.
- **Webhook** (`/admin/webhooks`): hantar peristiwa ke sistem lain apabila ia
  berlaku. Setiap langganan mempunyai satu log penghantaran, dan satu penghantaran
  yang gagal boleh dihantar semula. Selepas 20 kegagalan berturut-turut, atau 72
  jam kegagalan, Quire menangguhkan langganan itu dan menghantar e-mel kepada anda
  serta kenalan langganan tersebut.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-extensions.webp" alt="The Extensions page listing each activity type with its version and a Switch off button." width="944" height="760" loading="lazy" decoding="async"><figcaption>Extensions can be switched on or off for the organisation.</figcaption></figure>

## Perkongsian, kandungan dan AI <!--quire:sharing-content-and-ai-->

- **Ruang dikongsi** (`/admin/sharing`): tawarkan kursus dan item lain kepada
  organisasi lain, yang menjalankan sebuah kursus dikongsi sebagai satu salinan
  yang mereka miliki. Lihat [perkongsian antara organisasi](/ms/admin/sharing/).
- **Bank kandungan** (`/admin/content-bank`): fail dan kandungan yang dikongsi
  dengan seluruh organisasi atau satu kategori. Lihat
  [panduan bank kandungan](/ms/teacher/content-bank/).
- **Tetapan AI** (`/admin/ai`): pembekal, ciri, dasar penggunaan AI dan belanjawan.
  Lihat [ciri AI](/ms/admin/ai/).
- **Dasar** (`/admin/compliance/policies`): dasar yang diterima orang, dan dasar
  penggunaan wajar yang dipenguatkuasakan di tempat kandungan ditulis. Lihat
  [dasar dan penggunaan wajar](/ms/admin/policies/).
- **Pelan dan penbilangan** (`/admin/billing`): apa yang pelan anda sertakan dan
  apa yang sudah anda gunakan. Lihat [pelan dan penbilangan](/ms/admin/plans/).

## Rekod dan laporan <!--quire:records-and-reports-->

- **Log audit** (`/admin/audit`): siapa melakukan apa, dan bila. Entri dirantai,
  jadi satu entri tidak boleh diubah atau dibuang tanpa rantai itu menunjukkannya.
  Eksport untuk pasukan keselamatan atau SIEM anda daripada halaman yang sama.
- **Laporan** (`/admin/reports`): penyiakan, gred, penglibatan dan laporan tersuai.
  Laporan dibaca daripada satu sambungan berasingan hanya-baca, jadi sebuah laporan
  besar tidak pernah melambatkan laman untuk pelajar. Eksport yang mengandungi
  rekod pelajar direkodkan sebagai pendedahan.

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-audit.webp" alt="The Audit log with period and search filters." width="944" height="700" loading="lazy" decoding="async"><figcaption>The audit log records who did what, when and with what result.</figcaption></figure>

## Kebolehcapaian <!--quire:accessibility-->

Quire dibina mengikut WCAG 2.2 AA. Setiap orang juga boleh melaraskannya untuk
diri sendiri di `/account/preferences`: saiz teks, satu font mesra disleksia,
pengurangan gerakan dan kontras tinggi. Tiada apa-apa yang anda konfigurasikan boleh
mematikan perkara ini.

Source: https://docs.quirelms.com/ms/admin/index.mdx