Konsep inti

Brand

Brand adalah satu situs web dengan konten, media, menu, pengaturan, tema, anggota, dan token miliknya sendiri. Satu akun ATLAS bisa menjalankan banyak brand, dan tidak ada yang dibagi di antaranya: setiap kueri yang dijalankan API dibatasi ke brand yang aktif.

Id record milik brand lain dijawab 404, bukan 403, sehingga orang asing tidak mengetahui apa pun tentang apa yang ada. Brand dikenali dari token pada permintaan, atau dari domain yang dilayaninya saat panggilan tidak membawa token. Brand yang ditangguhkan dijawab 403 baik di API publik maupun API dashboard.

Entri dan tipe konten

Semua yang Anda terbitkan adalah entri. Halaman dan artikel adalah entri, begitu juga setiap record dari tipe konten kustom yang Anda definisikan, seperti kota, produk, atau rilis. Entri memiliki bahasa, tipe, dan path, dan ketiganya unik di dalam sebuah brand.

Tipe konten kustom adalah skema kecil berisi field bertipe: teks, angka, tanggal, tautan, media, teks kaya, daftar, repeater berisi baris, atau referensi ke entri lain. Dashboard membangun formulirnya dari skema, dan API memeriksa setiap penyimpanan terhadapnya.

Entri bisa dikelompokkan di bawah term (kategori dan tag), dan halaman bisa berada di bawah halaman induk, yang membuat path-nya bersarang.

Revisi

Entri tidak pernah berubah di tempat. Setiap penyimpanan menambahkan revisi berisi judul, block, SEO, dan field, dan revisi terbaru adalah draf. Menerbitkan mengarahkan entri ke satu revisi, dan rollback mengarahkannya kembali ke revisi sebelumnya. Tidak ada yang disalin.

Revisi bersifat hanya-tambah, sehingga Anda selalu punya riwayat dan diff antara dua revisi mana pun. API menyimpan 50 revisi terakhir dari setiap entri, ditambah revisi yang terbit, revisi yang ditunjuk jadwal, dan revisi apa pun yang bergantung pada tinjauan terbuka atau terjemahan.

Terbitkan, jadwalkan, dan rollback

Hanya publisher atau admin yang bisa mengubah apa yang tayang. Penerbitan bisa menyebut revisi persis yang akan diterbitkan; jika halaman sudah berubah sejak itu, API menjawab 409 revision_changed alih-alih menerbitkan sesuatu yang belum ditinjau siapa pun.

• Terbitkan membuat revisi yang dipilih tayang seketika.
• Jadwalkan menerbitkannya pada waktu yang Anda pilih. Penjadwal memeriksa setiap menit.
• Rollback membuat revisi sebelumnya kembali menjadi yang tayang.
• Tinjauan memungkinkan editor meminta persetujuan. Publisher menyetujui dan revisi yang ditinjau tayang persis seperti saat ditinjau.

Setiap perubahan pada output yang tayang menulis baris audit, menaikkan versi konten brand, dan mengantrekan webhook purge yang bertanda tangan, sehingga situs Anda menyegarkan diri dalam sekitar satu detik.

Terjemahan

Terjemahan adalah entri lain dalam bahasa lain, ditautkan ke entri pertama melalui grup terjemahan. Path bersifat per bahasa, dan tautan di antaranya keluar sebagai translations dalam jawaban halaman, yang dibutuhkan situs untuk hreflang.

Ketika halaman tidak punya entri dalam bahasa yang diminta, API menyajikan bahasa default dan menyatakannya dengan "fallback": true, kecuali brand mematikan fallback tersebut. Terjemahan dianggap usang ketika entri bahasa default memiliki revisi yang lebih baru daripada revisi asal pembuatannya.

Block dan tema

Isi halaman adalah pohon block: hero, grid fitur, FAQ, formulir. Block bersarang paling dalam tiga tingkat (section, kolom, block). Media disimpan sebagai id dan API menyelesaikannya menjadi URL dalam jawaban. Definisi block adalah satu-satunya sumber kebenaran untuk sebuah block: ia menggerakkan formulir editor, validasi server, dan komponen yang merendernya.

Tema adalah paket yang mengubah block menjadi situs web: komponen block, template halaman, bagian header dan footer, serta opsi yang bisa diubah brand tanpa kode. Setiap brand memiliki set token (warna, font, radius) yang disajikan API publik dari /v1/public/theme, sehingga situs dan pratinjau dashboard membaca nilai yang sama.

Situs Anda hanya membaca

Situs brand membaca konten yang sudah terbit melalui API publik. Penulisan, termasuk formulir lead, melewati server route milik layer, yang menambahkan token di server.