Filter service. More...

Collaboration diagram for ilUIFilterService:

Public Member Functions
	__construct (ilUIService $service, ilUIServiceDependencies $deps)
	Constructor. More...

	standard ( $filter_id, $base_action, array $inputs, array $is_input_initially_rendered, $is_activated=false, $is_expanded=false)
	Get standard filter instance. More...

	getData (Filter\Standard $filter)
	Get data. More...

Data Fields
const	CMD_TOGGLE_ON = "toggleOn"

const	CMD_TOGGLE_OFF = "toggleOff"

const	CMD_EXPAND = "expand"

const	CMD_COLLAPSE = "collapse"

const	CMD_APPLY = "apply"

const	CMD_RESET = "reset"

Protected Member Functions
	writeFilterStatusToSession ($filter_id, $inputs)
	Write filter status to session (filter activated/expanded, inputs being rendered or not) More...

	handleRendering ($filter_id, $inputs)
	Handle rendering of inputs to session. More...

	handleReset (string $filter_id)
	Handle reset command. More...

	handleApply (string $filter_id, Filter\Standard $filter)
	Handle apply command. More...

Protected Attributes
	$service

	$ui

	$session

	$request

Detailed Description

Filter service.

Wraps around KS filter container.

Author: killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 15 of file class.ilUIFilterService.php.

Constructor & Destructor Documentation

◆ __construct()

ilUIFilterService::__construct	(	ilUIService	$service,
		ilUIServiceDependencies	$deps
	)

Constructor.

Parameters

ilUIService	$service
ilUIServiceDependencies	$deps

Definition at line 51 of file class.ilUIFilterService.php.

    {
        $this->service = $service;
        $this->session = $deps->getSession();
        $this->request = $deps->getRequest();
        $this->ui = $deps->ui();
    }

References $service, ilUIServiceDependencies\getRequest(), ilUIServiceDependencies\getSession(), ilUIServiceDependencies\ui(), and ui().

Here is the call graph for this function:

Member Function Documentation

◆ getData()

ilUIFilterService::getData ( Filter\Standard $filter )

Get data.

Parameters

Filter\Standard $filter

Returns: array|null

Definition at line 135 of file class.ilUIFilterService.php.

    {
        $result = null;
        if ($filter->isActivated()) {
            $filter = $this->request->getFilterWithRequest($filter);
            $result = $filter->getData();
        }
        return $result;
    }

References $result.

◆ handleApply()

ilUIFilterService::handleApply	(	string	$filter_id,
		Filter\Standard	$filter
	)

protected

Handle apply command.

Parameters

string	$filter_id
Filter\Standard	$filter

Returns: Filter\Standard

Definition at line 211 of file class.ilUIFilterService.php.

                                                                               : Filter\Standard
    {
        if ((in_array(
            $this->request->getFilterCmd(),
            [self::CMD_APPLY]
        ))) {
            $filter = $this->request->getFilterWithRequest($filter);
            foreach ($filter->getInputs() as $input_id => $i) {
                $this->session->writeValue($filter_id, $input_id, $i->getValue());
            }
        }
        return $filter;
    }

References $i.

◆ handleRendering()

ilUIFilterService::handleRendering	(	$filter_id,
		$inputs
	)

protected

Handle rendering of inputs to session.

Parameters

string	$filter_id
array	$inputs

Definition at line 179 of file class.ilUIFilterService.php.

    {
        foreach ($inputs as $input_id => $i) {
            if ($this->request->isInputRendered($input_id)) {
                $this->session->writeRendered($filter_id, $input_id, true);
            } else {
                $this->session->writeRendered($filter_id, $input_id, false);
            }
        }
    }

References $i.

◆ handleReset()

ilUIFilterService::handleReset ( string $filter_id )

protected

Handle reset command.

Parameters

string $filter_id

Definition at line 195 of file class.ilUIFilterService.php.

    {
        // clear session, if reset is pressed
        if ($this->request->getFilterCmd() == self::CMD_RESET) {
            $this->session->reset($filter_id);
        }
    }

◆ standard()

ilUIFilterService::standard	(		$filter_id,
			$base_action,
		array	$inputs,
		array	$is_input_initially_rendered,
			$is_activated = `false`,
			$is_expanded = `false`
	)

Get standard filter instance.

Parameters

string	$filter_id
string	$base_action
FilterInput[]	$inputs
bool[]	$is_input_initially_rendered
bool	$is_activated
bool	$is_expanded

Returns: Filter\Standard

Definition at line 71 of file class.ilUIFilterService.php.

      : Filter\Standard {
        $ui = $this->ui->factory();
 
        // write expand, activation, rendered inputs info to session
        $this->writeFilterStatusToSession($filter_id, $inputs);
 
        // handle the reset command
        $this->handleReset($filter_id);
 
        // determine activation/expand status
        $is_activated = $this->session->isActivated($filter_id, $is_activated);
        $is_expanded = $this->session->isExpanded($filter_id, $is_expanded);
 
        // put data from session into filter
        $inputs_with_session_data = [];
        $is_input_initially_rendered_with_session = [];
        foreach ($inputs as $input_id => $i) {
            // rendering information
            $rendered =
                $this->session->isRendered($filter_id, $input_id, current($is_input_initially_rendered));
            $is_input_initially_rendered_with_session[] = $rendered;
            next($is_input_initially_rendered);
 
            // values
            $val = $this->session->getValue($filter_id, $input_id);
            if ($rendered && !is_null($val)) {
                $i = $i->withValue($val);
            }
            $inputs_with_session_data[$input_id] = $i;
        }
 
        // get the filter
        $filter = $ui->input()->container()->filter()->standard(
            $this->request->getAction($base_action, self::CMD_TOGGLE_ON),
            $this->request->getAction($base_action, self::CMD_TOGGLE_OFF),
            $this->request->getAction($base_action, self::CMD_EXPAND),
            $this->request->getAction($base_action, self::CMD_COLLAPSE),
            $this->request->getAction($base_action, self::CMD_APPLY, true),
            $this->request->getAction($base_action, self::CMD_RESET, true),
            $inputs_with_session_data,
            $is_input_initially_rendered_with_session,
            $is_activated,
            $is_expanded
        );
 
        // handle apply command
        $filter = $this->handleApply($filter_id, $filter);
 
        return $filter;
    }

◆ writeFilterStatusToSession()

ilUIFilterService::writeFilterStatusToSession	(	$filter_id,
		$inputs
	)

protected

Write filter status to session (filter activated/expanded, inputs being rendered or not)

Parameters

string	$filter_id
array	$inputs

Definition at line 150 of file class.ilUIFilterService.php.

    {
        if ($this->request->getFilterCmd() == self::CMD_TOGGLE_ON) {
            $this->session->writeActivated($filter_id, true);
        }
 
        if ($this->request->getFilterCmd() == self::CMD_TOGGLE_OFF) {
            $this->session->writeActivated($filter_id, false);
        }
 
        if ($this->request->getFilterCmd() == self::CMD_EXPAND) {
            $this->session->writeExpanded($filter_id, true);
        }
 
        if ($this->request->getFilterCmd() == self::CMD_COLLAPSE) {
            $this->handleRendering($filter_id, $inputs);
            $this->session->writeExpanded($filter_id, false);
        }
 
        if ($this->request->getFilterCmd() == self::CMD_APPLY) {
            $this->handleRendering($filter_id, $inputs);
        }
    }