AlkantarClanX12
Current Path : /home/thanudqk/thepball.com/wp-content/plugins/wordpress-seo/admin/ |
Current File : /home/thanudqk/thepball.com/wp-content/plugins/wordpress-seo/admin/class-suggested-plugins.php |
<?php /** * WPSEO plugin file. * * @package WPSEO\Suggested_Plugins */ /** * 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 ) { if ( ! $checker->dependencies_are_satisfied( $plugin ) ) { continue; } $dependency_names = $checker->get_dependency_names( $plugin ); $notification = $this->get_yoast_seo_suggested_plugins_notification( $plugin_name, $plugin, $dependency_names[0] ); if ( ! $checker->is_installed( $plugin ) || ! $checker->is_active( $plugin['slug'] ) ) { $this->notification_center->add_notification( $notification ); continue; } $this->notification_center->remove_notification( $notification ); } } /** * Build Yoast SEO suggested plugins notification. * * @param string $name The plugin name to use for the unique ID. * @param array $plugin The plugin to retrieve the data from. * @param string $dependency_name The name of the dependency. * * @return Yoast_Notification The notification containing the suggested plugin. */ protected function get_yoast_seo_suggested_plugins_notification( $name, $plugin, $dependency_name ) { $message = $this->create_install_suggested_plugin_message( $plugin, $dependency_name ); if ( $this->availability_checker->is_installed( $plugin ) && ! $this->availability_checker->is_active( $plugin['slug'] ) ) { $message = $this->create_activate_suggested_plugin_message( $plugin, $dependency_name ); } return new Yoast_Notification( $message, [ 'id' => 'wpseo-suggested-plugin-' . $name, '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. * @param array $third_party_plugin The third party plugin that we have a suggested plugin for. * * @return string The install suggested plugin message. */ protected function create_install_suggested_plugin_message( $suggested_plugin, $third_party_plugin ) { /* translators: %1$s expands to Yoast SEO, %2$s expands to the dependency name, %3$s expands to the install link, %4$s expands to the more info link. */ $message = __( '%1$s and %2$s can work together a lot better by adding a helper plugin. Please install %3$s to make your life better. %4$s.', 'wordpress-seo' ); $install_link = WPSEO_Admin_Utils::get_install_link( $suggested_plugin ); return sprintf( $message, 'Yoast SEO', $third_party_plugin, $install_link, $this->create_more_information_link( $suggested_plugin['url'], $suggested_plugin['title'] ) ); } /** * 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">%s</a>', $url, /* translators: %1$s expands to the dependency name. */ sprintf( __( 'More information about %1$s', 'wordpress-seo' ), $name ), __( 'More information', 'wordpress-seo' ) ); } /** * Creates a message to suggest the activation of a particular plugin. * * @param array $suggested_plugin The suggested plugin. * @param array $third_party_plugin The third party plugin that we have a suggested plugin for. * * @return string The activate suggested plugin message. */ protected function create_activate_suggested_plugin_message( $suggested_plugin, $third_party_plugin ) { /* translators: %1$s expands to Yoast SEO, %2$s expands to the dependency name, %3$s expands to activation link. */ $message = __( '%1$s and %2$s can work together a lot better by adding a helper plugin. Please activate %3$s to make your life better.', 'wordpress-seo' ); $activation_url = WPSEO_Admin_Utils::get_activation_url( $suggested_plugin['slug'] ); return sprintf( $message, 'Yoast SEO', $third_party_plugin, sprintf( '<a href="%s">%s</a>', $activation_url, $suggested_plugin['title'] ) ); } }