MokoJoomBackup/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_MokoBackupInstallerScript
{
	/**
	 * 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_MOKOBACKUP_PHP_VERSION_ERROR', $this->minimumPhp),
				'error'
			);

			return false;
		}

		return true;
	}

	/**
	 * Called after install/update.
	 *
	 * @param   string            $type    Action type
	 * @param   InstallerAdapter  $parent  Installer adapter
	 *
	 * @return  void
	 */
	public function postflight(string $type, InstallerAdapter $parent): void
	{
		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('mokobackup'));

			$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('mokobackup'));

			$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('mokobackup'));

			$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('mokobackup'));

			$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('mokobackup'));

			$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('mokobackup'));

			$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('mokobackup'));

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

			// Create default backup directory
			$backupDir = JPATH_ADMINISTRATOR . '/components/com_mokobackup/backups';

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

				// Protect backup directory with .htaccess
				file_put_contents($backupDir . '/.htaccess', "Order deny,allow\nDeny from all\n");
				file_put_contents($backupDir . '/index.html', '<!DOCTYPE html><title></title>');
			}
		}

		// Show update site link after install or update
		$this->showUpdateSiteNotice();
	}

	/**
	 * Show an info message linking directly to the update site record
	 * so the user can configure their download key.
	 *
	 * @return  void
	 */
	private function showUpdateSiteNotice(): 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_mokobackup'))
				->where($db->quoteName('e.type') . ' = ' . $db->quote('package'))
				->setLimit(1);

			$db->setQuery($query);
			$updateSiteId = (int) $db->loadResult();

			if ($updateSiteId > 0) {
				$editUrl = Route::_(
					'index.php?option=com_installer&view=updatesites&filter[search]=mokobackup'
				);

				Factory::getApplication()->enqueueMessage(
					Text::sprintf('PKG_MOKOBACKUP_POSTINSTALL_UPDATE_SITE', $editUrl),
					'info'
				);
			}
		} catch (\Throwable $e) {
			// Non-critical — silently ignore
		}
	}
}