Current File : /home/pacjaorg/wpt.pacja.org/wp-content/plugins/formidable/classes/helpers/FrmAddonsHelper.php

<?php
/**
 * Add-Ons helper class.
 *
 * @package Formidable
 */

if ( ! defined( 'ABSPATH' ) ) {
	die( 'You are not allowed to call this page directly.' );
}

/**
 * Provides helper functions for managing add-ons in the admin area.
 *
 * @since 6.15
 */
class FrmAddonsHelper {
	/**
	 * Stores the result of `FrmFormsHelper::get_plan_required`.
	 *
	 * @var string
	 */
	private static $plan_required;

	/**
	 * Show the CTA to upgrade or renew.
	 *
	 * @since 6.15
	 * @return void
	 */
	public static function show_upgrade_renew_cta() {
		if ( FrmAddonsController::is_license_expired() ) {
			self::show_expired_cta();
			return;
		}

		if ( ! FrmAppHelper::pro_is_connected() ) {
			self::show_lite_cta();
			return;
		}

		if ( 'elite' !== FrmAddonsController::license_type() ) {
			self::show_elite_cta();
		}
	}

	/**
	 * Show 'Renew' banner for expired users.
	 *
	 * @since 6.15
	 * @return void
	 */
	private static function show_expired_cta() {
		FrmTipsHelper::show_admin_cta(
			array(
				'title'       => esc_html__( 'Unlock Add-on library', 'formidable' ),
				'description' => esc_html__( 'Renew your subscription today and access our library of add-ons to supercharge your forms.', 'formidable' ),
				'link_text'   => esc_html__( 'Renew Now', 'formidable' ),
				'link_url'    => FrmAddonsController::is_license_expired(),
				'id'          => 'frm-renew-subscription-banner',
			)
		);
	}

	/**
	 * Show 'Upgrade to Pro' banner for users not connected to Pro.
	 *
	 * @since 6.15
	 * @return void
	 */
	private static function show_lite_cta() {
		FrmTipsHelper::show_admin_cta(
			array(
				'title'       => esc_html__( 'Unlock Add-on library', 'formidable' ),
				'description' => esc_html__( 'Upgrade to Pro and access our library of add-ons to supercharge your forms.', 'formidable' ),
				'link_text'   => esc_html__( 'Upgrade to PRO', 'formidable' ),
				'link_url'    => FrmAppHelper::admin_upgrade_link(
					array(
						'medium'  => 'addons',
						'content' => 'upgrade-cta',
					)
				),
				'id'          => 'frm-upgrade-banner',
			)
		);
	}

	/**
	 * Show 'Upgrade' banner for non-elite users.
	 *
	 * @since 6.15
	 * @return void
	 */
	private static function show_elite_cta() {
		FrmTipsHelper::show_admin_cta(
			array(
				'title'       => esc_html__( 'Unlock Even More Add-ons', 'formidable' ),
				'description' => sprintf(
					/* translators: %1$s: Open span tag, %2$s: Close span tag */
					esc_html__( 'Your plan includes %1$s%2$s add-ons. Upgrade to take your forms even farther', 'formidable' ),
					'<span class="frm-addons-available-count">',
					'</span>'
				),
				'link_text'   => esc_html__( 'Upgrade to PRO', 'formidable' ),
				'link_url'    => FrmAppHelper::admin_upgrade_link(
					array(
						'medium'  => 'addons',
						'content' => 'upgrade-cta',
					)
				),
				'id'          => 'frm-upgrade-banner',
			)
		);
	}

	/**
	 * Displays a reconnect link for checking add-ons status.
	 *
	 * @since 6.15
	 * @return void
	 */
	public static function get_reconnect_link() {
		if ( ! FrmAppHelper::pro_is_connected() ) {
			return;
		}
		?>
		<p class="frm-py-2xs">
			<span class="frm-font-medium frm-text-grey-700"><?php esc_html_e( 'Missing add-ons?', 'formidable' ); ?></span>
			<a href="#" id="frm_reconnect_link" class="frm-show-authorized frm-font-semibold" data-refresh="1">
				<?php esc_html_e( 'Check now for a recent upgrade or renewal', 'formidable' ); ?>
			</a>
		</p>
		<?php
	}

	/**
	 * Get the icon for a specific addon.
	 *
	 * @since 6.15
	 * @param string $slug The slug of the addon.
	 * @return void
	 */
	public static function get_addon_icon( $slug ) {
		$icons_map = array(
			'acf-forms'                       => 'acfforms',
			'activecampaign-wordpress-plugin' => 'activecampaign',
			'ai'                              => 'ai-form',
			'authorize-net-aim'               => 'authorize',
			'aweber'                          => 'aweber',
			'bootstrap'                       => 'bootstrap',
			'bootstrap-modal'                 => 'bootstrap',
			'campaign-monitor'                => 'campaignmonitor',
			'constant-contact'                => 'constant_contact',
			'getresponse-wordpress-plugin'    => 'getresponse',
			'google-sheets'                   => 'googlesheets',
			'highrise'                        => 'highrise',
			'hubspot-wordpress'               => 'hubspot',
			'mailchimp'                       => 'mailchimp',
			'mailpoet-newsletters'            => 'mailpoet',
			'paypal-standard'                 => 'paypal',
			'polylang'                        => 'polylang',
			'salesforce'                      => 'salesforcealt',
			'stripe'                          => 'stripealt',
			'twilio'                          => 'twilio',
			'woocommerce'                     => 'woocommerce',
			'zapier'                          => 'zapier',
			'convertkit'                      => 'convertkit',
		);

		$icon = array_key_exists( $slug, $icons_map ) ? 'frm_' . $icons_map[ $slug ] . '_icon' : 'frm_logo_icon';
		if ( 'ai' === $slug ) {
			$icon = str_replace( '_', '-', $icon );
		}

		FrmAppHelper::icon_by_class( 'frmfont ' . $icon );
	}

	/**
	 * Echo attributes for a given addon.
	 *
	 * @since 6.15
	 *
	 * @param array $addon
	 * @return void
	 */
	public static function add_addon_attributes( $addon ) {
		self::set_plan_required( $addon );

		$attributes = array(
			'tabindex'        => '0',
			'frm-search-text' => strtolower( $addon['title'] . ' ' . esc_html( $addon['excerpt'] ) ),
		);

		// Set 'data-slug' attribute.
		if ( ! empty( $addon['slug'] ) ) {
			$attributes['data-slug'] = $addon['slug'];
		}

		// Set 'data-categories' attribute.
		if ( ! empty( $addon['category-slugs'] ) ) {
			$attributes['data-categories'] = implode( ',', $addon['category-slugs'] );
		}

		$attributes['class'] = self::prepare_single_addon_classes( $addon );

		FrmAppHelper::array_to_html_params( $attributes, true );
	}

	/**
	 * Add classes for a given addon.
	 *
	 * @since 6.15
	 *
	 * @param array $addon
	 * @return string
	 */
	private static function prepare_single_addon_classes( $addon ) {
		$class_names   = array( 'frm-card-item frm-flex-col' );
		$class_names[] = 'plugin-card-' . $addon['slug'];
		$class_names[] = 'frm-addon-' . $addon['status']['type'];

		if ( self::is_locked() ) {
			$class_names[] = 'frm-locked-item';
		}

		return implode( ' ', $class_names );
	}

	/**
	 * Check if a given addon is locked.
	 *
	 * @return bool
	 */
	public static function is_locked() {
		return self::$plan_required || ! FrmAppHelper::pro_is_installed();
	}

	/**
	 * Set the required plan for the given addon.
	 *
	 * @note
	 * Because the `FrmFormsHelper::get_plan_required` changes $addon by reference,
	 * we save the result inside a static field called `$plan_required`.
	 *
	 * @since 6.15
	 *
	 * @param array $addon The addon array that will be modified by reference.
	 * @return void
	 */
	private static function set_plan_required( $addon ) {
		self::$plan_required = FrmFormsHelper::get_plan_required( $addon );
	}

	/**
	 * Get the required plan.
	 *
	 * @since 6.15
	 *
	 * @return false|string
	 */
	public static function get_plan() {
		return self::$plan_required;
	}
}