Import Konten Sampel

Hanya untuk WordPress yang masih baru (kosong). Importer WordPress hanya bisa membuat konten — ia tidak pernah memperbarui entri atau halaman yang sudah ada. Mengimpor sampel ini ke situs yang sudah berisi konten akan menghasilkan duplikat (entri, halaman, kategori, menu, dan media dibuat ulang semua), dan pengaturan halaman depan/menu pada sampel mengasumsikan instalasi yang kosong. Kalau situsmu sudah ada isinya: berhenti, ambil backup, lalu siapkan WordPress baru.

Yang perlu disiapkan

Kebutuhan	Alasan
WordPress baru (baru selesai wizard instalasi)	Importer membuat konten; ia tidak bisa mengganti atau menggabungkan
Akses admin	Impor, menu, halaman depan, dan permalink semuanya tugas admin
Tema Blogtail General aktif	Sampel ini dimaksudkan dilihat dengan tema tersebut
Plugin WindPress aktif (mode Tailwind CSS v4)	Tanpa itu, sampel tampil tanpa gaya
Berkas sampel	Belum dilampirkan — nama/lokasinya diisi setelah diberikan
Backup database	Importer tidak bisa dibatalkan

Langkah 1 — Siapkan instalasi kosong

Ambil backup dulu

docker exec wordpress_db sh -c \
  'mariadb-dump -u root -p"$MYSQL_ROOT_PASSWORD" --single-transaction --databases wordpress' \
  > ~/wordpress-before-sample-$(date +%F).sql

Hapus konten bawaan

Instalasi baru membawa satu entri (Hello world!), satu halaman (Sample Page), dan draf kebijakan privasi. Hapus semuanya supaya sampel menjadi satu-satunya konten di situs.

Aktifkan tema dan plugin

Appearance → Themes → Blogtail General; Plugins → pastikan WindPress aktif pada mode Tailwind CSS v4.

Langkah 2 — Impor sampel

Buka importer

Tools → Import → WordPress → Install Now (memasang plugin wordpress-importer) → Run Importer.

Unggah berkas sampel

Pilih berkas sampel (format ekspor WordPress, .xml) → Upload file and import. Kalau sampelnya berbentuk ZIP, ekstrak dulu lalu unggah .xml di dalamnya.

Tentukan penulis

Yang diimpor hanya kontennya — user tidak. Pilih admin yang ada pada Assign posts to an existing user, atau buat dulu user penulis lalu pilih user itu.

Impor lampiran

Centang Download and import file attachments bila sampel merujuk gambar; gambar akan diambil ke wp-content/uploads/. Kalau sampel menyertakan gambar secara lokal, unggah setelahnya lewat Media → Add New.

Jalankan impor

Klik Submit dan tunggu — importer memproses item satu per satu dan biasanya melaporkan item mana yang gagal, bila ada.

Langkah 3 — Selesaikan pengaturan (tidak ikut di berkas)

Tentukan halaman depan

Settings → Reading → Your homepage displays → A static page → pilih halaman depan dari sampel, plus halaman daftar entri bila sampel menyediakannya.

Pasang menunya

Appearance → Menus (atau Appearance → Customize → Menus) → pilih menu hasil impor → centang lokasi menu temanya → Save.

Periksa widget

Appearance → Widgets: tema ini tidak mendaftarkan area widget — sidebar di halaman tunggal dirender oleh template tema sendiri (sidebar-single.php).

Segarkan permalink

Settings → Permalinks → Post name → Save Changes, supaya entri hasil impor bisa diakses dan tidak 404.

Verifikasi	Harapan
Beranda	Hero plus kisi kartu “Latest Articles”
Halaman tunggal	Remah, badge kategori, baris meta, sidebar, kotak penulis, Related Posts
Arsip / pencarian	Kepala arsip + kisi kartu yang sama
Media	Gambar di `wp-content/uploads/<tahun>/<bulan>/`

Cara kerjanya (supaya kamu paham apa yang dilakukan importer)

Sampelnya adalah berkas WXR — WordPress eXtended RSS — XML yang dihasilkan Tools → Export. Dengan tahu apa yang ada dan tidak ada di dalamnya, aturan “hanya WordPress baru” dan beberapa langkah manual jadi masuk akal.

Ada di berkas WXR	Tidak ada di berkas WXR
Entri, halaman, custom post type	User (hanya nama penulis sebagai teks)
Kategori, tag, term	Pengaturan tema dan nilai Customizer
Komentar	Widget dan penempatannya
Term `nav_menu` dan item menu	Lokasi menu (spesifik tema)
Data lampiran + `wp:attachment_url`	Berkas gambarnya sendiri, kecuali bisa diakses dari URL itu
Post meta, termasuk `_thumbnail_id`	Pengaturan plugin (termasuk WindPress)

Yang sebenarnya terjadi saat impor:

Baca & buat. Setiap <item> menjadi entri baru dengan ID baru. Item dicocokkan dengan konten yang ada berdasarkan GUID: kalau sudah ada entri dengan GUID sama, item itu dilewati — tidak ada yang diperbarui.
Term. Kategori, tag, dan term menu dibuat, lalu relasi entri↔term dipulihkan dari berkas.
Lampiran. Dengan Download and import file attachments aktif, setiap URL media diambil dan disimpan sebagai lampiran di wp-content/uploads/<tahun>/<bulan>/. Importer tidak melakukan de-duplikasi — impor dua kali berarti dua kopi setiap gambar.
Thumbnail. Gambar unggulan adalah post meta yang menunjuk ID lampiran; kalau lampirannya gagal diimpor, entri tampil tanpa thumbnail.
Menu. Item menu diimpor sebagai konten, tetapi menu mana tampil di lokasi mana adalah opsi tema (nav_menu_locations) dan tidak pernah diimpor — kamu memasangnya manual.
Selebihnya tidak tersentuh. Halaman depan/daftar entri (page_on_front, page_for_posts), struktur permalink, setelan WindPress, dan opsi plugin lain ada di tabel opsi database, bukan di berkas.

Tidak ada jalur “perbarui konten yang ada dari berkas”, dan tidak ada undo. Itulah alasan sampel ini didokumentasikan sebagai hanya untuk WordPress baru: di situs yang sudah berisi konten, setiap impor membuat kopi kedua dari semuanya tanpa menggabungkan apa pun.

Alternatif bootstrap: snapshot setelah impor

Setelah sampelnya terlihat benar, simpan sebagai snapshot supaya lingkungan baru tidak perlu mengulang proses impor:

# database
docker exec wordpress_db sh -c \
  'mariadb-dump -u root -p"$MYSQL_ROOT_PASSWORD" --single-transaction --databases wordpress' \
  > ~/wordpress-with-sample-$(date +%F).sql

# media hasil unggahan (path host di server ini)
tar -czf ~/wordpress-uploads-$(date +%F).tar.gz \
  -C /home/www/project/wordpress/web/web/wp-content uploads

Memulihkan dump itu plus folder uploads pada stack baru akan mereproduksi sampel tanpa menjalankan importer lagi — cara tercepat mendapatkan lingkungan yang identik.

Kalau ada yang tidak beres

Gejala	Sebab / solusi
Semua konten jadi dobel	Situsnya belum kosong → pulihkan backup, lalu impor ulang di instalasi bersih
Entri 404 setelah impor	Settings → Permalinks → Post name → Save Changes
Beranda menampilkan daftar entri	Settings → Reading → pasang halaman depan statis
Menu tidak muncul di header	Pasang menu hasil impor ke lokasi menu temanya
Gambar hilang	Lampiran tidak terimpor (URL tak terjangkau, atau centangnya mati) → unggah lewat Media
Sampel tampil tanpa gaya	WindPress tidak aktif, atau belum mode Tailwind CSS v4

Referensi (server ini)

Item	Nilai
Docroot WordPress	`/home/www/project/wordpress/web/web`
Tema	`.../wp-content/themes/` (Blogtail General 1.0.4 terpasang)
Uploads	`.../wp-content/uploads/` (saat ini `2026/` dan `windpress/`)
Container database	`wordpress_db` (MariaDB; dump memakai env `MYSQL_ROOT_PASSWORD`)
WP-CLI	tidak tersedia di container `wordpress_php` → pakai `wp-admin`

Belum didokumentasikan

Berkas sampelnya sendiri: nama, format (.xml tunggal atau ZIP), lokasi penyimpanan, dan cara distribusinya (aset release, aset repo, atau dilampirkan di halaman ini).
Isi sampel: jumlah entri/halaman/kategori, apakah menu dan gambar disertakan, dan halaman mana yang harus dijadikan halaman depan.
Apakah perlu user penulis khusus untuk konten sampel.
Apakah sampel mengharapkan opsi tema (logo, warna) diatur manual.

Cara Install Logo, Favicon, Nama Situs & Navigasi Header