Description of ilDidacticTemplateBlockRoleAction. More...

Inheritance diagram for ilDidacticTemplateBlockRoleAction:

Collaboration diagram for ilDidacticTemplateBlockRoleAction:

Public Member Functions
	__construct ($action_id=0)
	Constructor. More...

	addFilterPattern (ilDidacticTemplateFilterPattern $pattern)
	Add filter. More...

	setFilterPatterns (array $patterns)
	Set filter patterns. More...

	getFilterPattern ()
	Get filter pattern. More...

	setFilterType ($a_type)
	Set filter type. More...

	getFilterType ()
	Get filter type. More...

	save ()
	Save action. More...

	delete ()
	delete action filter @global ilDB $ilDB More...

	apply ()
	Apply action. More...

	revert ()
	Revert action. More...

	getType ()
	Get action type. More...

	toXml (ilXmlWriter $writer)
	Export to xml. More...

	__clone ()
	clone method More...

	read ()
	read action data @global ilDB $ilDB More...

Public Member Functions inherited from ilDidacticTemplateAction
	__construct ($action_id=0)
	Constructor. More...

	getLogger ()
	Get logger. More...

	getActionId ()
	Get action id. More...

	setActionId ($a_action_id)
	Set action id. More...

	setType ($a_type_id)
	Set type id. More...

	setTemplateId ($a_id)
	Set template id. More...

	getTemplateId ()
	Get template id. More...

	setRefId ($a_ref_id)
	Set ref id of target object. More...

	getRefId ()
	Get ref id of target object. More...

	save ()
	write action to db overwrite for filling additional db fields More...

	delete ()
	Delete didactic template action overwrite for filling additional db fields. More...

	read ()
	@global ilDB $ilDB More...

	getType ()
	Get type of template. More...

	apply ()
	Apply action. More...

	revert ()
	Implement everthing that is necessary to revert a didactic template. More...

	__clone ()
	Clone method. More...

	toXml (ilXmlWriter $writer)
	Write xml for export. More...

Data Fields
const	FILTER_SOURCE_TITLE = 1

const	FILTER_SOURCE_OBJ_ID = 2

const	FILTER_PARENT_ROLES = 3

const	PATTERN_PARENT_TYPE = 'action'

Data Fields inherited from ilDidacticTemplateAction
const	TYPE_LOCAL_POLICY = 1

const	TYPE_LOCAL_ROLE = 2

const	TYPE_BLOCK_ROLE = 3

const	FILTER_SOURCE_TITLE = 1

const	FILTER_SOURCE_OBJ_ID = 2

const	FILTER_PARENT_ROLES = 3

const	FILTER_LOCAL_ROLES = 4

const	PATTERN_PARENT_TYPE = 'action'

Protected Member Functions
	blockRole ($a_role_id, $source)
	Blo k role. More...

	deleteLocalPolicy ($a_role_id, $source)
	Delete local policy. More...

Protected Member Functions inherited from ilDidacticTemplateAction
	initSourceObject ()
	Init the source object. More...

	filterRoles (ilObject $source)
	Filter roles. More...

Private Attributes
	$pattern = array()

	$filter_type = self::FILTER_SOURCE_TITLE

Detailed Description

Description of ilDidacticTemplateBlockRoleAction.

Author: Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Definition at line 12 of file class.ilDidacticTemplateBlockRoleAction.php.

Constructor & Destructor Documentation

◆ __construct()

ilDidacticTemplateBlockRoleAction::__construct ( $action_id = 0 )

Constructor.

Parameters

int $action_id

Reimplemented from ilDidacticTemplateAction.

Definition at line 28 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        parent::__construct($action_id);
    }

References ilDidacticTemplateAction\$action_id.

Member Function Documentation

◆ __clone()

ilDidacticTemplateBlockRoleAction::__clone ( )

clone method

Reimplemented from ilDidacticTemplateAction.

Definition at line 273 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        parent::__clone();
 
        // Clone patterns
        $cloned = array();
        foreach ($this->getFilterPattern() as $pattern) {
            $clones[] = clone $pattern;
        }
        $this->setFilterPatterns($clones);
    }

References $pattern, getFilterPattern(), and setFilterPatterns().

Here is the call graph for this function:

◆ addFilterPattern()

ilDidacticTemplateBlockRoleAction::addFilterPattern ( ilDidacticTemplateFilterPattern $pattern )

Add filter.

Parameters

ilDidacticTemplateFilterPatter $pattern

Definition at line 37 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        $this->pattern[] = $pattern;
    }

References $pattern.

Referenced by read().

Here is the caller graph for this function:

◆ apply()

ilDidacticTemplateBlockRoleAction::apply ( )

Apply action.

Reimplemented from ilDidacticTemplateAction.

Definition at line 133 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        $source = $this->initSourceObject();
        $roles = $this->filterRoles($source);
 
        // Create local policy for filtered roles
        foreach ($roles as $role_id => $role) {
            $this->blockRole($role_id, $source);
        }
        return true;
    }

References $source, blockRole(), ilDidacticTemplateAction\filterRoles(), and ilDidacticTemplateAction\initSourceObject().

Here is the call graph for this function:

◆ blockRole()

ilDidacticTemplateBlockRoleAction::blockRole	(	$a_role_id,
		$source
	)

protected

Blo k role.

Parameters

int	$a_role_id
ilObject	$source

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

    {
        global $DIC;
 
        $rbacadmin = $DIC['rbacadmin'];
        $rbacreview = $DIC['rbacreview'];
        
        // Set assign to 'y' only if it is a local role
        $assign = $rbacreview->isAssignable($a_role_id, $source->getRefId()) ? 'y' : 'n';
 
        // Delete permissions
        $rbacadmin->revokeSubtreePermissions($source->getRefId(), $a_role_id);
 
        // Delete template permissions
        $rbacadmin->deleteSubtreeTemplates($source->getRefId(), $a_role_id);
 
        $rbacadmin->assignRoleToFolder(
            $a_role_id,
            $source->getRefId(),
            $assign
        );
        return true;
    }

References $DIC, and $source.

Referenced by apply().

Here is the caller graph for this function:

◆ delete()

ilDidacticTemplateBlockRoleAction::delete ( )

delete action filter @global ilDB $ilDB

Returns: bool

Reimplemented from ilDidacticTemplateAction.

Definition at line 109 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        parent::delete();
 
        $query = 'DELETE FROM didactic_tpl_abr ' .
            'WHERE action_id  = ' . $ilDB->quote($this->getActionId(), 'integer');
        $ilDB->manipulate($query);
 
        foreach ($this->getFilterPattern() as $pattern) {
            $pattern->delete();
        }
        return true;
    }

References $DIC, $ilDB, $pattern, $query, ilDidacticTemplateAction\getActionId(), and getFilterPattern().

Here is the call graph for this function:

◆ deleteLocalPolicy()

ilDidacticTemplateBlockRoleAction::deleteLocalPolicy	(	$a_role_id,
		$source
	)

protected

Delete local policy.

Parameters

int	$a_role_id
ilObject	$source

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

    {
        global $DIC;
 
        $rbacreview = $DIC['rbacreview'];
        $rbacadmin = $DIC['rbacadmin'];
 
        // Create role folder if it does not exist
        //$rolf = $rbacreview->getRoleFolderIdOfObject($source->getRefId());
 
        if ($rbacreview->getRoleFolderOfRole($a_role_id) == $source->getRefId()) {
            ilLoggerFactory::getLogger('otpl')->debug('Ignoring local role: ' . ilObject::_lookupTitle($a_role_id));
            return false;
        }
 
        $rbacadmin->deleteLocalRole($a_role_id, $source->getRefId());
 
        // Change existing object
        include_once './Services/AccessControl/classes/class.ilObjRole.php';
        $role = new ilObjRole($a_role_id);
        $role->changeExistingObjects(
            $source->getRefId(),
            ilObjRole::MODE_UNPROTECTED_DELETE_LOCAL_POLICIES,
            array('all')
        );
        
        return true;
    }

References $DIC, $source, ilObject\_lookupTitle(), ilLoggerFactory\getLogger(), and ilObjRole\MODE_UNPROTECTED_DELETE_LOCAL_POLICIES.

Referenced by revert().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFilterPattern()

ilDidacticTemplateBlockRoleAction::getFilterPattern ( )

Get filter pattern.

Returns: array

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

    {
        return $this->pattern;
    }

References $pattern.

Referenced by __clone(), delete(), save(), and toXml().

Here is the caller graph for this function:

◆ getFilterType()

ilDidacticTemplateBlockRoleAction::getFilterType ( )

Get filter type.

Returns: int

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

    {
        return $this->filter_type;
    }

References $filter_type.

Referenced by save(), and toXml().

Here is the caller graph for this function:

◆ getType()

ilDidacticTemplateBlockRoleAction::getType ( )

Get action type.

Returns: int

Reimplemented from ilDidacticTemplateAction.

Definition at line 229 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        return self::TYPE_BLOCK_ROLE;
    }

References ilDidacticTemplateAction\TYPE_BLOCK_ROLE.

◆ read()

ilDidacticTemplateBlockRoleAction::read ( )

read action data @global ilDB $ilDB

Returns: bool

Reimplemented from ilDidacticTemplateAction.

Definition at line 290 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        if (!parent::read()) {
            return false;
        }
 
        $query = 'SELECT * FROM didactic_tpl_abr ' .
            'WHERE action_id = ' . $ilDB->quote($this->getActionId());
        $res = $ilDB->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $this->setFilterType($row->filter_type);
        }
 
        // Read filter
        include_once './Services/DidacticTemplate/classes/class.ilDidacticTemplateFilterPatternFactory.php';
        foreach (ilDidacticTemplateFilterPatternFactory::lookupPatternsByParentId($this->getActionId(), self::PATTERN_PARENT_TYPE) as $pattern) {
            $this->addFilterPattern($pattern);
        }
    }

References $DIC, $ilDB, $pattern, $query, $res, $row, addFilterPattern(), ilDBConstants\FETCHMODE_OBJECT, ilDidacticTemplateAction\getActionId(), ilDidacticTemplateFilterPatternFactory\lookupPatternsByParentId(), and setFilterType().

Here is the call graph for this function:

◆ revert()

ilDidacticTemplateBlockRoleAction::revert ( )

Revert action.

Reimplemented from ilDidacticTemplateAction.

Definition at line 177 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        $source = $this->initSourceObject();
        $roles = $this->filterRoles($source);
 
        // Create local policy for filtered roles
        foreach ($roles as $role_id => $role) {
            $this->deleteLocalPolicy($role_id, $source);
        }
        return true;
    }

References $source, deleteLocalPolicy(), ilDidacticTemplateAction\filterRoles(), and ilDidacticTemplateAction\initSourceObject().

Here is the call graph for this function:

◆ save()

ilDidacticTemplateBlockRoleAction::save ( )

Save action.

Reimplemented from ilDidacticTemplateAction.

Definition at line 81 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
 
        parent::save();
 
        $query = 'INSERT INTO didactic_tpl_abr (action_id,filter_type) ' .
            'VALUES( ' .
            $ilDB->quote($this->getActionId(), 'integer') . ', ' .
            $ilDB->quote($this->getFilterType(), 'integer') . ' ' .
            ')';
        $ilDB->manipulate($query);
 
        foreach ($this->getFilterPattern() as $pattern) {
            /* @var ilDidacticTemplateFilterPattern $pattern */
            $pattern->setParentId($this->getActionId());
            $pattern->setParentType(self::PATTERN_PARENT_TYPE);
            $pattern->save();
        }
    }

References $DIC, $ilDB, $pattern, $query, ilDidacticTemplateAction\getActionId(), getFilterPattern(), and getFilterType().

Here is the call graph for this function:

◆ setFilterPatterns()

ilDidacticTemplateBlockRoleAction::setFilterPatterns ( array $patterns )

Set filter patterns.

Parameters

array $patterns

Definition at line 46 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        $this->pattern = $patterns;
    }

Referenced by __clone().

Here is the caller graph for this function:

◆ setFilterType()

ilDidacticTemplateBlockRoleAction::setFilterType ( $a_type )

Set filter type.

Parameters

int $a_type

Definition at line 64 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        $this->filter_type = $a_type;
    }

References $a_type.

Referenced by read().

Here is the caller graph for this function:

◆ toXml()

ilDidacticTemplateBlockRoleAction::toXml ( ilXmlWriter $writer )

Export to xml.

Parameters

ilXmlWriter $writer

Returns: void

Reimplemented from ilDidacticTemplateAction.

Definition at line 239 of file class.ilDidacticTemplateBlockRoleAction.php.

    {
        $writer->xmlStartTag('blockRoleAction');
 
        switch ($this->getFilterType()) {
            case self::FILTER_SOURCE_OBJ_ID:
                $writer->xmlStartTag('roleFilter', ['source' => 'objId']);
                break;
 
            case self::FILTER_SOURCE_TITLE:
                $writer->xmlStartTag('roleFilter', ['source' => 'title']);
                break;
 
            case self::FILTER_PARENT_ROLES:
                $writer->xmlStartTag('roleFilter', ['source' => 'parentRoles']);
                break;
 
            default:
                $writer->xmlStartTag('roleFilter', ['source' => 'title']);
                break;
 
        }
 
        foreach ($this->getFilterPattern() as $pattern) {
            $pattern->toXml($writer);
        }
        $writer->xmlEndTag('roleFilter');
        $writer->xmlEndTag('blockRoleAction');
        return;
    }