DokumentasiGratisv1.2.0

Panduan Penggunaan Statsora

Badge statistik artikel untuk OJS. Tampilkan jumlah views, downloads, dan DOI di halaman artikel dan daftar isi terbitan - tanpa mengubah tema.

1. Apa itu Statsora?

Statsora adalah plugin OJS gratis yang menampilkan badge statistik pada setiap artikel. Badge berisi jumlah Abstract Views, jumlah Downloads, dan link DOI - langsung dibaca dari data statistik OJS tanpa layanan luar.

Contoh tampilan:

116 Views 50 Downloads 10.34306/att.v8i3.680

2. Apa yang terjadi setelah install?

Begitu plugin diaktifkan dan license key dimasukkan:

Kartu statistik langsung muncul di kolom utama halaman artikel
Badge ringkas juga muncul di daftar isi terbitan
Menu Statsora di sidebar admin membuka dasbor (total, artikel teratas, unduh CSV)
Angka dibaca dari statistik OJS: tabel metrics (OJS 3.3) atau metrics_submission (OJS 3.4/3.5)
Angka nol tetap ditampilkan secara default, supaya jurnal baru tetap kelihatan terpasang

3. Pengaturan (Settings)

Buka OJS > Settings > Website > Plugins > Statsora > Settings.

License Key

Tempelkan license key dari dashboard store.publiora.id. Format: PUBL-XXXX-XXXX-XXXX

Statsora gratis, tetapi tetap butuh key untuk mendapatkan update otomatis dan bantuan teknis. Registrasi gratis di Publiora Store.

Tampilan (v1.2.0)

Tampilkan angka nol — default nyala. Matikan jika ingin menyembunyikan 0.
DOI di kartu Statsora — default mati, karena tema biasanya sudah menampilkan DOI.

Tentang license key

Satu key terikat ke satu domain saat pertama kali disimpan
jurnal.ac.id dan www.jurnal.ac.id dihitung dua domain berbeda
Pemindahan domain diizinkan satu kali lewat dashboard Publiora
Key juga mengontrol kuota jurnal - jika OJS multi-jurnal, pastikan key mendukung jumlah jurnal Anda

4. Tampilan badge

Halaman artikel (article detail)

Kartu metrik tampil di kolom utama (setelah abstrak). Dua angka besar dengan label jelas:

Views - jumlah kali halaman abstrak dibuka
Downloads - jumlah unduhan file (PDF/galley)
DOI - opsional, default mati karena tema biasanya sudah menampilkan DOI

Daftar isi terbitan (issue TOC)

Badge tampil dalam format lebih kecil dan ringkas di bawah setiap judul artikel di halaman terbitan. Format sama (views, downloads, DOI) tapi lebih kompak.

Aturan tampil/sembunyi (v1.2.0)

Views dan Downloads tampil termasuk angka 0 (bisa dimatikan di Settings)
DOI di kartu Statsora default mati (tema biasanya sudah menampilkan DOI)
Label mengikuti bahasa jurnal (Dilihat / Diunduh, atau Views / Downloads)

5. Syarat teknis

Komponen	Syarat
OJS	3.3.x, 3.4.x, atau 3.5.x (berkas 3.4 dipakai juga untuk 3.5)
PHP	7.4+ (OJS 3.3) atau 8.1+ (OJS 3.4/3.5), dengan ekstensi `sodium`
Akun OJS	Site Administrator
License key	Gratis dari Publiora Store
Koneksi internet	Server harus bisa menghubungi `store.publiora.id`
Statistik OJS	Harus aktif (sudah default di OJS 3.4+)

6. Troubleshooting

Badge tidak muncul sama sekali

Pastikan plugin Enabled (centang aktif di daftar plugin)
Pastikan license key sudah tersimpan dan valid
Bersihkan folder cache/ lalu muat ulang halaman
Jika install manual: buka Settings > Website > Plugins sekali agar OJS mendaftarkan plugin

Angka Views/Downloads masih 0

Jurnal baru belum punya catatan kunjungan - tunggu sampai ada pembaca
Pastikan pemrosesan statistik OJS berjalan (cron tools/runScheduledTasks.php)
Sejak 1.2.0 angka nol tetap ditampilkan. Kalau kartu tidak muncul sama sekali, cek license key.

DOI tidak tampil

Artikel belum punya DOI - isi DOI di Publication > Identifiers pada artikel tersebut
DOI harus diisi pada level publikasi, bukan submission

License key ditolak

Domain harus sama persis dengan yang terikat pertama kali
Cek koneksi server ke store.publiora.id
Pastikan ekstensi PHP sodium aktif

Plugin tidak muncul di daftar setelah upload

Pastikan menggunakan berkas untuk versi OJS yang tepat (3.3 atau 3.4/3.5)
Cek izin folder plugins/generic/

7. FAQ

Statsora benar-benar gratis?: Ya. Cukup registrasi di Publiora Store untuk mendapatkan license key. Tidak ada biaya, tidak ada trial period, tidak ada fitur yang dikunci.
Kenapa masih perlu license key kalau gratis?: Key digunakan untuk mengirimkan notifikasi update dan memberikan bantuan teknis. Tanpa key, kami tidak tahu siapa yang memakai plugin dan tidak bisa menghubungi Anda saat ada patch penting.
Apakah Statsora menghubungi layanan luar untuk membaca statistik?: Tidak untuk statistik. Angka dibaca dari database OJS. License key dan pemeriksaan pembaruan menghubungi store.publiora.id.
Saya punya beberapa jurnal di satu OJS. Apakah badge muncul di semua?: Badge muncul di jurnal yang plugin-nya diaktifkan dan license key-nya valid. Key memiliki kuota jurnal - pastikan key Anda mendukung jumlah jurnal yang diinginkan.
Apakah perlu cron job tambahan?: Tidak. Statsora membaca data statistik yang sudah dicatat OJS. Pastikan cron job bawaan OJS (tools/runScheduledTasks.php) sudah berjalan.
Apakah badge mempengaruhi kecepatan halaman?: Ringan. Daftar isi terbitan memakai satu kumpulan query untuk semua artikel, bukan dua query per baris. CSS hanya dimuat di halaman artikel dan terbitan.
Apakah data hilang saat update plugin?: Tidak. Statsora hanya membaca data - tidak menyimpan data sendiri. Update aman dilakukan kapan saja. Lihat panduan update.
Apa yang terjadi kalau license key dicabut atau expired?: Badge berhenti tampil. Halaman kembali seperti sebelum plugin dipasang. Tidak ada data jurnal yang diubah atau dihapus.

Ada pertanyaan lain? Buat tiket bantuan dan kami akan bantu.

Lihat changelog lengkap