आवश्यकताएँ: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

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

अब, एंबेसडर्स 3.0 चार प्रोग्राम-विशिष्ट घटनाओं को इससे जोड़ता है:

• एक बढ़ता हुआ मॉडरेशन क्यू
• एक पैरेंट कैंपेन का पहला फंडरेजर
• एक फंडरेजर अपने लक्ष्य को पार करता है
• आपका प्रोग्राम एक नया लाइफटाइम माइलस्टोन हासिल करता है

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

चार घटनाएँ

ईवेंट	जब फायर होता है	बेल-आइकन शीर्षक
मॉडरेशन क्यू स्वास्थ्य	लंबित गणना आज पहली बार एक सीमा (डिफ़ॉल्ट 5) को पार करती है।	“5 फंडरेजर समीक्षा की प्रतीक्षा कर रहे हैं”
पहला फंडरेजर	एक पैरेंट कैंपेन पर पहला फंडरेजर लाइव होता है।	“[पैरेंट टाइटल] पर पहला फंडरेजर”
लक्ष्य प्राप्त हुआ	एक फंडरेजर पहली बार अपने लक्ष्य का 100% पार करता है।	“[फंडरेजर टाइटल] ने अपना लक्ष्य हासिल किया”
कुल जुटाई गई राशि टियर	साइट-व्यापी कुल एंबेसडर-जुटाए गए राशि एक टियर सीमा ($1K, $5K, $10K, $25K, $50K, $100K, $250K, $500K, $1M) को पार करती है।	“एंबेसडर्स प्रोग्राम ने लाइफटाइम में $10,000 जुटाए”

प्रत्येक घटना एक प्रति-घटना "लैच" का उपयोग करती है जो पोस्ट-मेटा या विकल्प के रूप में संग्रहीत होती है, इसलिए पुनः फायरिंग नहीं होती है। यदि कोई फंडरेजर अपने लक्ष्य (रिफंड) से नीचे चला जाता है और फिर से उसे पार करता है, तो लैच साफ़ हो जाता है और फिर से सक्रिय हो जाता है, इसलिए आपको फिर से सूचित किया जाता है।

घटना 1: मॉडरेशन क्यू स्वास्थ्य

जब किसी दिए गए कैलेंडर दिन पर पहली बार लंबित फंडरेजर की संख्या एक सीमा (डिफ़ॉल्ट 5) को पार करती है तो फायर होता है।

जाँच इस पर आधारित है:

• एक नया फंडरेजर लंबित स्थिति में परिवर्तित होता है (इसलिए यह हर पेज लोड पर फायर नहीं होता है)।
• लंबित गणना सीमा (>=) से अधिक है।
• आज के लिए लैच अभी तक सेट नहीं किया गया है।

लैच एक दैनिक विकल्प है: _charitable_ambassadors_notif_moderation_queue_<YYYY-MM-DD>। एक बार सेट हो जाने पर, उस दिन कोई और मॉडरेशन-क्यू सूचनाएं फायर नहीं होती हैं।

सीमा को ओवरराइड करें:

add_filter( 'charitable_ambassadors_notifications_moderation_queue_threshold', function () {
    return 10;  // fire only when 10+ pending
} );

इवेंट 2: पहला धन उगाहने वाला

जब कोई पैरेंट कैम्पेन अपना पहला प्रकाशित धन उगाहने वाला प्राप्त करता है, तो यह पहली बार फायर होता है, जिस क्षण वह पैरेंट के लिए प्रोग्राम “जीवित” हो जाता है।

लैच: प्रति-पैरेंट पोस्ट-मेटा _charitable_ambassadors_notif_first_fundraiser_fired। एक बार सेट हो जाने पर, यह उस पैरेंट के लिए फिर कभी फायर नहीं होगा।

इवेंट 3: लक्ष्य प्राप्त हुआ

जब कोई धन उगाहने वाला पहली बार अपने लक्ष्य का 100% पार कर जाता है तो फायर होता है। यह जांच दान-पूर्णता के समय चलती है।

लैच: प्रति-धन उगाहने वाला पोस्ट-मेटा _charitable_ambassadors_notif_goal_reached। यदि बाद में कोई दान वापस किया जाता है और धन उगाहने वाला लक्ष्य से नीचे चला जाता है, तो लैच साफ़ हो जाता है, इसलिए यदि यह बाद में फिर से पार करता है, तो आपको फिर से सूचित किया जाएगा।

इवेंट 4: कुल जुटाई गई राशि टियर

जब साइट-व्यापी एम्बेसडर-जुटाए गए कुल राशि टियर सीमा को पार करती है तो फायर होता है। डिफ़ॉल्ट टियर:

$1,000  |  $5,000  |  $10,000  |  $25,000  |  $50,000
$100,000  |  $250,000  |  $500,000  |  $1,000,000

प्रत्येक टियर अपने आप में एक लैच है (विकल्प _charitable_ambassadors_notif_total_raised_tier_<amount>), इसलिए $1K, फिर बाद में $5K, फिर बाद में $10K को पार करना सभी अलग-अलग ट्रिगर होते हैं।

टियर सूची को कस्टमाइज़ करें:

add_filter( 'charitable_ambassadors_notifications_total_raised_tiers', function () {
    return [ 5000, 25000, 100000, 1000000 ];  // milestones we actually care about
} );

सक्रियण पर बैकफ़िल

एम्बेसडर्स 3.0 सक्रियण पर, प्लगइन हर प्रासंगिक लैच को पूर्व-निर्धारित करके ऐतिहासिक घटनाओं को दबा देता है। अन्यथा, पहले सक्रियण पर आपको वर्षों पहले पार किए गए धन उगाहने वालों के लिए “X ने लक्ष्य प्राप्त किया” की सूचनाओं की बाढ़ मिल जाएगी।

बैकफ़िल:

• हर उस पैरेंट पर _notif_first_fundraiser_fired स्टैम्प करता है जिसके पास पहले से कम से कम एक प्रकाशित धन उगाहने वाला है।
• हर उस धन उगाहने वाले पर _notif_goal_reached स्टैम्प करता है जो पहले से ही 100%+ पर है।
• हर उस टियर के लिए उपयुक्त _notif_total_raised_tier_<amount> स्टैम्प करता है जो पहले से पार हो चुका है।

आपको कोई भी ऐतिहासिक सूचनाएं दिखाई नहीं देंगी, लेकिन सक्रियण के क्षण से आगे की नई घटनाएं सामान्य रूप से फायर होंगी।

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

कुछ चीजें जो आपको सूचना पैनल का अधिकतम लाभ उठाने में मदद करेंगी, बिना उसे शोर बनने दिए।

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

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

इस पृष्ठ का बाकी हिस्सा डेवलपर्स के लिए है जो एम्बेसडर्स अधिसूचना प्रणाली को कस्टमाइज़ या विस्तारित कर रहे हैं।

मास्टर किल स्विच

यदि घंटी-आइकन सूचनाएं आपके प्रोग्राम के लिए उपयोगी नहीं हैं, तो उन्हें एक पंक्ति में अक्षम करें:

add_filter( 'charitable_ambassadors_notifications_enabled', '__return_false' );

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

प्रति-इवेंट नियंत्रण

आप पूरी सुविधा को बंद किए बिना व्यक्तिगत घटनाओं को दबा सकते हैं। प्रत्येक घटना में एक _should_fire_<event> फ़िल्टर होता है:

add_filter( 'charitable_ambassadors_notifications_should_fire_moderation_queue', '__return_false' );
add_filter( 'charitable_ambassadors_notifications_should_fire_first_fundraiser', '__return_false' );
add_filter( 'charitable_ambassadors_notifications_should_fire_goal_reached', '__return_false' );
add_filter( 'charitable_ambassadors_notifications_should_fire_total_raised', '__return_false' );

प्रत्येक को ट्रिगर समय पर apply_filters कॉल में लपेटा जाता है, इसलिए false लौटाने से पोस्ट होने से पहले अधिसूचना शॉर्ट-सर्किट हो जाती है।

इवेंट सामग्री को अनुकूलित करना

प्रत्येक इवेंट में एक _args_<event> फ़िल्टर भी होता है जो Pro के नोटिफिकेशन API को पास किए जाने से पहले args ऐरे प्राप्त करता है। शीर्षक, लिंक, बॉडी या आइकन को बदलने के लिए इसका उपयोग करें:

add_filter( 'charitable_ambassadors_notifications_args_goal_reached', function ( $args, $fundraiser_id ) {
    $args['title'] = '🎯 ' . $args['title'];
    $args['link']  = get_edit_post_link( $fundraiser_id );  // link to edit instead of view
    return $args;
}, 10, 2 );

भंडारण

लैच	कुंजी	स्कोप
मॉडरेशन कतार (दैनिक)	_charitable_ambassadors_notif_moderation_queue_<YYYY-MM-DD>	विकल्प
पहला धन उगाहने वाला (प्रति अभिभावक)	_charitable_ambassadors_notif_first_fundraiser_fired	अभिभावक पर पोस्ट-मेटा
लक्ष्य तक पहुंचा (प्रति धन उगाहने वाला)	_charitable_ambassadors_notif_goal_reached	धन उगाहने वाले पर पोस्ट-मेटा
कुल जुटाई गई राशि टियर (प्रति टियर)	_charitable_ambassadors_notif_total_raised_tier_<amount>	विकल्प

Pro API

नोटिफिकेशन Pro के सार्वजनिक API के माध्यम से पोस्ट किए जाते हैं:

Charitable_Local_Notifications::add( $args );

Args का आकार और भंडारण Pro का है; एंबेसडर बस कॉल करता है।

ध्यान दें: Charitable_Local_Notifications::add() प्रविष्टियों को संख्यात्मक रूप से अनुक्रमित सूची के रूप में संग्रहीत करता है, न कि आईडी-कुंजी वाले मानचित्र के रूप में। यदि आप अंतर्निहित भंडारण को सीधे क्वेरी करते हैं, तो इसे एक सूची मानें।

फ़िल्टर

फ़िल्टर	डिफ़ॉल्ट	उद्देश्य
charitable_ambassadors_notifications_enabled	सत्य	मास्टर किल स्विच।
charitable_ambassadors_notifications_should_fire_<event>	सत्य	प्रति-इवेंट दमन।
charitable_ambassadors_notifications_args_<event>	कम्प्यूटेड	प्रति-इवेंट args संशोधक।
charitable_ambassadors_notifications_moderation_queue_threshold	5	लंबित-गणना थ्रेशोल्ड।
charitable_ambassadors_notifications_total_raised_tiers	9 का ऐरे	बढ़ते क्रम में टियर राशि।

कार्रवाई

कार्रवाई	तर्क	जब फायर होता है
charitable_ambassadors_notification_fired	$event_slug, $args	Pro के घंटी-आइकन पर एक सूचना पोस्ट की गई थी।
charitable_ambassadors_notification_suppressed	$event_slug, $reason	एक सूचना को दबा दिया गया था (किल स्विच, प्रति-इवेंट, या लैच होल्ड)।

ट्रिगर क्लास

Charitable_Ambassadors_Notification_Triggers::get_instance();

सिंगलटन। सभी इवेंट श्रोताओं को इसके __construct() में पंजीकृत किया जाता है। यदि आपको सर्जिकल अक्षमता की आवश्यकता है तो आप संदर्भ द्वारा विशिष्ट श्रोताओं को remove_action() कर सकते हैं।

टेस्ट-मोड बहिष्करण

कुल-उठाई गई टियर जांच _postmeta('test_mode') = '1' के रूप में चिह्नित दान को बाहर करती है। बहिष्करण Charitable_Ambassadors_Overview_Data::get_donation_aggregates() में रहता है, जिसे नोटिफ़ायर पुन: उपयोग करता है।

क्षमताएं

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

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

सामान्य ट्वीक्स। इनमें से किसी को भी अपने थीम के functions.php या साइट-विशिष्ट प्लगइन में जोड़ें।

“समीक्षा के लिए 5 फ़ंडरेज़र प्रतीक्षारत हैं” कॉपी को अपनी टीम की भाषा से बदलें:

add_filter( 'charitable_ambassadors_notifications_args_moderation_queue', function ( $args, $count ) {
    $args['title'] = sprintf( '%d fundraisers need your review (huddle time)', $count );
    return $args;
}, 10, 2 );

हर एम्बेसडर सूचना को स्लैक पर मिरर करें:

add_action( 'charitable_ambassadors_notification_fired', function ( $event_slug, $args ) {
    wp_remote_post( 'https://hooks.slack.com/...', [
        'body'    => json_encode( [
            'text' => "*{$event_slug}*: " . ( $args['title'] ?? '' ),
        ] ),
        'headers' => [ 'Content-Type' => 'application/json' ],
    ] );
}, 10, 2 );

परीक्षण के लिए “पहला फ़ंडरेज़र” लैच रीसेट करें (सूचना को फिर से चलाएं):

delete_post_meta( $parent_id, '_charitable_ambassadors_notif_first_fundraiser_fired' );
// Now the next published fundraiser on this parent will re-fire the event.

मल्टीसाइट में दो अलग-अलग साइटों के लिए अलग-अलग टियर:

add_filter( 'charitable_ambassadors_notifications_total_raised_tiers', function ( $tiers ) {
    if ( is_main_site() ) {
        return [ 25000, 100000, 500000, 1000000 ];
    }
    return [ 1000, 5000, 10000 ];
} );

समापन

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

यदि आपके पास किसी भी सूचना घटना या Pro सूचना API के बारे में प्रश्न हैं, तो हमारी सहायता टीम मदद करने में प्रसन्न है।

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

ये डॉक्स उन सुविधाओं को कवर करते हैं जो एम्बेसडर सूचनाओं को ट्रिगर करने वाली घटनाओं से सबसे निकटता से जुड़ी हुई हैं।

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