📐 Blueprint & Prompt Generator Tema CMS

Dokumentasi teknis ketat untuk pembuatan tema. Dibuat agar AI tidak meleset dalam generate kode.

⚠️ PERHATIAN UNTUK AI: Saat menggunakan prompt di bagian bawah halaman ini, AI WAJIB mengikuti struktur variabel, array, dan fungsi persis seperti yang didokumentasikan di bawah. Dilarang mengubah nama variabel atau membuat fungsi database sendiri.

1. Injeksi Variabel Global oleh Core System

File index.php (Front Controller) telah menyiapkan variabel berikut sebelum memuat file tema. Gunakan langsung tanpa query database:

$settings (Array Associative) - Berisi data dari tabel settings. Key yang sering dipakai:
- $settings['site_name'] (Nama Website)
- $settings['site_logo'] (URL Logo)
- $settings['site_icon'] (URL Favicon)
- $settings['color_primary'] (Kode Hex warna utama, misal: #4F46E5)
- $settings['color_secondary'] (Kode Hex warna sekunder)
- $settings['color_background'] (Kode Hex warna latar)
- $settings['color_text'] (Kode Hex warna teks)
- $settings['footer_html'] (HTML custom footer)
$post (Array) - Tersedia hanya di single.php, product.php, page.php. Berisi: ['title'], ['content'], ['feature_image'], ['meta_description'], ['tags'], ['price'], ['wa_number'], ['category_id'], ['type'].
$cat_posts (Array of Array) - Tersedia di category.php. Berisi daftar post di kategori tersebut.
$list_posts (Array of Array) - Tersedia di archive-article.php & archive-product.php.
$layout (Array of Array) - Tersedia di index.php. Berisi konfigurasi Homepage Builder.
$category (Array) - Tersedia di category.php. Berisi ['name'], ['description'], ['type'].

2. Fungsi Helper Wajib

AI harus menggunakan fungsi ini untuk mengambil data dinamis:

// Mengambil menu navigasi
get_menus('header'); // return array of ['title', 'url']
get_menus('footer'); 

// Mengambil daftar post terbaru (untuk sidebar/loop)
get_posts('article', 5, 0); // get_posts($type, $limit, $offset)

// Generate URL sesuai pengaturan permalink admin
generate_url($post['slug'], $post['type'], $settings); // WAJIB dipakai untuk link

3. Aturan Warna (CSS Variables)

Warna TIDAK BOLEH di-hardcode. File header.php WAJIB menginjeksi warna dari setting ke CSS :root seperti ini:

<style>
:root {
    --color-primary: <?= htmlspecialchars($settings['color_primary'] ?? '#4F46E5') ?>;
    --color-secondary: <?= htmlspecialchars($settings['color_secondary'] ?? '#10B981') ?>;
    --color-bg: <?= htmlspecialchars($settings['color_background'] ?? '#F3F4F6') ?>;
    --color-text: <?= htmlspecialchars($settings['color_text'] ?? '#1F2937') ?>;
}
body { background: var(--color-bg); color: var(--color-text); }
.btn { background: var(--color-primary); }
</style>

4. Logika Homepage Builder (index.php)

File index.php tema harus melakukan loop $layout. Jika block pertama adalah full_html, maka echo dan exit (abaikan header/footer).

if (!empty($layout) && $layout[0]['type'] === 'full_html') {
    echo $layout[0]['content'];
    exit;
}
include 'header.php';
foreach ($layout as $block) {
    if ($block['type'] == 'full_html') echo $block['content'];
    elseif ($block['type'] == 'html') echo '<div>'.$block['content'].'</div>';
    elseif ($block['type'] == 'hero') {
        // Akses: $block['title'], $block['desc'], $block['btn_text'], $block['btn_url'], $block['bg_color']
    }
    elseif ($block['type'] == 'image') {
        // Akses: $block['url'], $block['link']
    }
    elseif ($block['type'] == 'divider') {
        // Akses: $block['height']
    }
    elseif ($block['type'] == 'articles') {
        // Akses: $block['title'], $block['limit']
        $articles = get_posts('article', $block['limit'] ?? 3, 0);
        // Loop $articles...
    }
    elseif ($block['type'] == 'products') {
        // Akses: $block['title'], $block['limit']
        $products = get_posts('product', $block['limit'] ?? 4, 0);
        // Loop $products...
    }
}
include 'footer.php';

5. Logika Page.php (Full HTML Deteksi)

$is_full_html = (stripos(trim($post['content']), '<!DOCTYPE') === 0);
if ($is_full_html) {
    echo $post['content'];
    exit;
}
// Lanjut load header.php jika bukan full html

🤖 Master Prompt Generator

Instruksi: Edit spesifikasi desain di dalam kurung siku [...] pada textarea di bawah, lalu copy dan tempel ke AI (Gemini/ChatGPT/Claude).

Kamu adalah Senior Theme Developer. Buatkan 9 file tema PHP lengkap untuk CMS Custom saya. 
IKATAN WAJIB: Kamu harus menggunakan variabel global ($settings, $post, $layout, dll) dan fungsi helper (get_menus, get_posts, generate_url) yang sudah didefinisikan oleh sistem. DILARANG membuat query database SQL sendiri (seperti mysqli atau PDO) di dalam file tema!

**SPESIFIKASI DESAIN YANG DIMINTA:**
- Nama Tema: [Misal: DarkFuturistik / ElegantMagazine]
- Gaya Desain: [Misal: Dark mode dengan aksen neon, sudut membulat, glassmorphism / Majalah klasik dengan border tegas]
- Warna Default Jika Kosong: Primary [Misal: #8B5CF6], Secondary [Misal: #06B6D4], Background [Misal: #0F172A], Text [Misal: #F8FAFC]
- Font: [Misal: Poppins / Space Grotesk / Playfair Display]
- Layout Artikel (single.php): [Misal: 2 kolom (Konten 70% + Sidebar 30% sticky) / 1 kolom penuh di tengah layar]

**ATURAN TEKNIS MUTLAK (WAJIB DIIKUTI):**

1. Keamanan: Setiap file diawali `<?php if(!defined('RUNNING_IN_WEB')) exit(); ?>`.
2. Variabel Warna Dinamis: Di `header.php`, masukkan warna dari database ke CSS `:root`:
   `<style>:root { --color-primary: <?= htmlspecialchars($settings['color_primary'] ?? '#8B5CF6') ?>; --color-bg: <?= htmlspecialchars($settings['color_background'] ?? '#0F172A') ?>; }</style>`
   Gunakan `var(--color-primary)` di semua CSS, jangan hardcode warna!
3. Header.php: Harus ada SEO Meta Tag dinamis (og:title, og:description) dan JSON-LD Schema (WebSite, Article, Product) berdasarkan variabel `$post`. Panggil menu via `foreach(get_menus('header') as $m)`.
4. Index.php (Homepage Builder): 
   - Cek jika `$layout[0]['type'] === 'full_html'`, maka `echo $layout[0]['content']; exit;`.
   - Jika tidak, `include 'header.php'`, lalu `foreach ($layout as $block)` dan render berdasarkan `$block['type']` (`full_html`, `html`, `hero`, `image`, `divider`, `articles`, `products`).
   - Untuk `articles` dan `products`, panggil `get_posts($block['type'], $block['limit'] ?? 3, 0)`.
5. Single.php: Harus 2 kolom. Kiri konten, kanan sidebar. Sidebar wajib memanggil `get_posts('article', 6, 0)` lalu loop 5 item (skip yang sedang dibaca) dengan menampilkan thumbnail 80x80 dan judul. Gunakan `generate_url($p['slug'], 'article', $settings)` untuk link.
6. Product.php: Layout 2 kolom (Gambar & Info). Tombol WA wajib ada: `$wa_link = "https://wa.me/".$post['wa_number']."?text=".urlencode("Halo, saya tertarik dengan ".$post['title']);`
7. Page.php: Cek `stripos(trim($post['content']), '<!DOCTYPE')`. Jika true, echo mentah dan exit. Jika false, load header/footer.
8. Footer.php: Panggil `get_menus('footer')`, echo `$settings['footer_html']`, dan tambahkan teks copyright "by Andi | disatu.web.id".
9. Archive & Category: Gunakan CSS Grid untuk menampilkan list post. Di `archive-product.php` dan `category.php` (jika tipe produk), wajib tampilkan harga `Rp <?= number_format($p['price'] ?? 0, 0, ',', '.') ?>`.

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