# wp-parsely/3.14.1/src/content-helper/dashboard-widget/class-dashboard-widget.php

Parse.ly, version 3.14.1. 149 lines.

- Page: https://pluginprobe.com/plugins/wp-parsely/3.14.1/code/src/content-helper/dashboard-widget/class-dashboard-widget.php
- Raw: https://pluginprobe.com/plugins/wp-parsely/3.14.1/raw/src/content-helper/dashboard-widget/class-dashboard-widget.php
- Modified: 2024-03-12T09:31:56+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/wp-parsely/3.14.1/code/src/content-helper/dashboard-widget/class-dashboard-widget.php#L10-L20`.

```php
<?php
/**
 * PCH Dashboard Widget class
 *
 * @package Parsely
 * @since   3.7.0
 */

declare(strict_types=1);

namespace Parsely\Content_Helper;

use Parsely\Endpoints\User_Meta\Dashboard_Widget_Settings_Endpoint;
use Parsely\Parsely;
use Parsely\RemoteAPI\Analytics_Posts_API;

use function Parsely\Utils\get_asset_info;

use const Parsely\PARSELY_FILE;

/**
 * Class that generates and manages the PCH Dashboard Widget.
 *
 * @since 3.7.0
 */
class Dashboard_Widget extends Content_Helper_Feature {
	/**
	 * Constructor.
	 *
	 * @since 3.9.0
	 *
	 * @param Parsely $parsely Instance of Parsely class.
	 */
	public function __construct( Parsely $parsely ) {
		$this->parsely = $parsely;
	}

	/**
	 * Returns the feature's filter name.
	 *
	 * @since 3.9.0
	 *
	 * @return string The filter name.
	 */
	public static function get_feature_filter_name(): string {
		return self::get_global_filter_name() . '_dashboard_widget';
	}

	/**
	 * Returns the feature's script ID.
	 *
	 * @since 3.9.0
	 *
	 * @return string The script ID.
	 */
	public static function get_script_id(): string {
		return 'wp-parsely-dashboard-widget';
	}

	/**
	 * Returns the feature's style ID.
	 *
	 * @since 3.9.0
	 *
	 * @return string The style ID.
	 */
	public static function get_style_id(): string {
		return static::get_script_id();
	}

	/**
	 * Sets all the hooks that are needed in order to add the Dashboard Widget
	 * to the WordPress Dashboard.
	 *
	 * @since 3.7.0
	 */
	public function run(): void {
		// The can_enable_feature() function is not being used here, as
		// get_current_screen() is still null when this function is called.
		add_action( 'wp_dashboard_setup', array( $this, 'add_dashboard_widget' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
	}

	/**
	 * Returns whether the Dashboard Widget can be enabled.
	 *
	 * @since 3.9.0
	 *
	 * @return bool Whether the Dashboard Widget can be enabled.
	 */
	public function can_enable_widget(): bool {
		$screen    = get_current_screen();
		$posts_api = new Analytics_Posts_API( $GLOBALS['parsely'] );

		return $this->can_enable_feature(
			null !== $screen && 'dashboard' === $screen->id,
			$posts_api->is_available_to_current_user()
		);
	}

	/**
	 * Adds the Widget and its contents to the WordPress Dashboard.
	 *
	 * @since 3.7.0
	 */
	public function add_dashboard_widget(): void {
		if ( ! $this->can_enable_widget() ) {
			return;
		}

		wp_add_dashboard_widget(
			static::get_script_id(),
			__( 'Parse.ly Top Posts', 'wp-parsely' ),
			'__return_empty_string' // Content will be populated by JavaScript.
		);
	}

	/**
	 * Enqueues the Dashboard Widget's assets.
	 *
	 * @since 3.7.0
	 */
	public function enqueue_assets(): void {
		if ( ! $this->can_enable_widget() ) {
			return;
		}

		$asset_php        = get_asset_info( 'build/content-helper/dashboard-widget.asset.php' );
		$built_assets_url = plugin_dir_url( PARSELY_FILE ) . 'build/content-helper/';

		wp_enqueue_script(
			static::get_script_id(),
			$built_assets_url . 'dashboard-widget.js',
			$asset_php['dependencies'],
			$asset_php['version'],
			true
		);

		$this->inject_inline_scripts( Dashboard_Widget_Settings_Endpoint::get_route() );

		wp_enqueue_style(
			static::get_style_id(),
			$built_assets_url . 'dashboard-widget.css',
			array(),
			$asset_php['version']
		);
	}
}

```