DokumentasiGratisv1.3.2

Panduan Penggunaan Statsora

Panduan ini ditulis untuk siapa saja yang mengurus jurnal. Statsora menampilkan jumlah pembaca dan unduhan di halaman artikel, dan sejak versi 1.3 juga memberi tahu berapa persen artikel terbit Anda yang belum pernah dibuka siapa pun.

Yang baru sejak v1.3

Kalau Anda mengenal Statsora sebagai plugin yang hanya menempelkan angka di halaman artikel, bagian yang berubah ada di dasbor editor. Isinya sekarang bukan lagi sekadar total.

+ Persentase artikel terbit yang sudah dikunjungi dan yang belum (1.3.0)
+ Sepuluh artikel paling sepi, selain sepuluh yang paling ramai (1.3.0)
+ Saringan 30, 90, dan 180 hari (1.3.0)
+ Grafik pembaca dan unduhan mengikuti periode yang dipilih (1.3.0)
+ Cari artikel dari judulnya (1.3.0)
+ Unduhan spreadsheet mengikuti saringan waktu yang aktif (1.3.0)
+ Kartu metrik artikel lebih ringkas, dengan ikon dilihat dan diunduh (1.2.2)
+ Tombol pembaruan di dasbor (1.2.1)
~ Dasbor lebih rapi di layar lebar dan di ponsel (1.3.1)
~ Lisensi diperbarui sendiri, kartu statistik tidak lagi hilang setelah seminggu (1.3.2)
~ Akses lewat www atau tanpa www tidak lagi mematikan kartu statistik (1.3.2)
~ Pembaruan dari dasbor hanya untuk Site Administrator (1.3.2)

Kartu statistik Anda hilang setelah beberapa hari? Itu masalah di versi 1.3.1 ke bawah: lisensinya hanya diperbarui saat Settings disimpan. Perbarui ke 1.3.2 dari dasbor Statsora (masuk sebagai Site Administrator) atau unggah ulang paketnya. Setelah itu tidak ada lagi yang perlu disimpan ulang.

Rincian tiap versi ada di halaman changelog.

1. Apa itu Statsora

Buka halaman artikel di jurnal Anda. Pengunjung melihat judul, penulis, dan abstrak. Yang tidak mereka lihat: sudah berapa orang membaca artikel itu, dan berapa yang mengunduh berkasnya.

Statsora mengerjakan dua hal. Pertama, menampilkan angka itu di halaman artikel dan di daftar isi terbitan, supaya pembaca melihatnya tanpa perlu bertanya. Kedua, memberi editor satu dasbor untuk melihat gambaran seluruh jurnal, termasuk artikel mana yang belum pernah dibuka siapa pun.

Contoh tampilan di halaman artikel:

116 Dilihat 50 Diunduh 10.34306/att.v8i3.680

Label mengikuti bahasa jurnal, jadi jurnal berbahasa Inggris menampilkan Views dan Downloads.

2. Angkanya dari mana

Ini yang paling sering ditanya, dan jawabannya membuat sisa panduan ini lebih mudah dipahami: angkanya sudah ada di jurnal Anda sendiri. OJS mencatat setiap kunjungan halaman abstrak dan setiap unduhan berkas sejak hari pertama, hanya saja tidak menampilkannya. Statsora membacanya dari catatan itu.

Konsekuensinya ada tiga, dan semuanya menguntungkan Anda:

1. Tidak ada data yang keluar dari server Anda. Statsora tidak mengirim judul, angka, atau identitas pembaca ke layanan mana pun. Ini sering jadi syarat kebijakan kampus.
2. Riwayat lama langsung terpakai. Begitu dipasang, angka yang muncul bukan mulai dari nol, melainkan seluruh catatan yang sudah OJS kumpulkan selama ini.
3. Statsora tidak menyimpan data sendiri. Ia hanya membaca, jadi memperbarui atau melepas plugin tidak pernah menghilangkan angka apa pun.

Satu syarat yang perlu dipastikan: pemrosesan statistik bawaan OJS harus berjalan. Di OJS 3.4 dan 3.5 ini sudah menyala sendiri. Kalau di jurnal Anda tugas terjadwal OJS tidak pernah dijalankan, catatan kunjungannya tidak pernah diproses, dan yang Statsora tampilkan akan terus nol. Itu bukan plugin yang rusak, melainkan pencatatan OJS yang belum jalan.

3. Mulai dari sini

Empat langkah, sekitar lima menit. Tidak ada yang perlu disiapkan di server dan tema jurnal tidak disentuh.

Langkah 1. Ambil key gratis
Statsora gratis, tetapi tetap memakai license key. Daftar di Publiora Store, lalu ambil key Statsora dari dashboard lisensi. Tidak ada pembayaran dan tidak ada masa percobaan.
Langkah 2. Pasang plugin
Unduh berkas yang sesuai versi OJS Anda dari dashboard, lalu buka OJS: Settings > Website > Plugins > Upload A New Plugin. Aktifkan centangnya.
Langkah 3. Tempel license key
Buka Settings pada baris Statsora, tempel key-nya, lalu simpan. Ini satu-satunya kolom yang wajib diisi.
Langkah 4. Lihat hasilnya, tidak perlu menekan apa pun
Berbeda dari sebagian plugin lain, Statsora tidak perlu proses pengambilan data. Angkanya sudah ada di OJS, jadi begitu key tersimpan, kartunya langsung muncul di halaman artikel dan menu Statsora di sisi kiri OJS langsung berisi dasbornya.

4. Pengaturan, satu per satu

Semua ada di Settings > Website > Plugins > Statsora > Settings. Isinya sengaja sedikit.

License Key wajib

Tempelkan key dari dashboard lisensi. Bentuknya seperti PUBL-XXXX-XXXX-XXXX.

Kenapa yang gratis tetap butuh key? Karena itu satu-satunya cara kami tahu siapa yang memakai Statsora, sehingga pemberitahuan pembaruan dan bantuan teknis bisa sampai ke Anda. Tanpa key, kami tidak punya jalan menghubungi Anda kalau ada perbaikan penting.

Tampilkan angka nol

Bawaannya nyala, dan sebaiknya dibiarkan nyala. Artikel yang belum pernah dibuka tetap menampilkan angka 0, bukan menyembunyikan kartunya. Alasannya praktis: kartu yang hilang membuat halaman terlihat seperti plugin tidak bekerja, sedangkan angka 0 jujur dan tetap menunjukkan jurnal Anda terpasang rapi. Matikan hanya kalau Anda memang tidak ingin angka nol terlihat pembaca.

DOI di kartu Statsora

Bawaannya mati, karena hampir semua tema jurnal sudah menampilkan DOI sendiri, dan menampilkannya dua kali justru terlihat berantakan. Nyalakan kalau tema jurnal Anda tidak menampilkan DOI. Kalau dinyalakan, DOI-nya tampil sebagai tautan yang bisa diklik.

Tentang license key

Satu key terikat ke satu domain saat pertama kali disimpan, yaitu alamat jurnal di pengaturan OJS
jurnal.ac.id dan www.jurnal.ac.id dianggap satu alamat; pengunjung yang datang lewat salah satunya tetap melihat angka
Lisensi diperbarui sendiri sekali sehari. Kalau server sedang tidak bisa menghubungi Publiora, angkanya tetap tampil sampai seminggu
Pemindahan domain diizinkan satu kali lewat dashboard Publiora
Key berlaku untuk semua jurnal di domain itu, termasuk OJS multi-jurnal
Butuh domain lain? Ambil key gratis lagi, tidak dibatasi

5. Yang tampil di halaman jurnal

Dua tempat, keduanya muncul sendiri tanpa perlu diatur dan tanpa mengubah tema.

Di halaman tiap artikel

Kartu metrik tampil di kolom utama, setelah abstrak. Sejak versi 1.2.2 bentuknya lebih ringkas dan tiap angka punya ikonnya sendiri, jadi terbaca sekilas tanpa perlu membaca labelnya.

• Dilihat, yaitu berapa kali halaman abstrak artikel itu dibuka
• Diunduh, yaitu berapa kali berkasnya diunduh, biasanya PDF
• DOI, pilihan, bawaannya mati karena tema biasanya sudah menampilkannya

Di daftar isi terbitan

Angka yang sama tampil dalam bentuk lebih kecil di bawah setiap judul artikel, jadi pembaca yang sedang memilih artikel bisa langsung melihat mana yang paling banyak dibaca tanpa membuka satu per satu.

Halaman ini tetap ringan: angka untuk semua artikel diambil sekali untuk seluruh halaman, bukan berulang untuk setiap baris.

6. Dasbor editor v1.3

Buka menu Statsora di sisi kiri OJS. Ini halaman yang paling banyak berubah di versi 1.3, dan yang isinya tidak bisa dilihat dari halaman artikel mana pun.

Saringan periode

Di atas halaman ada pilihan 30, 90, atau 180 hari terakhir. Semua yang ada di bawahnya ikut menyesuaikan: totalnya, grafiknya, daftar artikelnya, dan berkas unduhannya. Berguna saat Anda ingin tahu kondisi satu semester terakhir saja, bukan sejak jurnal berdiri.

Grafik pembaca dan unduhan

Grafik yang menunjukkan naik turunnya jumlah pembaca dan unduhan sepanjang periode yang dipilih. Ini yang memperlihatkan efek sebuah tindakan: kalau Anda membagikan terbitan baru ke media sosial atau milis, kenaikannya terlihat di grafik ini.

Sepuluh paling ramai dan sepuluh paling sepi

Dua daftar berdampingan. Yang paling ramai enak dilihat dan berguna untuk laporan. Yang paling sepi adalah yang benar-benar bisa Anda tindak lanjuti, dan penjelasannya ada di bagian 7.

Cari artikel dari judulnya

Kalau Anda hanya ingin memeriksa satu artikel, misalnya karena penulisnya bertanya, ketik sebagian judulnya di kolom pencarian. Tidak perlu menggulir daftar atau membuka halaman artikelnya.

Unduh untuk dilampirkan

Isi dasbor bisa diunduh sebagai berkas spreadsheet yang bisa dibuka di Excel. Sejak versi 1.3 unduhannya mengikuti saringan waktu yang sedang aktif, jadi kalau Anda memilih 90 hari, yang terunduh adalah 90 hari itu dan tidak perlu dipangkas lagi.

Pembaruan dari dalam dasbor

Kalau ada versi baru, pemberitahuannya muncul di dasbor beserta tombol untuk memperbarui langsung dari situ. Anda tidak perlu mengunduh dan mengunggah berkasnya manual. Versi yang sedang terpasang juga tertulis di dasbor dan di halaman Settings.

Sejak versi 1.3.2 tombol ini hanya tampil untuk Site Administrator, karena pembaruan mengganti berkas plugin untuk semua jurnal di OJS itu. Journal Manager tetap bisa membuka dasbor dan mengunduh spreadsheet. Paket yang tidak bisa diverifikasi ditolak, dan versi lama tetap terpasang.

Dasbor ini per jurnal. Kalau satu OJS Anda menampung beberapa jurnal, tiap jurnal punya dasbor dan angkanya sendiri, dan satu key yang sama berlaku untuk semuanya.

7. Cakupan pembaca dan artikel sepi v1.3

Bagian ini layak dibaca terpisah, karena ini pertanyaan yang tidak bisa dijawab angka per artikel.

Berapa persen artikel Anda yang sudah pernah dibuka

Dasbor menghitung dari seluruh artikel yang sudah terbit: berapa persen yang sudah pernah dikunjungi, dan berapa persen yang belum sama sekali. Satu angka, dan biasanya angka itu mengejutkan pengelola jurnal yang pertama kali melihatnya.

Kenapa ini penting: total pembaca jurnal bisa terlihat besar padahal berasal dari beberapa artikel saja, sementara sisanya diam. Total tidak memperlihatkan itu, persentase cakupan memperlihatkannya.

Sepuluh artikel paling sepi

Daftar artikel terbit dengan pembaca paling sedikit. Ini bukan daftar artikel buruk. Artikel yang tidak pernah dibuka hampir selalu bukan soal mutu, melainkan soal tidak ada yang tahu artikel itu ada.

Yang bisa Anda lakukan setelah melihatnya:

Bagikan ulang artikelnya, karena banyak artikel sepi hanya terbit tanpa pernah diumumkan
Periksa judul dan kata kuncinya, karena judul yang tidak menyebut kata yang dicari orang membuat artikel tidak pernah muncul di pencarian
Beri tahu penulisnya, karena penulis biasanya punya jaringan sendiri dan mau membagikan begitu tahu artikelnya sepi
Pakai sebagai bahan rapat editorial, untuk melihat apakah ada tema tertentu yang selalu sepi

Yang perlu jujur disebut: Statsora menampilkan dan melaporkan angka, tidak menaikkannya. Artikel yang sepi tidak jadi ramai karena plugin ini dipasang. Yang berubah adalah Anda jadi tahu artikel mana yang perlu diurus, dan itu yang menentukan hasilnya.

8. 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` untuk lisensi dan pembaruan
Statistik OJS	Pemrosesan statistik bawaan OJS harus berjalan (sudah menyala sendiri di OJS 3.4+)

Tidak ada tugas terjadwal tambahan yang perlu Anda siapkan, dan tidak ada tabel baru yang dibuat di database jurnal Anda.

9. Kalau ada yang tidak muncul

Kartunya tidak muncul sama sekali di halaman artikel

Pastikan centang plugin sudah aktif di daftar Plugins
Pastikan license key sudah tersimpan dan sah
Kalau masih memakai versi 1.3.1 ke bawah dan kartunya hilang setelah beberapa hari, perbarui ke 1.3.2. Di versi lama lisensi hanya diperbarui saat Settings disimpan
Pastikan server bisa menghubungi store.publiora.id, karena lisensi diperbarui dari sana sekali sehari
Bersihkan folder cache/ lalu muat ulang halamannya
Kalau dipasang manual lewat berkas, buka sekali Settings > Website > Plugins supaya OJS mendaftarkan pluginnya

Angkanya muncul tapi terus nol

Untuk jurnal yang baru terbit, memang belum ada catatan kunjungan. Tunggu sampai ada pembaca.
Untuk jurnal lama yang seharusnya punya pembaca, kemungkinan besar pemrosesan statistik bawaan OJS tidak pernah berjalan. Ini penyebab paling sering, dan letaknya di pengaturan OJS atau server, bukan di Statsora.
Kartu yang tetap tampil dengan angka 0 adalah perilaku yang benar sejak versi 1.2.0, bukan tanda kerusakan.

Persentase cakupan terasa terlalu rendah

Periksa dulu saringan periodenya. Pada 30 hari, artikel lama yang pembacanya datang tahun lalu memang terhitung belum dikunjungi pada periode itu.
Kalau pada periode terpanjang pun tetap rendah, itu bukan kesalahan hitung, melainkan temuan. Bagian 7 menjelaskan apa yang bisa dikerjakan.

DOI tidak tampil

Pengaturan DOI di kartu Statsora bawaannya mati. Nyalakan dulu di Settings.
Artikelnya mungkin belum punya DOI. Isi di Publication > Identifiers pada artikel itu.
DOI harus diisi pada level publikasi, bukan pada submission.

License key ditolak

Domainnya harus sama dengan yang terikat pertama kali. Sejak 1.3.2 versi www dan tanpa www dianggap sama, tetapi subdomain lain tetap dihitung berbeda
Pastikan server bisa menghubungi store.publiora.id
Pastikan ekstensi PHP sodium aktif

Plugin tidak muncul di daftar setelah diunggah

Pastikan berkas yang diunggah sesuai versi OJS Anda, 3.3 atau 3.4/3.5
Cek izin tulis folder plugins/generic/

10. Pertanyaan yang sering muncul

Statsora benar-benar gratis?: Ya. Cukup registrasi di Publiora Store untuk mendapatkan license key. Tidak ada biaya, tidak ada masa percobaan, dan tidak ada fitur yang dikunci. Dasbor versi 1.3 juga ikut gratis.
Kenapa masih perlu license key kalau gratis?: Key dipakai untuk mengirim pemberitahuan pembaruan dan memberi bantuan teknis. Tanpa key, kami tidak tahu siapa yang memakai plugin dan tidak punya jalan menghubungi Anda saat ada perbaikan penting.
Apakah Statsora mengirim data jurnal saya ke luar?: Tidak untuk angka statistiknya. Semuanya dibaca dari database OJS Anda sendiri dan tidak pernah dikirim ke mana pun. Yang menghubungi store.publiora.id hanya pemeriksaan lisensi dan pemeriksaan versi baru.
Angkanya mulai dari nol setelah dipasang, atau memakai riwayat lama?: Memakai riwayat lama. Karena angkanya dibaca dari catatan OJS yang sudah ada, artikel yang terbit tahun lalu langsung menampilkan seluruh pembacanya sejak dulu, bukan mulai dari hari plugin dipasang.
Apa bedanya dasbor Statsora dengan statistik bawaan OJS?: Sumber angkanya sama. Bedanya pada pertanyaan yang dijawab. Statistik bawaan OJS bagus untuk menelusuri satu artikel atau satu rentang tanggal. Dasbor Statsora menjawab pertanyaan tingkat jurnal yang tidak disediakan di sana, terutama berapa persen artikel terbit Anda yang belum pernah dibuka dan artikel mana saja yang paling sepi.
Saya punya beberapa jurnal di satu OJS. Apakah tampil di semua?: Ya. Satu key berlaku untuk semua jurnal di domain itu. Aktifkan plugin di tiap jurnal dan tempel key yang sama. Setiap jurnal punya dasbor dan angkanya sendiri.
Apakah perlu menyiapkan tugas terjadwal tambahan?: Tidak ada yang khusus untuk Statsora. Yang perlu berjalan adalah pemrosesan statistik bawaan OJS, karena itulah yang mengolah catatan kunjungan. Di OJS 3.4 dan 3.5 ini sudah menyala sendiri.
Apakah memberatkan halaman jurnal?: Ringan. Di daftar isi terbitan, angka untuk semua artikel diambil sekali untuk seluruh halaman, bukan berulang untuk setiap baris. Lembar gayanya juga hanya dimuat di halaman yang memang menampilkan angka.
Apakah data hilang saat plugin diperbarui?: Tidak. Statsora hanya membaca dan tidak menyimpan data sendiri, jadi tidak ada yang bisa hilang. Pembaruan aman dilakukan kapan saja, dan sejak versi 1.2.1 bisa dijalankan dari dalam dasbor oleh Site Administrator. Lihat panduan update.
Perlukah membuka Settings dan menyimpan ulang secara berkala?: Tidak, sejak versi 1.3.2. Lisensi diperbarui sendiri saat jurnal dikunjungi, paling banyak sekali sehari. Di versi 1.3.1 ke bawah, kartu statistik berhenti tampil seminggu setelah key disimpan, dan itulah yang diperbaiki di 1.3.2.
Apa yang terjadi kalau license key dicabut atau berakhir?: Tampilan angkanya berhenti dan halaman kembali seperti sebelum plugin dipasang. Tidak ada data jurnal yang diubah atau dihapus, karena Statsora tidak pernah menulis apa pun.

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

Lihat changelog lengkap