Maxning Contact form 7 bilan integratsiyasi

Max-ning Contact form 7 bilan integratsiyasi

Qisqacha tavsif

Plagin Contact Form 7 shakllaridan muvaffaqiyatli arizalarni chat-bot API (platform-api.max.ru) orqali MAX messenjeriga yuboradi. Guruh chatida menejerlarga bildirishnomalar yuborish yoki foydalanuvchiga shaxsiy xabarlar yuborish uchun mos keladi.

Plagin faqat bir yo‘nalishda ishlaydi: yangi arizalar haqida chiquvchi bildirishnomalar. Kiruvchi xabarlar va bot voqealari MAX tomonida alohida Webhook sozlamasini talab qiladi va ushbu versiyada qayta ishlanmaydi.

Talablar

— WordPress 5.8 va undan yuqori
— PHP 7.4 va undan yuqori
— O‘rnatilgan va faol Contact Form 7 plagini
- Hamkorlar uchun platformadagi MAX chat-boti va access_token tokeni
- "MAX for Contact Form 7" mahsuloti uchun faol PluginHub litsenziyasi

MAX API hujjatlari: https://dev.max.ru/docs-api
Usullar ma’lumotnomasi: https://dev.max.ru/docs

O‘rnatish

1. max-cf7-integration papkasini serverdagi wp-content/plugins/ katalogiga ko‘chiring.
2. WordPress administrator panelida "Plaginlar" bo‘limini oching va "MAX for Contact Form 7"ni faollashtiring.
3. Contact Form 7 faol ekanligiga ishonch hosil qiling. Agar u faol bo‘lmasa, WordPress katalogidan plaginni o‘rnating.
4. Kontaktlar → MAX bo‘limiga o‘ting va quyidagi ko‘rsatmalarga muvofiq sozlang.

Sozlamalar qayerda joylashgan

Plagin sahifasi: Kontaktlar → MAX (Contact Form 7 pastki menyusi).

Sahifada ikkita yorliq mavjud:
— "Sozlamalar" - litsenziya, bot tokeni, chat_id, umumiy xabar parametrlari;
- "Yo‘riqnoma" - boshqaruv paneli ichidagi qisqacha ma’lumotnoma.

Alohida shakllarni sozlash: Kontaktlar → Aloqa shakllari → kerakli shaklni oching → "MAXda bildirishnoma" bloki.

"Sozlamalar" havolasi "Plaginlar" ekranidagi plaginlar ro‘yxatida ham mavjud.

1-qism. PluginHub litsenziyasi

1. Kontaktlar → MAX → "Sozlamalar" yorlig‘ini oching.
2. "PluginHub litsenziyasi" blokida mahsulotni xarid qilgandan so‘ng pluginhub.pro saytida olingan litsenziya kalitini kiriting.
3. Shaklning pastki qismidagi "Saqlash" tugmasini bosing.

Litsenziya kaliti faqat ushbu plagin sahifasida kiritiladi, WordPress umumiy sozlamalarida emas.

Saqlagandan so‘ng blok sarlavhasi ostida quyidagi holat ko‘rsatiladi:
— "Litsenziya faol" - MAXga yuborishdan foydalanish mumkin;
— xato xabari - kalit noto‘g‘ri, muddati tugagan, bekor qilingan, sayt domeni mos kelmayapti yoki litsenziya serveri bilan aloqa yo‘q.

Litsenziya faol bo‘lmaguncha, plagin MAXga xabar yubormaydi. Bot tokenini tekshirish ham mavjud emas.

Bitta PluginHub kaliti, agar xarid shartlarida nazarda tutilgan bo‘lsa, bitta saytda bir nechta PluginHub plaginlari uchun ishlatilishi mumkin.

2-qism. MAXda chat-botni tayyorlash

1. Tashkilotni hamkorlar uchun MAX platformasiga ulang (yuridik shaxslar va yakka tartibdagi tadbirkorlar - Rossiya Federatsiyasi rezidentlari uchun).
2. Chat-bot yarating va moderatsiyadan o‘tishini kuting.
3. Kirish tokenini oling: "Chat-botlar" bo‘limi → "Integratsiya" → "Tokenni olish". Bu access_token qiymati.
4. Botni arizalar kelishi kerak bo‘lgan guruh chatiga qo‘shing yoki shaxsiy xabarlar uchun user_id tayyorlang.
5. Chat (chat_id) yoki foydalanuvchi (user_id) identifikatorini bilib oling. Uni olish usuli MAX platformasi vositalari va API hujjatlariga bog‘liq.

Xavfsizlik nuqtai nazaridan muhim:
- tokenni faqat API so‘rovlarida Authorization sarlavhasida, URLda yoki saytning ochiq sahifalarida emas, uzating;
- tokenni ochiq omborlarda, skrinshotlarda va so‘rovlarning to‘liq matni ko‘rsatilgan jurnallarda e’lon qilmang.

3-qism. Plaginning global sozlamalari

Kontaktlar → MAX → "Sozlamalar"ni oching.

"Bot tokeni (access_token)" maydoni
MAX platformasidan tokenni kiriting. Birinchi saqlashdan so‘ng maydonda niqob ko‘rinadi: agar tokenni o‘zgartirish shart bo‘lmasa, uni bo‘sh qoldiring. Almashtirish uchun yangi tokenni kiriting va sozlamalarni saqlang.

"Chat ID" maydoni
Bot qo‘shilgan guruh chatining raqamli identifikatori. Arizalar haqida jamoaviy bildirishnomalar uchun tavsiya etiladi.

 "User ID (ixtiyoriy)" maydoni
MAX foydalanuvchi identifikatori. chat_id ko‘rsatilmagan bo‘lsa ishlatiladi: xabar shu foydalanuvchiga yuboriladi.

Manzillash ustuvorligi: agar chat_id ko‘rsatilgan bo‘lsa, jo‘natish chatga amalga oshiriladi; aks holda user_id ishlatiladi. Ulardan kamida bittasi to‘ldirilishi shart.

"Matn formati" maydoni
— Markdown - yulduzcha va tagchiziqlar bilan formatlash (sukut bo‘yicha);
— HTML - belgilash teglari;
 - Formatlashsiz - oddiy matn.

 "Sukut bo‘yicha prefiks" maydoni
Muayyan shakl uchun prefiks belgilanmagan bo‘lsa, har bir xabar boshida matn. Misol: "Saytdan yangi so‘rovnoma."

 "Suhbat ishtirokchilarini xabardor qilish (notify)" katakchasi
Agar yoqilgan bo‘lsa, suhbat ishtirokchilari MAX qoidalariga muvofiq yangi xabar haqida bildirishnoma oladi.

"Havolalar ko‘rinishini o‘chirish" katakchasi
Agar yoqilgan bo‘lsa, xabardagi havolalar ko‘rinishini ko‘rsatmaydi.

Maydonlarni to‘ldirgandan so‘ng "Saqlash" tugmasini bosing.

"Tokenni tekshirish" tugmasi
MAX API’ga GET /me so‘rovini yuboradi va natijani tugma yonida ko‘rsatadi. Tekshirish uchun faol litsenziya talab etiladi. Agar token allaqachon saqlangan bo‘lsa, kiritish maydoni bo‘sh bo‘lsa ham, tekshirish saqlangan qiymat bo‘yicha amalga oshiriladi.

4-qism. Har bir Contact Form 7 shaklini sozlash

1. Kontaktlar → Aloqa shakllari bo‘limini oching.
2. Shaklni tanlang va uni tahrirlash uchun oching.
3. Shakl muharriri ostidagi "MAXda bildirishnoma" blokini toping.

Blok parametrlari:

«Ushbu shakldagi so‘rovnomalarni MAXga yuborish»
Saytda shakl muvaffaqiyatli yuborilganda ma’lumotlar MAXga yuborilishini yoqing.

«Xabar matni»
CF7 shaklidagi bitta maydonning nomi - xabarda faqat uning qiymati ko‘rsatiladi.
Yoki __all__ maxsus qiymatini ko‘rsating (har ikki tomonda ikkita tagchiziq) - shunda xabarda shaklning barcha maydonlari sarlavhalar bilan birga ro‘yxat ko‘rinishida ko‘rsatiladi.

«Xabar prefiksi»
Xabarning asosiy qismidan oldingi matn. Agar bo‘sh qoldirilsa, plagin sozlamalaridan global prefiks ishlatiladi.

Prefiksdagi o‘rin almashtirishlar (jingalak qavslar ichida):
— {form_title} - shakl nomi;
— {form_id} - WordPress'dagi shaklning raqamli identifikatori;
— {site} - sayt bosh sahifasining manzili;
— {maydon-nomi} - CF7 maydonining qiymati, masalan {your-name}, {your-email}, {tel}.

"Yuborish sahifasining URL manzilini qo‘shish"
Xabarning oxiriga shakl yuborilgan sahifaning manzili qo‘shiladi.

«Sayt manzilini qo‘shish»
Xabarning oxiriga saytning asosiy sahifasining URL manzili qo‘shiladi.

4. CF7 shaklidagi "Saqlash" tugmasini bosing.

5-qism. MAXda xabar qanday shakllantiriladi

Xabar qismlarining tartibi:
1. Prefiks (shakl sozlamalaridan yoki global).
2. Bo‘sh satr.
3. Asosiy matn: bitta maydon yoki barcha maydonlar (__all__).
4. Variantlar yoqilganda - sayt manzili va yuborish sahifasining URL manzili.

__all__ formatida xabar sarlavhasi kvadrat qavs ichida shakl nomini o‘z ichiga oladi, so‘ngra har bir maydon nomi va qiymati ko‘rsatiladi. Xizmat ko‘rsatish maydonlari (pastki chiziq bilan boshlanadigan), reCAPTCHA va hCaptcha ro‘yxatga kiritilmaydi.

API MAX bo‘yicha matnning maksimal uzunligi - 4000 ta belgidan iborat. Plagin juda uzun matnni ruxsat etilgan o‘lchamgacha qisqartiradi.

6-qism. Ishlashini tekshirish

1. Litsenziya faol ekanligiga ishonch hosil qiling ("PluginHub litsenziyasi" bloki).
2. Token, chat_id yoki user_id ni saqlang va "Tokenni tekshirish" tugmasini bosing.
3. Metaboksdagi test shakli uchun MAXga yuborishni yoqing.
4. Saytning ushbu shakldagi sahifasini oching va tashrif buyuruvchi kabi test so‘rovini yuboring.
5. MAX chatini tekshiring: yangi xabar paydo bo‘lishi kerak.

MAX vaqtincha ishlamayotgan bo‘lsa ham, saytdagi shaklni muvaffaqiyatli yuborish to‘xtatilmaydi: tashrif buyuruvchi baribir CF7 standart muvaffaqiyat xabarini ko‘radi. MAXda yuborish xatosi, agar ular alohida sozlangan bo‘lsa, CF7 xatlari va boshqa harakatlarini bloklamaydi.

MAX API cheklovlari

- xabar matnining uzunligi 4000 ta belgigacha;
 - platform-api.max.ru saytiga soniyasiga taxminan 30 ta so‘rov (katta yuklama bo‘lganda API tomonidan cheklovlar bo‘lishi mumkin);
- ishlash uchun faol token va maqsadli chatda bot huquqlari kerak;
- plagin kiruvchi hodisalarni qayta ishlamasdan, POST /messages xabar yuborish usulidan foydalanadi.

Muammolarni bartaraf etish

Arizalar MAXga kelmayapti

- "Sozlamalar" ko‘rinishida litsenziya holatini tekshiring;
 - "Tokenni tekshirish" tugmasini bosing va xatolik mavjud bo‘lsa, uni bartaraf qiling;
 - chat_id yoki user_id ko‘rsatilganligiga ishonch hosil qiling;
- bot guruh chatida qo‘shilishi kerak (chat_id uchun);
- shaklning metaboksida MAXga yuborish yoqilgan;
 - saytdagi shakl CF7 xatosiz yuboriladi (qizil tasdiqlash xatosi xabarlari);
- xostingda platform-api.max.ru va pluginhub.pro saytlariga chiquvchi HTTPS-so‘rovlarga ruxsat berilgan.

Litsenziya faollashtirilmayapti

- kalitning to‘g‘riligini ortiqcha bo‘shliqlarsiz tekshiring;
- manzil satridagi sayt domeni pluginhub.pro litsenziyasiga bog‘langan domenga mos kelishi kerak;
- aloqa xatolik yuz berganda, serverning internetga kirishini va SSLni tekshiring.

 "Tokenni tekshirish" xatolik bermoqda

- token to‘liq ko‘chirilgan, boshida va oxirida bo‘sh joylar yo‘q;
- bot MAX platformasida o‘chirilmagan yoki bloklanmagan;
- tokenning amal qilish muddati tugamagan (zarur bo‘lsa, platformada yangisini chiqaring).

Xabar keladi, lekin kerakli maydonlarsiz

- "Xabar matni" maydonida __all__ yoki CF7 belgilashidagi kabi aniq maydon nomi ko‘rsatilgan (your-email, tel va boshqalar);
- prefiks almashtirishlaridagi maydon nomlari shakldagi nomlarga mos keladi.

Contact Form 7 o‘rnatilmagan

"Plaginlar" ekranida va administrator panelida Contact Form 7 ni o‘rnatish taklifi bilan bildirishnoma paydo bo‘ladi. U bo‘lmasa, integratsiya ishlamaydi.

Ishlab chiquvchilar uchun qo‘shimcha

PluginHub mahsulot identifikatori sukut bo‘yicha plagin kodida belgilangan. Uni wp-config.php faylida qayta belgilash mumkin:

define( 'MAX_CF7_PLUGINHUB_PLUGIN_ID', 'mahsulotingizning-uuid' );

Sozlamalarga kirish huquqlari filtri: max_cf7_capability (sukut bo‘yicha CF7 shakllarini tahrirlash yoki manage_options huquqiga mos keladi).

Mahsulot identifikatori filtri: max_cf7_pluginhub_plugin_id.

Plaginni o‘chirish

WordPress boshqaruv paneli orqali plaginni o‘chirishda (shunchaki o‘chirib qo‘yish emas) uninstall.php fayli plagin sozlamalarini va ushbu mahsulot uchun litsenziya holati keshini o‘chirib tashlaydi. Saytdagi umumiy pluginhub_license_key kaliti, agar u boshqa PluginHub plaginlari tomonidan ishlatilayotgan bo‘lsa, o‘chirilmaydi.

Qo‘llab-quvvatlash va havolalar

PluginHub: https://pluginhub.pro
MAX hujjatlari: https://dev.max.ru/docs
MAX API ma’lumotnomasi: https://dev.max.ru/docs-api