WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru
класс не описан

Yoast_Notifications{} Yoast 1.0

Class Yoast_Notifications.

Ищем WP-разработчика! Фулл-тайм, удаленка, хорошая зарплата, соц. пакет. Подробности.
Компания Boosta.

Хуков нет.

Возвращает

null. Ничего.

Использование

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

Методы

  1. __construct()
  2. add_hooks()
  3. ajax_dismiss_alert()
  4. ajax_dismiss_notification()
  5. ajax_restore_alert()
  6. ajax_restore_notification()
  7. collect_notifications()
  8. enqueue_assets()
  9. filter_dismissed_alerts( Yoast_Notification $notification )
  10. filter_dismissed_notifications( Yoast_Notification $notification )
  11. filter_error_alerts( Yoast_Notification $notification )
  12. filter_error_notifications( Yoast_Notification $notification )
  13. filter_warning_alerts( Yoast_Notification $notification )
  14. filter_warning_notifications( Yoast_Notification $notification )
  15. get_active_alert_count()
  16. get_active_notification_count()
  17. get_notification_from_ajax_request()
  18. get_template_variables()
  19. get_view_html( $type )
  20. output_ajax_response( $type )

Код Yoast_Notifications{} Yoast 17.4

class Yoast_Notifications {

	/**
	 * Holds the admin page's ID.
	 *
	 * @var string
	 */
	const ADMIN_PAGE = 'wpseo_dashboard';

	/**
	 * Total notifications count.
	 *
	 * @var int
	 */
	private static $notification_count = 0;

	/**
	 * All error notifications.
	 *
	 * @var array
	 */
	private static $errors = [];

	/**
	 * Active errors.
	 *
	 * @var array
	 */
	private static $active_errors = [];

	/**
	 * Dismissed errors.
	 *
	 * @var array
	 */
	private static $dismissed_errors = [];

	/**
	 * All warning notifications.
	 *
	 * @var array
	 */
	private static $warnings = [];

	/**
	 * Active warnings.
	 *
	 * @var array
	 */
	private static $active_warnings = [];

	/**
	 * Dismissed warnings.
	 *
	 * @var array
	 */
	private static $dismissed_warnings = [];

	/**
	 * Yoast_Notifications constructor.
	 */
	public function __construct() {

		$this->add_hooks();
	}

	/**
	 * Add hooks
	 */
	private function add_hooks() {

		$page = filter_input( INPUT_GET, 'page' );
		if ( $page === self::ADMIN_PAGE ) {
			add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_assets' ] );
		}

		// Needed for adminbar and Notifications page.
		add_action( 'admin_init', [ __CLASS__, 'collect_notifications' ], 99 );

		// Add AJAX hooks.
		add_action( 'wp_ajax_yoast_dismiss_notification', [ $this, 'ajax_dismiss_notification' ] );
		add_action( 'wp_ajax_yoast_restore_notification', [ $this, 'ajax_restore_notification' ] );
	}

	/**
	 * Enqueue assets.
	 */
	public function enqueue_assets() {

		$asset_manager = new WPSEO_Admin_Asset_Manager();
		$asset_manager->enqueue_style( 'notifications' );
	}

	/**
	 * Deprecated: Handle ajax request to dismiss a alert.
	 * Renamed to ajax_dismiss_notification
	 *
	 * @deprecated 14.0
	 *
	 * @codeCoverageIgnore
	 */
	public function ajax_dismiss_alert() {
		_deprecated_function( __METHOD__, 'WPSEO 14.0' );
	}

	/**
	 * Handle ajax request to dismiss a notification.
	 */
	public function ajax_dismiss_notification() {

		$notification = $this->get_notification_from_ajax_request();
		if ( $notification ) {
			$notification_center = Yoast_Notification_Center::get();
			$notification_center->maybe_dismiss_notification( $notification );

			$this->output_ajax_response( $notification->get_type() );
		}

		wp_die();
	}

	/**
	 * Deprecated: Handle ajax request to restore a notification.
	 * Renamed to ajax_restore_notification
	 *
	 * @deprecated 14.0
	 * @codeCoverageIgnore
	 *
	 * @return void
	 */
	public function ajax_restore_alert() {
		_deprecated_function( __METHOD__, 'WPSEO 14.0' );
	}

	/**
	 * Handle ajax request to restore a notification.
	 */
	public function ajax_restore_notification() {

		$notification = $this->get_notification_from_ajax_request();
		if ( $notification ) {
			$notification_center = Yoast_Notification_Center::get();
			$notification_center->restore_notification( $notification );

			$this->output_ajax_response( $notification->get_type() );
		}

		wp_die();
	}

	/**
	 * Create AJAX response data.
	 *
	 * @param string $type Notification type.
	 */
	private function output_ajax_response( $type ) {

		$html = $this->get_view_html( $type );
		// phpcs:disable WordPress.Security.EscapeOutput -- Reason: WPSEO_Utils::format_json_encode is safe.
		echo WPSEO_Utils::format_json_encode(
			[
				'html'  => $html,
				'total' => self::get_active_notification_count(),
			]
		);
		// phpcs:enable -- Reason: WPSEO_Utils::format_json_encode is safe.
	}

	/**
	 * Get the HTML to return in the AJAX request.
	 *
	 * @param string $type Notification type.
	 *
	 * @return bool|string
	 */
	private function get_view_html( $type ) {

		switch ( $type ) {
			case 'error':
				$view = 'errors';
				break;

			case 'warning':
			default:
				$view = 'warnings';
				break;
		}

		// Re-collect notifications.
		self::collect_notifications();

		/**
		 * Stops PHPStorm from nagging about this variable being unused. The variable is used in the view.
		 *
		 * @noinspection PhpUnusedLocalVariableInspection
		 */
		$notifications_data = self::get_template_variables();

		ob_start();
		include WPSEO_PATH . 'admin/views/partial-notifications-' . $view . '.php';
		$html = ob_get_clean();

		return $html;
	}

	/**
	 * Extract the Yoast Notification from the AJAX request.
	 *
	 * @return Yoast_Notification|null
	 */
	private function get_notification_from_ajax_request() {

		$notification_center = Yoast_Notification_Center::get();
		$notification_id     = filter_input( INPUT_POST, 'notification' );

		return $notification_center->get_notification_by_id( $notification_id );
	}

	/**
	 * Collect the notifications and group them together.
	 */
	public static function collect_notifications() {

		$notification_center = Yoast_Notification_Center::get();

		$notifications            = $notification_center->get_sorted_notifications();
		self::$notification_count = count( $notifications );

		self::$errors           = array_filter( $notifications, [ __CLASS__, 'filter_error_notifications' ] );
		self::$dismissed_errors = array_filter( self::$errors, [ __CLASS__, 'filter_dismissed_notifications' ] );
		self::$active_errors    = array_diff( self::$errors, self::$dismissed_errors );

		self::$warnings           = array_filter( $notifications, [ __CLASS__, 'filter_warning_notifications' ] );
		self::$dismissed_warnings = array_filter( self::$warnings, [ __CLASS__, 'filter_dismissed_notifications' ] );
		self::$active_warnings    = array_diff( self::$warnings, self::$dismissed_warnings );
	}

	/**
	 * Get the variables needed in the views.
	 *
	 * @return array
	 */
	public static function get_template_variables() {

		return [
			'metrics'  => [
				'total'    => self::$notification_count,
				'active'   => self::get_active_notification_count(),
				'errors'   => count( self::$errors ),
				'warnings' => count( self::$warnings ),
			],
			'errors'   => [
				'dismissed' => self::$dismissed_errors,
				'active'    => self::$active_errors,
			],
			'warnings' => [
				'dismissed' => self::$dismissed_warnings,
				'active'    => self::$active_warnings,
			],
		];
	}

	/**
	 * Deprecated: Get the number of active notifications.
	 * Renamed to get_active_notification_count
	 *
	 * @deprecated 14.0
	 * @codeCoverageIgnore
	 *
	 * @return int
	 */
	public function get_active_alert_count() {
		_deprecated_function( __METHOD__, 'WPSEO 14.0' );
		return 0;
	}

	/**
	 * Get the number of active notifications.
	 *
	 * @return int
	 */
	public static function get_active_notification_count() {

		return ( count( self::$active_errors ) + count( self::$active_warnings ) );
	}

	/**
	 * Deprecated: Filter out any non-errors. Renamed to filter_error_notifications
	 *
	 * @deprecated 14.0
	 * @codeCoverageIgnore
	 *
	 * @param Yoast_Notification $notification Notification to test.
	 * @return bool
	 */
	public function filter_error_alerts( Yoast_Notification $notification ) {
		_deprecated_function( __METHOD__, 'WPSEO 14.0' );
		return false;
	}

	/**
	 * Filter out any non-errors.
	 *
	 * @param Yoast_Notification $notification Notification to test.
	 *
	 * @return bool
	 */
	private static function filter_error_notifications( Yoast_Notification $notification ) {

		return $notification->get_type() === 'error';
	}

	/**
	 * Deprecated: Filter out any non-warnings. Renamed to filter_warning_notifications
	 *
	 * @deprecated 14.0
	 * @codeCoverageIgnore
	 *
	 * @param Yoast_Notification $notification Notification to test.
	 * @return bool
	 */
	public function filter_warning_alerts( Yoast_Notification $notification ) {
		_deprecated_function( __METHOD__, 'WPSEO 14.0' );
		return false;
	}

	/**
	 * Filter out any non-warnings.
	 *
	 * @param Yoast_Notification $notification Notification to test.
	 *
	 * @return bool
	 */
	private static function filter_warning_notifications( Yoast_Notification $notification ) {

		return $notification->get_type() !== 'error';
	}

	/**
	 * Deprecated: Filter out any dismissed notifications. Renamed to filter_dismissed_alerts.
	 *
	 * @deprecated 14.0
	 * @codeCoverageIgnore
	 *
	 * @param Yoast_Notification $notification Notification to test.
	 * @return bool
	 */
	public function filter_dismissed_alerts( Yoast_Notification $notification ) {
		_deprecated_function( __METHOD__, 'WPSEO 14.0' );
		return false;
	}

	/**
	 * Filter out any dismissed notifications.
	 *
	 * @param Yoast_Notification $notification Notification to test.
	 *
	 * @return bool
	 */
	private static function filter_dismissed_notifications( Yoast_Notification $notification ) {

		return Yoast_Notification_Center::is_notification_dismissed( $notification );
	}
}