@copyright Copyright (C) 2021. All Rights Reserved. @license GNU/GPL Version 2 or later - http://www.gnu.org/licenses/gpl-2.0.html ____ _____ _____ __ __ __ __ ___ _____ __ __ ____ _____ _ _ ____ _ _ ____ (_ _)( _ )( _ )( \/ )( ) /__\ / __)( _ )( \/ )( _ \( _ )( \( )( ___)( \( )(_ _) .-_)( )(_)( )(_)( ) ( )(__ /(__)\ ( (__ )(_)( ) ( )___/ )(_)( ) ( )__) ) ( )( \____) (_____)(_____)(_/\/\_)(____)(__)(__) \___)(_____)(_/\/\_)(__) (_____)(_)\_)(____)(_)\_) (__) /------------------------------------------------------------------------------------------------------*/ // No direct access to this file defined('_JEXEC') or die('Restricted access'); use Joomla\CMS\Filesystem\File; use Joomla\CMS\Language\Language; use Joomla\Registry\Registry; use Joomla\String\StringHelper; use Joomla\Utilities\ArrayHelper; /** * Extensiondistributor component helper */ abstract class ExtensiondistributorHelper { /** * Composer Switch * * @var array */ protected static $composer = array(); /** * The Main Active Language * * @var string */ public static $langTag; public static function getReleases($id, $view = 'extension', $latest = false) { if (!$id) { return null; } $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->select($db->quoteName( array('id','version_number','release_date','reltype','stability','file','extension','package') )) ->from($db->quoteName('#__extensiondistributor_release')) ->where( array( $db->quoteName($view) . ' = ' . (int)$id, $db->quoteName('published') . ' = 1' ) ) ->order('INET_ATON(version_number) DESC') ; $db->setQuery($query); return $latest ? $db->loadObject() : $db->loadObjectList(); } public static function getPackageContent($packageId): array { $package = self::getPackageObject($packageId); // We first get the extensions of the package $extensions = $package->files; $extensions = json_decode($extensions,true); $files = array(); foreach ($extensions as &$extension) { $data = self::getReleases($extension['extension'],'extension',true); $details = self::getExtensionObject($extension['extension']); $extension['details'] = $details; $extension['release'] = $data; if (isset($data->file)) { $files[$data->id] = $data->file; } } return array('extensions' => $extensions, 'files' => $files, 'package' => $package); } public static function createPackage($packageId,$release) { $cparams = JComponentHelper::getParams('com_extensiondistributor'); $content = self::getPackageContent($packageId); $package = $content['package']; $extensions = $content['extensions']; $files = $content['files']; $lists = self::getApplicationLists(); $releaseFolder = JPATH_SITE . '/' . $cparams->get('releases_directory'); $tmpFolder = JPATH_SITE . '/tmp/' . $package->packagename; $update_path = $cparams->get('updates_directory','updates'); $update_file = $cparams->get('updateserver_url', JUri::root()).$update_path.'/'.$package->update; // We first create the temporary folder JFolder::create($tmpFolder); // We create the packages folder and copy the files inside JFolder::create($tmpFolder . '/packages'); foreach ($files as $file) { JFile::copy($releaseFolder . '/' . $file, $tmpFolder . '/packages/' . $file); } $zipFilename = self::createPackageFileName($package, $release->version_number, $release->stability); $xmldoc = new DOMDocument(); $xmldoc->encoding = 'UTF-8'; $xmldoc->xmlVersion = '1.0'; $xmldoc->formatOutput = true; $xml_file_name = $tmpFolder .'/pkg_'.$package->packagename.'.xml'; // Extension $root = $xmldoc->createElement('extension'); $root->setAttributeNode(new DOMAttr('type', 'package')); $root->setAttributeNode(new DOMAttr('version', '3.8')); $root->setAttributeNode(new DOMAttr('method', 'upgrade')); $root->appendChild($xmldoc->createElement('name', $package->name)); $root->appendChild($xmldoc->createElement('version', $release->version_number)); // => release $root->appendChild($xmldoc->createElement('author', $package->author)); $root->appendChild($xmldoc->createElement('authorUrl', $package->authorurl)); $root->appendChild($xmldoc->createElement('authorEmail', $package->authoremail)); $root->appendChild($xmldoc->createElement('creationDate', JHtml::date($release->release_date,'M Y'))); // => release $root->appendChild($xmldoc->createElement('packagename', $package->packagename)); $root->appendChild($xmldoc->createElement('packager', $package->packager)); $root->appendChild($xmldoc->createElement('packagerurl', $package->packagerurl)); $root->appendChild($xmldoc->createElement('copyright', $package->copyright)); $root->appendChild($xmldoc->createElement('license', $package->license)); $root->appendChild($xmldoc->createElement('description'))->appendChild($xmldoc->createCDATASection($package->description)); $root->appendChild($xmldoc->createElement('scriptfile', 'script.php')); // => dynamic A venir if ($package->blockchilduninstall) { $root->appendChild($xmldoc->createElement('blockChildUninstall', 'true')); } $files_node = $xmldoc->createElement('files'); $files_node->setAttributeNode(new DOMAttr('folder', 'packages')); foreach ($extensions as $extension) { switch ($extension['details']->type) { case 'component' : case 'library' : $child_node_file = $xmldoc->createElement('file', $extension['release']->file); $child_node_file->setAttributeNode(new DOMAttr('type', $extension['details']->type)); $child_node_file->setAttributeNode(new DOMAttr('id', $extension['details']->element)); $files_node->appendChild($child_node_file); break; case 'module' : case 'template' : case 'language' : $child_node_file = $xmldoc->createElement('file', $extension['release']->file); $child_node_file->setAttributeNode(new DOMAttr('type', $extension['details']->type)); $child_node_file->setAttributeNode(new DOMAttr('id', $extension['details']->element)); $child_node_file->setAttributeNode(new DOMAttr('client', $extension['release']->client)); $files_node->appendChild($child_node_file); break; case 'plugin' : $child_node_file = $xmldoc->createElement('file', $extension['release']->file); $child_node_file->setAttributeNode(new DOMAttr('type', $extension['details']->type)); $child_node_file->setAttributeNode(new DOMAttr('id', $extension['details']->element)); $child_node_file->setAttributeNode(new DOMAttr('group', $extension['details']->group)); $files_node->appendChild($child_node_file); break; } } $root->appendChild($files_node); $updateservers_node = $xmldoc->createElement('updateservers'); $child_node_server = $xmldoc->createElement('server', $update_file); $child_node_server->setAttributeNode(new DOMAttr('type', 'extension')); $child_node_server->setAttributeNode(new DOMAttr('priority', '1')); $child_node_server->setAttributeNode(new DOMAttr('name', $cparams->get('server_name'))); $updateservers_node->appendChild($child_node_server); $root->appendChild($updateservers_node); $xmldoc->appendChild($root); $xmldoc->save($xml_file_name); // We create the script file self::createScriptFile($packageId, $tmpFolder); // We zip everything in a package self::zipPackage($releaseFolder.'/'.$zipFilename,$tmpFolder); JFolder::delete($tmpFolder); return $zipFilename; } public static function zipPackage($zipFile, $zipDir) { $zip = new ZipArchive(); $zip->open($zipFile, ZipArchive::CREATE | ZipArchive::OVERWRITE); $files = new RecursiveIteratorIterator( new RecursiveDirectoryIterator($zipDir), RecursiveIteratorIterator::LEAVES_ONLY ); foreach ($files as $name => $file) { // Skip directories (they would be added automatically) if (!$file->isDir()) { // Get real and relative path for current file $filePath = $file->getRealPath(); $relativePath = substr($filePath, strlen($zipDir) + 1); // Add current file to archive $zip->addFile($filePath, $relativePath); } } $zip->close(); } protected static $tabSpacerBucket = array(); protected static $tabSpacer = "\t"; protected static $debugLinenr = false; public static function _t($nr) { // check if we already have the string if (!isset(self::$tabSpacerBucket[$nr])) { // get the string self::$tabSpacerBucket[$nr] = str_repeat(self::$tabSpacer, (int) $nr); } // return stored string return self::$tabSpacerBucket[$nr]; } public static function getExtensionInstallClass(&$extension) { // yes we are adding it $script = PHP_EOL . '/**'; $script .= PHP_EOL . ' * ' . $extension->official_name . ' script file.'; $script .= PHP_EOL . ' *'; $script .= PHP_EOL . ' * @package ' . $extension->class_name; $script .= PHP_EOL . ' */'; $script .= PHP_EOL . 'class ' . $extension->installer_class_name; $script .= PHP_EOL . '{'; // set constructor if (isset($extension->add_php_script_construct) && $extension->add_php_script_construct == 1 && self::checkString( $extension->php_script_construct )) { $script .= self::setInstallMethodScript( 'construct', $extension->php_script_construct ); } // add PHP in extension install $addScriptMethods = array('php_preflight', 'php_postflight', 'php_method'); $addScriptTypes = array('install', 'update', 'uninstall', 'discover_install'); // set some buckets for sorting $function_install = array(); $function_update = array(); $function_uninstall = array(); $has_php_preflight = false; $function_php_preflight = array('install' => array(), 'uninstall' => array(), 'discover_install' => array(), 'update' => array()); $has_php_postflight = false; $function_php_postflight = array('install' => array(), 'uninstall' => array(), 'discover_install' => array(), 'update' => array()); // the function sorter foreach ($addScriptMethods as $scriptMethod) { foreach ($addScriptTypes as $scriptType) { if (isset( $extension->{'add_' . $scriptMethod . '_' . $scriptType} ) && $extension->{'add_' . $scriptMethod . '_' . $scriptType} == 1 && self::checkString( $extension->{$scriptMethod . '_' . $scriptType} )) { // add to the main methods if ('php_method' === $scriptMethod) { ${'function_' . $scriptType}[] = $extension->{$scriptMethod . '_' . $scriptType}; } else { ${'function_' . $scriptMethod}[$scriptType][] = $extension->{$scriptMethod . '_' . $scriptType}; ${'has_' . $scriptMethod} = true; } } } } // now add the install script. if (self::checkArray($function_install)) { $script .= self::setInstallMethodScript( 'install', $function_install ); } // now add the update script. if (self::checkArray($function_update)) { $script .= self::setInstallMethodScript( 'update', $function_update ); } // now add the uninstall script. if (self::checkArray($function_uninstall)) { $script .= self::setInstallMethodScript( 'uninstall', $function_uninstall ); } // now add the preflight script. if ($has_php_preflight) { $script .= self::setInstallMethodScript( 'preflight', $function_php_preflight ); } // now add the postflight script. if ($has_php_postflight) { $script .= self::setInstallMethodScript( 'postflight', $function_php_postflight ); } $script .= PHP_EOL . '}' . PHP_EOL; return $script; } public static function setInstallMethodScript($function_name, &$scripts) { $script = ''; // build function switch ($function_name) { case 'install': case 'update': case 'uninstall': // the main function types $script = PHP_EOL . PHP_EOL . self::_t(1) . '/**'; $script .= PHP_EOL . self::_t(1) . ' * Called on ' . $function_name; $script .= PHP_EOL . self::_t(1) . ' *'; $script .= PHP_EOL . self::_t(1) . ' * @param JAdapterInstance $adapter The object responsible for running this script'; $script .= PHP_EOL . self::_t(1) . ' *'; $script .= PHP_EOL . self::_t(1) . ' * @return boolean True on success'; $script .= PHP_EOL . self::_t(1) . ' */'; $script .= PHP_EOL . self::_t(1) . 'public function ' . $function_name . '(JAdapterInstance $adapter)'; $script .= PHP_EOL . self::_t(1) . '{'; $script .= PHP_EOL . implode(PHP_EOL . PHP_EOL, $scripts); // Added the HTML message $script .= PHP_EOL . '// Custom HTML message uninstall'; // return true if ('uninstall' !== $function_name) { $script .= PHP_EOL . self::_t(2) . 'return true;'; } break; case 'preflight': case 'postflight': // the pre/post function types $script = PHP_EOL . PHP_EOL . self::_t(1) . '/**'; $script .= PHP_EOL . self::_t(1) . ' * Called before any type of action'; $script .= PHP_EOL . self::_t(1) . ' *'; $script .= PHP_EOL . self::_t(1) . ' * @param string $route Which action is happening (install|uninstall|discover_install|update)'; $script .= PHP_EOL . self::_t(1) . ' * @param JAdapterInstance $adapter The object responsible for running this script'; $script .= PHP_EOL . self::_t(1) . ' *'; $script .= PHP_EOL . self::_t(1) . ' * @return boolean True on success'; $script .= PHP_EOL . self::_t(1) . ' */'; $script .= PHP_EOL . self::_t(1) . 'public function ' . $function_name . '($route, JAdapterInstance $adapter)'; $script .= PHP_EOL . self::_t(1) . '{'; $script .= PHP_EOL . self::_t(2) . '//' . self::setLine( __LINE__ ) . ' get application'; $script .= PHP_EOL . self::_t(2) . '$app = JFactory::getApplication();' . PHP_EOL; // add the default version check (TODO) must make this dynamic if ('preflight' === $function_name) { $script .= PHP_EOL . self::_t(2) . '//' . self::setLine( __LINE__ ) . ' the default for both install and update'; $script .= PHP_EOL . self::_t(2) . '$jversion = new JVersion();'; $script .= PHP_EOL . self::_t(2) . "if (!\$jversion->isCompatible('3.8.0'))"; $script .= PHP_EOL . self::_t(2) . '{'; $script .= PHP_EOL . self::_t(3) . "\$app->enqueueMessage('Please upgrade to at least Joomla! 3.8.0 before continuing!', 'error');"; $script .= PHP_EOL . self::_t(3) . 'return false;'; $script .= PHP_EOL . self::_t(2) . '}' . PHP_EOL; } // now add the scripts foreach ($scripts as $route => $_script) { if (self::checkArray($_script)) { // set the if and script $script .= PHP_EOL . self::_t(2) . "if ('" . $route . "' === \$route)"; $script .= PHP_EOL . self::_t(2) . '{'; $script .= PHP_EOL . self::_t(3) . implode( PHP_EOL, $_script ); // Ajouté pour la gestion du block custom html if ($route === 'install') { $script .= PHP_EOL . '// Custom HTML message install'; } elseif ($route === 'update') { $script .= PHP_EOL . '// Custom HTML message update'; } elseif ($route === 'uninstall') { $script .= PHP_EOL . '// Custom HTML message uninstall'; } // Fin de l'ajout $script .= PHP_EOL . self::_t(2) . '}' . PHP_EOL; } } // return true $script .= PHP_EOL . self::_t(2) . 'return true;'; break; case 'construct': // the __construct script $script = PHP_EOL . PHP_EOL . self::_t(1) . '/**'; $script .= PHP_EOL . self::_t(1) . ' * Constructor'; $script .= PHP_EOL . self::_t(1) . ' *'; $script .= PHP_EOL . self::_t(1) . ' * @param JAdapterInstance $adapter The object responsible for running this script'; $script .= PHP_EOL . self::_t(1) . ' */'; $script .= PHP_EOL . self::_t(1) . 'public function __construct(JAdapterInstance $adapter)'; $script .= PHP_EOL . self::_t(1) . '{'; $script .= PHP_EOL . $scripts; break; default: // oops error return ''; } // close the function $script .= PHP_EOL . self::_t(1) . '}'; return $script; } private static function setLine($nr) { if (self::$debugLinenr) { return ' [Interpretation ' . $nr . ']'; } return ''; } public static function createScriptFile($packageId, $path) { $extension = self::getPackageObject(1); $extension->official_name = $extension->name; $extension->class_name = 'Pkg_'.$extension->packagename; $extension->installer_class_name = $extension->class_name . 'InstallerScript'; $extension->php_method_uninstall = base64_decode($extension->php_method_uninstall); $extension->php_postflight_install = base64_decode($extension->php_postflight_install); $extension->php_postflight_update = base64_decode($extension->php_postflight_update); $extension->php_preflight_install = base64_decode($extension->php_preflight_install); $extension->php_preflight_uninstall = base64_decode($extension->php_preflight_uninstall); $extension->php_preflight_update = base64_decode($extension->php_preflight_update); $script = self::getExtensionInstallClass($extension); $file = $path . '/script.php'; file_put_contents($file, "getQuery(true); $query ->select($db->quoteName( array( 'id', 'alias', 'catid', 'client', 'description', 'element', 'group', 'image', 'keepfilename', 'name', 'newfilename', 'release_date', 'type', 'update', 'version_number', 'published' ) )) ->from($db->quoteName('#__extensiondistributor_extension')) ->where($db->quoteName('id') . ' = ' . (int)$extension) ; $db->setQuery($query); return $db->loadObject(); } public static function getPackageObject($package) { $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->select('*') ->from($db->quoteName('#__extensiondistributor_package')) ->where($db->quoteName('id') . ' = ' . (int)$package) ; $db->setQuery($query); return $db->loadObject(); } public static function isExtension($type,$element,$group,$client) { $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->select($db->quoteName('id')) ->from($db->quoteName('#__extensiondistributor_extension')) ->where( array( $db->quoteName('type') . ' = ' . $db->quote($type), $db->quoteName('element') . ' = ' . $db->quote($element), $db->quoteName('group') . ' = ' . $db->quote($group), $db->quoteName('client') . ' = ' . $db->quote($client) ) ) ; $db->setQuery($query); return $db->loadResult(); } public static function extensionsLastId() { $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->select($db->quoteName('id')) ->from($db->quoteName('#__extensiondistributor_extension')) ->order('id DESC') ; $db->setQuery($query,0,1); return $db->loadResult(); } public static function isRelease($extensionId,$version) { $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->select($db->quoteName('id')) ->from($db->quoteName('#__extensiondistributor_release')) ->where( array( $db->quoteName('extension') . ' = ' . (int)$extensionId, $db->quoteName('version_number') . ' = ' . $db->quote($version) ) ) ; $db->setQuery($query); return $db->loadResult(); } public static function getApplicationLists(): array { $lists = array(); $lists['stability'] = array( '0' => array( 'label' => 'Development', 'color' => 'default' ), '1' => array( 'label' => 'Alpha', 'color' => 'important' ), '2' => array( 'label' => 'Beta', 'color' => 'warning' ), '3' => array( 'label' => 'RC', 'color' => 'warning' ), '4' => array( 'label' => 'Stable', 'color' => 'success' ) ); $lists['extensionTypes'] = array( 'component' => 'com', 'plugin' => 'plg', 'module' => 'mod', 'library' => 'lib', 'template' => 'tpl', 'language' => 'lang', 'file' => 'file' ); return $lists; } public static function createBadge($id, $name, $type, $group = '', $client = ''): string { $tooltip = ''; $tooltip .= ''; $tooltip .= ucfirst($type); $tooltip .= ' ' . $group; $tooltip .= ' ' . $client; $tooltip .= ''; $tooltip .= '
'; $tooltip .= ""; $tooltip .= $name; $return = base64_encode(urlencode(JUri::getInstance()->toString())); $bagde = ''; $bagde .= ''; $bagde .= strtoupper(substr($type,0,1)); $bagde .= ''; if (!empty($group)) { $bagde .= strtolower(substr($group,0,1)); } if (!empty($client)) { $bagde .= strtolower(substr($client,0,1)); } $bagde .= ''; $bagde .= ''; $bagde .= ''; return $bagde; } public static function getReleaseToFile() { $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->select($db->quoteName(array('id','file'))) ->from($db->quoteName('#__extensiondistributor_release')) ; $db->setQuery($query); return $db->loadAssocList('id','file'); } public static function createExtensionFileName($extension, $version, $stability, $file) { if ($extension->keepfilename) { // if we keep the filename no need to waste more time return $file; } $lists = self::getApplicationLists(); $extensionTypes = $lists['extensionTypes']; $stabilityList = $lists['stability']; $pattern = $extension->newfilename; $version = explode('.',$version); $replacements = array( 'type' => $extensionTypes[$extension->type], 'element' => str_replace(array('com_','mod_'),'',$extension->element), 'client' => $extension->client, '_client' => $extension->client ? '_'.$extension->client : '', // Find a cleaner solution after 'group' => $extension->group, '_group' => $extension->group ? '_'.$extension->group : '', // Find a cleaner solution after 'stability' => $stabilityList[$stability]['label'], 'major' => $version[0], 'minor' => $version[1], 'release' => $version[2] ); foreach ($replacements as $k => $v) { $pattern = str_replace('{'.$k.'}',$v,$pattern); } return strtolower($pattern); } public static function createPackageFileName($package, $version, $stability) { $lists = self::getApplicationLists(); $stabilityList = $lists['stability']; $pattern = $package->newfilename; $version = explode('.',$version); $replacements = array( 'type' => 'pkg', 'packagename' => $package->packagename, 'stability' => $stabilityList[$stability]['label'], 'major' => $version[0], 'minor' => $version[1], 'release' => $version[2] ); foreach ($replacements as $k => $v) { $pattern = str_replace('{'.$k.'}',$v,$pattern); } return strtolower($pattern); } public static function getXmlVersions($xml_file) { $updates = simplexml_load_file($xml_file); $versions = array(); foreach ($updates->children() as $update) { $versions[] = $update->version; } return $versions; } public static function getReleaseDetails($releaseId) { $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->select($db->quoteName( array('r.id','r.version_number','r.release_date','r.reltype','r.stability','r.file','r.extension','r.package'), array('r_id','r_version_number','r_release_date','r_reltype','r_stability','r_file','r_extension','r_package') )) ->select('p.*') ->join('LEFT','#__extensiondistributor_package AS p ON p.id = r.package') ->from($db->quoteName('#__extensiondistributor_release','r')) ->where($db->quoteName('r.id') . ' = ' . (int)$releaseId) ; $db->setQuery($query); return $db->loadObject(); } public static function getReleaseFile($releaseId, $key = null): array { $file = true; $msg = ''; $db = JFactory::getDbo(); $query = $db->getQuery(true); $cparams = JComponentHelper::getParams('com_extensiondistributor'); $folder = $cparams->get('releases_directory'); $folder = JPath::clean(JPATH_SITE . '/' . $folder . '/'); $query ->clear() ->select($db->quoteName( array('id','file','extension','package','published') )) ->from($db->quoteName('#__extensiondistributor_release')) ->where($db->quoteName('id') . ' = ' . (int)$releaseId) ; $db->setQuery($query); $release = $db->loadObject(); if (is_null($release) || !$release) { $file = false; $msg = 'The requested file does not exist'; return array('file' => $file, 'msg' => $msg); } if ($release->published != 1) { $file = false; $msg = 'The requested file is not published'; return array('file' => $file, 'msg' => $msg); } if ($release->extension > 0) { // For extensions we do not check the key $file = false; $msg = 'The individual extension download is not authorized'; return array('file' => $file, 'msg' => $msg); } if ($release->package > 0) { $latest = self::getPackageObject($release->package); if (is_null($latest) || !$latest) { $file = false; $msg = 'The requested package is not available anymore'; return array('file' => $file, 'msg' => $msg); } if (!$latest->free) { if (is_null($key)) { $file = false; $msg = 'This is a commercial extension you need to provide a download key'; return array('file' => $file, 'msg' => $msg); } $userId = self::getVar('key',$key,'key','user'); if (!$userId) { $file = false; $msg = 'The download key you provided does not exists'; return array('file' => $file, 'msg' => $msg); } $isLegitimate = self::isLegitimate($userId,$release->package); if (!$isLegitimate) { $file = false; $msg = 'Your subscription is not active anymore'; return array('file' => $file, 'msg' => $msg); } } if (!JFile::exists($folder . $release->file)) { $file = false; $msg = sprintf('The file %s is not available', $release->file); return array('file' => $file, 'msg' => $msg); } $file = true; $msg = $release->file; return array('file' => $file, 'msg' => $msg); } return array('file' => $file, 'msg' => $msg); } public static function isLegitimate($userId,$packageId): bool { $now = JFactory::getDate()->toSql(); $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->clear() ->select($db->quoteName('id')) ->from($db->quoteName('#__extensiondistributor_subscription')) ->where( array( $db->quoteName('user') . ' = ' . (int)$userId, $db->quoteName('active') . ' = 1', $db->quoteName('date_start') . ' <= ' . $db->quote($now), $db->quoteName('date_expire') . ' > ' . $db->quote($now) ) ) ->extendWhere('AND', array( $db->quoteName('package') . ' = ' . (int)$packageId, $db->quoteName('package') . ' = ' . $db->quote('All') ),'OR') ; $db->setQuery($query); $result = $db->loadResult(); return $db->loadResult() ? true : false; } public static function getRealIpAddr() { if (!empty($_SERVER['HTTP_CLIENT_IP'])) { // Check IP from internet. $ip = $_SERVER['HTTP_CLIENT_IP']; } elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR']) ) { // Check IP is passed from proxy. $ip = $_SERVER['HTTP_X_FORWARDED_FOR']; } else { // Get IP address from remote address. $ip = $_SERVER['REMOTE_ADDR']; } return $ip; } public static function getFileUsage($filename) { $db = JFactory::getDbo(); $query = $db->getQuery(true); $query ->select($db->quoteName( array('r.id','r.version_number','r.release_date','r.reltype','r.stability','r.file','r.extension','r.package') )) ->from($db->quoteName('#__extensiondistributor_release','r')) ->select($db->quoteName( array('e.id','e.name','e.element','e.type','e.group','e.client'), array('e_id','e_name','e_element','e_type','e_group','e_client') )) ->join('LEFT','#__extensiondistributor_extension AS e ON r.extension = e.id') ->select($db->quoteName( array('p.id','p.packagename','p.name'), array('p_id','p_packagename','p_name') )) ->join('LEFT','#__extensiondistributor_package AS p ON r.package = p.id') ->where($db->quoteName('r.file') . ' = ' . $db->quote($filename)) ; $db->setQuery($query); return $db->loadObjectList('id'); } public static function secureFolder($path, $action = 'secure') { $destPath = JPath::clean($path); $srcPath = JPATH_ADMINISTRATOR.'/components/com_extensiondistributor/assets/security/'; $files = array( 'htaccess.txt' => '.htaccess', 'index.htm' => 'index.htm', 'index.html' => 'index.html', 'index.php' => 'index.php', 'web.config' => 'web.config' ); foreach ($files as $src => $dest) { if ($action === 'secure') { if (JFile::exists($srcPath.$src)) { JFile::copy($srcPath.$src, $destPath.$dest); } } else { if (JFile::exists($path.$dest)) { JFile::delete($path.$dest); } } } } /** * Load the Composer Vendors */ public static function composerAutoload($target) { // insure we load the composer vendor only once if (!isset(self::$composer[$target])) { // get the function name $functionName = self::safeString('compose' . $target); // check if method exist if (method_exists(__CLASS__, $functionName)) { return self::{$functionName}(); } return false; } return self::$composer[$target]; } /** * Convert it into a string */ public static function jsonToString($value, $sperator = ", ", $table = null, $id = 'id', $name = 'name') { // do some table foot work $external = false; if (strpos($table, '#__') !== false) { $external = true; $table = str_replace('#__', '', $table); } // check if string is JSON $result = json_decode($value, true); if (json_last_error() === JSON_ERROR_NONE) { // is JSON if (self::checkArray($result)) { if (self::checkString($table)) { $names = array(); foreach ($result as $val) { if ($external) { if ($_name = self::getVar(null, $val, $id, $name, '=', $table)) { $names[] = $_name; } } else { if ($_name = self::getVar($table, $val, $id, $name)) { $names[] = $_name; } } } if (self::checkArray($names)) { return (string) implode($sperator,$names); } } return (string) implode($sperator,$result); } return (string) json_decode($value); } return $value; } /** * Load the Component xml manifest. */ public static function manifest() { $manifestUrl = JPATH_ADMINISTRATOR."/components/com_extensiondistributor/extensiondistributor.xml"; return simplexml_load_file($manifestUrl); } /** * Joomla version object */ protected static $JVersion; /** * set/get Joomla version */ public static function jVersion() { // check if set if (!self::checkObject(self::$JVersion)) { self::$JVersion = new JVersion(); } return self::$JVersion; } /** * Load the Contributors details. */ public static function getContributors() { // get params $params = JComponentHelper::getParams('com_extensiondistributor'); // start contributors array $contributors = array(); // get all Contributors (max 20) $searchArray = range('0','20'); foreach($searchArray as $nr) { if ((NULL !== $params->get("showContributor".$nr)) && ($params->get("showContributor".$nr) == 2 || $params->get("showContributor".$nr) == 3)) { // set link based of selected option if($params->get("useContributor".$nr) == 1) { $link_front = ''; $link_back = ''; } elseif($params->get("useContributor".$nr) == 2) { $link_front = ''; $link_back = ''; } else { $link_front = ''; $link_back = ''; } $contributors[$nr]['title'] = self::htmlEscape($params->get("titleContributor".$nr)); $contributors[$nr]['name'] = $link_front.self::htmlEscape($params->get("nameContributor".$nr)).$link_back; } } return $contributors; } /** * Can be used to build help urls. **/ public static function getHelpUrl($view) { return false; } /** * Get any component's model */ public static function getModel($name, $path = JPATH_COMPONENT_SITE, $Component = 'Extensiondistributor', $config = array()) { // fix the name $name = self::safeString($name); // full path to models $fullPathModels = $path . '/models'; // load the model file JModelLegacy::addIncludePath($fullPathModels, $Component . 'Model'); // make sure the table path is loaded if (!isset($config['table_path']) || !self::checkString($config['table_path'])) { // This is the JCB default path to tables in Joomla 3.x $config['table_path'] = JPATH_ADMINISTRATOR . '/components/com_' . strtolower($Component) . '/tables'; } // get instance $model = JModelLegacy::getInstance($name, $Component . 'Model', $config); // if model not found (strange) if ($model == false) { jimport('joomla.filesystem.file'); // get file path $filePath = $path . '/' . $name . '.php'; $fullPathModel = $fullPathModels . '/' . $name . '.php'; // check if it exists if (File::exists($filePath)) { // get the file require_once $filePath; } elseif (File::exists($fullPathModel)) { // get the file require_once $fullPathModel; } // build class names $modelClass = $Component . 'Model' . $name; if (class_exists($modelClass)) { // initialize the model return new $modelClass($config); } } return $model; } /** * Add to asset Table */ public static function setAsset($id, $table, $inherit = true) { $parent = JTable::getInstance('Asset'); $parent->loadByName('com_extensiondistributor'); $parentId = $parent->id; $name = 'com_extensiondistributor.'.$table.'.'.$id; $title = ''; $asset = JTable::getInstance('Asset'); $asset->loadByName($name); // Check for an error. $error = $asset->getError(); if ($error) { return false; } else { // Specify how a new or moved node asset is inserted into the tree. if ($asset->parent_id != $parentId) { $asset->setLocation($parentId, 'last-child'); } // Prepare the asset to be stored. $asset->parent_id = $parentId; $asset->name = $name; $asset->title = $title; // get the default asset rules $rules = self::getDefaultAssetRules('com_extensiondistributor', $table, $inherit); if ($rules instanceof JAccessRules) { $asset->rules = (string) $rules; } if (!$asset->check() || !$asset->store()) { JFactory::getApplication()->enqueueMessage($asset->getError(), 'warning'); return false; } else { // Create an asset_id or heal one that is corrupted. $object = new stdClass(); // Must be a valid primary key value. $object->id = $id; $object->asset_id = (int) $asset->id; // Update their asset_id to link to the asset table. return JFactory::getDbo()->updateObject('#__extensiondistributor_'.$table, $object, 'id'); } } return false; } /** * Gets the default asset Rules for a component/view. */ protected static function getDefaultAssetRules($component, $view, $inherit = true) { // if new or inherited $assetId = 0; // Only get the actual item rules if not inheriting if (!$inherit) { // Need to find the asset id by the name of the component. $db = JFactory::getDbo(); $query = $db->getQuery(true) ->select($db->quoteName('id')) ->from($db->quoteName('#__assets')) ->where($db->quoteName('name') . ' = ' . $db->quote($component)); $db->setQuery($query); $db->execute(); // check that there is a value if ($db->getNumRows()) { // asset already set so use saved rules $assetId = (int) $db->loadResult(); } } // get asset rules $result = JAccess::getAssetRules($assetId); if ($result instanceof JAccessRules) { $_result = (string) $result; $_result = json_decode($_result); foreach ($_result as $name => &$rule) { $v = explode('.', $name); if ($view !== $v[0]) { // remove since it is not part of this view unset($_result->$name); } elseif ($inherit) { // clear the value since we inherit $rule = array(); } } // check if there are any view values remaining if (count((array) $_result)) { $_result = json_encode($_result); $_result = array($_result); // Instantiate and return the JAccessRules object for the asset rules. $rules = new JAccessRules($_result); // return filtered rules return $rules; } } return $result; } /** * xmlAppend * * @param SimpleXMLElement $xml The XML element reference in which to inject a comment * @param mixed $node A SimpleXMLElement node to append to the XML element reference, or a stdClass object containing a comment attribute to be injected before the XML node and a fieldXML attribute containing a SimpleXMLElement * * @return null * */ public static function xmlAppend(&$xml, $node) { if (!$node) { // element was not returned return; } switch (get_class($node)) { case 'stdClass': if (property_exists($node, 'comment')) { self::xmlComment($xml, $node->comment); } if (property_exists($node, 'fieldXML')) { self::xmlAppend($xml, $node->fieldXML); } break; case 'SimpleXMLElement': $domXML = dom_import_simplexml($xml); $domNode = dom_import_simplexml($node); $domXML->appendChild($domXML->ownerDocument->importNode($domNode, true)); $xml = simplexml_import_dom($domXML); break; } } /** * xmlComment * * @param SimpleXMLElement $xml The XML element reference in which to inject a comment * @param string $comment The comment to inject * * @return null * */ public static function xmlComment(&$xml, $comment) { $domXML = dom_import_simplexml($xml); $domComment = new DOMComment($comment); $nodeTarget = $domXML->ownerDocument->importNode($domComment, true); $domXML->appendChild($nodeTarget); $xml = simplexml_import_dom($domXML); } /** * xmlAddAttributes * * @param SimpleXMLElement $xml The XML element reference in which to inject a comment * @param array $attributes The attributes to apply to the XML element * * @return null * */ public static function xmlAddAttributes(&$xml, $attributes = array()) { foreach ($attributes as $key => $value) { $xml->addAttribute($key, $value); } } /** * xmlAddOptions * * @param SimpleXMLElement $xml The XML element reference in which to inject a comment * @param array $options The options to apply to the XML element * * @return void * */ public static function xmlAddOptions(&$xml, $options = array()) { foreach ($options as $key => $value) { $addOption = $xml->addChild('option'); $addOption->addAttribute('value', $key); $addOption[] = $value; } } /** * get the field object * * @param array $attributes The array of attributes * @param string $default The default of the field * @param array $options The options to apply to the XML element * * @return object * */ public static function getFieldObject(&$attributes, $default = '', $options = null) { // make sure we have attributes and a type value if (self::checkArray($attributes) && isset($attributes['type'])) { // make sure the form helper class is loaded if (!method_exists('JFormHelper', 'loadFieldType')) { jimport('joomla.form.form'); } // get field type $field = JFormHelper::loadFieldType($attributes['type'], true); // get field xml $XML = self::getFieldXML($attributes, $options); // setup the field $field->setup($XML, $default); // return the field object return $field; } return false; } /** * get the field xml * * @param array $attributes The array of attributes * @param array $options The options to apply to the XML element * * @return object * */ public static function getFieldXML(&$attributes, $options = null) { // make sure we have attributes and a type value if (self::checkArray($attributes)) { // start field xml $XML = new SimpleXMLElement(''); // load the attributes self::xmlAddAttributes($XML, $attributes); // check if we have options if (self::checkArray($options)) { // load the options self::xmlAddOptions($XML, $options); } // return the field xml return $XML; } return false; } /** * Render Bool Button * * @param array $args All the args for the button * 0) name * 1) additional (options class) // not used at this time * 2) default * 3) yes (name) * 4) no (name) * * @return string The input html of the button * */ public static function renderBoolButton() { $args = func_get_args(); // check if there is additional button class $additional = isset($args[1]) ? (string) $args[1] : ''; // not used at this time // button attributes $buttonAttributes = array( 'type' => 'radio', 'name' => isset($args[0]) ? self::htmlEscape($args[0]) : 'bool_button', 'label' => isset($args[0]) ? self::safeString(self::htmlEscape($args[0]), 'Ww') : 'Bool Button', // not seen anyway 'class' => 'btn-group', 'filter' => 'INT', 'default' => isset($args[2]) ? (int) $args[2] : 0); // set the button options $buttonOptions = array( '1' => isset($args[3]) ? self::htmlEscape($args[3]) : 'JYES', '0' => isset($args[4]) ? self::htmlEscape($args[4]) : 'JNO'); // return the input return self::getFieldObject($buttonAttributes, $buttonAttributes['default'], $buttonOptions)->input; } /** * Get a variable * * @param string $table The table from which to get the variable * @param string $where The value where * @param string $whereString The target/field string where/name * @param string $what The return field * @param string $operator The operator between $whereString/field and $where/value * @param string $main The component in which the table is found * * @return mix string/int/float * */ public static function getVar($table, $where = null, $whereString = 'user', $what = 'id', $operator = '=', $main = 'extensiondistributor') { if(!$where) { $where = JFactory::getUser()->id; } // Get a db connection. $db = JFactory::getDbo(); // Create a new query object. $query = $db->getQuery(true); $query->select($db->quoteName(array($what))); if (empty($table)) { $query->from($db->quoteName('#__'.$main)); } else { $query->from($db->quoteName('#__'.$main.'_'.$table)); } if (is_numeric($where)) { $query->where($db->quoteName($whereString) . ' '.$operator.' '.(int) $where); } elseif (is_string($where)) { $query->where($db->quoteName($whereString) . ' '.$operator.' '. $db->quote((string)$where)); } else { return false; } $db->setQuery($query); $db->execute(); if ($db->getNumRows()) { return $db->loadResult(); } return false; } /** * Get array of variables * * @param string $table The table from which to get the variables * @param string $where The value where * @param string $whereString The target/field string where/name * @param string $what The return field * @param string $operator The operator between $whereString/field and $where/value * @param string $main The component in which the table is found * @param bool $unique The switch to return a unique array * * @return array * */ public static function getVars($table, $where = null, $whereString = 'user', $what = 'id', $operator = 'IN', $main = 'extensiondistributor', $unique = true) { if(!$where) { $where = JFactory::getUser()->id; } if (!self::checkArray($where) && $where > 0) { $where = array($where); } if (self::checkArray($where)) { // prep main <-- why? well if $main='' is empty then $table can be categories or users if (self::checkString($main)) { $main = '_'.ltrim($main, '_'); } // Get a db connection. $db = JFactory::getDbo(); // Create a new query object. $query = $db->getQuery(true); $query->select($db->quoteName(array($what))); if (empty($table)) { $query->from($db->quoteName('#__'.$main)); } else { $query->from($db->quoteName('#_'.$main.'_'.$table)); } // add strings to array search if ('IN_STRINGS' === $operator || 'NOT IN_STRINGS' === $operator) { $query->where($db->quoteName($whereString) . ' ' . str_replace('_STRINGS', '', $operator) . ' ("' . implode('","',$where) . '")'); } else { $query->where($db->quoteName($whereString) . ' ' . $operator . ' (' . implode(',',$where) . ')'); } $db->setQuery($query); $db->execute(); if ($db->getNumRows()) { if ($unique) { return array_unique($db->loadColumn()); } return $db->loadColumn(); } } return false; } public static function isPublished($id,$type) { if ($type == 'raw') { $type = 'item'; } $db = JFactory::getDbo(); $query = $db->getQuery(true); $query->select(array('a.published')); $query->from('#__extensiondistributor_'.$type.' AS a'); $query->where('a.id = '. (int) $id); $query->where('a.published = 1'); $db->setQuery($query); $db->execute(); $found = $db->getNumRows(); if($found) { return true; } return false; } public static function getGroupName($id) { $db = JFactory::getDBO(); $query = $db->getQuery(true); $query->select(array('a.title')); $query->from('#__usergroups AS a'); $query->where('a.id = '. (int) $id); $db->setQuery($query); $db->execute(); $found = $db->getNumRows(); if($found) { return $db->loadResult(); } return $id; } /** * Get the action permissions * * @param string $view The related view name * @param int $record The item to act upon * @param string $views The related list view name * @param mixed $target Only get this permission (like edit, create, delete) * @param string $component The target component * @param object $user The user whose permissions we are loading * * @return object The JObject of permission/authorised actions * */ public static function getActions($view, &$record = null, $views = null, $target = null, $component = 'extensiondistributor', $user = 'null') { // load the user if not given if (!self::checkObject($user)) { // get the user object $user = JFactory::getUser(); } // load the JObject $result = new JObject; // make view name safe (just incase) $view = self::safeString($view); if (self::checkString($views)) { $views = self::safeString($views); } // get all actions from component $actions = JAccess::getActionsFromFile( JPATH_ADMINISTRATOR . '/components/com_' . $component . '/access.xml', "/access/section[@name='component']/" ); // if non found then return empty JObject if (empty($actions)) { return $result; } // get created by if not found if (self::checkObject($record) && !isset($record->created_by) && isset($record->id)) { $record->created_by = self::getVar($view, $record->id, 'id', 'created_by', '=', $component); } // set actions only set in component settings $componentActions = array('core.admin', 'core.manage', 'core.options', 'core.export'); // check if we have a target $checkTarget = false; if ($target) { // convert to an array if (self::checkString($target)) { $target = array($target); } // check if we are good to go if (self::checkArray($target)) { $checkTarget = true; } } // loop the actions and set the permissions foreach ($actions as $action) { // check target action filter if ($checkTarget && self::filterActions($view, $action->name, $target)) { continue; } // set to use component default $fallback = true; // reset permission per/action $permission = false; $catpermission = false; // set area $area = 'comp'; // check if the record has an ID and the action is item related (not a component action) if (self::checkObject($record) && isset($record->id) && $record->id > 0 && !in_array($action->name, $componentActions) && (strpos($action->name, 'core.') !== false || strpos($action->name, $view . '.') !== false)) { // we are in item $area = 'item'; // The record has been set. Check the record permissions. $permission = $user->authorise($action->name, 'com_' . $component . '.' . $view . '.' . (int) $record->id); // if no permission found, check edit own if (!$permission) { // With edit, if the created_by matches current user then dig deeper. if (($action->name === 'core.edit' || $action->name === $view . '.edit') && $record->created_by > 0 && ($record->created_by == $user->id)) { // the correct target $coreCheck = (array) explode('.', $action->name); // check that we have both local and global access if ($user->authorise($coreCheck[0] . '.edit.own', 'com_' . $component . '.' . $view . '.' . (int) $record->id) && $user->authorise($coreCheck[0] . '.edit.own', 'com_' . $component)) { // allow edit $result->set($action->name, true); // set not to use global default // because we already validated it $fallback = false; } else { // do not allow edit $result->set($action->name, false); $fallback = false; } } } elseif (self::checkString($views) && isset($record->catid) && $record->catid > 0) { // we are in item $area = 'category'; // set the core check $coreCheck = explode('.', $action->name); $core = $coreCheck[0]; // make sure we use the core. action check for the categories if (strpos($action->name, $view) !== false && strpos($action->name, 'core.') === false ) { $coreCheck[0] = 'core'; $categoryCheck = implode('.', $coreCheck); } else { $categoryCheck = $action->name; } // The record has a category. Check the category permissions. $catpermission = $user->authorise($categoryCheck, 'com_' . $component . '.' . $views . '.category.' . (int) $record->catid); if (!$catpermission && !is_null($catpermission)) { // With edit, if the created_by matches current user then dig deeper. if (($action->name === 'core.edit' || $action->name === $view . '.edit') && $record->created_by > 0 && ($record->created_by == $user->id)) { // check that we have both local and global access if ($user->authorise('core.edit.own', 'com_' . $component . '.' . $views . '.category.' . (int) $record->catid) && $user->authorise($core . '.edit.own', 'com_' . $component)) { // allow edit $result->set($action->name, true); // set not to use global default // because we already validated it $fallback = false; } else { // do not allow edit $result->set($action->name, false); $fallback = false; } } } } } // if allowed then fallback on component global settings if ($fallback) { // if item/category blocks access then don't fall back on global if ((($area === 'item') && !$permission) || (($area === 'category') && !$catpermission)) { // do not allow $result->set($action->name, false); } // Finally remember the global settings have the final say. (even if item allow) // The local item permissions can block, but it can't open and override of global permissions. // Since items are created by users and global permissions is set by system admin. else { $result->set($action->name, $user->authorise($action->name, 'com_' . $component)); } } } return $result; } /** * Filter the action permissions * * @param string $action The action to check * @param array $targets The array of target actions * * @return boolean true if action should be filtered out * */ protected static function filterActions(&$view, &$action, &$targets) { foreach ($targets as $target) { if (strpos($action, $view . '.' . $target) !== false || strpos($action, 'core.' . $target) !== false) { return false; break; } } return true; } /** * Check if have an json string * * @input string The json string to check * * @returns bool true on success */ public static function checkJson($string) { if (self::checkString($string)) { json_decode($string); return (json_last_error() === JSON_ERROR_NONE); } return false; } /** * Check if have an object with a length * * @input object The object to check * * @returns bool true on success */ public static function checkObject($object) { if (isset($object) && is_object($object)) { return count((array)$object) > 0; } return false; } /** * Check if have an array with a length * * @input array The array to check * * @returns bool/int number of items in array on success */ public static function checkArray($array, $removeEmptyString = false) { if (isset($array) && is_array($array) && ($nr = count((array)$array)) > 0) { // also make sure the empty strings are removed if ($removeEmptyString) { foreach ($array as $key => $string) { if (empty($string)) { unset($array[$key]); } } return self::checkArray($array, false); } return $nr; } return false; } /** * Check if have a string with a length * * @input string The string to check * * @returns bool true on success */ public static function checkString($string) { if (isset($string) && is_string($string) && strlen($string) > 0) { return true; } return false; } /** * Check if we are connected * Thanks https://stackoverflow.com/a/4860432/1429677 * * @returns bool true on success */ public static function isConnected() { // If example.com is down, then probably the whole internet is down, since IANA maintains the domain. Right? $connected = @fsockopen("www.example.com", 80); // website, port (try 80 or 443) if ($connected) { //action when connected $is_conn = true; fclose($connected); } else { //action in connection failure $is_conn = false; } return $is_conn; } /** * Merge an array of array's * * @input array The arrays you would like to merge * * @returns array on success */ public static function mergeArrays($arrays) { if(self::checkArray($arrays)) { $arrayBuket = array(); foreach ($arrays as $array) { if (self::checkArray($array)) { $arrayBuket = array_merge($arrayBuket, $array); } } return $arrayBuket; } return false; } // typo sorry! public static function sorten($string, $length = 40, $addTip = true) { return self::shorten($string, $length, $addTip); } /** * Shorten a string * * @input string The you would like to shorten * * @returns string on success */ public static function shorten($string, $length = 40, $addTip = true) { if (self::checkString($string)) { $initial = strlen($string); $words = preg_split('/([\s\n\r]+)/', $string, null, PREG_SPLIT_DELIM_CAPTURE); $words_count = count((array)$words); $word_length = 0; $last_word = 0; for (; $last_word < $words_count; ++$last_word) { $word_length += strlen($words[$last_word]); if ($word_length > $length) { break; } } $newString = implode(array_slice($words, 0, $last_word)); $final = strlen($newString); if ($initial != $final && $addTip) { $title = self::shorten($string, 400 , false); return ''.trim($newString).'...'; } elseif ($initial != $final && !$addTip) { return trim($newString).'...'; } } return $string; } /** * Making strings safe (various ways) * * @input string The you would like to make safe * * @returns string on success */ public static function safeString($string, $type = 'L', $spacer = '_', $replaceNumbers = true, $keepOnlyCharacters = true) { if ($replaceNumbers === true) { // remove all numbers and replace with english text version (works well only up to millions) $string = self::replaceNumbers($string); } // 0nly continue if we have a string if (self::checkString($string)) { // create file name without the extention that is safe if ($type === 'filename') { // make sure VDM is not in the string $string = str_replace('VDM', 'vDm', $string); // Remove anything which isn't a word, whitespace, number // or any of the following caracters -_() // If you don't need to handle multi-byte characters // you can use preg_replace rather than mb_ereg_replace // Thanks @Łukasz Rysiak! // $string = mb_ereg_replace("([^\w\s\d\-_\(\)])", '', $string); $string = preg_replace("([^\w\s\d\-_\(\)])", '', $string); // http://stackoverflow.com/a/2021729/1429677 return preg_replace('/\s+/', ' ', $string); } // remove all other characters $string = trim($string); $string = preg_replace('/'.$spacer.'+/', ' ', $string); $string = preg_replace('/\s+/', ' ', $string); // Transliterate string $string = self::transliterate($string); // remove all and keep only characters if ($keepOnlyCharacters) { $string = preg_replace("/[^A-Za-z ]/", '', $string); } // keep both numbers and characters else { $string = preg_replace("/[^A-Za-z0-9 ]/", '', $string); } // select final adaptations if ($type === 'L' || $type === 'strtolower') { // replace white space with underscore $string = preg_replace('/\s+/', $spacer, $string); // default is to return lower return strtolower($string); } elseif ($type === 'W') { // return a string with all first letter of each word uppercase(no undersocre) return ucwords(strtolower($string)); } elseif ($type === 'w' || $type === 'word') { // return a string with all lowercase(no undersocre) return strtolower($string); } elseif ($type === 'Ww' || $type === 'Word') { // return a string with first letter of the first word uppercase and all the rest lowercase(no undersocre) return ucfirst(strtolower($string)); } elseif ($type === 'WW' || $type === 'WORD') { // return a string with all the uppercase(no undersocre) return strtoupper($string); } elseif ($type === 'U' || $type === 'strtoupper') { // replace white space with underscore $string = preg_replace('/\s+/', $spacer, $string); // return all upper return strtoupper($string); } elseif ($type === 'F' || $type === 'ucfirst') { // replace white space with underscore $string = preg_replace('/\s+/', $spacer, $string); // return with first caracter to upper return ucfirst(strtolower($string)); } elseif ($type === 'cA' || $type === 'cAmel' || $type === 'camelcase') { // convert all words to first letter uppercase $string = ucwords(strtolower($string)); // remove white space $string = preg_replace('/\s+/', '', $string); // now return first letter lowercase return lcfirst($string); } // return string return $string; } // not a string return ''; } public static function transliterate($string) { // set tag only once if (!self::checkString(self::$langTag)) { // get global value self::$langTag = JComponentHelper::getParams('com_extensiondistributor')->get('language', 'en-GB'); } // Transliterate on the language requested $lang = Language::getInstance(self::$langTag); return $lang->transliterate($string); } public static function htmlEscape($var, $charset = 'UTF-8', $shorten = false, $length = 40) { if (self::checkString($var)) { $filter = new JFilterInput(); $string = $filter->clean(html_entity_decode(htmlentities($var, ENT_COMPAT, $charset)), 'HTML'); if ($shorten) { return self::shorten($string,$length); } return $string; } else { return ''; } } public static function replaceNumbers($string) { // set numbers array $numbers = array(); // first get all numbers preg_match_all('!\d+!', $string, $numbers); // check if we have any numbers if (isset($numbers[0]) && self::checkArray($numbers[0])) { foreach ($numbers[0] as $number) { $searchReplace[$number] = self::numberToString((int)$number); } // now replace numbers in string $string = str_replace(array_keys($searchReplace), array_values($searchReplace),$string); // check if we missed any, strange if we did. return self::replaceNumbers($string); } // return the string with no numbers remaining. return $string; } /** * Convert an integer into an English word string * Thanks to Tom Nicholson * * @input an int * @returns a string */ public static function numberToString($x) { $nwords = array( "zero", "one", "two", "three", "four", "five", "six", "seven", "eight", "nine", "ten", "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen", "nineteen", "twenty", 30 => "thirty", 40 => "forty", 50 => "fifty", 60 => "sixty", 70 => "seventy", 80 => "eighty", 90 => "ninety" ); if(!is_numeric($x)) { $w = $x; } elseif(fmod($x, 1) != 0) { $w = $x; } else { if($x < 0) { $w = 'minus '; $x = -$x; } else { $w = ''; // ... now $x is a non-negative integer. } if($x < 21) // 0 to 20 { $w .= $nwords[$x]; } elseif($x < 100) // 21 to 99 { $w .= $nwords[10 * floor($x/10)]; $r = fmod($x, 10); if($r > 0) { $w .= ' '. $nwords[$r]; } } elseif($x < 1000) // 100 to 999 { $w .= $nwords[floor($x/100)] .' hundred'; $r = fmod($x, 100); if($r > 0) { $w .= ' and '. self::numberToString($r); } } elseif($x < 1000000) // 1000 to 999999 { $w .= self::numberToString(floor($x/1000)) .' thousand'; $r = fmod($x, 1000); if($r > 0) { $w .= ' '; if($r < 100) { $w .= 'and '; } $w .= self::numberToString($r); } } else // millions { $w .= self::numberToString(floor($x/1000000)) .' million'; $r = fmod($x, 1000000); if($r > 0) { $w .= ' '; if($r < 100) { $w .= 'and '; } $w .= self::numberToString($r); } } } return $w; } /** * Random Key * * @returns a string */ public static function randomkey($size) { $bag = "abcefghijknopqrstuwxyzABCDDEFGHIJKLLMMNOPQRSTUVVWXYZabcddefghijkllmmnopqrstuvvwxyzABCEFGHIJKNOPQRSTUWXYZ"; $key = array(); $bagsize = strlen($bag) - 1; for ($i = 0; $i < $size; $i++) { $get = rand(0, $bagsize); $key[] = $bag[$get]; } return implode($key); } }