{"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":"actions-et-filtres-des-developpeurs","status":"publish","type":"docs","link":"https:\/\/relywp.com\/fr\/documents\/simple-points-rewards-woocommerce\/actions-et-filtres-des-developpeurs\/","title":{"rendered":"D\u00e9veloppeurs : Actions et filtres"},"content":{"rendered":"

Cette page pr\u00e9sente toutes les actions publiques et tous les filtres disponibles dans la base de donn\u00e9es Simple Points & Rewards (Pro)<\/strong> pour \u00e9tendre le comportement ou l'int\u00e9grer \u00e0 un code personnalis\u00e9.<\/p>\n\n\n\n

Le code fourni sur cette page n'est donn\u00e9 qu'\u00e0 titre d'exemple et doit \u00eatre utilis\u00e9 avec prudence et en effectuant des tests appropri\u00e9s.<\/em><\/p>\n\n\n\n

\n\n\n\n

Cycle de vie des points essentiels<\/h2>\n\n\n\n

Filtre : spar_user_points<\/code><\/h3>\n\n\n\n

Modifier le solde restitu\u00e9 (affichage) pour un utilisateur.<\/p>\n\n\n\n

Param\u00e8tres :<\/strong><\/p>\n\n\n\n

    \n
  • int $points<\/code> Solde stock\u00e9 \u00e0 partir des m\u00e9ta utilisateurs Points d'\u00e9pargne<\/code>.<\/li>\n\n\n\n
  • int $user_id<\/code><\/li>\n<\/ul>\n\n\n\n

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

    add_filter( 'spar_user_points', function( $points, $user_id ) {\n    \/\/ Ajout d'un bonus virtuel de 100pt pour les administrateurs\n    if ( user_can( $user_id, 'manage_options' ) ) {\n        $points += 100 ;\n    }\n    return $points ;\n}, 10, 2 ) ;<\/code><\/pre>\n\n\n\n
    Filtre : spar_update_user_points_args<\/code><\/h3>\n\n\n\n
    Ajuster les arguments avant l'application d'une mise \u00e0 jour des points.<\/p>\n\n\n\n
    Param\u00e8tres :<\/strong> (int $user_id, int $points, string $action, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    Action : spar_before_points_update<\/code><\/h3>\n\n\n\n
    Le feu avant une mise \u00e0 jour de l'\u00e9quilibre.<\/p>\n\n\n\n
    Param\u00e8tres :<\/strong> (int $user_id, int $points, string $action, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    Action : spar_after_points_update<\/code><\/h3>\n\n\n\n
    Feu apr\u00e8s une mise \u00e0 jour de l'\u00e9quilibre.<\/p>\n\n\n\n
    Param\u00e8tres :<\/strong> (int $user_id, int $new_balance, int $delta, string $action, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    Action : spar_points_added<\/code><\/h3>\n\n\n\n
    Le crochet de r\u00e9trocompatibilit\u00e9 est d\u00e9clench\u00e9 lorsque des points sont ajout\u00e9s.<\/p>\n\n\n\n
    Param\u00e8tres :<\/strong> (int $user_id, int $points, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    Action : spar_points_supprim\u00e9s<\/code><\/h3>\n\n\n\n
    D\u00e9clench\u00e9 lorsque des points sont retir\u00e9s.<\/p>\n\n\n\n
    Param\u00e8tres :<\/strong> (int $user_id, int $points, string $note, string $action_id)<\/code><\/p>\n\n\n\n
    <\/h3>\n\n\n\n
    Filtre : spar_points_histoire_par_page<\/code><\/h3>\n\n\n\n
    Contr\u00f4le le nombre de lignes de journal par page affich\u00e9es dans l'historique.<\/p>\n\n\n\n
    Param\u00e8tres :<\/strong> (int $per_page, int $user_id)<\/code><\/p>\n\n\n\n
    Filtre : histoire_des_points_des_utilisateurs_de_spar_spar_spar_spar_spar_users_points_history<\/code><\/h3>\n\n\n\n
    Modifier la r\u00e9ponse de l'historique assembl\u00e9.<\/p>\n\n\n\n
    Param\u00e8tres :<\/strong> (tableau $result, int $user_id)<\/code> o\u00f9 $result = [ 'logs' => [], 'pagination' => [] ]<\/code>.<\/p>\n\n\n\n
    Action : spar_user_level_changed<\/code><\/h3>\n\n\n\n
    D\u00e9clench\u00e9 lorsqu'un utilisateur passe \u00e0 un nouveau niveau.<\/p>\n\n\n\n
    Param\u00e8tres :<\/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
    Commandes (gagner\/d\u00e9duire)<\/h2>\n\n\n\n
    Filtres et actions permettant d'attribuer ou de supprimer des points lors d'\u00e9v\u00e9nements de commande.<\/p>\n\n\n\n
      \n
    • taux_de_points_de_ordre_de_spar<\/code> - Ignorer le calcul des points par unit\u00e9 mon\u00e9taire.<\/li>\n\n\n\n
    • points_de_base_de_l'ordre_de_spar<\/code> - Ajuster les points de base avant les paliers\/multiplicateurs.<\/li>\n\n\n\n
    • spar_order_fixed_points<\/code> - Ajuster les points fixes.<\/li>\n\n\n\n
    • multiplicateur_de_points_de_ordre_de_spar<\/code> - Ajuster le multiplicateur effectif pour l'ordre.<\/li>\n\n\n\n
    • points_ordre_attribu\u00e9s_spar<\/code> - Ajuster le nombre final de points attribu\u00e9s \u00e0 une commande.<\/li>\n\n\n\n
    • spar_order_points_action_text<\/code> - Modifier la note de journal pour les points d'ordre attribu\u00e9s.<\/li>\n\n\n\n
    • points d'ordre spar_before_award_order_points<\/code> \/ points d'ordre spar_after_award<\/code> - Avant et apr\u00e8s l'attribution des points.<\/li>\n\n\n\n
    • spar_order_points_to_deduct<\/code> - Ajuster le nombre de points \u00e0 retirer en cas de remboursement ou d'annulation.<\/li>\n\n\n\n
    • spar_order_deduction_action_id<\/code> - Modifier l'identifiant de l'action utilis\u00e9 pour l'enregistrement des d\u00e9ductions.<\/li>\n\n\n\n
    • spar_order_deduction_action_text<\/code> - Modifier le message du journal pour les \u00e9v\u00e9nements de d\u00e9duction.<\/li>\n\n\n\n
    • spar_after_deduct_order_points<\/code> - Feu apr\u00e8s d\u00e9duction des points en raison d'une modification de l'\u00e9tat de la commande.<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n
      Remboursement et bons<\/h2>\n\n\n\n
      Hooks relatifs \u00e0 l'\u00e9change de r\u00e9compenses, \u00e0 la cr\u00e9ation de bons et au flux d'\u00e9change frontal.<\/p>\n\n\n\n
        \n
      • spar_before_reward_redemption<\/code> - Avant de traiter un \u00e9change de primes.<\/li>\n\n\n\n
      • objet_de_la_r\u00e9compense_de_la_spar<\/code> - Ajustez le tableau des r\u00e9compenses avant la logique.<\/li>\n\n\n\n
      • points_de_r\u00e9compense_de_co\u00fbt_de_spar<\/code> - Modifier le nombre de points requis.<\/li>\n\n\n\n
      • spar_can_redeem_reward<\/code> - Autoriser ou refuser le rachat.<\/li>\n\n\n\n
      • spar_reward_redemption_refunded<\/code> - Renvoy\u00e9 en cas d'\u00e9chec du rachat et rembours\u00e9.<\/li>\n\n\n\n
      • spar_after_reward_redemption<\/code> - Apr\u00e8s un rachat r\u00e9ussi.<\/li>\n\n\n\n
      • spar_reward_voucher_meta<\/code> - Modifier le coupon de r\u00e9duction m\u00e9ta.<\/li>\n\n\n\n
      • spar_reward_voucher_created<\/code> - Lors de la cr\u00e9ation d'un poste de coupon.<\/li>\n\n\n\n
      • spar_voucher_claimed<\/code> - Lorsqu'un bon est r\u00e9clam\u00e9.<\/li>\n<\/ul>\n\n\n\n
        Crochets d'int\u00e9gration frontale :<\/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
          Courriels<\/h2>\n\n\n\n
          Crochet g\u00e9n\u00e9rique de r\u00e9sultat d'envoi d'email partag\u00e9 par tous les types :<\/p>\n\n\n\n
          Action : spar_email_sent<\/code><\/h3>\n\n\n\n
          Param\u00e8tres :<\/strong> (string $type, bool $sent, string $to, string $subject, int $user_id, string $context_id)<\/code><\/p>\n\n\n\n
            \n
          • Type $<\/code>: points_gagn\u00e9s<\/code> | voucher_claimed<\/code><\/li>\n\n\n\n
          • $context_id<\/code>: Pour les points_gagn\u00e9s, c'est $action_id<\/code>; pour voucher_claimed, il s'agit du code_voucher<\/code>.<\/li>\n<\/ul>\n\n\n\n
            Filtres :<\/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
              Niveaux<\/h2>\n\n\n\n
                \n
              • ic\u00f4nes de badges spar_badge<\/code><\/li>\n\n\n\n
              • tous_les_niveaux<\/code><\/li>\n\n\n\n
              • Niveau de l'utilisateur<\/code><\/li>\n\n\n\n
              • spar_user_next_level<\/code><\/li>\n\n\n\n
              • progr\u00e8s_niveau_de_spar<\/code><\/li>\n\n\n\n
              • multiplicateur de points spar_utilisateur<\/code><\/li>\n<\/ul>\n\n\n\n
                \n\n\n\n
                Mon compte \/ Shortcode UI<\/h2>\n\n\n\n
                  \n
                • spar_rewards_menu_label<\/code><\/li>\n\n\n\n
                • \u00e9l\u00e9ments de menu du compte spar<\/code> - Filtre le tableau de menu final apr\u00e8s l'insertion.<\/li>\n\n\n\n
                • spar_rewards_overview_html<\/code><\/li>\n\n\n\n
                • spar_rewards_visible_tabs<\/code><\/li>\n\n\n\n
                • spar_before_rewards_tab<\/code><\/li>\n\n\n\n
                • onglet spar_after_rewards_tab<\/code><\/li>\n\n\n\n
                • spar_render_tab_{key}<\/code> - Cl\u00e9s : gagner<\/code>, demande<\/code>, niveaux<\/code>, l'histoire<\/code>, bons<\/code>.<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n
                  Coupons (liste administrative)<\/h2>\n\n\n\n
                  Filtre : Pr\u00e9fixes des coupons spar_r\u00e9compense<\/code><\/h3>\n\n\n\n
                  Ajustez les pr\u00e9fixes des codes de coupon qui sont masqu\u00e9s dans le tableau de la liste des coupons par d\u00e9faut (par exemple, les bons de r\u00e9compense, les coupons de parrainage).<\/p>\n\n\n\n
                  Par d\u00e9faut :<\/strong> ['gift-', 'voucher-', 'ref-' ]<\/code><\/p>\n\n\n\n
                  \n\n\n\n
                  Exemples rapides<\/h2>\n\n\n\n
                  Attribution de 50 points suppl\u00e9mentaires sur toutes les commandes pass\u00e9es pour le r\u00f4le VIP :<\/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
                  Il faut 20% points en moins pour obtenir une r\u00e9compense lors du Black Friday :<\/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
                  Remplacer l'objet et le corps de l'e-mail de r\u00e9clamation de bons d'\u00e9tudes :<\/strong><\/p>\n\n\n\n
                  add_filter( 'spar_email_voucher_claimed_subject', function( $subject, $ctx ) {\n    return 'Votre bon est en ligne ! Code : ' . $ctx['voucher_code'] ;\n}, 10, 2 ) ;\n\nadd_filter( 'spar_email_voucher_claimed_body', function( $body, $ctx ) {\n    return wpautop('Utilisez votre code \u00e0 la caisse pour \u00e9conomiser. Profitez-en!') ;\n}, 10, 2 ) ;<\/code><\/pre>\n\n\n\n
                  R\u00e9agir aux mont\u00e9es en niveau :<\/strong><\/p>\n\n\n\n
                  add_action( 'spar_user_level_changed', function( $user_id, $new_level, $prev_level ) {\n    \/\/ Etiqueter dans le CRM, etc.\n}, 10, 3\n<\/code><\/pre>\n\n\n\n
                  \n\n\n\n
                  Fonctions<\/h2>\n\n\n\n
                  Gestion des points (ajout\/suppression programmatique)<\/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
                  Mise \u00e0 jour du solde d'un utilisateur et insertion d'une ligne de journal.<\/p>\n\n\n\n