* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved. * @license GNU General Public License version 3 or later; see LICENSE * SPDX-License-Identifier: GPL-3.0-or-later */ defined('_JEXEC') or die; use Joomla\CMS\Factory; use Joomla\CMS\Installer\InstallerAdapter; use Joomla\CMS\Language\Text; class Pkg_MokoSuiteCrossInstallerScript { protected $minimumPhp = '8.1.0'; public function preflight(string $type, InstallerAdapter $parent): bool { if (version_compare(PHP_VERSION, $this->minimumPhp, '<')) { Factory::getApplication()->enqueueMessage( Text::sprintf('PKG_MOKOSUITECROSS_PHP_VERSION_ERROR', $this->minimumPhp), 'error' ); return false; } $this->saveDownloadKey(); return true; } public function postflight(string $type, InstallerAdapter $parent): void { // Housekeeping — runs unconditionally regardless of child-install result. $this->restoreDownloadKey(); $db = Factory::getDbo(); if ($type === 'install') { $corePlugins = [ ['system', 'mokosuitecross'], ['content', 'mokosuitecross'], ['webservices', 'mokosuitecross'], ['task', 'mokosuitecross'], ]; foreach ($corePlugins as [$folder, $element]) { $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($folder)) ->where($db->quoteName('element') . ' = ' . $db->quote($element)); $db->setQuery($query); $db->execute(); } $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('mokosuitecross')); $db->setQuery($query); $db->execute(); $this->detectPerfectPublisherPro($db); } // Be honest about success. Joomla's package installer only LOGS a failed child // sub-install but still runs this postflight, so don't show the license / // next-steps message if a bundled extension is actually missing. Fails open // (see missingChildExtensions) so a query/IO glitch never fakes a failure. $missing = $this->missingChildExtensions($parent); if (!empty($missing)) { Factory::getApplication()->enqueueMessage( '

MokoSuiteCross did not install correctly.

' . '

The following bundled extensions are missing: ' . htmlspecialchars(implode(', ', $missing), ENT_QUOTES) . '

' . '

Please uninstall MokoSuiteCross and reinstall the full package.

', 'error' ); return; } // Warn if no license key is configured (success / next-steps path). $this->warnMissingLicenseKey(); } /** * Verify every child extension declared in the package manifest actually landed * in #__extensions. Returns readable labels of any that are missing. * * Matching per Joomla's #__extensions uniqueness: * - type = the "type" attribute * - element = the "id" attribute, EXCEPT for plugins the manifest often * declares the full `plg__` id, so strip a leading * `plg__` to get the real element; components/modules use id as-is * - plugins ALSO match folder = the "group" attribute * * FAILS OPEN: any error (unreadable manifest, query failure) returns [] so a * transient glitch never turns a good install into a false failure. */ private function missingChildExtensions(InstallerAdapter $parent): array { try { $manifest = $parent->getParent()->getManifest(); if (!$manifest || !isset($manifest->files) || !isset($manifest->files->file)) { return []; } $db = Factory::getDbo(); $missing = []; foreach ($manifest->files->file as $file) { $attrs = $file->attributes(); $id = isset($attrs['id']) ? (string) $attrs['id'] : ''; $exType = isset($attrs['type']) ? (string) $attrs['type'] : ''; if ($id === '' || $exType === '') { continue; } $group = isset($attrs['group']) ? (string) $attrs['group'] : ''; $element = $id; // Plugin element in #__extensions is the id minus any leading plg__. if ($exType === 'plugin' && $group !== '') { $prefix = 'plg_' . $group . '_'; if (strpos($element, $prefix) === 0) { $element = substr($element, \strlen($prefix)); } } $query = $db->getQuery(true) ->select('COUNT(*)') ->from($db->quoteName('#__extensions')) ->where($db->quoteName('element') . ' = ' . $db->quote($element)) ->where($db->quoteName('type') . ' = ' . $db->quote($exType)); if ($exType === 'plugin' && $group !== '') { $query->where($db->quoteName('folder') . ' = ' . $db->quote($group)); } if ((int) $db->setQuery($query)->loadResult() === 0) { $label = trim((string) $file); $missing[] = $label !== '' ? preg_replace('/\.zip$/i', '', $label) : $id; } } return $missing; } catch (\Throwable $e) { // Fail open — never fake a failure on a glitch. return []; } } private function detectPerfectPublisherPro($db): void { $query = $db->getQuery(true) ->select($db->quoteName(['element', 'params'])) ->from($db->quoteName('#__extensions')) ->where($db->quoteName('element') . ' LIKE ' . $db->quote('%perfectpublisher%')) ->where($db->quoteName('type') . ' = ' . $db->quote('component')); $db->setQuery($query); $result = $db->loadObject(); if ($result) { Factory::getApplication()->enqueueMessage( Text::_('PKG_MOKOSUITECROSS_MIGRATION_DETECTED'), 'notice' ); $query = $db->getQuery(true) ->update($db->quoteName('#__extensions')) ->set($db->quoteName('params') . ' = ' . $db->quote(json_encode([ 'migration_available' => 'perfectpublisher', 'migration_source_params' => $result->params, ]))) ->where($db->quoteName('type') . ' = ' . $db->quote('component')) ->where($db->quoteName('element') . ' = ' . $db->quote('com_mokosuitecross')); $db->setQuery($query); $db->execute(); } } private ?string $savedDownloadKey = null; private function saveDownloadKey(): void { try { $db = \Joomla\CMS\Factory::getDbo(); $db->setQuery( $db->getQuery(true) ->select($db->quoteName('us.extra_query')) ->from($db->quoteName('#__update_sites', 'us')) ->join('INNER', $db->quoteName('#__update_sites_extensions', 'use') . ' ON use.update_site_id = us.update_site_id') ->join('INNER', $db->quoteName('#__extensions', 'e') . ' ON e.extension_id = use.extension_id') ->where($db->quoteName('e.element') . ' = ' . $db->quote('pkg_mokosuitecross')) ->setLimit(1) ); $key = $db->loadResult(); if (!empty($key)) { $this->savedDownloadKey = $key; } } catch (\Throwable $e) {} } private function restoreDownloadKey(): void { if ($this->savedDownloadKey === null) { return; } try { $db = \Joomla\CMS\Factory::getDbo(); $db->setQuery( $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 use.update_site_id = us.update_site_id') ->join('INNER', $db->quoteName('#__extensions', 'e') . ' ON e.extension_id = use.extension_id') ->where($db->quoteName('e.element') . ' = ' . $db->quote('pkg_mokosuitecross')) ->setLimit(1) ); $siteId = (int) $db->loadResult(); if ($siteId > 0) { $db->setQuery( $db->getQuery(true) ->update($db->quoteName('#__update_sites')) ->set($db->quoteName('extra_query') . ' = ' . $db->quote($this->savedDownloadKey)) ->where($db->quoteName('update_site_id') . ' = ' . $siteId) )->execute(); } } catch (\Throwable $e) {} } private function warnMissingLicenseKey(): void { try { $db = \Joomla\CMS\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('%MokoSuiteCross%') . ' OR ' . $db->quoteName('location') . ' LIKE ' . $db->quote('%MokoSuiteCross%') . ')') ->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'; } \Joomla\CMS\Factory::getApplication()->enqueueMessage( 'Moko Consulting License Key Required — ' . 'No download key is configured. Updates will not be available until a valid license key is entered. ' . 'Enter License Key', 'warning' ); } catch (\Throwable $e) {} } }