Redmine के लिए प्लगइन्स बनाना

Redmine के लिए प्लगइन्स बनाने की प्रक्रिया बहुत खराब दस्तावेज है। इस लेख का उद्देश्य छोटे लेकिन उपयोगी प्लगइन बनाने में सफल अनुभव के बारे में बात करके आंशिक रूप से इस अंतर को भरना है। महत्वपूर्ण नोट। Redmine रूबी ऑन रेल्स में लिखा गया है, आपको इसके लिए तैयार रहने की आवश्यकता है यदि आप अपना खुद का प्लगइन बनाने की योजना बना रहे हैं :)

प्रारंभिक कार्य

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

डेवलपर्स, बेशक, इस संबंध में कई सेटिंग्स प्रदान करते हैं, लेकिन वे बल्कि दुर्लभ हैं। मैं विशिष्ट परिवर्तनों के लिए सूचनाओं को कॉन्फ़िगर करने में सक्षम होना चाहूंगा।



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

आप ऐसे अक्षरों के लिए मेल में फ़िल्टर को कॉन्फ़िगर कर सकते हैं (आप कहते हैं), लेकिन अपना स्वयं का प्लग-इन लिखना बहुत अधिक दिलचस्प था, जो आपको प्रक्रिया में सभी प्रतिभागियों को इन सूचनाओं को समायोजित करने की अनुमति देगा (कलाकार, लेखक, पर्यवेक्षक)।

इसलिए, कार्य: एक प्लगइन बनाने के लिए जो सेटिंग को जोड़ता है "उपयोगकर्ता के खाते में कार्य बंद होने पर मुझे सूचित न करें"।

समाधान का वर्णन

मैं प्लगइन के लिए टेम्प्लेट के निर्माण को छोड़ दूंगा; इसे redmine.org पर संबंधित अनुभाग में विस्तार से वर्णित किया गया है।

एक चेकमार्क जोड़ें, "मेरे द्वारा किए गए परिवर्तनों के बारे में सूचित न करें।" ऐसा करने के लिए, बस अपने प्लगइन में \ app \ views \ users \ _mail_notifications.html.erb टेम्पलेट को कॉपी करें और आवश्यक HTML कोड जोड़ें।

यह बहुत सही नहीं है, लेकिन उपयोगकर्ता के रूप में मानक हुक : view_users_form , गलत स्थान पर चेकबॉक्स प्रदर्शित करता है। प्रत्येक नए संस्करण के साथ Redmine अधिक से अधिक हुक का समर्थन करता है, लेकिन वे हमेशा अपर्याप्त होंगे और यह मामला कोई अपवाद नहीं है।

अगला, "पैच" 3 विधियाँ, यह एक उपयोगकर्ता व्यवस्थापक बना रहा है और खाता पृष्ठ पर संपादन कर रहा है। इन विधियों के लिए कोई हुक नहीं हैं, इसलिए "बॉक्स से बाहर हुक" बचाव के लिए आया: alias_method और alias_method_chain । उनके काम का तर्क एक श्रृंखला में नाम, लिंक विधियों और लिंक विधियों से स्पष्ट है।

नियंत्रक खाता my_controller नियंत्रक, खाता विधि के लिए जिम्मेदार है। हम प्लगइन \ sub \ पैच \ my_controller_patch.rb के उपनिर्देशिका में एक फ़ाइल बनाकर इसे पैच करेंगे

module Patches module MyControllerPatch def self.included(base) #    base.extend(ClassMethods) #     base.send(:include, InstanceMethods) base.class_eval do unloadable #     alias_method_chain :account, :ext end end module ClassMethods end module InstanceMethods #     ext def account_with_ext if request.post? #           User.current.pref[:no_self_notified_closed] = (params[:no_self_notified_closed] == '1') end #    account account_without_ext end end end end 

व्यवस्थापक द्वारा बनाना और संपादित करना, इसी तरह।

इसके बाद, आपको सूचना प्राप्त करने के लिए उपयोगकर्ताओं की सूची बनाते समय सेट मान को पढ़ने की आवश्यकता है, समस्या मॉडल, प्राप्तकर्ता विधि और watcher_recipients इसके लिए जिम्मेदार हैं, उन्हें \ lib \ patches \ issue_patch.rb पर कॉपी करें और उन्हें अपने लिए बदलें।

 module Patches module IssuePatch def self.included(base) … base.class_eval do unloadable #     alias_method :recipients, :recipients_ext alias_method :watcher_recipients, :watcher_recipients_ext end end … module InstanceMethods #     def recipients_ext #       @status = IssueStatus.find_by_id(self.status_id) notified = project.notified_users #         ( allow_notify_closed) notified << author if author && author.active? && author.notify_about?(self) && allow_notify_closed?(author) if assigned_to if assigned_to.is_a?(Group) notified += assigned_to.users.select { |u| u.active? && u.notify_about?(self) && allow_notify_closed?(u) } else notified << assigned_to if assigned_to.active? && assigned_to.notify_about?(self) && allow_notify_closed?(assigned_to) end end notified.uniq! notified.reject! { |user| !visible?(user) } notified.collect(&:mail) end #  def watcher_recipients_ext notified = watcher_users.active notified.reject! { |user| user.mail_notification == 'none' || allow_notify_closed?(user) === false } if respond_to?(:visible?) notified.reject! { |user| !visible?(user) } end notified.collect(&:mail).compact end private #   ,          def allow_notify_closed?(user) (user.pref[:no_self_notified_closed] && @status.is_closed?) ? false : true end end end end 

और सबसे महत्वपूर्ण बात यह है कि हमारे पैच को कनेक्ट करना है। प्लग इन की जड़ में, init.rb फ़ाइल जोड़ें:

 # dispatcher       require 'dispatcher' Dispatcher.to_prepare do MyController.send(:include, Patches::MyControllerPatch) UsersController.send(:include, Patches::UsersControllerPatch) Issue.send(:include, Patches::IssuePatch) end 

/ विक्रेता / प्लगइन्स / फ़ोल्डर में प्लगइन स्थापित करें और पुनः आरंभ करें। यही है, अब आप सूचनाओं का प्रबंधन कर सकते हैं और अनावश्यक ईमेल प्राप्त नहीं कर सकते हैं। इस प्रकार, आप Redmine में किसी भी विधि के व्यवहार को बदल सकते हैं और अपने स्वयं के प्लगइन्स को लिख सकते हैं जो काम को स्वचालित और सुविधाजनक बनाते हैं।

स्रोत से लिंक https://github.com/parshukovvv/redmine_notice