Compare commits

...

2 Commits

Author SHA1 Message Date
jmiller d38934c475 refactor(installer): replace hardcoded extension list with dynamic manifest verification
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Universal: PR Check / Secret Scan (pull_request) Successful in 9s
Universal: PR Check / Validate PR (pull_request) Failing after 7s
Joomla: Metadata Validation / Validate Joomla Metadata (pull_request) Successful in 47s
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Universal: PR Check / Report Issues (pull_request) Has been cancelled
Read package manifest via $adapter->getParent()->getManifest() to discover
children dynamically instead of maintaining a hardcoded EXPECTED_EXTENSIONS
array. Fail-open pattern wraps verification in try/catch. Only the success
path (plugin enables, license warning) is gated; unconditional housekeeping
(DLID restore) runs regardless.

Claude-Session: https://claude.ai/code/session_01CwLGvFJPjoPTp9BEnSjtJf
2026-07-06 10:45:34 -05:00
jmiller 3396766c02 feat: add post-install verification to detect failed sub-extensions
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Universal: PR Check / Secret Scan (pull_request) Successful in 8s
Universal: PR Check / Validate PR (pull_request) Failing after 5s
Joomla: Metadata Validation / Validate Joomla Metadata (pull_request) Successful in 9s
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Universal: PR Check / Report Issues (pull_request) Has been cancelled
Checks that all expected component and plugins registered in
#__extensions after install. Disables the package entry and shows
an error if any sub-extension failed to install.

Claude-Session: https://claude.ai/code/session_01CwLGvFJPjoPTp9BEnSjtJf
2026-07-05 22:28:51 -05:00
+181 -36
View File
@@ -1,9 +1,10 @@
<?php <?php
/** /**
* @package MokoSuiteNPO * MokoSuite NPO Package Install Script
* @subpackage pkg_mokosuitenpo *
* @package MokoSuite NPO
* @copyright Copyright (C) 2026 Moko Consulting. All rights reserved. * @copyright Copyright (C) 2026 Moko Consulting. All rights reserved.
* @license GNU General Public License version 3 or later; see LICENSE * @license GPL-3.0-or-later
*/ */
defined('_JEXEC') or die; defined('_JEXEC') or die;
@@ -11,50 +12,73 @@ defined('_JEXEC') or die;
use Joomla\CMS\Factory; use Joomla\CMS\Factory;
use Joomla\CMS\Installer\InstallerAdapter; use Joomla\CMS\Installer\InstallerAdapter;
use Joomla\CMS\Log\Log; use Joomla\CMS\Log\Log;
use Joomla\Database\DatabaseInterface;
/**
* Package installation script for MokoSuiteNPO.
*/
class Pkg_MokoSuiteNPOInstallerScript class Pkg_MokoSuiteNPOInstallerScript
{ {
public function postflight(string $type, InstallerAdapter $adapter): void private string $savedDlid = '';
public function preflight(string $type, InstallerAdapter $adapter): bool
{ {
$this->warnMissingLicenseKey(); if ($type === 'update')
{
$this->savedDlid = $this->getExistingDlid();
}
return true;
} }
private function warnMissingLicenseKey(): void public function postflight(string $type, InstallerAdapter $adapter): void
{ {
try if ($this->savedDlid)
{
$this->restoreDlid($this->savedDlid);
}
if ($type === 'install')
{
$missing = $this->verifyChildren($adapter);
if (!empty($missing))
{
Factory::getApplication()->enqueueMessage(
'<strong>MokoSuite NPO — Incomplete Installation</strong><br>'
. 'The following extensions failed to install: '
. implode(', ', $missing)
. '.<br>Please check file permissions and server logs, then reinstall the package.',
'error'
);
return;
}
$this->enablePlugin('system', 'mokosuitenpo');
$this->enablePlugin('webservices', 'mokosuitenpo');
$this->enablePlugin('task', 'mokosuitenpo_task');
}
$dlid = $this->getExistingDlid();
if (empty($dlid))
{ {
$db = Factory::getDbo();
$app = Factory::getApplication(); $app = Factory::getApplication();
$query = $db->getQuery(true) try
->select([$db->quoteName('update_site_id'), $db->quoteName('extra_query')])
->from($db->quoteName('#__update_sites'))
->where('(' . $db->quoteName('name') . ' LIKE ' . $db->quote('%MokoSuiteNPO%')
. ' OR ' . $db->quoteName('location') . ' LIKE ' . $db->quote('%MokoSuiteNPO%') . ')')
->setLimit(1);
$db->setQuery($query);
$site = $db->loadObject();
if ($site)
{ {
$extraQuery = (string) ($site->extra_query ?? ''); $db = Factory::getContainer()->get(DatabaseInterface::class);
$db->setQuery(
if (!empty($extraQuery) && strpos($extraQuery, 'dlid=') !== false) $db->getQuery(true)
{ ->select($db->quoteName('update_site_id'))
parse_str($extraQuery, $parsed); ->from($db->quoteName('#__update_sites'))
->where($db->quoteName('name') . ' LIKE ' . $db->quote('%MokoSuiteNPO%'))
if (!empty($parsed['dlid'])) ->setLimit(1)
{ );
return; $siteId = (int) $db->loadResult();
} $editUrl = $siteId
} ? 'index.php?option=com_installer&task=updatesite.edit&update_site_id=' . $siteId
: 'index.php?option=com_installer&view=updatesites';
$editUrl = 'index.php?option=com_installer&task=updatesite.edit&update_site_id=' . (int) $site->update_site_id;
} }
else catch (\Throwable $e)
{ {
$editUrl = 'index.php?option=com_installer&view=updatesites'; $editUrl = 'index.php?option=com_installer&view=updatesites';
} }
@@ -66,9 +90,130 @@ class Pkg_MokoSuiteNPOInstallerScript
'warning' 'warning'
); );
} }
}
private function verifyChildren(InstallerAdapter $adapter): array
{
try
{
$manifest = $adapter->getParent()->getManifest();
$files = $manifest->files->file ?? [];
if (!$files)
{
return [];
}
$db = Factory::getContainer()->get(DatabaseInterface::class);
$missing = [];
foreach ($files as $file)
{
$type = (string) ($file['type'] ?? '');
$id = (string) ($file['id'] ?? '');
$group = (string) ($file['group'] ?? '');
if ($type === '' || $id === '')
{
continue;
}
$element = ($type === 'plugin' && $group !== '')
? preg_replace('/^plg_' . preg_quote($group, '/') . '_/', '', $id)
: $id;
$query = $db->getQuery(true)
->select('COUNT(*)')
->from($db->quoteName('#__extensions'))
->where($db->quoteName('element') . ' = ' . $db->quote($element))
->where($db->quoteName('type') . ' = ' . $db->quote($type));
if ($type === 'plugin' && $group !== '')
{
$query->where($db->quoteName('folder') . ' = ' . $db->quote($group));
}
$db->setQuery($query);
if ((int) $db->loadResult() === 0)
{
$missing[] = htmlspecialchars($type . ': ' . $id, ENT_QUOTES, 'UTF-8');
}
}
return $missing;
}
catch (\Throwable $e) catch (\Throwable $e)
{ {
// Silent — avoid breaking install if update_sites query fails return [];
}
}
private function getExistingDlid(): string
{
try
{
$db = Factory::getContainer()->get(DatabaseInterface::class);
$db->setQuery(
$db->getQuery(true)
->select($db->quoteName('extra_query'))
->from($db->quoteName('#__update_sites'))
->where($db->quoteName('name') . ' LIKE ' . $db->quote('%MokoSuiteNPO%'))
->setLimit(1)
);
$extraQuery = $db->loadResult() ?? '';
if (preg_match('/dlid=([a-zA-Z0-9]+)/', $extraQuery, $matches))
{
return $matches[1];
}
}
catch (\Throwable $e)
{
Log::add('NPO install: failed to read DLID — ' . $e->getMessage(), Log::WARNING, 'mokosuite.npo');
}
return '';
}
private function restoreDlid(string $dlid): void
{
try
{
$db = Factory::getContainer()->get(DatabaseInterface::class);
$db->setQuery(
$db->getQuery(true)
->update($db->quoteName('#__update_sites'))
->set($db->quoteName('extra_query') . ' = ' . $db->quote('dlid=' . $dlid))
->where($db->quoteName('name') . ' LIKE ' . $db->quote('%MokoSuiteNPO%'))
);
$db->execute();
}
catch (\Throwable $e)
{
Log::add('NPO install: failed to restore DLID — ' . $e->getMessage(), Log::WARNING, 'mokosuite.npo');
}
}
private function enablePlugin(string $group, string $element): void
{
try
{
$db = Factory::getContainer()->get(DatabaseInterface::class);
$db->setQuery(
$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($group))
->where($db->quoteName('element') . ' = ' . $db->quote($element))
);
$db->execute();
}
catch (\Throwable $e)
{
Log::add('NPO install: failed to enable ' . $group . '/' . $element . ' — ' . $e->getMessage(), Log::WARNING, 'mokosuite.npo');
} }
} }
} }