giftflow_get_campaign_raised_amount( int $campaign_id ): float

$raised = giftflow_get_campaign_raised_amount( 42 );
// → 1250.00

giftflow_get_campaign_goal_amount( int $campaign_id ): string

$goal = giftflow_get_campaign_goal_amount( 42 );
// → '5000'

giftflow_get_campaign_progress_percentage( int $campaign_id ): float

$pct = giftflow_get_campaign_progress_percentage( 42 );
// → 25.00

giftflow_display_campaign_progress( int $campaign_id ): string

echo giftflow_display_campaign_progress( 42 );
// → <div class="campaign-progress">...</div>

giftflow_get_campaign_days_left( int $campaign_id ): int|false|string

$days = giftflow_get_campaign_days_left( 42 );
 
if ( $days === false ) {
    echo 'Not started yet';
} elseif ( $days === true ) {
    echo 'Campaign ended';
} elseif ( $days === '' ) {
    echo 'No end date';
} else {
    echo $days . ' days left';
}

giftflow_get_campaign_donations(
    int $campaign_id,
    array $args = [],
    int $paged = 1
): array

$result = giftflow_get_campaign_donations( 42, [], 1 );
 
foreach ( $result['posts'] as $donation ) {
    echo $donation['amount_formatted']; // e.g. $25.00
    echo $donation['donor_meta']['name'];
    echo $donation['status'];           // completed, pending, etc.
}
 
echo 'Total: ' . $result['total'];
echo 'Pages: ' . $result['pagination'];

giftflow_prepare_campaign_status_bar_data( int $post_id ): array

$data = giftflow_prepare_campaign_status_bar_data( 42 );
 
echo $data['raised_amount_formatted']; // $1,250.00
echo $data['progress_percentage'];     // 25.0
echo $data['donation_count'];          // 18
echo $data['days_left'];               // 12

giftflow_process_bar_of_campaign_donations( int $campaign_id ): void

giftflow_process_bar_of_campaign_donations( 42 );
// Echoes: <div class="giftflow-campaign-progress-bar">...</div>

giftflow_get_preset_donation_amounts(): string

$amounts = giftflow_get_preset_donation_amounts();
// → '10, 25, 35'

giftflow_get_preset_donation_amounts_by_campaign( int $campaign_id ): array

$amounts = giftflow_get_preset_donation_amounts_by_campaign( 42 );
// → [ ['amount' => 10.0], ['amount' => 50.0], ['amount' => 100.0] ]

giftflow_get_donation_data_by_id( int $donation_id ): object|false

$donation = giftflow_get_donation_data_by_id( 99 );
 
if ( $donation ) {
    echo $donation->donor_name;
    echo $donation->__amount_formatted;
    echo $donation->campaign_name;
    echo $donation->status;
}

giftflow_query_donation_by_donor_id(
    int|string $donor_id,
    int $page = 1,
    int $per_page = 20,
    array $filters = []
): WP_Query

$query = giftflow_query_donation_by_donor_id(
    $donor_id,
    1,
    20,
    [ 'status' => 'completed', 'date_from' => '2024-01-01' ]
);
 
if ( $query->have_posts() ) {
    while ( $query->have_posts() ) {
        $query->the_post();
        echo get_the_title();
    }
    wp_reset_postdata();
}

giftflow_get_donations_by_user(
    int $user_id,
    int $page = 1,
    int $per_page = 20,
    array $filters = []
): WP_Query

$query = giftflow_get_donations_by_user( get_current_user_id() );

giftflow_get_donations_by_parent_id(
    int $parent_donation_id,
    array $filters = []
): array

$renewals = giftflow_get_donations_by_parent_id( 77 );
 
foreach ( $renewals as $post ) {
    echo get_post_meta( $post->ID, '_amount', true );
}

giftflow_get_donation_status_options(): array

$options = giftflow_get_donation_status_options();
// → [ 'pending' => 'Pending', 'completed' => 'Completed', ... ]

giftflow_get_payment_methods_options(): array

$options = giftflow_get_payment_methods_options();
// → [ 'stripe' => 'Credit Card (Stripe)', 'paypal' => 'PayPal', ... ]

giftflow_donation_payment_template_tags( object $donation_data ): string

$d = giftflow_get_donation_data_by_id( 99 );
echo giftflow_donation_payment_template_tags( $d );
// → <div class="gfw-payment-method ...">Stripe</div>
//   <div class="gfw-donation-type ...">One-time</div>

giftflow_donation_type_label( array $donation_types = [] ): string

$label = giftflow_donation_type_label( $donation_types );
// → 'One-time Donation'   (single)
// → 'Select: One-time / Recurring'  (multiple)

giftflow_get_donor_data_by_id( int $donor_id = 0 ): object|null

$donor = giftflow_get_donor_data_by_id( 55 );
 
if ( $donor ) {
    echo $donor->first_name . ' ' . $donor->last_name;
    echo $donor->email;
    echo $donor->city . ', ' . $donor->country;
}

giftflow_get_donor_id_by_email( string $email ): int

$donor_id = giftflow_get_donor_id_by_email( 'jane@example.com' );
// Returns existing or newly created donor ID

giftflow_get_donor_user_information( int $user_id ): array

$info = giftflow_get_donor_user_information( get_current_user_id() );
 
echo $info['first_name'];
echo $info['donor_id'];
echo $info['phone'];

giftflow_get_options(
    string $option,
    string $group = 'giftflow_general_options',
    string $value_default = ''
): string

$currency   = giftflow_get_options( 'currency' );
$min_amount = giftflow_get_options( 'min_amount', 'giftflow_general_options', 1 );
$from_name  = giftflow_get_options( 'email_from_name', 'giftflow_email_options', '' );

giftflow_get_current_currency(): string

$code = giftflow_get_current_currency(); // → 'USD'

giftflow_get_currency_symbol( string $currency ): string

echo giftflow_get_currency_symbol( 'USD' ); // → $
echo giftflow_get_currency_symbol( 'EUR' ); // → €
echo giftflow_get_currency_symbol( 'GBP' ); // → £

giftflow_get_currency_name( string $currency ): string

echo giftflow_get_currency_name( 'USD' ); // → US Dollar

giftflow_get_global_currency_symbol(): string

echo giftflow_get_global_currency_symbol(); // → $

giftflow_get_currency_template(): string

$tpl = giftflow_get_currency_template();
// → '{{currency_symbol}}{{amount}}'

giftflow_get_currency_js_format_template(): string

$js_tpl = giftflow_get_currency_js_format_template();
// → '${{value}}'

giftflow_render_currency_formatted_amount(
    float $amount,
    int $decimals = 2,
    string|null $currency = null,
    string $template = ''
): string

echo giftflow_render_currency_formatted_amount( 1250 );
// → <span class="giftflow-currency-formatted-amount gfw-monofont">$1,250.00</span>
 
echo giftflow_render_currency_formatted_amount( 99.9, 0 );
// → <span ...>$100</span>
 
echo giftflow_render_currency_formatted_amount( 500, 2, 'EUR' );
// → <span ...>€500.00</span>

giftflow_get_common_currency(): array

$currencies = giftflow_get_common_currency();
// → [ ['code' => 'USD', 'symbol' => '$', 'name' => 'US Dollar', ...], ... ]

giftflow_load_template( string $template_name, array $args = [] ): void

giftflow_load_template( 'campaign-grid.php', [
    'campaigns'    => $campaigns,
    'custom_class' => 'my-grid',
] );
 
giftflow_load_template( 'block/campaign-status-bar.php', $data );
giftflow_load_template( 'email/thanks-donor.php', $email_args );

giftflow_render_attributes( array $attributes ): string

$attrs = giftflow_render_attributes( [
    'id'       => 'my-form',
    'class'    => 'donation-form',
    'data-id'  => 42,
    'disabled' => true,
    'hidden'   => false, // skipped
] );
 
echo "<form {$attrs}>";
// → <form id="my-form" class="donation-form" data-id="42" disabled>

giftflow_render_time_ago( string $datetime ): string

echo giftflow_render_time_ago( '2025-01-01 10:00:00' );
// → '2 hours ago'   (if within 3 days)
// → '2025-01-01 10:00:00'  (if older than 3 days)
// → 'just now'  (if < 10 seconds)

giftflow_render_current_user_info(): void

// Inside a template:
giftflow_render_current_user_info();
// → <div class="giftflow-user-info">...</div>

giftflow_svg_icon( string $name ): string

echo wp_kses( giftflow_svg_icon( 'checkmark-circle' ), giftflow_allowed_svg_tags() );
echo wp_kses( giftflow_svg_icon( 'error' ),            giftflow_allowed_svg_tags() );
echo wp_kses( giftflow_svg_icon( 'user' ),             giftflow_allowed_svg_tags() );
echo wp_kses( giftflow_svg_icon( 'shield-check' ),     giftflow_allowed_svg_tags() );

giftflow_allowed_svg_tags(): array

echo wp_kses( $my_svg_string, giftflow_allowed_svg_tags() );

giftflow_get_campaigns_page(): int|string

$page_id = giftflow_get_campaigns_page();
$url = get_permalink( $page_id );

giftflow_get_donor_account_page(): int|string

$url = get_permalink( giftflow_get_donor_account_page() );

giftflow_get_thank_donor_page(): int|string

$thank_you_url = get_permalink( giftflow_get_thank_donor_page() );

giftflow_get_donation_privacy_policy_page(): int|string

giftflow_get_donation_terms_conditions_page(): int|string

giftflow_assign_donor_role( int $user_id ): bool

giftflow_assign_donor_role( $user_id );

giftflow_remove_donor_role( int $user_id ): bool

giftflow_user_has_donor_role( int $user_id ): bool

if ( giftflow_user_has_donor_role( get_current_user_id() ) ) {
    // show donor-only content
}

giftflow_get_role_manager(): \GiftFlow\Core\Role

giftflow_sanitize_array( array $data ): array

$clean = giftflow_sanitize_array( $_POST );

giftflow_get_file_content( string $file_path = '' ): string

$html = giftflow_get_file_content( GIFTFLOW_PLUGIN_DIR . 'block-templates/page-content/my-page.html' );