Current File : /home/digitaw/www/wp-content/plugins/simple-history/inc/services/class-dashboard-widget.php

<?php

namespace Simple_History\Services;

use Simple_History\Helpers;

/**
 * Setup dashboard widget.
 */
class Dashboard_Widget extends Service {
	/**
	 * @inheritdoc
	 */
	public function loaded() {
		add_action( 'wp_dashboard_setup', array( $this, 'add_dashboard_widget' ) );
	}

	/**
	 * Add a dashboard widget.
	 * Requires current user to have view history capability
	 * and a setting to show dashboard to be set.
	 */
	public function add_dashboard_widget() {
		// phpcs:ignore WordPress.WP.Capabilities.Undetermined -- Capability is filterable, defaults to 'read'.
		if ( Helpers::setting_show_on_dashboard() && current_user_can( Helpers::get_view_history_capability() ) ) {
			/**
			 * Filter to determine if history page should be added to page below dashboard or not
			 *
			 * @since 2.0.23
			 *
			 * @param bool $show_dashboard_widget Show the page or not
			 */
			$show_dashboard_widget = apply_filters( 'simple_history/show_dashboard_widget', true );

			// Show link to settings page in dashboard widget if user can view settings page.
			$show_dashboard_settings_link_html = '';
			// phpcs:ignore WordPress.WP.Capabilities.Undetermined -- Capability is filterable, defaults to 'manage_options'.
			$show_dashboard_settings_link = current_user_can( Helpers::get_view_settings_capability() );
			if ( $show_dashboard_settings_link ) {
				$show_dashboard_settings_link_html = sprintf(
					'<a href="%1$s" title="%2$s" class="sh-Icon sh-Dashboard-settingsLink"></a>',
					esc_url( Helpers::get_settings_page_url() ),
					esc_html__( 'Settings & Tools', 'simple-history' )
				);
			}

			if ( $show_dashboard_widget ) {
				wp_add_dashboard_widget(
					'simple_history_dashboard_widget',
					__( 'Simple History', 'simple-history' ) . $show_dashboard_settings_link_html,
					array(
						$this,
						'dashboard_widget_output',
					)
				);
			}
		}
	}

	/**
	 * Output html for the dashboard widget
	 */
	public function dashboard_widget_output() {
		do_action( 'simple_history/dashboard/before_gui', $this );
	}
}