Class ilCtrlContext is responsible for holding the current context information. More...

Inheritance diagram for ilCtrlContext:

Collaboration diagram for ilCtrlContext:

Public Member Functions
	__construct (ilCtrlPathFactory $path_factory, RequestWrapper $request_wrapper, Refinery $refinery)
	ilCtrlContext Constructor More...

	isAsync ()
	@inheritDoc More...

	getRedirectSource ()
	@inheritDoc More...

	getPath ()
	@inheritDoc More...

	setCmdMode (string $mode)
	@inheritDoc More...

	getCmdMode ()
	@inheritDoc More...

	setBaseClass (string $base_class)
	@inheritDoc More...

	getBaseClass ()
	@inheritDoc More...

	setTargetScript (string $target_script)
	@inheritDoc More...

	getTargetScript ()
	@inheritDoc More...

	setCmdClass (?string $cmd_class)
	@inheritDoc More...

	getCmdClass ()
	@inheritDoc More...

	setCmd (?string $cmd)
	@inheritDoc More...

	getCmd ()
	@inheritDoc More...

	setObjType (string $obj_type)
	@inheritDoc More...

	getObjType ()
	@inheritDoc More...

	setObjId (int $obj_id)
	@inheritDoc More...

	getObjId ()
	@inheritDoc More...

	isAsync ()
	Returns whether this context is asynchronous or not. More...

	getRedirectSource ()
	Returns where the request of this context was redirected from. More...

	getPath ()
	Returns the path of this context. More...

	setCmdMode (string $mode)
	Sets the command mode of the current context. More...

	getCmdMode ()
	Returns the command mode of the current context. More...

	setBaseClass (string $base_class)
	Sets the baseclass of the current context. More...

	getBaseClass ()
	Returns the baseclass the current context. More...

	setTargetScript (string $target_script)
	Sets the target script of this context (usually ilias.php). More...

	getTargetScript ()
	Returns the target script of this context. More...

	setCmdClass (?string $cmd_class)
	Sets the current contexts command class. More...

	getCmdClass ()
	Returns the command class of this context. More...

	setCmd (?string $cmd)
	Sets the command which the current command- or baseclass should perform. More...

	getCmd ()
	Returns the command which the current command- or baseclass should perform. More...

	setObjType (string $obj_type)
	Sets the object type of the current context. More...

	getObjType ()
	Returns the object type of the current context. More...

	setObjId (int $obj_id)
	Sets the object id of the current context. More...

	getObjId ()
	Returns the object id of the current context. More...

Protected Member Functions
	adoptRequestParameters ()
	Adopts context properties from the according ones delivered by the current request. More...

	getQueryParam (string $parameter_name)
	Helper function to retrieve request parameter values by name. More...

Protected Attributes
ilCtrlPathFactory	$path_factory

RequestWrapper	$request_wrapper

Refinery	$refinery

ilCtrlPathInterface	$path

bool	$is_async = false

string	$target_script = 'ilias.php'

string	$cmd_mode = null

string	$redirect = null

string	$base_class = null

string	$cmd_class = null

string	$cmd = null

string	$obj_type = null

int	$obj_id = null

Detailed Description

Class ilCtrlContext is responsible for holding the current context information.

Author: Thibeau Fuhrer thf@s.nosp@m.tude.nosp@m.r-rai.nosp@m.mann.nosp@m..ch @noinspection AutoloadingIssuesInspection

Definition at line 31 of file class.ilCtrlContext.php.

Constructor & Destructor Documentation

◆ __construct()

ilCtrlContext::__construct	(	ilCtrlPathFactory	$path_factory,
		RequestWrapper	$request_wrapper,
		Refinery	$refinery
	)

ilCtrlContext Constructor

Parameters

ilCtrlPathFactory	$path_factory
RequestWrapper	$request_wrapper
Refinery	$refinery

Definition at line 107 of file class.ilCtrlContext.php.

    {
        $this->path_factory = $path_factory;
        $this->path = $path_factory->null();
        $this->request_wrapper = $request_wrapper;
        $this->refinery = $refinery;
 
        $this->adoptRequestParameters();
    }

References $path_factory, $refinery, $request_wrapper, adoptRequestParameters(), ilCtrlPathFactory\null(), and ILIAS\Repository\refinery().

Here is the call graph for this function:

Member Function Documentation

◆ adoptRequestParameters()

ilCtrlContext::adoptRequestParameters ( )

protected

Adopts context properties from the according ones delivered by the current request.

Note that this method should only be called when initializing ilCtrl, as methods may override delivered values on purpose later on.

Definition at line 288 of file class.ilCtrlContext.php.

                                               : void
    {
        $this->redirect = $this->getQueryParam(ilCtrlInterface::PARAM_REDIRECT);
        $this->cmd_mode = $this->getQueryParam(ilCtrlInterface::PARAM_CMD_MODE);
        $this->cmd = $this->getQueryParam(ilCtrlInterface::PARAM_CMD);
 
        // the context is considered asynchronous if
        // the command mode is 'async'.
        if (ilCtrlInterface::CMD_MODE_ASYNC === $this->cmd_mode) {
            $this->is_async = true;
        }
 
        // if an existing path is provided use it by default.
        $existing_path = $this->getQueryParam(ilCtrlInterface::PARAM_CID_PATH);
        if (null !== $existing_path) {
            $this->path = $this->path_factory->existing($existing_path);
        }
 
        // set the provided baseclass, which might override the
        // previously set existing path.
        $base_class = $this->getQueryParam(ilCtrlInterface::PARAM_BASE_CLASS);
        if (null !== $base_class) {
            $this->setBaseClass($this->decodeNamespaceFromUrl($base_class));
        }
 
        // set or append the provided command class, which might
        // override the previously set path again.
        $cmd_class = $this->getQueryParam(ilCtrlInterface::PARAM_CMD_CLASS);
        if (null !== $cmd_class) {
            $this->setCmdClass($this->decodeNamespaceFromUrl($cmd_class));
        }
    }

References $base_class, $cmd_class, ilCtrlInterface\CMD_MODE_ASYNC, decodeNamespaceFromUrl(), getQueryParam(), ilCtrlInterface\PARAM_BASE_CLASS, ilCtrlInterface\PARAM_CID_PATH, ilCtrlInterface\PARAM_CMD, ilCtrlInterface\PARAM_CMD_CLASS, ilCtrlInterface\PARAM_CMD_MODE, ilCtrlInterface\PARAM_REDIRECT, setBaseClass(), and setCmdClass().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getBaseClass()

ilCtrlContext::getBaseClass ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 180 of file class.ilCtrlContext.php.

                                  : ?string
    {
        return $this->base_class;
    }

References $base_class.

◆ getCmd()

ilCtrlContext::getCmd ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 241 of file class.ilCtrlContext.php.

                            : ?string
    {
        return $this->cmd;
    }

References $cmd.

◆ getCmdClass()

ilCtrlContext::getCmdClass ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 221 of file class.ilCtrlContext.php.

                                 : ?string
    {
        // if no cmd_class is set yet, the baseclass
        // value can be returned.
        return $this->cmd_class ?? $this->base_class;
    }

References $base_class.

◆ getCmdMode()

ilCtrlContext::getCmdMode ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 153 of file class.ilCtrlContext.php.

                                : ?string
    {
        return $this->cmd_mode;
    }

References $cmd_mode.

◆ getObjId()

ilCtrlContext::getObjId ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 275 of file class.ilCtrlContext.php.

                              : ?int
    {
        return $this->obj_id;
    }

References $obj_id.

◆ getObjType()

ilCtrlContext::getObjType ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 258 of file class.ilCtrlContext.php.

                                : ?string
    {
        return $this->obj_type;
    }

References $obj_type.

◆ getPath()

ilCtrlContext::getPath ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 136 of file class.ilCtrlContext.php.

                             : ilCtrlPathInterface
    {
        return $this->path;
    }

References $path.

◆ getQueryParam()

ilCtrlContext::getQueryParam ( string $parameter_name )

protected

Helper function to retrieve request parameter values by name.

Parameters

string $parameter_name

Returns: string|null

Definition at line 327 of file class.ilCtrlContext.php.

                                                            : ?string
    {
        if ($this->request_wrapper->has($parameter_name)) {
            return $this->request_wrapper->retrieve(
                $parameter_name,
                $this->refinery->to()->string()
            );
        }
 
        return null;
    }

References ILIAS\Repository\refinery().

Referenced by adoptRequestParameters().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRedirectSource()

ilCtrlContext::getRedirectSource ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 128 of file class.ilCtrlContext.php.

                                       : ?string
    {
        return $this->redirect;
    }

References $redirect.

◆ getTargetScript()

ilCtrlContext::getTargetScript ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 197 of file class.ilCtrlContext.php.

                                     : string
    {
        return $this->target_script;
    }

References $target_script.

◆ isAsync()

ilCtrlContext::isAsync ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 120 of file class.ilCtrlContext.php.

                             : bool
    {
        return $this->is_async;
    }

References $is_async.

◆ setBaseClass()

ilCtrlContext::setBaseClass ( string $base_class )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 161 of file class.ilCtrlContext.php.

                                                    : ilCtrlContextInterface
    {
        $path = $this->path_factory->find($this, $base_class);
 
        // only set baseclass if it's a valid target.
        if (null !== $path->getCidPath()) {
            $this->base_class = $base_class;
            // only update the path if the current one is null.
            if (null === $this->path->getCidPath()) {
                $this->path = $path;
            }
        }
 
        return $this;
    }

References $base_class, $path, and ilCtrlPathInterface\getCidPath().

Referenced by adoptRequestParameters().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setCmd()

ilCtrlContext::setCmd ( ?string $cmd )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 231 of file class.ilCtrlContext.php.

                                        : ilCtrlContextInterface
    {
        $this->cmd = $cmd;
 
        return $this;
    }

References $cmd.

◆ setCmdClass()

ilCtrlContext::setCmdClass ( ?string $cmd_class )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 205 of file class.ilCtrlContext.php.

                                                   : ilCtrlContextInterface
    {
        $path = $this->path_factory->find($this, $cmd_class);
 
        // only set command class if it's a valid target.
        if (null !== $path->getCidPath()) {
            $this->cmd_class = $cmd_class;
            $this->path = $path;
        }
 
        return $this;
    }

References $cmd_class, $path, and ilCtrlPathInterface\getCidPath().

Referenced by adoptRequestParameters().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setCmdMode()

ilCtrlContext::setCmdMode ( string $mode )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 144 of file class.ilCtrlContext.php.

                                            : ilCtrlContextInterface
    {
        $this->cmd_mode = $mode;
        return $this;
    }

◆ setObjId()

ilCtrlContext::setObjId ( int $obj_id )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 266 of file class.ilCtrlContext.php.

                                         : ilCtrlContextInterface
    {
        $this->obj_id = $obj_id;
        return $this;
    }

References $obj_id.

◆ setObjType()

ilCtrlContext::setObjType ( string $obj_type )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 249 of file class.ilCtrlContext.php.

                                                : ilCtrlContextInterface
    {
        $this->obj_type = $obj_type;
        return $this;
    }

References $obj_type.

◆ setTargetScript()

ilCtrlContext::setTargetScript ( string $target_script )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 188 of file class.ilCtrlContext.php.

                                                          : ilCtrlContextInterface
    {
        $this->target_script = $target_script;
        return $this;
    }

References $target_script.

Field Documentation

◆ $base_class

string ilCtrlContext::$base_class = null

protected

Definition at line 78 of file class.ilCtrlContext.php.

Referenced by adoptRequestParameters(), getBaseClass(), getCmdClass(), and setBaseClass().

◆ $cmd

string ilCtrlContext::$cmd = null

protected

Definition at line 88 of file class.ilCtrlContext.php.

Referenced by getCmd(), and setCmd().

◆ $cmd_class

string ilCtrlContext::$cmd_class = null

protected

Definition at line 83 of file class.ilCtrlContext.php.

Referenced by adoptRequestParameters(), and setCmdClass().

◆ $cmd_mode

string ilCtrlContext::$cmd_mode = null

protected

Definition at line 68 of file class.ilCtrlContext.php.

Referenced by getCmdMode().

◆ $is_async

bool ilCtrlContext::$is_async = false

protected

Definition at line 58 of file class.ilCtrlContext.php.

Referenced by isAsync().

◆ $obj_id

int ilCtrlContext::$obj_id = null

protected

Definition at line 98 of file class.ilCtrlContext.php.

Referenced by getObjId(), and setObjId().

◆ $obj_type

string ilCtrlContext::$obj_type = null

protected

Definition at line 93 of file class.ilCtrlContext.php.

Referenced by getObjType(), and setObjType().

◆ $path

ilCtrlPathInterface ilCtrlContext::$path

protected

Definition at line 53 of file class.ilCtrlContext.php.

Referenced by getPath(), setBaseClass(), and setCmdClass().

◆ $path_factory

ilCtrlPathFactory ilCtrlContext::$path_factory

protected

Definition at line 38 of file class.ilCtrlContext.php.

Referenced by __construct().

◆ $redirect

string ilCtrlContext::$redirect = null

protected

Definition at line 73 of file class.ilCtrlContext.php.

Referenced by getRedirectSource().

◆ $refinery

Refinery ilCtrlContext::$refinery

protected

Definition at line 48 of file class.ilCtrlContext.php.

Referenced by __construct().

◆ $request_wrapper

RequestWrapper ilCtrlContext::$request_wrapper

protected

Definition at line 43 of file class.ilCtrlContext.php.

Referenced by __construct().

◆ $target_script

string ilCtrlContext::$target_script = 'ilias.php'

protected

Definition at line 63 of file class.ilCtrlContext.php.

Referenced by getTargetScript(), and setTargetScript().

The documentation for this class was generated from the following file:

components/ILIAS/UICore/classes/class.ilCtrlContext.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ adoptRequestParameters()

◆ getBaseClass()

◆ getCmd()

◆ getCmdClass()

◆ getCmdMode()

◆ getObjId()

◆ getObjType()

◆ getPath()

◆ getQueryParam()

◆ getRedirectSource()

◆ getTargetScript()

◆ isAsync()

◆ setBaseClass()

◆ setCmd()

◆ setCmdClass()

◆ setCmdMode()

◆ setObjId()

◆ setObjType()

◆ setTargetScript()

Field Documentation

◆ $base_class

◆ $cmd

◆ $cmd_class

◆ $cmd_mode

◆ $is_async

◆ $obj_id

◆ $obj_type

◆ $path

◆ $path_factory

◆ $redirect

◆ $refinery

◆ $request_wrapper

◆ $target_script