{"id":41835,"date":"2025-11-03T23:12:47","date_gmt":"2025-11-03T23:12:47","guid":{"rendered":"https:\/\/relywp.com\/?post_type=docs&p=41835"},"modified":"2025-11-15T12:21:38","modified_gmt":"2025-11-15T12:21:38","password":"","slug":"entwickleraktionen-und-filter","status":"publish","type":"docs","link":"https:\/\/relywp.com\/de\/docs\/einfache-punkte-belohnungen-woocommerce\/entwickleraktionen-und-filter\/","title":{"rendered":"Entwickler: Aktionen und Filter"},"content":{"rendered":"

Diese Seite dokumentiert alle \u00f6ffentlichen Aktionen und Filter, die in Einfache Punkte und Belohnungen (Pro)<\/strong> um das Verhalten zu erweitern oder mit benutzerdefiniertem Code zu integrieren.<\/p>\n\n\n\n

Der auf dieser Seite zur Verf\u00fcgung gestellte Code dient nur als Beispiel und sollte mit Vorsicht und nach entsprechender Pr\u00fcfung verwendet werden.<\/em><\/p>\n\n\n\n

\n\n\n\n

Lebenszyklus der Kernpunkte<\/h2>\n\n\n\n

Filter: spar_benutzer_punkte<\/code><\/h3>\n\n\n\n

\u00c4ndern Sie den zur\u00fcckgegebenen (angezeigten) Saldo f\u00fcr einen Benutzer.<\/p>\n\n\n\n

Parameter:<\/strong><\/p>\n\n\n\n

    \n
  • int $points<\/code> Gespeicherter Saldo aus der Benutzer-Meta _spar_points<\/code>.<\/li>\n\n\n\n
  • int 1TP4Benutzer_id<\/code><\/li>\n<\/ul>\n\n\n\n

    Beispiel:<\/strong><\/p>\n\n\n\n

    add_filter( 'spar_user_points', function( $points, $user_id ) {\n    \/\/ Hinzuf\u00fcgen eines virtuellen 100pt Vorschau-Bonus f\u00fcr Administratoren\n    if ( user_can( $user_id, 'manage_options' ) ) {\n        $points += 100;\n    }\n    return $points;\n}, 10, 2 );<\/code><\/pre>\n\n\n\n
    Filter: spar_update_user_points_args<\/code><\/h3>\n\n\n\n
    Argumente anpassen, bevor eine Punktaktualisierung durchgef\u00fchrt wird.<\/p>\n\n\n\n
    Parameter:<\/strong> (int $user_id, int $points, string $action, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    Aktion: spar_before_points_update<\/code><\/h3>\n\n\n\n
    Feuern Sie vor einer Aktualisierung des Gleichgewichts.<\/p>\n\n\n\n
    Parameter:<\/strong> (int $user_id, int $points, string $action, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    Aktion: spar_after_points_update<\/code><\/h3>\n\n\n\n
    Feuer nach einer Balance-Aktualisierung.<\/p>\n\n\n\n
    Parameter:<\/strong> (int $user_id, int $new_balance, int $delta, string $action, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    Aktion: spar_points_added<\/code><\/h3>\n\n\n\n
    Back-Compat-Haken, der beim Hinzuf\u00fcgen von Punkten ausgel\u00f6st wird.<\/p>\n\n\n\n
    Parameter:<\/strong> (int $user_id, int $points, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    Aktion: spar_points_removed<\/code><\/h3>\n\n\n\n
    Wird ausgel\u00f6st, wenn Punkte entfernt werden.<\/p>\n\n\n\n
    Parameter:<\/strong> (int $user_id, int $points, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    <\/h3>\n\n\n\n
    Filter: spar_points_history_per_page<\/code><\/h3>\n\n\n\n
    Steuern Sie, wie viele Protokollzeilen pro Seite im Verlauf angezeigt werden.<\/p>\n\n\n\n
    Parameter:<\/strong> (int $per_page, int $user_id)<\/code><\/p>\n\n\n\n
    Filter: spar_user_points_history<\/code><\/h3>\n\n\n\n
    \u00c4ndern Sie die zusammengestellte Antwort auf die Historie.<\/p>\n\n\n\n
    Parameter:<\/strong> (Array $result, int $user_id)<\/code> wobei $result = [ 'logs' => [], 'pagination' => [] ]<\/code>.<\/p>\n\n\n\n
    Aktion: spar_user_level_changed<\/code><\/h3>\n\n\n\n
    Wird ausgel\u00f6st, wenn ein Benutzer in eine neue Ebene wechselt.<\/p>\n\n\n\n
    Parameter:<\/strong> (int $user_id, array $new_level, array|null $previous_level, int $lifetime_total_earned)<\/code><\/p>\n\n\n\n
    \n\n\n\n
    Auftr\u00e4ge (verdienen\/abziehen)<\/h2>\n\n\n\n
    Filter und Aktionen f\u00fcr die Vergabe oder den Entzug von Punkten bei Bestellvorg\u00e4ngen.<\/p>\n\n\n\n
      \n
    • spar_bestellung_punkte_rate<\/code> - \u00dcberschreiben Sie die Berechnung der Punkte pro W\u00e4hrungseinheit.<\/li>\n\n\n\n
    • spar_order_base_points<\/code> - Basispunkte vor Tiers\/Multiplikatoren anpassen.<\/li>\n\n\n\n
    • spar_order_fixed_points<\/code> - Anpassung der Punkte der festen Ebene.<\/li>\n\n\n\n
    • spar_order_points_multiplikator<\/code> - Anpassung des effektiven Multiplikators f\u00fcr den Auftrag.<\/li>\n\n\n\n
    • spar_order_awarded_points<\/code> - Anpassung der f\u00fcr eine Bestellung vergebenen Endpunkte.<\/li>\n\n\n\n
    • spar_order_points_action_text<\/code> - \u00c4ndern Sie die Protokollnotiz f\u00fcr vergebene Auftragspunkte.<\/li>\n\n\n\n
    • spar_before_award_order_points<\/code> \/ spar_after_award_order_points<\/code> - Vor und nach der Punktevergabe.<\/li>\n\n\n\n
    • spar_bestellung_punkte_abzuziehen<\/code> - Stellen Sie ein, wie viele Punkte bei Erstattung oder Stornierung entfernt werden sollen.<\/li>\n\n\n\n
    • spar_order_deduction_action_id<\/code> - \u00c4ndern Sie die f\u00fcr das Abzugsprotokoll verwendete Aktions-ID.<\/li>\n\n\n\n
    • spar_order_deduction_action_text<\/code> - Protokollmeldung f\u00fcr Abzugsereignisse \u00e4ndern.<\/li>\n\n\n\n
    • spar_nach_Abzug_von_Bestellpunkten<\/code> - Feuer nach Abzug von Punkten aufgrund der \u00c4nderung des Auftragsstatus.<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n
      Einl\u00f6sung & Gutscheine<\/h2>\n\n\n\n
      Hooks f\u00fcr die Einl\u00f6sung von Pr\u00e4mien, die Erstellung von Gutscheinen und den Front-End-Einl\u00f6sefluss.<\/p>\n\n\n\n
        \n
      • spar_vor_belohnung_wiedereinl\u00f6sung<\/code> - Vor der Bearbeitung einer Pr\u00e4mieneinl\u00f6sung.<\/li>\n\n\n\n
      • spar_belohnung_objekt<\/code> - Passen Sie das Belohnungsfeld vor der Logik an.<\/li>\n\n\n\n
      • spar_belohnung_kosten_punkte<\/code> - \u00c4ndern Sie, wie viele Punkte erforderlich sind.<\/li>\n\n\n\n
      • spar_can_redeem_reward<\/code> - R\u00fccknahme zulassen oder verweigern.<\/li>\n\n\n\n
      • spar_belohnung_zuruecknahme_erstattet<\/code> - Wird entlassen, wenn die Einl\u00f6sung fehlschl\u00e4gt und erstattet.<\/li>\n\n\n\n
      • spar_nach_belohnung_wiedereinl\u00f6sung<\/code> - Nach erfolgreicher Einl\u00f6sung.<\/li>\n\n\n\n
      • spar_belohnung_gutschein_meta<\/code> - \u00c4ndern Sie die Metadaten f\u00fcr den Gutschein.<\/li>\n\n\n\n
      • spar_belohnung_gutschein_erstellt<\/code> - Wenn der Coupon erstellt wird.<\/li>\n\n\n\n
      • spar_voucher_claimed<\/code> - Wenn ein Gutschein in Anspruch genommen wird.<\/li>\n<\/ul>\n\n\n\n
        Frontend-Integrationshaken:<\/strong><\/p>\n\n\n\n
          \n
        • spar_before_handle_redeem_request<\/code><\/li>\n\n\n\n
        • spar_redeem_product_redirect_url<\/code><\/li>\n\n\n\n
        • spar_redeem_success_redirect<\/code><\/li>\n\n\n\n
        • spar_before_apply_coupon_from_query<\/code> \/ spar_after_apply_coupon_from_query<\/code><\/li>\n\n\n\n
        • spar_ajax_before_apply_voucher<\/code> \/ spar_ajax_after_apply_voucher<\/code><\/li>\n\n\n\n
        • spar_voucher_deferred<\/code>, spar_voucher_pending_invalid<\/code>, spar_voucher_auto_applied<\/code><\/li>\n<\/ul>\n\n\n\n
          \n\n\n\n
          E-Mails<\/h2>\n\n\n\n
          Generischer Haken f\u00fcr das Ergebnis des E-Mail-Versands, der f\u00fcr alle Typen gilt:<\/p>\n\n\n\n
          Aktion: spar_email_gesendet<\/code><\/h3>\n\n\n\n
          Parameter:<\/strong> (string $type, bool $sent, string $to, string $subject, int $user_id, string $context_id)<\/code><\/p>\n\n\n\n
            \n
          • $-Typ<\/code>: Punkte_verdient<\/code> | Gutschein_eingel\u00f6st<\/code><\/li>\n\n\n\n
          • $Kontext_id<\/code>: F\u00fcr points_earned ist dies $action_id<\/code>; f\u00fcr voucher_claimed ist dies der gutschein_code<\/code>.<\/li>\n<\/ul>\n\n\n\n
            Filter:<\/strong><\/p>\n\n\n\n
              \n
            • spar_email_points_earned_subject<\/code><\/li>\n\n\n\n
            • spar_email_points_earned_body<\/code><\/li>\n\n\n\n
            • spar_email_voucher_claimed_subject<\/code><\/li>\n\n\n\n
            • spar_email_voucher_claimed_body<\/code><\/li>\n<\/ul>\n\n\n\n
              \n\n\n\n
              Ebenen<\/h2>\n\n\n\n
                \n
              • spar_badge_icons<\/code><\/li>\n\n\n\n
              • spar_alle_ebenen<\/code><\/li>\n\n\n\n
              • spar_user_level<\/code><\/li>\n\n\n\n
              • spar_user_next_level<\/code><\/li>\n\n\n\n
              • spar_level_fortschritt<\/code><\/li>\n\n\n\n
              • spar_benutzer_punkte_multiplikator<\/code><\/li>\n<\/ul>\n\n\n\n
                \n\n\n\n
                Mein Konto \/ Shortcode UI<\/h2>\n\n\n\n
                  \n
                • spar_pr\u00e4mien_menu_label<\/code><\/li>\n\n\n\n
                • spar_account_menu_items<\/code> - Endg\u00fcltiges Men\u00fcfeld nach dem Einf\u00fcgen filtern.<\/li>\n\n\n\n
                • spar_pr\u00e4mien_uebersicht_html<\/code><\/li>\n\n\n\n
                • spar_pr\u00e4mien_sichtbare_tabs<\/code><\/li>\n\n\n\n
                • spar_before_rewards_tab<\/code><\/li>\n\n\n\n
                • spar_nach_belohnungen_tab<\/code><\/li>\n\n\n\n
                • spar_render_tab_{key}<\/code> - Schl\u00fcssel: verdienen<\/code>, Anspruch<\/code>, Ebenen<\/code>, Geschichte<\/code>, Gutscheine<\/code>.<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n
                  Gutscheine (Admin-Liste)<\/h2>\n\n\n\n
                  Filter: spar_belohnung_gutschein_pr\u00e4fixe<\/code><\/h3>\n\n\n\n
                  Passen Sie an, welche Gutscheincode-Pr\u00e4fixe in der Standard-Coupon-Liste ausgeblendet werden (z. B. Pr\u00e4miengutscheine, Empfehlungsgutscheine).<\/p>\n\n\n\n
                  Standard:<\/strong> [ 'Geschenk-', 'Gutschein-', 'Erstattung-' ]<\/code><\/p>\n\n\n\n
                  \n\n\n\n
                  Schnelle Beispiele<\/h2>\n\n\n\n
                  Vergeben Sie pauschal 50 Extrapunkte auf alle abgeschlossenen Auftr\u00e4ge f\u00fcr die VIP-Rolle:<\/strong><\/p>\n\n\n\n
                  add_filter( 'spar_order_awarded_points', function( $points, $order_id, $user_id ) {\n    if ( user_can( $user_id, 'vip_customer' ) ) {\n        $points += 50;\n    }\n    return $points;\n}, 10, 3 );<\/code><\/pre>\n\n\n\n
                  Sie ben\u00f6tigen 20% weniger Punkte, um eine Pr\u00e4mie am Black Friday einzul\u00f6sen:<\/strong><\/p>\n\n\n\n
                  add_filter( 'spar_reward_cost_points', function( $cost, $reward, $user_id ) {\n    if ( date( 'm-d' ) === '11-28' ) {\n        $cost = (int) round( $cost * 0.8 );\n    }\n    return max( 1, $cost );\n}, 10, 3 );<\/code><\/pre>\n\n\n\n
                  Ersetzen Sie den Betreff und den Text der E-Mail mit dem beanspruchten Voucher:<\/strong><\/p>\n\n\n\n
                  add_filter( 'spar_email_voucher_claimed_subject', function( $subject, $ctx ) {\n    return 'Ihre Verg\u00fcnstigung ist aktiviert! Code: ' . $ctx['voucher_code'];\n}, 10, 2 );\n\nadd_filter( 'spar_email_voucher_claimed_body', function( $body, $ctx ) {\n    return wpautop( 'Verwenden Sie Ihren Code an der Kasse, um zu sparen!' );\n}, 10, 2 );<\/code><\/pre>\n\n\n\n
                  Reagiere auf Levelaufstiege:<\/strong><\/p>\n\n\n\n
                  add_action( 'spar_user_level_changed', function( $user_id, $new_level, $prev_level ) {\n    \/\/ Tag in CRM, etc.\n}, 10, 3\n<\/code><\/pre>\n\n\n\n
                  \n\n\n\n
                  Funktionen<\/h2>\n\n\n\n
                  Punkteverwaltung (programmatisch hinzuf\u00fcgen\/entfernen)<\/h3>\n\n\n\n
                  spar_update_user_points( int $user_id, int $points, string $action, string $note = '', string $action_id = 'custom' )<\/code><\/strong><\/p>\n\n\n\n
                  Aktualisieren Sie den Saldo eines Benutzers und f\u00fcgen Sie eine Protokollzeile ein.<\/p>\n\n\n\n