giftflow.php

<?php
/**
 * Plugin Name: GiftFlow – Donation & Fundraising
 * Plugin URI: https://giftflow.beplus-agency.cloud/
 * Description: The all-in-one fundraising and donation management solution for WordPress. GiftFlow empowers nonprofits and organizations to easily accept donations, run unlimited campaigns, and manage donor relationships—all with a modern interface, robust analytics, and seamless payment integrations (Stripe, PayPal, bank transfer). Designed for growth, security, and extensibility, GiftFlow offers powerful tools—even no coding required—to launch, track, and optimize your giving programs.
 * Version: 1.1.11
 * Author: Beplus
 * Author URI: https://beplusthemes.com/
 * Text Domain: giftflow
 * Domain Path: /languages
 * Requires at least: 6.0
 * Requires PHP: 7.4
 * License: GPL v2 or later
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 *
 * @package GiftFlow
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Plugin version and path constants.
 */
define( 'GIFTFLOW_VERSION', '1.1.11' );
define( 'GIFTFLOW_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
define( 'GIFTFLOW_PLUGIN_URL', plugin_dir_url( __FILE__ ) );
define( 'GIFTFLOW_PLUGIN_BASENAME', plugin_basename( __FILE__ ) );

/*
 * Load Composer autoloaders.
 *
 * 1. vendor/autoload.php — PSR-4 for src/ classes (development).
 * 2. vendor-prefixed/autoload.php — Strauss-prefixed Stripe SDK (production).
 *
 * In production builds, vendor/ is excluded. A fallback autoloader
 * mirrors the PSR-4 mapping from composer.json for the src/ directory.
 */
$vendor_autoload = GIFTFLOW_PLUGIN_DIR . 'vendor/autoload.php';
if ( file_exists( $vendor_autoload ) ) {
	require_once $vendor_autoload;
} else {
	spl_autoload_register(
		function ( string $class_name ) {
			$mappings = array(
				'GiftFlow\\Patterns\\' => 'includes/patterns/',
				'GiftFlow\\' => 'src/',
			);

			foreach ( $mappings as $prefix => $dir ) {
				$prefix_len = strlen( $prefix );
				if ( strncmp( $class_name, $prefix, $prefix_len ) !== 0 ) {
					continue;
				}

				$relative = substr( $class_name, $prefix_len );
				$file     = GIFTFLOW_PLUGIN_DIR . $dir . str_replace( '\\', '/', $relative ) . '.php';

				if ( file_exists( $file ) ) {
					require_once $file;
					return;
				}
			}
		}
	);
}

$prefixed_autoload = GIFTFLOW_PLUGIN_DIR . 'vendor-prefixed/autoload.php';
if ( ! file_exists( $prefixed_autoload ) ) {
	add_action(
		'admin_notices',
		function () {
			printf(
				'<div class="notice notice-error"><p>%s</p></div>',
				esc_html__( 'GiftFlow requires Composer dependencies to be installed. Please run "composer run build" in the plugin directory.', 'giftflow' )
			);
		}
	);
	return;
}
require_once $prefixed_autoload;

/**
 * Remove legacy block registration actions to prevent duplicate
 * "Block type is already registered" notices. BlockRegistry in
 * src/Blocks/BlockRegistry.php handles actual registration at priority 9.
 *
 * @return void
 */
function giftflow_unhook_legacy_block_registrations(): void {
	$legacy_block_funcs = array(
		'giftflow_donation_button_block',
		'giftflow_campaign_status_bar_block',
		'giftflow_campaign_single_content_block',
		'giftflow_campaign_single_images_block',
		'giftflow_campaigns_grid_block',
		'giftflow_donor_account_block',
		'giftflow_share_block',
		'giftflow_thank_donor_block',
	);

	foreach ( $legacy_block_funcs as $func ) {
		remove_action( 'init', $func );
	}
}

/**
 * Legacy file loader (backward compatibility).
 *
 * Loads all classes under includes/ and admin/ that have not yet been
 * migrated to src/ PSR-4 autoloading.
 */
function giftflow_load_files() {
	// Core files.
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-base.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-loader.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-field.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-role.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-ajax.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-donations.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-campaigns.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-block-template.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-logger.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-donation-event-history.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/core/class-wp-block-custom-hooks.php';

	// Blocks are now registered via GiftFlow\Blocks\BlockRegistry (src/Blocks/BlockRegistry.php)
	// which auto-discovers blocks/*/block.json. The legacy block loader is kept for
	// helper functions defined in block.php files (templates depend on these).
	// Block registration from legacy files is removed to prevent duplicates.
	require_once GIFTFLOW_PLUGIN_DIR . 'blocks/index.php';
	giftflow_unhook_legacy_block_registrations();
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/common.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/hooks.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/mail.php';

	// Payment gateways.
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/gateways/class-gateway-base.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/gateways/class-stripe.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/gateways/class-paypal.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/gateways/class-direct-bank-transfer.php';

	// Admin files.
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/dashboard.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/class-export.php';

	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/post-types/class-base-post-type.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/post-types/class-donation.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/post-types/class-donor.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/post-types/class-campaign.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/settings.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/api.php';

	// Meta boxes.
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/meta-boxes/class-base-meta-box.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/meta-boxes/class-donation-transaction-meta.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/meta-boxes/class-donor-contact-meta.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'admin/includes/meta-boxes/class-campaign-details-meta.php';

	// Frontend files.
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/frontend/class-shortcodes.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/frontend/class-forms.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/frontend/class-template.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/frontend/campaign-single-template-hooks.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/frontend/campaign-taxonomy-archive-template-hooks.php';
	require_once GIFTFLOW_PLUGIN_DIR . 'includes/frontend/campaigns-page-template-hooks.php';

	$additional_files = apply_filters( 'giftflow_load_files', array() );

	if ( ! empty( $additional_files ) && is_array( $additional_files ) ) {
		foreach ( $additional_files as $file ) {
			if ( file_exists( $file ) ) {
				require_once $file;
			}
		}
	}
}

// Preload legacy files so classes are available for activation/deactivation.
giftflow_load_files();

/**
 * Boot the plugin via the new container-based architecture.
 *
 * The Plugin class internally calls giftflow_load_files() for
 * backward compatibility.
 *
 * @return \GiftFlow\Core\Plugin
 */
function giftflow_boot() {
	static $plugin = null;

	if ( null === $plugin ) {
		$plugin = new \GiftFlow\Core\Plugin();
		$plugin->boot();
	}

	return $plugin;
}

/**
 * Initialize the plugin on plugins_loaded.
 *
 * @return void
 */
function giftflow_init() {
	giftflow_boot();
}

add_action( 'plugins_loaded', 'giftflow_init' );

/**
 * Activation / Deactivation hooks.
 */
register_activation_hook( __FILE__, 'giftflow_activate' );

/**
 * Plugin activation handler.
 *
 * @return void
 */
function giftflow_activate() {
	if ( version_compare( PHP_VERSION, '7.4', '<' ) ) {
		deactivate_plugins( plugin_basename( __FILE__ ) );
		wp_die(
			esc_html__( 'GiftFlow requires PHP 7.4 or higher.', 'giftflow' ),
			'Plugin Activation Error',
			array( 'back_link' => true )
		);
	}

	$plugin = new \GiftFlow\Core\Plugin();
	$plugin->activate();
}

register_deactivation_hook( __FILE__, 'giftflow_deactivate' );

/**
 * Plugin deactivation handler.
 *
 * @return void
 */
function giftflow_deactivate() {
	delete_option( 'giftflow_first_activation_notice_dismissed' );
	flush_rewrite_rules();

	$plugin = new \GiftFlow\Core\Plugin();
	$plugin->deactivate();
}

/**
 * Add admin bar item.
 */
add_action( 'admin_bar_menu', 'giftflow_admin_bar_item', 100 );

/**
 * Add admin bar items.
 *
 * @param \WP_Admin_Bar $wp_admin_bar The admin bar object.
 * @return void
 */
function giftflow_admin_bar_item( $wp_admin_bar ) {

	if ( ! current_user_can( 'manage_options' ) ) {
		// Do not add admin bar items if user is not allowed.
		return;
	}

	// Add parent item.
	$args = array(
		'id'    => 'giftflow_admin_bar_item',
		'title' => esc_html__( 'Gift Flow Dashboard', 'giftflow' ),
		'href'  => admin_url( 'admin.php?page=giftflow-dashboard' ), // or any URL.
		'meta'  => array(
			'class' => 'giftflow_admin_bar_item',
			'title' => esc_html__( 'Go to Gift Flow Dashboard', 'giftflow' ), // Tooltip.
		),
	);
	$wp_admin_bar->add_node( $args );

	$wp_admin_bar->add_node(
		array(
			'id'     => 'giftflow_admin_bar_item_donations',
			'title'  => esc_html__( 'Donations', 'giftflow' ),
			'href'   => admin_url( 'edit.php?post_type=donation' ),
			'parent' => 'giftflow_admin_bar_item',
		)
	);

	$wp_admin_bar->add_node(
		array(
			'id'     => 'giftflow_admin_bar_item_donors',
			'title'  => esc_html__( 'Donors', 'giftflow' ),
			'href'   => admin_url( 'edit.php?post_type=donor' ),
			'parent' => 'giftflow_admin_bar_item',
		)
	);

	$wp_admin_bar->add_node(
		array(
			'id'     => 'giftflow_admin_bar_item_campaigns',
			'title'  => esc_html__( 'Campaigns', 'giftflow' ),
			'href'   => admin_url( 'edit.php?post_type=campaign' ),
			'parent' => 'giftflow_admin_bar_item',
		)
	);

	// Add child item.
	$wp_admin_bar->add_node(
		array(
			'id'     => 'giftflow_admin_bar_item_settings',
			'title'  => esc_html__( 'Settings', 'giftflow' ),
			'href'   => admin_url( 'admin.php?page=giftflow-settings' ),
			'parent' => 'giftflow_admin_bar_item',
		)
	);
}

/**
 * Add admin notice on first activation to suggest viewing documentation.
 */
add_action( 'admin_init', 'giftflow_add_first_activation_notice' );

/**
 * Add admin notice on first activation to suggest viewing documentation.
 */
function giftflow_add_first_activation_notice() {
	$is_giftflow_help_page = false;
	if (
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		isset( $_GET['page'], $_GET['tab'] )
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.PHP.YodaConditions.NotYoda
		&& sanitize_text_field( wp_unslash( $_GET['page'] ) ) === 'giftflow-dashboard'
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.PHP.YodaConditions.NotYoda
		&& sanitize_text_field( wp_unslash( $_GET['tab'] ) ) === 'help'
	) {
		$is_giftflow_help_page = true;
	}

	// Show admin notice on first activation to suggest viewing documentation.
	if ( is_admin()
		&& ! get_option( 'giftflow_first_activation_notice_dismissed', false )
		&& ! $is_giftflow_help_page
	) {
		add_action(
			'admin_notices',
			function () {
				// Only show to users who can manage options.
				if ( ! current_user_can( 'manage_options' ) ) {
					return;
				}

				// Prepare URL to documentation. You may want to change this as needed.
				$docs_url = esc_url( admin_url( 'admin.php?page=giftflow-dashboard&tab=help' ) );
				?>
			<div
				class="notice notice-info is-dismissible giftflow-first-activation-notice"
				data-nonce="<?php echo esc_attr( wp_create_nonce( 'giftflow_dismiss_notice' ) ); ?>">
				<p>
					<?php esc_html_e( 'It looks like you\'re using GiftFlow for the first time. We highly recommend visiting the documentation page to quickly get started and make the most out of your donation campaigns.', 'giftflow' ); ?>
					<a 
						href="<?php echo esc_url( $docs_url ); ?>" 
						target="_blank" >
						<?php esc_html_e( 'View documentation here.', 'giftflow' ); ?>
					</a>
				</p>
			</div>
				<?php
			}
		);

		add_action(
			'wp_ajax_giftflow_dismiss_first_activation_notice',
			function () {
				check_ajax_referer( 'giftflow_dismiss_notice', '_giftflow_nonce' );
				update_option( 'giftflow_first_activation_notice_dismissed', true );
				wp_send_json_success();
			}
		);
	}
}