# charitable/1.8.11/includes/shortcodes/class-charitable-donors-shortcode.php

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

- Page: https://pluginprobe.com/plugins/charitable/1.8.11/code/includes/shortcodes/class-charitable-donors-shortcode.php
- Raw: https://pluginprobe.com/plugins/charitable/1.8.11/raw/includes/shortcodes/class-charitable-donors-shortcode.php
- Modified: 2025-02-20T16:43:24+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/code/includes/shortcodes/class-charitable-donors-shortcode.php#L10-L20`.

```php
<?php
/**
 * Donors shortcode class.
 *
 * @package   Charitable/Shortcodes/Donors
 * @author    David Bisset
 * @copyright Copyright (c) 2023, WP Charitable LLC
 * @license   http://opensource.org/licenses/gpl-2.0.php GNU Public License
 * @since     1.5.0
 * @version   1.5.7
 */

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

if ( ! class_exists( 'Charitable_Donors_Shortcode' ) ) :

	/**
	 * Charitable_Donors_Shortcode class.
	 *
	 * @since   1.5.0
	 */
	class Charitable_Donors_Shortcode {

		/**
		 * Display the shortcode output. This is the callback method for the donors shortcode.
		 *
		 * @since  1.5.0
		 *
		 * @param  array $atts The user-defined shortcode attributes.
		 * @return string
		 */
		public static function display( $atts ) {
			$default = array(
				'number'            => 10,
				'orderby'           => 'date',
				'order'             => 'DESC',
				'campaign'          => 0,
				'distinct_donors'   => 0,
				'orientation'       => 'horizontal',
				'show_name'         => 1,
				'show_location'     => 0,
				'show_amount'       => 1,
				'show_avatar'       => 1,
				'hide_if_no_donors' => 0,
				'campaign_categories' => '',
				'builder_preview'   => false, // added in 1.8.0
			);

			$args = shortcode_atts( $default, $atts, 'charitable_donors' );

			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'      => [
						[
							'taxonomy' => 'campaign_category',
							'field'    => 'slug',
							'terms'    => $campaign_categories,
						],
					],
				];
				$query               = new WP_Query( $cat_args );
				if ( ! empty( $query->posts ) ) {
					$args['campaign'] = $query->posts;
				}
			}
			$args['donors'] = self::get_donors( $args );

			/**
			 * Replace the default template with your own.
			 *
			 * If you replace the template with your own, it needs to be an instance of Charitable_Template.
			 *
			 * @since  1.5.0
			 *
			 * @param  false|Charitable_Template The template. If false (the default), we will use our own template.
			 * @param  array $args               All the parsed arguments.
			 * @return false|Charitable_Template
			 */
			$template = apply_filters( 'charitable_donors_shortcode_template', false, $args );

			/* Fall back to default Charitable_Template if no template returned or if template was not object of 'Charitable_Template' class. */
			if ( ! is_object( $template ) || ! is_a( $template, 'Charitable_Template' ) ) {
				$template = new Charitable_Template( 'donor-loop.php', false );
			}

			if ( ! $template->template_file_exists() ) {
				return false;
			}

			/**
			 * Modify the view arguments that are passed to the donors template.
			 *
			 * @since  1.5.0
			 *
			 * @param  array $view_args The arguments to pass.
			 * @param  array $args      All the parsed arguments.
			 * @return array
			 */
			$view_args = apply_filters(
				'charitable_donors_shortcode_view_args',
				charitable_array_subset(
					$args,
					array(
						'donors',
						'number',
						'orderby',
						'order',
						'campaign',
						'orientation',
						'distinct_donors',
						'show_name',
						'show_location',
						'show_amount',
						'show_avatar',
						'hide_if_no_donors',
						'builder_preview'
					)
				),
				$args
			);

			$template->set_view_args( $view_args );

			ob_start();

			$template->render();

			/**
			 * Customize the output of the shortcode.
			 *
			 * @since  1.5.0
			 *
			 * @param  string $content The content to be displayed.
			 * @param  array  $args    All the parsed arguments.
			 * @return string
			 */
			return apply_filters( 'charitable_donors_shortcode', ob_get_clean(), $args );
		}

		/**
		 * Return donors to display in the donors shortcode.
		 *
		 * @since  1.5.0
		 *
		 * @param  array $args The query arguments to be used to retrieve donors.
		 * @return Charitable_Donor_Query
		 */
		public static function get_donors( $args ) {
			/**
			 * Filter the arguments passed to Charitable_Donor_Query.
			 *
			 * @since  1.5.0
			 *
			 * @param  array $query_args The arguments to be passed to Charitable_Donor_Query::__construct.
			 * @param  array $args       All the parsed arguments.
			 * @return array
			 */
			$query_args = apply_filters( 'charitable_donors_shortcode_donor_query_args',
				charitable_array_subset( $args, array( 'number', 'orderby', 'order', 'campaign', 'distinct_donors' ) ),
				$args
			);

			return new Charitable_Donor_Query( $query_args );
		}
	}

endif;

```