Hoy lanzamos Charitable 1.5, la primera gran actualización de 2017. Esta es una actualización importante para Charitable, ya que agrega funciones muy solicitadas y mejora muchos aspectos de Charitable, tanto visibles como internos.

Lee a continuación para descubrir qué hay de nuevo.

Colaboradores

En primer lugar, me gustaría agradecer a las personas que han aportado cambios en esta versión. Sin ningún orden en particular: Jeroen Sormani, Rafe Colton, Kathy Darling, Nick Ciske, B. Scott y dsoares. ¡Gracias a todos!

Por supuesto, el código no es la única forma en que puedes contribuir a Charitable. A todos los que han dejado un comentario en un problema, han reportado un error o han ayudado con la traducción de Charitable, ¡gracias!

Las 9 mejores novedades de Charitable 1.5

Se cerraron 69 incidencias en esta versión (eso es un poco más del 23% de todas las incidencias reportadas para Charitable) y una buena parte de ellas eran para nuevas funciones. Cubriré nueve de las nuevas funciones más importantes a continuación, pero para una descripción completa de todo lo nuevo, lee el registro de cambios.

Crea y edita donaciones en el panel de WordPress

De todas las nuevas funciones de Charitable 1.5, esta es la que se ha solicitado con más frecuencia. Ahora puedes agregar nuevas donaciones directamente desde tu panel de WordPress.

Las donaciones existentes se pueden editar con la misma interfaz.

Para más información, lee la documentación detallada.

Reenviar recibos de donación (y otros correos electrónicos) desde el panel

¿Alguna vez un donante ha perdido su recibo de donación?

Ahora puedes reenviar fácilmente el recibo de un donante a través del panel de WordPress. Simplemente ve a la donación, selecciona el correo electrónico en las Acciones de donación que deseas reenviar y haz clic en el botón “Reenviar correo electrónico”.

Lea la documentación para obtener una guía paso a paso para reenviar correos electrónicos.

Por cierto, el cuadro de meta Acciones de donación es una nueva adición en la versión 1.5. Por ahora se utiliza exclusivamente para reenviar correos electrónicos, pero esperamos agregar más opciones aquí en el futuro.

Añade tu formulario de donación a una página

Otra solicitud popular ha sido una forma sencilla de incrustar un formulario de donación en una página. Eso ahora es posible con el shortcode [charitable_donation_form]:

[charitable_donation_form campaign_id=123]

¿Bastante fácil, eh? Si necesitas más detalles, lee la documentación.

Nuevos correos electrónicos para donaciones sin conexión

Un punto de dolor muy antiguo para algunos usuarios de Charitable ha sido la falta de un buen sistema de notificación por correo electrónico para donaciones sin conexión. El recibo y la notificación de administración para las donaciones solo se envían cuando una donación se marca como Pagada, lo que sucede automáticamente para todas las pasarelas excepto para Sin conexión.

Las donaciones sin conexión permanecen Pendientes hasta que un administrador las marque como Pagadas.

Rafe Colton resolvió este problema introduciendo dos nuevos correos electrónicos, el Recibo de donación sin conexión y la Notificación de donación sin conexión. Estos correos electrónicos solo se envían para donaciones sin conexión que están pendientes. En el recibo de donación, también puedes mostrar las instrucciones de pago sin conexión para ayudar a tu donante a saber cómo completar su donación.

Haz clic aquí para más detalles sobre los correos electrónicos.

Consulta información importante de la campaña de un vistazo

La tabla de Campañas en el panel de WordPress ha sido rediseñada para adaptarse a las campañas. De un vistazo, ahora puedes ver cuánto ha recaudado una campaña, cuándo termina y, si ha finalizado, si tuvo éxito.

También verás el ID de la campaña en la columna izquierda, lo que resulta útil cuando necesitas conocer el ID de una campaña en particular en un shortcode como [charitable_donation_form], [charitable_donors] o [campaigns], todos los cuales aceptan parámetros de campaña.

Muestra donantes en cualquier lugar con un shortcode

Ahora puedes mostrar una lista de tus donantes en cualquier lugar de tu sitio con el shortcode [charitable_donors]. El shortcode te permite mostrar donantes de todas las campañas o de una campaña específica, y también puedes controlar qué se muestra para cada donante. Por defecto, mostrará el avatar (o Gravatar) del donante, su nombre y la cantidad que donó:

Read the docs for more examples of how you can use this.

Cuentas de donantes mejoradas con verificación de correo electrónico

Desde la versión 1.4, Charitable incluye un shortcode [charitable_my_donations], que ha proporcionado una forma sencilla para que los donantes vean su historial de donaciones.

Pero había un problema: solo mostraba las donaciones que habías hecho mientras tenías la sesión iniciada. Si habías hecho donaciones sin iniciar sesión pero con la misma dirección de correo electrónico que tu cuenta, estas no se mostraban.

Para solucionarlo, configuramos un proceso básico de verificación de correo electrónico para los usuarios registrados, lo que garantiza que tengan acceso a la dirección de correo electrónico con la que se registraron antes de mostrar todas las donaciones asociadas a esa dirección. Confirmar tu dirección de correo electrónico es un proceso rápido y sencillo: solo tienes que hacer clic en un enlace y listo.

Añadir un enlace de cierre de sesión con un shortcode

Charitable siempre ha incluido formularios de inicio de sesión, registro y perfil. En la versión 1.4 añadimos también un proceso de restablecimiento de contraseña. Pero una pieza que aún faltaba era una forma integrada de añadir un enlace de cierre de sesión.

Afortunadamente, ahora hay un simple shortcode para eso:

[charitable_logout]

Lee la documentación para más detalles sobre el uso del shortcode de cierre de sesión.

Aprovecha al máximo Varnish Cache con Charitable

Varnish es un popular mecanismo de caché utilizado por los principales hosts web como WP Engine y SiteGround. Es posible que lo estés utilizando sin saberlo. Y puede que te haya estado causando dolores de cabeza con Charitable.

El problema clave que encontramos con Varnish es que podía impedir que las sesiones de usuario funcionaran como se esperaba. Un subproducto particularmente desagradable de esto era que los donantes veían un mensaje de "No tienes acceso a este recibo de donación" inmediatamente después de donar. Difícilmente la impresión que quieres dejar a los donantes.

Charitable 1.5 resuelve este problema cargando contenido dinámicamente (a través de AJAX) cuando detectamos que las sesiones de usuario no funcionan. Eso significa que ahora puedes aprovechar al máximo Varnish para acelerar tu sitio web, sin afectar negativamente la experiencia de tus donantes.

Actualizaciones para Desarrolladores

No todos los cambios son visibles para el usuario, y Charitable 1.5 incluye una serie de mejoras diseñadas para facilitar la vida de los desarrolladores y abrir nuevas oportunidades para crear experiencias de recaudación de fondos en línea con Charitable.

Registra nuevos campos de donación con la API de Campos de Donación

Antes de esta versión, si querías añadir un nuevo campo a tu formulario de donación y mostrar el valor en correos electrónicos, metadatos de administrador y exportaciones de donaciones, tenías que usar cinco ganchos (hooks) separados, con una función diferente para cada uno. Además de ser una molestia, eso dejaba mucho margen de error, especialmente para los usuarios menos experimentados que han añadido campos personalizados con poco o ningún conocimiento de desarrollo.

En Charitable 1.5, puedes registrar un nuevo campo de donación en una sola función llamada en el gancho init:

function ed_charitable_register_new_donation_field() {
    $field = new Charitable_Donation_Field( 'national_id_number', array(
        'label'          => __( 'National ID Number', 'charitable' );
        'data_type'      => 'user',
        'donation_form'  => array(
            'show_after' => 'phone',
            'required'   => false,
        ),
        'admin_form'     => array(
            'show_after' => 'phone',
            'required'   => false,
        ),
        'show_in_meta'   => true,
        'show_in_export' => true,
        'email_tag'      => array(
            'description' => __( 'The donor\'s national ID number' , 'charitable' ),
        )
    ) );

    charitable()->donation_fields()->register_field( $field );
}

add_action( 'init', 'ed_charitable_register_new_donation_field' );

Consulta el código completo y muy comentado para obtener un esquema detallado de todas las opciones disponibles.

Obtén fácilmente recuentos de donantes y donaciones con las clases Charitable_Query

La clase Charitable_Query es la base tanto para Charitable_Donations_Query como para Charitable_Donor_Query, que te permiten obtener colecciones de donaciones y donantes, respectivamente. Pero a veces no necesitas obtener la colección completa; solo necesitas el número de resultados.

Hemos agregado una nueva opci ilde{0}n a Charitable_Query que te permite obtener f ilde{0}cilmente el recuento. Simplemente establece output en count y forma el resto de tu consulta como de costumbre. Por ejemplo, aqu ilde{0} tienes una consulta que obtendr ilde{0} el n ilde{0}mero de donaciones realizadas por el donante con ID 123 a la campa ilde{0}a con ID 4:

$query = new Charitable_Donations_Query( array( 
    'campaign' => 4, 
    'donor_id' => 123,
    'output' => 'count' 
) );
$query->count();

Haz clic aqu ilde{0} para ver m ilde{0}s ejemplos.

A ilde0}ade nuevos campos de correo electr ilde{0}nico con la API de Campos de Correo Electr ilde{0}nico

Descubrimos un gran problema de rendimiento relacionado con la forma en que se configuraban previamente los campos de correo electr ilde{0}nico, as ilde{0} que aprovechamos la oportunidad para reescribir completamente la forma en que funcionan los campos de correo electr ilde{0}nico. Esto solucion ilde{0} el problema de rendimiento (p ilde{0}ginas de configuraci ilde{0}n que pod ilde{0}an tardar m ilde{0}s de 15 segundos en cargarse ahora lo hacen en menos de un segundo) y tambi ilde{n}n abri ilde{0} una forma m ilde{0}s flexible de a ilde0}adir y editar campos de correo electr ilde{0}nico.

function ed_charitable_email_campaign_field_callback( $value, $args, $email ) {
    $campaign = $email->get_campaign();
    return $campaign->get( 'some_field' );
}

function ed_charitable_add_email_campaign_field( $fields ) {
    $fields['some_field'] = array(
        'description' => 'A description of this field',                    
        'preview'     => 'Placeholder value',
        'callback'    => 'ed_charitable_email_campaign_field_callback',
    );

    return $fields;
}

add_filter( 'charitable_email_campaign_fields', 'ed_charitable_add_email_campaign_field' );

Haz clic aqu ilde{0} para la documentaci ilde{0}n completa.

Establecer un importe m ilde{0}nimo de donaci ilde{0}n

Ahora puedes establecer un importe m ilde{0}nimo de donaci ilde{0}n para todas las campa ilde{0}as con el filtro charitable_minimum_donation_amount. Por ejemplo, para establecer un importe m ilde{0}nimo de donaci ilde{0}n de 2 $:

function ed_charitable_set_minimum_donation_amount() {
    return 2;
 }

add_filter( 'charitable_minimum_donation_amount', 'ed_charitable_set_minimum_donation_amount' );

Comentarios de documentaci ilde{0}n detallados para hooks y filtros

Siempre hemos sido bastante rigurosos con la documentaci ilde{0}n en l ilde{0}nea, pero con esta versi ilde{0}n realmente hemos dado un paso m ilde{0}s. Muchos hooks de acci ilde{0}n y filtro ahora incluyen comentarios de documentaci ilde{0}n detallados que muestran cu ilde{0}ndo se introdujo el hook y los par ilde{0}metros que env ilde{0}a. Aqu ilde{0} tienes un ejemplo:

Otros cambios:

• Se a ilde0}adi ilde{0} un autoloader. ¡Gracias a Kathy Darling por esto!
• Establece si una campa ilde{0}a puede recibir donaciones con el filtro charitable_campaign_can_receive_donations.
• Utiliza el filtro charitable_monetary_amount para un control detallado sobre c ilde{0}mo se muestran los importes monetarios.
• Se a ilde0}adi ilde{0} la API de Vista de Formularios. Esto separa c ilde{0}mo se *renderizan* los formularios de c ilde{0}mo se *configuran*. Tambi ilde{n}n mejora el rendimiento.
• Se a ilde0}adi ilde{0} la API de Puntos Finales, que te permite registrar nuevos puntos finales a trav ilde{n}s de Charitable.

ilde{1}Qu ilde{n} Te Parece?

Como puedes ver, esta es una actualizaci ilde{0}n enorme para Charitable. Nos ha llevado mucho m ilde{0}s tiempo llegar aqu ilde{0} de lo que esperaba, pero estoy inmensamente orgulloso de las mejoras realizadas. Muchos de estos problemas han sido puntos de dolor de larga data para los usuarios, y se siente genial tener finalmente una soluci ilde{0}n s ilde{0}lida para esos problemas.

Si a ilde0}n no lo has hecho, actualiza Charitable a trav ilde{n}s de tu panel de control hoy mismo y dinos qu ilde{n} te parece. La mayor ilde0}a de estas mejoras se han basado en los comentarios de los usuarios y, como siempre, queremos saber qu ilde{n} opinas de estas actualizaciones.

¡Comparte tus opiniones en los comentarios de abajo!