phpDocumentor

AdminFavoritesAjaxController extends AdminHttpViewController

Class AdminFavoritesAjaxController

This class handles the ajax requests for the favorites menu box from the admin menu.

Tags
category

System

extends

AdminHttpViewController

Table of Contents

$adminFavoritesTable  : string
$assets  : AssetCollectionInterface
$contentView  : ContentViewInterface
$customerId  : int
$db  : CI_DB_query_builder
Database connection.
$httpContextReader  : HttpContextReaderInterface
$httpResponseProcessor  : HttpResponseProcessorInterface
$linkKey  : string
$postDataArray  : array<string|int, mixed>
$queryParametersArray  : array<string|int, mixed>
$serverDataArray  : array<string|int, mixed>
__construct()  : mixed
actionAddMenuItem()  : HttpControllerResponse
Callback method
actionDefault()  : HttpControllerResponse
Callback method for the default action
actionRemoveMenuItem()  : HttpControllerResponse
Callback method
init()  : mixed
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
_addMenuItemToFavorites()  : bool
Adds an entry to the favorites table.
_callActionMethod()  : HttpControllerResponseInterface
Invokes an action method by the given action name.
_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.
_getServerData()  : string|null
Returns the expected $_SERVER value by the given key name.
_isAdmin()  : bool
Check if the customer is the admin.
_removeMenuItemFromFavorites()  : bool
Removes an entry from the favorites database table.
_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.
isValidJson()  : bool
isValidRequestMethod()  : bool
prepareJsonInput()  : array<string|int, mixed>

Properties

Methods

actionAddMenuItem()

Callback method

public actionAddMenuItem() : HttpControllerResponse

This method inserts a menu item to the favorites table.

Tags
throws
InvalidArgumentException

If the link_key argument from the get request is not valid.

throws
AuthenticationException

If the customer has no admin privileges.

Return values
HttpControllerResponse

'success' if deletion was successfully else 'error'

actionRemoveMenuItem()

Callback method

public actionRemoveMenuItem() : HttpControllerResponse

This method deletes a menu item from the favorites table.

Tags
throws
InvalidArgumentException

If the link_key argument from the get request is not valid.

throws
AuthenticationException

If the customer has no admin privileges.

Return values
HttpControllerResponse

'success' if deletion was successfully else 'error'

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
throws
LogicException

When no action method is found by the http context reader.

see
HttpContextReaderInterface::getActionName
see
HttpResponseProcessorInterface::proceed
Return values
mixed

_addMenuItemToFavorites()

Adds an entry to the favorites table.

protected _addMenuItemToFavorites() : bool
Tags
throws
InvalidArgumentException

If the link key is not valid.

Return values
bool

true on success, else false will be returned.

_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.

_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.

_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.

_removeMenuItemFromFavorites()

Removes an entry from the favorites database table.

protected _removeMenuItemFromFavorites() : bool
Tags
throws
InvalidArgumentException

If the link key is not valid.

Return values
bool

true on success, else false will be returned.

_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
throws
Exception

If the validation fails.

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
throws
Exception

if the path or file is not found

Return values
ExistingFile

containing absolute file path to the given template file

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>

Search results