Docs

Panduan Penggunaan Plugin Flight Schedules Connector (FSC)

✈️ Apa itu FSC?

FSC adalah plugin WordPress untuk menampilkan jadwal penerbangan real-time (kedatangan & keberangkatan).
Cocok untuk:

  • Website bandara
  • Travel agent
  • Website informasi kota/pariwisata

🛠️ Cara Instalasi

  1. Login ke WordPress Admin
  2. Masuk ke menu Plugins > Add New > Upload Plugin
  3. Pilih file flight-schedules-connector.zip
  4. Klik Install Now → lalu Activate
  5. Setelah aktif, muncul menu Flight Schedules di sidebar admin

Dependencies

  • PHP ≥ 7.4
  • WordPress ≥ 5.8
  • API key dari provider (jika menggunakan data live)

⚙️ Pengaturan Awal

  1. Masuk ke menu Flight Schedules > Settings
  2. Pilih Provider Data (misalnya: OpenSky, AviationStack, dll)
  3. Masukkan API Key jika provider membutuhkannya
  4. Atur opsi lain:
    • Cache Time → untuk mempercepat loading
    • Theme → pilih Light/Dark
    • Fullscreen Mode → aktifkan bila ingin tampilan seperti layar FIDS di bandara
  5. Klik Save Changes

💡 Jika tidak punya API key, aktifkan opsi Demo Mode untuk melihat contoh data.

🖥️ Menampilkan Jadwal di Website

Ada 2 cara:

Cara 1: Dengan Shortcode

  • Tambahkan shortcode ke halaman/post:
    • [fsc_board airport="CGK" type="arrivals" theme="dark"]
  • Sesuaikan:
    • airport="CGK" → kode bandara (misal: CGK = Soekarno-Hatta)
    • type="arrivals" → arrivals (kedatangan), departures (keberangkatan), atau both
    • theme="dark" → bisa diganti light

Cara 2: Dengan Generator

  1. Masuk ke menu Flight Schedules > Shortcodes & Generator
  2. Pilih Bandara, Jenis Jadwal, Tema
  3. Klik Generate Shortcode
  4. Copy shortcode → paste ke halaman/post

📖 Penjelasan Tab Settings – Flight Schedules Connector (FSC)

1. 🛫 General

Tab untuk pengaturan dasar jadwal penerbangan.

  • Default Airport → kode bandara utama yang akan dipakai jika shortcode tidak menyebutkan airport. (misalnya CGK = Soekarno-Hatta Jakarta)

  • Default Direction → arah jadwal default:

    • Arrivals (kedatangan)
    • Departures (keberangkatan)
    • Both (keduanya)

  • Timezone Mode → mode zona waktu yang dipakai untuk menampilkan jam penerbangan:

    • Airport timezone → ikuti zona waktu bandara
    • Site timezone → ikuti pengaturan WordPress

  • Cache TTL (seconds) → lama waktu data API disimpan (detik). Misalnya 60 berarti data disimpan 1 menit sebelum di-refresh lagi.

2. 🔌 Connector

Tab untuk memilih sumber data (API provider).

  • Provider → pilih sumber data: None, OpenSky, AviationStack, AeroDataBox, FlightAware, atau Custom.
  • API Key → masukkan kunci API (jika provider memerlukan).
  • API Endpoint → isi jika menggunakan Custom API.

👉 Jika tidak punya API, pilih None lalu aktifkan Demo Mode.

3. 📊 Data

Tab ini biasanya dipakai untuk data tambahan & seed airports.

  • Seed Airports → daftar bandara bawaan (plugin sudah include file seed-airports.json).
  • Bisa dipakai untuk memilih airport favorit atau default list saat generate shortcode.
  • Admin bisa menambahkan custom airport bila perlu.

4. 🎨 Themes

Tab untuk mengatur tampilan board.

  • Theme Style → pilih Light atau Dark.
  • Fullscreen Mode → aktifkan agar tampil memenuhi layar (seperti FIDS di bandara).
  • Font & Layout Options → beberapa versi plugin juga memberi opsi ukuran font, jarak baris, dsb.

5. 🧩 Modules

Tab ini berisi fitur tambahan yang bisa diaktifkan/nonaktifkan.

Contoh modul (sesuai roadmap plugin):

  • Auto Refresh → board update otomatis tiap X detik.
  • Search & Filter → menambahkan kolom pencarian (mis. filter maskapai atau nomor penerbangan).
  • Infinite Scroll / Paging → load data lebih banyak.
  • Demo Data → tampilkan contoh jadwal.

6. 🎨 Status Colors

Tab untuk mengatur warna status penerbangan.

  • On Time → misalnya hijau
  • Delayed → kuning/oranye
  • Canceled → merah
  • Boarding / Landed → bisa custom sesuai kebutuhan

👉 Tujuannya agar lebih jelas secara visual bagi pengunjung.

7. 🔑 License

Tab untuk aktivasi lisensi Envato/CodeCanyon (jika plugin dijual resmi).

  • Purchase Code → masukkan kode pembelian
  • Check License → validasi ke server Envato
  • Auto Update → jika lisensi valid, plugin bisa update otomatis

📝 Ringkasan Sederhana untuk User Non-Teknis

  • General → atur default airport, arah, timezone, cache
  • Connector → pilih provider API & masukkan API key
  • Data → kelola daftar bandara bawaan
  • Themes → pilih tema tampilan (light/dark/fullscreen)
  • Modules → aktifkan fitur tambahan (auto refresh, search, dll)
  • Status Colors → ubah warna status penerbangan
  • License → aktivasi kode pembelian & update otomatis

👀 Contoh Tampilan

  • Light Theme
    (Latar putih, teks gelap, cocok untuk website biasa)

  • Dark Theme (Fullscreen)
    (Latar hitam seperti papan FIDS di bandara)

📖 Panduan Shortcodes & Generator – Flight Schedules Connector (FSC)

Halaman ini dipakai untuk membuat shortcode otomatis tanpa harus menulis manual.
User hanya perlu memilih opsi → lihat hasil di Live Preview → copy shortcode ke halaman/post.

🛠️ Bagian Generator (kiri)

1. Airport

Masukkan kode bandara (IATA/ICAO).
Contoh:

  • CGK = Soekarno-Hatta Jakarta
  • DPS = Ngurah Rai Bali

👉 Jika kosong, akan pakai Default Airport dari tab Settings.

2. Template

Pilih gaya tampilan jadwal:

  • Table → bentuk tabel klasik (seperti papan FIDS)
  • List → daftar vertikal
  • Cards → setiap penerbangan tampil dalam kartu
  • Compact → tampilan ringkas, hemat ruang
  • Mobile Card / Panel → khusus untuk tampilan ponsel

3. Display From/To As

Pilih bagaimana rute bandara ditampilkan:

  • Code (IATA/ICAO) → contoh: CGK – SIN
  • Full Name → contoh: Soekarno-Hatta → Changi
  • City Name → contoh: Jakarta → Singapore

4. Direction

Tentukan jenis jadwal:

  • Arrivals → kedatangan
  • Departures → keberangkatan
  • Both → tampilkan keduanya

5. Theme

Pilih tema tampilan:

  • Light → latar putih (cocok untuk website biasa)
  • Dark → latar hitam (mirip papan bandara)

6. Timezone Mode

Pilih cara menampilkan waktu penerbangan:

  • Airport timezone → sesuai zona waktu bandara
  • Site timezone → sesuai pengaturan WordPress

7. Auto refresh (s)

Berapa detik sekali data otomatis diperbarui.

  • 0 = tidak auto-refresh
  • 30 = refresh setiap 30 detik

👉 Berguna untuk layar TV/monitor publik.

8. Page size

Jumlah baris penerbangan yang ditampilkan per halaman.
Contoh:

  • 25 → tampil 25 flight per halaman
  • Bisa kombinasikan dengan infinite scroll/pagination

9. Options

Beberapa fitur tambahan:

  • Show Fullscreen button → tampilkan tombol fullscreen di board
  • Start in Fullscreen → board langsung terbuka fullscreen
  • Show search → tampilkan kolom pencarian/filter

10. Custom CSS class

Untuk user/developer yang ingin menambahkan class CSS sendiri agar bisa custom styling.
Contoh: fsc-custom-blue

👀 Bagian Live Preview (kanan)

  • Menampilkan hasil jadwal sesuai setting di kiri.
  • Bisa dilihat langsung tanpa perlu reload halaman WordPress.
  • Jika cocok, tinggal klik tombol Generate Shortcode (biasanya di bawah form).
  • Copy hasil shortcode → paste ke halaman/post.

🚀 Cara Menggunakan Shortcodes & Generator

  1. Buka menu Flight Schedules > Shortcodes & Generator
  2. Pilih Airport, Template, Direction, Theme, dll.
  3. Lihat hasil di Live Preview
  4. Jika sudah sesuai → klik Generate Shortcode
  5. Copy kode shortcode → paste ke halaman/post/widget
  6. Klik Update/Publish → jadwal penerbangan tampil di website

📌 Contoh Shortcode yang Dihasilkan

[fsc_board airport="CGK" type="both" theme="dark" template="table" auto_refresh="30" page_size="25" fullscreen="true" search="true"]

👉 Shortcode di atas akan menampilkan:

  • Bandara CGK
  • Kedatangan & keberangkatan
  • Tema Dark
  • Tampilan Table
  • Auto refresh 30 detik
  • 25 flight per halaman
  • Ada tombol fullscreen + kolom search

📑 Cheat Sheet – Shortcodes & Generator (FSC)

Fitur Fungsi Contoh Pengaturan
Airport Tentukan bandara asal data jadwal. CGK = Soekarno-Hatta Jakarta
DPS = Ngurah Rai Bali
Template Pilih gaya tampilan jadwal. Table = tabel klasik
Cards = tampilan kartu
Compact = versi ringkas
Display From/To As Tentukan format rute bandara. Code = CGK → SIN
Full Name = Soekarno-Hatta → Changi
City Name = Jakarta → Singapore
Direction Pilih arah jadwal. Arrivals = kedatangan
Departures = keberangkatan
Both = keduanya
Theme Pilih tema tampilan. Light = latar putih
Dark = latar hitam (FIDS style)
Timezone Mode Tentukan zona waktu yang dipakai. Airport timezone = sesuai bandara
Site timezone = sesuai WordPress
Auto Refresh (s) Atur jeda pembaruan otomatis. 0 = tidak refresh
30 = refresh tiap 30 detik
Page Size Jumlah penerbangan per halaman. 25 flight per halaman
Options Aktifkan fitur tambahan. ✅ Show Fullscreen button
✅ Start in Fullscreen
✅ Show Search
Custom CSS class Tambahkan class CSS untuk styling khusus. fsc-custom-blue → jadwal dengan tema biru custom

❓ FAQ – Flight Schedules Connector (FSC)

🔧 Instalasi & Aktivasi

Q: Bagaimana cara menginstal plugin FSC?
👉 Masuk ke WordPress Admin > Plugins > Add New > Upload Plugin → pilih file .zip plugin → klik Install Now → Activate.

Q: Apakah FSC bisa dipakai di semua versi WordPress?
👉 Minimal WordPress 5.8 dan PHP 7.4. Disarankan pakai versi terbaru agar lebih stabil.

Q: Apakah plugin ini mendukung multisite?
👉 Ya, FSC bisa dipakai di WordPress Multisite.

📡 Data & Provider

Q: Dari mana data jadwal penerbangan diambil?
👉 FSC mendukung beberapa provider:

Q: Apakah saya butuh API Key?
👉 Ya, untuk sebagian besar provider (kecuali Demo Mode atau OpenSky gratis).

Q: Kalau saya tidak punya API Key, apa masih bisa dipakai?
👉 Bisa. Aktifkan Demo Mode (Connector = None + Demo Data ON) → plugin akan menampilkan jadwal contoh (sample flights).

⚙️ Pengaturan

Q: Apa fungsi tab General di Settings?
👉 Mengatur default bandara, arah jadwal (Arrivals/Departures), timezone, dan cache.

Q: Bagaimana cara mengganti warna status (On Time, Delayed, dll.)?
👉 Masuk ke Settings > Status Colors → pilih warna sesuai kebutuhan.

Q: Bagaimana cara menampilkan jadwal lebih dari satu bandara?
👉 Gunakan beberapa shortcode dengan airport="XXX" berbeda di halaman yang sama atau berbeda.

Q: Bagaimana agar waktu penerbangan sesuai dengan waktu lokal bandara?
👉 Pilih Timezone Mode = Airport timezone di Settings atau Generator.

🖥️ Shortcode & Generator

Q: Bagaimana cara membuat shortcode dengan mudah?
👉 Masuk ke menu FSC > Shortcodes & Generator → pilih bandara, arah, tema, dll. → lihat hasil di Live Preview → klik Generate Shortcode → copy ke halaman/post.

Q: Apa perbedaan Template Table, List, Cards, Compact, Panel?
👉 Itu adalah pilihan gaya tampilan jadwal. Table mirip papan bandara klasik, Cards lebih modern, Compact hemat ruang, Panel cocok untuk mobile.

Q: Bagaimana cara menampilkan tombol fullscreen di jadwal?
👉 Centang opsi Show Fullscreen Button di Generator.

Q: Bisa tidak menambahkan kolom pencarian di jadwal?
👉 Ya, aktifkan Show Search di Generator.

⚡ Performa

Q: Apa fungsi Cache TTL?
👉 Menentukan berapa lama data API disimpan sebelum di-refresh. Misalnya 60 detik berarti data baru diambil dari API setelah 1 menit.

Q: Bagaimana cara agar jadwal selalu update otomatis?
👉 Atur Auto Refresh (detik) di Generator, misalnya 30 → board akan refresh tiap 30 detik.

Q: Kenapa data tidak muncul padahal sudah isi API key?
👉 Cek:

  1. API Key valid dan aktif
  2. Kuota API belum habis (beberapa provider ada limit harian)
  3. Pastikan permalink WordPress tidak Plain (harus Post name/Pretty permalink)

🎨 Tampilan

Q: Bagaimana cara mengubah tema tampilan?
👉 Masuk ke Settings > Themes atau atur lewat Generator (Light / Dark).

Q: Bisa tampil fullscreen otomatis (misalnya di layar TV bandara)?
👉 Ya, centang opsi Start in Fullscreen di Generator.

Q: Bisa menambahkan style khusus sesuai branding website?
👉 Bisa. Gunakan kolom Custom CSS class di Generator untuk menambahkan class CSS sendiri.

🔑 Lisensi & Update

Q: Bagaimana cara aktivasi plugin setelah beli?
👉 Masuk ke Settings > License → masukkan Purchase Code dari Envato/CodeCanyon.

Q: Apakah plugin bisa auto-update?
👉 Ya, jika lisensi sudah valid, update otomatis tersedia dari dashboard WordPress.

Q: Bagaimana kalau lisensi expired?
👉 Plugin tetap jalan, tapi tidak bisa update otomatis & tidak dapat support resmi.

🧪 Troubleshooting

Q: Jadwal tidak tampil, hanya kosong?
👉 Cek provider & API key. Jika tetap kosong, coba aktifkan Demo Mode untuk memastikan plugin bekerja.

Q: Preview di Generator gagal (No REST/AJAX available)?
👉 Pastikan permalink WordPress tidak Plain dan endpoint /wp-json/ bisa diakses.

Q: Kenapa status penerbangan ada yang tidak sesuai?
👉 Data sepenuhnya berasal dari provider API, plugin hanya menampilkan.

Q: Bisa dipakai untuk jadwal kereta / kapal juga?
👉 Secara default hanya penerbangan. Tapi jika punya Custom API dengan format mirip, bisa diintegrasikan.

🎯 Fitur Utama

✅ Support banyak provider API
✅ Pilihan tema (Light/Dark/Fullscreen)
✅ Auto Refresh & Search Filter
✅ Generator shortcode tanpa coding
✅ Demo Mode (untuk test tanpa API)

🚀 Siap Dipakai!

Setelah mengikuti langkah di atas, website kamu akan menampilkan jadwal penerbangan langsung dengan tampilan profesional.

No related posts.