📖 Dokumentasi Tema CMS

Panduan lengkap struktur file, variabel, dan generator prompt untuk membuat tema baru.

1. Struktur Folder & File Wajib

Tema diletakkan di dalam folder content/themes/nama_tema/. Sebuah tema wajib memiliki 9 file berikut:

header.php - Bagian atas web (<head>, navigasi, pembuka <body>)
footer.php - Bagian bawah web (penutup </body>, copyright)
index.php - Halaman Beranda (Merender Homepage Builder)
single.php - Halaman baca artikel detail
product.php - Halaman detail produk
page.php - Halaman statis / Landing Page
category.php - Halaman daftar konten per kategori
archive-article.php - Halaman daftar semua artikel
archive-product.php - Halaman daftar semua produk

2. Aturan Keamanan Wajib

Setiap file tema HARUS diawali dengan kode ini untuk mencegah akses langsung dari luar:

<?php if(!defined('RUNNING_IN_WEB')) exit(); ?>

3. Variabel Global yang Tersedia

Anda tidak perlu melakukan query database manual. Semua data sudah disiapkan oleh sistem.

$settings (Array) - Berisi semua pengaturan web.
Contoh: $settings['site_name'], $settings['site_logo'], $settings['color_primary'], $settings['slug_article']
$page_title (String) - Judul halaman untuk tag <title>.
$post (Array) - Tersedia di single.php, product.php, page.php. Berisi: title, content, feature_image, price, wa_number, dll.
$cat_posts (Array) - Tersedia di category.php.
$list_posts (Array) - Tersedia di archive-*.php.
$layout (Array) - Tersedia di index.php. Berisi susunan block dari Homepage Builder.

4. Fungsi Helper (Bawaan Sistem)

get_menus('header') - Mengembalikan array menu navigasi header.
get_menus('footer') - Mengembalikan array menu navigasi footer.
get_posts($type, $limit, $offset) - Mengambil daftar konten. Contoh: get_posts('article', 5, 0).
generate_url($slug, $type, $settings) - Mengubah slug menjadi URL yang benar sesuai pengaturan permalink.

5. Logika Khusus (Wajib Diimplementasikan)

Homepage Builder (index.php): Looping variabel $layout dan render berdasarkan tipenya: html, full_html, hero, image, divider, articles, products. Jika full_html ada di urutan pertama, echo dan exit.
Full HTML Page (page.php): Cek apakah konten dimulai dengan <!DOCTYPE. Jika ya, echo langsung dan exit (abaikan tema).
SEO & Schema (header.php): Harus berisi logika deteksi $post untuk menghasilkan Meta Tag (OG, Twitter) dan JSON-LD (Article, Product) secara dinamis.

🤖 Prompt Generator Tema Baru

Ganti teks di dalam kurung siku [...] sesuai keinginan Anda, lalu klik tombol Copy. Tempelkan prompt tersebut ke ChatGPT/Claude/Gemini untuk generate tema baru.

Saya ingin membuat tema baru untuk CMS buatan saya sendiri. Tolong buatkan 9 file tema lengkap berdasarkan spesifikasi di bawah ini.

**Spesifikasi Desain Tema:**
- Nama Tema: [Misal: TechBlog / DarkModeZ / MagazinePro]
- Gaya Desain: [Misal: Futuristik neon / Majalah koran / Minimalis glassmorphism / Dark mode elegan]
- Warna Default: [Misal: Background hitam, teks putih, aksen ungu neon]
- Font: [Misal: Poppins / Roboto / Font monospace / Playfair Display]
- Layout Khusus: [Misal: Grid 3 kolom untuk homepage / Sidebar di kiri / Tanpa sidebar di mobile]

**Aturan Teknis CMS (WAJIB DIIKUTI):**
1. Setiap file harus diawali `<?php if(!defined('RUNNING_IN_WEB')) exit(); ?>`.
2. File `header.php` harus berisi SEO lengkap (Meta Tag dinamis, Open Graph, JSON-LD Schema untuk WebSite, Article, dan Product), panggilan menu via `get_menus('header')`, dan memuat variabel `$settings['color_primary']` dll ke dalam CSS `:root`.
3. File `index.php` harus merender variabel `$layout` (Homepage Builder) dengan tipe block: `full_html`, `html`, `hero`, `image`, `divider`, `articles`, `products`. Jika `full_html` ada di urutan pertama, echo dan exit.
4. File `single.php` (artikel) harus punya layout 2 kolom (Konten + Sidebar 5 artikel terbaru dengan thumbnail). Gunakan `get_posts('article', 6, 0)` untuk sidebar.
5. Gunakan fungsi `generate_url($p['slug'], $p['type'], $settings)` untuk semua link URL artikel/produk.
6. File `page.php` harus cek apakah konten `<!DOCTYPE`. Jika ya, tampilkan mentah tanpa tema. Jika teks biasa, format dengan `nl2br()`.
7. File `footer.php` harus memuat `$settings['footer_html']`, `get_menus('footer')`, dan teks "by Andi | disatu.web.id".

Tolong generate kodenya secara lengkap untuk 9 file: `header.php`, `footer.php`, `index.php`, `single.php`, `product.php`, `page.php`, `category.php`, `archive-article.php`, `archive-product.php`. Pisahkan setiap file dengan blok kode yang jelas.