KP un BUS, sākot ar versiju 11.5, izdevumos, kas ietver sociālo tīklu, ir parādījies jauns modulis “Web messenger”.
Pirms modulis tika izlaists visiem, tas tika kristīts mūsu sociālajā iekštīklā, savācot pat 8 atjauninājumus.
Sešu attīstības mēnešu laikā mēs esam daudz paveikuši
Mēs pilnībā atteicāmies no iepriekšējās saskarnes un izveidojām jaunu, pamatojoties uz populāro tūlītējo ziņojumapmaiņas programmu pieredzi.
Lapā sāka atvērties dialoga logs, tajā parādījās sejas, ziņojumi tika apzīmēti ar krāsu kodiem, un kļuva iespējams ērti turpināt sarunu ar vairākiem cilvēkiem vienlaikus.
Vēstures logs ir atsevišķs temats, visi sen ir gribējuši vēstures meklēšanu, nu beidzot tas ir, plānojam tur pievienot kalendāru ātrai navigācijai.
Mēs izveidojām paziņojumu centru ar dažāda veida ziņojumiem, nodrošinājām iespēju skatīt to saņemšanas vēsturi un izstrādātājiem vienkāršu API paziņojumu pievienošanai un atsaukšanai.
Un tas viss ir pieejams katrā jūsu vietnes lapā!
Diemžēl ne viss iecerētais tika īstenots
Pirmkārt Mums nebija laika, ko darīt, bija pārtulkot ziņojumus mūsu tabulās.
Šāda pāreja ļautu atteikties no “sociālo tīklu” moduļa, kas dotu lielāku brīvību redaktoru izvēlē, kā arī būtu iespējams ieviest grupu čatus.
Otrkārt, šī ir patiesas "tūlītējas" komunikācijas īstenošana. Tagad modulis izmanto regulāru pūlēšanu, aptauju serveri reizi n-sekundēs, aptaujas periods mainās atkarībā no komunikācijas aktivitātes.
Plānojam uzrakstīt atsevišķu servisu, kas uzturēs pastāvīgus savienojumus un izsūtīs datu atjauninājumus pēc nepieciešamības (mēnesenim, tiešraidei utt.).
Trešais, mēs plānojam nedaudz mainīt saskarni, atteikties no atsevišķā kontaktpersonu saraksta un dialoga loga un apvienot tos vienā veselumā, kas nākotnē ļaus mums pārvietot kurjeru mobilajā aplikācijā.
Dokumentācijas pagaidām nav un līdz rudenim tā arī neparādīsies, jo... Modulis tiek aktīvi izstrādāts, un mēs vēlamies atstāt iespēju mainīt API.
Tomēr es mēģināšu publicēt piemērus darbam ar to API daļu, pie kuras darbs jau ir pabeigts, un jūs varat tos droši izmantot savos moduļos.
Darbs ar paziņojumiem (attiecas uz tūlītējo ziņojumu, sākot no versijas 11.5.2)
Mēs esam ieviesuši trīs veidu paziņojumus:
- personalizēts paziņojums;
- paziņojums no sistēmas;
- paziņojums, kam nepieciešams apstiprinājums;
Pirms API lietošanas pārbaudiet, vai modulis ir instalēts sistēmā:
| if (IsModuleInstalled("im") && CModule::IncludeModule("im")) ( ) ?> |
Personalizēts paziņojums 
Ja ziņojumi ir iestatīti uz NOTIFY_TAG, lietotājs tos grupēs. 
Paziņojums no sistēmas 
| $arMessageFields = masīvs(// adresāts "TO_USER_ID" => $USER->GetId(), // sūtītājs (var būt >0) "FROM_USER_ID" => 0, // paziņojuma veids "NOTIFY_TYPE" => IM_NOTIFY_SYSTEM, // modulis, kas pieprasīja nosūtīt paziņojumu "NOTIFY_MODULE" => "im", // simbolisks tags grupēšanai (tiks parādīts tikai viens ziņojums), ja tas nav nepieciešams, neiestatiet parametru "NOTIFY_TAG" => "IM_CONFIG_NOTICE", // paziņojuma teksts vietnē (pieejami html un BB kodi) "NOTIFY_MESSAGE" => "[b]Uzmanību: jums jāpārbauda un jānorāda pareizais ceļš uz sociālo tīklu moduļa "Tūlītējā ziņojumapmaiņa un paziņojumi" iestatījumos" , // paziņojuma teksts, kas jānosūta pa e-pastu (vai XMPP ), ja nav atšķirību, neiestatiet parametru //"NOTIFY_MESSAGE_OUT" => ""); CIMNotify::Add($arMessageFields); ?> |
Paziņojums, kam nepieciešams apstiprinājums (apstiprināt) 
| $arMessageFields = array(// adresāts "TO_USER_ID" => $USER->GetId(), // sūtītājs "FROM_USER_ID" => 2, // paziņojuma veids "NOTIFY_TYPE" => IM_NOTIFY_CONFIRM, // modulis, kas pieprasīja nosūtīt paziņojumu "NOTIFY_MODULE " => "calendar", // simbolisks tags grupēšanai (tiks parādīts tikai viens ziņojums), ja tas nav nepieciešams, neiestatiet parametru "NOTIFY_TAG" => "CALENDAR|INVITE|123|".$ USER->GetId() , // paziņojuma teksts vietnē (pieejami html un BB kodi) "NOTIFY_MESSAGE" => "Aicinu piedalīties sanāksmē "Tūlītējā ziņojumapmaiņa un paziņojumi", kas notiks 15. martā, 2012 at 14:00", // paziņojuma teksts nosūtīt pa e-pastu (vai XMPP), ja nav atšķirību, neiestatiet parametru "NOTIFY_MESSAGE_OUT" => "Lietotājs Jevgeņijs Šeļenkovs aicina piedalīties sapulcē "Instant ziņojumi un paziņojumi” #BR#, kas notiks 15.03.2012. plkst. 14:00.#BR # #BR# Pieņemiet: http://test.ru/calend.php?CONFIRM=Y&CID=123 #BR# Atteikt: http://test.ru/calend.php?CONFIRM=N&CID=123", // masīvs, kas apraksta paziņojumu pogas "NOTIFY_BUTTONS" => Masīvs(// 1. pogas nosaukums, 2. vērtība, 3. pogas veidne , 4. pāreja uz adresi pēc noklikšķināšanas (izvēles parametrs) Array("TITLE" => "Accept", " VALUE" => "Y", "TYPE" => "accept" /*, "URL" => " http://test.ru/?confirm=Y" */), Array("TITLE" => " Atteikt", "VALUE" => "N", "TYPE" => "atcelt" /*, "URL " => "http://test.ru/?confirm=N" */),), // vēstules nosūtīšanas veidnes simboliskais kods, ja nav norādīts, tas tiek nosūtīts ar paziņojumu veidni "NOTIFY_EMAIL_TEMPLATE" => " KALENDĀRS_UZAICINĀJUMS"); CIMNotify::Add($arMessageFields); ?> |
Lai strādātu ar šāda veida paziņojumiem, nepietiek tikai ar ziņojuma nosūtīšanu.
apkalpošana
Ir divas iespējas, visvienkāršākā ir sekot saitei (ja NOTIFY_BUTTONS iestatāt 4. parametru).
Pēc tam, kad sekojat saitei, kodā ir jāizsauc šāds kods:
Uzmanību: pievērsiet īpašu uzmanību tagu nosaukumam, kad izsaucat dzēšanu, visi ziņojumi ar šo tagu tiks dzēsti.
Sūtot vairākus ziņojumus, tas ir jāņem vērā, lai viena lietotāja darbības izpilde nejauši neizdzēstu paziņojumu visiem (izņemot vietas, kur šāda loģika ir nepieciešama).
Otra iespēja ir pasākumos.
1. jāreģistrē atkarība
Neaizmirstiet par savām funkcijām ConfirmRequest Un RejectRequest izraisīt paziņojuma dzēšanu CIMNotify::DeleteByTag()
Pagaidām tas arī viss, gaidu jūsu ieteikumus komentāros, veiksmīgas realizācijas!
Ja vēlaties izmēģināt API pirms 11.5.2 izlaišanas masīvā ar parametriem, papildus jānorāda "MESSAGE_TYPE" => IM_MESSAGE_SYSTEM, arī opcija ar saiti pogās nedarbosies apstiprinājuma paziņojumiem. Bet labāk ir pagaidīt; atjauninājums 11.5.2 iznāks 23. maijā.
Šajā kursa brīdī ir izveidots mūsu spraudņa pamats, ir definēts pielāgots āķis un ir pievienots pastāvīgs ziņojums, kas parāda, kā āķis darbojas.
Ka mēs Nav izdarīja, viņi neieviesa ziņojumu veidus un to attēlošanu atbilstoši lietotāja ievadītajiem datiem.
Bet pirms sākam, mums ir jāpievieno atbalsts dažādiem ziņojumu veidiem, klases interfeiss, kas atbalstīs katru ziņojuma veidu, un datu struktūra, kas nepieciešama šādu ziņojumu glabāšanai.
Vai esat gatavs sākt?Ar nepacietību gaidu apmācības turpināšanu, taču ir dažas lietas, kas mums jāņem vērā, pirms iedziļināties avota kodā. Pārliecinieties, vai jūsu sistēmā ir instalēta šāda programmatūra:
- PHP 5.6.25 un MySQL 5.6.28
- Apache vai Nginx
- WordPress 4.6.1
- Jūsu vēlamais IDE vai redaktors
Un, ja meklējat universālu risinājumu, neaizmirstiet izmēģināt MAMP.
Mēs esam virzījušies uzKā minēts iepriekš, mēs esam tieši šī kursa vidū. Ja esat nokavējis kādu no pirmajām nodarbībām, lūk, ko mēs līdz šim esam apskatījuši:
Un tas ir tas, ko mēs apsvērsim apmācības pēdējā posmā:
Pašlaik mums ir citi uzdevumi, un mēs koncentrēsimies uz tiem.
Atgriezīsimies pie darbaTā kā esam pievērsušies darbam (un, kā minēts iepriekšējās nodarbībās), esam apņēmušies turpināt šīs daļas uzdevumu izpildi:
Šajā apmācībā mēs turpināsim pilnveidot iestatījumu Messenger, pievienojot atbalstu veiksmes un neveiksmes ziņojumiem, kā arī pieskaroties drošības problēmām.Iepriekšējā rakstā mēs sākām darbu lietotnē Settings Messenger, taču tikai līdz tādai funkcijai, kas nepārtraukti rādīs paziņojumu par panākumiem, kamēr tiek ielādēta lietotāja lapa.
Šajā apmācībā mēs pievienosim atbalstu kļūdu, brīdinājumu un veiksmes ziņojumiem. Pēc tam mēs tos parādīsim ekrānā, lai iegūtu priekšstatu par to, kā kurjers darbosies.
Turklāt mēs veiksim vēl vienu izmaiņu, kas papildinās atbalstu paziņojumu noraidīšanai pēc lietotāja ieskatiem.
Šis ir viss šīs nodarbības nepieciešamā darba plāns. Sāksim.
Iestatījumi Messenger paplašinājumsAtcerieties, ka Iestatījumu ziņojumapmaiņas mērķis ir definēt mūsu veidu, kā strādāt ar pielāgotiem ziņojumiem, pielāgotiem āķiem un vietējo WordPress API, lai parādītu ziņojumus WordPress administratora paneļa kontekstā.
Lai to paveiktu, mēs paplašināsim pēdējā nodarbībā paveikto un sāksim no šejienes.
Veiksmīgas ziņasTā kā iepriekšējā nodarbībā sākām ar veiksmīgiem ziņojumiem, tad turpināsim ar tiem. Tagad mums ir stingri kodēta metode, kas parāda vienu metodi:
"."n"; /* XML dokumenta pamatteksts */ $xarg["xml"] .= "" . $xml_string . ""; /* XSL veidne */ $xarg["xsl"] = implode(" ", file("style.xsl")); /* izvada HTML kodu — XSL transformācijas rezultātu */ echo xslt_process($xh, "arg:xml", "arg:xsl", NULL, $xarg) ; / * izejas XML avots (atkļūdošana) */ echo "" htmlspecialchars($xml_string) "";
Galvenais jauninājums ir $global_content objektā, kura nosaukums runā pats par sevi. Šajā gadījumā tas pieder klasei Outputable reālās dzīves uzdevumos, jūs, iespējams, izveidotu atsevišķu klasi lapas saturam.
Ja paskatās vērīgi, tad skripta saturs praktiski nav mainījies – tā pati inbox, tā pati toPage(). Pievienota instrukcija, kas lapas saturā parāda ziņojumu saraksta saturu. Dažādībai tagad tiek ģenerēti divi ziņojumi.
Lai apskatītu rezultātu, atliek tikai sagatavot XSL veidni.
style.xsl
XSLT piemērs
Ko esam sasnieguši?
Pirmkārt, jūs varat drošāk uzņemties sarežģītus projektus - tiek nodrošināta reāla moduļu neatkarība. Rezultātu ievietošanas secība lapā tagad tiek kontrolēta, izmantojot ārēju XSL veidni, un tā nav atkarīga no moduļu palaišanas secības.
Jebkurš modulis, kas sava darba rezultātā ģenerē XML datus, var tikt izmantots projektā. Starp citu, šī ir viena no priekšrocībām salīdzinājumā ar veidņu dzinējiem, kuros datu izveide sastāv no konkrēta dzinēja izsaukšanas metožu secības (piešķiršanas utt.), kurai nav vienota standarta.
Vēl viena priekšrocība ir atkļūdošanas vienkāršība. Ja palaižat skriptu, pamanīsit, ka katra lapa satur atkļūdošanas izvadi — XML prototipu, kas ievērojami vienkāršo atkļūdošanas lietojumprogrammas.
Vēl kaut kas, par ko jums jādomā, ir ziņojumu objektu izveide. Ne vienmēr ir ērti lietot jaunu tieši klienta kodā. Bet varbūt šī ir atsevišķa raksta tēma.
Visbeidzot, atainojums par perspektīvām:
* uznirstošie logi svarīgu ziņojumu sarakstam
* "sūtītāja lapas" un "galamērķa lapas" ziņojumos
* ziņojumu reģistrēšana datu bāzē
* poga "rādīt manu darbību vēsturi"
* statistiskā analīze par lietotāju darbībām sesiju laikā
* "inteliģentie palīgi" tīmekļa lietojumprogrammās
Iebūvētā paziņojumu sistēma, pirmo reizi Joomla, ļauj jūsu lietotnei informēt lietotāju (vai lietotāju grupu) par dažādiem notikumiem. Uztveriet paziņojumus kā svarīgus brīdinājumus, ka lietotājs būtu ieinteresēts tos lasīt un sekot līdzi.
Paziņojumus var ģenerēt visur. Jūsu komponentā vai spraudņos un vēlāk tiek parādīts JomSocial paziņojumu sistēmā.
Šī apmācība jums parādīs, kā, taču, tā kā mums nav ne jausmas par kādu trešās puses komponentu, ko mēs varētu izmantot:) piemēri tiks veikti kopienas spraudnī, kas tiks aktivizēts notikumā onAfterProfileUpdate
Ja nezināt, kā izveidot spraudni, kas tiks aktivizēts šajā notikumā, iesakām pārbaudīt šo rokasgrāmatu
Kā minēts šīs apmācības pārskatā, mēs ģenerēsim paziņojumus, izmantojot kopienas spraudni.
Jūs, visticamāk, vēlēsities izveidot paziņojumus savā komponentā vai spraudnī. Tālāk sniegtā apmācība darbosies jebkurā no šiem gadījumiem. Jums tikai jānosaka, kurā koda punktā paziņojums tiks izveidots, un vienkārši ielādējiet failu JomSocial Core Libraries.
prasīt_vienreiz JPATH_ROOT . "/components/com_community/libraries/core.php" ;
Tālāk izskaidrotās apmācības ievērošana lieliski darbosies arī jūsu paplašinājumam
Attīstības vides sagatavošana1. Mēs pieņemsim, ka jūs jau esat izveidojis kopienas tipa spraudņa piemēru, kas tiks aktivizēts, kad lietotājs mainīs savu profilu
Ja nē, varat lejupielādēt tukšu spraudņa piemēru no , instalēt to Joomla un iespējot spraudni. Tas ir nosaukts Kopiena — paziņojumu piemērs
2. Dodieties uz savu datu bāzi un iztukšojiet šīs divas tabulas, lai tajās vispār nebūtu ierakstu
A) prefix_community_notification
b) prefix_community_mailq
3. Jūsu testa vietnēs ir jābūt vismaz diviem (2) lietotājiem un jāzina viņu ID
Iepriekšējās Joomla versijās lietotāja ID vienmēr ir sākušies no norādītā skaitļa (62, 42). Joomla 3 šis skaitlis būs nejaušs, līdz ar to mūsu testēšanas vides attēls, jo tas noteikti atšķirsies jūsu beigās.
Pirmais paziņojumsAtveriet spraudņa php failu, kas atradīsies mapē ROOT/plugins/community/example
Funkcijā onAfterProfileUpdate() aizstājiet
CNotificationLibrary::add ( $cmd , $actor , $target , $subject , $body , $template , $params ) ;
Kā parādīts piemērā, paziņojumu pievienošanas api ir 7 parametri
Zinot to visu, definēsim mainīgos, ko izmantosim
Mainiet spraudņa kodu uz:
$lietotājs = CFactory::getUser(); $cmd = "sistēmas_ziņojumapmaiņa" ; // pirmais parametrs, darbības veids $actor = $user -> id ; //otrais parametrs - iegūstiet $actor ID $target = "965" ; // trešais param. Kas saņem paziņojumus? Mūsu izstrādātāju vidē tā administratora lietotājs ar id 965. Jūsu vidē jūs, visticamāk, vēlēsities iegūt ID no sava objekta vai no lietotāju masīva. $subject = "Paziņojuma tēma" ; // Abu, e-pasta un uznirstošo paziņojumu tēma $body = ; //Ķermeņa ziņojums e-pastos. $template = "" ; // Ja jums ir nepieciešams izmantot konkrētu jomsocial veidnes failu, varat to definēt šeit. $params = jauns CParameter("" ) ; // Mēs vēlamies izveidot papildu parametru objektu un piešķirt tam datus, formāli nedefinējot klasi CNotificationLibrary:: add ( $cmd , $actor , $target , $subject , $body , $template , $params ) ;
Tagad piesakieties ar jebkuru lietotāju un mainiet profila informāciju. Dodieties uz datu bāzi, lai redzētu, kas noticis.
Pārejiet uz tabulu prefix_community_notifications un novērojiet jauno ierakstu
Pārejiet uz tabulu prefix_community_mailq un skatiet jauno ierakstu
Apsveicam! - Jūs esat veiksmīgi izveidojis savu pirmo paziņojumu, kas ir nosūtīts pa e-pastu un iekšējo JomSocial paziņojumu sistēmu
Iespējamais kods uzpūšanās Iepriekš minētais piemērs ir labs, un tas darbojas, bet kopumā nav ieteicams to izmantot šādi. Tā vietā to varētu uzrakstīt šādi
$actor = CFactory::getUser(); $params = jauns CParameter("" ) ; CNotificationLibrary:: add ( "system_messaging" , $actor -> "Šis ir paziņojuma pamatteksta ziņojums" , "" , $params ) ;
Tas ir daudz tīrāks un vieglāk izpildāms, vienlaikus darot to pašu, ko iepriekš parādītajā kodā.
Pielāgoti paziņojumu parametriPaziņojumu API var paplašināt ar jebkuru parametru, kuru vēlaties pievienot.
Šos parametrus var nodot vai nu e-pasta veidnei, paziņojumam un, protams, valodas failam.
$actor = CFactory::getUser(); $link = "http://www.google.com" ; $params = jauns CParameter("" ) ; $params -> set ("actor" , $actor -> getDisplayName () ) ; // var izmantot kā (actor) tagu $params -> set ("actor_url" , "index.php?option=com_community&view=profile&userid=" . $actor -> id ) ; // Saite (aktieru) tagam $params -> set ("url" , $link ) ; //url no visas darbības. Izmanto, kad paziņojumu logā virza kursoru virs iemiesojuma. Var izmantot kā (url) tagu arī izejošajos e-pastos. Pārliecinieties, vai esat definējis $link mainīgo:) CNotificationLibrary:: add ( "system_messaging" , $actor -> id , "965" , "Notification Subject" , "This is the notification body message" , "" , $params ) ;
- $params = jauns CParameter( ); - Mēs vēlamies izveidot jaunu parametru objektu un piešķirt tam datus, oficiāli nedefinējot klasi.
- $params->set("aktieris", $actor->getDisplayName()); - Jūsu paziņojumā vienmēr ir jābūt aktierim. Šo parametru var nodot veidnei kā (aktiera) tagu. Paziņojumu logā tas definē lietotāju, kurš veic darbību.
- $params->set("aktora_url", "index.php?option=com_community&view=profile&userid=" . $actor->id); - Aktiera URL parasti ir aktiera URL. Paziņojuma uznirstošajā logā tas pievieno saiti uz (aktiera) elementu
- $params->set("url", $saite); - Šis ir vissvarīgākais parametrs, kas vienmēr ir pareizi jāiestata. Paziņojumu logā šis parametrs tiek izmantots virs iemiesojuma attēla. E-pasta paziņojumā tas atkārto vietu, kur notika darbība.
Šajā piemērā mēs iestatīsim mainīgo $link uz zemi www.google.com lai jūs varētu redzēt, kā tas darbojas
Valodas virknes pievienošana un parametru izmantošanaTikko iestatītie parametri ir pieejami lietošanai arī mūsu valodu failos.
Ļauj definēt valodas taustiņus, mainot " CNotificationLibrary::add() API
CNotificationLibrary::add("sistēmas_ziņojumapmaiņa" , $actor -> id , "965" , JText::sprintf("PLG_COMMUNITY_EXAMPLE_SUBJECT") , JText::sprintf("PLG_COMMUNITY_EXAMPLE_BODY") ,,par
Valodas failam vajadzētu izskatīties šādi
PLG_COMMUNITY_EXAMPLE_SUBJECT = "(aktieris) atjaunināts profils" PLG_COMMUNITY_EXAMPLE_BODY = "Sveiki, administrators \n Šis ir vēstule, lai informētu, ka (aktieris) ir atjaunināts profils \n\n Ja vēlaties doties uz Google, noklikšķiniet šeit \n a href=" _QQ_" (url)"_QQ_">(url)"
Šajā piemērā mēs esam izmantojuši tagu (actor) un (url), lai nodotu datus gan paziņojumu, gan e-pasta veidnēm. Redzēsim, kā tas izskatās.
Paziņojumu logā, virzot kursoru virs iemiesojuma, ievērojiet (url) parametru, kas ir ieslēgts un pievieno saiti uz Google virs iemiesojuma. Tas ir apzināti, jo mēs tā esam izveidojuši :)
]
Tajā pašā logā, virzot kursoru virs aktiera saites. Šī ir daļa, kurā (aktors) atsaucās uz lietotāju, kurš veic darbību, savukārt (actor_url)" rūpējās, lai objekts tiktu pareizi saistīts
Redzēsim, kas notiek e-pasta rindā
Un visbeidzot faktiskais e-pasts, kas tiek nosūtīts gala lietotājam
Panākumi
Līdz šim esam izveidojuši trīs (3) parametrus, kas tiek veiksmīgi izmantoti paziņojumu logā un e-pastos.
Līdzīgi jūs varat definēt "
- (mērķis) - ja jums tas ir nepieciešams
- (target_url), ja tas ir nepieciešams paziņojumā.
- (nosaukums) — parasti izmanto, lai atsauktos uz objektu, kas ģenerēja paziņojumu. Piemērs: "Lietotājs X publicēja jaunu fotoattēlu albumā Y." Šeit ir albuma Y nosaukums
- (title_url) — tāpat kā iepriekšējiem, tā objekta URL, kas ģenerēja paziņojumu.
- (Ziņojums) — šo parametru var izmantot, lai iestatītu (un atbalsotu) ziņojumu JomSocial e-pasta pamattekstā.
