ilObjForumListGUI Class Reference

Class ilObjForumListGUI. More...

Inheritance diagram for ilObjForumListGUI:

Collaboration diagram for ilObjForumListGUI:

Public Member Functions
	__construct ()
	Constructor. More...
	setChildId ($a_child_id)
	getChildId ()
	init ()
	initialisation More...
	getProperties ()
	{Get item properties.Overwrite this method to add properties at the bottom of the item html Returns array array of property arrays: "alert" (boolean) => display as an alert property (usually in red) "property" (string) => property name "value" (string) => property value } More...
	getCommandFrame ($a_cmd)
	{Get command target frame.Overwrite this method if link frame is not current frame Parameters string $a_cmd command Returns string command target frame } More...
	getCommandLink ($a_cmd)
	{Get command link url.Overwrite this method, if link target is not build by ctrl class (e.g. "forum.php"). This is the case for all links now, but bringing everything to ilCtrl should be realised in the future. Parameters string $a_cmd command Returns string command link url } More...
Public Member Functions inherited from ilObjectListGUI
	__construct ($a_context=self::CONTEXT_REPOSITORY)
	constructor More...
	setContainerObject ($container_obj)
	set the container object (e.g categorygui) Used for link, delete ... commands More...
	getContainerObject ()
	get container object More...
	init ()
	initialisation More...
	enableProperties ($a_status)
	En/disable properties. More...
	getPropertiesStatus ()
	enablePreconditions ($a_status)
	En/disable preconditions. More...
	getNoticePropertiesStatus ()
	enableNoticeProperties ($a_status)
	En/disable notices. More...
	getPreconditionsStatus ()
	enableDescription ($a_status)
	En/disable description. More...
	getDescriptionStatus ()
	getSearchFragmentStatus ()
	Show hide search result fragments. More...
	enableSearchFragments ($a_status)
	En/disable description. More...
	enableLinkedPath ($a_status)
	Enable linked path. More...
	enabledRelevance ()
	enabled relevance More...
	enableRelevance ($a_status)
	enable relevance More...
	setRelevance ($a_rel)
	set relevance More...
	getRelevance ()
	get relevance More...
	enableIcon ($a_status)
	En/Dis-able icons. More...
	getIconStatus ()
	Are icons enabled? More...
	enableCheckbox ($a_status)
	En/Dis-able checkboxes. More...
	getCheckboxStatus ()
	Are checkboxes enabled? More...
	enableExpand ($a_status)
	En/Dis-able expand/collapse link. More...
	getExpandStatus ()
	Is expand/collapse enabled. More...
	setExpanded ($a_status)
	isExpanded ()
	setPositionInputField ($a_field_index, $a_position_value)
	Set position input field. More...
	enableDelete ($a_status)
	En/disable delete. More...
	getDeleteStatus ()
	enableCut ($a_status)
	En/disable cut. More...
	getCutStatus ()
	enableCopy ($a_status)
	En/disable copy. More...
	getCopyStatus ()
	enableSubscribe ($a_status)
	En/disable subscribe. More...
	getSubscribeStatus ()
	enableLink ($a_status)
	En/disable link. More...
	getLinkStatus ()
	enablePath ($a_path, $a_start_node=null)
	En/disable path. More...
	getPathStatus ()
	enableCommands ($a_status, $a_std_only=false)
	En/disable commands. More...
	getCommandsStatus ()
	enableInfoScreen ($a_info_screen)
	En/disable path. More...
	addSubItemHTML ($a_html)
	Add HTML for subitem (used for sessions) More...
	getInfoScreenStatus ()
	enableProgressInfo ($a_status)
	enable progress info More...
	getProgressInfoStatus ()
	get progress info status More...
	enableSubstitutions ($a_status)
	Enable substitutions. More...
	getSubstitutionStatus ()
	Get substitution status. More...
	enableItemDetailLinks ($a_status)
	enable item detail links E.g Direct links to chapters or pages More...
	getItemDetailLinkStatus ()
	get item detail link status More...
	setItemDetailLinks ($a_detail_links, $a_intro_txt='')
	set items detail links More...
	insertItemDetailLinks ()
	insert item detail links More...
	setTitle ($a_title)
	getTitle ()
	getTitle overwritten in class.ilObjLinkResourceList.php More...
	setDescription ($a_description)
	getDescription ()
	getDescription overwritten in class.ilObjLinkResourceList.php More...
	setSearchFragment ($a_text)
	set search fragment More...
	getSearchFragment ()
	get search fragment More...
	setSeparateCommands ($a_val)
	Set separate commands. More...
	getSeparateCommands ()
	Get separate commands. More...
	getCommandId ()
	get command id Normally the ref id. More...
	setAdditionalInformation ($a_val)
	Set additional information. More...
	getAdditionalInformation ()
	Get additional information. More...
	setDetailsLevel ($a_level)
	Details level Currently used in Search which shows only limited properties of forums Currently used for Sessions (switch between minimal and extended view for each session) More...
	getDetailsLevel ()
	Get current details level. More...
	enableRepositoryTransfer ($a_value)
	Enable copy/move to repository (from personal workspace) More...
	restrictToGoto ($a_value)
	Restrict all actions/links to goto. More...
	checkCommandAccess ($a_permission, $a_cmd, $a_ref_id, $a_type, $a_obj_id="")
	initItem ($a_ref_id, $a_obj_id, $a_title="", $a_description="")
	inititialize new item (is called by getItemHTML()) More...
	setConditionTarget ($a_ref_id, $a_obj_id, $a_target_type)
	resetConditionTarget ()
	disableTitleLink ($a_status)
	setDefaultCommandParameters (array $a_params)
	createDefaultCommand ($command)
	Get default command link Overwritten for e.g categories,courses => they return a goto link If search engine visibility is enabled these object type return a goto_CLIENT_ID_cat_99.html link. More...
	getCommandLink ($a_cmd)
	Get command link url. More...
	getCommandFrame ($a_cmd)
	Get command target frame. More...
	getCommandImage ($a_cmd)
	Get command icon image. More...
	getProperties ()
	Get item properties. More...
	addCustomProperty ( $a_property="", $a_value="", $a_alert=false, $a_newline=false)
	add custom property More...
	getCustomProperties ($a_prop)
	get custom properties More...
	getAlertProperties ()
	get all alert properties More...
	getNoticeProperties ()
	get notice properties More...
	addCustomCommand ($a_link, $a_lang_var, $a_frame="", $onclick="")
	add a custom command More...
	forceVisibleOnly ($a_stat)
	Force visible access only. More...
	isVisibleOnlyForced ()
	Force unreadable. More...
	getCommands ()
	get all current commands for a specific ref id (in the permission context of the current user) More...
	getIconImageType ()
	Returns the icon image type. More...
	insertTitle ()
	insert item title More...
	insertSubstitutions ()
	Insert substitutions. More...
	insertDescription ()
	insert item description More...
	insertSearchFragment ()
	Insert highlighted search fragment. More...
	insertRelevance ()
	insert relevance More...
	setMode ($a_mode)
	set output mode More...
	getMode ()
	get output mode More...
	setConditionDepth ($a_depth)
	set depth for precondition output (stops at level 5) More...
	isMode ($a_mode)
	check current output mode More...
	insertProperties ()
	insert properties More...
	insertNoticeProperties ()
	insertPreconditions ()
	insert all missing preconditions More...
	insertCommand ($a_href, $a_text, $a_frame="", $a_img="", $a_cmd="", $a_onclick="")
	insert command button More...
	insertDeleteCommand ()
	insert cut command More...
	insertLinkCommand ()
	insert link command More...
	insertCutCommand ($a_to_repository=false)
	insert cut command More...
	insertCopyCommand ($a_to_repository=false)
	Insert copy command. More...
	insertPasteCommand ()
	Insert paste command. More...
	insertSubscribeCommand ()
	insert subscribe command More...
	insertInfoScreenCommand ()
	insert info screen command More...
	insertCommonSocialCommands ($a_header_actions=false)
	Insert common social commands (comments, notes, tagging) More...
	insertTimingsCommand ()
	insert edit timings command More...
	insertCommands ( $a_use_asynch=false, $a_get_asynch_commands=false, $a_asynch_url="", $a_header_actions=false)
	insert all commands into html code More...
	enableComments ($a_value, $a_enable_comments_settings=true)
	Toogle comments action status. More...
	enableNotes ($a_value)
	Toogle notes action status. More...
	enableTags ($a_value)
	Toogle tags action status. More...
	enableRating ($a_value, $a_text=null, $a_categories=false, array $a_ctrl_path=null)
	Toogle rating action status. More...
	enableMultiDownload ($a_value)
	Toggles whether multiple objects can be downloaded at once or not. More...
	insertMultiDownloadCommand ()
	enableDownloadCheckbox ($a_ref_id, $a_value)
	getDownloadCheckboxState ()
	setHeaderSubObject ($a_type, $a_id)
	Set sub object identifier. More...
	addHeaderIcon ($a_id, $a_img, $a_tooltip=null, $a_onclick=null, $a_status_text=null, $a_href=null)
	addHeaderIconHTML ($a_id, $a_html)
	addHeaderGlyph ($a_id, $a_glyph, $a_onclick=null)
	setAjaxHash ($a_hash)
	getHeaderAction (ilTemplate $a_main_tpl=null)
	Get header action. More...
	appendRepositoryFrameParameter ($a_link)
	workaround: all links into the repository (from outside) must tell repository to setup the frameset More...
	modifySAHSlaunch ($a_link, $wtarget)
	workaround: SAHS in new javavasript-created window or iframe More...
	insertPath ()
	insert path More...
	insertProgressInfo ()
	insert progress info More...
	insertIconsAndCheckboxes ()
	Insert icons and checkboxes. More...
	insertSubItems ()
	Insert subitems. More...
	insertPositionField ()
	Insert field for positioning. More...
	adminCommandsIncluded ()
	returns whether any admin commands (link, delete, cut) are included in the output More...
	storeAccessCache ()
	Store access cache. More...
	getListItemHTML ( $a_ref_id, $a_obj_id, $a_title, $a_description, $a_use_asynch=false, $a_get_asynch_commands=false, $a_asynch_url="")
	Get all item information (title, commands, description) in HTML. More...
	setParentRefId ($a_ref_id)
	Set current parent ref id to enable unique js-ids (sessions, etc.) More...
	getCommandsHTML ()
	Get commands HTML (must be called after get list item html) More...
	isSideBlock ()
	Returns whether current item is a block in a side column or not. More...
	setBoldTitle ($a_bold_title)
	@access public @params boolean $a_bold_title set the item title bold More...
	isTitleBold ()
	@access public More...
	enableTimings ($a_status)
	enable timings link More...
	isFileUploadAllowed ()
	Gets a value indicating whether file uploads to this object are allowed or not. More...
	insertFileUpload ()
	Inserts a file upload component. More...

Data Fields
	$lng
	$user
	$access
	$settings
Data Fields inherited from ilObjectListGUI
const	DETAILS_MINIMAL = 10
const	DETAILS_SEARCH = 20
const	DETAILS_ALL = 30
const	CONTEXT_REPOSITORY = 1
const	CONTEXT_WORKSPACE = 2
const	CONTEXT_WORKSPACE_SHARING = 4
const	CONTEXT_PERSONAL_DESKTOP = 5
const	CONTEXT_SEARCH = 6
const	DOWNLOAD_CHECKBOX_NONE = 0
const	DOWNLOAD_CHECKBOX_ENABLED = 1
const	DOWNLOAD_CHECKBOX_DISABLED = 2
	$ctrl
	$description_enabled = true
	$preconditions_enabled = true
	$properties_enabled = true
	$notice_properties_enabled = true
	$commands_enabled = true
	$cust_prop = array()
	$cust_commands = array()
	$info_screen_enabled = false
	$condition_depth = 0
	$std_cmd_only = false
	$sub_item_html = array()
	$multi_download_enabled = false
	$download_checkbox_state = self::DOWNLOAD_CHECKBOX_NONE

Additional Inherited Members
Static Public Member Functions inherited from ilObjectListGUI
static	prepareJsLinks ($a_redraw_url, $a_notes_url, $a_tags_url, $a_tpl=null)
	Insert js/ajax links into template. More...
static	preloadCommonProperties ($a_obj_ids, $a_context)
	Preload common properties. More...
Protected Member Functions inherited from ilObjectListGUI
	buildGotoLink ()
	parseConditions ($toggle_id, $conditions, $obligatory=true)
	modifyTitleLink ($a_default_link)
	resetCustomData ()
	reset properties and commands More...
	getUniqueItemId ($a_as_div=false)
	Get unique item identifier (for js-actions) More...
	isCommentsActivated ($a_type, $a_ref_id, $a_obj_id, $a_header_actions, $a_check_write_access=true)
	Check comments status against comments settings and context. More...
Protected Attributes inherited from ilObjectListGUI
	$access
	$lng
	$user
	$obj_definition
	$tree
	$settings
	$tpl
	$obj_id
	$ref_id
	$type
	$sub_obj_id
	$sub_obj_type
	$substitutions = null
	$substitutions_enabled = false
	$icons_enabled = false
	$checkboxes_enabled = false
	$position_enabled = false
	$progress_enabled = false
	$item_detail_links_enabled = false
	$item_detail_links = array()
	$item_detail_links_intro = ''
	$search_fragments_enabled = false
	$search_fragment = ''
	$path_linked = false
	$enabled_relevance = false
	$relevance = 0
	$expand_enabled = false
	$is_expanded = true
	$bold_title = false
	$copy_enabled = true
	$details_level = self::DETAILS_ALL
	$reference_ref_id = false
	$separate_commands = false
	$search_fragment_enabled = false
	$additional_information = false
	$static_link_enabled = false
	$repository_transfer_enabled = false
	$shared = false
	$restrict_to_goto = false
	$comments_enabled = false
	$comments_settings_enabled = false
	$notes_enabled = false
	$tags_enabled = false
	$rating_enabled = false
	$rating_categories_enabled = false
	$rating_text = false
	$rating_ctrl_path = false
	$timings_enabled = true
	$force_visible_only = false
	$prevent_duplicate_commands = array()
	$parent_ref_id
	$context
	$title_link = ''
	$title_link_disabled = false
	$ui
Static Protected Attributes inherited from ilObjectListGUI
static	$cnt_notes = array()
static	$cnt_tags = array()
static	$tags = array()
static	$comments_activation = array()
static	$preload_done = false
static	$js_unique_id = 0
static	$tpl_file_name = "tpl.container_list_item.html"
static	$tpl_component = "Services/Container"

Detailed Description

Class ilObjForumListGUI.

Author

Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e $Id$

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

Constructor & Destructor Documentation

__construct()

ilObjForumListGUI::__construct

(

)

Constructor.

Definition at line 22 of file class.ilObjForumListGUI.php.

    {
        parent::__construct();
        
        global $DIC;
        $this->lng = $DIC->language();
        $this->user = $DIC->user();
        $this->access = $DIC->access();
        $this->settings = $DIC->settings();
    }

References $DIC, settings(), and user().

Here is the call graph for this function:

Member Function Documentation

getChildId()

ilObjForumListGUI::getChildId

(

)

Returns

int

Definition at line 44 of file class.ilObjForumListGUI.php.

    {
        return $this->child_id;
    }

Referenced by getCommandLink().

Here is the caller graph for this function:

getCommandFrame()

ilObjForumListGUI::getCommandFrame

(

$a_cmd

)

{Get command target frame.Overwrite this method if link frame is not current frame

Parameters

string

$a_cmd

command

Returns

string command target frame

}

Reimplemented from ilObjectListGUI.

Definition at line 183 of file class.ilObjForumListGUI.php.

    {
        return ilFrameTargetInfo::_getFrame('MainContent');
    }

References ilFrameTargetInfo\_getFrame().

Here is the call graph for this function:

getCommandLink()

ilObjForumListGUI::getCommandLink

(

$a_cmd

)

{Get command link url.Overwrite this method, if link target is not build by ctrl class (e.g. "forum.php"). This is the case for all links now, but bringing everything to ilCtrl should be realised in the future.

Parameters

string

$a_cmd

command

Returns

string command link url

}

Reimplemented from ilObjectListGUI.

Definition at line 191 of file class.ilObjForumListGUI.php.

    {
        switch ($a_cmd) {
            case 'thread':
                return 'ilias.php?baseClass=ilRepositoryGUI&cmd=viewThread&cmdClass=ilobjforumgui&ref_id=' . $this->ref_id . '&thr_pk=' . $this->getChildId();
 
            case 'posting':
                $thread_post = $this->getChildId();
                return 'ilias.php?baseClass=ilRepositoryGUI&cmd=viewThread&cmdClass=ilobjforumgui&target=1&ref_id=' . $this->ref_id . '&thr_pk=' . $thread_post[0] . '&pos_pk=' . $thread_post[1] . '#' . $thread_post[1];
 
            default:
                return parent::getCommandLink($a_cmd);
        }
    }

References getChildId().

Here is the call graph for this function:

getProperties()

ilObjForumListGUI::getProperties

(

)

{Get item properties.Overwrite this method to add properties at the bottom of the item html

Returns

array array of property arrays: "alert" (boolean) => display as an alert property (usually in red) "property" (string) => property name "value" (string) => property value

}

Reimplemented from ilObjectListGUI.

Definition at line 69 of file class.ilObjForumListGUI.php.

    {
        if (!$this->access->checkAccess('read', '', $this->ref_id)) {
            return array();
        }
 
        $this->lng->loadLanguageModule('forum');
 
        $props = array();
 
        include_once 'Modules/Forum/classes/class.ilObjForumAccess.php';
        $properties       = ilObjForumAccess::getStatisticsByRefId($this->ref_id);
        $num_posts_total  = $properties['num_posts'];
        $num_unread_total = $properties['num_unread_posts'];
 
        include_once 'Modules/Forum/classes/class.ilForumPostDraft.php';
        $num_drafts_total = 0;
        if (ilForumPostDraft::isSavePostDraftAllowed()) {
            $drafts_statistics = ilForumPostDraft::getDraftsStatisticsByRefId($this->ref_id);
            $num_drafts_total = $drafts_statistics['total'];
        }
 
        $frm_overview_setting = (int) $this->settings->get('forum_overview');
        $num_new_total = 0;
        if ($frm_overview_setting == ilForumProperties::FORUM_OVERVIEW_WITH_NEW_POSTS) {
            $num_new_total    = $properties['num_new_posts'];
        }
        
        $last_post        = ilObjForumAccess::getLastPostByRefId($this->ref_id);
 
        if (!$this->user->isAnonymous()) {
            if ($this->getDetailsLevel() == ilObjectListGUI::DETAILS_ALL) {
                $alert   = ($num_unread_total > 0) ? true : false;
                $props[] = array(
                    'alert'     => $alert,
                    'property' => $this->lng->txt('forums_articles') . ' (' . $this->lng->txt('unread') . ')',
                    'value'     => $num_posts_total . ' (' . $num_unread_total . ')'
                );
                if ($frm_overview_setting == ilForumProperties::FORUM_OVERVIEW_WITH_NEW_POSTS) {
                    if ($num_new_total > 0) {
                        // New
                        $alert   = ($num_new_total > 0) ? true : false;
                        $props[] = array(
                            'alert' => $alert, 'property' => $this->lng->txt('forums_new_articles'), 'value' => $num_new_total
                        );
                    }
                }
            }
            
            if (ilForumPostDraft::isSavePostDraftAllowed() && $num_drafts_total > 0) {
                $props[] = array(
                    'alert'    => ($num_drafts_total > 0) ? true : false,
                    'property' => $this->lng->txt('drafts'),
                    'value'    => $num_drafts_total
                );
            }
        } else {
            $props[] = array(
                'alert' => false,
                'property' => $this->lng->txt('forums_articles'),
                'value' => $num_posts_total
            );
        }
 
        include_once 'Modules/Forum/classes/class.ilForumProperties.php';
        if ($this->getDetailsLevel() == ilObjectListGUI::DETAILS_ALL) {
            if (ilForumProperties::getInstance($this->obj_id)->isAnonymized()) {
                $props[] = array(
                    'alert'     => false,
                    'newline'  => false,
                    'property' => $this->lng->txt('forums_anonymized'),
                    'value'     => $this->lng->txt('yes')
                );
            }
        }
 
        // Last Post
        if ((int) $last_post['pos_pk']) {
            $lpCont = "<a class=\"il_ItemProperty\" target=\"" . ilFrameTargetInfo::_getFrame('MainContent') .
                "\" href=\"ilias.php?baseClass=ilRepositoryGUI&amp;cmd=viewThread&amp;cmdClass=ilobjforumgui&amp;target=true&amp;pos_pk=" .
                $last_post['pos_pk'] . "&amp;thr_pk=" . $last_post['pos_thr_fk'] . "&amp;ref_id=" .
                $this->ref_id . "#" . $last_post["pos_pk"] . "\">" .
                ilObjForumAccess::prepareMessageForLists($last_post['pos_message']) . "</a> " .
                strtolower($this->lng->txt('from')) . "&nbsp;";
 
            require_once 'Modules/Forum/classes/class.ilForumAuthorInformation.php';
            $authorinfo = new ilForumAuthorInformation(
                $last_post['pos_author_id'],
                $last_post['pos_display_user_id'],
                $last_post['pos_usr_alias'],
                $last_post['import_name'],
                array(
                     'class' => 'il_ItemProperty',
                     'href'  => 'ilias.php?baseClass=ilRepositoryGUI&amp;cmd=showUser&amp;cmdClass=ilobjforumgui&amp;ref_id=' . $this->ref_id . '&amp;user=' . $last_post['pos_display_user_id'] . '&amp;offset=0&amp;backurl=' . urlencode('ilias.php?baseClass=ilRepositoryGUI&amp;ref_id=' . $_GET['ref_id'])
                )
            );
 
            $lpCont .= $authorinfo->getLinkedAuthorName();
            $lpCont .= ', ' . ilDatePresentation::formatDate(new ilDateTime($last_post['pos_date'], IL_CAL_DATETIME));
 
            $props[] = array(
                'alert' => false,
                'newline'  => true,
                'property' => $this->lng->txt('forums_last_post'),
                'value' => $lpCont
            );
        }
 
        return $props;
    }

References $_GET, ilFrameTargetInfo\_getFrame(), ilObjectListGUI\DETAILS_ALL, ilDatePresentation\formatDate(), ilForumProperties\FORUM_OVERVIEW_WITH_NEW_POSTS, ilObjectListGUI\getDetailsLevel(), ilForumPostDraft\getDraftsStatisticsByRefId(), ilForumProperties\getInstance(), ilObjForumAccess\getLastPostByRefId(), ilObjForumAccess\getStatisticsByRefId(), IL_CAL_DATETIME, ilForumPostDraft\isSavePostDraftAllowed(), ilObjForumAccess\prepareMessageForLists(), settings(), and user().

Here is the call graph for this function:

init()

ilObjForumListGUI::init

(

)

initialisation

this method should be overwritten by derived classes

Reimplemented from ilObjectListGUI.

Definition at line 49 of file class.ilObjForumListGUI.php.

    {
        $this->static_link_enabled = true;
        $this->delete_enabled      = true;
        $this->cut_enabled         = true;
        $this->copy_enabled        = true;
        $this->subscribe_enabled   = true;
        $this->link_enabled        = true;
        $this->info_screen_enabled = true;
        $this->type                = 'frm';
        $this->gui_class_name      = 'ilobjforumgui';
 
        // general commands array
        include_once 'Modules/Forum/classes/class.ilObjForumAccess.php';
        $this->commands = ilObjForumAccess::_getCommands();
    }

References ilObjForumAccess\_getCommands().

Here is the call graph for this function:

setChildId()

ilObjForumListGUI::setChildId

(

$a_child_id

)

Parameters

int

$a_child_id

Definition at line 36 of file class.ilObjForumListGUI.php.

    {
        $this->child_id = $a_child_id;
    }

Field Documentation

$access

ilObjForumListGUI::$access

Definition at line 16 of file class.ilObjForumListGUI.php.

$lng

ilObjForumListGUI::$lng

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

$settings

ilObjForumListGUI::$settings

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

$user

ilObjForumListGUI::$user

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

---

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

• Modules/Forum/classes/class.ilObjForumListGUI.php