एपीआई टू ड्रुपल के माध्यम से डेटा ट्रांसफर - निर्यात के लिए एक नया घटक जोड़ें

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


मैं एक उदाहरण के रूप में मेटाटैग मॉड्यूल का उपयोग करके यह करने के लिए कैसे समझाऊंगा।
पहले आपको features_api हुक को लागू करने की आवश्यकता है, यह "सुविधाओं" के माध्यम से निर्यात के लिए घटकों को परिभाषित करता है।

/ **
* इम्प्लीमेंट्स हुक_फिटर्स_पी ()।
* /
फ़ंक्शन मेटाटैग_फ्रीचर_एपी ( ) {
$ घटक = सरणी (
'मेटाटैग्स' => सरणी (
'नाम' => टी ( 'मेटाटैग' ) ,
'features_source' => TRUE ,
'default_hook' => 'metatag_export_default' , '
'default_file' => फीचर्स_DEFAULTS_INCLUDED ,
'फ़ाइल' => drupal_get_path ( 'मॉड्यूल' , 'मेटाटैग' ) । '/metatag.features.inc' ,
) ,
) ;
$ घटक वापस करें ;
}

यह default_hook सरणी की कुंजी पर ध्यान देने योग्य है। यह उस हुक को परिभाषित करता है जिसका उपयोग फीचर से डेटा पुनर्प्राप्त करने के लिए किया जाएगा। मुझे लगता है कि यह किसी के लिए कोई रहस्य नहीं है कि "सुविधा" एक मॉड्यूल है। हम इस मॉड्यूल में metatag_export_default हुक को लागू करते हैं और वहां निर्यात किए गए डेटा को जोड़ते हैं। बाकी हुक मैंने एक अलग मेटाटैग.फ़िएट.इन फ़ाइल में डाल दिया

एक और महत्वपूर्ण बिंदु यह है कि hook_features_api एक नियमित हुक है और MODULE_NAME_features_api की तरह काम करता है। शेष हुक, जिस पर चर्चा की जाएगी, सामान्य रूप से मॉड्यूल नाम के बजाय निर्यात किए गए घटक के नाम का उपयोग करके बनाया जाता है। उदाहरण के लिए हुक features_export_options।

इस हुक में, हम उन मदों के साथ एक सरणी लौटाते हैं जिन्हें "सुविधा" के माध्यम से स्थानांतरित किया जा सकता है। मेटाटैग मॉड्यूल के मामले में, यह विभिन्न पृष्ठ प्रकारों (उदाहरण के लिए, वैश्विक, नोड, taxonomy_term) के लिए मेटा टैग सेट करने के विकल्पों की ओर संकेत करता है।

/ **
* इम्प्लीमेंट्स हुक_फिट्स_एक्सपोर्ट_ऑप्टिशंस ()।
* /
फ़ंक्शन मेटाटैग_फ्रीचर_एक्सपोर्ट_ऑप्टेशन ( ) {
$ उदाहरण = metatag_config_instance_info ( ) ;
foreach ( $ इंस्टेंस के रूप में $ कुंजी => $ इंस्टेंस ) {
$ विकल्प [ $ कुंजी ] = $ कुंजी ;
} ;
$ विकल्प लौटाएं ;
}

नए "फ़ीचर" बनाते समय ये आइटम संबंधित मेटाटैग अनुभाग में उपलब्ध हो जाएंगे



निम्नलिखित features_export_render हुक, यह "सुविधाओं" फ़ाइल के लिए कोड उत्पन्न करता है, जिसमें निर्यात किया गया डेटा संग्रहीत होता है।

/ **
* इम्प्लीमेंट्स हुक_फिटर्स_एक्सपोर्ट_रेंडर ()।
* /
फ़ंक्शन मेटाटैग_फ्रीचर_एक्सपोर्ट_रेंडर ( $ मॉड्यूल_नाम , $ डेटा , $ निर्यात = NULL ) {
$ कोड = सरणी ( ) ;
$ कोड [ ] = '$ config = सरणी (?) ;
$ कोड [ ] = '' ;

foreach ( $ कुंजी के रूप में $ डेटा => $ नाम ) {
अगर ( is_object ( $ नाम ) ) {
$ नाम = $ नाम -> उदाहरण ;
}
अगर ( $ config = metatag_config_load ( $ नाम ) ) {
$ निर्यात = नया stdClass ( ) ;
$ निर्यात -> उदाहरण = $ विन्यास -> उदाहरण ;
$ निर्यात -> विन्यास = $ विन्यास -> विन्यास ;
$ निर्यात = features_var_export ( $ निर्यात , '' ) ;
$ कुंजी = features_var_export ( $ नाम ) ;
$ कोड [ ] = "// निर्यात किए गए मेटाटैग्स कॉन्फ़िगर उदाहरण: {$ नाम} ।" ;
$ कोड [ ] = " $ config [ {$ कुंजी} ] = {$ निर्यात} ;" ;
$ कोड [ ] = "" ;
}
}
$ कोड [ ] = '$ config लौटाएँ;' ;
$ कोड = निहित ( "एन" , $ कोड ) ;
रिटर्न ऐरे ( 'मेटाटैग_एक्सपोर्ट_डेफ़ॉल्ट' => $ कोड ) ;
}

$ डाटा ऐरे को हुक में पास किया जाता है। इसमें बहुत ही आइटम हैं जो आपने पहले स्क्रीनशॉट में "फीचर" बनाते समय चुने थे। इन बिंदुओं पर लगभग ऐसा कोड उत्पन्न होता है



कृपया ध्यान दें कि हुक कोड और स्क्रीनशॉट में समान मेटाटैग_एक्सपोर्ट_डेफ़ॉल्ट हुक दिखाया गया है जिसे हमने features_api में बहुत शुरुआत में परिभाषित किया था।

Features_export हुक आपको $ डेटा सरणी का उपयोग करके $ निर्यात सरणी में डेटा लिखने की अनुमति देता है। आप संग्रहीत डेटा की संरचना को श्रेणियों में विभाजित करके भी जटिल कर सकते हैं।

/ **
* औजार हुक_फिट्स_एक्सपोर्ट
* /
फ़ंक्शन metatags_features_export ( $ डेटा , और $ निर्यात , $ मॉड्यूल_name = '' , $ प्रकार = 'मेटाटैग' ) {

foreach ( $ नाम के रूप में $ डेटा ) {
$ निर्यात [ 'सुविधाएँ' ] [ $ प्रकार ] [ $ नाम ] = metatag_config_load ( $ नाम ) ;
}
}

"सुविधा" के माध्यम से निर्यात की गई वस्तुओं को $ डेटा सरणी में स्थानांतरित किया जाता है। इन मदों के लिए, डेटाबेस में संग्रहीत स्थिति लोड की जाती है।

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



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

दूसरा विकल्प वापस आ गया है - डेटाबेस में उस स्थिति को रीसेट करें जो "सुविधा" में संग्रहीत है। रिवर्ट करने के लिए, आपको features_revert हुक की आवश्यकता होगी।

/ **
* इम्प्लीमेंट्स हुक_फिट्स_रेवेट ()।
* /
फ़ंक्शन मेटाटैग्स_फ्रीचर_ब्रेवर ( $ मॉड्यूल ) {
$ फ़ंक्शन = " {$ मॉड्यूल} _metatag_export_default" ;
$ feature_conf = $ function ( ) ;
अगर ( $ default_config = features_get_default ( 'metatags' ) ) {
foreach ( array_keys ( $ default_config ) $ config के रूप में ) {
अगर ( $ conf = metatag_config_load ( $ config ) ) {
db_delete ( 'metatag_config' ) -> हालत ( 'उदाहरण' , $ config ) -> निष्पादित ( ) ;
}
unset ( $ feature_conf [ $ config ] [ 'cid' ] ) ;
$ वस्तु = नया stdClass ( ) ;
$ वस्तु -> cid = NULL ;
$ वस्तु -> उदाहरण = $ विन्यास ;
$ वस्तु -> config = $ feature_conf [ $ config ] [ 'config' ] ;
metatag_config_save ( $ ऑब्जेक्ट ) ;
}
}
}

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

मेटाटैग मॉड्यूल के लिए पैच से लिंक करें