चैरिटेबल के आंतरिक एपीआई की बदौलत चैरिटेबल दान फ़ॉर्म को विभिन्न तरीकों से अनुकूलित किया जा सकता है। सबसे अधिक अनुरोधित सुविधाओं में से एक चैरिटेबल दान फ़ॉर्म में एक या अधिक कस्टम फ़ील्ड जोड़ना है। इस पोस्ट में हम आपको कोड स्निपेट के साथ कस्टम फ़ील्ड जोड़ने के कुछ उदाहरण दिखाएंगे।
भले ही आप डेवलपर न हों, कोड स्निपेट जोड़ना आसान है। आपके पास अपनी पसंद का कोड स्निपेट प्लगइन स्थापित करने का विकल्प है, लेकिन चूंकि चैरिटेबल WPCode के साथ बहुत अच्छा काम करता है... हम मान लेंगे कि आप इस पोस्ट के लिए उसका उपयोग कर रहे हैं।
नोट: यदि आप डेवलपर हैं तो आप जानते हैं कि कोड स्निपेट को वर्डप्रेस थीम के functions.php में या उसके अपने प्लगइन में जोड़ा जा सकता है... यदि आप इस रास्ते पर जाते हैं तो हम अनुशंसा करते हैं कि आप चैरिटेबल के साथ कोड लिखने के लिए सर्वोत्तम प्रथाओं पर हमारे निर्देशों का पालन करें। आपको हमारे Charitable_Donation_Field दस्तावेज़ीकरण को भी पढ़ना चाहिए।
WPCode का उपयोग करना
पहला कदम WPCode को स्वयं स्थापित करना है। आप किसी भी अन्य वर्डप्रेस प्लगइन की तरह ही मुफ्त संस्करण को स्थापित और सक्रिय कर सकते हैं। हालांकि, चैरिटेबल में एक आसान अंतर्निहित प्रक्रिया है। कृपया WPCode के साथ कोड स्निपेट स्थापित करने और ब्राउज़ करने पर हमारे दस्तावेज़ीकरण को पढ़ें।
याद रखें कि एक बार जब यह (चैरिटेबल स्निपेट स्क्रीन के माध्यम से या कोड को कॉपी और पेस्ट करके) WPCode में जोड़ा जाता है, तो आपको इसे एक वर्णनात्मक शीर्षक देना होगा, सुनिश्चित करना होगा कि कोड का प्रकार “PHP स्निपेट” है, और आपने ऑटो-इन्सर्ट/रन एवरीवेयर का चयन किया है। स्निपेट को सक्रिय/सक्षम करें। यहाँ एक उदाहरण दिया गया है:
एक चेकबॉक्स जोड़ना
एकल चेकबॉक्स के लिए कोड स्निपेट टेक्स्ट बॉक्स से बहुत अलग नहीं है। “टाइप” के रूप में “चेकबॉक्स” का उपयोग देखें। आप इस कोड को हमारी WPCode स्निपेट लाइब्रेरी में भी देख सकते हैं।
/**
* Collect a checkbox field in the donation form.
*
* This snippet only works in Charitable 1.5 or above.
*
* Related examples:
*
* @see Register a text field (detailed example) - https://github.com/Charitable/library/blob/master/donation-form/register-new-donation-field-1.5.php
* @see Register multiple fields - https://github.com/Charitable/library/blob/master/donation-form/register-multiple-donation-fields.php
* @see The old way to add fields - https://github.com/Charitable/library/blob/master/donation-form/legacy/add-checkbox-field-to-donation-form.php
*/
function wpchar_charitable_register_new_checkbox_field() {
if ( ! class_exists("Charitable_Donation_Field" ) ) {
return;
};
/**
* Define a new checkbox field.
*/
$field = new Charitable_Donation_Field( 'new_checkbox_field', array(
'label' => __( 'New Checkbox Field', 'charitable' ),
'data_type' => 'user',
'donation_form' => array(
'type' => 'checkbox',
'show_before' => 'phone',
'required' => false,
),
'admin_form' => true,
'show_in_meta' => true,
'show_in_export' => true,
'email_tag' => array(
'description' => __( 'The new checkbox field' , 'charitable' ),
),
) );
/**
* Register the checkbox field.
*/
charitable()->donation_fields()->register_field( $field );
}
add_action( 'init', 'wpchar_charitable_register_new_checkbox_field' );अनुकूलित करने के लिए यहां मुख्य फ़ील्ड दिए गए हैं:
- लेबल। उद्धरणों के भीतर "मेरा कस्टम फ़ील्ड" टेक्स्ट को बदलें जो आप चाहते हैं कि यह उन दाताओं को दिखाई दे जो इस फ़ील्ड को सार्वजनिक दान फ़ॉर्म में देखते हैं।
- donation_form -> type। यह दान फ़ील्ड का प्रकार है (टेक्स्ट, सेलेक्ट, चेकबॉक्स, डेटपिकर आदि)। समर्थित दान फ़ील्ड प्रकारों की पूरी सूची के लिए हमारे दस्तावेज़ीकरण देखें।
- donation_form -> required। यदि आप चाहते हैं कि यह फ़ील्ड आवश्यक हो, तो इसे true पर सेट करें।
- email_tag। यदि आप चैरिटेबल में ईमेल टैग के साथ अपने ईमेल में इस फ़ील्ड में दर्ज मान को शामिल करना चाहते हैं, तो यहां एक विवरण जोड़ें ताकि आप इसे ईमेल सेटिंग्स में दिखाई दे सकें। डिफ़ॉल्ट रूप से, चैरिटेबल टैग के रूप में कुंजी मान का उपयोग करता है (इस मामले में 'my_custom_field')।
एक बार यह कोड (चैरिटेबल स्निपेट स्क्रीन के माध्यम से या कोड को कॉपी और पेस्ट करके) WPCode में आ जाए, तो सुनिश्चित करें कि आप इसे एक वर्णनात्मक शीर्षक दें, सुनिश्चित करें कि कोड प्रकार “PHP स्निपेट” है, और आपने ऑटो-इन्सर्ट/रन एवरीवेयर चुना है। स्निपेट को सक्रिय/सक्षम करें।
एक बार यह सक्रिय हो जाने पर, एक दान फ़ॉर्म पर जाएं (या तो चैरिटेबल द्वारा स्वचालित रूप से उत्पन्न या शॉर्टकोड के माध्यम से) और आपको अपना चेकबॉक्स दिखना चाहिए। 🎉
एकाधिक चेकबॉक्स
एकाधिक चेकबॉक्स जोड़ने के लिए स्निपेट में “विकल्प” जोड़ने और प्रकार को “मल्टी-चेकबॉक्स” में बदलने की आवश्यकता होती है।
नीचे दिया गया स्क्रिप्ट एकाधिक चेकबॉक्स जोड़ता है (“मल्टी-चेकबॉक्स” का उपयोग करके और हमारी WPCode स्निपेट लाइब्रेरी में भी पाया जा सकता है और आप चेकबॉक्स का उपयोग करने के अधिक वास्तविक दुनिया के उदाहरण भी देख सकते हैं जो थोड़ा और तर्क जोड़ते हैं, जैसे कि दान रसीद ऑप्ट आउट चेकबॉक्स जोड़ने का यह उदाहरण।
/**
* Add three checkboxes (the same group) in the donation form.
*
* This snippet only works in Charitable 1.5 or above.
*
*/
function wpchar_charitable_register_new_checkboxes_field() {
if ( ! class_exists("Charitable_Donation_Field" ) ) {
return;
};
/**
* Define a new checkbox field.
*/
$field = new Charitable_Donation_Field( 'new_checkboxes_field', array(
'label' => __( 'New Checkboxes Field', 'charitable' ),
'data_type' => 'user',
'donation_form' => array(
'type' => 'multi-checkbox',
'show_before' => 'phone',
'required' => false,
'options' => array (
'option_1_value' => 'Option One',
'option_2_value' => 'Option Two',
'option_3_value' => 'Option Three',
),
),
'admin_form' => true,
'show_in_meta' => true,
'show_in_export' => true,
'email_tag' => array(
'description' => __( 'The new checkbox field' , 'charitable' ),
),
) );
/**
* Register the checkbox field.
*/
charitable()->donation_fields()->register_field( $field );
}
add_action( 'init', 'wpchar_charitable_register_new_checkboxes_field' );यह आपके दान फ़ॉर्म में इस तरह दिखना चाहिए:
एक उत्तर छोड़ें