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 '

'; 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;