Inheritance diagram for ilForumExplorerGUI:

Collaboration diagram for ilForumExplorerGUI:

Public Member Functions
	__construct (string $a_expl_id, object $a_parent_obj, string $a_parent_cmd, ilForumTopic $thread, ilForumPost $root)
	ilForumExplorerGUI constructor. More...

	getChildsOfNode ($parentNodeId)
	@inheritDoc More...

	setCurrentPage (int $currentPage)

	getChildren ($record, $environment=null)
	@inheritDoc More...

	getTreeLabel ()

	getTreeComponent ()
	@inheritDoc More...

	getNodeId ($a_node)
	@inheritDoc More...

	getNodeIcon ($node)
	@inheritDoc More...

	getNodeHref ($node)
	@inheritDoc More...

	getNodeContent ($a_node)
	@inheritDoc More...

Public Member Functions inherited from ilTreeExplorerGUI
	__construct ($a_expl_id, $a_parent_obj, $a_parent_cmd, $a_tree)
	Constructor. More...

	getTree ()
	Get tree. More...

	setOrderField ($a_val, $a_numeric=false)
	Set order field. More...

	getOrderField ()
	Get order field. More...

	setTypeWhiteList ($a_val)
	Set type white list. More...

	getTypeWhiteList ()
	Get type white list. More...

	setTypeBlackList ($a_val)
	Set type black list. More...

	getTypeBlackList ()
	Get type black list. More...

	setPreloadChilds ($a_val)
	Set preload childs. More...

	getPreloadChilds ()
	Get preload childs. More...

	getSuccessorNode ($a_node_id, $a_type="")
	Get successor node (currently only(!) based on lft/rgt tree values) More...

	getChildsOfNode ($a_parent_node_id)
	Get childs of node. More...

	getNodeId ($a_node)
	Get id for node. More...

	getNodeIconAlt ($a_node)
	Get node icon alt attribute. More...

	getRootNode ()
	Get root node. More...

	setRootId ($a_root)

	setPathOpen ($a_id)
	Set node path to be opened. More...

	getHTML ($new=false)
	Get HTML. More...

	getChildren ($node, $environment=null)
	Get a list of records (that list can also be empty).Each record will be relayed to $this->build to retrieve a Node. Also, each record will be asked for Sub-Nodes using this function. Returns array More...

	build (\ILIAS\UI\Component\Tree\Node\Factory $factory, $record, $environment=null)

	getTreeLabel ()

	getTreeComponent ()
	Get Tree UI. More...

	toggleExplorerNodeState ()
	Should be called by an ilCtrl-enabled command class if a tree node toggle action should be processed. More...

Public Member Functions inherited from ilExplorerBaseGUI
	__construct ($a_expl_id, $a_parent_obj, $a_parent_cmd)
	Constructor. More...

	setChildLimit ($a_val)
	Set child limit. More...

	getChildLimit ()
	Get child limit. More...

	setSearchTerm ($a_val)
	Set search term. More...

	getSearchTerm ()
	Get search term. More...

	setMainTemplate ($a_main_tpl=null)
	Set main template (that is responsible for adding js/css) More...

	getRootNode ()
	Get root node. More...

	getChildsOfNode ($a_parent_node_id)
	Get childs of node. More...

	getNodeContent ($a_node)
	Get content of a node. More...

	getNodeId ($a_node)
	Get id of a node. More...

	getNodeHref ($a_node)
	Get href for node. More...

	nodeHasVisibleChilds ($a_node)
	Node has childs? More...

	sortChilds ($a_childs, $a_parent_node_id)
	Sort childs. More...

	getNodeIcon ($a_node)
	Get node icon path. More...

	getNodeIconAlt ($a_node)
	Get node icon alt attribute. More...

	getNodeTarget ($a_node)
	Get node target (frame) attribute. More...

	getNodeOnClick ($a_node)
	Get node onclick attribute. More...

	isNodeVisible ($a_node)
	Is node visible? More...

	isNodeHighlighted ($a_node)
	Is node highlighted? More...

	isNodeClickable ($a_node)
	Is node clickable? More...

	getId ()
	Get id of explorer element. More...

	setSkipRootNode ($a_val)
	Set skip root node. More...

	getSkipRootNode ()
	Get skip root node. More...

	setAjax ($a_val)
	Set ajax. More...

	getAjax ()
	Get ajax. More...

	setSecondaryHighlightedNodes ($a_val)
	Set secondary (background) highlighted nodes. More...

	getSecondaryHighlightedNodes ()
	Get secondary (background) highlighted nodes. More...

	setNodeOpen ($a_id)
	Set node to be opened (additional custom opened node, not standard expand behaviour) More...

	setSelectMode ($a_postvar, $a_multi=false)
	Set select mode (to deactivate, pass an empty string as postvar) More...

	setNodeSelected ($a_id)
	Set node to be opened (additional custom opened node, not standard expand behaviour) More...

	setOfflineMode ($a_val)
	Set offline mode. More...

	getOfflineMode ()
	Get offline mode. More...

	handleCommand ()
	Handle explorer internal command. More...

	getContainerId ()
	Get container id. More...

	openNode ()
	Open node. More...

	closeNode ()
	Close node. More...

	getNodeAsync ()
	Get node asynchronously. More...

	beforeRendering ()
	Before rendering. More...

	getOnLoadCode ()
	Get on load code. More...

	getHTML ()
	Get HTML. More...

	renderNode ($a_node, $tpl)
	Render node. More...

	renderChilds ($a_node_id, $tpl)
	Render childs. More...

	getDomNodeIdForNodeId ($a_node_id)
	Get DOM node id for node id. More...

	getNodeIdForDomNodeId ($a_dom_node_id)
	Get node id for dom node id. More...

	listItemStart ($tpl, $a_node)
	List item start. More...

	listItemEnd ($tpl)
	List item end. More...

	listStart ($tpl)
	List start. More...

	listEnd ($tpl)
	List end. More...

	isNodeOnclickEnabled ()

	setNodeOnclickEnabled ($nodeOnclickEnabled)

	isEnableDnd ()

	setEnableDnd ($enable_dnd)
	Enable Drag & Drop functionality. More...

Public Member Functions inherited from ILIAS\UI\Component\Tree\TreeRecursion
	getChildren ( $record, $environment=null)
	Get a list of records (that list can also be empty). More...

	build (Node\Factory $factory, $record, $environment=null)
	Build and return a Node. More...

Protected Member Functions
	initPosting ()

	preloadChilds ()
	@inheritDoc More...

	createNode (\ILIAS\UI\Component\Tree\Node\Factory $factory, $record)
	@inheritDoc More...

	getNodeStateToggleCmdClasses ($record)
	@inheritDoc More...

Protected Member Functions inherited from ilTreeExplorerGUI
	preloadChilds ()
	Preload childs. More...

	matches ($node)
	Does a node match a search term (or is search term empty) More...

	getRootId ()

	createNode (\ILIAS\UI\Component\Tree\Node\Factory $factory, $record)
	Creates at tree node, can be overwritten in derivatives if another node type should be used. More...

	getNodeStateToggleCmdClasses ($record)
	Should return an array of ilCtrl-enabled command classes which should be used to build the URL for the expand/collapse actions applied on a tree node. More...

	render ()
	Render tree. More...

Protected Member Functions inherited from ilExplorerBaseGUI
	isNodeSelectable ($a_node)
	Is node selectable? More...

	getNodeToggleOnClick ($a_node)
	Get onclick attribute for node toggling. More...

	getSelectOnClick ($a_node)
	Get onclick attribute for selecting radio/checkbox. More...

	isNodeOpen ($node_id)
	Get all open nodes. More...

	getJSTreePlugins ()

Protected Attributes
	$thread

	$root_node

	$node_id_to_parent_node_id_map = []

	$max_entries = PHP_INT_MAX

	$preloaded_children = []

	$authorInformation = []

	$currentPostingId = 0

Protected Attributes inherited from ilTreeExplorerGUI
	$lng

	$httpRequest

	$tree = null

	$tree_label = ""

	$order_field = ""

	$order_field_numeric = false

	$type_white_list = array()

	$type_black_list = array()

	$childs = array()

	$preloaded = false

	$preload_childs = false

	$root_node_data = null

	$all_childs = array()

	$ui

Protected Attributes inherited from ilExplorerBaseGUI
	$log

	$ctrl

	$tpl

	$skip_root_node = false

	$ajax = false

	$custom_open_nodes = array()

	$selected_nodes = array()

	$select_postvar = ""

	$offline_mode = false

	$sec_highl_nodes = array()

	$enable_dnd = false

	$search_term = ""

	$open_nodes = []

	$store

	$parent_obj

	$child_limit = 0

	$parent_cmd = ''

Private Member Functions
	getAuthorInformationByNode (array $node)

Private Attributes
	$currentPage = 0

Additional Inherited Members
Static Public Member Functions inherited from ilExplorerBaseGUI
static	getLocalExplorerJsPath ()
	Get local path of explorer js. More...

static	getLocalJsTreeJsPath ()
	Get local path of jsTree js. More...

static	getLocalJsTreeCssPath ()
	Get local path of jsTree js. More...

static	createHTMLExportDirs ($a_target_dir)
	Create html export directories. More...

static	init ($a_main_tpl=null)
	Init JS. More...

Static Protected Attributes inherited from ilExplorerBaseGUI
static	$js_tree_path = "./libs/bower/bower_components/jstree/dist/jstree.js"

static	$js_tree_path_css = "./libs/bower/bower_components/jstree/dist/themes/default/style.min.css"

static	$js_expl_path = "./Services/UIComponent/Explorer2/js/Explorer2.js"

Detailed Description

Class ilForumExplorerGUI.

Author: Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Definition at line 11 of file class.ilForumExplorerGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilForumExplorerGUI::__construct	(	string	$a_expl_id,
		object	$a_parent_obj,
		string	$a_parent_cmd,
		ilForumTopic	$thread,
		ilForumPost	$root
	)

ilForumExplorerGUI constructor.

Parameters

	$a_expl_id
	$a_parent_obj
	$a_parent_cmd
ilForumTopic	$thread
ilForumPost	$root

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

    {
        global $DIC;
 
        parent::__construct($a_expl_id, $a_parent_obj, $a_parent_cmd, $DIC->repositoryTree());
        
        $this->setSkipRootNode(false);
        $this->setAjax(false);
        $this->setPreloadChilds(true);
 
        $this->thread = $thread;
        $this->root_node = $root;
 
        $this->ctrl->setParameter($this->parent_obj, 'thr_pk', $this->thread->getId());
 
        $frm = new ilForum();
        $this->max_entries = (int) $frm->getPageHits();
 
        $this->initPosting();
 
        $this->setNodeOpen($this->root_node->getId());
    }

References $DIC, $thread, ILIAS\GlobalScreen\Provider\__construct(), initPosting(), ilExplorerBaseGUI\setAjax(), ilExplorerBaseGUI\setNodeOpen(), ilTreeExplorerGUI\setPreloadChilds(), and ilExplorerBaseGUI\setSkipRootNode().

Here is the call graph for this function:

Member Function Documentation

◆ createNode()

ilForumExplorerGUI::createNode	(	\ILIAS\UI\Component\Tree\Node\Factory	$factory,
			$record
	)

protected

@inheritDoc

Definition at line 173 of file class.ilForumExplorerGUI.php.

      : \ILIAS\UI\Component\Tree\Node\Node {
        $nodeIconPath = $this->getNodeIcon($record);
 
        $icon = null;
        if (is_string($nodeIconPath) && strlen($nodeIconPath) > 0) {
            $icon = $this->ui
                ->factory()
                ->symbol()
                ->icon()
                ->custom($nodeIconPath, $this->getNodeIconAlt($record));
        }
 
        if ((int) $record['pos_pk'] === (int) $this->root_node->getId()) {
            $node = $factory->simple($this->getNodeContent($record), $icon);
        } else {
            $authorInfo = $this->getAuthorInformationByNode($record);
            $creationDate = ilDatePresentation::formatDate(new ilDateTime($record['pos_date'], IL_CAL_DATETIME));
            $bylineString = $authorInfo->getAuthorShortName() . ', ' . $creationDate;
 
            $node = $factory->bylined($this->getNodeContent($record), $bylineString, $icon);
        }
 
        return $node;
    }

References ilTreeExplorerGUI\getNodeIconAlt(), and ui().

Here is the call graph for this function:

◆ getAuthorInformationByNode()

ilForumExplorerGUI::getAuthorInformationByNode ( array $node )

private

Parameters

array $node

Returns: ilForumAuthorInformation

Definition at line 216 of file class.ilForumExplorerGUI.php.

                                                             : ilForumAuthorInformation
    {
        if (isset($this->authorInformation[(int) $node['pos_pk']])) {
            return $this->authorInformation[(int) $node['pos_pk']];
        }
 
        return $this->authorInformation[(int) $node['pos_pk']] = new ilForumAuthorInformation(
            $node['pos_author_id'],
            $node['pos_display_user_id'],
            $node['pos_usr_alias'],
            $node['import_name']
        );
    }

◆ getChildren()

ilForumExplorerGUI::getChildren	(	$record,
		$environment = `null`
	)

@inheritDoc

Reimplemented from ilTreeExplorerGUI.

Definition at line 131 of file class.ilForumExplorerGUI.php.

                                                              : array
    {
        return $this->getChildsOfNode((int) $record['pos_pk']);
    }

References getChildsOfNode().

Here is the call graph for this function:

◆ getChildsOfNode()

ilForumExplorerGUI::getChildsOfNode ( $parentNodeId )

@inheritDoc

Reimplemented from ilTreeExplorerGUI.

Definition at line 84 of file class.ilForumExplorerGUI.php.

    {
        if ($this->preloaded) {
            if (isset($this->preloaded_children[$parentNodeId])) {
                return $this->preloaded_children[$parentNodeId];
            }
 
            return [];
        }
 
        return $this->thread->getNestedSetPostChildren($parentNodeId, 1);
    }

Referenced by getChildren().

Here is the caller graph for this function:

◆ getNodeContent()

ilForumExplorerGUI::getNodeContent ( $a_node )

@inheritDoc

Reimplemented from ilExplorerBaseGUI.

Definition at line 283 of file class.ilForumExplorerGUI.php.

    {
        return $a_node['pos_subject'];
    }

◆ getNodeHref()

ilForumExplorerGUI::getNodeHref ( $node )

@inheritDoc

Reimplemented from ilExplorerBaseGUI.

Definition at line 253 of file class.ilForumExplorerGUI.php.

    {
        if ((int) $this->root_node->getId() === (int) $node['pos_pk']) {
            return '';
        }
 
        $this->ctrl->setParameter($this->parent_obj, 'backurl', null);
 
        if (isset($node['counter']) && $node['counter'] > 0) {
            $page = (int) floor(($node['counter'] - 1) / $this->max_entries);
            $this->ctrl->setParameter($this->parent_obj, 'page', $page);
        }
 
        if (isset($node['post_read']) && $node['post_read']) {
            $this->ctrl->setParameter($this->parent_obj, 'pos_pk', null);
            $url = $this->ctrl->getLinkTarget($this->parent_obj, $this->parent_cmd, $node['pos_pk'], false, false);
        } else {
            $this->ctrl->setParameter($this->parent_obj, 'pos_pk', $node['pos_pk']);
            $url = $this->ctrl->getLinkTarget($this->parent_obj, 'markPostRead', $node['pos_pk'], false, false);
            $this->ctrl->setParameter($this->parent_obj, 'pos_pk', null);
        }
 
        $this->ctrl->setParameter($this->parent_obj, 'page', null);
        
        return $url;
    }

References $url.

◆ getNodeIcon()

ilForumExplorerGUI::getNodeIcon ( $node )

@inheritDoc

Reimplemented from ilExplorerBaseGUI.

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

    {
        if ((int) $this->root_node->getId() === (int) $node['pos_pk']) {
            return ilObject::_getIcon(0, 'tiny', 'frm');
        }
 
        return $this->getAuthorInformationByNode($node)->getProfilePicture();
    }

◆ getNodeId()

ilForumExplorerGUI::getNodeId ( $a_node )

@inheritDoc

Reimplemented from ilTreeExplorerGUI.

Definition at line 233 of file class.ilForumExplorerGUI.php.

    {
        return $a_node['pos_pk'];
    }

◆ getNodeStateToggleCmdClasses()

ilForumExplorerGUI::getNodeStateToggleCmdClasses ( $record )

protected

@inheritDoc

Reimplemented from ilTreeExplorerGUI.

Definition at line 204 of file class.ilForumExplorerGUI.php.

                                                             : array
    {
        return [
            'ilRepositoryGUI',
            'ilObjForumGUI',
        ];
    }

◆ getTreeComponent()

ilForumExplorerGUI::getTreeComponent ( )

@inheritDoc

Reimplemented from ilTreeExplorerGUI.

Definition at line 147 of file class.ilForumExplorerGUI.php.

                                       : Tree
    {
        $rootNode = [
            [
                'pos_pk' => $this->root_node->getId(),
                'pos_subject' => $this->root_node->getSubject(),
                'pos_author_id' => $this->root_node->getPosAuthorId(),
                'pos_display_user_id' => $this->root_node->getDisplayUserId(),
                'pos_usr_alias' => $this->root_node->getUserAlias(),
                'pos_date' => $this->root_node->getCreateDate(),
                'import_name' => $this->root_node->getImportName(),
                'post_read' => $this->root_node->isPostRead()
            ]
        ];
 
        $tree = $this->ui->factory()->tree()
            ->expandable($this->getTreeLabel(), $this)
            ->withData($rootNode)
            ->withHighlightOnNodeClick(false);
 
        return $tree;
    }

References ilTreeExplorerGUI\$tree, getTreeLabel(), and ui().

Here is the call graph for this function:

◆ getTreeLabel()

ilForumExplorerGUI::getTreeLabel ( )

Returns: string

Reimplemented from ilTreeExplorerGUI.

Definition at line 139 of file class.ilForumExplorerGUI.php.

    {
        return $this->lng->txt("frm_posts");
    }

Referenced by getTreeComponent().

Here is the caller graph for this function:

◆ initPosting()

ilForumExplorerGUI::initPosting ( )

protected

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

                                     : void
    {
        $postingId = (int) ($this->httpRequest->getParsedBody()['pos_pk'] ?? 0);
        if (0 === $postingId) {
            $postingId = (int) ($this->httpRequest->getQueryParams()['pos_pk'] ?? 0);
        }
 
        $this->currentPostingId = (int) $postingId;
    }

Referenced by __construct().

Here is the caller graph for this function:

◆ preloadChilds()

ilForumExplorerGUI::preloadChilds ( )

protected

@inheritDoc

Reimplemented from ilTreeExplorerGUI.

Definition at line 108 of file class.ilForumExplorerGUI.php.

    {
        $this->preloaded_children = [];
        $this->node_id_to_parent_node_id_map = [];
 
        $children = $this->thread->getNestedSetPostChildren($this->root_node->getId());
 
        array_walk($children, function (&$node, $key) {
            $this->node_id_to_parent_node_id_map[(int) $node['pos_pk']] = (int) $node['parent_pos'];
 
            if (!array_key_exists((int) $node['pos_pk'], $this->preloaded_children)) {
                $this->preloaded_children[(int) $node['pos_pk']] = [];
            }
 
            $this->preloaded_children[(int) $node['parent_pos']][$node['pos_pk']] = $node;
        });
 
        $this->preloaded = true;
    }

◆ setCurrentPage()

ilForumExplorerGUI::setCurrentPage ( int $currentPage )

Parameters

int $currentPage

Definition at line 100 of file class.ilForumExplorerGUI.php.

                                                     : void
    {
        $this->currentPage = $currentPage;
    }

References $currentPage.

Field Documentation

◆ $authorInformation

ilForumExplorerGUI::$authorInformation = []

protected

Definition at line 29 of file class.ilForumExplorerGUI.php.

◆ $currentPage

ilForumExplorerGUI::$currentPage = 0

private

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

Referenced by setCurrentPage().

◆ $currentPostingId

ilForumExplorerGUI::$currentPostingId = 0

protected

Definition at line 32 of file class.ilForumExplorerGUI.php.

◆ $max_entries

ilForumExplorerGUI::$max_entries = PHP_INT_MAX

protected

Definition at line 23 of file class.ilForumExplorerGUI.php.

◆ $node_id_to_parent_node_id_map

ilForumExplorerGUI::$node_id_to_parent_node_id_map = []

protected

Definition at line 20 of file class.ilForumExplorerGUI.php.

◆ $preloaded_children

ilForumExplorerGUI::$preloaded_children = []

protected

Definition at line 26 of file class.ilForumExplorerGUI.php.

◆ $root_node

ilForumExplorerGUI::$root_node

protected

Definition at line 17 of file class.ilForumExplorerGUI.php.

◆ $thread

ilForumExplorerGUI::$thread

protected

Definition at line 14 of file class.ilForumExplorerGUI.php.

Referenced by __construct().

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

Modules/Forum/classes/class.ilForumExplorerGUI.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ createNode()

◆ getAuthorInformationByNode()

◆ getChildren()

◆ getChildsOfNode()

◆ getNodeContent()

◆ getNodeHref()

◆ getNodeIcon()

◆ getNodeId()

◆ getNodeStateToggleCmdClasses()

◆ getTreeComponent()

◆ getTreeLabel()

◆ initPosting()

◆ preloadChilds()

◆ setCurrentPage()

Field Documentation

◆ $authorInformation

◆ $currentPage

◆ $currentPostingId

◆ $max_entries

◆ $node_id_to_parent_node_id_map

◆ $preloaded_children

◆ $root_node

◆ $thread