MODx रेवो, लॉगिन प्राधिकरण सेटअप। मूल सेटिंग

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

कोष्ठक में संख्या संसाधन आईडी हैं। यह page_id है, यह आपके लिए अलग हो सकता है। यहां उन्हें सिर्फ सुविधा के लिए चुना गया है।

हम आवश्यक पृष्ठ बनाते हैं

इससे पहले कि हम कोड अंशों के साथ विखंडन करें, हम पांच पृष्ठ बनाएंगे।

• लॉगिन पेज (1): लॉगिन फॉर्म वाला पेज
• पासवर्ड रीसेट (2): एक पेज जहां उपयोगकर्ता पासवर्ड रीसेट का अनुरोध कर सकते हैं
• पासवर्ड रीसेट, हैंडलर (3): एक छिपा हुआ पेज जो वास्तव में पासवर्ड रीसेट करेगा। उपयोगकर्ता इसे नहीं देखेंगे।
• उपयोगकर्ता-केवल पृष्ठ (4): एक पृष्ठ जिसकी सामग्री केवल साइट के अधिकृत उपयोगकर्ताओं के लिए दिखाई देती है
• निकास पृष्ठ (5): वह पृष्ठ, जिसके सफल निकास के बाद उपयोगकर्ता पुनर्निर्देशित होता है

इस समय मेरा संसाधन वृक्ष कैसा दिखता है। ध्यान रखें कि आपकी रिसोर्स आईडी अलग होगी। इस उदाहरण में, लॉगिन घटक के लिए पृष्ठों के अलावा कुछ भी नहीं है।

अगला, हमें उपयोगकर्ताओं और संसाधनों के लिए सही अधिकार निर्दिष्ट करने की आवश्यकता है।

आवश्यक उपयोगकर्ता समूह और संसाधन समूह बनाएँ

MODX Revo में उपयोगकर्ता की अनुमतियों की बात आने पर अधिकारों की बारीकियों की एक बहुत ही लचीली प्रणाली है, लेकिन इस विषय में हम केवल वही करेंगे जो हमें इस विषय में गहराई में जाने के बिना आवश्यक है। और इसलिए, चलो शुरू करें।
1. सुरक्षा → संसाधन समूह
उदाहरण के लिए "एक संसाधन समूह बनाएं" पर क्लिक करें और इसे "केवल उपयोगकर्ताओं के लिए" कहें। "सहेजें" पर क्लिक करें और यही वह है, इस पृष्ठ पर हम कुछ और नहीं बदलते हैं।


2. सुरक्षा → अभिगम नियंत्रण
पहले टैब पर "उपयोगकर्ता समूह" "नए उपयोगकर्ता समूह" पर क्लिक करें। हम नए समूह को "उपयोगकर्ता" नाम देंगे और "सहेजें" पर क्लिक करेंगे। उपयोगकर्ता समूह के पास "केवल उपयोगकर्ताओं के लिए" संसाधनों तक पहुंच होगी। हमें इसकी आवश्यकता क्यों है, हम इस पाठ के हिस्से के रूप में थोड़ा बाद में सीखेंगे।


3. एक ही पृष्ठ पर ( सुरक्षा → एक्सेस कंट्रोल ), निर्मित उपयोगकर्ता समूह पर राइट-क्लिक करें और "उपयोगकर्ता समूह संपादित करें" चुनें।


अगला, "संसाधन समूहों तक पहुंच" टैब पर जाएं और "संसाधन समूह जोड़ें" पर क्लिक करें। उचित संचालन के लिए, कम से कम निम्नलिखित पैरामीटर होने चाहिए:
संसाधन समूह: उपयोगकर्ता केवल (एक हमने अभी बनाया है)
न्यूनतम भूमिका: सदस्य -9999
पहुंच नीति: लोड, सूची और दृश्य
संदर्भ: वेब
और बचा लो।


4. सुरक्षा → उपयोगकर्ता प्रबंधन
हम एक "नया उपयोगकर्ता" बनाते हैं और इस तरह जांचते हैं कि उपयोगकर्ताओं के लिए एक्सेस अधिकारों का भेदभाव कैसे काम करेगा।
इस मामले में, एक साधारण उपयोगकर्ता नाम और पासवर्ड का उपयोग करें, क्योंकि हमारे लिए, जैसा कि मैंने ऊपर लिखा था, यह सुनिश्चित करना महत्वपूर्ण है कि नया उपयोगकर्ता उपयोगकर्ता समूह में है। ऐसा करने के लिए, "अनुमतियाँ" टैब पर जाएं और "उपयोगकर्ता को समूह में जोड़ें" पर क्लिक करें।
उपयोगकर्ता समूह: उपयोगकर्ता
भूमिका: सदस्य
फिर हम खिड़की पर "सहेजें" पर क्लिक करते हैं, और फिर नियंत्रण कक्ष के दाहिने कोने में फिर से ।


यह सुनिश्चित करना चाहिए कि "केवल उपयोगकर्ताओं के लिए" अधिकारों के साथ पृष्ठ को देखने के लिए एक नया उपयोगकर्ता "उपयोगकर्ता" अधिकारों के साथ लॉग इन कर सकता है।
अब स्निपेट और कोड स्निपेट को संबंधित पृष्ठों में जोड़ने के लिए पृष्ठों पर वापस जाते हैं।

पृष्ठों पर स्निपेट जोड़ें

लॉगिन पेज (1)

उपयोगकर्ताओं के प्रवेश पृष्ठ पर निम्नलिखित स्निपेट कॉल कोड डालें।

[[!Login? &loginTpl=`lgnLoginTpl` &logoutTpl=`lgnLogoutTpl` &errTpl=`lgnErrTpl` &loginResourceId=`4` &logoutResourceId=`5`]] 

लॉगिन फॉर्म को प्रदर्शित करने वाले चंक (कोड स्निपेट) में "पासवर्ड रिकवरी" के साथ पृष्ठ का लिंक भी शामिल होना चाहिए। आइए देखें कि फॉर्म कॉल में हमारे पास क्या है:
& loginTpl = `lgnLoginTpl` - यदि उपयोगकर्ता अधिकृत नहीं है, तो lgnLoginTpl chunk लॉगिन फॉर्म के लिए जिम्मेदार है।
& logoutTpl = `lgnLogoutTpl` - यदि उपयोगकर्ता अधिकृत है, तो lgnLogoutTpl chunk की सामग्री प्रदर्शित की जाएगी
& गलती = `lgnErrTpl` - यदि प्राधिकरण के लिए डेटा गलत तरीके से दर्ज किया गया है, या सरल शब्द" त्रुटि "के साथ, chunk lgnErrTpl प्रदर्शित किया जाएगा
& loginResourceId = `4` - सफल प्राधिकरण के बाद उपयोगकर्ता को पुनर्निर्देशित करने के लिए कहाँ। संसाधन ID के रूप में इंगित किया गया, इस मामले में 4।
& logoutResourceId = `5` - यदि उपयोगकर्ता लॉग इन है, तो उसे बाहर निकलने पर 5 के बराबर आईडी के साथ पृष्ठ पर पुनर्निर्देशित किया जाएगा।
इसके अलावा, मैं यह नोट करना चाहता हूं कि ये हिस्सा मानक हैं, आप हर स्वाद, लेआउट और कार्यान्वयन के लिए अपनी खुद की चूड़ियां बना सकते हैं। यह इनपुट / आउटपुट फॉर्म और इतने पर किसी भी वांछित रूप में प्रदर्शित करने की क्षमता प्रदान करता है, और इसके अलावा, कोड के साथ अराजकता की व्यवस्था किए बिना। मानक टेम्पलेट, वैसे, भी बदला जा सकता है।
यहां वह कोड है जो उन उपयोगकर्ताओं को दिया जाएगा जिन्होंने अभी तक लॉग इन नहीं किया है, दूसरे शब्दों में, "लॉगिन फ़ॉर्म"। चंक - lgnLoginTpl ।

 <div class="loginForm"> <div class="loginMessage">[[+errors]]</div> <div class="loginLogin"> <form class="loginLoginForm" action="[[~[[*id]]]]" method="post"> <fieldset class="loginLoginFieldset"> <legend class="loginLegend">[[+actionMsg]]</legend> <label class="loginUsernameLabel">[[%login.username]] <input class="loginUsername" type="text" name="username" /> </label> <label class="loginPasswordLabel">[[%login.password]] <input class="loginPassword" type="password" name="password" /> </label> <input class="returnUrl" type="hidden" name="returnUrl" value="[[+request_uri]]" /> [[+login.recaptcha_html]] <input class="loginLoginValue" type="hidden" name="service" value="login" /> <span class="loginLoginButton"><input type="submit" name="Login" value="[[+actionMsg]]" /></span> </fieldset> </form> </div> </div> <a href="[[~2]]"> ?</a> 

आप अपने टेम्पलेट के अंदर "पासवर्ड भूल गए" (पासवर्ड रीसेट) के लिए एक लिंक डाल सकते हैं और इसे आईडी द्वारा संदर्भित कर सकते हैं। मेरे मामले में, पासवर्ड पुनर्प्राप्ति के साथ संसाधन आईडी 2 है।

पासवर्ड रीसेट (2)

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

 [[!ForgotPassword? &resetResourceId=`3` &tpl=`lgnForgotPassTpl`]] 

आइए कॉल का विश्लेषण करें:
& resetResourceId = `3` - पेज हैंडलर (आईडी 3 के साथ मेरे मामले में), यह वह है जो रीसेट करता है।
& tpl = `lgnForgotPassTpl` - एक कोड वाला एक कोड जिसमें पासवर्ड रीसेट फॉर्म है।
यह समझने के लिए कि हैंडलर क्यों है और यह कैसे काम करता है, मैं सुझाव देता हूं कि चित्र देखें:

पासवर्ड रीसेट, हैंडलर (3)

यह पृष्ठ किसी भी मेनू से छिपा होना चाहिए। फिर भी, यदि कोई लिंक है, तो भी यह व्यर्थ होगा।
इसका सार इस प्रकार है। जब कोई उपयोगकर्ता पासवर्ड रीसेट करने के लिए कहता है, तो इस लिंक के साथ उसके मेल पर एक संदेश भेजा जाएगा, साथ ही एक हैश भी। जब कोई उपयोगकर्ता मेल से लिंक पर क्लिक करता है, तो MODx पासवर्ड रीसेट करता है और उपयोगकर्ता को लॉगिन पृष्ठ पर पुनर्निर्देशित करता है।
हैंडलर पृष्ठ पर, स्निपेट को इस तरह कहा जाता है:

 [[!ResetPassword? &loginResourceId=`1`]] 

- और loginResourceId = `1` इंगित करता है कि कौन से पृष्ठ को पुनर्निर्देशित करना है, हमारे मामले में, आईडी 1 के साथ पृष्ठ, जहां एक लॉगिन फ़ॉर्म है।

उपयोगकर्ता केवल पृष्ठ (4)

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

पृष्ठ से बाहर निकलें (5)

यह वह पृष्ठ है जो उपयोगकर्ताओं को अपने खाते से सफलतापूर्वक लॉग आउट करने के बाद मिलता है। पृष्ठ में केवल मुख्य एक होना चाहिए, उदाहरण के लिए एक अलविदा संदेश, या लॉगिन फ़ॉर्म का लिंक। उदाहरण के लिए:

 <p>  !  !</p> 

इसके साथ ही

पृष्ठ से बाहर निकलें (5)

यह आवश्यक नहीं है, लेकिन परीक्षण के लिए और, सामान्य रूप से, विकास में आसानी से, आप बाहर निकलने के लिए एक विशेष लिंक प्राप्त कर सकते हैं। ऐसा करने के लिए, एक "नया लिंक" (वेब-लिंक) बनाएं और आईडी 1 के साथ अपना पेज भरें। उदाहरण के लिए, पेज को इस तरह लिंक के साथ कॉल करें:

 [[~1? &service=`logout`]] 

इसका उपयोग इस रूप में बाहर निकलने के लिए किया जा सकता है:

 <a href="[[~1? &service=`logout`]]" title=""></a> 

संभावित त्रुटियां

हमने सभी पृष्ठ एकत्र करने के बाद, उन्हें लिंक किया, पहुँच अधिकार सेट किए, हमें सब कुछ जाँचना चाहिए। यदि सब कुछ हमारी योजना के अनुसार काम करता है, तो प्रवेश द्वार पर हमें "केवल उपयोगकर्ताओं के लिए" पृष्ठ पर पुनर्निर्देशित किया जाएगा। हम लॉगिन पृष्ठ के माध्यम से खाते से बाहर निकल सकते हैं, क्योंकि यदि हम अधिकृत हैं, तो लॉगिन पृष्ठ पर निकास के लिए एक लिंक दिखाई देगा। एक सफल निकास के बाद, आपको "निकास पृष्ठ" पर पुनर्निर्देशित किया जाना चाहिए।

मैं लॉग इन नहीं कर सकता!

आमतौर पर, ऐसी समस्याएं तब आती हैं जब पृष्ठ आईडी गलत तरीके से निर्दिष्ट होते हैं, गलत तरीके से लिखे गए चंक नाम या लापता वर्ग कोष्ठक। कोड्स को ध्यान से देखें।

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

 [[!Login]] 

ऐसा नहीं है:

 [[Login]] 

मैं लॉग आउट नहीं कर सकता हूँ!

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

यह भी हो सकता है कि पासवर्ड रीसेट करते समय, एक ई-मेल संदेश नहीं आता है। इस मामले में, यह आपके सर्वर पर मेल भेजने के लायक है।

सवाल पूछें, अगर मुझे जवाब पता है, तो मैं निश्चित रूप से मदद करूंगा। अगला पाठ आपके खाली समय में अनुवादित किया जाएगा। आपकी टिप्पणियों को ध्यान में रखा जाएगा :)
मैं पहली बार कोड के डिजाइन के लिए माफी माँगता हूँ, लेकिन इसे कैसे डिज़ाइन करना है यह कहीं नहीं लिखा है ...