PHP Класс FOF30\Platform\Joomla\Platform

This implements the platform class for Joomla! 3
С версии: 2.1
Наследование: extends FOF30\Platform\Base\Platform
Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство Тип Описание
$isAdmin Is this an administrator application?
$isCLI Is this a CLI application?

Открытые методы

Метод Описание
URIbase ( boolean $pathonly = false ) : string Returns the base URI for the request.
URIroot ( boolean $pathonly = false, string $path = null ) : string Returns the root URI for the request.
authorise ( string $action, string $assetname ) : boolean Perform an ACL check.
authorizeAdmin ( string $component ) : boolean Authorise access to the component in the back-end.
checkExecution ( ) : boolean Checks if the current script is run inside a valid CMS execution
clearCache ( ) : boolean Clears the cache of system-wide F0F data. You are supposed to call this in your components' installation script post-installation and post-upgrade methods or whenever you are modifying the structure of database tables accessed by F0F. Please note that F0F's cache never expires and is not purged by Joomla!. You MUST use this method to manually purge the cache.
closeApplication ( integer $code ) : void Immediately terminate the containing application's execution
getCache ( string $key, string $default = null ) : string Retrieves data from the cache. This is supposed to be used for system-side F0F data, not application data.
getComponentBaseDirs ( string $component ) : array Returns the base (root) directories for a given component.
getConfig ( ) : JRegistry Returns an object that holds the configuration of the current site.
getDate ( mixed $time = 'now', null $tzOffest = null, boolean $locale = true ) : JDate Returns an object to handle dates
getDbo ( ) : JDatabaseDriver Returns the database driver object of the CMS/application
getDocument ( ) : JDocument Returns the JDocument object which handles this component's response.
getLanguage ( ) : JLanguage Return the \JLanguage instance of the CMS/application
getPlatformBaseDirs ( ) : array Returns absolute path to directories used by the CMS.
getTemplate ( boolean | array $params = false ) : string Returns the application's template name
getTemplateOverridePath ( string $component, boolean $absolute = true ) : string Return the absolute path to the application's template overrides directory for a specific component. We will use it to look for template files instead of the regular component directories. If the application does not have such a thing as template overrides return an empty string.
getTemplateSuffixes ( ) : array Get application-specific suffixes to use with template paths. This allows you to look for view template overrides based on the application version.
getUser ( integer $id = null ) : JUser Return a user object.
getUserStateFromRequest ( string $key, string $request, Input $input, mixed $default = null, string $type = 'none', boolean $setUserState = true ) : mixed This method will try retrieving a variable from the request (input) data.
importPlugin ( string $type ) : void Load plugins of a specific type. Obviously this seems to only be required in the Joomla! CMS.
isBackend ( ) : boolean Is this the administrative section of the component?
isCli ( ) : boolean Is this a component running in a CLI application?
isFrontend ( ) : boolean Is this the public section of the component?
isGlobalF0FCacheEnabled ( ) : boolean Is the global F0F cache enabled?
loadTranslations ( string $component ) : void Load the translation files for a given component.
logAddLogger ( string $file ) : void Add a log file for FOF
logDebug ( string $message ) : void Adds a message to the application's debug log
logDeprecated ( string $message ) : void Logs a deprecated practice. In Joomla! this results in the $message being output in the deprecated log file, found in your site's log directory.
loginUser ( array $authInfo ) : boolean logs in a user
logoutUser ( ) : boolean logs out a user
raiseError ( integer $code, string $message ) : void Raises an error, using the logic requested by the CMS (PHP Exception or dedicated class)
runPlugins ( string $event, array $data ) : array Execute plugins (system-level triggers) and fetch back an array with their return values.
sendHeaders ( ) : void In platforms that perform header caching, send all headers.
setCache ( string $key, string $content ) : boolean Saves something to the cache. This is supposed to be used for system-wide F0F data, not application data.
setHeader ( string $name, string $value, boolean $replace = false ) : void Method to set a response header. If the replace flag is set then all headers with the given name will be replaced by the new one (only if the current platform supports header caching)
supportsAjaxOrdering ( ) : boolean Is AJAX re-ordering supported? This is 100% Joomla!-CMS specific. All other platforms should return false and never ask why.

Защищенные методы

Метод Описание
isCliAdmin ( ) : array Main function to detect if we're running in a CLI environment and we're admin

Приватные методы

Метод Описание
getCacheObject ( boolean $force = false ) : JRegistry Gets a reference to the cache object, loading it from the disk if needed.
saveCache ( ) : boolean Save the cache object back to disk

Описание методов

URIbase() публичный Метод

Returns the base URI for the request.
public URIbase ( boolean $pathonly = false ) : string
$pathonly boolean If false, prepend the scheme, host and port information. Default is false.
Результат string The base URI string

URIroot() публичный Метод

Returns the root URI for the request.
public URIroot ( boolean $pathonly = false, string $path = null ) : string
$pathonly boolean If false, prepend the scheme, host and port information. Default is false.
$path string The path
Результат string The root URI string.

authorise() публичный Метод

Perform an ACL check.
См. также: PlatformInterface::authorise()
public authorise ( string $action, string $assetname ) : boolean
$action string The ACL privilege to check, e.g. core.edit
$assetname string The asset name to check, typically the component's name
Результат boolean True if the user is allowed this action

authorizeAdmin() публичный Метод

Authorise access to the component in the back-end.
См. также: PlatformInterface::authorizeAdmin()
public authorizeAdmin ( string $component ) : boolean
$component string The name of the component.
Результат boolean True to allow loading the component, false to halt loading

checkExecution() публичный Метод

Checks if the current script is run inside a valid CMS execution
См. также: PlatformInterface::checkExecution()
public checkExecution ( ) : boolean
Результат boolean

clearCache() публичный Метод

Clears the cache of system-wide F0F data. You are supposed to call this in your components' installation script post-installation and post-upgrade methods or whenever you are modifying the structure of database tables accessed by F0F. Please note that F0F's cache never expires and is not purged by Joomla!. You MUST use this method to manually purge the cache.
public clearCache ( ) : boolean
Результат boolean True on success

closeApplication() публичный Метод

Immediately terminate the containing application's execution
public closeApplication ( integer $code ) : void
$code integer The result code which should be returned by the application
Результат void

getCache() публичный Метод

Retrieves data from the cache. This is supposed to be used for system-side F0F data, not application data.
public getCache ( string $key, string $default = null ) : string
$key string The key of the data to retrieve
$default string The default value to return if the key is not found or the cache is not populated
Результат string The cached value

getComponentBaseDirs() публичный Метод

Returns the base (root) directories for a given component.
См. также: PlatformInterface::getComponentBaseDirs()
public getComponentBaseDirs ( string $component ) : array
$component string The name of the component. For Joomla! this is something like "com_example"
Результат array A hash array with keys main, alt, site and admin.

getConfig() публичный Метод

Returns an object that holds the configuration of the current site.
public getConfig ( ) : JRegistry
Результат JRegistry

getDate() публичный Метод

Returns an object to handle dates
public getDate ( mixed $time = 'now', null $tzOffest = null, boolean $locale = true ) : JDate
$time mixed The initial time
$tzOffest null The timezone offset
$locale boolean Should I try to load a specific class for current language?
Результат JDate object

getDbo() публичный Метод

Returns the database driver object of the CMS/application
public getDbo ( ) : JDatabaseDriver
Результат JDatabaseDriver

getDocument() публичный Метод

Returns the JDocument object which handles this component's response.
См. также: PlatformInterface::getDocument()
public getDocument ( ) : JDocument
Результат JDocument

getLanguage() публичный Метод

Return the \JLanguage instance of the CMS/application
public getLanguage ( ) : JLanguage
Результат JLanguage

getPlatformBaseDirs() публичный Метод

Returns absolute path to directories used by the CMS.
См. также: PlatformInterface::getPlatformBaseDirs()
public getPlatformBaseDirs ( ) : array
Результат array A hash array with keys root, public, admin, tmp and log.

getTemplate() публичный Метод

Returns the application's template name
public getTemplate ( boolean | array $params = false ) : string
$params boolean | array An optional associative array of configuration settings
Результат string The template name. System is the fallback.

getTemplateOverridePath() публичный Метод

Return the absolute path to the application's template overrides directory for a specific component. We will use it to look for template files instead of the regular component directories. If the application does not have such a thing as template overrides return an empty string.
public getTemplateOverridePath ( string $component, boolean $absolute = true ) : string
$component string The name of the component for which to fetch the overrides
$absolute boolean Should I return an absolute or relative path?
Результат string The path to the template overrides directory

getTemplateSuffixes() публичный Метод

Get application-specific suffixes to use with template paths. This allows you to look for view template overrides based on the application version.
public getTemplateSuffixes ( ) : array
Результат array A plain array of suffixes to try in template names

getUser() публичный Метод

Return a user object.
См. также: PlatformInterface::getUser()
public getUser ( integer $id = null ) : JUser
$id integer The user ID to load. Skip or use null to retrieve the object for the currently logged in user.
Результат JUser The JUser object for the specified user

getUserStateFromRequest() публичный Метод

This method will try retrieving a variable from the request (input) data.
См. также: PlatformInterface::getUserStateFromRequest()
public getUserStateFromRequest ( string $key, string $request, Input $input, mixed $default = null, string $type = 'none', boolean $setUserState = true ) : mixed
$key string The user state key for the variable
$request string The request variable name for the variable
$input FOF30\Input\Input The Input object with the request (input) data
$default mixed The default value. Default: null
$type string The filter type for the variable data. Default: none (no filtering)
$setUserState boolean Should I set the user state with the fetched value?
Результат mixed The value of the variable

importPlugin() публичный Метод

Load plugins of a specific type. Obviously this seems to only be required in the Joomla! CMS.
См. также: PlatformInterface::importPlugin()
public importPlugin ( string $type ) : void
$type string The type of the plugins to be loaded
Результат void

isBackend() публичный Метод

Is this the administrative section of the component?
См. также: PlatformInterface::isBackend()
public isBackend ( ) : boolean
Результат boolean

isCli() публичный Метод

Is this a component running in a CLI application?
См. также: PlatformInterface::isCli()
public isCli ( ) : boolean
Результат boolean

isCliAdmin() защищенный Метод

Main function to detect if we're running in a CLI environment and we're admin
protected isCliAdmin ( ) : array
Результат array isCLI and isAdmin. It's not an associative array, so we can use list.

isFrontend() публичный Метод

Is this the public section of the component?
См. также: PlatformInterface::isFrontend()
public isFrontend ( ) : boolean
Результат boolean

isGlobalF0FCacheEnabled() публичный Метод

Is the global F0F cache enabled?
public isGlobalF0FCacheEnabled ( ) : boolean
Результат boolean

loadTranslations() публичный Метод

Load the translation files for a given component.
См. также: PlatformInterface::loadTranslations()
public loadTranslations ( string $component ) : void
$component string The name of the component. For Joomla! this is something like "com_example"
Результат void

logAddLogger() публичный Метод

Add a log file for FOF
public logAddLogger ( string $file ) : void
$file string
Результат void

logDebug() публичный Метод

Adds a message to the application's debug log
public logDebug ( string $message ) : void
$message string
Результат void

logDeprecated() публичный Метод

Logs a deprecated practice. In Joomla! this results in the $message being output in the deprecated log file, found in your site's log directory.
public logDeprecated ( string $message ) : void
$message string The deprecated practice log message
Результат void

loginUser() публичный Метод

logs in a user
public loginUser ( array $authInfo ) : boolean
$authInfo array authentification information
Результат boolean True on success

logoutUser() публичный Метод

logs out a user
public logoutUser ( ) : boolean
Результат boolean True on success

raiseError() публичный Метод

Raises an error, using the logic requested by the CMS (PHP Exception or dedicated class)
public raiseError ( integer $code, string $message ) : void
$code integer
$message string
Результат void

runPlugins() публичный Метод

Execute plugins (system-level triggers) and fetch back an array with their return values.
См. также: PlatformInterface::runPlugins()
public runPlugins ( string $event, array $data ) : array
$event string The event (trigger) name, e.g. onBeforeScratchMyEar
$data array A hash array of data sent to the plugins as part of the trigger
Результат array A simple array containing the results of the plugins triggered

sendHeaders() публичный Метод

In platforms that perform header caching, send all headers.
public sendHeaders ( ) : void
Результат void

setCache() публичный Метод

Saves something to the cache. This is supposed to be used for system-wide F0F data, not application data.
public setCache ( string $key, string $content ) : boolean
$key string The key of the data to save
$content string The actual data to save
Результат boolean True on success

setHeader() публичный Метод

Method to set a response header. If the replace flag is set then all headers with the given name will be replaced by the new one (only if the current platform supports header caching)
public setHeader ( string $name, string $value, boolean $replace = false ) : void
$name string The name of the header to set.
$value string The value of the header to set.
$replace boolean True to replace any headers with the same name.
Результат void

supportsAjaxOrdering() публичный Метод

Is AJAX re-ordering supported? This is 100% Joomla!-CMS specific. All other platforms should return false and never ask why.
См. также: PlatformInterface::supportsAjaxOrdering()
public supportsAjaxOrdering ( ) : boolean
Результат boolean

Описание свойств

$isAdmin защищенное статическое свойство

Is this an administrator application?
protected static $isAdmin

$isCLI защищенное статическое свойство

Is this a CLI application?
protected static $isCLI