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 30 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 104 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 285 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($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($cmd_class);
        }
    }

References $base_class, $cmd_class, ilCtrlInterface\CMD_MODE_ASYNC, 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 177 of file class.ilCtrlContext.php.

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

References $base_class.

◆ getCmd()

ilCtrlContext::getCmd ( )

@inheritDoc

Implements ilCtrlContextInterface.

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

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

References $cmd.

◆ getCmdClass()

ilCtrlContext::getCmdClass ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 218 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 150 of file class.ilCtrlContext.php.

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

References $cmd_mode.

◆ getObjId()

ilCtrlContext::getObjId ( )

@inheritDoc

Implements ilCtrlContextInterface.

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

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

References $obj_id.

◆ getObjType()

ilCtrlContext::getObjType ( )

@inheritDoc

Implements ilCtrlContextInterface.

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

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

References $obj_type.

◆ getPath()

ilCtrlContext::getPath ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 133 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 324 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 125 of file class.ilCtrlContext.php.

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

References $redirect.

◆ getTargetScript()

ilCtrlContext::getTargetScript ( )

@inheritDoc

Implements ilCtrlContextInterface.

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

                                     : string
    {
        return $this->target_script;
    }

References $target_script.

◆ isAsync()

ilCtrlContext::isAsync ( )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 117 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 158 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 228 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 202 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 141 of file class.ilCtrlContext.php.

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

◆ setObjId()

ilCtrlContext::setObjId ( int $obj_id )

@inheritDoc

Implements ilCtrlContextInterface.

Definition at line 263 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 246 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 185 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 75 of file class.ilCtrlContext.php.

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

◆ $cmd

string ilCtrlContext::$cmd = null

protected

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

Referenced by getCmd(), and setCmd().

◆ $cmd_class

string ilCtrlContext::$cmd_class = null

protected

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

Referenced by adoptRequestParameters(), and setCmdClass().

◆ $cmd_mode

string ilCtrlContext::$cmd_mode = null

protected

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

Referenced by getCmdMode().

◆ $is_async

bool ilCtrlContext::$is_async = false

protected

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

Referenced by isAsync().

◆ $obj_id

int ilCtrlContext::$obj_id = null

protected

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

Referenced by getObjId(), and setObjId().

◆ $obj_type

string ilCtrlContext::$obj_type = null

protected

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

Referenced by getObjType(), and setObjType().

◆ $path

ilCtrlPathInterface ilCtrlContext::$path

protected

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

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

◆ $path_factory

ilCtrlPathFactory ilCtrlContext::$path_factory

protected

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

Referenced by __construct().

◆ $redirect

string ilCtrlContext::$redirect = null

protected

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

Referenced by getRedirectSource().

◆ $refinery

Refinery ilCtrlContext::$refinery

protected

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

Referenced by __construct().

◆ $request_wrapper

RequestWrapper ilCtrlContext::$request_wrapper

protected

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

Referenced by __construct().

◆ $target_script

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

protected

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

Referenced by getTargetScript(), and setTargetScript().

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

Services/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