OJS plagini — foydalanish qo‘llanmasi

Bu qo‘llanma Open Journal Systems (OJS) da Sertifikat QR plaginini o‘rnatish, sozlash va mualliflarga avtomatik sertifikat berish tartibini bosqichma-bosqich tushuntiradi.

Plaginni yuklab olish (.zip) Maqolalar / API kalit

Mundarija 1. Plagin nima qiladi? 2. Talablar 3. Sertifikat QR da tayyorgarlik 4. OJS ga o‘rnatish 5. Sozlash (Settings) 6. Kundalik ish tartibi 7. Natijani tekshirish 8. Xatoliklar va yechimlar

1Plagin nima qiladi?

OJS da maqola Publish (nashr) qilinganda plagin avtomatik ravishda Sertifikat QR serveriga so‘rov yuboradi va har bir muallifga alohida sertifikat yaratadi.

Maqola nomi → sertifikatdagi kurs / ish nomi
Muallif ismi → sertifikat oluvchi
Har bir sertifikatda QR kod bo‘ladi (tekshirish uchun)

2Talablar

OJS 3.3 yoki 3.4+
Serverda PHP 8+, curl yoki allow_url_fopen
Sertifikat QR hisobi (obuna limiti yetarli bo‘lishi kerak)
Jurnal administrator huquqi (Plugins / Settings)

3Sertifikat QR da tayyorgarlik

3.1 Jurnal loyihasi yarating

Maqolalar / Jurnal sahifasiga kiring
+ Yangi loyiha → jurnal nomini yozing → Yaratish
Loyiha kartasidagi slug qiymatini nusxa oling (masalan: journal-of-science)

3.2 API kalit oling

Xuddi shu sahifada Yangi API kalit tugmasini bosing
Ko‘rsatilgan sk_… kalitni xavfsiz joyga saqlang (faqat bir marta ko‘rsatiladi)

Eslatma: API kalit maxfiy. Uni OJS sozlamalariga yozasiz — ochiq chatga / emailga yubormang.

4OJS ga o‘rnatish

ojs-sertifikat-qr-plugin.zip ni yuklab oling
OJS admin paneliga kiring
Menyu: Settings → Website → Plugins (ba’zi tillarda: Sozlamalar → Veb-sayt → Plaginlar)
Upload a New Plugin / Yangi plagin yuklash → zip faylni tanlang → yuklang
Ro‘yxatdan Sertifikat QR ni toping va Enable (Yoqish) qiling

Qo‘lda o‘rnatish (upload ishlamasa)

Zip ni oching — ichida sertifikatQr/ papka bo‘ladi
Uni serverdagi plugins/generic/sertifikatQr/ yo‘liga ko‘chiring
OJS da Plugins sahifasini yangilang va plaginni yoqing

5Sozlash (Settings)

Plugins ro‘yxatida Sertifikat QR yonidagi Settings ni oching
Quyidagi maydonlarni to‘ldiring:

Maydon	Nima yoziladi
API base URL	Masalan: `https://sertifikat-qr.uz` yoki lokal: `http://127.0.0.1:8000`
API key	`sk_…` kalit
Project slug	3-bosqichdagi loyiha slug
Auto-issue on publish	Belgilangan bo‘lsin (nashrda avtomatik chiqarish)

Save / Saqlash tugmasini bosing

6Kundalik ish tartibi

OJS da maqolani oddiy tartibda tahrirlang (mualliflar to‘g‘ri kiritilgan bo‘lsin)
Maqolani Publish qiling
Plagin fon rejimida chaqiradi: POST /api/v1/articles/issue
Har bir muallif uchun alohida sertifikat yaratiladi

Mualliflar OJS submission / publication dagi author ro‘yxatidan olinadi. Ism bo‘sh bo‘lmasligi muhim.

7Natijani tekshirish

Sertifikat QR → Maqolalar → loyiha → Chiqarilganlar
U yerda muallif, maqola nomi, sertifikat ID ko‘rinadi
Sertifikat sahifasidan PDF/PNG yuklab olish yoki QR orqali tekshirish mumkin

8Xatoliklar va yechimlar

Sertifikat chiqmadi

Plagin yoqilganmi va Settings saqlanganmi?
API URL to‘g‘rimi? (oxirida keraksiz / bo‘lsa ham odatda ishlaydi)
API kalit yangimi / o‘chirilmaganmi?
Project slug to‘g‘rimi?
Obuna limiti tugagan bo‘lishi mumkin — Tariflar sahifasini tekshiring

OJS log

Server error_log da quyidagi qatorlarni qidiring:

[SertifikatQr] Issue OK: ...
[SertifikatQr] Issue failed: ...
[SertifikatQr] Sozlamalar to‘liq emas ...

Qisqa eslatma (cheklist)

☐ Sertifikat QR da loyiha + slug
☐ API kalit (sk_…)
☐ OJS ga zip yuklash va Enable
☐ Settings: URL + key + slug + auto-issue
☐ Test maqolani Publish qilish
☐ Maqolalar → Chiqarilganlar da tekshirish

Plaginni yuklab olish Maqolalar sahifasiga qaytish