ZonAuto News

Plugin WordPress untuk otomasi scraping berita RSS, rewrite artikel via AI, dan auto-posting ke WordPress & Facebook Page. Dikembangkan khusus untuk zonautara.com — media online Sulawesi Utara, Indonesia.

---

Daftar Isi

1. Apa Itu ZonAuto News?
2. Fitur Lengkap
3. Persyaratan Sistem
4. Instalasi
5. Konfigurasi Awal
6. Panduan Penggunaan
7. Pengaturan AI Provider
8. Sumber Berita Default
9. Kustomisasi Prompt AI
10. Featured Image
11. Jadwal Otomatis
12. Integrasi Facebook
13. Struktur Database
14. Struktur File Plugin
15. Pertanyaan Umum (FAQ)
16. Catatan Etika & Legal
17. Changelog

---

Apa Itu ZonAuto News?

ZonAuto News adalah plugin WordPress yang mengotomasi alur kerja jurnalistik digital:

RSS Feed Sumber Berita
        ↓
  Scraping & Deduplikasi
        ↓
  Rewrite via AI (Claude / GPT / Gemini)
        ↓
  Featured Image dari foto sumber berita
        ↓
  Auto-post ke WordPress & Facebook Page

Plugin ini dirancang untuk media online yang ingin memperbanyak konten dari berbagai sumber terpercaya, dengan tetap menjaga standar jurnalistik: data akurat, kutipan narasumber utuh, dan atribusi sumber yang jelas.

Dua mode utama:

• Rewrite — Mengambil 1 artikel dari sumber, menulis ulang menjadi 1 artikel baru yang lengkap
• Rangkuman — Mengambil beberapa artikel dari berbagai sumber, merangkumnya menjadi 1 artikel kompilasi

---

Fitur Lengkap

🤖 Multi AI Provider

• Claude (Anthropic) — model Sonnet, Opus, Haiku
• GPT (OpenAI) — model GPT-4o, GPT-4o Mini, GPT-4 Turbo
• Gemini (Google) — model Gemini 1.5 Pro, 1.5 Flash, 2.0 Flash
• Pilihan model bisa diubah dari dashboard tanpa edit kode

✍️ Rewrite Jurnalistik Berkualitas

• Struktur piramida terbalik (fakta terpenting di lead)
• Lead wajib menjawab 5W1H
• Data angka, kutipan narasumber, nama orang/tempat tidak diubah
• Artikel lengkap — tidak terpotong di tengah
• Byline media bold otomatis disisipkan di paragraf pertama
• Baris sumber italic + link ke artikel asli di akhir artikel
• SEO otomatis: 1 focus keyword di judul & tag, meta description max 160 karakter
• Maksimal 3 tag per artikel

📋 Rangkuman Multi-Berita

• N berita dari berbagai sumber → 1 artikel ringkas
• Judul otomatis menyertakan tanggal (contoh: "Rangkuman Berita Sulut 27 Maret 2026")
• Setiap berita dalam rangkuman punya link ke sumber asli
• Bisa diaktifkan/nonaktifkan dari Pengaturan

📤 Tujuan Posting Fleksibel

• WordPress saja
• Facebook Page saja
• WordPress + Facebook sekaligus

🖼️ Featured Image Otomatis

• Mengambil foto langsung dari URL sumber berita (tanpa editing)
• Caption foto otomatis: "Foto: [Nama Media]"
• Mendukung JPEG, PNG, WebP, GIF

⏰ Jadwal Fleksibel

• Rewrite dan Rangkuman punya jadwal terpisah dan independen
• Setiap X jam (2–12 jam), X kali per hari, atau setiap X hari

✏️ Prompt AI Bisa Dikustom dari Dashboard

• Edit prompt Rewrite dan Rangkuman langsung dari browser
• Variabel dinamis: {{BYLINE}}, {{REGION}}, {{COUNT}}, {{DATE}}
• Tombol reset ke prompt default kapanpun
• Kosongkan = pakai prompt default otomatis

📡 Manajemen Sumber Berita Lengkap

• 29 sumber RSS default (20 Nasional, 3 Global, 6 Sulawesi Utara)
• Tambah, edit, hapus sumber dari dashboard
• Toggle aktif/nonaktif per sumber tanpa menghapus
• Filter sumber per region
• Test RSS feed langsung dari form

🔧 Dashboard & Monitoring

• Statistik real-time: total artikel, berhasil post, hari ini, error
• Log 100 artikel terakhir dengan status dan detail error
• 5 run terakhir dengan durasi dan rincian
• Mode Uji Coba untuk test tanpa menunggu jadwal

---

Persyaratan Sistem

Komponen	Minimum	Direkomendasikan
WordPress	5.8	6.4+
PHP	7.4	8.1+
MySQL	5.7	8.0+
PHP Extension	cURL, JSON	cURL, JSON, GD
Memori PHP	128MB	256MB+
Max Execution Time	120 detik	300 detik

API Key yang dibutuhkan (pilih salah satu):

• Anthropic: console.anthropic.com
• OpenAI: platform.openai.com
• Google Gemini: aistudio.google.com

---

Instalasi

Cara 1 — Via WordPress Admin (Termudah)

1. Download zonauto-news-v3.3.1.zip dari halaman Releases
2. Login ke WordPress Admin
3. Klik Plugins → Add New Plugin
4. Klik Upload Plugin → pilih file zip → Install Now
5. Klik Activate Plugin
6. Menu ZonAuto News muncul di sidebar kiri

Cara 2 — Via FTP / cPanel File Manager

1. Extract zip — dapat folder zonauto-news
2. Upload folder ke /wp-content/plugins/ di server
3. WordPress Admin → Plugins → Installed Plugins → Activate

Cara 3 — Via SSH + WP-CLI

cd /var/www/html/wp-content/plugins/
wget https://github.com/USERNAME/zonauto-news/releases/latest/download/zonauto-news.zip
unzip zonauto-news.zip && rm zonauto-news.zip
wp plugin activate zonauto-news

⚠️ Catatan Install Bersih: Jika sebelumnya pernah install versi lain, hapus dulu data lama di phpMyAdmin sebelum install ulang:

DROP TABLE IF EXISTS wp_zonauto_sources;
DROP TABLE IF EXISTS wp_zonauto_articles;
DROP TABLE IF EXISTS wp_zonauto_runs;
DELETE FROM wp_options WHERE option_name LIKE 'zonauto_%';

---

Konfigurasi Awal

1. Pilih AI Provider dan Isi API Key

ZonAuto News → Pengaturan → 🤖 AI Engine

• Pilih provider (Claude/OpenAI/Gemini)
• Isi API Key
• Pilih model (yang ada tanda "Rekomendasi")

2. Atur Tujuan Posting

Pengaturan → 📤 Tujuan Posting

• Pilih: WordPress saja / Facebook saja / Keduanya
• Status post: Draft (aman, review manual) atau Langsung Publish
• Pilih Author dan Kategori default

3. Atur Jadwal

Pengaturan → ✍️ Jadwal Rewrite & 📋 Rangkuman

• Mulai dari jadwal yang tidak terlalu sering (misal: setiap 4 jam, maks 2 artikel/sumber)

4. Simpan dan Test

• Klik 💾 Simpan Semua Pengaturan
• Kembali ke Dashboard → klik 🧪 Uji Rewrite
• Cek hasilnya di Log Artikel dan WordPress Posts

---

Panduan Penggunaan

Dashboard

• Statistik — ringkasan artikel diproses hari ini dan total
• Tombol Run — jalankan manual kapanpun
• 🧪 Mode Uji Coba — test 1 artikel tanpa menunggu jadwal
• Status Sistem — cek jadwal berikutnya dan status rangkuman
• 5 Run Terakhir — riwayat dengan detail

Sumber Berita

• Filter per region — Semua / Sulawesi Utara / Nasional / Global
• 🔍 Test RSS — verifikasi URL sebelum menyimpan
• ⏸ Nonaktifkan — hentikan sementara tanpa hapus

Mode Rewrite vs Rangkuman

• Rewrite: 1 artikel penting → 1 artikel baru lengkap
• Rangkuman: 5+ berita sejenis → 1 artikel kompilasi efisien

---

Pengaturan AI Provider

Anthropic (Claude)

Format key : sk-ant-api03-...

Model	Kualitas	Kecepatan	Biaya
claude-sonnet-4-5	⭐⭐⭐⭐⭐	Sedang	Sedang
claude-opus-4-5	⭐⭐⭐⭐⭐	Lambat	Mahal
claude-haiku-4-5	⭐⭐⭐⭐	Cepat	Murah

OpenAI (GPT)

Format key : sk-...

Model	Kualitas	Kecepatan	Biaya
gpt-4o	⭐⭐⭐⭐⭐	Sedang	Sedang
gpt-4o-mini	⭐⭐⭐⭐	Cepat	Murah
gpt-4-turbo	⭐⭐⭐⭐⭐	Lambat	Mahal

Google Gemini

Format key : AIza...

Model	Kualitas	Kecepatan	Biaya
gemini-1.5-pro	⭐⭐⭐⭐⭐	Sedang	Sedang
gemini-1.5-flash	⭐⭐⭐⭐	Cepat	Murah
gemini-2.0-flash	⭐⭐⭐⭐	Cepat	Murah

---

Sumber Berita Default

29 sumber RSS aktif sejak pertama kali plugin diaktifkan:

🇮🇩 Nasional (20): Antara, Detik, Tempo, CNN Indonesia, CNBC Indonesia, Liputan6, Republika, Media Indonesia, Kontan, Suara.com, Kumparan, Tirto.id, Coconuts Jakarta

🌍 Global (3): Reuters, BBC News, Associated Press

🌴 Sulawesi Utara (6): Tribun Manado, Manado Post, SulutKini, Berita Manado, Manado Today, Poros Manado

---

Kustomisasi Prompt AI

Pengaturan → ✏️ Kustomisasi Prompt AI

Variabel yang bisa digunakan dalam prompt:

Variabel	Tersedia di	Contoh Output
{{BYLINE}}	Rewrite & Rangkuman	ZONAUTARA.com
{{REGION}}	Rangkuman	Sulawesi Utara
{{COUNT}}	Rangkuman	5
{{DATE}}	Rangkuman	27 Maret 2026

Tips: Kosongkan kolom = plugin pakai prompt default. Klik "Reset ke Default" untuk kembali kapanpun.

---

Featured Image

Plugin mengambil foto langsung dari sumber (tidak ada editing):

1. Cek URL foto di RSS feed (tag enclosure atau media:content)
2. Jika tidak ada, ambil og:image dari halaman artikel
3. Download dan upload ke WordPress Media Library
4. Caption otomatis: "Foto: [Nama Media]"

---

Jadwal Otomatis

Tipe	Pilihan
Interval jam	2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 jam
Kali per hari	1, 2, 3, 4, 6, 8, 12 kali
Hari sekali	Setiap 1–7 hari

WP-Cron di shared hosting — tambahkan real cron job di cPanel:

*/30 * * * * wget -q -O /dev/null "https://domain.com/wp-cron.php?doing_wp_cron"

---

Integrasi Facebook

Di Pengaturan → 📘 Facebook Page:

• Isi Page Access Token (Long-Lived, berlaku ~60 hari)
• Isi Facebook Page ID (angka)
• Klik 🔍 Verifikasi Token

Token bisa didapat dari developers.facebook.com → Graph API Explorer.

---

Struktur Database

wp_zonauto_sources — sumber berita RSS

wp_zonauto_articles — log semua artikel yang diproses (deduplikasi via SHA-256)

wp_zonauto_runs — log setiap kali plugin berjalan (rewrite/rangkuman)

---

Struktur File Plugin

zonauto-news/
├── zonauto-news.php                  ← Entry point
├── README.md                         ← Dokumentasi ini
├── CHANGELOG.md                      ← Riwayat versi
├── .gitignore
├── includes/
│   ├── class-database.php            ← Tabel DB & semua query
│   ├── class-default-sources.php     ← 29 sumber RSS default
│   ├── class-rss-fetcher.php         ← Fetch RSS + ekstrak artikel
│   ├── class-content-extractor.php   ← Ekstrak teks & gambar dari web
│   ├── class-ai-rewriter.php         ← Multi AI + post-processing format
│   ├── class-image-generator.php     ← Featured image dari sumber
│   ├── class-wp-publisher.php        ← Post ke WordPress + SEO
│   ├── class-facebook-publisher.php  ← Post ke Facebook
│   └── class-scheduler.php           ← WP-Cron + run logic
└── admin/
    ├── class-admin.php               ← Menu, hooks, AJAX
    ├── css/admin.css
    ├── js/admin.js
    └── views/
        ├── dashboard.php
        ├── sources.php
        ├── settings.php
        └── log.php

---

Pertanyaan Umum (FAQ)

Apakah plugin ini legal? Ya. Menggunakan RSS feed resmi yang disediakan media. Artikel ditulis ulang oleh AI dan selalu ada link ke sumber asli.

Berapa biaya API per bulan? Untuk ~100 artikel/hari: Claude Sonnet ~$60-150/bulan, GPT-4o ~$90-210/bulan, Gemini Flash ~$15-45/bulan.

Sumber berita kosong setelah install? Hapus data lama di phpMyAdmin dulu (lihat bagian Instalasi), lalu reinstall.

Jadwal tidak berjalan tepat waktu? Tambahkan real cron job di cPanel (lihat bagian Jadwal Otomatis).

Bisa dipakai untuk website lain? Ya. Ganti zonauto_byline di Pengaturan dengan nama media Anda. Sesuaikan prompt AI jika perlu.

Artikel terpotong? Pastikan menggunakan prompt default atau menyertakan instruksi "artikel harus lengkap" di prompt kustom.

---

Catatan Etika & Legal

• ✅ RSS feed resmi — bukan scraping ilegal
• ✅ Data angka & kutipan tidak diubah AI
• ✅ Credit sumber dan link ke artikel asli di setiap artikel
• ✅ Caption foto mencantumkan nama media sumber
• ✅ Disclaimer AI otomatis di setiap artikel
• ⚠️ Editor tetap bertanggung jawab — gunakan mode Draft untuk berita sensitif
• ⚠️ Bukan pengganti jurnalis — gunakan sebagai alat bantu dengan pengawasan

---

Changelog

Lihat CHANGELOG.md untuk riwayat lengkap.

Versi terkini: 3.3.1 — byline bold, artikel lengkap, sumber italic+link, 1 focus keyword, max 3 tag, foto dari sumber dengan caption.

---

Dikembangkan untuk ZonAuTara.com — Media Online Sulawesi Utara