2026-06-21 11:38:41 -05:00
<? php
/**
* @package MokoSuiteCross
* @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
* 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
{
2026-07-06 11:14:57 -05:00
// Housekeeping — runs unconditionally regardless of child-install result.
2026-06-21 11:38:41 -05:00
$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 );
}
2026-07-06 11:14:57 -05:00
// 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 (
'<h4>MokoSuiteCross did not install correctly.</h4>'
. '<p>The following bundled extensions are missing: '
. htmlspecialchars ( implode ( ', ' , $missing ), ENT_QUOTES ) . '</p>'
. '<p>Please uninstall MokoSuiteCross and reinstall the full package.</p>' ,
'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 <file> "type" attribute
* - element = the <file> "id" attribute, EXCEPT for plugins the manifest often
* declares the full `plg_<group>_<element>` id, so strip a leading
* `plg_<group>_` to get the real element; components/modules use id as-is
* - plugins ALSO match folder = the <file> "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_<group>_.
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 [];
}
2026-06-21 11:38:41 -05:00
}
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 (
'<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 ) {}
}
}