GXModuleCenterModuleController
extends AbstractModuleCenterModuleController
in package
Class GXModuleCenterModuleController
Tags
Table of Contents
- $assets : AssetCollectionInterface
- $buttons : array<string|int, mixed>
- $configurationStorage : GXModuleConfigurationStorage
- Configuration storage.
- $contentView : ContentViewInterface
- $httpContextReader : HttpContextReaderInterface
- $httpResponseProcessor : HttpResponseProcessorInterface
- $languageTextManager : LanguageTextManager
- $modules : array<string|int, mixed>
- Holds json data for all modules
- $pageTitle : string
- $postDataArray : array<string|int, mixed>
- $queryParametersArray : array<string|int, mixed>
- $redirectUrl : string
- $sectionsGrid : array<string|int, mixed>
- $serverDataArray : array<string|int, mixed>
- $userConfigurationService : object
- $languageProvider : mixed
- __construct() : mixed
- actionDefault() : HttpControllerResponse
- Returns an AdminLayoutHttpControllerResponse with configuration options or returns a RedirectHttpControllerResponse with specified redirect url.
- actionSaveConfiguration() : RedirectHttpControllerResponse
- Saves the configuration.
- proceed() : mixed
- Processes a http response object which is get by invoking an action method.
- validateCurrentAdminStatus() : mixed
- Makes sure that the admin status is currently given in session
- _callActionMethod() : HttpControllerResponseInterface
- Invokes an action method by the given action name.
- _callUserMethod() : mixed
- Call the method from the controller
- _getAssets() : AssetCollection|bool
- _getGXModuleJSONConfiguration() : array<string|int, mixed>|bool
- Get the json configuration from GXModule.json file
- _getPostData() : string|null
- Returns the expected $_POST value by the given key name.
- _getPostDataCollection() : KeyValueCollection
- Creates and returns a key value collection which represent the global $_POST array.
- _getQueryParameter() : mixed|null
- Returns the expected $_GET value by the given key name.
- _getQueryParametersCollection() : KeyValueCollection
- Creates and returns a key value collection which represent the global $_GET array.
- _getSaveHookData() : array<string|int, mixed>|null
- Returns the after-save hook data from the GXModules config JSON file.
- _getSectionsGridWidth() : array<string|int, mixed>
- Calculate total activated languages & return columns width for label & flags grids in the dashboard configurations
- _getServerData() : string|null
- Returns the expected $_SERVER value by the given key name.
- _init() : mixed
- Initialize the module e.g. set title, description, sort order etc.
- _render() : string
- Renders and returns a template file.
- _validatePageToken() : mixed
- Check if the $_POST['pageToken'] or $_GET['pageToken'] variable is provided and if it's valid.
- getTemplateFile() : ExistingFile
- Searches the GXModules directory and admin/html directory for a template file, wich can be useed inside the AdminLayoutHttpControllerResponse object for the template parameter.
- getText() : string
- Returns the translated text for the given section phrase selector (i.e. "buttons.ok" results in "Ok")
- initConfiguration() : mixed
- Loads the configuration from db for specific module
- isValidJson() : bool
- isValidRequestMethod() : bool
- prepareJsonInput() : array<string|int, mixed>
- process_uploads() : mixed
- Processing the uploaded files
- getLanguageProvider() : mixed
Properties
$assets
protected
AssetCollectionInterface
$assets
$buttons
protected
array<string|int, mixed>
$buttons
= []
$configurationStorage
Configuration storage.
protected
GXModuleConfigurationStorage
$configurationStorage
$contentView
protected
ContentViewInterface
$contentView
$httpContextReader
protected
HttpContextReaderInterface
$httpContextReader
$httpResponseProcessor
protected
HttpResponseProcessorInterface
$httpResponseProcessor
$languageTextManager
protected
LanguageTextManager
$languageTextManager
$modules
Holds json data for all modules
protected
array<string|int, mixed>
$modules
= []
$pageTitle
protected
string
$pageTitle
= ''
$postDataArray
protected
array<string|int, mixed>
$postDataArray
$queryParametersArray
protected
array<string|int, mixed>
$queryParametersArray
$redirectUrl
protected
string
$redirectUrl
= ''
$sectionsGrid
protected
array<string|int, mixed>
$sectionsGrid
= []
$serverDataArray
protected
array<string|int, mixed>
$serverDataArray
$userConfigurationService
protected
object
$userConfigurationService
$languageProvider
private
mixed
$languageProvider
Methods
__construct()
public
__construct(HttpContextReaderInterface $httpContextReader, HttpResponseProcessorInterface $httpResponseProcessor, ContentViewInterface $defaultContentView) : mixed
Parameters
- $httpContextReader : HttpContextReaderInterface
- $httpResponseProcessor : HttpResponseProcessorInterface
- $defaultContentView : ContentViewInterface
Return values
mixed —actionDefault()
Returns an AdminLayoutHttpControllerResponse with configuration options or returns a RedirectHttpControllerResponse with specified redirect url.
public
actionDefault() : HttpControllerResponse
Return values
HttpControllerResponse —actionSaveConfiguration()
Saves the configuration.
public
actionSaveConfiguration() : RedirectHttpControllerResponse
Return values
RedirectHttpControllerResponse —Default page.
proceed()
Processes a http response object which is get by invoking an action method.
public
proceed(HttpContextInterface $httpContext) : mixed
The action method is determined by the http context reader instance and the current request context. Re-implement this method in child classes to enable XSS and CSRF protection on demand.
Parameters
- $httpContext : HttpContextInterface
-
Http context object which hold the request variables.
Tags
Return values
mixed —validateCurrentAdminStatus()
Makes sure that the admin status is currently given in session
public
validateCurrentAdminStatus() : mixed
Tags
Return values
mixed —_callActionMethod()
Invokes an action method by the given action name.
protected
_callActionMethod(string $actionName) : HttpControllerResponseInterface
Parameters
- $actionName : string
-
Name of action method to call, without 'action'-Suffix.
Tags
Return values
HttpControllerResponseInterface —Response message.
_callUserMethod()
Call the method from the controller
protected
_callUserMethod( $action) : mixed
Parameters
Return values
mixed —_getAssets()
protected
_getAssets() : AssetCollection|bool
Return values
AssetCollection|bool —_getGXModuleJSONConfiguration()
Get the json configuration from GXModule.json file
protected
_getGXModuleJSONConfiguration( $name) : array<string|int, mixed>|bool
Parameters
Return values
array<string|int, mixed>|bool —_getPostData()
Returns the expected $_POST value by the given key name.
protected
_getPostData(string $keyName) : string|null
This method is the object oriented layer for $_POST[$keyName].
Parameters
- $keyName : string
-
Expected key of post parameter.
Return values
string|null —Either the expected value or null, of not found.
_getPostDataCollection()
Creates and returns a key value collection which represent the global $_POST array.
protected
_getPostDataCollection() : KeyValueCollection
Return values
KeyValueCollection —_getQueryParameter()
Returns the expected $_GET value by the given key name.
protected
_getQueryParameter(string $keyName) : mixed|null
This method is the object oriented layer for $_GET[$keyName].
Parameters
- $keyName : string
-
Expected key of query parameter.
Return values
mixed|null —Either the expected value or null, of not found.
_getQueryParametersCollection()
Creates and returns a key value collection which represent the global $_GET array.
protected
_getQueryParametersCollection() : KeyValueCollection
Return values
KeyValueCollection —_getSaveHookData()
Returns the after-save hook data from the GXModules config JSON file.
protected
_getSaveHookData(string $moduleName) : array<string|int, mixed>|null
Parameters
- $moduleName : string
Return values
array<string|int, mixed>|null —_getSectionsGridWidth()
Calculate total activated languages & return columns width for label & flags grids in the dashboard configurations
protected
_getSectionsGridWidth([int $breakpoint = 8 ]) : array<string|int, mixed>
Parameters
- $breakpoint : int = 8
-
maximum languages count then it will show label & flags in separate rows
Return values
array<string|int, mixed> —[label, flag]
_getServerData()
Returns the expected $_SERVER value by the given key name.
protected
_getServerData(string $keyName) : string|null
This method is the object oriented layer for $_SERVER[$keyName].
Parameters
- $keyName : string
-
Expected key of server parameter.
Return values
string|null —Either the expected value or null, of not found.
_init()
Initialize the module e.g. set title, description, sort order etc.
protected
_init() : mixed
Function will be called in the constructor
Return values
mixed —_render()
Renders and returns a template file.
protected
_render(string $templateFile, array<string|int, mixed> $contentArray) : string
Parameters
- $templateFile : string
-
Template file to render.
- $contentArray : array<string|int, mixed>
-
Content array which represent the variables of the template.
Return values
string —Rendered template.
_validatePageToken()
Check if the $_POST['pageToken'] or $_GET['pageToken'] variable is provided and if it's valid.
protected
_validatePageToken([string $customExceptionMessage = null ]) : mixed
Example: public function proceed(HttpContextInterface $httpContext) { parent::proceed($httpContext); // proceed http context from parent class if($_SERVER['REQUEST_METHOD'] === 'POST') { $this->_validatePageToken(); // CSRF Protection } }
Parameters
- $customExceptionMessage : string = null
-
(optional) You can specify a custom exception message.
Tags
Return values
mixed —getTemplateFile()
Searches the GXModules directory and admin/html directory for a template file, wich can be useed inside the AdminLayoutHttpControllerResponse object for the template parameter.
protected
getTemplateFile(string $templateFile) : ExistingFile
Parameters
- $templateFile : string
-
The relative path and filename to search for
Tags
Return values
ExistingFile —containing absolute file path to the given template file
getText()
Returns the translated text for the given section phrase selector (i.e. "buttons.ok" results in "Ok")
protected
getText( $sectionPhraseSelector) : string
Parameters
Return values
string —initConfiguration()
Loads the configuration from db for specific module
protected
initConfiguration( $module) : mixed
Parameters
Return values
mixed —isValidJson()
protected
isValidJson(string $string) : bool
Parameters
- $string : string
Return values
bool —isValidRequestMethod()
protected
isValidRequestMethod(string $method) : bool
Parameters
- $method : string
Return values
bool —prepareJsonInput()
protected
prepareJsonInput(string $json) : array<string|int, mixed>
Parameters
- $json : string
Return values
array<string|int, mixed> —process_uploads()
Processing the uploaded files
protected
process_uploads( $data) : mixed
Parameters
Return values
mixed —getLanguageProvider()
private
getLanguageProvider() : mixed