MokoSuiteStoreLocator/src/script.php

<?php
/**
 * @package     MokoJoomStoreLocator
 * @subpackage  pkg_mokojoomstorelocator
 * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
 * @license     GNU General Public License version 3 or later; see LICENSE
 */

defined('_JEXEC') or die;

use Joomla\CMS\Factory;
use Joomla\CMS\Installer\InstallerAdapter;
use Joomla\CMS\Log\Log;

class Pkg_MokojoomstorelocatorInstallerScript
{
	protected $minimumPhp = '8.1';
	protected $minimumJoomla = '4.4.0';

	/** @var array Download keys saved before Joomla wipes update sites */
	private array $savedDownloadKeys = [];

	public function preflight($type, $parent)
	{
		if (version_compare(PHP_VERSION, $this->minimumPhp, '<'))
		{
			Log::add('MokoJoomStoreLocator requires PHP ' . $this->minimumPhp . ' or later.', Log::WARNING, 'jerror');

			return false;
		}

		if (version_compare(JVERSION, $this->minimumJoomla, '<'))
		{
			Log::add('MokoJoomStoreLocator requires Joomla ' . $this->minimumJoomla . ' or later.', Log::WARNING, 'jerror');

			return false;
		}

		$this->savedDownloadKeys = $this->backupDownloadKeys();

		return true;
	}

	public function postflight($type, $parent)
	{
		$this->restoreDownloadKeys($this->savedDownloadKeys);
		$this->warnMissingLicenseKey();

		return true;
	}

	public function uninstall($parent)
	{
	}

	private function backupDownloadKeys(): array
	{
		$keys = [];

		try
		{
			$db = Factory::getDbo();
			$db->setQuery(
				$db->getQuery(true)
					->select(['us.' . $db->quoteName('update_site_id'), 'us.' . $db->quoteName('extra_query'), 'us.' . $db->quoteName('location'), 'e.' . $db->quoteName('element')])
					->from($db->quoteName('#__update_sites', 'us'))
					->join('INNER', $db->quoteName('#__update_sites_extensions', 'use') . ' ON us.update_site_id = use.update_site_id')
					->join('INNER', $db->quoteName('#__extensions', 'e') . ' ON e.extension_id = use.extension_id')
					->where($db->quoteName('us.extra_query') . ' != ' . $db->quote(''))
			);

			foreach ($db->loadObjectList() ?: [] as $row)
			{
				$keys['elem_' . $row->element] = $row->extra_query;
				$keys[$row->location] = $row->extra_query;
				$keys['id_' . $row->update_site_id] = $row->extra_query;
			}
		}
		catch (\Throwable $e) {}

		return $keys;
	}

	private function restoreDownloadKeys(array $savedKeys): void
	{
		if (empty($savedKeys)) { return; }

		try
		{
			$db = Factory::getDbo();
			$db->setQuery(
				$db->getQuery(true)
					->select(['us.' . $db->quoteName('update_site_id'), 'us.' . $db->quoteName('extra_query'), 'us.' . $db->quoteName('location'), 'e.' . $db->quoteName('element')])
					->from($db->quoteName('#__update_sites', 'us'))
					->join('LEFT', $db->quoteName('#__update_sites_extensions', 'use') . ' ON us.update_site_id = use.update_site_id')
					->join('LEFT', $db->quoteName('#__extensions', 'e') . ' ON e.extension_id = use.extension_id')
					->where('(' . $db->quoteName('us.extra_query') . ' = ' . $db->quote('') . ' OR ' . $db->quoteName('us.extra_query') . ' NOT LIKE ' . $db->quote('%dlid=%') . ')')
			);

			$restored = 0;

			foreach ($db->loadObjectList() ?: [] as $site)
			{
				$element = (string) ($site->element ?? '');
				$key = ($element !== '') ? ($savedKeys['elem_' . $element] ?? '') : '';
				if (empty($key)) { $key = $savedKeys[$site->location] ?? $savedKeys['id_' . $site->update_site_id] ?? ''; }

				if (!empty($key))
				{
					$db->setQuery($db->getQuery(true)->update($db->quoteName('#__update_sites'))->set($db->quoteName('extra_query') . ' = ' . $db->quote($key))->where($db->quoteName('update_site_id') . ' = ' . (int) $site->update_site_id))->execute();
					$restored++;
				}
			}

			if ($restored > 0) { Factory::getApplication()->enqueueMessage(sprintf('Restored %d download key(s).', $restored), 'message'); }
		}
		catch (\Throwable $e) {}
	}

	private function warnMissingLicenseKey(): void
	{
		try
		{
			$db = Factory::getDbo();
			$db->setQuery(
				$db->getQuery(true)
					->select([$db->quoteName('update_site_id'), $db->quoteName('extra_query')])
					->from($db->quoteName('#__update_sites'))
					->where('(' . $db->quoteName('name') . ' LIKE ' . $db->quote('%MokoJoomStoreLocator%') . ' OR ' . $db->quoteName('location') . ' LIKE ' . $db->quote('%MokoJoomStoreLocator%') . ')')
					->setLimit(1)
			);
			$site = $db->loadObject();

			if ($site)
			{
				$eq = (string) ($site->extra_query ?? '');
				if (!empty($eq) && strpos($eq, 'dlid=') !== false) { parse_str($eq, $p); if (!empty($p['dlid'])) { return; } }
				$editUrl = 'index.php?option=com_installer&task=updatesite.edit&update_site_id=' . (int) $site->update_site_id;
			}
			else
			{
				$editUrl = 'index.php?option=com_installer&view=updatesites';
			}

			Factory::getApplication()->enqueueMessage(
				'<strong>Moko Consulting License Key Required</strong> — '
				. 'No download key is configured. Updates will not be available until a valid license key is entered. '
				. '<a href="' . $editUrl . '" class="btn btn-sm btn-warning ms-2">Enter License Key</a>',
				'warning'
			);
		}
		catch (\Throwable $e) {}
	}
}