Requiere:
- Charitable Pro 1.8.16+
- Charitable Rewards 1.0.0+
Cada hook que Charitable Rewards expone, agrupado por lo que afecta. Las páginas de características contienen ejemplos prácticos; este es el índice completo.
Añada sus fragmentos a un plugin específico del sitio o a un plugin de fragmentos de código, no al functions.php de un tema, para que sobrevivan a un cambio de tema.
Acciones
Seis acciones, tres de las cuales son los puntos de integración para sincronizar reclamaciones con un sistema externo.
| Acción | Se dispara cuando |
|---|---|
charitable_rewards_claim_confirmed | Una reclamación pasa a confirmada, lo que significa que la donación se ha completado. |
charitable_rewards_claim_fulfilled | Una reclamación se marca como completada. |
charitable_rewards_claim_revoked | Una reclamación es revocada. |
charitable_rewards_onboarding_complete | El asistente de configuración llega a su último paso. |
charitable_rewards_onboarding_reset | Se utiliza el asistente de configuración 'Volver a ejecutar'. |
charitable_rewards_onboarding_help_slot | Se renderiza dentro del bloque Ayuda y Onboarding, para sus propios botones. |
Formulario y visualización de donaciones
| Filtro | Cambios |
|---|---|
charitable_rewards_form_heading | Encabezado encima del bloque de recompensas en un formulario de donación. |
charitable_rewards_form_heading_no_reward | Ese encabezado cuando no hay ninguna recompensa actualmente al alcance. |
charitable_rewards_thresholds_heading | Encabezado encima de la lista de tarjetas de umbrales. |
charitable_rewards_threshold_strip_with_cards | Si la tira de umbrales compacta se renderiza junto con las tarjetas. |
charitable_rewards_summary_label | La etiqueta de recompensa en el resumen de la donación. |
charitable_rewards_decline_label | Texto de la casilla de verificación de recompensas de disminución |
charitable_rewards_change_amount_level_label | Etiqueta en el enlace cambiar tu nivel en modo de niveles |
charitable_rewards_change_amount_level_link | El enlace cambiar tu nivel en sí |
charitable_rewards_unlock_color | Color de acento para el estado desbloqueado |
charitable_rewards_tier_image_size | Tamaño de imagen registrado para las imágenes de la tarjeta de recompensa |
charitable_rewards_level_image_size | Tamaño de imagen registrado para las imágenes de la tarjeta de nivel de donación |
charitable_rewards_view_models | Los modelos de vista detrás de la representación de la tarjeta, compartidos por el formulario y el shortcode |
charitable_reward_cards_shortcode | Salida o atributos de [charitable_reward_cards] |
Comportamiento
| Filtro | Cambios |
|---|---|
charitable_rewards_stacking_mode | Si un donante recibe solo la recompensa más alta o todo lo que ha superado. El segundo argumento es el ID de la campaña |
charitable_rewards_reservation_ttl | Cuánto tiempo se retiene una recompensa limitada para una donación pendiente |
charitable_rewards_backers_statuses | Qué estados de reclamación cuentan para los recuentos de reclamaciones públicas |
charitable_rewards_log_renewal_to_donor | Si una reclamación de renovación se registra contra el donante |
Entrega digital
| Filtro | Cambios |
|---|---|
charitable_rewards_download_url_ttl | Vida útil en segundos de una URL de descarga firmada. Predeterminado 604800, siete días |
charitable_rewards_allowed_file_types | Tipos de archivo permitidos para cargas de recompensas digitales |
charitable_rewards_max_file_size | Límite de tamaño de carga |
Cumplimiento
| Filtro | Cambios |
|---|---|
charitable_rewards_carriers | La lista de transportistas ofrecida al registrar el seguimiento |
Recibos e impuestos
| Filtro | Cambios |
|---|---|
charitable_rewards_receipt_heading | Encabezado del bloque de recompensas en un recibo |
charitable_rewards_receipt_pending_note | Nota que se muestra en una reclamación no satisfecha aún |
charitable_rewards_tax_receipt_heading | Encabezado de la divulgación de impuestos |
charitable_rewards_tax_receipt_disclaimer | El texto de la divulgación de impuestos |
Correos electrónicos
Cada uno de los tres correos expone los mismos cuatro filtros.
| Correo electrónico | Filtros |
|---|---|
| Confirmación de recompensa | charitable_email_reward_confirmation_recipient, _default_subject, _default_headline, _default_body |
| Entrega digital de recompensa | charitable_email_reward_digital_delivery_recipient, _default_subject, _default_headline, _default_body |
| Recompensa enviada | charitable_email_reward_shipped_recipient, _default_subject, _default_headline, _default_body |
Cada filtro _default_* va precedido por el mismo prefijo charitable_email_reward_<email>_ que su filtro de destinatario.
Pantallas de administración
| Filtro | Cambios |
|---|---|
charitable_rewards_admin_tabs | La lista de pestañas de Recompensas |
charitable_rewards_admin_tab_badges | Insignias de recuento en las pestañas |
charitable_rewards_overview_range_presets | Los ajustes preestablecidos de rango de fechas del panel |
charitable_rewards_overview_empty_state_html | Marcado que se muestra cuando no hay nada que informar |
charitable_rewards_catalog_search_limit | Cuántos resultados devuelve la búsqueda del catálogo |
charitable_rewards_reports_overview_stat | Una estadística en la integración de Informes |
Asistente de configuración
| Filtro | Cambios |
|---|---|
charitable_rewards_onboarding_enabled | Desactivar el asistente por completo |
charitable_rewards_onboarding_steps | Añadir, eliminar o reordenar pasos |
charitable_rewards_onboarding_capability | Quién puede ejecutarlo. Por defecto es charitable_manage_rewards |
charitable_rewards_onboarding_should_show_panel | Si el panel de entrada de Resumen se representa |
charitable_rewards_onboarding_campaign_limit | Cuántas campañas lista el paso de adjuntar |
charitable_rewards_onboarding_step_errors | Mensajes de validación por paso |
charitable_rewards_onboarding_docs_url | URL base para los enlaces de Más información |
charitable_rewards_onboarding_docs_url_for_step | URL de documentación por paso, para enlazar directamente a una ancla |
charitable_rewards_onboarding_video_id | ID de vídeo para la ficha del paso 1 |
charitable_rewards_onboarding_video_file | Archivo de vídeo autoalojado para la ficha del paso 1 |
charitable_rewards_onboarding_video_params | Parámetros del reproductor para la ficha del paso 1 |
Entorno, licencia e integración
| Filtro | Cambios |
|---|---|
charitable_rewards_license_state | El estado de la licencia resuelto |
charitable_rewards_license_grace_period_seconds | Periodo de gracia de la licencia |
charitable_rewards_ambassadors_active | Si Charitable Rewards cree que Embajadores está presente |
charitable_rewards_docs_url | URL base de la documentación utilizada fuera del asistente |
Capacidades
Cuatro capacidades, por lo que el acceso puede tener un ámbito limitado en lugar de ser total.
| Capacidad | Permite |
|---|---|
charitable_manage_rewards | Crear, editar y archivar recompensas |
charitable_fulfill_rewards | Procesar la cola de reclamaciones y marcar las reclamaciones como cumplidas |
charitable_view_reward_pii | Ver nombres de donantes y direcciones de envío |
charitable_manage_reward_tax | Cambiar valores justos de mercado y configuraciones fiscales |
Configuración
Almacenado en la opción charitable_rewards_settings, leído a través de Charitable_Rewards_Settings::get().
| Clave | Predeterminado | Propósito |
|---|---|---|
habilitar_recibo_fiscal | false | Registrar el valor justo de mercado y divulgar la parte deducible |
reservation_ttl_minutes | 30 | Cuánto tiempo se retiene una recompensa limitada para una donación pendiente |
La configuración por campaña se encuentra en campaign_settings_v2 dentro de la matriz settings.rewards de la campaña. Esas claves se enumeran en Modo Automático.
Constantes
| Constante | Valor | Propósito |
|---|---|---|
Charitable_Rewards_Env::MIN_PRO_VERSION | 1.8.16 | Debajo de esto, la interfaz de administración se bloquea detrás de un aviso |
Charitable_Rewards_Download::DEFAULT_TTL | 604800 | Duración en segundos de la URL de descarga firmada |
Charitable_Rewards_Matcher::MODE_HIGHEST | más alto | Modo de apilamiento predeterminado |
Charitable_Rewards_Matcher::MODE_CUMULATIVE | acumulativo | Modo de apilamiento alternativo |
Objetos de valor
| Clase | Expone |
|---|---|
Charitable_Rewards_Reward | Constantes de tipo, alcance, modelo de adjunto y estado |
Charitable_Rewards_Claim | Constantes de estado y tipo de reclamación |
Charitable_Rewards_Level | Los campos de nivel de donación |
Charitable_Rewards_Tax | deductible( $total, $fmv ), una utilidad pura |
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() |
Almacenamiento
Rewards mantiene sus propias tablas para recompensas, adjuntos de campaña, reclamaciones, actividad de reclamaciones, reservas y niveles de campaña. Las direcciones de envío y los números de seguimiento son metadatos de la donación posterior en lugar de columnas de tabla, prefijados respectivamente con charitable_rewards_shipping_ y charitable_rewards_tracking_.
Los esquemas no se reproducen aquí a propósito. Cambian entre versiones, y una copia en la documentación se queda obsoleta silenciosamente. Léelos de la clase de esquema si necesitas la forma actual.
Se declaran dos columnas pero no se escriben: deductible_snapshot y tax_profile_version en la tabla de reclamaciones. La cifra deducible se deriva en el momento de la renderización del valor justo de mercado congelado. No crees informes que las lean esperando datos.
Cosas que deliberadamente no son filtrables
Vale la pena saberlo para que no lo busques:
- El tipo de una recompensa después de la creación. El comportamiento ya ha ocurrido para cuando lo cambiarías.
- Eliminar una recompensa. No hay ninguna ruta de eliminación; archivar es la ruta admitida, ya que las reclamaciones hacen referencia a las recompensas.
- La puerta de enlace de niveles peer-to-peer. Los formularios de donación hijos no renderizan recompensas heredadas cuando el padre está en modo de niveles, porque un nivel establece el monto de la donación y un formulario hijo no puede. Es un límite de capacidad, no una política.
Relacionado
- Recompensas Benéficas – la página principal.
- Modo Automático – claves de configuración por campaña y clases de estado de tarjeta.
- Entrega de Recompensas – URLs de descarga firmadas y campos de envío.
- Reclamaciones y Cumplimiento – las tres acciones de reclamación en contexto.
Enlaces Útiles
🤝 Obtenga ayuda cuando la necesite
Conéctese con el Soporte al Cliente →
📑 Encuentre la guía que necesita
Explore el Centro de Documentación →
⬇️ Descarga estrategias probadas, ideas de campañas y herramientas expertas
Consigue el Kit de Recaudación de Fondos →
🔗 Deja que tu Asistente de IA haga el trabajo de recaudación de fondos por ti.
Conecta Charitable a tu asistente de IA →
💸 Obtén recursos gratuitos de recaudación de fondos
Ve al Centro de Recaudación de Fondos de Charitable →
¿Tienes preguntas sobre Charitable?
Preguntas frecuentes de Charitable →
¿Necesita ayuda para entender la terminología y la jerga de las organizaciones sin ánimo de lucro?
Consulte nuestro Glosario de organizaciones sin ánimo de lucro→
