WordPress at a glance
class is not described

Automattic\WooCommerce\Admin

PaymentPlugins{} WC 1.0

Contains backend logic for retrieving payment plugin recommendations.

Return

null. Nothing.

Usage

$PaymentPlugins = new PaymentPlugins();
// use class methods

Methods

  1. allow_recommendations()
  2. get_instance()
  3. get_recommended_plugins()

Code of PaymentPlugins{} WC 5.4.1

<?php
class PaymentPlugins {

	/**
	 * Name of recommended plugins transient.
	 *
	 * @var string
	 */
	const RECOMMENDED_PLUGINS_TRANSIENT = 'wc_recommended_payment_plugins';


	/**
	 * Class instance.
	 *
	 * @var PaymentPlugins instance
	 */
	protected static $instance = null;

	/**
	 * Get class instance.
	 */
	public static function get_instance() {
		if ( ! self::$instance ) {
			self::$instance = new self();
		}
		return self::$instance;
	}

	/**
	 * Load recommended payment plugins from WooCommerce.com
	 *
	 * @return array
	 */
	public function get_recommended_plugins() {
		if ( ! self::allow_recommendations() ) {
			return array();
		}
		$plugins_data = get_transient( self::RECOMMENDED_PLUGINS_TRANSIENT );

		if ( false === $plugins_data ) {
			include_once ABSPATH . '/wp-admin/includes/plugin-install.php';

			$url     = 'https://woocommerce.com/wp-json/wccom/marketplace-suggestions/1.0/payment-suggestions.json';
			$request = wp_safe_remote_get( $url );
			$plugins = [];

			if ( ! is_wp_error( $request ) && 200 === $request['response']['code'] ) {
				$plugins = json_decode( $request['body'], true );
			}
			foreach ( $plugins as $key => $plugin ) {
				if ( ! array_key_exists( 'copy', $plugins[ $key ] ) ) {
					$api = plugins_api(
						'plugin_information',
						array(
							'slug'   => $plugin['product'],
							'fields' => array(
								'short_description' => true,
							),
						)
					);
					if ( is_wp_error( $api ) ) {
						continue;
					}
					$plugins[ $key ]['copy'] = $api->short_description;
				}
			}

			$plugins_data = array(
				'recommendations' => $plugins,
				'updated'         => time(),
			);

			set_transient(
				self::RECOMMENDED_PLUGINS_TRANSIENT,
				$plugins_data,
				// Expire transient in 15 minutes if remote get failed.
				// Cache an empty result to avoid repeated failed requests.
				empty( $plugins ) ? 900 : 3 * DAY_IN_SECONDS
			);
		}

		return array_values( $plugins_data['recommendations'] );
	}

	/**
	 * Should recommendations be displayed?
	 *
	 * @return bool
	 */
	private function allow_recommendations() {
		// Suggestions are only displayed if user can install plugins.
		if ( ! current_user_can( 'install_plugins' ) ) {
			return false;
		}

		// Suggestions may be disabled via a setting under Accounts & Privacy.
		if ( 'no' === get_option( 'woocommerce_show_marketplace_suggestions', 'yes' ) ) {
			return false;
		}

		// User can disabled all suggestions via filter.
		return apply_filters( 'woocommerce_allow_payment_recommendations', true );
	}
}