MokoSuiteBackup/source/script.php

<?php

/**
 * @package     MokoJoomBackup
 * @author      Moko Consulting <hello@mokoconsulting.tech>
 * @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\Language\Text;
use Joomla\CMS\Router\Route;

class Pkg_MokoJoomBackupInstallerScript
{
	/**
	 * Minimum Joomla version required
	 *
	 * @var string
	 */
	protected $minimumJoomla = '4.0.0';

	/**
	 * Minimum PHP version required
	 *
	 * @var string
	 */
	protected $minimumPhp = '8.1.0';

	/**
	 * Called before any install/update/uninstall action.
	 *
	 * @param   string            $type    Action type (install, update, uninstall)
	 * @param   InstallerAdapter  $parent  Installer adapter
	 *
	 * @return  bool
	 */
	public function preflight(string $type, InstallerAdapter $parent): bool
	{
		if (version_compare(PHP_VERSION, $this->minimumPhp, '<')) {
			Factory::getApplication()->enqueueMessage(
				Text::sprintf('PKG_MOKOJOOMBACKUP_PHP_VERSION_ERROR', $this->minimumPhp),
				'error'
			);

			return false;
		}

		// Save download key before Joomla re-registers the update site
		if ($type === 'update') {
			$this->preflight_saveKey();
		}

		return true;
	}

	/**
	 * Called after install/update.
	 *
	 * @param   string            $type    Action type
	 * @param   InstallerAdapter  $parent  Installer adapter
	 *
	 * @return  void
	 */
	/**
	 * Called before install/update to preserve the download key.
	 *
	 * Joomla re-registers update sites from the manifest on every update,
	 * which can reset the extra_query (download key). We save it here
	 * and restore it in postflight.
	 */
	private ?string $savedDownloadKey = null;

	public function preflight_saveKey(): void
	{
		try {
			$db    = Factory::getDbo();
			$query = $db->getQuery(true)
				->select($db->quoteName('us.extra_query'))
				->from($db->quoteName('#__update_sites', 'us'))
				->join(
					'INNER',
					$db->quoteName('#__update_sites_extensions', 'use')
					. ' ON ' . $db->quoteName('use.update_site_id') . ' = ' . $db->quoteName('us.update_site_id')
				)
				->join(
					'INNER',
					$db->quoteName('#__extensions', 'e')
					. ' ON ' . $db->quoteName('e.extension_id') . ' = ' . $db->quoteName('use.extension_id')
				)
				->where($db->quoteName('e.element') . ' = ' . $db->quote('pkg_mokojoombackup'))
				->where($db->quoteName('e.type') . ' = ' . $db->quote('package'))
				->setLimit(1);
			$db->setQuery($query);
			$key = $db->loadResult();

			if (!empty($key)) {
				$this->savedDownloadKey = $key;
			}
		} catch (\Throwable $e) {
			error_log('MokoJoomBackup: Could not save download key: ' . $e->getMessage());
		}
	}

	public function postflight(string $type, InstallerAdapter $parent): void
	{
		// Restore download key if it was saved before update
		if ($this->savedDownloadKey !== null) {
			$this->restoreDownloadKey();
		}

		if ($type === 'install') {
			// Enable the system plugin automatically on fresh install
			$db    = Factory::getDbo();
			$query = $db->getQuery(true)
				->update($db->quoteName('#__extensions'))
				->set($db->quoteName('enabled') . ' = 1')
				->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
				->where($db->quoteName('folder') . ' = ' . $db->quote('system'))
				->where($db->quoteName('element') . ' = ' . $db->quote('mokojoombackup'));

			$db->setQuery($query);
			$db->execute();

			// Enable the quickicon plugin automatically
			$query = $db->getQuery(true)
				->update($db->quoteName('#__extensions'))
				->set($db->quoteName('enabled') . ' = 1')
				->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
				->where($db->quoteName('folder') . ' = ' . $db->quote('quickicon'))
				->where($db->quoteName('element') . ' = ' . $db->quote('mokojoombackup'));

			$db->setQuery($query);
			$db->execute();

			// Enable the task plugin automatically
			$query = $db->getQuery(true)
				->update($db->quoteName('#__extensions'))
				->set($db->quoteName('enabled') . ' = 1')
				->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
				->where($db->quoteName('folder') . ' = ' . $db->quote('task'))
				->where($db->quoteName('element') . ' = ' . $db->quote('mokojoombackup'));

			$db->setQuery($query);
			$db->execute();

			// Enable the webservices plugin automatically
			$query = $db->getQuery(true)
				->update($db->quoteName('#__extensions'))
				->set($db->quoteName('enabled') . ' = 1')
				->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
				->where($db->quoteName('folder') . ' = ' . $db->quote('webservices'))
				->where($db->quoteName('element') . ' = ' . $db->quote('mokojoombackup'));

			$db->setQuery($query);
			$db->execute();

			// Enable the console plugin automatically
			$query = $db->getQuery(true)
				->update($db->quoteName('#__extensions'))
				->set($db->quoteName('enabled') . ' = 1')
				->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
				->where($db->quoteName('folder') . ' = ' . $db->quote('console'))
				->where($db->quoteName('element') . ' = ' . $db->quote('mokojoombackup'));

			$db->setQuery($query);
			$db->execute();

			// Enable the content plugin automatically
			$query = $db->getQuery(true)
				->update($db->quoteName('#__extensions'))
				->set($db->quoteName('enabled') . ' = 1')
				->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
				->where($db->quoteName('folder') . ' = ' . $db->quote('content'))
				->where($db->quoteName('element') . ' = ' . $db->quote('mokojoombackup'));

			$db->setQuery($query);
			$db->execute();

			// Enable the actionlog plugin automatically
			$query = $db->getQuery(true)
				->update($db->quoteName('#__extensions'))
				->set($db->quoteName('enabled') . ' = 1')
				->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
				->where($db->quoteName('folder') . ' = ' . $db->quote('actionlog'))
				->where($db->quoteName('element') . ' = ' . $db->quote('mokojoombackup'));

			$db->setQuery($query);
			$db->execute();

			// Create and protect default backup directory
			$backupDir = JPATH_ADMINISTRATOR . '/components/com_mokojoombackup/backups';

			if (!is_dir($backupDir)) {
				mkdir($backupDir, 0755, true);
			}

			if (is_dir($backupDir)) {
				$htaccess = $backupDir . '/.htaccess';

				if (!is_file($htaccess)) {
					file_put_contents($htaccess, "# Apache 2.4+\n<IfModule mod_authz_core.c>\n  Require all denied\n</IfModule>\n# Apache 2.2\n<IfModule !mod_authz_core.c>\n  Order deny,allow\n  Deny from all\n</IfModule>\n");
				}

				$index = $backupDir . '/index.html';

				if (!is_file($index)) {
					file_put_contents($index, '<!DOCTYPE html><title></title>');
				}
			}

			// Create default scheduled task — every 30 days, profile 1
			$this->createDefaultScheduledTask();
		}

		if ($type === 'uninstall') {
			return;
		}

		// Sync submenu icons in #__menu (Joomla doesn't update icons on upgrades)
		$this->syncMenuIcons();

		// Warn if no license key configured
		$this->warnMissingLicenseKey();

		// Warn if any profile still uses the default backup directory
		$this->warnDefaultBackupDir();

		// Remind user to review backup profile settings
		if ($type === 'install') {
			$profileUrl = Route::_('index.php?option=com_mokojoombackup&view=profiles');

			Factory::getApplication()->enqueueMessage(
				'<strong>Review Your Backup Settings</strong> — '
				. 'A default backup profile has been created. Review the profile settings to configure '
				. 'backup type, schedule, storage location, and notifications. '
				. '<a href="' . $profileUrl . '" class="btn btn-sm btn-primary ms-2">Review Profiles</a>',
				'info'
			);
		}
	}

	private function warnDefaultBackupDir(): void
	{
		try {
			$db    = Factory::getDbo();
			$query = $db->getQuery(true)
				->select('COUNT(*)')
				->from($db->quoteName('#__mokojoombackup_profiles'))
				->where($db->quoteName('published') . ' = 1')
				->where('(' . $db->quoteName('backup_dir') . ' = ' . $db->quote('administrator/components/com_mokojoombackup/backups')
					. ' OR ' . $db->quoteName('backup_dir') . ' = ' . $db->quote('[DEFAULT_DIR]')
					. ' OR ' . $db->quoteName('backup_dir') . ' = ' . $db->quote('')
					. ' OR ' . $db->quoteName('backup_dir') . ' IS NULL)');
			$db->setQuery($query);

			if ((int) $db->loadResult() > 0) {
				$profileUrl = Route::_('index.php?option=com_mokojoombackup&view=profiles');

				Factory::getApplication()->enqueueMessage(
					'<strong>Backup Directory Warning</strong> — '
					. 'One or more profiles store backups in the default directory inside the web root. '
					. 'For better security, configure a backup directory outside the web root. '
					. '<a href="' . $profileUrl . '" class="btn btn-sm btn-warning ms-2">Edit Profiles</a>',
					'warning'
				);
			}
		} catch (\Throwable $e) {
			error_log('MokoJoomBackup: warnDefaultBackupDir() failed: ' . $e->getMessage());
		}
	}

	private function createDefaultScheduledTask(): void
	{
		try {
			$db = Factory::getDbo();

			// Check if a MokoJoomBackup task already exists
			$query = $db->getQuery(true)
				->select('COUNT(*)')
				->from($db->quoteName('#__scheduler_tasks'))
				->where($db->quoteName('type') . ' = ' . $db->quote('mokojoombackup.run_profile'));
			$db->setQuery($query);

			if ((int) $db->loadResult() > 0) {
				return;
			}

			$now = date('Y-m-d H:i:s');

			$task = (object) [
				'title'           => 'MokoJoomBackup — Monthly Full Backup',
				'type'            => 'mokojoombackup.run_profile',
				'execution_rules' => json_encode([
					'rule-type'      => 'interval-days',
					'interval-days'  => '30',
					'exec-day'       => '1',
					'exec-time'      => '03:00:00',
				]),
				'cron_rules'      => json_encode([
					'type' => 'interval',
					'exp'  => 'P30D',
				]),
				'state'           => 1,
				'params'          => json_encode([
					'profile_id'     => 1,
					'individual_log' => true,
					'log_file'       => '',
					'notifications'  => [
						'success_mail'             => '0',
						'failure_mail'             => '1',
						'notification_failure_groups' => ['8'],
						'fatal_failure_mail'       => '1',
						'notification_fatal_groups'  => ['8'],
						'orphan_mail'              => '0',
					],
				]),
				'priority'        => 0,
				'ordering'        => 0,
				'cli_exclusive'   => 0,
				'note'            => '',
				'created'         => $now,
				'created_by'      => Factory::getApplication()->getIdentity()->id ?? 0,
				'next_execution'  => date('Y-m-d 03:00:00', strtotime('+1 day')),
			];

			$db->insertObject('#__scheduler_tasks', $task);
		} catch (\Throwable $e) {
			error_log('MokoJoomBackup: createDefaultScheduledTask() failed: ' . $e->getMessage());
		}
	}

	private function syncMenuIcons(): void
	{
		$iconMap = [
			'view=dashboard' => 'class:home',
			'view=backups'   => 'class:database',
			'view=profiles'  => 'class:cog',
		];

		try {
			$db = Factory::getDbo();

			foreach ($iconMap as $linkFragment => $icon) {
				$query = $db->getQuery(true)
					->update($db->quoteName('#__menu'))
					->set($db->quoteName('img') . ' = ' . $db->quote($icon))
					->where($db->quoteName('client_id') . ' = 1')
					->where($db->quoteName('link') . ' LIKE ' . $db->quote('%com_mokojoombackup%' . $linkFragment . '%'));
				$db->setQuery($query);
				$db->execute();
			}

			// Set top-level component menu icon
			$query = $db->getQuery(true)
				->update($db->quoteName('#__menu'))
				->set($db->quoteName('img') . ' = ' . $db->quote('class:archive'))
				->where($db->quoteName('client_id') . ' = 1')
				->where($db->quoteName('link') . ' LIKE ' . $db->quote('index.php?option=com_mokojoombackup'))
				->where($db->quoteName('level') . ' = 1');
			$db->setQuery($query);
			$db->execute();
		} catch (\Throwable $e) {
			error_log('MokoJoomBackup: syncMenuIcons() failed: ' . $e->getMessage());
		}
	}

	/**
	 * Restore the download key to the (possibly new) update site record.
	 */
	private function restoreDownloadKey(): void
	{
		try {
			$db    = Factory::getDbo();
			$query = $db->getQuery(true)
				->select($db->quoteName('us.update_site_id'))
				->from($db->quoteName('#__update_sites', 'us'))
				->join(
					'INNER',
					$db->quoteName('#__update_sites_extensions', 'use')
					. ' ON ' . $db->quoteName('use.update_site_id') . ' = ' . $db->quoteName('us.update_site_id')
				)
				->join(
					'INNER',
					$db->quoteName('#__extensions', 'e')
					. ' ON ' . $db->quoteName('e.extension_id') . ' = ' . $db->quoteName('use.extension_id')
				)
				->where($db->quoteName('e.element') . ' = ' . $db->quote('pkg_mokojoombackup'))
				->where($db->quoteName('e.type') . ' = ' . $db->quote('package'))
				->setLimit(1);
			$db->setQuery($query);
			$updateSiteId = (int) $db->loadResult();

			if ($updateSiteId > 0) {
				$query = $db->getQuery(true)
					->update($db->quoteName('#__update_sites'))
					->set($db->quoteName('extra_query') . ' = ' . $db->quote($this->savedDownloadKey))
					->where($db->quoteName('update_site_id') . ' = ' . $updateSiteId);
				$db->setQuery($query);
				$db->execute();
			}
		} catch (\Throwable $e) {
			error_log('MokoJoomBackup: Could not restore download key: ' . $e->getMessage());
		}
	}

	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('%MokoJoomBackup%') . ' OR ' . $db->quoteName('location') . ' LIKE ' . $db->quote('%MokoJoomBackup%') . ')')
					->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) {
			error_log('MokoJoomBackup: License key check failed: ' . $e->getMessage());
		}
	}
}