MODx क्रांति में निजी संदेश

मेरे मित्र और मैंने एक सेवा के बारे में सोचा, हमने इसे MODx क्रांति पर लागू करने का निर्णय लिया। इस निर्णय के कारण, साथ ही परियोजना स्वयं इस लेख के दायरे से बहुत दूर है, शायद (आवश्यक रूप से पढ़ें) मैं इस बारे में बाद में लिखूंगा। आज मैं बताना चाहता हूं कि एक विशिष्ट समस्या का समाधान कैसे किया गया।

इसलिए, उपयोगकर्ताओं के व्यक्तिगत संदेशों के रूप में "सामाजिक" तत्व को लागू करना आवश्यक है। MODx के लिए तैयार एड-ऑन की खोज ने कुछ भी समझदार नहीं दिया, जैसा कि इस विषय पर गुगली करना था। सच है, अभी भी कुछ झलकियाँ थीं , लेकिन स्पष्ट रूप से गलत दिशा में। खैर, मैं अन्य उद्देश्यों के लिए संसाधनों (जो दस्तावेजों) का उपयोग नहीं करना चाहता था। और फिर मैंने देखा कि MODx में, जिसे "आउट ऑफ द बॉक्स" कहा जाता है, एक संदेश प्रणाली पहले से ही लागू है, जिसमें एक छोटा "लेकिन" है: आप उन्हें केवल व्यवस्थापक पैनल में उपयोग कर सकते हैं, जहां उपयोगकर्ताओं को बिल्कुल भी ऐसा नहीं करना चाहिए। फ्रंटएंड में उपयोग के लिए स्निपेट्स का एक संकेत भी नहीं। यह तब था जब मैंने गहरी खुदाई करने का फैसला किया।

1. हमें क्या करना है

तो हमारे पास क्या है। MODx डेटाबेस में तालिका modx_user_messages और संबंधित xPDO वर्ग modUserMessage समाहित है। सिद्धांत रूप में, कुछ भी हमें हमारे संदेश प्रणाली के लिए उनका उपयोग करने से रोकता है, जो हम करेंगे।

वर्ग तक पहुँचने के लिए, तरीके getObject, getCollection, newObject और अन्य का उपयोग किया जाता है, जो हमें करने की आवश्यकता पर निर्भर करता है।

हां, और संदेशों की गोपनीयता के बारे में कुछ शब्द, फिर भी वे व्यक्तिगत हैं और पते वाले को छोड़कर किसी को दिखाई नहीं देना चाहिए। इसलिए, आपको सबसे पहले हमारी वेबसाइट पर प्राधिकरण को कॉन्फ़िगर करना होगा (MODx रिपॉजिटरी में एक अद्भुत लॉगिन पैकेज है, और इस विषय पर जानकारी प्राप्त करना आसान है )।

युपीडी। मेरे पास एक लेख प्रकाशित करने का समय नहीं था, क्योंकि आज इस विषय पर प्रकाश डाला गया था।

2. संदेश पढ़ना सीखना

आइए सरल से जटिल पर जाएं। मान लें कि हमारे पास एक प्राधिकरण प्रणाली है और उपयोगकर्ता रजिस्टर और सिस्टम में लॉग इन कर सकते हैं। ठीक है, चलो एक इनबॉक्स पृष्ठ बनाते हैं जो एक विशिष्ट उपयोगकर्ता के लिए आने वाले संदेशों को प्राप्त करेगा।

हम एक नया संसाधन बनाते हैं और इसे केवल पंजीकृत उपयोगकर्ताओं के लिए एक्सेस अधिकार प्रदान करते हैं ताकि अनधिकृत "राहगीरों" को भी इस पृष्ठ पर संदेह न हो। फिर, मैं इस बिंदु पर नहीं रहूंगा, क्योंकि लेख उस बारे में नहीं है।

MODx में, किसी भी चंक या संसाधन में, एक प्लेसहोल्डर [[+ modx.user.id]] उपलब्ध है, जो वर्तमान लॉग-इन उपयोगकर्ता की आईडी वापस कर देगा। "राहगीरों" के लिए यह "0" लौटाएगा। हम इसका उपयोग पतेदार के रूप में करेंगे (यदि वर्तमान उपयोगकर्ता को निर्धारित करने के लिए किसी भी व्यक्ति को अधिक विश्वसनीय तरीके से पता है, तो मैं ख़ुशी से उसका अनुभव लेगा)।

इसलिए, हमारे नए संसाधन में हम स्निपेट कॉल रखेंगे, जिसे अब हम लिखेंगे:

[[!msg-inbox? &userId=`[[+modx.user.id]]`]] 

कृपया ध्यान दें कि हम उपयोगकर्ता आईडी के रूप में वर्तमान उपयोगकर्ता आईडी पैरामीटर पास करते हैं। अब msg-inbox नामक स्निपेट बनाएं और उसमें निम्न कोड जोड़ें:

 <?php $output = ''; $outputSeparator = isset($outputSeparator) ? $outputSeparator : "\n"; $userId = isset($userId) ? $userId : 0; $limit = isset($limit) ? (integer) $limit : 10; $offset = isset($offset) ? (integer) $offset : 0; $tpl = isset($tpl) ? $tpl : 'inbox_tpl'; if ($userId == 0) { return; } $c = $modx->newQuery('modUserMessage'); $c->where(array( 'recipient' => $userId )); $c->sortby('date_sent','DESC'); $c->limit($offset,$limit); $messages = $modx->getCollection('modUserMessage',$c); foreach ($messages as $msg){ $msgarray = $msg->toArray(); $output .= $modx->getChunk($tpl, $msgarray) . $outputSeparator; $msg->set('read',1); $msg->save(); } return $output; 

जैसा कि आप देख सकते हैं, कुछ भी विशेष रूप से उत्कृष्ट नहीं है। यहां हम पहले मापदंडों को स्वीकार करते हैं, यदि कोई हो, या उनके डिफ़ॉल्ट मानों को इंगित करते हैं। फिर, बस मामले में, हम एक बार फिर यूजर आईडी (अचानक चंचल हाथों वाला व्यक्ति एसीएल में मिला) की जांच करते हैं, अगर 0, हम स्निपेट को रोकते हैं। वैसे, स्निपेट को कॉल करते समय, आपको हमेशा उपयोगकर्ता आईडी निर्दिष्ट करने की आवश्यकता होती है, अन्यथा यह 0 पर चूक जाता है और स्निपेट इस चरण पर काम करना बंद कर देता है।

अगला, हम डेटाबेस में क्वेरी के लिए xPDO तैयार करते हैं। हमें उन संदेशों की आवश्यकता है जिनके लिए पता यूजरआईड के बराबर आईडी है। हम अन्य मापदंडों को भी पास करते हैं जिनकी हमें संदेशों को पेजिंग करते समय आवश्यकता होगी - $ सीमा और $ ऑफसेट। खैर, हम तारीख के क्रम में क्रमबद्ध हैं। लाइन "$ संदेश = $ modx-> getCollection ('modUserMessage', $ c);" मापदंड $ c द्वारा modUserMessage से सीधा चयन करता है। फिर हम परिणामी सरणी के माध्यम से जाते हैं और टेम्पलेट के बजाय चंक का उपयोग करते हैं। प्रदर्शित करने के बाद से, हम अनिवार्य रूप से संदेशों को पढ़ते हैं, उन्हें "1" के बराबर स्थिति पढ़ने के लिए सेट करते हैं, अर्थात "पढ़ें।"

अब आपको संदेशों को प्रदर्शित करने के लिए एक टेम्पलेट बनाने की आवश्यकता है। ऐसा करने के लिए, "inbox_tpl" नाम का एक नया हिस्सा बनाएं और उसमें निम्नलिखित जोड़ें:

 <div class=”inbox-message [[+read:isequalto=`0`:then=`unread`]]”> <p><b>:</b> [[+sender:userinfo=`username`]] </p> <p><b>:</b> [[+date_sent]] </p> <p><b>:</b> [[+subject]] </p> <p><b>:</b> [[+message]]</p> </div> 

असल में, HTML मार्कअप आपके स्वाद के लिए बिल्कुल भी हो सकता है। इसलिए, मैं यहां शैलियों को इंगित नहीं करता हूं। केवल एक चीज जिस पर मैं ध्यान आकर्षित करना चाहूंगा वह है बिना पढ़े संदेशों का संकेत। इसके लिए, मैंने एक वर्ग का उपयोग किया जो संदेश कंटेनर को सौंपा गया है यदि इसका पढ़ा हुआ मान 0: वर्ग = "इनबॉक्स-संदेश [[+ पढ़ा: isequalto =` 0`: तो = `अपठित`]] है। अन्यथा, अपठित वर्ग बस नहीं जोड़ा जाएगा। इस प्रकार, बिना पढ़े संदेशों को सीएसएस का उपयोग करके "हाइलाइट" किया जा सकता है। यदि आप चाहें, तो आप पाठ को "नहीं पढ़ा" या संबंधित आइकन प्रदर्शित कर सकते हैं।

अब हम परीक्षण कर रहे हैं। एक नया उपयोगकर्ता पंजीकृत करें और दृश्यपटल पर लॉग इन करें। हम इनबॉक्स पृष्ठ पर जाते हैं, और निश्चित रूप से, हम कुछ भी नहीं देखते हैं, क्योंकि किसी ने अभी तक हमें नहीं लिखा है। ठीक है, चलो एक परीक्षण संदेश भेजें। हम व्यवस्थापक पैनल पर जाते हैं, मेनू "उपयोगकर्ता" -> "संदेश"। हम बटन "नया संदेश" दबाते हैं, उपयोगकर्ता का चयन करते हैं, "विषय" और "संदेश" भरें और भेजें। अब इनबॉक्स पृष्ठ पर वापस जाएं, और वॉइला - हमारे पास व्यवस्थापक से एक नया अपठित संदेश है!

3. संदेश भेजें

पूर्ण संचार के लिए, संदेश पढ़ना पर्याप्त नहीं है, उन्हें किसी तरह भेजने की आवश्यकता है। खैर, हमारे पेज पर एक संदेश भेजने का फॉर्म जोड़ें। हमारे इनबॉक्स संसाधन खोलें और फ़ॉर्म जोड़ें:

 <form action="[[*id]]" method="post"> <label> </label><input type="text" name="to" value=""/> <label> </label><input type="text" name="subj" value=""/> <label> </label><textarea name="msg"></textarea> <input type="submit" name="send" value=""/> </form> 

फिर, सब कुछ एक आदिम स्तर पर है। हम FormIt स्निपेट का उपयोग करके फॉर्म को प्रोसेस करेंगे। मेरी राय में, सबसे सुविधाजनक रूप प्रसंस्करण उपकरण है। डेटा को संसाधित करने के लिए, FormIt स्निपेट की एक श्रृंखला कह सकते हैं - "हुक" (हुक)। हुक विभिन्न प्रकार के कार्य कर सकते हैं - स्पैम के विरुद्ध सुरक्षा, फ़ॉर्म सत्यापन और अन्य। यदि कोई हुक फॉर्म को अस्वीकार करता है (उदाहरण के लिए, सत्यापन के दौरान), तो वह गलत वापस आ जाएगा और श्रृंखला में अगला हुक विफल हो जाएगा। साथ ही, आप एक त्रुटि संदेश भेज सकते हैं।

एक संदेश भेजने के लिए, हम अपना हुक लिखेंगे और इसे फॉर्म फ़ीड करेंगे। सबसे पहले, इनबॉक्स संसाधन में एक FormIt कॉल जोड़ें। इसे पृष्ठ पर जितना संभव हो सके स्थान पर रखने की अनुशंसा की जाती है, अर्थात हम इसे फ़ॉर्म से पहले डालेंगे और संदेश-इनबॉक्स स्निपेट को कॉल करेंगे:

 [[!FormIt? &hooks=`msg-send` &submitVar=`send`]] 

दूसरे पैरामीटर submitVar पर ध्यान दें। इसमें हम "सबमिट करें" बटन का नाम दर्शाते हैं, इसलिए फ़ॉर्म को पता चल जाएगा कि पेज पर कौन सा फॉर्म है और इसे कैसे प्रोसेस करना है। कहने की जरूरत नहीं है, पेज पर कई रूप हो सकते हैं।

अब msg-send नाम से एक नया स्निपेट बनाएं और उसमें निम्नलिखित जोड़ें:

 <?php $userid = isset($userId) ? $userId: 0; if ($userid == 0) { return false; //    }; $to = $hook->getValue('to'); $message = $hook->getValue('msg'); $subj = $hook->getValue('subj'); $msg = $modx->newObject('modUserMessage'); $msg->fromArray(array( 'sender' => $userid, 'recipient' => $to, 'message' => $message, 'subject' => $subj, 'read' => 0, 'private' => 1, 'date_sent'=> strftime('%Y-%m-%d %T'), )); $msg->save(); return true; 

यहां हम पहले गुमनामी के लिए फिर से जांच करते हैं, फिर हम फॉर्म से डेटा लेते हैं। FormIt उन्हें $ हुक ऑब्जेक्ट में संग्रहीत करता है। आप उन्हें $ हुक का उपयोग करके प्राप्त कर सकते हैं -> getValue () विधि, और $ हुक -> getValues ​​() विधि सभी प्रपत्र डेटा के साथ एक सरणी वापस आ जाएगी। अगला, हम एक नया modUserMessage ऑब्जेक्ट बनाते हैं और इसके गुणों को डेटा के साथ पॉप्युलेट करते हैं। हम संदेश भेजने की तारीख भी जोड़ते हैं और प्रकार निजी = 1 है।

बचाओ, चेक करो। इस स्तर पर, "टू" फ़ील्ड में, आपको प्राप्तकर्ता आईडी लिखना होगा। आइए अपने आप को एक संदेश भेजने की कोशिश करें। यदि आप फ्रंटएंड में एक व्यवस्थापक के रूप में लॉग इन हैं, तो प्राप्तकर्ता की आईडी होगी। हम शेष फ़ील्ड भरते हैं और "भेजें" पर क्लिक करते हैं। यदि सब कुछ सही ढंग से किया गया था, तो हमारा संदेश हमारे पेज पर दिखाई देगा। अब आप कई उपयोगकर्ताओं को पंजीकृत करने और एक-दूसरे को संदेश फेंकने का प्रयास कर सकते हैं।

निष्कर्ष

मैंने जानबूझकर लेख में नाम से उपयोगकर्ता की परिभाषा या सूची से एक पतेदार की पसंद को शामिल नहीं किया - यह सब सीधे आपके कार्यों और इच्छाओं पर निर्भर करता है। इसके अलावा, मैं आपको रचनात्मकता के लिए बहुत जगह छोड़ता हूं, और इसलिए विचारहीन कॉपी-पेस्ट कम था। और उपयोगकर्ता नाम के लिए, मैं एक संकेत देता हूं - MODx में उपयोगकर्ता अनिवार्य रूप से एक ही वस्तु हैं, केवल उनके वर्ग को modUser कहा जाता है।

यह लेख एक संपूर्ण समाधान होने का दावा नहीं करता है, क्योंकि कोई संदेश प्रबंधन नहीं है, कोई छंटनी नहीं है, और इसी तरह। मैंने अभी दिखाया कि कस्टम स्निपेट्स के साथ MODx की कार्यक्षमता का विस्तार इतना मुश्किल नहीं है क्योंकि यह पहली नज़र में लगता है।

सौभाग्य है

पुनश्च धन्यवाद क्या आप के लिए पता है!