Tiny File Manager

Back Back Up Advanced Editor

<?php
/** 
 * @package     VikBooking
 * @subpackage  core
 * @author      E4J s.r.l.
 * @copyright   Copyright (C) 2025 E4J s.r.l. All Rights Reserved.
 * @license     http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL
 * @link        https://vikwp.com
 */

// No direct access
defined('ABSPATH') or die('No script kiddies please!');

/**
 * Task manager task registry.
 * 
 * @since   1.18.0 (J) - 1.8.0 (WP)
 */
final class VBOTaskTaskregistry
{
    /**
     * @var  array
     */
    protected $record = [];

/**
     * @var  ?VBOTaskArea
     */
    protected $area;

/**
     * @var  array
     */
    protected $assigneeIds = [];

/**
     * @var  array
     */
    protected static $areaRecords = [];

/**
     * @var  array
     */
    protected static $areaNamesMap = [];

/**
     * @var  array
     */
    protected static $listingNamesMap = [];

/**
     * Proxy to construct the object from a task record ID.
     * 
     * @param   int   $recordId     The task record ID.
     * 
     * @return  VBOTaskTaskregistry
     */
    public static function getRecordInstance(int $recordId)
    {
        $task = $recordId ? VBOTaskModelTask::getInstance()->getItem($recordId) : null;

return new static((array) $task);
    }

/**
     * Proxy to construct the object.
     * 
     * @param   array   $record     The task record or an empty array.
     * 
     * @return  VBOTaskTaskregistry
     */
    public static function getInstance(array $record)
    {
        return new static($record);
    }

/**
     * Class constructor.
     * 
     * @param   array   $record     The task record or an empty array.
     * 
     * @throws  Exception
     */
    public function __construct(array $record)
    {
        if (!empty($record['tags']) && is_string($record['tags'])) {
            // decode task tags
            $record['tags'] = array_filter(array_map('intval', (array) json_decode($record['tags'], true)));
        }

// set internal record property
        $this->record = $record;
    }

/**
     * Returns the current task record.
     * 
     * @return  array
     */
    public function getRecord()
    {
        return $this->record;
    }

/**
     * Returns the current task area ID, if any.
     * 
     * @return  int
     */
    public function getAreaID()
    {
        return (int) ($this->area ? $this->area->getID() : $this->get('id_area', 0));
    }

/**
     * Returns the task area name from the given ID.
     * 
     * @param   int     $areaId     The area/project ID.
     * 
     * @return  string
     */
    public function getAreaName(int $areaId)
    {
        if (!empty(static::$areaNamesMap[$areaId])) {
            // return the cached value
            return static::$areaNamesMap[$areaId];
        }

if ($this->area && $this->area->getID() == $areaId) {
            // return the current area name
            return $this->area->getName();
        }

// fetch the requested area/project
        $areaRecord = $this->fetchAreaRecord($areaId);

if (!$areaRecord) {
            // requested area not found
            return '';
        }

// cache value and return it
        static::$areaNamesMap[$areaId] = $areaRecord->name ?? '';

return static::$areaNamesMap[$areaId];
    }

/**
     * Returns the current task area object.
     * 
     * @return  ?VBOTaskArea
     */
    public function getArea()
    {
        return $this->area ?? null;
    }

/**
     * Returns the current task area object.
     * 
     * @param  VBOTaskArea  $area   The task area object.
     * 
     * @return  void
     */
    public function setArea(VBOTaskArea $area)
    {
        $this->area = $area;
    }

/**
     * Attempts to fetch the requested record property.
     * 
     * @param   string  $prop       The record property to get.
     * @param   mixed   $default    The default value to return.
     * 
     * @return  mixed
     */
    public function get(string $prop, $default = null)
    {
        return $this->record[$prop] ?? $default;
    }

/**
     * Returns the record ID if available, or 0.
     * 
     * @return  int
     */
    public function getID()
    {
        return (int) $this->get('id', 0);
    }

/**
     * Returns the task title.
     * 
     * @return  string
     */
    public function getTitle()
    {
        return (string) $this->get('title', '');
    }

/**
     * Returns the task notes.
     * 
     * @return  string
     */
    public function getNotes()
    {
        return (string) $this->get('notes', '');
    }

/**
     * Returns the list of tag IDs for the current task.
     * 
     * @return  array
     */
    public function getTags()
    {
        return (array) $this->get('tags', []);
    }

/**
     * Returns the list of tag records for the current task.
     * 
     * @return  array
     */
    public function getTagRecords()
    {
        return VBOFactory::getTaskManager()->getColorTags($this->getTags());
    }

/**
     * Returns the status enumeration for the current task.
     * 
     * @return  string
     */
    public function getStatus()
    {
        return (string) $this->get('status_enum', '');
    }

/**
     * Returns the status readable name for the current task.
     * 
     * @return  string
     */
    public function getStatusName()
    {
        $enum = $this->getStatus();

if (VBOFactory::getTaskManager()->statusTypeExists($enum)) {
            return VBOFactory::getTaskManager()->getStatusTypeInstance($enum)->getName();
        }

return $enum;
    }

/**
     * Returns the scheduling enumeration for the current task.
     * 
     * @return  string
     */
    public function getScheduling()
    {
        return (string) $this->get('scheduler', '');
    }

/**
     * Returns the booking ID assigned to the current task.
     * 
     * @return  string
     */
    public function getBookingId()
    {
        return (int) $this->get('id_order', 0);
    }

/**
     * Builds the current task booking information for rendering the record as element.
     * 
     * @param   int     $activeBid  Optional active booking ID.
     * 
     * @return  array
     */
    public function buildBookingElement(int $activeBid = 0)
    {
        $bid = $this->getBookingId() ?: $activeBid;
        if (!$bid) {
            return [];
        }

return VBOFactory::getTaskManager()->buildBookingElement((int) $bid);
    }

/**
     * Returns the listing ID assigned to the current task.
     * 
     * @return  string
     */
    public function getListingId()
    {
        return (int) $this->get('id_room', 0);
    }

/**
     * Proxy for getting the current task listing ID.
     * 
     * @return  int
     */
    public function getRoomId()
    {
        return $this->getListingId();
    }

/**
     * Returns the listing name from the given ID.
     * 
     * @param   int     $listingId     The listing ID.
     * 
     * @return  string
     */
    public function getListingName(int $listingId)
    {
        if (!empty(static::$listingNamesMap[$listingId])) {
            // return the cached value
            return static::$listingNamesMap[$listingId];
        }

// fetch the requested listing
        $listing = VikBooking::getRoomInfo($listingId, ['name'], true);

if (!$listing) {
            // requested listing not found
            return '';
        }

// cache value and return it
        static::$listingNamesMap[$listingId] = $listing['name'] ?? '';

return static::$listingNamesMap[$listingId];
    }

/**
     * Returns the current task due date, either in UTC or local timezone.
     * 
     * @param   bool    $local   True to get the date in local timezone for display.
     * @param   string  $format  The date format to return.
     * 
     * @return  string
     */
    public function getDueDate(bool $local = false, string $format = '')
    {
        $dt = (string) $this->get('dueon', '');

if (!$dt || (!$local && !$format)) {
            // return the raw date value, empty string or UTC date from database
            return $dt;
        }