Erfordert:
- Charitable Pro 1.8.16+
- Charitable Rewards 1.0.0+
Jeder Hook, den Charitable Rewards bereitstellt, gruppiert nach dem, was er beeinflusst. Feature-Seiten enthalten funktionierende Beispiele; dies ist der vollständige Index.
Fügen Sie Ihre Snippets zu einem websitespezifischen Plugin oder einem Code-Snippets-Plugin hinzu, nicht zur functions.php eines Themes, damit sie einen Theme-Wechsel überstehen.
Aktionen
Sechs Aktionen, von denen drei die Integrationspunkte für die Synchronisierung von Ansprüchen mit einem externen System sind.
| Aktion | Wird ausgelöst, wenn |
|---|---|
charitable_rewards_claim_confirmed | Ein Anspruch wird als bestätigt markiert, was bedeutet, dass die Spende erfolgreich war |
charitable_rewards_claim_fulfilled | Ein Anspruch wird als erfüllt markiert |
charitable_rewards_claim_revoked | Ein Anspruch wird widerrufen |
charitable_rewards_onboarding_complete | Der Einrichtungsassistent erreicht seinen letzten Schritt |
charitable_rewards_onboarding_reset | Der Einrichtungsassistent wird erneut ausgeführt |
charitable_rewards_onboarding_help_slot | Wird im Hilfe- & Onboarding-Block gerendert, für Ihre eigenen Schaltflächen |
Spendenformular und Anzeige
| Filter | Änderungen |
|---|---|
charitable_rewards_form_heading | Überschrift über dem Belohnungsblock auf einem Spendenformular |
charitable_rewards_form_heading_no_reward | Diese Überschrift, wenn keine Belohnung derzeit erreichbar ist |
charitable_rewards_thresholds_heading | Überschrift über der Liste der Schwellenwertkarten |
charitable_rewards_threshold_strip_with_cards | Ob der kompakte Schwellenwertstreifen neben den Karten gerendert wird |
charitable_rewards_summary_label | Das Belohnungslabel in der Spendenzusammenfassung |
charitable_rewards_decline_label | Der Text für die Kontrollkästchen zum Ablehnen von Belohnungen |
charitable_rewards_change_amount_level_label | Label für den Link zum Ändern der Stufe im Stufenmodus |
charitable_my_donations_change_amount_level_link | Der Link zum Ändern der Stufe selbst |
charitable_rewards_unlock_color | Akzentfarbe für den freigeschalteten Zustand |
charitable_rewards_tier_image_size | Registrierte Bildgröße für Prämienkartenbilder |
charitable_rewards_level_image_size | Registrierte Bildgröße für Bilder von Spendenstufenkarten |
charitable_rewards_view_models | Die View-Modelle für das Rendern von Karten, die von Formular und Shortcode gemeinsam genutzt werden |
charitable_reward_cards_shortcode | Ausgabe oder Attribute von [charitable_reward_cards] |
Verhalten
| Filter | Änderungen |
|---|---|
charitable_rewards_stacking_mode | Ob der Spender nur die höchste Belohnung oder alles erhält, was er angekreuzt hat. Das zweite Argument ist die Kampagnen-ID |
charitable_rewards_reservation_ttl | Wie lange eine befristete Belohnung für eine ausstehende Spende aufbewahrt wird |
charitable_rewards_backers_statuses | Welche Anspruchsstatus bei der öffentlichen Zählung von Ansprüchen berücksichtigt werden |
charitable_rewards_log_renewal_to_donor | Wird ein Verlängerungsanspruch beim Spender protokolliert |
Digitale Lieferung
| Filter | Änderungen |
|---|---|
charitable_rewards_download_url_ttl | Lebensdauer in Sekunden einer signierten Download-URL. Standard 604800, sieben Tage |
charitable_rewards_allowed_file_types | Zulässige Dateitypen für den Upload digitaler Belohnungen |
charitable_rewards_max_file_size | Upload-Größenobergrenze |
Erfüllung
| Filter | Änderungen |
|---|---|
charitable_rewards_carriers | Die Liste der Spediteure, die bei der Aufzeichnung der Sendungsverfolgung angeboten wird |
Belege und Steuern
| Filter | Änderungen |
|---|---|
charitable_rewards_receipt_heading | Überschrift des Belohnungsblocks auf einem Beleg |
charitable_rewards_receipt_pending_note | Hinweis, der bei einem noch nicht erfüllten Anspruch angezeigt wird |
charitable_rewards_tax_receipt_heading | Überschrift über dem Steuerhinweis |
charitable_rewards_tax_receipt_disclaimer | Der Wortlaut des Steuerhinweises |
E-Mails
Jede der drei E-Mails zeigt die gleichen vier Filter.
| Filter | |
|---|---|
| Belohnungsbestätigung | charitable_email_reward_confirmation_recipient, _default_subject, _default_headline, _default_body |
| Digitale Belohnungszustellung | charitable_email_reward_digital_delivery_recipient, _default_subject, _default_headline, _default_body |
| Belohnung versandt | charitable_email_reward_shipped_recipient, _default_subject, _default_headline, _default_body |
Jeder _default_*-Filter wird mit demselben charitable_email_reward_<email>_-Stamm wie sein Empfängerfilter vorangestellt.
Admin-Bildschirme
| Filter | Änderungen |
|---|---|
charitable_rewards_admin_tabs | Die Liste der Belohnungs-Tabs |
charitable_rewards_admin_tab_badges | Anzahl der Abzeichen auf den Tabs |
charitable_rewards_overview_range_presets | Die Voreinstellungen für den Datumsbereich des Dashboards |
charitable_rewards_overview_empty_state_html | Markup, das angezeigt wird, wenn nichts zu berichten ist |
charitable_rewards_catalog_search_limit | Wie viele Ergebnisse die Katalogsuche zurückgibt |
charitable_rewards_reports_overview_stat | Eine Statistik in der Berichte-Integration |
Einrichtungsassistent
| Filter | Änderungen |
|---|---|
charitable_rewards_onboarding_enabled | Schalten Sie den Assistenten vollständig aus |
charitable_rewards_onboarding_steps | Schritte hinzufügen, entfernen oder neu anordnen |
charitable_rewards_onboarding_capability | Wer ihn ausführen kann. Standard ist charitable_manage_rewards |
charitable_rewards_onboarding_should_show_panel | Ob das Übersichtseinstiegsfeld gerendert wird |
charitable_rewards_onboarding_campaign_limit | Wie viele Kampagnen der Anhangschritt auflistet |
charitable_rewards_onboarding_step_errors | Schrittweise Validierungsnachrichten |
charitable_rewards_onboarding_docs_url | Basis-URL für die Links "Weitere Informationen" |
charitable_rewards_onboarding_docs_url_for_step | Schrittweise Docs-URL für Deep-Linking zu einem Anker |
charitable_rewards_onboarding_video_id | Video-ID für die Kachel von Schritt 1 |
charitable_rewards_onboarding_video_file | Selbst gehostete Videodatei für die Kachel von Schritt 1 |
charitable_rewards_onboarding_video_params | Player-Parameter für die Kachel von Schritt 1 |
Umgebung, Lizenz und Integration
| Filter | Änderungen |
|---|---|
charitable_rewards_license_state | Der ermittelte Lizenzstatus |
charitable_rewards_license_grace_period_seconds | Lizenz Kulanzzeitraum |
charitable_rewards_ambassadors_active | Ob apakah Belohnungen gemeinnützige Botschafter als vorhanden betrachtet |
charitable_rewards_docs_url | Basis-URL für die Dokumentation, die außerhalb des Assistenten verwendet wird |
Funktionen
Vier Fähigkeiten, sodass der Zugriff eingeschränkt und nicht alles oder nichts sein kann.
| Fähigkeit | Erlaubt |
|---|---|
charitable_manage_rewards | Belohnungen erstellen, bearbeiten und archivieren |
charitable_fulfill_rewards | Bearbeiten Sie die Antragswarteschlange und markieren Sie Anträge als erfüllt |
charitable_view_reward_pii | Spendername und Lieferadresse anzeigen |
charitable_manage_reward_tax | Zeitwertermittlung und Steuereinstellungen ändern |
Einstellungen
Gespeichert in der Option charitable_rewards_settings, gelesen über Charitable_Rewards_Settings::get().
| Schlüssel | Standard | Zweck |
|---|---|---|
Steuerbescheinigung aktivieren | false | Zeitwertermittlung aufzeichnen und den abzugsfähigen Anteil offenlegen |
reservation_ttl_minutes | 30 | Wie lange eine befristete Belohnung für eine ausstehende Spende aufbewahrt wird |
Kampagnenspezifische Einstellungen befinden sich unter campaign_settings_v2 im settings.rewards-Array der Kampagne. Diese Schlüssel sind unter Automatischer Modus aufgeführt.
Konstanten
| Konstante | Wert | Zweck |
|---|---|---|
Charitable_Rewards_Env::MIN_PRO_VERSION | 1.8.16 | Darunter wird die Admin-Oberfläche hinter einem Hinweis gesperrt |
Charitable_Rewards_Download::DEFAULT_TTL | 604800 | Lebensdauer der signierten Download-URL in Sekunden |
Charitable_Rewards_Matcher::MODE_HIGHEST | höchste | Standard-Stacking-Modus |
Charitable_Rewards_Matcher::MODE_CUMULATIVE | kumulativ | Alternativer Stacking-Modus |
Wertobjekte
| Klasse | Exponiert |
|---|---|
Charitable_Rewards_Reward | Konstanten für Typ, Geltungsbereich, Anhangsmodell und Status |
Charitable_Rewards_Claim | Konstanten für Status und Anspruchstyp |
Charitable_Rewards_Level | Die Felder für das Spenden-Level |
Charitable_Rewards_Tax | deductible( $total, $fmv ), ein reiner Helfer |
Charitable_Rewards_Tracking | carriers(), save(), tracking_url(), parts_for_donation_reward() |
Charitable_Rewards_Shipping | field_keys(), parts_for_donation(), format_address() |
Charitable_Rewards_P2P_Source | resolve_source_campaign_id() |
Speicher
Rewards unterhält eigene Tabellen für Belohnungen, Kampagnenanhänge, Ansprüche, Anspruchsaktivitäten, Reservierungen und Kampagnen-Level. Versandadressen und Tracking-Nummern sind Spenden-Post-Metadaten und keine Tabellenspalten, die mit charitable_rewards_shipping_ bzw. charitable_rewards_tracking_ präfixiert sind.
Schemata werden hier absichtlich nicht wiedergegeben. Sie ändern sich zwischen den Versionen, und eine Kopie in der Dokumentation wird stillschweigend veraltet sein. Lesen Sie sie aus der Schema-Klasse, wenn Sie die aktuelle Struktur benötigen.
Zwei Spalten werden deklariert, aber nicht beschrieben: deductible_snapshot und tax_profile_version in der Anspruchstabelle. Der abzugsfähige Betrag wird zur Renderzeit aus dem eingefrorenen Zeitwert ermittelt. Erstellen Sie keine Berichte, die diese lesen und Daten erwarten.
Dinge, die absichtlich nicht filterbar sind
Wissenswert, damit Sie nicht danach suchen:
- Der Typ einer Belohnung nach der Erstellung. Das Verhalten ist bereits eingetreten, wenn Sie es ändern würden.
- Löschen einer Belohnung. Es gibt keinen Löschpfad; Archivierung ist der unterstützte Weg, da Ansprüche sich auf Belohnungen beziehen.
- Das Peer-to-Peer-Level-Gate. Untergeordnete Spendenformulare rendern keine geerbten Belohnungen, wenn die übergeordnete Formular im Level-Modus ist, da ein Level den Spendenbetrag festlegt und ein untergeordnetes Formular dies nicht kann. Es ist eine Fähigkeitsbeschränkung, keine Richtlinie.
Verwandt
- Charitable Rewards – die zentrale Seite.
- Automatischer Modus – kampagnenspezifische Einstellschlüssel und Kartenstatusklassen.
- Belohnungen liefern – signierte Download-URLs und Versandfelder.
- Ansprüche und Erfüllung – die drei Anspruchsaktionen im Kontext.
Hilfreiche Links
🤝 Holen Sie sich Hilfe, wenn Sie sie brauchen
📑 Finden Sie die Anleitung, die Sie benötigen
Durchsuchen Sie den Dokumentations-Hub →
⬇️ Laden Sie bewährte Strategien, Kampagnenideen und Experten-Tools herunter
Holen Sie sich das Fundraising-Kit →
🔗 Lassen Sie Ihren KI-Assistenten die Fundraising-Arbeit für Sie erledigen.
Verbinden Sie Charitable mit Ihrem KI-Assistenten →
💸 Holen Sie sich kostenlose Fundraising-Ressourcen
Besuchen Sie den Charitable Fundraising Hub →
🤔 Haben Sie Fragen zu Charitable?
Charitable FAQs →
Benötigen Sie Hilfe beim Verständnis von Begriffen und Fachjargon für gemeinnützige Organisationen?
Siehe unser Glossar für gemeinnützige Organisationen→
