# charitable/1.8.11.3/includes/shortcodes/class-charitable-stat-shortcode.php

Charitable – Donation & Fundraising Platform (Donation Forms, Recurring Donations & Fundraising Campaigns), version 1.8.11.3. 274 lines.

- Page: https://pluginprobe.com/plugins/charitable/1.8.11.3/code/includes/shortcodes/class-charitable-stat-shortcode.php
- Raw: https://pluginprobe.com/plugins/charitable/1.8.11.3/raw/includes/shortcodes/class-charitable-stat-shortcode.php
- Modified: 2026-01-01T16:41:46+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/charitable/1.8.11.3/code/includes/shortcodes/class-charitable-stat-shortcode.php#L10-L20`.

```php
<?php
/**
 * Responsible for parsing and displaying the output of the [charitable_stat] shortcode.
 *
 * @package   Charitable_Stat/Classes/Charitable_Stat_Shortcode
 * @author    David Bisset
 * @copyright Copyright (c) 2023, WP Charitable LLC
 * @license   http://opensource.org/licenses/gpl-2.0.php GNU Public License
 * @since     1.6.0
 * @version   1.6.0
 */

// Exit if accessed directly.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

if ( ! class_exists( 'Charitable_Stat_Shortcode' ) ) :

	/**
	 * Charitable_Stat_Shortcode
	 *
	 * @since 1.6.0
	 */
	class Charitable_Stat_Shortcode {

		/**
		 * The type of query.
		 *
		 * @since 1.6.0
		 *
		 * @var   string
		 */
		private $type;

		/**
		 * Mixed set of arguments for the query.
		 *
		 * @since 1.6.0
		 *
		 * @var   array
		 */
		private $args;

		/**
		 * Create class object.
		 *
		 * @since 1.6.0
		 *
		 * @param array $atts User-defined attributes.
		 */
		private function __construct( $atts ) {
			$this->args   = $this->parse_args( $atts );
			$this->type   = $this->args['display'];
			$this->report = $this->get_report();
		}

		/**
		 * Create class object.
		 *
		 * @since 1.6.0
		 *
		 * @param  array $atts User-defined attributes.
		 * @return string
		 */
		public static function display( $atts ) {
			$object = new Charitable_Stat_Shortcode( $atts );

			return $object->get_query_result();
		}

		/**
		 * Return the query result.
		 *
		 * @since  1.6.0
		 *
		 * @return string
		 */
		public function get_query_result() {
			switch ( $this->type ) {
				case 'progress':
					$total = $this->report->get_report( 'amount' );

					if ( ! $this->args['goal'] ) {
						return charitable_format_money( $total );
					}

					$goal    = charitable_sanitize_amount( $this->args['goal'], false );
					$total   = charitable_sanitize_amount( $total, true );
					$percent = ( $total / $goal ) * 100;

					return '<div class="campaign-progress-bar" role="progressbar" aria-valuemin="0" aria-valuemax="100" aria-valuenow="' . $percent . '"><span class="bar" style="width:' . $percent . '%;"></span></div>';

				case 'total':
					return charitable_format_money( $this->report->get_report( 'amount' ) );

				case 'donors':
				case 'donations':
					return (string) $this->report->get_report( $this->type );
			}
		}

		/**
		 * Parse shortcode attributes.
		 *
		 * @since   1.6.0
		 * @version 1.8.3.5 added 'campaign_categories' to the shortcode attributes.
		 * @version 1.9.0 added 'include_children' to the shortcode attributes.
		 *
		 * @param  array $atts User-defined attributes.
		 * @return array
		 */
		private function parse_args( $atts ) {
			$defaults = array(
				'display'             => 'total',
				'campaigns'           => '',
				'goal'                => false,
				'campaign_categories' => '',
				'include_children'    => false,
			);

			$args = shortcode_atts( $defaults, $atts, 'charitable_stat' );

			if ( '' !== $args['campaign_categories'] ) {
				$campaign_categories = str_replace( ', ', ',', $args['campaign_categories'] );
				$campaign_categories = explode( ',', $args['campaign_categories'] );
				$cat_args            = [
					'post_type'      => 'campaign',
					'posts_per_page' => -1,
					'fields'         => 'ids',
					'tax_query'      => [ // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query
						[
							'taxonomy' => 'campaign_category',
							'field'    => 'slug',
							'terms'    => $campaign_categories,
						],
					],
				];
				$cat_query           = new WP_Query( $cat_args );
				if ( ! empty( $cat_query->posts ) ) {
					$campaigns         = $cat_query->posts;
					$args['campaigns'] = implode( ',', $campaigns );
				}
			}

			$args['campaigns'] = strlen( $args['campaigns'] ) ? explode( ',', $args['campaigns'] ) : array();

			// Convert include_children to boolean.
			$args['include_children'] = filter_var( $args['include_children'], FILTER_VALIDATE_BOOLEAN );

			return $args;
		}

		/**
		 * Run the report for the shortcode.
		 *
		 * @since  1.6.0
		 *
		 * @return Charitable_Donation_Report
		 */
		private function get_report() {
			return new Charitable_Donation_Report( $this->get_report_args() );
		}

		/**
		 * Return the arguments used for generating the report.
		 *
		 * @since  1.6.0
		 * @version 1.9.0 added support for including child campaigns.
		 *
		 * @return array
		 */
		private function get_report_args() {
			$args                = array();
			$args['report_type'] = in_array( $this->type, array( 'progress', 'total' ), true ) ? 'amount' : $this->type;

			// Expand campaigns to include child campaigns if requested.
			if ( $this->args['include_children'] && ! empty( $this->args['campaigns'] ) ) {
				$args['campaigns'] = $this->expand_campaigns_with_children( $this->args['campaigns'] );
			} else {
				$args['campaigns'] = $this->args['campaigns'];
			}

			return $args;
		}

		/**
		 * Expand campaign IDs to include all child campaigns recursively.
		 *
		 * @since  1.9.0
		 *
		 * @param  array $campaign_ids Array of campaign IDs.
		 * @return array Expanded array of campaign IDs including children.
		 */
		private function expand_campaigns_with_children( $campaign_ids ) {
			$all_campaign_ids = array();

			foreach ( $campaign_ids as $campaign_id ) {
				$campaign_id = intval( $campaign_id );
				if ( ! $campaign_id ) {
					continue;
				}

				// Add the parent campaign.
				$all_campaign_ids[] = $campaign_id;

				// Get child campaigns recursively.
				$child_campaigns = $this->get_all_child_campaigns( $campaign_id );
				if ( ! empty( $child_campaigns ) ) {
					$all_campaign_ids = array_merge( $all_campaign_ids, $child_campaigns );
				}
			}

			return array_unique( array_filter( $all_campaign_ids ) );
		}

		/**
		 * Get all child campaigns for a campaign ID, recursively.
		 *
		 * @since  1.9.0
		 *
		 * @param  int $campaign_id The parent campaign ID.
		 * @return array Array of child campaign IDs.
		 */
		private function get_all_child_campaigns( $campaign_id ) {
			$child_campaign_ids = array();

			// Check if Charitable Ambassadors is active and use its method if available.
			if ( class_exists( 'Charitable_Ambassadors_Campaign' ) ) {
				$ambassadors_campaign = new Charitable_Ambassadors_Campaign( $campaign_id );
				$child_campaigns     = $ambassadors_campaign->get_child_campaigns();

				if ( ! empty( $child_campaigns ) ) {
					$child_campaign_ids = array_merge( $child_campaign_ids, $child_campaigns );

					// Recursively get grandchildren.
					foreach ( $child_campaigns as $child_id ) {
						$grandchildren = $this->get_all_child_campaigns( $child_id );
						if ( ! empty( $grandchildren ) ) {
							$child_campaign_ids = array_merge( $child_campaign_ids, $grandchildren );
						}
					}
				}
			} else {
				// Fallback to standard WordPress parent-child relationship.
				$direct_children = get_posts(
					array(
						'post_type'      => Charitable::CAMPAIGN_POST_TYPE,
						'posts_per_page' => -1,
						'post_parent'    => $campaign_id,
						'fields'         => 'ids',
						'post_status'    => 'any',
					)
				);

				if ( ! empty( $direct_children ) ) {
					$child_campaign_ids = array_merge( $child_campaign_ids, $direct_children );

					// Recursively get grandchildren.
					foreach ( $direct_children as $child_id ) {
						$grandchildren = $this->get_all_child_campaigns( $child_id );
						if ( ! empty( $grandchildren ) ) {
							$child_campaign_ids = array_merge( $child_campaign_ids, $grandchildren );
						}
					}
				}
			}

			return $child_campaign_ids;
		}
	}

endif;

```