File "Helpers.php"

Full path: C:/Inetpub/vhosts/drshti.com/httpdocs/wp-content/plugins/wpforms-lite/src/Admin/Payments/Views/Overview/Helpers.php
File size: 2.59 B (2.59 KB bytes)
MIME-type: text/x-php
Charset: utf-8

Download   Open   Edit   Advanced Editor &nnbsp; Back

<?php

namespace WPForms\Admin\Payments\Views\Overview;

use WPForms\Db\Payments\ValueValidator;

/**
 * Helper methods for the Overview page.
 *
 * @since 1.8.2
 */
class Helpers {

	/**
	 * Get subscription description.
	 *
	 * @since 1.8.2
	 *
	 * @param string $payment_id Payment id.
	 * @param string $amount     Payment amount.
	 *
	 * @return string
	 */
	public static function get_subscription_description( $payment_id, $amount ) {

		// Get the subscription period for the payment.
		$period    = wpforms()->obj( 'payment_meta' )->get_single( $payment_id, 'subscription_period' );
		$intervals = ValueValidator::get_allowed_subscription_intervals();

		// If the subscription period is not set or not allowed, return the amount only.
		if ( ! isset( $intervals[ $period ] ) ) {
			return $amount;
		}

		// Use "/" as a separator between the amount and the subscription period.
		return $amount . ' / ' . $intervals[ $period ];
	}

	/**
	 * Return a placeholder text "N/A" when there is no actual data to display.
	 *
	 * @since 1.8.2
	 *
	 * @param string $with_wrapper Wrap the text within a span tag for styling purposes. Default: true.
	 *
	 * @return string
	 */
	public static function get_placeholder_na_text( $with_wrapper = true ) {

		$text = __( 'N/A', 'wpforms-lite' );

		// Check if the text should be wrapped within a span tag.
		if ( $with_wrapper ) {
			return sprintf( '<span class="payment-placeholder-text-none">%s</span>', $text );
		}

		return $text;
	}

	/**
	 * Get the default heading for the Payments pages.
	 *
	 * @since 1.8.2.2
	 *
	 * @param string $help_link Help link.
	 */
	public static function get_default_heading( $help_link = '' ) {

		if ( ! $help_link ) {
			$help_link = 'https://wpforms.com/docs/viewing-and-managing-payments/';
		}

		echo '<span class="wpforms-payments-overview-help">';
		printf(
			'<a href="%s" target="_blank"><i class="fa fa-question-circle-o"></i>%s</a>',
			esc_url(
				wpforms_utm_link(
					$help_link,
					'Payments Dashboard',
					'Manage Payments Documentation'
				)
			),
			esc_html__( 'Help', 'wpforms-lite' )
		);
		echo '</span>';
	}

	/**
	 * Look for at least one payment in test mode.
	 *
	 * @since 1.9.0
	 *
	 * @return bool
	 */
	public static function is_test_payment_exists(): bool {

		$published = wpforms()->obj( 'payment' )->get_payments(
			[
				'mode'   => 'test',
				'number' => 1,
			]
		);

		if ( $published ) {
			return true;
		}

		// Check for trashed payments.
		return ! empty(
			wpforms()->obj( 'payment' )->get_payments(
				[
					'mode'         => 'test',
					'number'       => 1,
					'is_published' => 0,
				]
			)
		);
	}
}