🛅 📼 🧛🏼 MovableType - प्लगइन विकास के कुछ अंश 🚵🏽 🌽 🚶🏻

MovableType हमारे देश में बहुत लोकप्रिय नहीं है, लेकिन यह ब्लॉगिंग सिस्टम को देखने लायक है। बॉक्स से बाहर, यह बहुत सारे ब्लॉगों का समर्थन करता है, 5 वें संस्करण से यह एक पूर्ण साइट का प्रबंधन भी करता है। यह बहुत सारे स्टैटिक html फाइल्स जेनरेट करके पेरल पर काम करता है, जिसकी वजह से यह बहुत बड़े लोड को भी अच्छी तरह से झेल सकता है।

इसे दो संस्करणों में वितरित किया गया है: ओपनसोर्स और प्रो। इसके लिए प्लगइन्स को एक अर्ध-मुक्त मोड में वितरित किया जाता है: घड़ी, घड़ी, भुगतान, उपयोग।

सामान्य तौर पर, सिस्टम OOP की भावना में लिखा गया है, लगभग हर छींक के लिए हुक हैं, ORM है, सब कुछ लगभग ठीक है ...

प्लगइन स्थापना

तो, पहला बिंदु: प्लगइन्स इंस्टॉल करना। स्थापित प्लगइन्स में शामिल हैं:

$ Mt / plugins / <plugin> प्लगइन कोड में प्लगइन के डैडी भरें
$ Mtpub / mt-static / plugins / <plugin> में स्थिर प्लगइन फ़ाइलों के फ़ोल्डर में भरें
जाँच करें कि क्या आपको $ mt / extlib / में किसी भी पुस्तकालय को भरने की आवश्यकता है
हम ध्यान से इस विषय पर प्रलेखन का अध्ययन करते हैं "क्या मुझे पर्ल के लिए कोई लाइब्रेरी स्थापित करने की आवश्यकता है"
हम ध्यान से इस विषय पर प्रलेखन का अध्ययन करते हैं कि "मैं अब टेम्पलेट्स को फिर से कैसे लिख सकता हूं"

प्लगइन की कार्यक्षमता और जटिलता के आधार पर, अंतिम दो बिंदु कभी-कभी एक गैर-तुच्छ कार्य में परिणत होते हैं। कुछ प्लगइन निर्माताओं ने इन कार्यों को सरल बनाने के लिए कस्टम प्लगइन्स भी विकसित किए हैं, जैसे कि mt-hacks.com से TemplateInstaller ।
इसलिए, यदि आप एमटी के लिए एक प्लगइन लिखने का निर्णय लेते हैं, तो ध्यान से सोचें ताकि उपयोगकर्ता को यथासंभव कम आंदोलनों का सामना करना पड़े।

MT के लिए प्लगइन का विवरण

इसलिए, हमने एक प्लगइन को जन्म देने का फैसला किया। हमने इसके लिए एक फ़ोल्डर संरचना बनाई:

plugins/coolplugin/
plugins/coolplugin/lib/
plugins/coolplugin/tmpl/
mt-static/plugins/coolplugin/

और उन्होंने सोचा: क्या लिखना है?

सबसे पहले, config.yaml लिखें। कुछ (4.xx प्रकार) के साथ शुरू, प्लगइन का विवरण config.yaml फ़ाइल के माध्यम से एक सरल और सुलभ रूप में बनाया जा सकता है, और प्लगइन की मुख्य फ़ाइल में कोड का एक गुच्छा जोड़ने के साथ सौदा नहीं है। तो क्या और config.yaml शामिल होना चाहिए?
लेकिन किसी को पता नहीं है । यदि आप यह जानने की इच्छा रखते हैं कि क्या हो सकता है - स्वागत है, $mt/lib/MT/Plugin.pm और अन्य प्लगइन्स का अध्ययन करें।

सबसे उपयोगी चीजें हैं:

 नाम: आपके प्लगइन का नाम।  एक छोटी रेखा की सिफारिश की जाती है ताकि यह फिट हो।
 आईडी: प्लगइन नाम
 Author_link: प्लगइन के लेखक से लिंक करें
 author_name: प्लगइन लेखक का नाम
 विवरण: <__ ट्रांस वाक्यांश = "प्लगइन का विवरण, प्रकट होता है यदि आप प्लगइन्स मेनू में प्लगइन नाम पर क्लिक करते हैं">
 संस्करण: प्लगइन संस्करण
 स्कीमा_वर्जन: प्लगइन डेटा स्कीमा संस्करण
 plugin_link: उस पृष्ठ से लिंक करें जहाँ आप प्लगइन को मर्ज कर सकते हैं
 doc_link: उस पृष्ठ से लिंक करें जहां प्लगइन विवरण है
 blog_config_template: template_name with_configuration_page.tpl
 l10n_class: प्लगइन :: अंतर्राष्ट्रीयकरण वर्ग
 आइकन: प्लगइन छवि! {gif / png / jpg / itd}
 सेटिंग्स:
     क्या सेटिंग:
         डिफ़ॉल्ट: "डिफ़ॉल्ट मान"
         गुंजाइश: ब्लॉग
     वैश्विक सेटिंग:
         डिफ़ॉल्ट: "अधिक महत्वपूर्ण"

 init: $ प्लगिन :: मॉड्यूल :: आरंभीकरण कार्य

 कॉलबैक:
     कुछ हैक: $ प्लगिन :: मॉड्यूल :: हैक फ़ंक्शन

 टैग:
     समारोह:
         टैगनाम: $ प्लगइन :: मॉड्यूल :: टैग_फंक्शन
     ब्लॉक:
         ब्लॉकटैगनाम: $ प्लगइन :: मॉड्यूल :: ब्लॉक_फंक्शन_फंक्शन

 object_types:
     वस्तु:
         फ़ील्ड: टाइप # इस फ़ील्ड को डेटाबेस में ऑब्जेक्ट में जोड़ा जाएगा
         फ़ील्ड: टाइप करें मेटा # इस फ़ील्ड को मेटाडेटा तालिका में संग्रहीत किया जाएगा और डेटाबेस संरचना को अपडेट करने की आवश्यकता नहीं होगी

 अनुप्रयोगों:
     # इस बारे में बाद में, जबकि वे भूल गए

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

प्लगइन विन्यास

सेटिंग के बारे में बहुत कुछ लिखा गया है। एमटी आपको एक विकल्प प्रदान करता है: स्वयं सेटिंग पेज बनाएं, या ऑटो-जनरेटर का उपयोग करें। यदि आपका प्लग-इन 2-3-4 सरल रेखाओं / चेकबॉक्स / आदि के साथ कॉन्फ़िगर किया गया है, तो यह निश्चित रूप से, ऑटो-जनरेटर लेने के लिए बहुत आसान और तेज़ है। सामान्य तौर पर, एडेप्ट एमटी बेरेन रीज़ ("वास्तव में एमटी के बारे में बहुत कुछ जानता है, मैं आपको उनके पोस्ट पढ़ने के लिए सलाह देता हूं)" HOWTO: ओन प्लगइन सेटिंग्स पेज "लेख में आपकी मदद करेगा।

मैं विन्यास से संबंधित कुछ बिंदुओं का वर्णन करना चाहता हूं, जिसका वर्णन मुझे कहीं भी नहीं मिला:

प्लगइन कॉन्फ़िगरेशन के दौरान डेटा का सत्यापन

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

तो, यहां आपके पास प्लगइन क्लास है जो इनिट हुक में कॉन्फ़िगर किया गया था (ऊपर config.yaml देखें)। स्वयं विधि (उदाहरण के लिए, प्लग इन / OurPlugin / lib / Plugin.pm में निहित है) सबसे सरल तरीके से इस तरह दिखता है:

 package OurPlugin::Plugin use base 'MT::Plugin'; sub cb_init { my $p = shift; return bless $p, 'OurPlugin::Plugin'; }

और config.yaml में इस तरह वर्णित है:
init: $OurPlugin::Plugin::cb_init

तो, बचत के समय, OurPlugin :: Plugin: save_config कहा जाएगा, जिसे तीन तर्क दिए जाएंगे: हमारी वस्तु, हैश में फॉर्म डेटा और स्कोप क्षेत्र।

चूंकि हमारे पास पहले से आधार MT :: Plugin है, अगर हम कुछ भी नहीं करते हैं, तो उपयोगकर्ता द्वारा बताई गई हर चीज को-के रूप में सहेजा जाएगा। यदि हम कोई सत्यापन करना चाहते हैं, तो हमें इसकी आवश्यकता है:

 sub save_config { my ($plugin, $args, $scope) = @_; my @errors; #           if (@errors) { return $plugin->error("<br />\n".join("<br />\n", @errors)); } return $plugin->SUPER::save_config($args, $scope); } ## end sub save_config

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

 sub load_config { my ($plugin, $args, $scope) = @_; $plugin->SUPER::load_config($args, $scope); #   -   ,   $plugin->error()   if($plugin->errstr) { # Set $args->{error} to display error banner right before plugin settings $args->{error} = $plugin->errstr; } } ## end sub load_config

और कॉन्फ़िगरेशन टेम्पलेट में एक टुकड़ा डालें

  <mt:if name="error"> <mtapp:statusmsg id="generic-error" class="error"> <mt:var name="error"> </mtapp:statusmsg> </mt:if>

इस प्रकार, मनमाना डेटा सहेजा जाएगा, लेकिन जब आप सेटिंग्स विंडो खोलते हैं, तो उपयोगकर्ता देखेंगे कि क्या गलत है। यह तय करने के लिए कि आपको किस रास्ते पर जाना है, आप विभिन्न अवसरों के लिए दोनों विधियों का उपयोग कर सकते हैं, यह याद रखना महत्वपूर्ण है कि प्लगइन कॉन्फ़िगरेशन टेम्पलेट के अंदर कई मानक टैग काम नहीं करते हैं । यही है, वे उपलब्ध हैं, लेकिन वे बकवास देते हैं, क्योंकि टेम्पलेट एक अलग स्वतंत्र संदर्भ में संकलित किया गया है, इसलिए एक ब्लॉग आईडी भी नहीं है जिसके लिए सेटिंग्स उत्पन्न होती हैं - और यहां load_config $args->{...} load_config से सेट करने के लिए load_config से बचाव में आएगा $args->{...} आवश्यक चर, जिसके बिना उपयोगकर्ता को सामान्य रूप से कोई संकेत देना संभव नहीं होगा।

JQuery कनेक्शन प्लगइन को कॉन्फ़िगर करने के लिए

बहुत ही मजेदार पल। MT5 पूर्ण रूप से jQ का उपयोग करता है, लेकिन MT4 में यह नहीं है। उसी समय, MT4 के लिए कुछ प्लगइन्स पहले से ही jQ लोड करते हैं, इसलिए यदि हम सिर्फ jQ को हमेशा लोड करते हैं, तो सिर में संघर्ष होगा।
खुद के लिए, मैंने blog_config.tmpl में इस तरह के एक टुकड़े का फैसला किया:

 <mt:If tag="Version" lt="5"> <script type="text/javascript"> // prevent double-load of jQuery, save if jQ already loaded its state if(window.jQuery) { window.__PLUG_jQ = window.jQuery; window.__PLUGB = window.$; } </script> <script type="text/javascript" src="<$mt:StaticWebPath$>jquery/jquery.js"></script> <script type="text/javascript"> // Restore there jQ state, if it was loaded before if(window.__PLUG_jQ) { window.jQuery = window.__PLUG_jQ; window.$ = window.__PLUGB; window.__PLUG_jQ = undefined; window.__PLUGB = undefined; } </script> </mt:If>

विधि बहुत सुंदर नहीं है, लेकिन यह आपको यह सुनिश्चित करने की अनुमति देता है कि दोनों jQ बिल्कुल लोड होंगे और $ / jQuery खराब नहीं होगा।

जादू का टैग

अब टैग पर विचार करें: फ़ंक्शन और ब्लॉक।

एक टैग फ़ंक्शन एक निश्चित फ़ंक्शन है जो वर्तमान संदर्भ, तर्क, शर्तों को प्राप्त करता है, और एक स्ट्रिंग देता है जिसका उपयोग किया जाएगा। टेम्प्लेट में, टैग्स को <$mt:$> माध्यम से संदर्भित किया जाता है।

क्लासिक सवाल:

टैग में अपनी सेटिंग्स कैसे प्राप्त करें?

 sub tag_somemytag { my ($ctx, $args, $cond) = @_; my $blog_id = $ctx->stash('blog_id'); my $some_param = MT->component('OurPlugin')->get_config_value('some_param', 'blog:' . $blog_id); #   my $config = MT->component('OurPlugin')->get_config_hash('blog:' . $blog_id); #    .... } ## end sub tag_somemytag

एक टैग कैसे बनाएं जो अन्य टैग का उपयोग करता है?

 sub tag_somemytag { my ($ctx, $args, $cond) = @_; my $text = "<$mt:SomeOtherTag$>"; .... my $t = MT::Template->new; $t->text($t); return $t->build($ctx) or $ctx->error($t->errstr); } ## end sub tag_somemytag

बग्स की रिपोर्ट कैसे करें?
ठीक है, वास्तव में सिर्फ $ctx->error("error message"); , लेकिन इसके अलावा "तेज" त्रुटि विधियाँ भी हैं, उदाहरण के लिए $ctx->_no_entry_error(); ।
अधिक जानकारी के लिए, $ mt / lib / MT / टेम्पलेट / प्रसंग देखें ।pm

एक ब्लॉक टैग या तो एक लूप, या एक शर्त, या कुछ और है जिसमें "इंटर्नल" को टेम्पलेट में परिभाषित किया गया है, लेकिन ब्लॉक स्वयं निर्धारित करता है कि वे कैसे संकलित हैं। उन्हें config.yaml में टैग / ब्लॉक में वर्णित किया गया है (ऊपर देखें)। एक सरणी के लिए क्लासिक टैग लूप इस तरह दिखता है:

 sub tag_myloop { my($ctx, $args, $cond) = @_; my $builder = $ctx->stash('builder'); #       . #   ,     -  my $tokens = $ctx->stash('tokens'); #   ,     my $res = ''; my $vars = $ctx->{__stash}{vars} ||= {}; for my $i (0..$#looparray) { my $item = $looparray[$i]; #    ,        local $vars->{__item__} = $item; #     local $vars->{__first__} = $i == 0; local $vars->{__last__} = ($i==($#looparray-1)); local $vars->{__odd__} = ($i % 2) == 0; local $vars->{__even__} = ($i % 2) == 1; local $vars->{__counter__} = $i+1; defined(my $out = $builder->build($ctx, $tokens, $cond)) or return $ctx->error($builder->errstr); $res .= $out; } return $res; }

इस प्रकार, शरीर को आवश्यक संख्या में संकलित किया जाएगा, संक्षिप्त और जारी किया जाएगा। यदि आप चाहें, तो, आप एक और तर्क को बदल सकते हैं, यह एक और बात है कि यह बिल्कुल स्पष्ट नहीं होगा, इसलिए सामान्य नियम का पालन करना बेहतर है: टैग ब्लॉक आवश्यक डेटा तक पहुंच प्रदान करता है, बाकी सभी टैग और टेम्पलेट में आवश्यक होने पर ही।

कॉलबैक: कर्नेल हैक

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

चूंकि कॉलबैक के विषय को सभी अवसरों के लिए लंबे समय तक चबाया जा सकता है, इसलिए मैं केवल सबसे सरल उदाहरण दूंगा, जैसे कि पोस्ट के अंदर ट्विटर पर लिंक को स्वचालित रूप से तैनात करना।
Config.yaml में परिभाषित किया गया

  कॉलबैक:
     MT :: प्रविष्टि :: pre_save: $ OurPlugin :: Plugin :: cb_entry_pre_save
     # cms_pre_save.entry: $ OurPlugin :: Plugin :: cb_cms_pre_save_entry
     # api_pre_save.entry: $ OurPlugin :: Plugin :: cb_api_pre_save_entry

हमारे पास तीन बिंदु हैं जहां हम इसे सहेजने से पहले रिकॉर्ड के पाठ को संसाधित करने के लिए छड़ी कर सकते हैं।

MT::Entry::pre_save - डेटाबेस में सहेजने से पहले ORM हैंडलर से तुरंत कॉल किया जाता है।
cms_pre_save.entry - व्यवस्थापक पैनल के माध्यम से संपादन करते समय रिकॉर्ड सहेजने से पहले कॉल किया जाता है
api_pre_save.entry - RPC या ATOM के माध्यम से संपादन करते समय रिकॉर्ड सहेजने से पहले कॉल किया जाता है

Entry_pre_save हमारे कार्य के लिए एकदम सही है, क्योंकि हमें केवल regexp द्वारा पाठ को संसाधित करने की आवश्यकता है। तो, हम लिखते हैं:

 sub cb_entry_pre_save { my ($cb, $entry, $original) = @_; my $txt = $entry->text; if ($txt ne $original->text) { my $newtxt = $txt; # regexp from twitter-blackbird-pie plugin $newtxt =~ s/([^a-zA-Z0-9_]|^)([@\xef\xbc\xa0]+)([a-zA-Z0-9_]{1,20})(\/[a-zA-Z][a-zA-Z0-9\x80-\xff-]{0,79})?/$1@<a href="http://twitter.com/intent/user?screen_name=$3" class="twitter-action">$3</a>/ug; $entry->text($newtxt) if ($newtxt ne $txt); } return 1; } ## end sub cb_entry_pre_save

अनुप्रयोग: व्यवस्थापक सेटिंग्स

एमटी खुद को कई "अलग" भागों में विभाजित किया गया है, जिनमें से प्रत्येक को उसके प्रारंभ बिंदु से लॉन्च किया गया है। यह है:

CMS (mt.cgi, व्यवस्थापक)
टिप्पणियाँ (mt-comments.cgi, जनता से नई टिप्पणियाँ प्राप्त)
विज़ार्ड (mt-Wizard.cgi, स्थापना
Upgrader (mt-upgrade.cgi, जिसे डेटाबेस को अपडेट करते समय कहा जाता है)
खोज, खोज :: FreeText (mt-search.cgi, mt-ftsearch.cgi, साइट के सार्वजनिक भाग पर खोजें)
एक्टिविटीफीड्स (mt-feed.cgi, RSS / Atom जनरेटर)
ट्रैकबैक, नोटिफाईलिस्ट

Config.yaml एप्लिकेशन अनुभाग में प्रत्येक भाग के लिए, आप अपने स्वयं के पैरामीटर और सेटिंग्स सेट कर सकते हैं, जिसे प्लगइन विस्तार / प्रतिस्थापित करेगा। संपूर्ण खंड अत्यंत खराब तरीके से प्रलेखित है (केवल PODs में और स्वयं उपयोग देखें)।
अनुभाग का मुख्य उपयोग आपके लिए आवश्यक अजाक्स कॉल की घोषणा करना है। उदाहरण के लिए, सार्वजनिक साइट पर उपलब्ध अजाक्स विधि:

  applitcations:
     टिप्पणियाँ:
         विधि:
             record_some_info: $ OurPlugin :: Plugin :: ajax_record_some_info

और प्लगइन में इसके लिए फ़ंक्शन:

 sub ajax_record_some_info { my ($app) = @_; my $blog = $app->blog; my $result = "{'error': 'No information supplied'}"; my $user_name = $app->param('user_name'); my $info = $app->param('info'); if ($user_name && $info) { $result = do_store_info($user_name, $info); #     } $app->send_http_header(""); $app->print($result); return $app->{no_print_body} = 1; } ## end sub ajax_record_some_info

इंटरफ़ेस में कुछ प्रकार जोड़ें (कोड उत्पन्न किया जाना चाहिए, या केवल उत्पन्न पथ):

 var u = mtGetUser(); if(u && !u.is_anonymous) { jQuery.post({ url: '<mt:CGIPath encode_js='1'><mt:CommentScript encode_js='1'>', '__mode': 'record_some_info', 'user_name': u.name, 'info': 'he he' });

यहां यह महत्वपूर्ण है कि पोस्ट के लिए URL <mt: CGIPath encode_js = '1'> <mt: CommentScript encode_js = '1'> किट से प्राप्त किया जाना चाहिए, क्योंकि यह प्रत्येक स्थान पर भिन्न हो सकता है। क्लासिक समाधान एक .js फ़ाइल उत्पन्न करने के लिए है, जैसा कि एमटी खुद करता है, या हैडर टेम्पलेट में ऐसा कुछ दर्ज करता है

 <script>COMMENTS_URL = '<mt:CGIPath encode_js='1'><mt:CommentScript encode_js='1'>';</script>

और जहाँ आवश्यक हो, टिप्पणियाँ_URL का उपयोग करें।

छूटे हुए पल

मैंने एक डेटाबेस के साथ काम करने का वर्णन नहीं किया, मौजूदा लोगों का विस्तार कैसे करें और नई वस्तुओं का निर्माण कैसे करें, साथ ही साथ व्यवस्थापक पैनल और i18n प्रश्नों में अपने खुद के पृष्ठ कैसे बनाएं। इसके बारे में अगले अंक में पढ़िए।

उपयोगी लिंक

MovableType - प्लेटफ़ॉर्म की आधिकारिक वेबसाइट
MovableType Developer Center - आधिकारिक डेवलपर प्रलेखन
मंचों पर HOWTO.movabletype.org - मंच पर बहुत उपयोगी चीजें खोजने के लिए Google मदद।
mt-dev maillist उपयोगी जानकारी पकड़ने के लिए मछली पकड़ने का एक और स्थान है। थोड़ा सड़ा हुआ।

MovableType - प्लगइन विकास के कुछ अंश