# metricool/trunk/app/Features/TaskManagement/TaskManagementController.php

Metricool – Social media and site statistics, version trunk. 99 lines.

- Page: https://pluginprobe.com/plugins/metricool/trunk/code/app/Features/TaskManagement/TaskManagementController.php
- Raw: https://pluginprobe.com/plugins/metricool/trunk/raw/app/Features/TaskManagement/TaskManagementController.php
- Modified: 2026-08-20T14:08:30+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/metricool/trunk/code/app/Features/TaskManagement/TaskManagementController.php#L10-L20`.

```php
<?php

declare(strict_types=1);

namespace Metricool\Features\TaskManagement;

if (!defined('ABSPATH')) {
    exit;
}

use Metricool\Interfaces\FeatureInterface;
use Metricool\Interfaces\TaskInterface;
use Metricool\Services\DashboardService;
use Metricool\Traits\HasAllowlistControl;

class TaskManagementController implements FeatureInterface
{
    use HasAllowlistControl;

    private TaskManagementEndpoints $endpoints;
    private TaskManagementService $service;
    private TaskManagementListener $listener;
    private DashboardService $dashboard;

    public function __construct(TaskManagementService $service, TaskManagementEndpoints $endpoints, TaskManagementListener $listener, DashboardService $dashboard)
    {
        $this->service = $service;
        $this->endpoints = $endpoints;
        $this->listener = $listener;
        $this->dashboard = $dashboard;
    }

    public function register(): void
    {
        $this->endpoints->register();

        if ($this->userCanManage() && $this->dashboard->isOnboardingCompleted()) {
            $this->listener->listen();
            $this->initiateTasks();
        }

        add_action('metricool_plugin_version_upgrade', [$this, 'upgradeTasks']);
    }

    /**
     * This method returns an array of Task class-strings that should be added
     * to the database.
     *
     * @internal New tasks should be added here. Upgrade the task version if the
     * task should be updated. If a task should be removed, remove the task from
     * this list.
     *
     * @return array<int,class-string<TaskInterface>> Array of Task class-strings
     */
    private function getTaskObjects(): array
    {
        return [
            Tasks\TwitterTask::class,
            Tasks\LinkedInTask::class,
            Tasks\HistoricalDataTask::class,
            Tasks\FirstConnectionTask::class,
            Tasks\SchedulePostTask::class,
        ];
    }

    /**
     * This method adds the initial tasks to the database if they are not
     * already present.
     * @throws \Exception If task class cannot be instantiated
     */
    private function initiateTasks(): void
    {
        if ($this->service->hasTasks()) {
            return;
        }

        $this->service->addTasks(
            $this->getTaskObjects()
        );
    }

    /**
     * This method makes sure that if new tasks are added in the update that
     * these tasks are added in the database. Existing tasks will be updated
     * if the version is higher than the current existing task with the same id.
     * @throws \Exception If task class cannot be instantiated
     */
    public function upgradeTasks(): void
    {
        if ($this->service->hasTasks() === false) {
            return; // Tasks will be added by initiateTasks()
        }

        $this->service->upgradeTasks(
            $this->getTaskObjects()
        );
    }
}

```