{"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":"acciones-y-filtros-para-desarrolladores","status":"publish","type":"docs","link":"https:\/\/relywp.com\/es\/docs\/simple-points-rewards-woocommerce\/acciones-y-filtros-para-desarrolladores\/","title":{"rendered":"Desarrolladores: Acciones y filtros"},"content":{"rendered":"

Esta p\u00e1gina documenta todas las acciones y filtros p\u00fablicos disponibles en Simple Points & Rewards (Pro)<\/strong> para ampliar el comportamiento o integrarlo con c\u00f3digo personalizado.<\/p>\n\n\n\n

El c\u00f3digo proporcionado en esta p\u00e1gina es s\u00f3lo un ejemplo y debe utilizarse con precauci\u00f3n y realizando las pruebas adecuadas.<\/em><\/p>\n\n\n\n

\n\n\n\n

Ciclo de vida de los puntos b\u00e1sicos<\/h2>\n\n\n\n

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

Modificar el saldo devuelto (visualizado) de un usuario.<\/p>\n\n\n\n

Par\u00e1metros:<\/strong><\/p>\n\n\n\n

    \n
  • int $points<\/code> Saldo almacenado del usuario meta puntos_espar<\/code>.<\/li>\n\n\n\n
  • int $user_id<\/code><\/li>\n<\/ul>\n\n\n\n

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

    add_filter( 'spar_user_points', function( $points, $user_id ) {\n    \/\/ A\u00f1ade una bonificaci\u00f3n virtual de 100pt para los administradores\n    if ( user_can( $user_id, 'manage_options' ) ) {\n        $points += 100;\n    }\n    return $points;\n}, 10, 2 );<\/code><\/pre>\n\n\n\n
    Filtrar: spar_update_user_points_args<\/code><\/h3>\n\n\n\n
    Ajuste los argumentos antes de aplicar una actualizaci\u00f3n de puntos.<\/p>\n\n\n\n
    Par\u00e1metros:<\/strong> (int $user_id, int $points, cadena $action, cadena $note, cadena $action_id)<\/code><\/p>\n\n\n\n
    Acci\u00f3n: spar_before_points_update<\/code><\/h3>\n\n\n\n
    Dispara antes de una actualizaci\u00f3n de saldo.<\/p>\n\n\n\n
    Par\u00e1metros:<\/strong> (int $user_id, int $points, cadena $action, cadena $note, cadena $action_id)<\/code><\/p>\n\n\n\n
    Acci\u00f3n: spar_after_points_update<\/code><\/h3>\n\n\n\n
    Dispara despu\u00e9s de una actualizaci\u00f3n de equilibrio.<\/p>\n\n\n\n
    Par\u00e1metros:<\/strong> (int $user_id, int $new_balance, int $delta, cadena $action, cadena $note, cadena $action_id)<\/code><\/p>\n\n\n\n
    Acci\u00f3n: spar_points_added<\/code><\/h3>\n\n\n\n
    El gancho de retrocompensaci\u00f3n se dispara cuando se a\u00f1aden puntos.<\/p>\n\n\n\n
    Par\u00e1metros:<\/strong> (int $user_id, int $points, cadena $note, cadena $action_id)<\/code><\/p>\n\n\n\n
    Acci\u00f3n: spar_points_removed<\/code><\/h3>\n\n\n\n
    Se activa cuando se quitan puntos.<\/p>\n\n\n\n
    Par\u00e1metros:<\/strong> (int $user_id, int $points, cadena $note, cadena $action_id)<\/code><\/p>\n\n\n\n
    <\/h3>\n\n\n\n
    Filtrar: spar_points_history_per_page<\/code><\/h3>\n\n\n\n
    Controla cu\u00e1ntas filas de registro por p\u00e1gina se muestran en el historial.<\/p>\n\n\n\n
    Par\u00e1metros:<\/strong> (int $per_page, int $user_id)<\/code><\/p>\n\n\n\n
    Filtrar: spar_user_points_history<\/code><\/h3>\n\n\n\n
    Modificar la respuesta del historial ensamblado.<\/p>\n\n\n\n
    Par\u00e1metros:<\/strong> (array $result, int $user_id)<\/code> donde $result = [ 'logs' => [], 'pagination' => [] ]<\/code>.<\/p>\n\n\n\n
    Acci\u00f3n: spar_user_level_changed<\/code><\/h3>\n\n\n\n
    Se activa cuando un usuario pasa a un nuevo nivel.<\/p>\n\n\n\n
    Par\u00e1metros:<\/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
    Pedidos (ingresos\/deducciones)<\/h2>\n\n\n\n
    Filtros y acciones para otorgar o quitar puntos durante los eventos de pedido.<\/p>\n\n\n\n
      \n
    • spar_order_points_rate<\/code> - Anular el c\u00e1lculo de puntos por unidad monetaria.<\/li>\n\n\n\n
    • spar_order_base_points<\/code> - Ajustar los puntos base antes de los niveles\/multiplicadores.<\/li>\n\n\n\n
    • spar_order_fixed_points<\/code> - Ajustar los puntos de nivel fijo.<\/li>\n\n\n\n
    • spar_order_points_multiplier<\/code> - Ajuste el multiplicador efectivo de la orden.<\/li>\n\n\n\n
    • spar_order_awarded_points<\/code> - Ajustar los puntos finales concedidos por un pedido.<\/li>\n\n\n\n
    • spar_order_points_action_text<\/code> - Modificar la nota de registro para los puntos de pedido concedidos.<\/li>\n\n\n\n
    • spar_before_award_order_points<\/code> \/ spar_after_award_order_points<\/code> - Antes y despu\u00e9s de la concesi\u00f3n de puntos.<\/li>\n\n\n\n
    • spar_order_points_to_deduct<\/code> - Ajuste el n\u00famero de puntos a eliminar en caso de reembolso o cancelaci\u00f3n.<\/li>\n\n\n\n
    • spar_order_deduction_action_id<\/code> - Cambiar el ID de acci\u00f3n utilizado para el registro de deducciones.<\/li>\n\n\n\n
    • spar_order_deduction_action_text<\/code> - Modificar el mensaje de registro para los eventos de deducci\u00f3n.<\/li>\n\n\n\n
    • spar_after_deduct_order_points<\/code> - Incendio tras restar puntos por cambio de estado del pedido.<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n
      Canje y vales<\/h2>\n\n\n\n
      Ganchos relacionados con el canje de recompensas, la creaci\u00f3n de vales y el flujo de canje del front-end.<\/p>\n\n\n\n
        \n
      • spar_before_reward_redemption<\/code> - Antes de tramitar el canje de una recompensa.<\/li>\n\n\n\n
      • spar_reward_object<\/code> - Ajuste la matriz de recompensa antes de la l\u00f3gica.<\/li>\n\n\n\n
      • spar_reward_cost_points<\/code> - Modificar el n\u00famero de puntos necesarios.<\/li>\n\n\n\n
      • spar_can_redeem_reward<\/code> - Permitir o denegar el rescate.<\/li>\n\n\n\n
      • spar_reward_redemption_refunded<\/code> - Despedido cuando falla el rescate y reembolsado.<\/li>\n\n\n\n
      • spar_after_reward_redemption<\/code> - Despu\u00e9s de la redenci\u00f3n exitosa.<\/li>\n\n\n\n
      • spar_reward_voucher_meta<\/code> - Modificar cup\u00f3n meta.<\/li>\n\n\n\n
      • spar_reward_voucher_created<\/code> - Cuando se crea el puesto de cup\u00f3n.<\/li>\n\n\n\n
      • spar_voucher_claimed<\/code> - Cuando se reclama un vale.<\/li>\n<\/ul>\n\n\n\n
        Ganchos de integraci\u00f3n frontend:<\/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_ferred<\/code>, spar_voucher_pending_invalid<\/code>, spar_voucher_auto_applied<\/code><\/li>\n<\/ul>\n\n\n\n
          \n\n\n\n
          Correos electr\u00f3nicos<\/h2>\n\n\n\n
          Gancho gen\u00e9rico de resultado de env\u00edo de correo electr\u00f3nico compartido en todos los tipos:<\/p>\n\n\n\n
          Acci\u00f3n: spar_email_sent<\/code><\/h3>\n\n\n\n
          Par\u00e1metros:<\/strong> (string $type, bool $sent, string $to, string $subject, int $user_id, string $context_id)<\/code><\/p>\n\n\n\n
            \n
          • Tipo $<\/code>: puntos_ganados<\/code> | vale_reclamado<\/code><\/li>\n\n\n\n
          • $context_id<\/code>: Para points_earned esto es $action_id<\/code>; para voucher_claimed este es el c\u00f3digo_vale<\/code>.<\/li>\n<\/ul>\n\n\n\n
            Filtros:<\/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
              Niveles<\/h2>\n\n\n\n
                \n
              • spar_badge_icons<\/code><\/li>\n\n\n\n
              • spar_todos_los_niveles<\/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_progress<\/code><\/li>\n\n\n\n
              • spar_user_points_multiplier<\/code><\/li>\n<\/ul>\n\n\n\n
                \n\n\n\n
                Mi cuenta \/ Shortcode UI<\/h2>\n\n\n\n