🤲🏻 👩🏻‍✈️ 💄 WordPress में metaboxes बनाना 🏉 🧑🏿‍🤝‍🧑🏽 ✅

आपके प्लगइन द्वारा साइट संरचना में पेश किए गए पोस्ट के विशिष्ट गुणों को मेटाबोक्स का उपयोग करके कॉन्फ़िगर किया गया है। ये सभी आवश्यक सेटिंग्स वाले पैनल हैं। वे संपादन स्क्रीन पर स्थित हैं।

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

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

फौजों को घर देना

प्रयोगात्मक उद्देश्यों के लिए, हम सबसे सरल प्लग-इन बनाएंगे। इसमें एक स्क्रिप्ट होगी। चलो इसे मेटाटैस्ट कहते हैं। पीपीपी और इसे सीधे wp-content में डालें।

प्लग-इन को सक्रिय करने के बाद पोस्ट एडिट पेज पर मेटाबोक्स के लिए यहां न्यूनतम आवश्यक है:

<?php /* * Plugin Name: metatest */ add_action('add_meta_boxes', 'metatest_init'); function metatest_init() { add_meta_box('metatest', 'MetaTest- ', 'metatest_showup', 'post', 'side', 'default'); } function metatest_showup() { echo '<p>   </p>'; } ?>

फिलहाल जब आपको अपना मेटाबॉक्स बनाना चाहिए, तो add_meta_boxes हुक सक्रिय हो गया है। हमने मेटाटैस्ट_इनिट फ़ंक्शन को इसके साथ जोड़ दिया, जिससे पोस्ट एडिटिंग स्क्रीन के साइड पैनल पर 'मेटाटेस्ट-पोस्ट पैरामीटर' बॉक्स बना। इसकी सामग्री metatest_showup फ़ंक्शन द्वारा बनाई गई हैं। परिणाम "थंबनेल रिकॉर्डिंग" और "टैग" बक्से के बीच स्थित है:

यहाँ सभी कार्य add_meta_box फ़ंक्शन द्वारा किया जाता है। इसकी परिभाषा इस प्रकार है:

 function add_meta_box( $id, $title, $callback, $screen = null, $context = 'advanced', $priority = 'default', $callback_args = null) ...

उपस्थिति और सामग्री पहले तीन तर्कों द्वारा निर्दिष्ट की गई हैं: $ id - मेटाबॉक्‍स पहचानकर्ता, $ शीर्षक - शीर्षक, $ कॉलबैक - फ़ंक्शन जो मेटाबॉक्‍स की सामग्री लौटाता है।

स्क्रीन बनाते समय, पहचानकर्ता $ आईडी मेटाबोक्स वाले अनुभाग को दिया जाता है। चेकबॉक्स की पहचानकर्ता जो बॉक्स डिस्प्ले को परिभाषित करता है और स्क्रीन सेटिंग्स में स्थित है, "{$ id} -hide" के रूप में बनता है।

यह स्टाइल सेट करते समय या स्क्रिप्ट में उपयोग किए जाने पर उपयोगी हो सकता है।

अन्य सभी तर्क वैकल्पिक हैं।

उनमें से तीन निम्नलिखित स्थान निर्धारित करते हैं: $ स्क्रीन - स्क्रीन एक विशिष्ट प्रकार के पोस्ट को संपादित करने के लिए, $ संदर्भ - इस स्क्रीन पर स्थिति, $ प्राथमिकता - एक ही स्क्रीन पर स्थित बक्से के संबंध में प्राथमिकता और उसी संदर्भ में।

$ स्क्रीन तर्क का मूल्य वास्तव में, उन पदों का प्रकार है जिनके संपादन पृष्ठ का मतलब है। मूल रूप से वर्डप्रेस के मालिक, ये 'पोस्ट' (पोस्ट), 'पेज' (पेज) और 'अटैचमेंट' (मीडिया और अन्य अटैचमेंट) हैं। यदि मान सेट नहीं किया गया है (या शून्य के बराबर), मेटाबॉक्स सभी स्क्रीन पर मौजूद होगा, भले ही पोस्ट के प्रकार संपादित किए गए हों।

$ संदर्भ में निर्दिष्ट स्थिति निम्नलिखित में से एक हो सकती है: 'सामान्य' - मुख्य संपादन तत्व - केंद्रीय स्तंभ का ऊपरी हिस्सा; 'उन्नत' - अतिरिक्त तत्व - केंद्रीय स्तंभ का निचला हिस्सा; 'साइड' - एक साइड पैनल, स्क्रीन में दो कॉलम होने चाहिए। मैन्युअल परिवर्तन के बाद, वर्डप्रेस मेटाबोक्स की स्थिति को याद रखता है और add_meta_box में निर्दिष्ट चूक को अनदेखा करता है। इसलिए, प्लेसमेंट के साथ खुद को परिचित करने के लिए, आप विभिन्न संदर्भों में एक ही बॉक्स के तीन और जोड़ सकते हैं:

 foreach (array('normal', 'advanced', 'side') as $context) add_meta_box('metatest_' . $context, 'MetaTest ' . $context, 'metatest_meta_box_showup', 'post', $context, 'default');

$ प्राथमिकता तर्क दूसरों पर पैनल प्लेसमेंट की प्राथमिकता निर्धारित करता है। प्राथमिकता जितनी अधिक होगी, पहले वाला पैनल उतारा जाएगा। संभावित प्राथमिकता मान, अवरोही क्रम में: 'उच्च', 'कोर', 'डिफ़ॉल्ट', 'कम'।

$ Callback_args में, $ कॉलबैक फ़ंक्शन के लिए एक मनमाना पैरामीटर पारित किया जाता है। यह दो तर्क देता है: एक संपादन योग्य पोस्ट (WP_Post वर्ग का एक उदाहरण) और मेटाबोक्स जानकारी। जानकारी एक सरणी में निहित है, जिसकी कुंजी लगभग तर्कों के साथ समान होती है add_meta_box: 'id', 'title', 'callback' और 'args'। $ Callback_args का मूल्य 'args' में रखा गया है:

 function showup_fn($post, $box) { $args = $box['args']; ... }

आप एक सरणी के रूप में कई तर्क पास कर सकते हैं

 array('var0' => $var0, 'var1' => $var1, ...)

फ़ंक्शन अभिव्यक्ति के अंदर

 extract($box['args']);

मौजूदा दायरे में $ varN चर डालेंगे।

मेटाडाटा

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

इनपुट फ़ील्ड के गठन और उपलब्ध मानों (या डिफ़ॉल्ट मानों) के आउटपुट को मेटाबोक्स ड्राइंग फ़ंक्शन को सौंपा गया है। जानकारी डेटाबेस से निकाली गई है और इनपुट क्षेत्र में रखी गई है:

 function metatest_showup($post, $box) { //    $data = get_post_meta($post->ID, '_metatest_data', true); //   echo '<p>: <input type="text" name="metadata_field" value="' . esc_attr($data) . '"/></p>'; }

फिलहाल, आवश्यक मेटाडेटा डेटाबेस में सम्‍मिलित नहीं है, और इनपुट फ़ील्ड खाली होगी। इसे भरने से अभी कुछ नहीं मिलेगा। बचत लागू नहीं है और वर्डप्रेस क्षेत्र पर प्रतिक्रिया नहीं देता है।

फ़ंक्शन सहेजें

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

 add_action('save_post', 'metatest_save'); function metatest_save($postID) { ... }

फ़ंक्शन के लिए पहला (और, इस मामले में, एकमात्र) तर्क पद की पहचानकर्ता को बचाया जा रहा है। सहेजे गए पोस्ट को get_post ($ postID) कॉल करके या दूसरे तर्क द्वारा प्राप्त किया जा सकता है:

 function metatest_save($postID, $post) ...

इस मामले में, स्वीकृत तर्कों की संख्या स्पष्ट रूप से चौथे add_action पैरामीटर में सेट की जानी चाहिए:

 add_action('save_post', 'metatest_save', 10, 2);

जैसा कि पारमार्थिक पैरामीटर - हमारे फ़ंक्शन के निष्पादन की प्राथमिकता - इसका डिफ़ॉल्ट मान (wp- शामिल / plugin.php से) लिया गया है।

'Save_post' क्रिया दो तर्कों के साथ की जाती है: पोस्ट आइडेंटिफ़ायर और पोस्ट खुद WP_ost क्लास के उदाहरण के रूप में। इसलिए, अधिक तर्कों में कोई अर्थ नहीं है।

Metatest_save फ़ंक्शन हमारे प्लगइन में दूसरों की तुलना में थोड़ा अधिक जटिल है। उसकी योजना इस तरह दिखती है:
* हमारे मेटाबॉक्स से जानकारी की उपलब्धता की जांच करें;
* इसे स्वीकार करने वाले पोस्ट की जांच करें;
* सुनिश्चित करें कि इसके स्रोत की प्रामाणिकता;
* डेटा की शुद्धता को नियंत्रित करता है और संभावित खतरनाक दृश्यों को समाप्त करता है;
* अंत में, हम डेटाबेस में स्वच्छ जानकारी सहेजते हैं।

चेकों

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

 if (!isset($_POST['metadata_field'])) return;

यदि कोई फ़ील्ड नहीं है, तो बाहर निकलें।

लक्ष्य पोस्ट से जुड़े कुछ महत्वपूर्ण बिंदु हैं।

पहला क्षण - संशोधन। एक पोस्ट का प्रत्येक नया संशोधन अपनी पिछली सामग्रियों को एक संशोधन में विस्थापित करता है - एक बच्चा, अपरिवर्तनीय पोस्ट। इस मामले में, एक और 'save_post' सक्रिय है, पहले से ही संशोधन पहचानकर्ता के साथ। इस प्रकार, metatest_save फ़ंक्शन को दो बार कहा जाएगा, और कॉल में एकमात्र अंतर $ पोस्टआईडी का मूल्य है।

मेटाडेटा का स्वामी पद है। इसलिए, संशोधन को बचाने पर ध्यान नहीं दिया जाना चाहिए:

 if (wp_is_post_revision($postID)) return;

यदि तर्क में पारित पहचानकर्ता संशोधन के अंतर्गत आता है तो wp_is_post_revision फ़ंक्शन सत्य हो जाता है।

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

पोस्ट के लिए बनाया गया ऑटोसैव एक प्रकार का संशोधन है। अपने पहचानकर्ता के जवाब में, wp_is_post_revision फ़ंक्शन भी सही लौटेगा। लेकिन एक ख़तरा है: जब ऑटोसैविंग ड्राफ्ट होता है, तो save_post हुक पोस्ट के पहचानकर्ता के साथ सक्रिय होता है, और यह फ़ंक्शन काम नहीं करेगा।

विशेष wp_is_post_autosave के बारे में भी यही कहा जा सकता है: यह तभी काम करेगा जब पद पहले से ही स्वत: सहेज लिया गया हो:

 if (wp_is_post_autosave($postID)) { //    ,  $postID //   . }

इस स्थिति में, आपको wp_ajax_autosave फ़ंक्शन द्वारा सही पर सेट होने वाले निरंतर DOING_AUTOSAVE पर भरोसा करना चाहिए, जो कि सर्वर द्वारा स्वतः सहेजा गया डेटा प्राप्त करते समय कहा जाता है। (Wp_ajax_autosave फ़ंक्शन wp-admin / ajax-actions.php में शामिल है)। उदाहरण के लिए, इसी तरह का कोड दिखाई दे सकता है:

 if (exists('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;

ऑटो-सेव जो होता है उसे $ _POST ['कार्रवाई]] ==' ऑटोसेव 'के मूल्य से भी निर्धारित किया जा सकता है।

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

स्थापना को मेटाबोक्स बॉडी फॉर्मेशन कोड में रखा जाना चाहिए:

 wp_nonce_field("metatest_action", "metatest_nonce");           : check_admin_referer("metatest_action", "metatest_nonce");

सही नियंत्रण

अब, जब हम लक्ष्य पोस्ट के साथ काम करते हैं, तो हमारे पास आवश्यक क्षेत्र होते हैं और उनके स्रोत की विश्वसनीयता में विश्वास होता है, हम उनके प्रसंस्करण के लिए आगे बढ़ सकते हैं।

सबसे पहले, संग्रहीत मेटाडेटा की शुद्धता की जांच करना आवश्यक है। दो शर्तें पूरी होनी चाहिए:
1) डेटा स्वीकार्य है;
2) डेटा सुरक्षित है;

स्वीकृति मानदंड पूरी तरह से हल की जा रही समस्या पर निर्भर करता है - स्थानान्तरण के लिए स्वीकार्य मूल्य, पाठ में अपवित्रता की अनुपस्थिति, आदि।

सुरक्षा फ़ंक्शन update_post_meta डेटाबेस के संबंध में मेटाडेटा की सुरक्षा का ध्यान रखेगा।

साइट और उपयोगकर्ताओं के संबंध में, डेटा सुरक्षा उनके आवेदन के तरीकों से निर्धारित होती है। कोई अनियंत्रित HTML कोड, मनमाने ढंग से JavaScripts की व्याख्या, दुर्भावनापूर्ण URL के लिए कमियां आदि नहीं होनी चाहिए।

हमारे मामले में, मेटाडेटा एक स्ट्रिंग है। इसलिए, उसे अनावश्यक रिक्त स्थान, हाइफ़नेशन और गलत यूनिकोड वर्णों से बचाने के लिए समझ में आता है। इन उद्देश्यों के लिए, sanitize_text_field फ़ंक्शन का उपयोग किया जाता है, जो तर्क स्ट्रिंग के सही संस्करण को लौटाता है:

 $string = sanitize_text_field($string);

परिरक्षण

डेटा रिकॉर्डिंग - फ़ंक्शन का उद्देश्य - एक कॉल में किया जाता है:

 update_post_meta($postID, '_metatest_data', $string);

अंडरस्कोर पर ध्यान दें जिसके साथ फ़ील्ड नाम शुरू होता है। यह क्षेत्र को मनमाने फ़ील्ड पैनल से अप्राप्य बनाता है।

परिणाम

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

 <?php /* * Plugin Name: metatest */ //      //     : add_action('add_meta_boxes', 'metatest_init'); add_action('save_post', 'metatest_save'); function metatest_init() { add_meta_box('metatest', 'MetaTest- ', 'metatest_showup', 'post', 'side', 'default'); }

मेटाबॉक्स ड्राइंग फ़ंक्शन को एक बार कोड के गठन के साथ फिर से बनाया गया था और अब इस तरह दिखता है:

 function metatest_showup($post, $box) { //    $data = get_post_meta($post->ID, '_metatest_data', true); //      wp_nonce_field('metatest_action', 'metatest_nonce'); //    echo '<p>: <input type="text" name="metadata_field" value="' . esc_attr($data) . '"/></p>'; }

और यहाँ डेटा भंडारण समारोह है:

 function metatest_save($postID) { //     ? if (!isset($_POST['metadata_field'])) return; //    ? if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return; //    ? if (wp_is_post_revision($postID)) return; //    check_admin_referer('metatest_action', 'metatest_nonce'); //   $data = sanitize_text_field($_POST['metadata_field']); //  update_post_meta($postID, '_metatest_data', $data); } ?>

परिणाम, "हैलो, दुनिया!" लाइन को बचाने और पृष्ठ को ताज़ा करने के बाद, इस तरह दिखना चाहिए:

जैसा कि आप देख सकते हैं, सरलतम मेटाबॉक्स बनाना आसान है। यह दो हुक पर निर्भर करता है - 'add_meta_box' और 'save_post', और दो कार्य होते हैं - फॉर्म बॉडी को आउटपुट करना और डेटा को सेव करना।

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

WordPress में metaboxes बनाना