Max - ti Contact Form 7-men biriktirý

Max - ti Contact Form 7-men biriktirý

Qysqasha sıpattama

Plagın Contact Form 7 formalarynan sátti ótinimderdi chatbot API arqyly MAX messendjerine jiberedi (platform-api.max.ru). toptyq chattaǵy menedjerlerdiń habarlamalary nemese paıdalanýshyǵa jeke habarlamalar úshin qolaıly.

Plagın tek bir jolmen jumys isteıdi: jańa ótinimder týraly Shyǵys habarlamalar. Kiris habarlamalar men bot oqıǵalary MAX jaǵynda bólek webhook ornatýdy qajet etedi jáne bul nusqada óńdelmeıdi.

Talaptar

- WordPress 5.8 jáne odan joǵary
- PHP 7.4 jáne odan joǵary
- Ornatylǵan jáne belsendi Contact Form 7 plagıni
- Seriktester platformasyndaǵy Max chatboty jáne access_token tańbalaýyshy
- "MAX for Contact Form 7"ónimine arnalǵan pluginhub belsendi lısenzıasy

MAX API qujattamasy: https://dev.max.ru/docs-api
Ádisterdiń anyqtamalyǵy: https://dev.max.ru/docs

Ornatý

1. Max-cf7-integration qaltasyn serverdegi wp-content/plugins / katalogyna kóshirińiz.
2. WordPress ákimshisinde "plagınder" bólimin ashyp, "max for Contact Form 7"iske qosyńyz.
3. Contact Form 7 belsendi ekenine kóz jetkizińiz. Eger ol bolmasa, WordPress katalogynan plagındi ornatyńyz.
4. Kontaktiler → MAX tarmaǵyna ótip, tómendegi nusqaýlardy oryndańyz.

Parametrler qaıda

Plagın beti: kontaktiler → MAX (Contact Form 7 Ishki máziri).

Bette eki qoıyndy bar:
- "Parametrler" - lısenzıa, bot belgisi, chat_id, jalpy habarlama parametrleri;
— "Nusqaýlyq" - ákimshi ishindegi qysqasha anyqtama.

Jeke pishinderdi ornatý: kontaktiler → Baılanys pishinderi → qajetti pishindi ashyńyz → MAX ishindegi habarlandyrý blogy.

Parametrler siltemesi plagınder ekranyndaǵy plagınder tiziminde de qol jetimdi.

1 bólim. Pluginhub Lısenzıasy

1. Kontaktiler → MAX → Parametrler qoıyndysyn ashyńyz.
2. "Pluginhub lısenzıasy" blogynda saıtta alynǵan lısenzıa kiltin engizińiz pluginhub.pro ónimdi satyp alǵannan keıin.
3. Pishinniń tómengi jaǵyndaǵy Saqtaý túımesin basyńyz.

Lısenzıa kilti jalpy WordPress parametrlerinde emes, tek osy plagın betinde engiziledi.

Saqtaǵannan keıin blok taqyrybynyń astynda kúı kórsetiledi:
- "Lısenzıa belsendi" - Max-qa jiberýdi paıdalanýǵa bolady;
— qate týraly habarlama-kilt durys emes, merzimi ótip ketken, keri qaıtarylǵan, saıttyń domeni sáıkes kelmeıdi nemese lısenzıa serverimen baılanys joq.

Lısenzıa belsendi bolmaıynsha, plagın MAX-qa habarlama jibermeıdi. Bot tańbalaýyshyn tekserý de qol jetimdi emes.

Bir pluginhub kiltin satyp alý sharttarynda qarastyrylǵan bolsa, bir saıttaǵy birneshe PluginHub plagınderi úshin paıdalanýǵa bolady.

2 bólim. Max-te chat-botty daıyndaý

1. Seriktester úshin Max platformasynda uıymdy qosyńyz (Reseı Federasıasynyń zańdy tulǵalary men jeke kásipkerleri úshin).
2. Chatbot jasańyz jáne moderasıany kútińiz.
3. Kirý tańbalaýyshyn alyńyz:" Chatbottar " → "Integrasıa" → "tańbalaýyshty alý" bólimi. Bul access_token máni.
4. Ótinimder keletin toptyq chatqa bot qosyńyz nemese jeke habarlamalar úshin user_id daıyndańyz.
5. Chat ıdentıfıkatoryn (chat_id) nemese paıdalanýshyny (user_id) bilińiz. Alý ádisi MAX platformasynyń quraldaryna jáne API qujattamasyna baılanysty.

Qaýipsizdik mańyzdy:
- APL mekenjaıynda nemese saıttyń jalpyǵa ortaq betterinde emes, API suraýlarynda tek Authorization taqyrybynda tańbalaýyshty jiberińiz;
— tańbalaýyshty ashyq repozıtorıılerde, skrınshottarda jáne tolyq suraý mátini bar jýrnaldarda jarıalamańyz.

3 bólim. Jahandyq plagın parametrleri

Kontaktiler → MAX → "Parametrler" tarmaǵyn ashyńyz.

"Bot tańbalaýyshy (access_token)"órisi
Tańbalaýyshty MAX platformasynan salyńyz. Birinshi saqtaǵannan keıin óris maskany kórsetedi: eger tańbalaýyshty ózgertý qajet bolmasa, ony bos qaldyryńyz. Aýystyrý úshin jańa tańbalaýyshty engizip, parametrlerdi saqtańyz.

"Chat id" órisi
Bot qosylǵan toptyq chattyń sandyq ıdentıfıkatory. Ótinimder týraly komandalyq habarlamalar úshin usynylady.

"Paıdalanýshy ıdentıfıkatory (mindetti emes)"órisi
Max paıdalanýshy ıdentıfıkatory. Eger chat_id kórsetilmese qoldanylady: habarlama sol paıdalanýshyǵa ketedi.

Adresteý basymdyǵy: eger chat_id kórsetilse, jiberý chatqa ótedi; áıtpese user_id paıdalanylady. Olardyń kem degende bireýi toltyrylýy kerek.

Mátin pishimi órisi
- Markdown-juldyzshalar men astyn syzý arqyly pishimdeý (ádepki);
- HTML belgileý tegteri;
- Pishimdeý joq-qarapaıym mátin.

Ádepki Prefıks órisi
Eger belgili bir forma úshin prefıks berilmese, ár habarlamanyń basyndaǵy mátin. Mysal: "saıttan jańa ótinim".

Chekboks"chat múshelerine habarlaý (notify)"
Qosylǵan bolsa, chat músheleri MAX erejelerine sáıkes jańa habarlama týraly habarlama alady.

"Siltemelerdi aldyn ala qaraýdy óshirý"chekboksy
Qosylǵan bolsa, habarlamadaǵy siltemeler aldyn ala qaraýdy kórsetpeıdi.

Óristerdi toltyrǵannan keıin "Saqtaý"túımesin basyńyz.

"Tańbalaýyshty tekserý" batyrmasy
Get / me suraýyn MAX API-ge jiberedi jáne nátıjeni batyrmanyń janynda kórsetedi. Tekserý úshin sizge belsendi lısenzıa qajet. Eger token áldeqashan saqtalǵan bolsa, tekserý bos engizý órisi bolsa da saqtalǵan mán boıynsha oryndalady.

4 bólim. Árbir Contact Form 7 pishinin ornatý

1. Kontaktiler → baılanys formalaryn ashyńyz.
2. Pishindi tańdap, ony ashyńyz óńdeý.
3. Pishin óńdegishiniń astyndaǵy "MAX ishindegi habarlandyrý" blogyn tabyńyz.

Blok parametrleri:

"Osy formadaǵy ótinimderdi MAX-qa jiberý"
Nysandy saıtta sátti jibergen kezde derekter MAX-qa ketetinin qosyńyz.

"Habarlama mátini"
Cf7 formasynyń bir órisiniń ataýy-habarlamaǵa onyń máni ǵana enedi.
Nemese _ _ all _ _ arnaıy mánin kórsetińiz (eki jaǵynan eki astyn syzý) — sodan keıin barlyq pishin óristeri habarlamaǵa qoltańbalar tizimimen enedi.

"Habarlama prefıksi"
Habarlamanyń negizgi denesiniń aldyndaǵy mátin. Eger bos qaldyrylsa, plagın parametrlerinen Ǵalamdyq prefıks qoldanylady.

Prefıkstegi almastyrýlar (buıra jaqshada):
— {form_title} - pishin ataýy;
— {form_id} - WordPress-tegi sandyq forma ıdentıfıkatory;
— {site} - saıttyń basty betiniń meken-jaıy;
— {óris ataýy} - cf7 órisiniń máni, mysaly {your-name}, {your-email}, {tel}.

"Jiberý betiniń URL mekenjaıyn qosý"
Habarlamanyń sońyna forma jiberilgen bettiń meken-jaıy qosylady.

"Saıt mekenjaıyn qosý"
Habarlamanyń sońyna saıttyń basty betiniń URL mekenjaıy qosylady.

4. CF7 pishininde "Saqtaý" túımesin basyńyz.

5 bólim. Max-ta habarlama qalaı qalyptasady

Habarlama bólikteriniń tártibi:
1. Prefıks (pishin parametrlerinen nemese ǵalamdyq).
2. Bos jol.
3. Negizgi mátin: bir óris nemese barlyq órister (__all__).
4. Opsıalar qosylǵan kezde-saıt mekenjaıy jáne jiberý betiniń URL mekenjaıy.

_ _ All _ _ formatynda habarlamanyń taqyryby tórtburyshty jaqshadaǵy pishin ataýyn, sodan keıin aty men máni bar árbir óristi qamtıdy. Qyzmet óristeri (astyn syzýdan bastalady), reCAPTCHA jáne hcaptcha tizimge enbeıdi.

Max API mátininiń maksımaldy uzyndyǵy-4000 tańba. Plagın tym uzyn mátindi ruqsat etilgen ólshemge deıin kesedi.

6 bólim. Jumysty tekserý

1. Lısenzıanyń belsendi ekenine kóz jetkizińiz ("Pluginhub lısenzıasy"blogy).
2. Tańbalaýyshty, chat_id nemese user_id saqtańyz jáne "tańbalaýyshty tekserý"túımesin basyńyz.
3. METABOKSTAǴY synaq formasy úshin MAX-ke jiberýdi qosyńyz.
4. Osy formamen saıttyń betin ashyp, kelýshi sıaqty testilik ótinimdi jiberińiz.
5. Max chatyn tekserińiz: jańa habarlama paıda bolýy kerek.

MAX ýaqytsha qol jetimdi bolmasa da, Saıtta pishindi sátti jiberý úzilmeıdi: kelýshi áli de cf7 standartty sáttilik týraly habardy kóredi. MAX jiberý qatesi hattardy jáne basqa cf7 áreketterin, eger olar bólek konfıgýrasıalanǵan bolsa, buǵattamaıdy.

MAX API shekteýleri

- habarlama mátininiń uzyndyǵy 4000 tańbaǵa deıin;
- sekýndyna shamamen 30 suranys platform-api.max.ru (aýyr júkteme kezinde API shekteýleri bolýy múmkin);
- jumys isteý úshin maqsatty chatta jaramdy token men bot quqyqtary qajet;
— plagın kiris oqıǵalaryn óńdeýsiz POST / messages jiberý ádisin qoldanady.

Aqaýlyqtardy joıý

Ótinimder MAX-qa kelmeıdi

- Parametrler qoıyndysyndaǵy lısenzıa kúıin tekserińiz;
— "tańbalaýyshty tekserý" túımesin basyp, eger bar bolsa, qateni túzetińiz;
- chat_id nemese user_id kórsetilgenine kóz jetkizińiz;
- botty toptyq chatqa qosý kerek (chat_id úshin);
- forma metaboksynda MAX-qa jiberý engizilgen;
- saıttaǵy pishin cf7 qatelerinsiz jiberiledi (qyzyl valıdasıa qatesi týraly habarlamalar);
— hostıng Shyǵys HTTPS suraýlaryna ruqsat beredi platform-api.max.ru jáne pluginhub.pro.

Lısenzıa iske qosylmaıdy

- artyq bos orynsyz kilttiń durystyǵyn tekserińiz;
- mekenjaı jolaǵyndaǵy saıt domeni lısenzıaǵa baılanysty domenmen sáıkes kelýi kerek pluginhub.pro;
- Eger baılanys qatesi bolsa, serverdiń Internetke jáne SSL-ge kirýin tekserińiz.

"Tańbalaýyshty tekserý" qate jiberedi

- token tolyǵymen kóshirildi, basynda jáne sońynda Bos oryndar joq;
- bot MAX platformasynda joıylmaǵan nemese buǵattalmaǵan;
— tańbalaýyshtyń merzimi aıaqtalǵan joq (qajet bolsa, platformada jańasyn shyǵaryńyz).

Habarlama keledi, biraq qajetti órister joq

- "habarlama mátini" órisinde __all__ nemese cf7 belgileýindegideı óristiń naqty ataýy (your-email, tel jáne t. b.) kórsetilgen;
- prefıkstiń almastyrýlaryndaǵy óris ataýlary formadaǵy ataýlarmen sáıkes keledi.

Contact Form 7 ornatylmaǵan

Plagınder ekranynda jáne ákimshi terezesinde Contact Form 7 ornatýdy suraıtyn habarlama paıda bolady. Onsyz ıntegrasıa jumys istemeıdi.

Ázirleýshiler úshin qosymsha

PluginHub ónim ıdentıfıkatory ádepki boıynsha plagın kodynda ornatylǵan. Ony wp-config-te qaıta anyqtaýǵa bolady.php:

define ('MAX_CF7_PLUGINHUB_PLUGIN_ID', 'sizdiń-UUID-ónim');

Parametrlerge kirý quqyǵy súzgisi: max_cf7_capability (ádepki boıynsha cf7 nemese manage_options formalaryn óńdeý quqyǵymen sáıkes keledi).

Ónim ıdentıfıkatory súzgisi: max_cf7_pluginhub_plugin_id.

Plagındi joıý

Plagındi WordPress ákimshisi arqyly joıǵan kezde (tek óshirý emes) uninstall faıly.php osy ónimge arnalǵan plagın parametrleri men lısenzıa kúıiniń keshin joıady. Saıttaǵy pluginhub_license_key jalpy kilti, eger ony basqa PluginHub plagınderi qoldansa, joıylmaıdy.

Qoldaý jáne siltemeler

PluginHub: https://pluginhub.pro
MAX qujattamasy: https://dev.max.ru/docs
MAX API anyqtamalyǵy: https://dev.max.ru/docs-api