# charitable/1.7.0.2/includes/users/class-charitable-roles.php

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

- Page: https://pluginprobe.com/plugins/charitable/1.7.0.2/code/includes/users/class-charitable-roles.php
- Raw: https://pluginprobe.com/plugins/charitable/1.7.0.2/raw/includes/users/class-charitable-roles.php
- Modified: 2022-09-21T15:01:56+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.7.0.2/code/includes/users/class-charitable-roles.php#L10-L20`.

```php
<?php
/**
 * Roles and Capabilities for Charitable
 *
 * @package   Charitable/Classes/Charitable_Roles
 * @author    David Bisset
 * @copyright Copyright (c) 2022, WP Charitable LLC
 * @license   http://opensource.org/licenses/gpl-2.0.php GNU Public License
 * @since     1.0.0
 * @version   1.6.51
 */

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

if ( ! class_exists( 'Charitable_Roles' ) ) :

	/**
	 * Charitable_Roles class.
	 *
	 * @since 1.0.0
	 */
	class Charitable_Roles {

		/**
		 * Sets up roles for Charitable. This is called by the install script.
		 *
		 * @since  1.0.0
		 *
		 * @return void
		 */
		public function add_roles() {
			add_role(
				'campaign_manager',
				__( 'Campaign Manager', 'charitable' ),
				array(
					'read'                   => true,
					'delete_posts'           => true,
					'edit_posts'             => true,
					'delete_published_posts' => true,
					'publish_posts'          => true,
					'upload_files'           => true,
					'edit_published_posts'   => true,
					'read_private_pages'     => true,
					'edit_private_pages'     => true,
					'delete_private_pages'   => true,
					'read_private_posts'     => true,
					'edit_private_posts'     => true,
					'delete_private_posts'   => true,
					'delete_others_posts'    => true,
					'delete_published_pages' => true,
					'delete_others_pages'    => true,
					'delete_pages'           => true,
					'publish_pages'          => true,
					'edit_published_pages'   => true,
					'edit_others_pages'      => true,
					'edit_pages'             => true,
					'edit_others_posts'      => true,
					'manage_links'           => true,
					'manage_categories'      => true,
					'moderate_comments'      => true,
					'import'                 => true,
					'export'                 => true,
					'unfiltered_html'        => false,
				)
			);

			add_role(
				'donor',
				__( 'Donor', 'charitable' ),
				array(
					'read' => true,
				)
			);
		}

		/**
		 * Sets up capabilities for Charitable. This is called by the install script.
		 *
		 * @since  1.0.0
		 *
		 * @global WP_Roles
		 * @return void
		 */
		public function add_caps() {
			global $wp_roles;

			if ( class_exists( 'WP_Roles' ) ) {
				if ( ! isset( $wp_roles ) ) {
					$wp_roles = new WP_Roles();
				}
			}

			if ( is_object( $wp_roles ) ) {
				$wp_roles->add_cap( 'campaign_manager', 'view_charitable_sensitive_data' );
				$wp_roles->add_cap( 'campaign_manager', 'export_charitable_reports' );

				$wp_roles->add_cap( 'administrator', 'view_charitable_sensitive_data' );
				$wp_roles->add_cap( 'administrator', 'export_charitable_reports' );
				$wp_roles->add_cap( 'administrator', 'manage_charitable_settings' );

				/* Add the main post type capabilities. */
				foreach ( $this->get_core_caps() as $cap ) {
					$wp_roles->add_cap( 'campaign_manager', $cap );
					$wp_roles->add_cap( 'administrator', $cap );
				}
			}
		}

		/**
		 * Removes roles. This is called upon deactivation.
		 *
		 * @since  1.0.0
		 *
		 * @global WP_Roles
		 * @return void
		 */
		public function remove_caps() {
			global $wp_roles;

			if ( class_exists( 'WP_Roles' ) ) {
				if ( ! isset( $wp_roles ) ) {
					$wp_roles = new WP_Roles();
				}
			}

			if ( is_object( $wp_roles ) ) {
				$wp_roles->remove_cap( 'campaign_manager', 'view_charitable_sensitive_data' );
				$wp_roles->remove_cap( 'campaign_manager', 'export_charitable_reports' );

				$wp_roles->remove_cap( 'administrator', 'view_charitable_sensitive_data' );
				$wp_roles->remove_cap( 'administrator', 'export_charitable_reports' );
				$wp_roles->remove_cap( 'administrator', 'manage_charitable_settings' );

				/* Remove the main post type capabilities. */
				foreach ( $this->get_core_caps() as $cap ) {
					$wp_roles->remove_cap( 'campaign_manager', $cap );
					$wp_roles->remove_cap( 'administrator', $cap );
				}

				remove_role( 'donor' );
				remove_role( 'campaign_manager' );
			}
		}

		/**
		 * Returns the caps for the post types that Charitable adds.
		 *
		 * @since  1.0.0
		 *
		 * @return array
		 */
		private function get_core_caps() {
			return array(
				/* Campaign post type */
				'edit_campaign',
				'read_campaign',
				'delete_campaign',
				'edit_campaigns',
				'edit_others_campaigns',
				'publish_campaigns',
				'read_private_campaigns',
				'delete_campaigns',
				'delete_private_campaigns',
				'delete_published_campaigns',
				'delete_others_campaigns',
				'edit_private_campaigns',
				'edit_published_campaigns',

				/* Donation post type */
				'edit_donation',
				'read_donation',
				'delete_donation',
				'edit_donations',
				'edit_others_donations',
				'publish_donations',
				'read_private_donations',
				'delete_donations',
				'delete_private_donations',
				'delete_published_donations',
				'delete_others_donations',
				'edit_private_donations',
				'edit_published_donations',

				/* Terms */
				'manage_campaign_terms',
				'edit_campaign_terms',
				'delete_campaign_terms',
				'assign_campaign_terms',
			);
		}
	}

endif;

```