Your IP : 216.73.217.68
home/wuectly/www/media/fef/fef.php 0000604 00000034444 15245570366 0013126 0 ustar 00 <?php
/**
* Akeeba Frontend Framework (FEF)
*
* @package fef
* @copyright (c) 2017-2022 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
// Protect from unauthorized access
use Joomla\CMS\Document\PreloadManagerInterface;
use Joomla\CMS\Factory;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Uri\Uri;
use Joomla\Utilities\ArrayHelper;
defined('_JEXEC') || die();
if (@file_exists(__DIR__ . '/version.php') && @is_file(__DIR__ . '/version.php') && @is_readable(__DIR__ . '/version.php'))
{
@include_once(__DIR__ . '/version.php');
}
if (!defined('AKEEBAFEF_VERSION'))
{
define('AKEEBAFEF_VERSION', 'dev');
define('AKEEBAFEF_DATE', gmdate('Y-m-d'));
}
class AkeebaFEFHelper
{
/**
* Media versioning tag
*
* @var string
* @since 1.0.3
*/
public static $tag = null;
/**
* The Akeeba FEF Loader object
*
* @var AkeebaFEFLoader
* @since 2.0.0
*/
private static $loader;
/**
* Is this Joomla 4?
*
* @var bool|null
* @since 2.0.0
*/
private static $isJoomla4 = null;
/**
* Loads the Akeeba Frontend Framework, both CSS and JS
*
* @param bool $withReset Should I also load the CSS reset for the FEF container?
* @param bool $dark Include Dark Mode CSS?
*
* @return void
* @since 1.0.3
*/
public static function load(bool $withReset = true, bool $dark = false)
{
self::loadCSSFramework();
self::loadJSFramework();
}
/**
* Loads the Akeeba FEF CSS Framework
*
* @param bool $withReset Should I also load the CSS reset for the FEF container?
* @param bool $dark Include Dark Mode CSS?
*
* @return void
* @since 1.0.3
*/
public static function loadCSSFramework(bool $withReset = true, bool $dark = false)
{
self::getLoader()->loadCSSFramework($withReset, $dark);
}
/**
* Loads the Akeeba FEF JavaScript Framework
*
* @param bool $minimal Should I load the minimal framework (without optional features linked to FEF CSS?)
*
* @return void
* @since 2.0.0
*/
public static function loadJSFramework(bool $minimal = false)
{
self::getLoader()->loadJSFramework($minimal);
}
/**
* Legacy (FEF 1.1.x) alias to loadFEFScript.
*
* @param string $name
*
* @see self::loadFEFScript
* @deprecated 3.0
* @since 1.1.0
*/
public static function loadScript(string $name): void
{
self::loadFEFScript($name, true);
}
/**
* Load an Akeeba FEF JavaScript file and its dependencies.
*
* @param string $name The basename of the file, e.g. "Tabs"
* @param bool $defer Should I defer loading of the file?
*
* @since 2.0.0
*/
public static function loadFEFScript(string $name, bool $defer = true): void
{
self::getLoader()->loadFEFScript($name, $defer);
}
/**
* Is this Joomla 4 or later?
*
* @return bool
* @since 2.0.0
*/
private static function isJoomla4(): bool
{
if (!is_bool(self::$isJoomla4))
{
self::$isJoomla4 = version_compare(JVERSION, '3.999.999', 'gt');
}
return self::$isJoomla4;
}
/**
* Load a JavaScript file using the Joomla! API.
*
* Special considerations:
*
* We always load the minified version of the file. Joomla! will automatically use the non-minified one if Debug
* Site is enabled.
*
* You can have browser-specific files, e.g. foo_firefox.min.js, foo_firefox_57.min.js etc. These are loaded
* automatically instead of the foo.js file as needed.
*
* This method goes through Joomla's script loader, thus allowing template media overrides. The media overrides are
* supposed to be in the templates/YOUR_TEMPLATE/js/fef folder for FEF.
*
* @param string $name The Joomla!-coded path of the file, e.g. 'foo/bar.min.js' for the JavaScript file
* media/foo/js/bar.min.js
*
* @param bool $defer Should I load the script defered?
*
* @return void
* @since 1.0.3
*/
private static function loadJS(string $name, bool $defer = true): void
{
$options = [
'version' => self::getMediaVersion(),
'relative' => true,
'detectDebug' => false,
'framework' => false,
'pathOnly' => false,
'detectBrowser' => true,
];
HTMLHelper::_('script', 'fef/' . $name . '.min.js', $options, [
'defer' => $defer,
'async' => false,
]);
/**
* Preload the static resource we are definitely asking the browser to use for better performance.
*
* Yes, this is also useful for deferred scripts! On Joomla 4 this goes through Preload Manager which does an
* HTTP/2 Push for the script files. This is **far** faster than the browser making a number of HEAD requests
* to see if the scripts are cached then an equal (or smaller) number of GET requests to fetch the scripts.
*/
$options['pathOnly'] = 'true';
$path = HTMLHelper::_('script', 'fef/' . $name . '.min.js', $options);
if (empty($path))
{
return;
}
self::preloadResource($path . '?' . self::getMediaVersion(), ['as' => 'script']);
}
/**
* Load a CSS file using the Joomla! API.
*
* Special considerations:
*
* We always as Joomla to load the minified version of a file. Joomla! will automatically use the non-minified one
* if Debug Site is enabled.
*
* You can have browser-specific files, e.g. foo_firefox.min.css, foo_firefox_57.min.css etc. These are loaded
* automatically instead of the foo.css file as needed.
*
* This method goes through Joomla's script loader, thus allowing template media overrides. The media overrides are
* supposed to be in the templates/YOUR_TEMPLATE/css/fef folder for FEF.
*
* We are instructing the browser to preload the CSS file we are inserting in the HTML. This can cause a small
* performance increase. On Joomla 4 the increase is most noticeable because we go through the Preload Manager
* which can leverage HTTP/2 Push.
*
* When loading the main CSS file (joomla-fef) we preload the WOFF font files which will be most likely used by the
* browser consuming the CSS. This allows the browser to fetch the font files before fully parsing the stylesheet,
* saving some time.
*
* @param string $name The Joomla!-coded path of the file, e.g. 'foo/bar.min.css' for the stylesheet file
* media/foo/css/bar.min.css
*
* @return void
* @since 1.0.3
*/
private static function loadCSS(string $name): void
{
/**
* IMPORTANT! The $attribs (final parameter) MUST ALWAYS be non-empty. Otherwise Joomla! 3.x bugs out.
*/
$options = [
'version' => self::getMediaVersion(),
'relative' => true,
'detectDebug' => false,
'pathOnly' => false,
'detectBrowser' => true,
];
HTMLHelper::_('stylesheet', 'fef/' . $name . '.min.css', $options, [
'type' => 'text/css',
]);
// Preload the static resource we are definitely asking the browser to use for better performance
$options['pathOnly'] = 'true';
$path = HTMLHelper::_('stylesheet', 'fef/' . $name . '.min.css', $options, [
'type' => 'text/css',
]);
if (empty($path))
{
return;
}
self::preloadResource($path . '?' . self::getMediaVersion(), ['as' => 'style']);
// Special case: loading the fef-joomla stylesheet. Preload the font files as well
if ($name == 'fef-joomla')
{
$fontPath = dirname(dirname($path)) . '/fonts/akeeba/Akeeba-Products.woff';
self::preloadResource($fontPath, ['as' => 'font', 'crossorigin' => 'anonymous']);
$fontPath = dirname(dirname($path)) . '/fonts/Ionicon/ionicons.woff';
self::preloadResource($fontPath, ['as' => 'font', 'crossorigin' => 'anonymous']);
}
}
/**
* Preload a resource.
*
* On Joomla 3 this adds a LINK tag to the HTML document, instructing the browser to preload the resource.
*
* On Joomla 4 we are using the document object's Preload Manager to leverage HTTP/2 Push if available.
*
* @param string $url The absolute or relative URL of the resource to preload.
* @param array $options Preload options. You need to specify 'as' as the bare minimum.
*
* @return void
* @see https://developer.mozilla.org/en-US/docs/Web/HTML/Preloading_content
*
* @since 2.0.0
*/
private static function preloadResource(string $url, array $options): void
{
if (!self::isJoomla4() || !self::preloadResourceJoomla4($url, $options))
{
self::preloadResourceJoomla3($url, $options);
}
}
/**
* Preload a resource on Joomla 3.
*
* This adds a LINK tag to the HTML document, instructing the browser to preload the resource.
*
* @param string $url The absolute or relative URL of the resource to preload.
* @param array $options Preload options. You need to specify 'as' as the bare minimum.
*
* @return bool True if successful; false if we can't get the document, or can't add a LINK tag e.g. this is not
* an HTMLDocument
* @since 2.0.0
*/
private static function preloadResourceJoomla3(string $url, array $options): bool
{
// Try to get Joomla's document object
$document = self::getDocument();
// Make sure the document object implements addCustomTag
if (!is_object($document) || !method_exists($document, 'addCustomTag'))
{
return false;
}
$options['rel'] = 'preload';
$options['href'] = self::relativeToAbsoluteURL($url);
$document->addCustomTag('<link ' . ArrayHelper::toString($options) . '>');
return true;
}
/**
* Preload a resource on Joomla 4.
*
* We are using the document object's Preload Manager to leverage HTTP/2 Push if available.
*
* @param string $url The absolute or relative URL of the resource to preload.
* @param array $options Preload options. You need to specify 'as' as the bare minimum.
*
* @return bool True if successful; false if we can't get the document, or can't add a LINK tag e.g. this is not
* an HTMLDocument
* @since 2.0.0
*/
private static function preloadResourceJoomla4(string $url, array $options): bool
{
// Make sure we're in a version of Joomla which has support for the Preload Manager
if (!interface_exists('\\Joomla\CMS\Document\PreloadManagerInterface'))
{
return false;
}
// Try to get Joomla's document object
$document = self::getDocument();
// Make sure the document object implements getPreloadManager
if (!is_object($document) || !method_exists($document, 'getPreloadManager'))
{
return false;
}
// Try to get the preload manager
try
{
$preloadManager = $document->getPreloadManager();
}
catch (Throwable $e)
{
return false;
}
// Make sure the preload manager is an object implementing the PreloadManagerInterface
if (!is_object($preloadManager) || !($preloadManager instanceof PreloadManagerInterface))
{
return false;
}
$absoluteUrl = self::relativeToAbsoluteURL($url);
$preloadManager->preload($absoluteUrl, $options);
return true;
}
/**
* Get the Joomla document object
*
* @return JDocument|\Joomla\CMS\Document\Document|null NULL if we can't retrieve the document object.
*
* @since 2.0.0
*/
private static function getDocument()
{
// Get the CMS application
try
{
$app = Factory::getApplication();
}
catch (Throwable $e)
{
return null;
}
// Make sure it's an object implementing getDocument
if (!is_object($app) || !method_exists($app, 'getDocument'))
{
return null;
}
// Try to get the document
try
{
$document = $app->getDocument();
}
catch (Throwable $e)
{
return null;
}
return $document;
}
/**
* Convert a relative URL to an absolute URL for the current site
*
* @param string $url The possibly relative URL.
*
* @return string The definitely absolute URL.
*
* @since 2.0.0
*/
private static function relativeToAbsoluteURL(string $url): string
{
static $baseUri;
static $basePath;
// Get the base URI, e.g. 'https://localhost/test'
if (empty($baseUri))
{
$baseUri = $baseUri ?? Uri::base();
if (substr($baseUri, -15) === '/administrator/')
{
$baseUri = substr($baseUri, 0, -15);
}
elseif (substr($baseUri, -14) === '/administrator')
{
$baseUri = substr($baseUri, 0, -14);
}
}
// Get the base path, e.g. 'test'
if (empty($basePath))
{
$basePath = $basePath ?? Uri::base(true);
$basePath = empty($basePath) ? '' : trim($basePath, '/');
if ($basePath === 'administrator')
{
$basePath = '';
}
elseif (substr($basePath, -14) == '/administrator')
{
$basePath = trim(substr($basePath, 0, -14), '/');
}
}
if ((substr($url, 0, 2) == '//') ||
(substr($url, 0, 7) == 'http://') ||
(substr($url, 0, 8) == 'https://') ||
(substr($url, 0, strlen($baseUri)) == $baseUri))
{
return $url;
}
$url = ltrim($url, '/');
if ((strlen($basePath) != 0) && (substr($url, 0, strlen($basePath)) === $basePath))
{
$url = ltrim(substr($url, strlen($basePath)), '/');
$url = ltrim($url, '/');
}
return rtrim($baseUri, '/') . '/' . $url;
}
/**
* Get the media versioning tag. If it's not set, create one first.
*
* @return string
* @since 1.1.0
*/
private static function getMediaVersion(): string
{
if (empty(self::$tag))
{
self::$tag = md5(AKEEBAFEF_VERSION . AKEEBAFEF_DATE . self::getApplicationSecret());
}
return self::$tag;
}
/**
* Return the secret key for the Joomla! installation. Falls back to an MD5 of our file mod time.
*
* @return string
* @since 1.1.0
*/
private static function getApplicationSecret(): string
{
$secret = md5(filemtime(__FILE__));
// Get the site's secret
try
{
$app = Factory::getApplication();
if (method_exists($app, 'get'))
{
return $app->get('secret', $secret);
}
}
catch (Exception $e)
{
}
return $secret;
}
/**
* Returns or creates the Akeeba FEF Loader object.
*
* IMPORTANT: DO NOT SET A RETURN VALUE TYPE HINT. The AkeebaFEFLoader class is undefined until we load it in this
* method. This causes a chicken and egg problem which results in a Fatal Error!
*
* @return AkeebaFEFLoader
* @since 2.0.0
*/
private static function getLoader()
{
if (!is_null(self::$loader))
{
return self::$loader;
}
if (!class_exists('AkeebaFEFLoader'))
{
require_once __DIR__ . '/php/AkeebaFEFLoader.php';
}
self::$loader = new AkeebaFEFLoader(function (string $name) {
self::loadCSS($name);
}, function (string $name, bool $defer) {
self::loadJS($name, $defer);
}, 'joomla');
return self::$loader;
}
}
home/wuectly/www/administrator/components/com_akeeba/View/fef.php 0000604 00000003071 15245662762 0021326 0 ustar 00 <?php
/**
* @package akeebabackup
* @copyright Copyright (c)2006-2021 Nicholas K. Dionysopoulos / Akeeba Ltd
* @license GNU General Public License version 3, or later
*/
// Protect from unauthorized access
defined('_JEXEC') or die();
?>
<div style="margin: 1em">
<h1>Akeeba Frontend Framework (FEF) could not be found on this site</h1>
<hr/>
<div class="alert alert-warning">
<h2>
This component requires the Akeeba Frontend Framework (FEF) to be installed on your site. Please go to <a
href="https://www.akeeba.com/download/official/fef.html">our download page</a> to download it, then install it on your site.
</h2>
</div>
<hr/>
<h4>Further information</h4>
<p>
FEF is the name of our custom CSS framework. It's responsible for rendering the interface of our Joomla!
extensions. It is automatically installed when you install our extensions on your site.
</p>
<p>
FEF can be missing from your site either because Joomla failed to install it or because you, another Super User,
or another extension mistakenly uninstalled it.
</p>
<p>
If it's missing we cannot display the interface to this component. That's why you see this message.
</p>
<p>
You do not have to worry about adding bloat to your site. FEF is very small. It will also be automatically
uninstalled when you uninstall all components which depend on it.
</p>
<p>
FEF is installed in the <code>media/fef</code> folder under your site's root. It appears in Joomla's Extensions,
Manage page as <code>file_fef</code>. Please do not remove it from your site.
</p>
</div>