Pertanyaan yang Sering Diajukan

Konsep

Apa itu headless CMS?

Headless CMS adalah sistem pengelolaan konten yang memisahkan tempat mengelola konten dari layar tempat konten ditampilkan. Di sini "headless" berarti tidak ada layar (UI) tetap yang melekat secara terpisah.

Pada cara tradisional, tempat mengelola konten dan layar situs web yang menampilkannya terikat menjadi satu. Headless CMS memisahkan keduanya. Konten dikelola di satu tempat, lalu konten itu disampaikan melalui jalur yang telah disepakati (API, yaitu cara saling bertukar data lewat alamat menurut aturan yang sudah ditetapkan). Karena itu, konten yang sama dapat diambil dan dipakai di berbagai layar berbeda seperti situs web maupun aplikasi seluler.

WEEGLOO termasuk headless CMS ini. Ketika Anda membuat dan menerbitkan konten di studio konten, situs web atau aplikasi mengambil hasil terbitan itu dan menampilkannya di layar. Cara kerja WEEGLOO secara keseluruhan dibahas di Cara kerjanya.

Dengan cara apa konten disediakan?

WEEGLOO menyediakan konten melalui RESTful API berbasis JSON (format data berbasis teks yang dipakai saat bertukar data). API adalah jalur untuk saling bertukar data lewat alamat menurut aturan yang sudah ditetapkan.

Sesuai penggunaannya, ada beberapa API yang dipisahkan.

  • CDA (Content Delivery API) untuk membaca konten yang sudah diterbitkan: dipakai saat situs web atau aplikasi mengambil konten dan menampilkannya kepada pengunjung.
  • CMA (Content Management API) untuk membuat dan mengelola konten: dipakai saat menjalankan pekerjaan seperti menulis, menyunting, dan menerbitkan yang biasa dilakukan di studio konten, tetapi lewat kode.

Karena membaca dan mengelola dipisahkan seperti ini, Anda dapat memilih hanya jalur yang diperlukan di berbagai lingkungan untuk memanfaatkan konten. API mana yang dipakai pada situasi mana dibahas di Referensi API.

Apakah WEEGLOO dapat dipakai di aplikasi seluler juga?

Ya. Seperti yang dijelaskan di Apa itu headless CMS?, WEEGLOO mengelola konten secara terpisah dari layar yang menampilkannya. Karena itu, konten yang sama dapat diambil dan dipakai baik di situs web maupun di aplikasi seluler. Cara aplikasi mengambil konten yang sudah diterbitkan sama dengan di web.

Ada satu hal yang berbeda saat memasang login anggota di aplikasi seluler (Android·iOS). Sambungan untuk menerima kembali hasilnya ke aplikasi setelah login selesai berbeda dari web, sehingga ada langkah teknis tersendiri yang diperlukan. Langkah itu dibahas di Auth API.

Contoh lengkap yang mengintegrasikan aplikasi seluler dengan WEEGLOO dapat Anda lihat dari awal sampai akhir di Layanan Pelacak Lari.

Pengelolaan konten

Bagaimana cara menyebarkan konten dalam beberapa bahasa?

Untuk menyediakan Content atau Media dalam beberapa bahasa, tambahkan dulu bahasa (Locale) ke Space.

  1. Dari menu kiri, masuk ke layar pengelolaan Locale pada pengaturan Space.
  2. Tekan tombol + Tambah di kanan atas, lalu pilih bahasa yang diinginkan dari dropdown.
  3. (Opsional) Tetapkan Fallback Locale. Ini adalah bahasa yang ditampilkan sebagai pengganti saat nilai bahasa itu kosong.
  4. Tekan Simpan.

Setelah menambahkan Locale, Anda harus mengaktifkan multibahasa pada setiap Field yang akan menerima nilai per bahasa. Pada layar edit Content Type, buka Konfigurasikan Field untuk Field terkait, lalu pada tab Pengaturan pastikan Aktifkan lokalisasi untuk Field ini dalam keadaan aktif.

Penjelasan rinci dibahas di Pengelolaan multibahasa.

Bagaimana cara melakukan validasi Content?

Validasi adalah fitur untuk menerapkan kondisi tentang "nilai yang boleh masuk ke kolom ini" pada Field. Nilai yang tidak memenuhi kondisi tidak akan tersimpan, sehingga mencegah menumpuknya Content yang salah.

Kondisi yang dapat diterapkan berbeda untuk setiap jenis Field. Sebagai contoh, pada Field yang menghubungkan Media tersedia kondisi untuk membatasi jenis berkas yang boleh diunggah atau membatasi ukuran berkas dan ukuran gambar, sedangkan pada Field angka tersedia kondisi untuk menentukan rentang nilai.

Untuk menambahkan validasi pada Field, lakukan langkah berikut.

  1. Buka layar edit Content Type, lalu tekan Field yang akan diberi kondisi.
  2. Pada Konfigurasikan Field, pindah ke tab Validasi.
  3. Kondisi yang dapat dipakai pada jenis Field itu akan muncul. Pilih dan atur kondisi yang diperlukan.

Penjelasan rinci dibahas di Validasi.

Bagaimana cara mengatur judul Content?

Judul Content adalah nama untuk mengenali setiap item di daftar Content. Field bertipe ShortText mana pun dapat dipakai sebagai judul.

Pada layar edit Content Type, buka Field yang akan dipakai sebagai judul, lalu tetapkan Field itu untuk dipakai sebagai judul. Judul hanya dapat dimiliki oleh satu Field per Content Type, jadi jika sudah ada Field lain yang ditetapkan sebagai judul, lepaskan dulu penetapan itu, baru tetapkan yang baru.

Alur menetapkan judul saat pertama kali membuat Field dibahas di Pemodelan Content.

Pengelolaan Organization dan Space

Bagaimana cara mengundang pengguna?

Untuk memasukkan seorang pengguna ke Space, pengguna itu harus lebih dulu termasuk dalam Organization. Karena itu, kolaborasi dimulai dengan mengundang ke Organization.

Mengundang pengguna ke Organization dapat dilakukan oleh pengguna yang memiliki peran Owner atau Admin.

  1. Masuk ke layar pengaturan Organization.
  2. Di menu kiri, tekan Memberships.
  3. Tekan tombol Undang di kanan atas, lalu masukkan informasi seperti email dan peran yang akan diberikan untuk mengirim undangan.

Pengguna yang diundang langsung menjadi anggota. Tidak ada tahap "terima" secara terpisah, dan email pemberitahuan dikirim ke email yang diundang.

Penjelasan rinci tentang undangan dan peran dibahas di Organization dan Space.

API

Apakah nilai sys.id bersifat unik?

Ya. sys.id dibuat unik di seluruh layanan. Karena itu, nilainya tidak akan bertabrakan dengan sumber daya yang termasuk dalam Organization atau Space lain.

Informasi yang ditampung dalam sys dibahas di Properti sistem (sys).

Bagaimana cara mengambil sumber daya referensi dari Content?

Dengan memakai parameter include, Anda dapat mengambil Content sekaligus sumber daya referensi yang dirujuknya dalam satu permintaan.

GET /v1/spaces/{spaceId}/contents?include=1

Permintaan di atas mengambil daftar Content sekaligus data referensi yang terhubung sedalam satu tingkat. Jika Anda menaikkan nilainya menjadi 2 atau 3, data diambil dengan membentangkannya hingga tingkat yang lebih dalam.

include dapat dipakai dengan cara yang sama bukan hanya pada Content, melainkan pada pengambilan semua sumber daya. Penjelasan rinci dibahas di Parameter kueri umum.

Apakah operasi OR didukung pada kondisi pencarian?

Pada REST API, fitur untuk menggabungkan beberapa kondisi dengan OR (mengambil jika salah satu dari keduanya cocok) tidak didukung secara langsung. Jika Anda memberikan beberapa kondisi sekaligus dalam satu permintaan, hanya hasil yang memenuhi semuanya (AND) yang keluar. Jika Anda membutuhkan OR, kirim permintaan secara terpisah per kondisi, lalu gabungkan hasil yang diterima.

Cara mempersempit daftar dengan kondisi dibahas di Parameter kueri umum.

Pembayaran dan tarif

Apakah paket harga dapat diubah?

Anda dapat menaikkan (upgrade) atau menurunkan (downgrade) paket harga kapan saja. Jika Anda melakukan upgrade, biaya disesuaikan secara proporsional untuk sisa periode penagihan, sedangkan downgrade berlaku mulai periode penagihan berikutnya.

Batas dan harga tiap paket dibahas di Paket harga.

Bagaimana pemakaian API dihitung?

Banyak platform konten menghitung pemakaian berdasarkan jumlah panggilan API (jumlah permintaan). WEEGLOO menghitung pemakaian berdasarkan jumlah data yang benar-benar dipertukarkan (volume transfer data), bukan jumlah panggilan. Untuk jumlah permintaan yang sama, semakin besar data yang dipertukarkan, semakin besar pula pemakaian yang tercatat.

Paket Free, Basic, dan Pro sudah mencakup volume transfer data tertentu setiap bulan di dalam tarif bulanannya. Pada tabel paket harga, volume transfer ini juga ditampilkan sebagai nilai hasil konversi ke jumlah panggilan agar Anda dapat memperkirakannya. Pekerjaan yang satu kali pencariannya dihitung sebagai beberapa kali panggilan, seperti Advanced Search, juga memakai volume transfer ini.

Jika Anda memerlukan pemakaian yang lebih besar daripada volume transfer yang telah ditetapkan, Anda dapat menggunakan paket Enterprise yang ditagih sesuai pemakaian. Batas transfer data tiap paket dibahas di Paket harga.