=== Doojoq Stats ===
Contributors: doojoq
Tags: karate, dojo, statistik, elementor, widget, shortcode, atlit, perguruan
Requires at least: 5.8
Tested up to: 6.5
Stable tag: 2.1.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Tampilkan statistik, daftar atlit, ranking atlit, dan pelatih perguruan karate di WordPress. Mendukung Elementor.

== Description ==

**Doojoq Stats** menghubungkan website WordPress Anda dengan platform manajemen dojo Doojoq.

= Fitur Utama =

* **4 Widget Elementor** baru yang dapat di-drag ke halaman
* **4 Shortcode** siap pakai
* **Daftar Atlit** — tampilkan semua atlit aktif dengan foto, sabuk, dan disiplin *(Baru di v2)*
* **Ranking Atlit** — ranking berdasarkan skor prestasi kejuaraan *(Baru di v2)*
* **Statistik Perguruan** — total karateka, dojo aktif, pelatih, dan atlit
* **Data Pelatih** — daftar pelatih publik dengan grid yang rapi
* **Filter wilayah Indonesia dan internasional** — negara, state/provinsi, kota, serta province/regency ID Indonesia
* **Tema Terang & Gelap**
* **Cache otomatis** 5 menit via WordPress transients
* **Responsif** — tampil baik di mobile, tablet, dan desktop

= Shortcode =

`[doojoq_stats]` — Statistik perguruan
`[doojoq_athletes]` — Daftar atlit aktif
`[doojoq_athlete_rankings]` — Ranking atlit terbaik
`[doojoq_coaches]` — Daftar pelatih

Filter lokasi internasional menggunakan `country_code`, `state_province_name`, dan `city_name`:

	[doojoq_stats id="46" country_code="JP" state_province_name="Tokyo" city_name="Shibuya"]

Filter Indonesia lama tetap didukung:

	[doojoq_stats id="46" country_code="ID" province_id="32" regency_id="3273"]

= Widget Elementor =

* Doojoq Stats
* Doojoq Daftar Atlit *(Baru)*
* Doojoq Ranking Atlit *(Baru)*
* Doojoq Pelatih

== Installation ==

1. Upload file `doojoq-stats.zip` ke menu Plugins → Add New → Upload Plugin
2. Klik "Install Now" lalu "Activate Plugin"
3. Buka Settings → Doojoq Stats
4. Masukkan **ID Perguruan** Anda (temukan di URL halaman publik)
5. Gunakan shortcode atau widget Elementor

== Changelog ==

= 2.1.0 =
* NEW: Filter lokasi global untuk statistik, atlet, ranking, dan pelatih.
* NEW: Elementor widgets menerima country, state/province, dan city filters.
* IMPROVED: Tetap mendukung province_id/regency_id untuk data Indonesia.

= 2.0.0 =
* NEW: Widget & shortcode Daftar Atlit (`[doojoq_athletes]`)
* NEW: Widget & shortcode Ranking Atlit (`[doojoq_athlete_rankings]`)
* NEW: Endpoint `/athletes-list` — daftar atlit terurut sabuk
* NEW: Endpoint `/athlete-rankings` — ranking berdasarkan prestasi
* NEW: Parameter `show_atlit` pada widget Stats
* IMPROVED: Tampilan belt badge berwarna sesuai warna sabuk asli
* IMPROVED: Foto atlit dengan fallback avatar inisial
* IMPROVED: Admin settings page: tabel shortcode lengkap & test koneksi

= 1.0.0 =
* Rilis awal: widget stats & pelatih

== Frequently Asked Questions ==

= Dari mana saya mendapatkan ID Perguruan? =
Buka halaman publik perguruan Anda, ID ada di URL. Contoh: `doojoq.com/perguruan/46` → ID = **46**.

= Apakah perlu Elementor? =
Tidak wajib. Plugin tetap berfungsi via shortcode tanpa Elementor.

= Data diperbarui seberapa sering? =
Data di-cache 5 menit. Setiap 5 menit sekali akan diambil dari server Doojoq.

= Apakah data atlit aman? =
Ya. API hanya mengekspos nama, sabuk, dojo, dan disiplin. Tidak ada data pribadi (NIK, alamat, kontak) yang diekspos.
