आवश्यकताएँ:
चैरिटेबल प्रो 1.8.16+
चैरिटेबल एंबेसडर्स 3.0.0+

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

टेम्पलेट्स टैब आपके एंबेसडर्स सेटअप में चार सबसे विज़ुअल निर्णयों का एकमात्र घर है: कौन से टेम्पलेट परिवार रेंडर होते हैं (Legacy, Enhanced, या Visual), Enhanced परिवार कौन सा लेआउट वेरिएंट उपयोग करता है, आपका प्राथमिक एक्सेंट कलर, और आपकी कार्ड स्टाइल।

अधिकांश अन्य डिस्प्ले सेटिंग्स छोटे सब-टैब जैसे Fundraiser Page और My Campaigns पर रहती हैं, लेकिन टेम्पलेट्स ओरिएंटेशन है। यह वह जगह है जहाँ से आप शुरू करते हैं जब आप तय कर रहे होते हैं कि प्रोग्राम कैसा दिखना और महसूस होना चाहिए।

आप इसका उपयोग कब करेंगे

आप इस टैब पर तब वापस आएंगे जब भी आपके प्रोग्राम के लुक में कुछ बदलने की आवश्यकता होगी। सबसे आम कारण:

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

वहाँ कैसे पहुँचें

चैरिटेबल » एंबेसडर्स » टेम्पलेट्स पर जाएं।

टेम्पलेट्स टैब पर क्या है

सेटिंग्स के तीन समूह ऊपर से नीचे तक चलते हैं। व्यवहार में, आप आमतौर पर उन्हें क्रम में काम करेंगे: एक स्टाइल चुनें, फिर वेरिएंट या टेम्पलेट चयन को परिष्कृत करें, फिर अपनी थीमिंग को ट्यून करें।

समूह	इसमें क्या है
फ्रंटएंड टेम्पलेट स्टाइल	तीन कार्ड: लेगेसी, एन्हांस्ड, विज़ुअल। टैब पर सबसे बड़ा एकल निर्णय।
लेआउट / टेम्पलेट	एक दूसरा चयनकर्ता जो ऊपर की स्टाइल के आधार पर बदलता है। एन्हांस्ड के तहत यह 8-वेरिएंट लेआउट चयनकर्ता है। विज़ुअल के तहत यह फंडरेज़र टेम्पलेट अभियान ऑटो-कम्प्लीट है। लेगेसी के तहत छिपा हुआ।
थीमिंग	प्राइमरी एक्सेंट कलर और कार्ड स्टाइल रेडियो।

फ्रंटएंड टेम्पलेट स्टाइल

यह इस बात का मास्टर स्विच है कि आपके फंडरेज़र पेज कैसे रेंडर होते हैं। वह चुनें जो आपके प्रोग्राम के जीवन में जहाँ आप हैं, उसके लिए उपयुक्त हो।

स्टाइल	क्या रेंडर होता है	कब चुनें
लेगेसी	मूल 1.x टेम्पलेट्स और CSS, अछूता।	आपने अपने थीम में टेम्पलेट्स या CSS को कस्टमाइज़ किया है और कुछ भी बदलना नहीं चाहते हैं।
एन्हांस्ड	प्रगति बार, आइकन आँकड़े, शेयर पॉपओवर और खोज के साथ 3.0 टेम्प्लेट। वेरिएंट चॉइसर नीचे दिखाई देता है।	आप आधुनिक लुक चाहते हैं लेकिन अभी तक कस्टम अभियान टेम्प्लेट डिज़ाइन नहीं किया है।
दृश्य	हर फंडरेज़र पेज आपके द्वारा चुने गए विज़ुअल कैंपेन बिल्डर लेआउट से रेंडर होता है। टेम्प्लेट अभियान चॉइसर नीचे दिखाई देता है।	आप अधिकतम ब्रांड नियंत्रण चाहते हैं या आपकी कोई प्रायोजक-संचालित डिज़ाइन आवश्यकता है।

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

लेआउट / टेम्प्लेट (प्रासंगिक)

इस अनुभाग में क्या दिखाई देता है, यह आपके द्वारा ऊपर चुनी गई शैली पर निर्भर करता है। यह लेगेसी के तहत बिल्कुल भी नहीं दिखेगा, और यह एन्हांस्ड और विज़ुअल के बीच पूरी तरह से बदल जाता है।

• लेगेसी के तहत: यहाँ कुछ भी रेंडर नहीं होता है।
• एन्हांस्ड के तहत: 8-वेरिएंट लेआउट वेरिएंट चॉइसर। क्लासिक, स्टोरी-फॉरवर्ड, स्टैट्स-फॉरवर्ड, डोनेट-फर्स्ट, मैगज़ीन, शोकेस, शोकेस पोस्टर, या रैली चुनें।
• विज़ुअल के तहत: फंडरेज़र टेम्प्लेट कैंपेन ऑटो-कम्प्लीट। चुनें कि आपकी साइट पर कौन सा अभियान सभी फंडरेज़र पेजों के लिए डिज़ाइन स्रोत के रूप में कार्य करता है।

लेआउट चॉइसर फंडरेज़र पेज सब-टैब पर भी दिखाई देता है। वे एक ही चॉइसर हैं जो एक ही सेटिंग साझा करते हैं, इसलिए इसे उस सब-टैब से चुनें जो आपको अधिक स्वाभाविक लगे।

थीमिंग

दो सेटिंग्स आपकी साइट पर सभी एम्बेसडर्स-रेंडर्ड पेजों को प्रभावित करती हैं। उन्हें एक बार सेट करें और वे स्वचालित रूप से हर जगह प्रवाहित होते हैं।

सेटिंग	डिफ़ॉल्ट	प्रभाव
प्राथमिक एक्सेंट रंग	(थीम इनहेरिट करता है)	एन्हांस्ड और विज़ुअल दोनों मोड में प्रगति बार, प्राथमिक बटन, होवर स्टेट्स और चयनित-स्टेट हाइलाइट्स द्वारा उपयोग किया जाता है। वर्डप्रेस कलर-पिकर के माध्यम से सेट करें।
कार्ड शैली	गोल (सूक्ष्म छाया)	तीन विकल्प: फ्लैट (कोई बॉर्डर नहीं, कोई छाया नहीं), गोल (सूक्ष्म छाया), बॉर्डर्ड (1px बॉर्डर, कोई छाया नहीं)। मेरे अभियान कार्ड और फंडरेज़र डोनेट कार्ड पर लागू होता है।

थीमिंग पर एक गहरी नज़र के लिए जिसमें --cap-accent CSS वेरिएबल, थीम ओवरराइड चेन और डार्क-मोड हैंडलिंग शामिल है, थीमिंग देखें।

टेम्प्लेट टैब अन्य सब-टैब से कैसे संबंधित है

टेम्प्लेट टैब ओरिएंटेशन है। भारी प्रति-फ़ीचर सेटिंग्स अपने समर्पित सब-टैब पर रहती हैं। यहाँ नक्शा है ताकि आप जान सकें कि किसके लिए कहाँ जाना है।

सेटिंग चिंता	पर रहता है
कौन सा टेम्प्लेट परिवार	टेम्प्लेट टैब (यह पृष्ठ)।
एन्हांस्ड लेआउट वेरिएंट	टेम्पलेट्स टैब या फंडरेज़र पेज सब-टैब।
विज़ुअल टेम्पलेट अभियान	टेम्पलेट्स टैब।
फंडरेज़र पेज व्यवहार (शेयर, ब्रेडक्रंब, डोनर वॉल, क्रोम)	फंडरेज़र पेज सब-टैब।
मेरे अभियान पेज का व्यवहार (खोज, सॉर्ट, थंबनेल, शेयर)	मेरे अभियान सब-टैब।
शेयर पॉपओवर नेटवर्क पिक्स	शेयरिंग नेटवर्क।
प्रत्येक सतह पर क्यूआर कोड रेंडरिंग	क्यूआर कोड।

अधिकांश लोग अपना अधिकांश टेम्पलेट-ट्वीकिंग समय इस टेम्पलेट्स टैब और फंडरेज़र पेज सब-टैब पर बिताते हैं। बाकी छोटे ऑन/ऑफ टॉगल हैं जिन्हें आप एक बार सेट करके भूल जाएंगे।

ध्यान रखने योग्य सुझाव

कुछ चीजें जो आपके प्रोग्राम के लुक को ठीक करते समय आपका समय बचाएंगी।

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

डेवलपर संदर्भ

इस पेज का बाकी हिस्सा डेवलपर्स के लिए है जो टेम्पलेट्स टैब के व्यवहार को कस्टमाइज़ कर रहे हैं।

सेटिंग्स स्टोरेज

charitable_settings > ambassadors > ambassadors_ui_version          # 'legacy' | 'enhanced' | 'visual'
charitable_settings > ambassadors > p2p_template_campaign_id        # int (0 = none)
charitable_settings > ambassadors > ambassadors_enhanced_layout_variant
charitable_settings > ambassadors > theme_primary_color             # hex string
charitable_settings > ambassadors > theme_card_style                # 'flat' | 'rounded' | 'bordered'

सहायक

charitable_ambassadors_ui_version();                                // 'legacy' | 'enhanced' | 'visual'
charitable_ambassadors_should_use_p2p_template( $fundraiser_id );   // bool
charitable_ambassadors_fundraiser_template_is_theme_overridden();   // bool

फ़िल्टर

फ़िल्टर	डिफ़ॉल्ट	उद्देश्य
charitable_ambassadors_settings_display_fields	कम्प्यूटेड (लेगेसी फ़िल्टर नाम)	टेम्पलेट्स सब-टैब पर सेट फ़ील्ड सेट को संशोधित करें। पुराने "डिस्प्ले" टैब में फ़ील्ड जोड़ने वाले साइटों के साथ पिछड़े संगतता के लिए फ़िल्टर नाम रखा गया है।
charitable_ambassadors_visual_mode_is_available	कम्प्यूटेड	क्या इस इंस्टॉल पर विज़ुअल मोड चुना जा सकता है (प्रो संस्करण पर निर्भर करता है)।
चैरिटेबल एंबेसडर्स रैली उपलब्ध है	कम्प्यूटेड	क्या रैले लेआउट वेरिएंट कार्ड चॉइसर में दिखाई देता है (प्रो के मिनी डोनेशन विजेट पर निर्भर करता है)।
चैरिटेबल_एंबेसडर्स_यूआई_संस्करण_फोर्स	शून्य	सहेजी गई सेटिंग की परवाह किए बिना एक विशिष्ट यूआई संस्करण को बाध्य करें। ए/बी परीक्षण के लिए उपयोगी।

कार्रवाई

कार्रवाई	तर्क	जब फायर होता है
चैरिटेबल_एंबेसडर्स_यूआई_संस्करण_बदला	$old, $new	यूआई संस्करण सेटिंग एक अलग मान के साथ सहेजी गई थी।
चैरिटेबल_एंबेसडर्स_लेआउट_वेरिएंट_बदला	$old, $new	एन्हांस्ड लेआउट वेरिएंट सेटिंग एक अलग मान के साथ सहेजी गई थी।
चैरिटेबल_एंबेसडर्स_पी2पी_टेम्पलेट_कैंपेन_बदला	$old_id, $new_id	विज़ुअल मोड टेम्पलेट-कैंपेन सेटिंग सहेजी गई थी।

टेम्पलेट्स

प्रत्येक शैली की अपनी टेम्पलेट फ़ाइल या परिवार होती है:

स्टाइल	टेम्पलेट पथ
लेगेसी	templates/campaign/<filename>.php — 1.x से अपरिवर्तित
एन्हांस्ड	templates/campaign/fundraiser-page-enhanced.php (+ प्रति-वेरिएंट आंशिक)
दृश्य	रनटाइम पर फंडरेज़र के रेंडर में टेम्पलेट कैंपेन के campaign_settings_v2 को प्रतिस्थापित करता है

एन्हांस्ड और विज़ुअल के लिए थीम ओवरराइड पथ: your-theme/charitable-pro/charitable-ambassadors/fundraiser-page-enhanced.php।

क्षमताएं

सेटिंग्स एक्सेस के लिए manage_charitable_settings की आवश्यकता होती है। फ्रंट-एंड रेंडरिंग में कोई क्षमता गेट नहीं है।

अनुकूलन उदाहरण

मौजूदा इंस्टॉल पर एन्हांस्ड को फोर्स करें जिन्होंने अभी तक कोई शैली सेट नहीं की है:

add_filter( 'charitable_ambassadors_ui_version_force', function () {
    if ( ! get_option( 'charitable_settings' ) ) {
        return 'enhanced';
    }
    return null;
} );

जब भी यूआई संस्करण बदलता है तो अपने सीआरएम को वेबहुक करें:

add_action( 'charitable_ambassadors_ui_version_changed', function ( $old, $new ) {
    wp_remote_post( 'https://crm.example.com/hooks/charitable', [
        'body' => [ 'event' => 'ui_version_changed', 'from' => $old, 'to' => $new ],
    ] );
}, 10, 2 );

ब्रांड-सख्त कार्यक्रम के लिए कार्ड शैली को बॉर्डर्ड पर फोर्स करें:

add_filter( 'pre_option_charitable_settings', function ( $value ) {
    if ( ! is_array( $value ) ) {
        return $value;
    }
    if ( isset( $value['ambassadors']['theme_card_style'] ) ) {
        $value['ambassadors']['theme_card_style'] = 'bordered';
    }
    return $value;
} );

जब विज़ुअल मोड सक्रिय हो तो केवल-व्यवस्थापक बैनर जोड़ें:

add_action( 'admin_notices', function () {
    if ( 'visual' === charitable_ambassadors_ui_version() ) {
        echo '
Visual mode is active. Edit the template campaign to change every fundraiser page at once.
';
    }
} );

समापन

यह टेम्प्लेट्स टैब पर सब कुछ कवर करता है। चाहे आप अपनी पहली इंस्टॉल पर त्वरित निर्णय ले रहे हों या ब्रांड-नियंत्रित विज़ुअल सेटअप को ठीक कर रहे हों, यहीं से सब कुछ शुरू होता है। अपनी शैली चुनें, एक लेआउट चुनें, अपना एक्सेंट रंग सेट करें, और बाकी सब कुछ वहीं से अनुसरण करता है।

यदि आपके पास प्रश्न हैं या यह तय करने में सहायता की आवश्यकता है कि कौन सी शैली आपके प्रोग्राम के लिए सही है, तो हमारी सहायता टीम मदद करने में प्रसन्न है।

आप यह भी पढ़ना चाह सकते हैं

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

• फंडरेज़र पेज – प्रति-फंडरेज़र डिस्प्ले टॉगल जो एक टैब आगे रहते हैं।
• लेआउट वेरिएंट – आठ एन्हांस्ड वेरिएंट में से प्रत्येक पर एक गहरी गोता।
• विज़ुअल टेम्प्लेट मोड – विज़ुअल रेंडरिंग पाथ कैसे काम करता है और अपने टेम्प्लेट अभियान को कैसे सेट करें।
• थीमिंग – एक्सेंट रंग, --cap-accent CSS चर, और पूर्ण थीम ओवरराइड श्रृंखला।
• मेरे अभियान – एम्बेसडर-सामना करने वाले डैशबोर्ड पेज के लिए डिस्प्ले सेटिंग्स।
• एम्बेसडर में हुक और फ़िल्टर – पूर्ण डेवलपर संदर्भ।