Jetpack_Plugin_Search::get_configure_url() - Code Metrics - Inspection of "PSH: Verify user has VP or Ak before showing a car..." - Automattic/jetpack - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — update/psh-dont-advertise-vp-a... ( c31b22 )

unknown

created 2019-04-03 09:22 UTC

Jetpack_Plugin_Search::get_configure_url() A

↳ Parent: Jetpack_Plugin_Search

Complexity

Conditions	6
Paths	6

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	6
nc	6
nop	2
dl	0
loc	19
rs	9.0111
c	0
b	0
f	0

<?php
/**
 * Disable direct access and execution.
 */
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}


if (
	is_admin() &&
	Jetpack::is_active() &&
	/** This filter is documented in _inc/lib/admin-pages/class.jetpack-react-page.php */
	apply_filters( 'jetpack_show_promotions', true ) &&
	jetpack_is_psh_active()
) {
	Jetpack_Plugin_Search::init();
}

// Register endpoints when WP REST API is initialized.
add_action( 'rest_api_init', array( 'Jetpack_Plugin_Search', 'register_endpoints' ) );

/**
 * Class that includes cards in the plugin search results when users enter terms that match some Jetpack feature.
 * Card can be dismissed and includes a title, description, button to enable the feature and a link for more information.
 *
 * @since 7.1.0
 */
class Jetpack_Plugin_Search {

	static $slug = 'jetpack-plugin-search';

	public static function init() {
		static $instance = null;

		if ( ! $instance ) {
			jetpack_require_lib( 'tracks/client' );
			$instance = new Jetpack_Plugin_Search();
		}

		return $instance;
	}

	public function __construct() {
		add_action( 'current_screen', array( $this, 'start' ) );
	}

	/**
	 * Add actions and filters only if this is the plugin installation screen and it's the first page.
	 *
	 * @param object $screen
	 *
	 * @since 7.1.0
	 */
	public function start( $screen ) {
		if ( 'plugin-install' === $screen->base && ( ! isset( $_GET['paged'] ) || 1 == $_GET['paged'] ) ) {
			add_action( 'admin_enqueue_scripts', array( $this, 'load_plugins_search_script' ) );
			add_filter( 'plugins_api_result', array( $this, 'inject_jetpack_module_suggestion' ), 10, 3 );
			add_filter( 'self_admin_url', array( $this, 'plugin_details' ) );
			add_filter( 'plugin_install_action_links', array( $this, 'insert_module_related_links' ), 10, 2 );
		}
	}

	/**
	 * Modify URL used to fetch to plugin information so it pulls Jetpack plugin page.
	 *
	 * @param string $url URL to load in dialog pulling the plugin page from wporg.
	 *
	 * @since 7.1.0
	 *
	 * @return string The URL with 'jetpack' instead of 'jetpack-plugin-search'.
	 */
	public function plugin_details( $url ) {
		return false !== stripos( $url, 'tab=plugin-information&amp;plugin=' . self::$slug )
			? 'plugin-install.php?tab=plugin-information&amp;plugin=jetpack&amp;TB_iframe=true&amp;width=600&amp;height=550'
			: $url;
	}

	/**
	 * Register REST API endpoints.
	 *
	 * @since 7.1.0
	 */
	public static function register_endpoints() {
		register_rest_route( 'jetpack/v4', '/hints', array(
			'methods' => WP_REST_Server::EDITABLE,
			'callback' => __CLASS__ . '::dismiss',
			'permission_callback' => __CLASS__ . '::can_request',
			'args' => array(
				'hint' => array(
					'default'           => '',
					'type'              => 'string',
					'required'          => true,
					'validate_callback' => __CLASS__ . '::is_hint_id',
				),
			)
		) );
	}

	/**
	 * A WordPress REST API permission callback method that accepts a request object and
	 * decides if the current user has enough privileges to act.
	 *
	 * @since 7.1.0
	 *
	 * @return bool does a current user have enough privileges.
	 */
	public static function can_request() {
		return current_user_can( 'jetpack_admin_page' );
	}

	/**
	 * Validates that the ID of the hint to dismiss is a string.
	 *
	 * @since 7.1.0
	 *
	 * @param string|bool $value Value to check.
	 * @param WP_REST_Request $request The request sent to the WP REST API.
	 * @param string $param Name of the parameter passed to endpoint holding $value.
	 *
	 * @return bool|WP_Error
	 */
	public static function is_hint_id( $value, $request, $param ) {
		return in_array( $value, Jetpack::get_available_modules(), true )
			? true
			: new WP_Error( 'invalid_param', sprintf( esc_html__( '%s must be an alphanumeric string.', 'jetpack' ), $param ) );
	}

	/**
	 * A WordPress REST API callback method that accepts a request object and decides what to do with it.
	 *
	 * @param WP_REST_Request $request {
	 *     Array of parameters received by request.
	 *
	 *     @type string $hint Slug of card to dismiss.
	 * }
	 *
	 * @since 7.1.0
	 *
	 * @return bool|array|WP_Error a resulting value or object, or an error.
	 */
	public static function dismiss( WP_REST_Request $request ) {
		return self::add_to_dismissed_hints( $request['hint'] )
			? rest_ensure_response( array( 'code' => 'success' ) )
			: new WP_Error( 'not_dismissed', esc_html__( 'The card could not be dismissed', 'jetpack' ), array( 'status' => 400 ) );
	}

	/**
	 * Returns a list of previously dismissed hints.
	 *
	 * @since 7.1.0
	 *
	 * @return array List of dismissed hints.
	 */
	protected static function get_dismissed_hints() {
		$dismissed_hints = Jetpack_Options::get_option( 'dismissed_hints' );
		return isset( $dismissed_hints ) && is_array( $dismissed_hints )
			? $dismissed_hints
			: array();
	}

	/**
	 * Save the hint in the list of dismissed hints.
	 *
	 * @since 7.1.0
	 *
	 * @param string $hint The hint id, which is a Jetpack module slug.
	 *
	 * @return bool Whether the card was added to the list and hence dismissed.
	 */
	protected static function add_to_dismissed_hints( $hint ) {
		return Jetpack_Options::update_option( 'dismissed_hints', array_merge( self::get_dismissed_hints(), array( $hint ) ) );
	}

	/**
	 * Checks that the module slug passed, the hint, is not in the list of previously dismissed hints.
	 *
	 * @since 7.1.0
	 *
	 * @param string $hint The hint id, which is a Jetpack module slug.
	 *
	 * @return bool True if $hint wasn't already dismissed.
	 */
	protected function is_not_dismissed( $hint ) {
		return ! in_array( $hint, $this->get_dismissed_hints(), true );
	}

	public function load_plugins_search_script() {
		wp_enqueue_script( self::$slug, plugins_url( 'modules/plugin-search/plugin-search.js', JETPACK__PLUGIN_FILE ), array( 'jquery' ), JETPACK__VERSION, true );
		wp_localize_script(
			self::$slug,
			'jetpackPluginSearch',
			array(
				'nonce'          => wp_create_nonce( 'wp_rest' ),
				'base_rest_url'  => rest_url( '/jetpack/v4' ),
				'manageSettings' => esc_html__( 'Configure', 'jetpack' ),
				'activateModule' => esc_html__( 'Activate Module', 'jetpack' ),
				'getStarted'     => esc_html__( 'Get started', 'jetpack' ),
				'activated'      => esc_html__( 'Activated', 'jetpack' ),
				'activating'     => esc_html__( 'Activating', 'jetpack' ),
				'logo'           => 'https://ps.w.org/jetpack/assets/icon.svg?rev=1791404',
				'legend'         => esc_html__(
					'Jetpack is trusted by millions to help secure and speed up their WordPress site. Make the most of it today.',
					'jetpack'
				),
				'hideText'       => esc_html__( 'Hide this suggestion', 'jetpack' ),
			)
		);

		wp_enqueue_style( self::$slug, plugins_url( 'modules/plugin-search/plugin-search.css', JETPACK__PLUGIN_FILE ) );
	}

	/**
	 * Get the plugin repo's data for Jetpack to populate the fields with.
	 *
	 * @return array|mixed|object|WP_Error
	 */
	public static function get_jetpack_plugin_data() {
		$data = get_transient( 'jetpack_plugin_data' );

		if ( false === $data || is_wp_error( $data ) ) {
			include_once( ABSPATH . 'wp-admin/includes/plugin-install.php' );
			$data = plugins_api( 'plugin_information', array(
				'slug' => 'jetpack',
				'is_ssl' => is_ssl(),
				'fields' => array(
					'banners' => true,
					'reviews' => true,
					'active_installs' => true,
					'versions' => false,
					'sections' => false,
				),
			) );
			set_transient( 'jetpack_plugin_data', $data, DAY_IN_SECONDS );
		}

		return $data;
	}

	/**
	 * Create a list with additional features for those we don't have a module, like Akismet.
	 *
	 * @since 7.1.0
	 *
	 * @return array List of features.
	 */
	public function get_extra_features() {
		return array(
			'akismet' => array(
				'name' => 'Akismet',
				'search_terms' => 'akismet, anti-spam, antispam, comments, spam, spam protection, form spam, captcha, no captcha, nocaptcha, recaptcha, phising, google',
				'short_description' => esc_html__( 'Keep your visitors and search engines happy by stopping comment and contact form spam with Akismet.', 'jetpack' ),
				'requires_connection' => true,
				'module' => 'akismet',
				'sort' => '16',
				'learn_more_button' => 'https://jetpack.com/features/security/spam-filtering/',
				'configure_url' => admin_url( 'admin.php?page=akismet-key-config' ),
			),
		);
	}

	/**
	 * Intercept the plugins API response and add in an appropriate card for Jetpack
	 */
	public function inject_jetpack_module_suggestion( $result, $action, $args ) {

		// Looks like a search query; it's matching time
		if ( ! empty( $args->search ) ) {
			require_once JETPACK__PLUGIN_DIR . 'class.jetpack-admin.php';
			$jetpack_modules_list = array_intersect_key(
				array_merge( $this->get_extra_features(), Jetpack_Admin::init()->get_modules() ),
				array_flip( array(
					'contact-form',
					'lazy-images',
					'monitor',
					'photon',
					'photon-cdn',
					'protect',
					'publicize',
					'related-posts',
					'sharedaddy',
					'akismet',
					'vaultpress',
					'videopress',
					'search',
				) )
			);
			uasort( $jetpack_modules_list, array( $this, 'by_sorting_option' ) );

			// Record event when user searches for a term over 3 chars (less than 3 is not very useful.)
			if ( strlen( $args->search ) >= 3 ) {
				JetpackTracking::record_user_event( 'wpa_plugin_search_term', array( 'search_term' => $args->search ) );
			}

			// Lowercase, trim, remove punctuation/special chars, decode url, remove 'jetpack'
			$normalized_term = $this->sanitize_search_term( $args->search );

			$matching_module = null;

			// Try to match a passed search term with module's search terms
			foreach ( $jetpack_modules_list as $module_slug => $module_opts ) {
				if ( false !== stripos( $module_opts['search_terms'] . ', ' . $module_opts['name'], $normalized_term ) ) {
					$matching_module = $module_slug;
					break;
				}
			}

			if ( isset( $matching_module ) && $this->is_not_dismissed( $matching_module ) ) {
				// Verify user has VP or Ak before showing a card to ensure we're not advertising
				// something that the user would have to pay for.
				if ( in_array( $module_slug, array( 'vaultpress', 'akismet' ) ) && ! Jetpack_Plan::supports( $module_slug ) ) {
foreach ($a as $b) {
}

// $b is defined here only if $a has elements, for example if $a is array()
// then $b would not be defined here. To avoid that, we recommend to set a
// default value for $b.


// Better
$b = 0; // or whatever default makes sense in your context
foreach ($a as $b) {
}

// $b is now guaranteed to be defined here.
					return $result;
				}
				// Record event when a matching feature is found
				JetpackTracking::record_user_event( 'wpa_plugin_search_match_found', array( 'feature' => $matching_module ) );

				$inject = (array) self::get_jetpack_plugin_data();
				$image_url = plugins_url( 'modules/plugin-search/psh', JETPACK__PLUGIN_FILE );
				$overrides = array(
					'plugin-search' => true, // Helps to determine if that an injected card.
					'name' => sprintf(       // Supplement name/description so that they clearly indicate this was added.
						esc_html_x( 'Jetpack: %s', 'Jetpack: Module Name', 'jetpack' ),
						$jetpack_modules_list[ $matching_module ]['name']
					),
					'short_description' => $jetpack_modules_list[ $matching_module ]['short_description'],
					'requires_connection' => (bool) $jetpack_modules_list[ $matching_module ]['requires_connection'],
					'slug'    => self::$slug,
					'version' => JETPACK__VERSION,
					'icons' => array(
						'1x'  => "$image_url-128.png",
						'2x'  => "$image_url-256.png",
						'svg' => "$image_url.svg",
					),
				);

				// Splice in the base module data
				$inject = array_merge( $inject, $jetpack_modules_list[ $matching_module ], $overrides );

				// Add it to the top of the list
				$result->plugins = array_filter( $result->plugins, array( $this, 'filter_cards' ) );
				array_unshift( $result->plugins, $inject );
			}
		}
		return $result;
	}

	/**
	 * Remove cards for Jetpack plugins since we don't want duplicates.
	 *
	 * @since 7.1.0
	 * @since 7.2.0 Only remove Jetpack.
	 *
	 * @param array|object $plugin
	 *
	 * @return bool
	 */
	function filter_cards( $plugin ) {
		// Take in account that before WordPress 5.1, the list of plugins is an array of objects.
		// With WordPress 5.1 the list of plugins is an array of arrays.
		$slug = is_array( $plugin ) ? $plugin['slug'] : $plugin->slug;
		return ! in_array( $slug, array( 'jetpack' ), true );
	}

	/**
	 * Take a raw search query and return something a bit more standardized and
	 * easy to work with.
	 *
	 * @param  String $term The raw search term
	 * @return String A simplified/sanitized version.
	 */
	private function sanitize_search_term( $term ) {
		$term = strtolower( urldecode( $term ) );

		// remove non-alpha/space chars.
		$term = preg_replace( '/[^a-z ]/', '', $term );

		// remove strings that don't help matches.
		$term = trim( str_replace( array( 'jetpack', 'jp', 'free', 'wordpress' ), '', $term ) );

		return $term;
	}

	/**
	 * Callback function to sort the array of modules by the sort option.
	 */
	private function by_sorting_option( $m1, $m2 ) {
		return $m1['sort'] - $m2['sort'];
	}

	/**
	 * Builds a URL to purchase and upgrade inserting the site fragment and the affiliate code if it exists.
	 *
	 * @param string $feature Module slug (or forged one for extra features).
	 *
	 * @since 7.1.0
	 *
	 * @return string URL to upgrade.
	 */
	private function get_upgrade_url( $feature ) {
		$site_raw_url = Jetpack::build_raw_urls( get_home_url() );
		$affiliateCode = Jetpack_Affiliate::init()->get_affiliate_code();
		$user = wp_get_current_user()->ID;
		return "https://jetpack.com/redirect/?source=plugin-hint-upgrade-$feature&site=$site_raw_url&u=$user" .
		       ( $affiliateCode ? "&aff=$affiliateCode" : '' );
	}

	/**
	 * Modify the URL to the feature settings, for example Publicize.
	 * Sharing is included here because while we still have a page in WP Admin,
	 * we prefer to send users to Calypso.
	 *
	 * @param string $feature
	 * @param string $configure_url
	 *
	 * @return string
	 * @since 7.1.0
	 *
	 */
	private function get_configure_url( $feature, $configure_url ) {
		$siteFragment = Jetpack::build_raw_urls( get_home_url() );
		switch ( $feature ) {
			case 'sharing':
			case 'publicize':
				$configure_url = "https://wordpress.com/sharing/$siteFragment";
				break;
			case 'seo-tools':
				$configure_url = "https://wordpress.com/settings/traffic/$siteFragment#seo";
				break;
			case 'google-analytics':
				$configure_url = "https://wordpress.com/settings/traffic/$siteFragment#analytics";
				break;
			case 'wordads':
				$configure_url = "https://wordpress.com/ads/settings/$siteFragment";
				break;
		}
		return $configure_url;
	}

	/**
	 * Put some more appropriate links on our custom result cards.
	 */
	public function insert_module_related_links( $links, $plugin ) {
		if ( self::$slug !== $plugin['slug'] ) {
			return $links;
		}

		// By the time this filter is applied, self_admin_url was already applied and we don't need it anymore.
		remove_filter( 'self_admin_url', array( $this, 'plugin_details' ) );

		$links = array();

		if ( 'akismet' === $plugin['module'] || 'vaultpress' === $plugin['module'] ) {
			$links['jp_get_started'] = '<a
				id="plugin-select-settings"
				class="jetpack-plugin-search__primary jetpack-plugin-search__get-started button"
				href="https://jetpack.com/redirect/?source=plugin-hint-learn-' . $plugin['module'] . '"
				data-module="' . esc_attr( $plugin['module'] ) . '"
				data-track="get_started"
				>' . esc_html__( 'Get started', 'jetpack' ) . '</a>';
			// Jetpack installed, active, feature not enabled; prompt to enable.
		} elseif (
			current_user_can( 'jetpack_activate_modules' ) &&
			! Jetpack::is_module_active( $plugin['module'] ) &&
			Jetpack_Plan::supports( $plugin['module'] )
		) {
			$links[] = '
				<button
					id="plugin-select-activate"
					class="jetpack-plugin-search__primary button"
					data-module="' . esc_attr( $plugin['module'] ) . '"
					data-configure-url="' . esc_url( $this->get_configure_url( $plugin['module'], $plugin['configure_url'] ) ) . '"
					> ' . esc_html__( 'Enable', 'jetpack' ) . '</button>';
		} elseif (
			! empty( $plugin['configure_url'] ) &&
			current_user_can( 'jetpack_configure_modules' ) &&
			Jetpack::is_module_active( $plugin['module'] ) &&
			/** This filter is documented in class.jetpack-admin.php */
			apply_filters( 'jetpack_module_configurable_' . $plugin['module'], false )
		) {
			$links[] = '<a
				id="plugin-select-settings"
				class="jetpack-plugin-search__primary button jetpack-plugin-search__configure"
				href="' . esc_url( $this->get_configure_url( $plugin['module'], $plugin['configure_url'] ) ) . '"
				data-module="' . esc_attr( $plugin['module'] ) . '"
				data-track="configure"
				>' . esc_html__( 'Configure', 'jetpack' ) . '</a>';
			// Module is active, doesn't have options to configure
		} elseif ( Jetpack::is_module_active( $plugin['module'] ) ) {
			$links['jp_get_started'] = '<a
				id="plugin-select-settings"
				class="jetpack-plugin-search__primary jetpack-plugin-search__get-started button"
				href="https://jetpack.com/redirect/?source=plugin-hint-learn-' . $plugin['module'] . '"
				data-module="' . esc_attr( $plugin['module'] ) . '"
				data-track="get_started"
				>' . esc_html__( 'Get started', 'jetpack' ) . '</a>';
		}

		// Add link pointing to a relevant doc page in jetpack.com only if the Get started button isn't displayed.
		if ( ! empty( $plugin['learn_more_button'] ) && ! isset( $links['jp_get_started'] ) ) {
			$links[] = '<a
				class="jetpack-plugin-search__learn-more"
				href="' . esc_url( $plugin['learn_more_button'] ) . '"
				target="_blank"
				data-module="' . esc_attr( $plugin['module'] ) . '"
				data-track="learn_more"
				>' . esc_html__( 'Learn more', 'jetpack' ) . '</a>';
		}

		// Dismiss link
		$links[] = '<a
			class="jetpack-plugin-search__dismiss"
			data-module="' . esc_attr( $plugin['module'] ) . '"
			>' . esc_html__( 'Hide this suggestion', 'jetpack' ) . '</a>';

		return $links;
	}

}

/**
 * Master control that checks if Plugin search hints is active.
 *
 * @since 7.1.1
 *
 * @return bool True if PSH is active.
 */
function jetpack_is_psh_active() {
	// false means unset, 1 means active, 0 means inactive.
	$status = get_transient( 'jetpack_psh_status' );

	if ( false === $status ) {
		$error = false;
		$status = jetpack_get_remote_is_psh_active( $error );
		set_transient(
			'jetpack_psh_status',
			// Cache as int
			(int) $status,
			// If there was an error, still cache but for a shorter time
			( $error ? 5 : 15 ) * MINUTE_IN_SECONDS
		);
	}

	return (bool) $status;
}

/**
 * Makes remote request to determine if Plugin search hints is active.
 *
 * @since 7.1.1
 * @internal
 *
 * @param bool &$error Did the remote request result in an error?
 * @return bool True if PSH is active.
 */
function jetpack_get_remote_is_psh_active( &$error ) {
	$response = wp_remote_get( 'https://jetpack.com/psh-status/' );
	if ( is_wp_error( $response ) ) {
		$error = true;
		return true;
	}

	$body = wp_remote_retrieve_body( $response );
	if ( empty( $body ) ) {
		$error = true;
		return true;
	}

	$json = json_decode( $body );
	if ( ! isset( $json->active ) ) {
		$error = true;
		return true;
	}

	$error = false;
	return (bool) $json->active;
}


1			<?php
2			/**
3			* Disable direct access and execution.
4			*/
5			if ( ! defined( 'ABSPATH' ) ) {
6			exit;
7			}
8
9
10			if (
11			is_admin() &&
12			Jetpack::is_active() &&
13			/** This filter is documented in _inc/lib/admin-pages/class.jetpack-react-page.php */
14			apply_filters( 'jetpack_show_promotions', true ) &&
15			jetpack_is_psh_active()
16			) {
17			Jetpack_Plugin_Search::init();
18			}
19
20			// Register endpoints when WP REST API is initialized.
21			add_action( 'rest_api_init', array( 'Jetpack_Plugin_Search', 'register_endpoints' ) );
22
23			/**
24			* Class that includes cards in the plugin search results when users enter terms that match some Jetpack feature.
25			* Card can be dismissed and includes a title, description, button to enable the feature and a link for more information.
26			*
27			* @since 7.1.0
28			*/
29			class Jetpack_Plugin_Search {
30
31			static $slug = 'jetpack-plugin-search';
32
33			public static function init() {
34			static $instance = null;
35
36			if ( ! $instance ) {
37			jetpack_require_lib( 'tracks/client' );
38			$instance = new Jetpack_Plugin_Search();
39			}
40
41			return $instance;
42			}
43
44			public function __construct() {
45			add_action( 'current_screen', array( $this, 'start' ) );
46			}
47
48			/**
49			* Add actions and filters only if this is the plugin installation screen and it's the first page.
50			*
51			* @param object $screen
52			*
53			* @since 7.1.0
54			*/
55			public function start( $screen ) {
56			if ( 'plugin-install' === $screen->base && ( ! isset( $_GET['paged'] ) \|\| 1 == $_GET['paged'] ) ) {
57			add_action( 'admin_enqueue_scripts', array( $this, 'load_plugins_search_script' ) );
58			add_filter( 'plugins_api_result', array( $this, 'inject_jetpack_module_suggestion' ), 10, 3 );
59			add_filter( 'self_admin_url', array( $this, 'plugin_details' ) );
60			add_filter( 'plugin_install_action_links', array( $this, 'insert_module_related_links' ), 10, 2 );
61			}
62			}
63
64			/**
65			* Modify URL used to fetch to plugin information so it pulls Jetpack plugin page.
66			*
67			* @param string $url URL to load in dialog pulling the plugin page from wporg.
68			*
69			* @since 7.1.0
70			*
71			* @return string The URL with 'jetpack' instead of 'jetpack-plugin-search'.
72			*/
73			public function plugin_details( $url ) {
74			return false !== stripos( $url, 'tab=plugin-information&plugin=' . self::$slug )
75			? 'plugin-install.php?tab=plugin-information&plugin=jetpack&TB_iframe=true&width=600&height=550'
76			: $url;
77			}
78
79			/**
80			* Register REST API endpoints.
81			*
82			* @since 7.1.0
83			*/
84			public static function register_endpoints() {
85			register_rest_route( 'jetpack/v4', '/hints', array(
86			'methods' => WP_REST_Server::EDITABLE,
87			'callback' => __CLASS__ . '::dismiss',
88			'permission_callback' => __CLASS__ . '::can_request',
89			'args' => array(
90			'hint' => array(
91			'default' => '',
92			'type' => 'string',
93			'required' => true,
94			'validate_callback' => __CLASS__ . '::is_hint_id',
95			),
96			)
97			) );
98			}
99
100			/**
101			* A WordPress REST API permission callback method that accepts a request object and
102			* decides if the current user has enough privileges to act.
103			*
104			* @since 7.1.0
105			*
106			* @return bool does a current user have enough privileges.
107			*/
108			public static function can_request() {
109			return current_user_can( 'jetpack_admin_page' );
110			}
111
112			/**
113			* Validates that the ID of the hint to dismiss is a string.
114			*
115			* @since 7.1.0
116			*
117			* @param string\|bool $value Value to check.
118			* @param WP_REST_Request $request The request sent to the WP REST API.
119			* @param string $param Name of the parameter passed to endpoint holding $value.
120			*
121			* @return bool\|WP_Error
122			*/
123			public static function is_hint_id( $value, $request, $param ) {
124			return in_array( $value, Jetpack::get_available_modules(), true )
125			? true
126			: new WP_Error( 'invalid_param', sprintf( esc_html__( '%s must be an alphanumeric string.', 'jetpack' ), $param ) );
127			}
128
129			/**
130			* A WordPress REST API callback method that accepts a request object and decides what to do with it.
131			*
132			* @param WP_REST_Request $request {
133			* Array of parameters received by request.
134			*
135			* @type string $hint Slug of card to dismiss.
136			* }
137			*
138			* @since 7.1.0
139			*
140			* @return bool\|array\|WP_Error a resulting value or object, or an error.
141			*/
142			public static function dismiss( WP_REST_Request $request ) {
143			return self::add_to_dismissed_hints( $request['hint'] )
144			? rest_ensure_response( array( 'code' => 'success' ) )
145			: new WP_Error( 'not_dismissed', esc_html__( 'The card could not be dismissed', 'jetpack' ), array( 'status' => 400 ) );
146			}
147
148			/**
149			* Returns a list of previously dismissed hints.
150			*
151			* @since 7.1.0
152			*
153			* @return array List of dismissed hints.
154			*/
155			protected static function get_dismissed_hints() {
156			$dismissed_hints = Jetpack_Options::get_option( 'dismissed_hints' );
157			return isset( $dismissed_hints ) && is_array( $dismissed_hints )
158			? $dismissed_hints
159			: array();
160			}
161
162			/**
163			* Save the hint in the list of dismissed hints.
164			*
165			* @since 7.1.0
166			*
167			* @param string $hint The hint id, which is a Jetpack module slug.
168			*
169			* @return bool Whether the card was added to the list and hence dismissed.
170			*/
171			protected static function add_to_dismissed_hints( $hint ) {
172			return Jetpack_Options::update_option( 'dismissed_hints', array_merge( self::get_dismissed_hints(), array( $hint ) ) );
173			}
174
175			/**
176			* Checks that the module slug passed, the hint, is not in the list of previously dismissed hints.
177			*
178			* @since 7.1.0
179			*
180			* @param string $hint The hint id, which is a Jetpack module slug.
181			*
182			* @return bool True if $hint wasn't already dismissed.
183			*/
184			protected function is_not_dismissed( $hint ) {
185			return ! in_array( $hint, $this->get_dismissed_hints(), true );
186			}
187
188			public function load_plugins_search_script() {
189			wp_enqueue_script( self::$slug, plugins_url( 'modules/plugin-search/plugin-search.js', JETPACK__PLUGIN_FILE ), array( 'jquery' ), JETPACK__VERSION, true );
190			wp_localize_script(
191			self::$slug,
192			'jetpackPluginSearch',
193			array(
194			'nonce' => wp_create_nonce( 'wp_rest' ),
195			'base_rest_url' => rest_url( '/jetpack/v4' ),
196			'manageSettings' => esc_html__( 'Configure', 'jetpack' ),
197			'activateModule' => esc_html__( 'Activate Module', 'jetpack' ),
198			'getStarted' => esc_html__( 'Get started', 'jetpack' ),
199			'activated' => esc_html__( 'Activated', 'jetpack' ),
200			'activating' => esc_html__( 'Activating', 'jetpack' ),
201			'logo' => 'https://ps.w.org/jetpack/assets/icon.svg?rev=1791404',
202			'legend' => esc_html__(
203			'Jetpack is trusted by millions to help secure and speed up their WordPress site. Make the most of it today.',
204			'jetpack'
205			),
206			'hideText' => esc_html__( 'Hide this suggestion', 'jetpack' ),
207			)
208			);
209
210			wp_enqueue_style( self::$slug, plugins_url( 'modules/plugin-search/plugin-search.css', JETPACK__PLUGIN_FILE ) );
211			}
212
213			/**
214			* Get the plugin repo's data for Jetpack to populate the fields with.
215			*
216			* @return array\|mixed\|object\|WP_Error
217			*/
218			public static function get_jetpack_plugin_data() {
219			$data = get_transient( 'jetpack_plugin_data' );
220
221			if ( false === $data \|\| is_wp_error( $data ) ) {
222			include_once( ABSPATH . 'wp-admin/includes/plugin-install.php' );
223			$data = plugins_api( 'plugin_information', array(
224			'slug' => 'jetpack',
225			'is_ssl' => is_ssl(),
226			'fields' => array(
227			'banners' => true,
228			'reviews' => true,
229			'active_installs' => true,
230			'versions' => false,
231			'sections' => false,
232			),
233			) );
234			set_transient( 'jetpack_plugin_data', $data, DAY_IN_SECONDS );
235			}
236
237			return $data;
238			}
239
240			/**
241			* Create a list with additional features for those we don't have a module, like Akismet.
242			*
243			* @since 7.1.0
244			*
245			* @return array List of features.
246			*/
247			public function get_extra_features() {
248			return array(
249			'akismet' => array(
250			'name' => 'Akismet',
251			'search_terms' => 'akismet, anti-spam, antispam, comments, spam, spam protection, form spam, captcha, no captcha, nocaptcha, recaptcha, phising, google',
252			'short_description' => esc_html__( 'Keep your visitors and search engines happy by stopping comment and contact form spam with Akismet.', 'jetpack' ),
253			'requires_connection' => true,
254			'module' => 'akismet',
255			'sort' => '16',
256			'learn_more_button' => 'https://jetpack.com/features/security/spam-filtering/',
257			'configure_url' => admin_url( 'admin.php?page=akismet-key-config' ),
258			),
259			);
260			}
261
262			/**
263			* Intercept the plugins API response and add in an appropriate card for Jetpack
264			*/
265			public function inject_jetpack_module_suggestion( $result, $action, $args ) {
266
267			// Looks like a search query; it's matching time
268			if ( ! empty( $args->search ) ) {
269			require_once JETPACK__PLUGIN_DIR . 'class.jetpack-admin.php';
270			$jetpack_modules_list = array_intersect_key(
271			array_merge( $this->get_extra_features(), Jetpack_Admin::init()->get_modules() ),
272			array_flip( array(
273			'contact-form',
274			'lazy-images',
275			'monitor',
276			'photon',
277			'photon-cdn',
278			'protect',
279			'publicize',
280			'related-posts',
281			'sharedaddy',
282			'akismet',
283			'vaultpress',
284			'videopress',
285			'search',
286			) )
287			);
288			uasort( $jetpack_modules_list, array( $this, 'by_sorting_option' ) );
289
290			// Record event when user searches for a term over 3 chars (less than 3 is not very useful.)
291			if ( strlen( $args->search ) >= 3 ) {
292			JetpackTracking::record_user_event( 'wpa_plugin_search_term', array( 'search_term' => $args->search ) );
293			}
294
295			// Lowercase, trim, remove punctuation/special chars, decode url, remove 'jetpack'
296			$normalized_term = $this->sanitize_search_term( $args->search );
297
298			$matching_module = null;
299
300			// Try to match a passed search term with module's search terms
301			foreach ( $jetpack_modules_list as $module_slug => $module_opts ) {
302			if ( false !== stripos( $module_opts['search_terms'] . ', ' . $module_opts['name'], $normalized_term ) ) {
303			$matching_module = $module_slug;
304			break;
305			}
306			}
307
308			if ( isset( $matching_module ) && $this->is_not_dismissed( $matching_module ) ) {
309			// Verify user has VP or Ak before showing a card to ensure we're not advertising
310			// something that the user would have to pay for.
311			if ( in_array( $module_slug, array( 'vaultpress', 'akismet' ) ) && ! Jetpack_Plan::supports( $module_slug ) ) {
			0 ignored issues – show Bug introduced 2019-04-03 09:30 UTC by Report Bug Copy Issue Report The variable `$module_slug` seems to be defined by a `foreach` iteration on line `301`. Are you sure the iterator is never empty, otherwise this variable is not defined? It seems like you are relying on a variable being defined by an iteration: foreach ($a as $b) { } // $b is defined here only if $a has elements, for example if $a is array() // then $b would not be defined here. To avoid that, we recommend to set a // default value for $b. // Better $b = 0; // or whatever default makes sense in your context foreach ($a as $b) { } // $b is now guaranteed to be defined here. Loading history...
312			return $result;
313			}
314			// Record event when a matching feature is found
315			JetpackTracking::record_user_event( 'wpa_plugin_search_match_found', array( 'feature' => $matching_module ) );
316
317			$inject = (array) self::get_jetpack_plugin_data();
318			$image_url = plugins_url( 'modules/plugin-search/psh', JETPACK__PLUGIN_FILE );
319			$overrides = array(
320			'plugin-search' => true, // Helps to determine if that an injected card.
321			'name' => sprintf( // Supplement name/description so that they clearly indicate this was added.
322			esc_html_x( 'Jetpack: %s', 'Jetpack: Module Name', 'jetpack' ),
323			$jetpack_modules_list[ $matching_module ]['name']
324			),
325			'short_description' => $jetpack_modules_list[ $matching_module ]['short_description'],
326			'requires_connection' => (bool) $jetpack_modules_list[ $matching_module ]['requires_connection'],
327			'slug' => self::$slug,
328			'version' => JETPACK__VERSION,
329			'icons' => array(
330			'1x' => "$image_url-128.png",
331			'2x' => "$image_url-256.png",
332			'svg' => "$image_url.svg",
333			),
334			);
335
336			// Splice in the base module data
337			$inject = array_merge( $inject, $jetpack_modules_list[ $matching_module ], $overrides );
338
339			// Add it to the top of the list
340			$result->plugins = array_filter( $result->plugins, array( $this, 'filter_cards' ) );
341			array_unshift( $result->plugins, $inject );
342			}
343			}
344			return $result;
345			}
346
347			/**
348			* Remove cards for Jetpack plugins since we don't want duplicates.
349			*
350			* @since 7.1.0
351			* @since 7.2.0 Only remove Jetpack.
352			*
353			* @param array\|object $plugin
354			*
355			* @return bool
356			*/
357			function filter_cards( $plugin ) {
358			// Take in account that before WordPress 5.1, the list of plugins is an array of objects.
359			// With WordPress 5.1 the list of plugins is an array of arrays.
360			$slug = is_array( $plugin ) ? $plugin['slug'] : $plugin->slug;
361			return ! in_array( $slug, array( 'jetpack' ), true );
362			}
363
364			/**
365			* Take a raw search query and return something a bit more standardized and
366			* easy to work with.
367			*
368			* @param String $term The raw search term
369			* @return String A simplified/sanitized version.
370			*/
371			private function sanitize_search_term( $term ) {
372			$term = strtolower( urldecode( $term ) );
373
374			// remove non-alpha/space chars.
375			$term = preg_replace( '/[^a-z ]/', '', $term );
376
377			// remove strings that don't help matches.
378			$term = trim( str_replace( array( 'jetpack', 'jp', 'free', 'wordpress' ), '', $term ) );
379
380			return $term;
381			}
382
383			/**
384			* Callback function to sort the array of modules by the sort option.
385			*/
386			private function by_sorting_option( $m1, $m2 ) {
387			return $m1['sort'] - $m2['sort'];
388			}
389
390			/**
391			* Builds a URL to purchase and upgrade inserting the site fragment and the affiliate code if it exists.
392			*
393			* @param string $feature Module slug (or forged one for extra features).
394			*
395			* @since 7.1.0
396			*
397			* @return string URL to upgrade.
398			*/
399			private function get_upgrade_url( $feature ) {
400			$site_raw_url = Jetpack::build_raw_urls( get_home_url() );
401			$affiliateCode = Jetpack_Affiliate::init()->get_affiliate_code();
402			$user = wp_get_current_user()->ID;
403			return "https://jetpack.com/redirect/?source=plugin-hint-upgrade-$feature&site=$site_raw_url&u=$user" .
404			( $affiliateCode ? "&aff=$affiliateCode" : '' );
405			}
406
407			/**
408			* Modify the URL to the feature settings, for example Publicize.
409			* Sharing is included here because while we still have a page in WP Admin,
410			* we prefer to send users to Calypso.
411			*
412			* @param string $feature
413			* @param string $configure_url
414			*
415			* @return string
416			* @since 7.1.0
417			*
418			*/
419			private function get_configure_url( $feature, $configure_url ) {
420			$siteFragment = Jetpack::build_raw_urls( get_home_url() );
421			switch ( $feature ) {
422			case 'sharing':
423			case 'publicize':
424			$configure_url = "https://wordpress.com/sharing/$siteFragment";
425			break;
426			case 'seo-tools':
427			$configure_url = "https://wordpress.com/settings/traffic/$siteFragment#seo";
428			break;
429			case 'google-analytics':
430			$configure_url = "https://wordpress.com/settings/traffic/$siteFragment#analytics";
431			break;
432			case 'wordads':
433			$configure_url = "https://wordpress.com/ads/settings/$siteFragment";
434			break;
435			}
436			return $configure_url;
437			}
438
439			/**
440			* Put some more appropriate links on our custom result cards.
441			*/
442			public function insert_module_related_links( $links, $plugin ) {
443			if ( self::$slug !== $plugin['slug'] ) {
444			return $links;
445			}
446
447			// By the time this filter is applied, self_admin_url was already applied and we don't need it anymore.
448			remove_filter( 'self_admin_url', array( $this, 'plugin_details' ) );
449
450			$links = array();
451
452			if ( 'akismet' === $plugin['module'] \|\| 'vaultpress' === $plugin['module'] ) {
453			$links['jp_get_started'] = '<a
454			id="plugin-select-settings"
455			class="jetpack-plugin-search__primary jetpack-plugin-search__get-started button"
456			href="https://jetpack.com/redirect/?source=plugin-hint-learn-' . $plugin['module'] . '"
457			data-module="' . esc_attr( $plugin['module'] ) . '"
458			data-track="get_started"
459			>' . esc_html__( 'Get started', 'jetpack' ) . '</a>';
460			// Jetpack installed, active, feature not enabled; prompt to enable.
461			} elseif (
462			current_user_can( 'jetpack_activate_modules' ) &&
463			! Jetpack::is_module_active( $plugin['module'] ) &&
464			Jetpack_Plan::supports( $plugin['module'] )
465			) {
466			$links[] = '
467			<button
468			id="plugin-select-activate"
469			class="jetpack-plugin-search__primary button"
470			data-module="' . esc_attr( $plugin['module'] ) . '"
471			data-configure-url="' . esc_url( $this->get_configure_url( $plugin['module'], $plugin['configure_url'] ) ) . '"
472			> ' . esc_html__( 'Enable', 'jetpack' ) . '</button>';
473			} elseif (
474			! empty( $plugin['configure_url'] ) &&
475			current_user_can( 'jetpack_configure_modules' ) &&
476			Jetpack::is_module_active( $plugin['module'] ) &&
477			/** This filter is documented in class.jetpack-admin.php */
478			apply_filters( 'jetpack_module_configurable_' . $plugin['module'], false )
479			) {
480			$links[] = '<a
481			id="plugin-select-settings"
482			class="jetpack-plugin-search__primary button jetpack-plugin-search__configure"
483			href="' . esc_url( $this->get_configure_url( $plugin['module'], $plugin['configure_url'] ) ) . '"
484			data-module="' . esc_attr( $plugin['module'] ) . '"
485			data-track="configure"
486			>' . esc_html__( 'Configure', 'jetpack' ) . '</a>';
487			// Module is active, doesn't have options to configure
488			} elseif ( Jetpack::is_module_active( $plugin['module'] ) ) {
489			$links['jp_get_started'] = '<a
490			id="plugin-select-settings"
491			class="jetpack-plugin-search__primary jetpack-plugin-search__get-started button"
492			href="https://jetpack.com/redirect/?source=plugin-hint-learn-' . $plugin['module'] . '"
493			data-module="' . esc_attr( $plugin['module'] ) . '"
494			data-track="get_started"
495			>' . esc_html__( 'Get started', 'jetpack' ) . '</a>';
496			}
497
498			// Add link pointing to a relevant doc page in jetpack.com only if the Get started button isn't displayed.
499			if ( ! empty( $plugin['learn_more_button'] ) && ! isset( $links['jp_get_started'] ) ) {
500			$links[] = '<a
501			class="jetpack-plugin-search__learn-more"
502			href="' . esc_url( $plugin['learn_more_button'] ) . '"
503			target="_blank"
504			data-module="' . esc_attr( $plugin['module'] ) . '"
505			data-track="learn_more"
506			>' . esc_html__( 'Learn more', 'jetpack' ) . '</a>';
507			}
508
509			// Dismiss link
510			$links[] = '<a
511			class="jetpack-plugin-search__dismiss"
512			data-module="' . esc_attr( $plugin['module'] ) . '"
513			>' . esc_html__( 'Hide this suggestion', 'jetpack' ) . '</a>';
514
515			return $links;
516			}
517
518			}
519
520			/**
521			* Master control that checks if Plugin search hints is active.
522			*
523			* @since 7.1.1
524			*
525			* @return bool True if PSH is active.
526			*/
527			function jetpack_is_psh_active() {
528			// false means unset, 1 means active, 0 means inactive.
529			$status = get_transient( 'jetpack_psh_status' );
530
531			if ( false === $status ) {
532			$error = false;
533			$status = jetpack_get_remote_is_psh_active( $error );
534			set_transient(
535			'jetpack_psh_status',
536			// Cache as int
537			(int) $status,
538			// If there was an error, still cache but for a shorter time
539			( $error ? 5 : 15 ) * MINUTE_IN_SECONDS
540			);
541			}
542
543			return (bool) $status;
544			}
545
546			/**
547			* Makes remote request to determine if Plugin search hints is active.
548			*
549			* @since 7.1.1
550			* @internal
551			*
552			* @param bool &$error Did the remote request result in an error?
553			* @return bool True if PSH is active.
554			*/
555			function jetpack_get_remote_is_psh_active( &$error ) {
556			$response = wp_remote_get( 'https://jetpack.com/psh-status/' );
557			if ( is_wp_error( $response ) ) {
558			$error = true;
559			return true;
560			}
561
562			$body = wp_remote_retrieve_body( $response );
563			if ( empty( $body ) ) {
564			$error = true;
565			return true;
566			}
567
568			$json = json_decode( $body );
569			if ( ! isset( $json->active ) ) {
570			$error = true;
571			return true;
572			}
573
574			$error = false;
575			return (bool) $json->active;
576			}
577

Automattic / jetpack

Push — update/psh-dont-advertise-vp-a... ( c31b22 )

Jetpack_Plugin_Search::get_configure_url() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like