Recaudación de fondos de embajadores benéficos

Añadido en la versión 2.0.0

u003cpu003eCambia el título generado automáticamente para una nueva recaudación de fondos, cuando el título se establece para basarse dinámicamente en el nombre del creador de la campaña.u003c/pu003e

Valor de retorno

u003cpu003eString. El título de la recaudación de fondos.u003c/pu003e

Argumentos

• $title (cadena)

  u003cpu003eEl título. Por defecto, será el nombre completo del creador de la campaña.u003c/pu003e

• $data (matriz)

  u003cpu003eLos datos enviados.u003c/pu003e

Uso

add_filter( 'charitable_ambassadors_fundraiser_title', function( $title, $data ) {n    $first_name = array_key_exists( 'first_name', $data ) ? $data['first_name'] : '';n    $last_name  = array_key_exists( 'last_name', $data ) ? $data['last_name'] : '';n    $full_name   = trim( sprintf( '%s %s', $first_name, $last_name ) );nn    // Joe Blow's Fundraisern    return sprintf( u0022%s's Fundraiseru0022, $full_name );n}, 10, 2 );

Mostrar enlace de creación de campaña

Añadido en la versión 2.0.0

u003cpu003eElige si quieres mostrar el botón "Crear una nueva campaña" al final de la salida del shortcode [charitable_my_campaigns].u003c/pu003e

Valor de retorno

u003cpu003eBooleano. Verdadero si quieres mostrarlo, o falso si prefieres no hacerlo. Por defecto, esto devolverá verdadero.u003c/pu003e

Argumentos

• $show (booleano)

  u003cpu003eSi se debe mostrar el botón.u003c/pu003e

Uso

// Do not show the button.nadd_filter( 'charitable_ambassadors_my_campaigns_show_campaign_creation_link', '__return_false' );

Texto del botón

Añadido en la versión 1.0.0

u003cpu003eCambia el texto del botón "Crear una campaña" al final de la salida del shortcode [charitable_my_campaigns].u003c/pu003e

Valor de retorno

u003cpu003eString. El texto a usar en el botón.u003c/pu003e

Argumentos

• $text (cadena)

  u003cpu003eEl texto del botón.u003c/pu003e

Uso

add_filter( 'charitable_ambassadors_my_campaigns_button_text', function( $text ) {n    return 'Start a New Campaign';n} );

Página de éxito de envío de campaña

Añadido en la versión 1.0.0

u003cpu003eCambia la página a la que se redirigirá a los usuarios después de que envíen su campaña por primera vez. Ten en cuenta que si quieres redirigir a una página estática, puedes hacerlo sin código configurando la opción "Página de éxito de envío de campaña" en Charitable > Ajustes > Embajadores.u003c/pu003e

Valor de retorno

u003cpu003eString. Una URL a la que redirigir después de enviar una campaña por primera vez. Ten en cuenta que la redirección se realiza a través de una llamada a u003ccodeu003ewp_safe_redirect()u003c/codeu003e, por lo que la URL debe ser a un host permitido (ver u003ca href=u0022https://developer.wordpress.org/reference/functions/wp_safe_redirect/u0022u003ehttps://developer.wordpress.org/reference/functions/wp_safe_redirect/u003c/au003e).u003c/pu003e

Argumentos

• $default (cadena)

  u003cpu003eLa URL a la que redirigir.u003c/pu003e

• $argumentos (matriz)

  u003cpu003eUna matriz de argumentos. Por defecto, solo tendrá una propiedad u003ccodeu003ecampaign_idu003c/codeu003e con el ID de la campaña recién enviada.u003c/pu003e

Uso

// Redirect to the newly submitted campaign after submission.nadd_filter( 'charitable_permalink_campaign_submission_success_page', function( $url, $args = array() ) {n    if ( ! array_key_exists( 'campaign_id', $args ) ) {n        return $url;n    }nn    return get_permalink( $args['campaign_id'] );n}, 10, 2 );

URL de redirección del envío de campaña

Añadido en la versión 1.0.0

u003cpu003eCambia la URL a la que se redirige a los usuarios después de enviar, actualizar o guardar y previsualizar su campaña.u003c/pu003e u003cpu003eSi solo quieres cambiar la página a la que se redirige a los usuarios después de enviar su campaña por primera vez, usa en su lugar el filtro u003ca href=u0022https://www.wpcharitable.com/documentation/hooks-filters-in-ambassadors/#charitable_permalink_campaign_submission_success_pageu0022u003echaritable_permalink_campaign_submission_success_pageu003c/au003e.u003c/pu003e

Valor de retorno

u003cpu003eString. La URL a la que se redirigirá al usuario.u003c/pu003e

Argumentos

• $url (cadena)

  u003cpu003eLa URL a la que se redirigirá al usuario.u003c/pu003e

• $data (matriz)

  u003cpu003eLos datos enviados.u003c/pu003e

• $campaign_id (int)

  u003cpu003eEl ID de la campaña.u003c/pu003e

• $user_id (int)

  u003cpu003eEl ID del usuario.u003c/pu003e

Lista de campos del formulario de recaudación de fondos de embajadores benéficos

Añadido en la versión 2.1.0

u003cpu003eAñade o elimina campos del formulario de recaudación de fondos. u003c/pu003eu003cpu003eLa lista de campos es una lista de claves de campos que se incluyen en el formulario principal de la campaña, los cuales también deben incluirse en el formulario de recaudación de fondos. Los siguientes campos no se incluyen en el formulario de recaudación de fondos por defecto:u003c/pu003eu003cpu003e- u003ccodeu003edescriptionu003c/codeu003eu003cbru003e- u003ccodeu003ecategoriesu003c/codeu003eu003cbru003e- u003ccodeu003etagsu003c/codeu003eu003cbru003e- u003ccodeu003esuggested_donationsu003c/codeu003eu003cbru003e- u003ccodeu003eallow_custom_donationsu003c/codeu003eu003c/pu003e

Valor de retorno

matriz

Argumentos

• $list (matriz)

  u003cpu003eLa lista de campos que se incluirán.u003c/pu003e

• $form (Charitable_Ambassadors_Fundraiser_Form)

  u003cpu003eEl objeto del formulario de recaudación de fondos.u003c/pu003e

Uso

// Include the 'description' field in the Fundraiser form.nadd_filter( 'charitable_ambassadors_fundraiser_form_field_list', function( $fields ) {n    $fields[] = 'description';n    return $fields;n} );

Campos heredados de la recaudación de fondos de embajadores benéficos

Añadido en la versión 2.0.0

u003cpu003eFiltra los campos que se heredan automáticamente de la campaña principal de la recaudación de fondos.u003c/pu003e

Valor de retorno

matriz

Argumentos

• $campos (matriz)

  u003cpu003eLos campos heredados.u003c/pu003e

Uso

add_filter(n    'charitable_ambassadors_fundraiser_inherited_fields', n    function( $fields ) {n        $fields[] = 'my_custom_field';n        return $fields;n    }n);

Actualizar las fechas de finalización de la recaudación de fondos cuando cambie la fecha de finalización principal

Añadido en la versión 2.0.0

u003cpu003eEstablece si las fechas de finalización de las recaudaciones de fondos se actualizarán automáticamente cuando la campaña principal cambie su fecha de finalización.u003c/pu003e

Valor de retorno

u003cpu003eBooleano. Por defecto es true.u003c/pu003e

Argumentos

• $should_update (booleano)

  u003cpu003eSi se debe actualizar automáticamente.u003c/pu003e

• $campaign (Charitable_Campaign)

  u003cpu003eEl objeto de la campaña principal.u003c/pu003e

Columnas de exportación de donaciones del creador de embajadores benéficos

Añadido en la versión 2.0.0

u003cpu003eFiltra las columnas que se incluyen en la exportación.u003c/pu003e

Valor de retorno

u003cpu003eArray. Las claves de las columnas a incluir.u003c/pu003e

Argumentos

• $columns (matriz)

  u003cpu003eLas columnas a incluir.u003c/pu003e

Uso

add_filter( 'charitable_ambassadors_creator_donations_export_columns', function( $columns ) {n    // Only show the first name, last name, amount and donor comment.n    $included_columns = array(n        'first_name',n        'last_name',n        'amount',n        'donor_comment',n    );ntn    foreach ( $columns as $column =u003e $header ) {n        if ( ! in_array( $column, $included_columns ) ) {n            unset( $columns[ $column ] );n        }n    }ntn    return $columns;n} );