आवश्यकताएँ:

• चैरिटेबल प्रो 1.8.16+
• चैरिटेबल एम्बेसडर्स 3.0.0+

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

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

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

एम्बेसडर्स सेटअप विज़ार्ड ढूँढना

सक्रियण के बाद किसी भी एम्बेसडर्स एडमिन पेज पर पहली बार जाने पर सेटअप स्क्रीन स्वचालित रूप से दिखाई देती है। उसके बाद:

अपने वर्डप्रेस एडमिन में, चैरिटेबल » एम्बेसडर्स » सामान्य » सेटअप क्रियाएँ » सेटअप खोलें पर जाएँ

सेटअप स्क्रीन हमेशा उपलब्ध रहती है - आप जब चाहें तीन रास्तों में से किसी को भी फिर से चला सकते हैं, और फिर से चलाने से आपके द्वारा पहले से अनुकूलित की गई सेटिंग्स नहीं हटेंगी।

विज़ार्ड के तीन रास्ते

रास्ता 1 - विज़ार्ड

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

कदम:

#	कदम	आप क्या तय करते हैं
1	स्वागत है	परिचय + रास्ता पसंद।
2	अभियान प्रकार	आप किस प्रकार के धन उगाहने वाले अभियानों को स्वीकार करेंगे - व्यक्तिगत, टीम, टीम सदस्य।
3	अनुमोदन और आवश्यकताएँ	मैन्युअल या ऑटो-अनुमोदन। क्या एम्बेसडर्स को खाता पंजीकृत करने की आवश्यकता है। क्या उन्हें अपने ईमेल को सत्यापित करने की आवश्यकता है।
4	लॉगिन प्रवाह	जब एम्बेसडर्स को साइन इन करने की आवश्यकता होती है तो वे कहाँ उतरते हैं। (शर्तों के अधीन - यदि आपकी साइट में पहले से ही लॉगिन प्रवाह कॉन्फ़िगर है तो छोड़ दिया जाएगा।)
5	पेज	यदि आपके पास पहले से /submit-campaign/ पेज और /my-campaigns/ पेज नहीं हैं तो उन्हें तैयार करें।
6	साझा करना	फ़ंडरेज़र पेजों पर शेयर ग्रिड किन सोशल नेटवर्क्स को दिखाता है, उसे चुनें।
7	टेम्पलेट शैली	फ़ंडरेज़र पेजों के लिए लेगेसी / एन्हांस्ड / विज़ुअल रेंडरिंग चुनें।
8	ब्रांड रंग	अपना प्राथमिक एक्सेंट रंग सेट करें (एन्हांस्ड + विज़ुअल टेम्पलेट्स द्वारा उपयोग किया जाता है)। (शर्तों के अधीन - यदि आप लेगेसी टेम्पलेट्स पर बने रहते हैं तो छोड़ दिया जाएगा)।
9	स्टार्टर अभियान	वैकल्पिक रूप से एक ड्राफ्ट पीयर-टू-पीयर-सक्षम अभियान बनाएं ताकि आपके पास तुरंत एम्बेसडर फ़्लो का परीक्षण करने के लिए कुछ हो।
10	पूर्ण	क्या सेट किया गया था, अगले चरण, निकास का सारांश।

प्रत्येक चरण में हेडर में "इस चरण के बारे में अधिक जानें" लिंक होता है जो इस डॉक्स पेज को चरण के नाम पर एंकर करके खोलता है। हर चरण में "छोड़ें" बटन भी होता है ताकि आप किसी भी चीज़ को छोड़ सकें जिसे आप बाद में सेटिंग्स से कॉन्फ़िगर करना पसंद करेंगे।

पथ 2 – टेम्पलेट्स

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

छह परिदृश्य:

टेम्पलेट	इसे कब चुनें	यह क्या सेट करता है
मैराथन / वॉक-ए-थॉन	टीमों के साथ रेस-डे फ़ंडरेज़र।	व्यक्तिगत + टीम + टीम सदस्य सबमिशन, मैन्युअल अनुमोदन, ईमेल सत्यापन चालू, "स्टैट्स-फॉरवर्ड" लेआउट। स्टार्टर लक्ष्य $50K, 90-दिन की लंबाई।
स्मारक / श्रद्धांजलि	किसी व्यक्ति का सम्मान करने वाले सोलो फ़ंडरेज़र।	केवल व्यक्तिगत सबमिशन, मैन्युअल अनुमोदन, "स्टोरी-फॉरवर्ड" लेआउट। स्टार्टर लक्ष्य $10K, 60-दिन की लंबाई।
वार्षिक गाला / कार्यक्रम	वार्षिक कार्यक्रम चलाने वाली विश्वसनीय आंतरिक टीमें।	टीम + टीम सदस्य सबमिशन, स्वचालित अनुमोदन (कम घर्षण), "क्लासिक" लेआउट। स्टार्टर लक्ष्य $100K, 30-दिन की लंबाई।
स्कूल / शिक्षा	K-12 स्कूल, PTA, कक्षा फ़ंडरेज़िंग।	टीम + टीम सदस्य सबमिशन, मैन्युअल अनुमोदन, "डोनेट-फर्स्ट" लेआउट। स्टार्टर लक्ष्य $25K, 45-दिन की लंबाई।
जन्मदिन / व्यक्तिगत	शॉर्ट-बर्स्ट व्यक्तिगत फ़ंडरेज़र।	केवल व्यक्तिगत सबमिशन, ऑटो-अप्रूवल, “मैगज़ीन” लेआउट। स्टार्टर लक्ष्य $1K, 14-दिन की अवधि।
कस्टम – अपना खुद का बनाएं	उपरोक्त में से कोई भी फिट नहीं बैठता है।	कोई प्रीसेट लागू नहीं करता; आपको नियमित विज़ार्ड में डालता है।

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

पथ 3 – क्विक स्टार्ट

सबसे तेज़ पथ: एक क्लिक। क्विक स्टार्ट एक सामान्य लेकिन समझदार डिफ़ॉल्ट बंडल लागू करता है (मूल रूप से कस्टम चुनने और हर डिफ़ॉल्ट को स्वीकार करने जैसा ही), आपका सबमिट अभियान + मेरे अभियान पेज बनाता है, और आपको एक एंबेसडर लिंक साझा करने के लिए तैयार ओवरव्यू पर छोड़ देता है।

क्विक स्टार्ट का उपयोग तब करें जब:

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

आप बाद में किसी भी समय नियमित विज़ार्ड को फिर से चला सकते हैं ताकि क्विक स्टार्ट द्वारा स्वचालित रूप से लागू किए गए विकल्पों को परिष्कृत किया जा सके।

विज़ार्ड वास्तव में क्या करता है

तीनों पथों में, विज़ार्ड एक ही तरह के बदलाव करता है:

सतह	क्या छुआ जाता है
सेटिंग्स	आपके द्वारा पूरा किए गए हर चरण के लिए wp_options.charitable_settings > ambassadors > * कुंजियाँ।
पेज	पेज चरण /submit-campaign/ ([charitable_submit_campaign] के साथ) और /my-campaigns/ ([charitable_my_campaigns] के साथ) को ड्राफ्ट के रूप में बनाता है यदि वे पहले से मौजूद नहीं हैं। आप उन्हें तब प्रकाशित करते हैं जब आप तैयार हों।
स्टार्टर अभियान	स्टार्टर चरण वैकल्पिक प्लेसहोल्डर हेडर छवि और स्टार्टर कॉपी के साथ एक पीयर-टू-पीयर-सक्षम ड्राफ्ट अभियान बनाता है।
ऑनबोर्डिंग स्थिति	विज़ार्ड की प्रगति wp_options.charitable_ambassadors_onboarding में संग्रहीत होती है ताकि आप पृष्ठ बंद करने के बाद फिर से शुरू कर सकें।

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

सेटअप डेटा रीसेट करना

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

रीसेट की दोहरी पुष्टि की जाती है और लॉग किया जाता है।

“सेटअप को ध्यान देने की आवश्यकता है” पैनल

जब तक आप कम से कम एक पूर्णता पथ समाप्त नहीं कर लेते, तब तक ओवरव्यू पर एक नारंगी पैनल दिखाई देता है जो आपको सेटअप खोलने के लिए प्रेरित करता है:

आप प्रति-उपयोगकर्ता पैनल को खारिज कर सकते हैं - खारिज करना उपयोगकर्ता-मेटा में संग्रहीत होता है और अन्य व्यवस्थापकों को प्रभावित नहीं करता है।

टिप्स

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

---

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

पृष्ठ का शेष भाग डेवलपर्स के लिए ऑनबोर्डिंग प्रवाह को अनुकूलित करने के लिए है।

भंडारण

wp_option:  charitable_ambassadors_onboarding
shape:      {
              'completed_via'       => null | 'wizard' | 'template' | 'quick_start',
              'completed_at'        => null | int (epoch),
              'template_slug'       => null | string,
              'current_step'        => string (key),
              'completed_steps'     => string[],
              'panel_dismissed_by'  => int[] (user IDs),
            }

Charitable_Ambassadors_Onboarding_State::get_instance() के माध्यम से स्थिति पढ़ी/लिखी जाती है।

चरण रजिस्ट्री

10 मास्टर चरण Charitable_Ambassadors_Onboarding_Steps::get_master_steps() में परिभाषित किए गए हैं। प्रत्येक में सशर्त शाखाओं के लिए उपयोग किया जाने वाला एक can_render कॉलबल होता है। दो चरण बॉक्स से बाहर सशर्त हैं:

• login_setup – यदि साइट में पहले से ही एक गैर-डिफ़ॉल्ट लॉगिन प्रवाह कॉन्फ़िगर है तो छोड़ दिया जाता है।
• brand_color – यदि साइट लिगेसी टेम्प्लेट पर रहती है (कोई एक्सेंट रंग उपयोग नहीं किया जाता है) तो छोड़ दिया जाता है।

charitable_ambassadors_onboarding_wizard_steps फ़िल्टर के माध्यम से चरणों को जोड़ें, हटाएं या पुन: व्यवस्थित करें।

प्रति-चरण can_render

प्रत्येक चरण की रेंडर पात्रता को प्रति-चरण फ़िल्टर के माध्यम से भी ओवरराइड किया जा सकता है:

add_filter( 'charitable_ambassadors_onboarding_step_brand_color_can_render', '__return_false' );

मास्टर सूची को संशोधित किए बिना व्यक्तिगत चरणों को छिपाने के लिए इसका उपयोग करें।

टेम्प्लेट रजिस्ट्री

6 टेम्प्लेट Charitable_Ambassadors_Onboarding_Templates::get_all() में परिभाषित किए गए हैं। प्रत्येक टेम्प्लेट में है:

• label, description (केवल प्रदर्शन)
• settings – लागू करने के लिए ambassadors सेटिंग्स का बंडल
• starter – स्टार्टर अभियान के लिए डिफ़ॉल्ट (शीर्षक, विवरण, लक्ष्य, लंबाई, सुझाए गए दान)

charitable_ambassadors_onboarding_templates फ़िल्टर के माध्यम से टेम्प्लेट जोड़ें या संशोधित करें।

फ़िल्टर

फ़िल्टर	डिफ़ॉल्ट	उद्देश्य
charitable_ambassadors_onboarding_wizard_steps	10 का ऐरे	विज़ार्ड चरणों को जोड़ें, हटाएं या पुन: व्यवस्थित करें।
charitable_ambassadors_onboarding_step_<key>_can_render	true	प्रति-चरण सशर्त गेट।
charitable_ambassadors_onboarding_templates	6 का ऐरे	अतिरिक्त परिदृश्य टेम्प्लेट पंजीकृत करें।
charitable_ambassadors_onboarding_visual_template_candidates	कम्प्यूटेड	टेम्पलेट स्टाइल चरण में टेम्पलेट स्टाइल अभियान के रूप में पेश किए गए अभियानों की सूची को फ़िल्टर करें।
charitable_ambassadors_onboarding_starter_campaign_args	कम्प्यूटेड	स्टार्टर अभियान बनाने के लिए उपयोग किए जाने वाले wp_insert_post तर्कों को संशोधित करें। $args, $template_slug, $data प्राप्त करता है।
charitable_ambassadors_onboarding_starter_campaign_defaults	कम्प्यूटेड	स्टार्टर डिफ़ॉल्ट (शीर्षक, विवरण, लक्ष्य, आदि) को संशोधित करें। $defaults, $slug प्राप्त करता है।
charitable_ambassadors_onboarding_starter_suggested_donations	टेम्पलेट डिफ़ॉल्ट	स्टार्टर के लिए सुझाए गए दान राशि को ओवरराइड करें। $amounts, $template_slug प्राप्त करता है।
charitable_ambassadors_onboarding_should_show_panel	कम्प्यूटेड	“सेटअप को ध्यान देने की आवश्यकता है” पैनल को चालू या बंद करें।
charitable_ambassadors_onboarding_panel_accent	#E38632	प्रॉम्प्ट पैनल का एक्सेंट रंग।
charitable_ambassadors_onboarding_show_features / _show_resources	true	विज़ार्ड साइडबार पर फ़ीचर्स और संसाधन अनुभागों को टॉगल करें।
charitable_ambassadors_onboarding_features / _resources / _sidebar_features	कम्प्यूटेड	उन अनुभागों की सामग्री को बदलें।
charitable_ambassadors_onboarding_sidebar_illustration	SVG	साइडबार इलस्ट्रेशन को बदलें।
charitable_ambassadors_onboarding_sidebar_docs_url / _docs_label	wpcharitable.com URL	साइडबार डॉक्स लिंक को ओवरराइड करें।
charitable_ambassadors_onboarding_docs_url	यह पृष्ठ	बेस डॉक्स URL को ओवरराइड करें जिस पर प्रति-चरण “अधिक पढ़ें” लिंक हल होते हैं।
charitable_ambassadors_onboarding_docs_url_for_step	कम्प्यूटेड	प्रति-चरण डॉक्स URL ओवरराइड। $url, $step_key प्राप्त करता है।
charitable_ambassadors_onboarding_capability	manage_charitable_settings	सभी ऑनबोर्डिंग AJAX एंडपॉइंट्स के लिए क्षमता जांच।
charitable_ambassadors_quick_start_defaults	कम्प्यूटेड	क्विक स्टार्ट लागू करता है सेटिंग्स के बंडल को ओवरराइड करें।
charitable_ambassadors_onboarding_placeholder_image_meta	array	स्टार्टर अभियान द्वारा उपयोग की जाने वाली प्लेसहोल्डर हेडर छवि के लिए मेटाडेटा।
charitable_ambassadors_onboarding_path_icon	प्रति पथ SVG	पथ-पिकर पर प्रति-पथ आइकन बदलें। $svg, $slug प्राप्त करता है।

कार्रवाई

कार्रवाई	तर्क	जब फायर होता है
charitable_ambassadors_onboarding_artifact_created	$type, $post_id	एक विज़ार्ड चरण ने एक पृष्ठ या स्टार्टर अभियान बनाया। $type 'page' या 'campaign' है।
charitable_ambassadors_onboarding_complete	$via, $template_slug	तीन पथों में से कोई भी पूरा होता है। $via 'wizard', 'template', या 'quick_start' है।
charitable_ambassadors_onboarding_quick_start_applied	–	क्विक स्टार्ट पूरा हुआ (_complete के अतिरिक्त)।
charitable_ambassadors_onboarding_panel_dismissed	$user_id	एक उपयोगकर्ता ने अवलोकन प्रॉम्प्ट पैनल को खारिज कर दिया।

AJAX एंडपॉइंट्स

सभी wp_ajax_ पर ही, नॉनस एक्शन charitable_ambassadors_onboarding, क्षमता manage_charitable_settings (charitable_ambassadors_onboarding_capability के माध्यम से फ़िल्टर करने योग्य):

कार्रवाई	उद्देश्य
charitable_ambassadors_onboarding_apply_quick_start	क्विक स्टार्ट डिफ़ॉल्ट बंडल लागू करें।
charitable_ambassadors_onboarding_dismiss_panel	वर्तमान उपयोगकर्ता के लिए "सेटअप को ध्यान देने की आवश्यकता है" पैनल को खारिज करें।

(चरण-दर-चरण नेविगेशन विज़ार्ड के अपने यूआरएल पर सब-एक्शन पैरामीटर के साथ मानक फॉर्म-पोस्ट का उपयोग करता है; यह AJAX नहीं है।)

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

एक कस्टम "क्राउडफंडिंग" टेम्पलेट जोड़ें:

add_filter( 'charitable_ambassadors_onboarding_templates', function ( $templates ) {
    $templates['crowdfunding'] = [
        'label'       => 'Crowdfunding launch',
        'description' => 'High-volume short-burst campaign with auto-approve.',
        'settings'    => [
            'campaign_recipients'    => [ 'individual' ],
            'auto_approve_campaigns' => 1,
            'ui_version'             => 'enhanced',
            'enhanced_layout_variant'=> 'magazine',
        ],
        'starter' => [
            'title'       => 'Help us launch',
            'description' => 'A short, intense campaign...',
            'goal'        => 20000,
            'length_days' => 30,
            'suggested_donations' => [ 10, 25, 50, 100 ],
            'terms'       => [],
        ],
    ];
    return $templates;
} );

हर इंस्टॉल पर लॉगिन फ्लो चरण छोड़ें:

add_filter( 'charitable_ambassadors_onboarding_step_login_setup_can_render', '__return_false' );

सेटअप पैनल के एक्सेंट रंग को अपने ब्रांड से मेल खाने के लिए बदलें:

add_filter( 'charitable_ambassadors_onboarding_panel_accent', function () {
    return '#1e7e34';
} );

संबंधित

• अवलोकन डैशबोर्ड – ऑनबोर्डिंग पूरी होने तक प्रॉम्प्ट पैनल अवलोकन के शीर्ष पर रहता है।
• डिस्प्ले फ़ीचर्स – टेम्पलेट स्टाइल स्टेप के विकल्प।
• मेरे अभियान – पेजेज स्टेप द्वारा बनाए गए दो पेजों में से एक।
• अभियान सबमिट करें – पेजेज स्टेप द्वारा बनाया गया दूसरा पेज।
• एंबेसडर्स में हुक्स और फ़िल्टर – पूर्ण संदर्भ।