관리-도구

편집 파일: class-suggested-plugins.php

<?php
/**
 * WPSEO plugin file.
 *
 * @package WPSEO\Suggested_Plugins
 */

use Yoast\WP\SEO\Conditionals\Conditional;

/**
 * Class WPSEO_Suggested_Plugins
 */
class WPSEO_Suggested_Plugins implements WPSEO_WordPress_Integration {

/**
	 * Holds the availability checker.
	 *
	 * @var WPSEO_Plugin_Availability
	 */
	protected $availability_checker;

/**
	 * Holds the notification center.
	 *
	 * @var Yoast_Notification_Center
	 */
	protected $notification_center;

/**
	 * WPSEO_Suggested_Plugins constructor.
	 *
	 * @param WPSEO_Plugin_Availability $availability_checker The availability checker to use.
	 * @param Yoast_Notification_Center $notification_center  The notification center to add notifications to.
	 */
	public function __construct( WPSEO_Plugin_Availability $availability_checker, Yoast_Notification_Center $notification_center ) {
		$this->availability_checker = $availability_checker;
		$this->notification_center  = $notification_center;
	}

/**
	 * Registers all hooks to WordPress.
	 *
	 * @return void
	 */
	public function register_hooks() {
		add_action( 'admin_init', [ $this->availability_checker, 'register' ] );
		add_action( 'admin_init', [ $this, 'add_notifications' ] );
	}

/**
	 * Adds notifications (when necessary).
	 *
	 * @return void
	 */
	public function add_notifications() {
		$checker = $this->availability_checker;

// Get all Yoast plugins that have dependencies.
		$plugins = $checker->get_plugins_with_dependencies();

foreach ( $plugins as $plugin_name => $plugin ) {
			$notification_id = 'wpseo-suggested-plugin-' . $plugin_name;

if ( ! $checker->dependencies_are_satisfied( $plugin ) ) {
				$this->notification_center->remove_notification_by_id( $notification_id );

continue;
			}

if ( ! $checker->is_installed( $plugin ) ) {
				$notification = $this->get_yoast_seo_suggested_plugins_notification( $notification_id, $plugin );
				$this->notification_center->add_notification( $notification );

continue;
			}

$this->notification_center->remove_notification_by_id( $notification_id );
		}
	}

/**
	 * Build Yoast SEO suggested plugins notification.
	 *
	 * @param string                                                $notification_id The id of the notification to be created.
	 * @param array<string, string|bool|array<string, Conditional>> $plugin          The plugin to retrieve the data from.
	 *
	 * @return Yoast_Notification The notification containing the suggested plugin.
	 */
	protected function get_yoast_seo_suggested_plugins_notification( $notification_id, $plugin ) {
		$message = $this->create_install_suggested_plugin_message( $plugin );

return new Yoast_Notification(
			$message,
			[
				'id'           => $notification_id,
				'type'         => Yoast_Notification::WARNING,
				'capabilities' => [ 'install_plugins' ],
			],
		);
	}

/**
	 * Creates a message to suggest the installation of a particular plugin.
	 *
	 * @param array $suggested_plugin The suggested plugin.
	 *
	 * @return string The install suggested plugin message.
	 */
	protected function create_install_suggested_plugin_message( $suggested_plugin ) {
		/* translators: %1$s expands to an opening strong tag, %2$s expands to the dependency name, %3$s expands to a closing strong tag, %4$s expands to an opening anchor tag, %5$s expands to a closing anchor tag. */
		$message      = __( 'It looks like you aren\'t using our %1$s%2$s addon%3$s. %4$sUpgrade today%5$s to unlock more tools and SEO features to make your products stand out in search results.', 'wordpress-seo' );
		$install_link = WPSEO_Admin_Utils::get_install_link( $suggested_plugin );

return sprintf(
			$message,
			'<strong>',
			$install_link,
			'</strong>',
			$this->create_more_information_link( $suggested_plugin['url'], $suggested_plugin['title'] ),
			'</a>',
		);
	}

/**
	 * Creates a more information link that directs the user to WordPress.org Plugin repository.
	 *
	 * @param string $url  The URL to the plugin's page.
	 * @param string $name The name of the plugin.
	 *
	 * @return string The more information link.
	 */
	protected function create_more_information_link( $url, $name ) {
		return sprintf(
			'<a href="%s" aria-label="%s" target="_blank" rel="noopener noreferrer">',
			$url,
			/* translators: Hidden accessibility text; %1$s expands to the dependency name */
			sprintf( __( 'More information about %1$s', 'wordpress-seo' ), $name ),
		);
	}
}