# packeta/2.1/src/Packetery/Module/DashboardWidget.php

Packeta, version 2.1. 211 lines.

- Page: https://pluginprobe.com/plugins/packeta/2.1/code/src/Packetery/Module/DashboardWidget.php
- Raw: https://pluginprobe.com/plugins/packeta/2.1/raw/src/Packetery/Module/DashboardWidget.php
- Modified: 2025-08-28T06:15:50+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/packeta/2.1/code/src/Packetery/Module/DashboardWidget.php#L10-L20`.

```php
<?php

declare( strict_types=1 );

namespace Packetery\Module;

use Packetery\Latte\Engine;
use Packetery\Module\Carrier\CarrierActivityBridge;
use Packetery\Module\Carrier\CarrierOptionsFactory;
use Packetery\Module\Carrier\CountryListingPage;
use Packetery\Module\Dashboard\DashboardHelper;
use Packetery\Module\Options\OptionsProvider;
use Packetery\Module\Views\UrlBuilder;

class DashboardWidget {

	/**
	 * @var Engine
	 */
	private $latteEngine;

	/**
	 * @var Carrier\Repository
	 */
	private $carrierRepository;

	/**
	 * @var OptionsProvider
	 */
	private $optionsProvider;

	/**
	 * @var Carrier\OptionsPage
	 */
	private $carrierOptionsPage;

	/**
	 * @var Options\Page
	 */
	private $optionsPage;

	/**
	 * @var array<string, bool|string>
	 */
	private $surveyConfig;

	/**
	 * @var Carrier\EntityRepository
	 */
	private $carrierEntityRepository;

	/**
	 * @var ModuleHelper
	 */
	private $moduleHelper;

	/**
	 * @var CarrierOptionsFactory
	 */
	private $carrierOptionsFactory;

	/**
	 * @var UrlBuilder
	 */
	private $urlBuilder;

	/**
	 * @var CarrierActivityBridge
	 */
	private $carrierActivityBridge;

	/**
	 * @var DashboardHelper
	 */
	private $dashboardHelper;

	public function __construct(
		Engine $latteEngine,
		Carrier\Repository $carrierRepository,
		OptionsProvider $optionsProvider,
		Carrier\OptionsPage $carrierOptionsPage,
		Options\Page $optionsPage,
		array $surveyConfig,
		Carrier\EntityRepository $carrierEntityRepository,
		ModuleHelper $moduleHelper,
		CarrierOptionsFactory $carrierOptionsFactory,
		UrlBuilder $urlBuilder,
		CarrierActivityBridge $carrierActivityBridge,
		DashboardHelper $dashboardHelper
	) {
		$this->latteEngine             = $latteEngine;
		$this->carrierRepository       = $carrierRepository;
		$this->optionsProvider         = $optionsProvider;
		$this->carrierOptionsPage      = $carrierOptionsPage;
		$this->optionsPage             = $optionsPage;
		$this->surveyConfig            = $surveyConfig;
		$this->carrierEntityRepository = $carrierEntityRepository;
		$this->moduleHelper            = $moduleHelper;
		$this->carrierOptionsFactory   = $carrierOptionsFactory;
		$this->urlBuilder              = $urlBuilder;
		$this->carrierActivityBridge   = $carrierActivityBridge;
		$this->dashboardHelper         = $dashboardHelper;
	}

	/**
	 * Registers widget.
	 *
	 * @return void
	 */
	public function register(): void {
		add_action( 'wp_dashboard_setup', [ $this, 'setup' ] );
	}

	/**
	 * Dashborad setup.
	 *
	 * @return void
	 */
	public function setup(): void {
		wp_add_dashboard_widget( 'packetery_dashboard_widget', __( 'Packeta', 'packeta' ), [ $this, 'render' ], null, null, 'normal', 'high' );
	}

	/**
	 * Renders widget.
	 *
	 * @return void
	 */
	public function render(): void {
		$wcCountries        = WC()->countries->get_countries();
		$activeCountries    = [];
		$isCodSettingNeeded = false;

		foreach ( $this->carrierEntityRepository->getAllCarriersIncludingNonFeed() as $carrier ) {
			$country        = $carrier->getCountry();
			$carrierOptions = $this->carrierOptionsFactory->createByCarrierId( $carrier->getId() );

			if ( $this->carrierActivityBridge->isActive( $carrier, $carrierOptions ) === false ) {
				continue;
			}

			if ( $isCodSettingNeeded === false && $this->optionsProvider->getCodPaymentMethods() === [] && $carrierOptions->hasAnyCodSurchargeSetting() ) {
				$isCodSettingNeeded = true;
			}

			if ( ! isset( $activeCountries[ $country ] ) ) {
				$activeCountries[ $country ] = [
					CountryListingPage::DATA_KEY_COUNTRY_CODE => $country,
					'name' => $wcCountries[ strtoupper( $country ) ],
					'url'  => $this->carrierOptionsPage->createUrl( $country ),
				];
			}
		}

		$this->latteEngine->render(
			PACKETERY_PLUGIN_DIR . '/template/dashboard-widget.latte',
			[
				'activeCountries'    => $activeCountries,
				'isCodSettingNeeded' => $isCodSettingNeeded,
				'isOptionsFormValid' => $this->optionsPage->create_form()->isValid(),
				'hasExternalCarrier' => $this->carrierRepository->hasAnyActiveFeedCarrier(),
				'hasPacketaShipping' => $this->dashboardHelper->isPacketaShippingMethodActive(),
				'survey'             => new SurveyConfig(
					( $this->surveyConfig['active'] && new \DateTimeImmutable( 'now' ) <= $this->surveyConfig['validTo'] ),
					$this->surveyConfig['url'],
					$this->urlBuilder->buildAssetUrl( 'public/images/survey-illustration.png' )
				),
				'translations'       => [
					'packeta'                => __( 'Packeta', 'packeta' ),
					'activeCountriesNotice'  => __( 'You have set up Packeta carriers for the following countries', 'packeta' ),
					'noGlobalSettings'       => sprintf(
						// translators: 1: link start 2: link end.
						esc_html__( 'Global plugin settings have not been made, you can make the settings %1$shere%2$s.', 'packeta' ),
						...$this->moduleHelper->createLinkParts( $this->optionsPage->createLink() )
					),
					'noActiveCountry'        => sprintf(
						// translators: 1: link start 2: link end.
						esc_html__( 'Now you do not send parcels to any country via Packeta. The settings can be made %1$shere%2$s.', 'packeta' ),
						...$this->moduleHelper->createLinkParts( $this->carrierOptionsPage->createUrl() )
					),
					'noCodPaymentConfigured' => sprintf(
						// translators: 1: link start 2: link end.
						esc_html__( 'No COD payment configured. The settings can be made %1$shere%2$s.', 'packeta' ),
						...$this->moduleHelper->createLinkParts( $this->optionsPage->createLink() )
					),
					'noExternalCarrier'      => sprintf(
						// translators: 1: link start 2: link end.
						esc_html__( 'No external carrier was found. Carriers can be downloaded %1$shere%2$s.', 'packeta' ),
						...$this->moduleHelper->createLinkParts( $this->carrierOptionsPage->createUrl() )
					),
					'noPacketaShipping'      => sprintf(
						// translators: 1: link start 2: link end.
						esc_html__( 'No Packeta shipping method was configured. Configure shipping zone with Packeta shipping method %1$shere%2$s.', 'packeta' ),
						...$this->moduleHelper->createLinkParts(
							add_query_arg(
								[
									'page' => 'wc-settings',
									'tab'  => 'shipping',
								],
								get_admin_url( null, 'admin.php' )
							)
						)
					),
					'surveyTitle'            => __( 'Help us with plugin development', 'packeta' ),
					'surveyDescription'      => __( 'An effective way to improve our plugin is to ask you, its users, for your opinion. It won\'t take you even two minutes and it will help us a lot to develop the plugin in the right way. Thank you very much.', 'packeta' ),
					'surveyButtonText'       => __( 'Fill out a questionnaire', 'packeta' ),
				],
			]
		);
	}
}

```