File Editor

Directories:

Files:

Create New File

Edit File: Helpers.php

<?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( '%s', $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 '';
		printf(
			'<a href="%s" target="_blank">%s</a>',
			esc_url(
				wpforms_utm_link(
					$help_link,
					'Payments Dashboard',
					'Manage Payments Documentation'
				)
			),
			esc_html__( 'Help', 'wpforms-lite' )
		);
		echo '';
	}

/**
	 * 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,
				]
			)
		);
	}
}

File Editor

Directories:

Files:

Create New File

Edit File: Helpers.php

Rename File