ilPCSection Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilPCSection:

Collaboration diagram for ilPCSection:

Public Member Functions
	init ()
	create (ilPageObject $a_pg_obj, string $a_hier_id, string $a_pc_id="")
	setCharacteristic (string $a_char)
	getCharacteristic ()
	modifyPageContentPostXsl (string $a_output, string $a_mode, bool $a_abstract_only=false)
	setActiveFrom (int $a_unix_ts)
	getActiveFrom ()
	Get activation from. More...
	setActiveTo (int $a_unix_ts)
	Set activation to. More...
	getActiveTo ()
	setPermission (string $a_val)
	Set permission. More...
	getPermission ()
	setPermissionRefId (int $a_ref_id)
	getPermissionRefId ()
	setNoLink ()
	Set no link. More...
	setExtLink (string $a_href)
	Set link of area to an external one. More...
	setIntLink (string $a_type, string $a_target, string $a_target_frame)
	Set link of area to an internal one. More...
	getLink ()
	handleAccess (string $a_html, string $a_mode)
	insertTimings (string $a_html)
	Insert timings (in edit mode) More...
	getProtected ()
	setProtected (bool $val)
	getModel ()
Public Member Functions inherited from ilPageContent
	__construct (ilPageObject $a_pg_obj, ?PageManagerInterface $page_manager=null, ?ObjectAdapterInterface $object_adapter=null)
	setPage (ilPageObject $a_val)
	getPage ()
	init ()
	Init object. More...
	getType ()
	getDomNode ()
	getDomDoc ()
	setDomNode (DOMNode $node)
	getChildNode ()
	getJavascriptFiles (string $a_mode)
	getCssFiles (string $a_mode)
	getOnloadCode (string $a_mode)
	setHierId (string $a_hier_id)
	getHierId ()
	lookupHierId ()
	readHierId ()
	setPcId (string $a_pcid)
	getPCId ()
	setFileDownloadLink (string $a_download_link)
	getFileDownloadLink ()
	setProfileBackUrl (string $url)
	getProfileBackUrl ()
	setFullscreenLink (string $a_fullscreen_link)
	getFullscreenLink ()
	setSourcecodeDownloadScript (string $script_name)
	getSourcecodeDownloadScript ()
	readPCId ()
	writePCId (string $a_pc_id)
	setEnabled (string $value)
	Set Enabled value for page content component. More...
	enable ()
	disable ()
	isEnabled ()
	createPageContentNode (bool $a_set_this_node=true)
	Create page content node (always use this method first when adding a new element) More...
	getNewPageContentNode ()
	modifyPageContentPostXsl (string $a_output, string $a_mode, bool $a_abstract_only=false)
	Modify page content after xsl. More...
	getModel ()
	Get model as needed for the front-end editor. More...

Static Public Member Functions
static	getLangVars ()
static	afterPageUpdate (ilPageObject $a_page, DOMDocument $a_domdoc, string $a_xml, bool $a_creation)
	After page has been updated (or created) More...
static	saveTimings (ilPageObject $a_page)
static	getCacheTriggerString (ilPageObject $a_page)
	Get page cache update trigger string. More...
Static Public Member Functions inherited from ilPageContent
static	sortHierIds (array $a_array)
	Sort an array of Hier IDS in ascending order. More...
static	isGreaterHierId (string $a, string $b)
	Check whether Hier ID $a is greater than Hier ID $b. More...
static	getLangVars ()
	Get lang vars needed for editing. More...
static	handleCopiedContent (DOMDocument $a_domdoc, bool $a_self_ass=true, bool $a_clone_mobs=false, int $new_parent_id=0, int $obj_copy_id=0)
	Handle copied content. More...
static	afterPageUpdate (ilPageObject $a_page, DOMDocument $a_domdoc, string $a_xml, bool $a_creation)
	After page has been updated (or created) More...
static	beforePageDelete (ilPageObject $a_page)
	Before page is being deleted. More...
static	afterRepositoryCopy (ilPageObject $page, array $mapping, int $source_ref_id)
	After repository (container) copy action. More...
static	afterPageHistoryEntry (ilPageObject $a_page, DOMDocument $a_old_domdoc, string $a_old_xml, int $a_old_nr)
	After page history entry has been created. More...
static	deleteHistoryLowerEqualThan (string $parent_type, int $page_id, string $lang, int $delete_lower_than_nr)
	Overwrite in derived classes, if old history entries are being deleted. More...

Protected Attributes
ilAccessHandler	$access
ilCtrl	$ctrl
ilLanguage	$lng
Protected Attributes inherited from ilPageContent
DOMDocument	$dom_doc
ILIAS COPage InternalDomainService	$domain
string	$pcid
string	$type = ""
ilPageObject	$pg_obj
string	$file_download_link
string	$fullscreen_link
string	$sourcecode_download_script
ilLogger	$log
string	$profile_back_url = ""
ILIAS COPage Dom DomUtil	$dom_util
PageManagerInterface	$page_manager = null
ObjectAdapterInterface	$object = null

Additional Inherited Members
Data Fields inherited from ilPageContent
string	$hier_id = ""
DOMNode	$dom_node = null
string	$page_lang = ""
Protected Member Functions inherited from ilPageContent
	getPageManager ()
	setType (string $a_type)
	Set Type. More...
	hasNode ()
	createInitialChildNode (string $hier_id, string $pc_id, string $child, array $child_attributes=[])

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class ilPCSection Section content object (see ILIAS DTD)

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 24 of file class.ilPCSection.php.

Member Function Documentation

afterPageUpdate()

static ilPCSection::afterPageUpdate ( ilPageObject  $a_page, DOMDocument  $a_domdoc, string  $a_xml, bool  $a_creation  )

static

After page has been updated (or created)

Definition at line 78 of file class.ilPCSection.php.

     : void {
        self::saveTimings($a_page);
    }

create()

ilPCSection::create	(	ilPageObject	$a_pg_obj,
		string	$a_hier_id,
		string	$a_pc_id = ""
	)

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

References ilPageContent\createInitialChildNode().

     : void {
        $this->createInitialChildNode(
            $a_hier_id,
            $a_pc_id,
            "Section",
            ["Characteristic" => "Block"]
        );
    }

Here is the call graph for this function:

getActiveFrom()

ilPCSection::getActiveFrom

(

)

Get activation from.

Definition at line 110 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

                                   : int
    {
        if (is_object($this->getChildNode())) {
            return (int) $this->getChildNode()->getAttribute("ActiveFrom");
        }
        return 0;
    }

Here is the call graph for this function:

getActiveTo()

ilPCSection::getActiveTo

(

)

Definition at line 127 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

                                 : int
    {
        if (is_object($this->getChildNode())) {
            return (int) $this->getChildNode()->getAttribute("ActiveTo");
        }
        return 0;
    }

Here is the call graph for this function:

getCacheTriggerString()

static ilPCSection::getCacheTriggerString ( ilPageObject  $a_page )

static

Get page cache update trigger string.

Returns

string trigger string

Exceptions

ilDateTimeException

Definition at line 316 of file class.ilPCSection.php.

References $DIC, $ilDB, ilPageObject\getId(), ilPageObject\getParentType(), and IL_CAL_UNIX.

Referenced by ilPageObjectGUI\showPage().

     : string {
        global $DIC;

        $ilDB = $DIC->database();

        $set = $ilDB->query(
            "SELECT * FROM copg_section_timings " .
            " WHERE page_id = " . $ilDB->quote($a_page->getId(), "integer") .
            " AND parent_type = " . $ilDB->quote($a_page->getParentType(), "text")
        );
        $str = "1";     // changed to 1 to force cache miss for #24277
        $current_ts = new ilDateTime(time(), IL_CAL_UNIX);
        $current_ts = $current_ts->get(IL_CAL_UNIX);
        while ($rec = $ilDB->fetchAssoc($set)) {
            $unix_ts = $rec["unix_ts"];
            if ($unix_ts < $current_ts) {
                $unix_ts .= "a";
            }
            $str .= "-" . $unix_ts;
        }

        return $str;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCharacteristic()

ilPCSection::getCharacteristic

(

)

Definition at line 58 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

                                       : string
    {
        if (is_object($this->getChildNode())) {
            $char = $this->getChildNode()->getAttribute("Characteristic");
            if (substr($char, 0, 4) == "ilc_") {
                $char = substr($char, 4);
            }
            return $char;
        }
        return "";
    }

Here is the call graph for this function:

getLangVars()

static ilPCSection::getLangVars ( )

static

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

                                        : array
    {
        return array("ed_insert_section");
    }

getLink()

ilPCSection::getLink

(

)

Definition at line 209 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

                             : array
    {
        $childs = $this->getChildNode()->childNodes;
        foreach ($childs as $child) {
            if ($child->nodeName === "ExtLink") {
                return array("LinkType" => "ExtLink",
                    "Href" => $child->getAttribute("Href"));
            }
            if ($child->nodeName === "IntLink") {
                return array("LinkType" => "IntLink",
                    "Target" => $child->getAttribute("Target"),
                    "Type" => $child->getAttribute("Type"),
                    "TargetFrame" => $child->getAttribute("TargetFrame"));
            }
        }
        return array("LinkType" => "NoLink");
    }

Here is the call graph for this function:

getModel()

ilPCSection::getModel

(

)

Definition at line 406 of file class.ilPCSection.php.

References ilPageContent\getChildNode(), getProtected(), and null.

                              : ?stdClass
    {
        if ($this->getChildNode()->nodeName !== "Section") {
            return null;
        }
        $model = new stdClass();
        $model->protected = $this->getProtected();

        return $model;
    }

Here is the call graph for this function:

getPermission()

ilPCSection::getPermission

(

)

Definition at line 144 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

                                   : string
    {
        return $this->getChildNode()->getAttribute("Permission");
    }

Here is the call graph for this function:

getPermissionRefId()

ilPCSection::getPermissionRefId

(

)

Definition at line 154 of file class.ilPCSection.php.

References $id, ilPageContent\getChildNode(), and IL_INST_ID.

                                        : int
    {
        $id = explode("_", $this->getChildNode()->getAttribute("PermissionRefId"));
        if (isset($id[3]) && in_array($id[1], array("", 0, IL_INST_ID))) {
            return (int) $id[3];
        }
        return 0;
    }

Here is the call graph for this function:

getProtected()

ilPCSection::getProtected

(

)

Definition at line 388 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

Referenced by getModel().

                                  : bool
    {
        if (is_object($this->getChildNode())) {
            return ($this->getChildNode()->getAttribute("Protected") === "1");
        }

        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleAccess()

ilPCSection::handleAccess	(	string	$a_html,
		string	$a_mode
	)

Definition at line 228 of file class.ilPCSection.php.

References $access, $id, ilRBACAccessHandler\checkAccess(), ilPageObjectGUI\EDIT, and IL_INST_ID.

Referenced by modifyPageContentPostXsl().

     : string {
        $ilAccess = $this->access;

        while (($start = strpos($a_html, "{{{{{Section;Access;")) > 0) {
            $end = strpos($a_html, "}}}}}", $start);
            $access_attr = explode(";", substr($a_html, $start, $end - $start));
            $id = explode("_", $access_attr[3]);
            $section_nr = $access_attr[6];
            $access = true;
            if (in_array($id[1], array("", 0, IL_INST_ID)) && $id[3] > 0) {
                if ($access_attr[5] == "no_read") {
                    $access = !$ilAccess->checkAccess("read", "", $id[3]);
                } else {
                    $access = $ilAccess->checkAccess($access_attr[5], "", $id[3]);
                }
            }
            if ($a_mode == ilPageObjectGUI::EDIT) {
                $access = true;
            }
            $end_limiter = "{{{{{Section;AccessEnd;" . $section_nr . "}}}}}";
            if ($access) {
                $a_html = substr($a_html, 0, $start) . substr($a_html, $end + 5);
                $a_html = str_replace($end_limiter, "", $a_html);
            } else {
                $end = strpos($a_html, $end_limiter, $start);
                $a_html = substr($a_html, 0, $start) . substr($a_html, $end + strlen($end_limiter));
            }
        }

        $a_html = str_replace("{{{{{Section;Access}}}}}", "", $a_html);
        return $a_html;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

init()

ilPCSection::init

(

)

Definition at line 30 of file class.ilPCSection.php.

References $DIC, ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ilPageContent\setType().

                          : void
    {
        global $DIC;

        $this->access = $DIC->access();
        $this->ctrl = $DIC->ctrl();
        $this->lng = $DIC->language();
        $this->setType("sec");
    }

Here is the call graph for this function:

insertTimings()

ilPCSection::insertTimings

(

string

$a_html

)

Insert timings (in edit mode)

Exceptions

ilDateTimeException

Definition at line 346 of file class.ilPCSection.php.

References $lng, $param, ilDatePresentation\formatDate(), IL_CAL_UNIX, ilDatePresentation\setUseRelativeDates(), and ilLanguage\txt().

     : string {
        $lng = $this->lng;

        $end = 0;
        $start = strpos($a_html, "{{{{{Section;ActiveFrom");
        if (is_int($start)) {
            $end = strpos($a_html, "}}}}}", $start);
        }
        $i = 1;
        while ($end > 0) {
            $param = substr($a_html, $start + 13, $end - $start - 13);
            $param = explode(";", $param);
            $from = $param[1];
            $to = $param[3];
            $html = "";
            if ($from != "") {
                ilDatePresentation::setUseRelativeDates(false);
                $from = new ilDateTime($from, IL_CAL_UNIX);
                $html .= $lng->txt("cont_active_from") . ": " . ilDatePresentation::formatDate($from);
            }
            if ($to != "") {
                $to = new ilDateTime($to, IL_CAL_UNIX);
                $html .= " " . $lng->txt("cont_active_to") . ": " . ilDatePresentation::formatDate($to);
            }

            $h2 = substr($a_html, 0, $start) .
                $html .
                substr($a_html, $end + 5);
            $a_html = $h2;
            $i++;

            $start = strpos($a_html, "{{{{{Section;ActiveFrom;", $start + 5);
            $end = 0;
            if (is_int($start)) {
                $end = strpos($a_html, "}}}}}", $start);
            }
        }
        return $a_html;
    }

Here is the call graph for this function:

modifyPageContentPostXsl()

ilPCSection::modifyPageContentPostXsl	(	string	$a_output,
		string	$a_mode,
		bool	$a_abstract_only = false
	)

Exceptions

ilDateTimeException

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

References handleAccess().

     : string {
        $a_output = self::insertTimings($a_output);
        $a_output = $this->handleAccess($a_output, $a_mode);

        return $a_output;
    }

Here is the call graph for this function:

saveTimings()

static ilPCSection::saveTimings ( ilPageObject  $a_page )

static

Definition at line 264 of file class.ilPCSection.php.

References $DIC, ilPageContent\$dom_util, $ilDB, $path, ilPageObject\getDomDoc(), ilPageObject\getId(), and ilPageObject\getParentType().

     : void {
        global $DIC;

        $ilDB = $DIC->database();
        $dom_util = $DIC->copage()->internal()->domain()->domUtil();

        $ilDB->manipulate(
            "DELETE FROM copg_section_timings WHERE " .
            " page_id = " . $ilDB->quote($a_page->getId(), "integer") .
            " AND parent_type = " . $ilDB->quote($a_page->getParentType(), "text")
        );

        $doc = $a_page->getDomDoc();

        // media aliases
        $path = "//Section";
        $nodes = $dom_util->path($doc, $path);
        foreach ($nodes as $node) {
            $from = $node->getAttribute("ActiveFrom");
            if ($from != "") {
                $ilDB->replace(
                    "copg_section_timings",
                    array(
                        "page_id" => array("integer", $a_page->getId()),
                        "parent_type" => array("text", $a_page->getParentType()),
                        "unix_ts" => array("integer", $from)
                        ),
                    array()
                );
            }
            $to = $node->getAttribute("ActiveTo");
            if ($to != "") {
                $ilDB->replace(
                    "copg_section_timings",
                    array(
                        "page_id" => array("integer", $a_page->getId()),
                        "parent_type" => array("text", $a_page->getParentType()),
                        "unix_ts" => array("integer", $to)
                    ),
                    array()
                );
            }
        }
    }

Here is the call graph for this function:

setActiveFrom()

ilPCSection::setActiveFrom

(

int

$a_unix_ts

)

Definition at line 101 of file class.ilPCSection.php.

References ilPageContent\getChildNode(), and null.

                                                 : void
    {
        $a_unix_ts = ($a_unix_ts > 0) ? (string) $a_unix_ts : null;
        $this->dom_util->setAttribute($this->getChildNode(), "ActiveFrom", $a_unix_ts);
    }

Here is the call graph for this function:

setActiveTo()

ilPCSection::setActiveTo

(

int

$a_unix_ts

)

Set activation to.

Definition at line 121 of file class.ilPCSection.php.

References ilPageContent\getChildNode(), and null.

                                               : void
    {
        $a_unix_ts = ($a_unix_ts > 0) ? (string) $a_unix_ts : null;
        $this->dom_util->setAttribute($this->getChildNode(), "ActiveTo", $a_unix_ts);
    }

Here is the call graph for this function:

setCharacteristic()

ilPCSection::setCharacteristic

(

string

$a_char

)

Definition at line 53 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

                                                     : void
    {
        $this->dom_util->setAttribute($this->getChildNode(), "Characteristic", $a_char);
    }

Here is the call graph for this function:

setExtLink()

ilPCSection::setExtLink

(

string

$a_href

)

Set link of area to an external one.

Definition at line 174 of file class.ilPCSection.php.

References ilPageContent\getChildNode(), and setNoLink().

                                              : void
    {
        $this->setNoLink();
        if (trim($a_href) != "") {
            $attributes = array("Href" => trim($a_href));
            $this->dom_util->setFirstOptionalElement(
                $this->getChildNode(),
                "ExtLink",
                [],
                "",
                $attributes
            );
        }
    }

Here is the call graph for this function:

setIntLink()

ilPCSection::setIntLink	(	string	$a_type,
		string	$a_target,
		string	$a_target_frame
	)

Set link of area to an internal one.

Definition at line 192 of file class.ilPCSection.php.

References ilPageContent\getChildNode(), and setNoLink().

     : void {
        $this->setNoLink();
        $attributes = array("Type" => $a_type, "Target" => $a_target,
            "TargetFrame" => $a_target_frame);
        $this->dom_util->setFirstOptionalElement(
            $this->getChildNode(),
            "IntLink",
            [],
            "",
            $attributes
        );
    }

Here is the call graph for this function:

setNoLink()

ilPCSection::setNoLink

(

)

Set no link.

Definition at line 166 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

Referenced by setExtLink(), and setIntLink().

                               : void
    {
        $this->dom_util->deleteAllChildsByName($this->getChildNode(), ["IntLink", "ExtLink"]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setPermission()

ilPCSection::setPermission

(

string

$a_val

)

Set permission.

Parameters

string

$a_val

"read"|"write"|"visible"|"no_read"

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

References ilPageContent\getChildNode().

                                                : void
    {
        $this->dom_util->setAttribute($this->getChildNode(), "Permission", $a_val);
    }

Here is the call graph for this function:

setPermissionRefId()

ilPCSection::setPermissionRefId

(

int

$a_ref_id

)

Definition at line 149 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

                                                     : void
    {
        $this->dom_util->setAttribute($this->getChildNode(), "PermissionRefId", "il__ref_" . $a_ref_id);
    }

Here is the call graph for this function:

setProtected()

ilPCSection::setProtected

(

bool

$val

)

Definition at line 397 of file class.ilPCSection.php.

References ilPageContent\getChildNode().

                                           : void
    {
        if ($val) {
            $this->getChildNode()->setAttribute("Protected", "1");
        } else {
            $this->getChildNode()->setAttribute("Protected", "0");
        }
    }

Here is the call graph for this function:

Field Documentation

$access

ilAccessHandler ilPCSection::$access

protected

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

Referenced by handleAccess().

$ctrl

ilCtrl ilPCSection::$ctrl

protected

Definition at line 27 of file class.ilPCSection.php.

$lng

ilLanguage ilPCSection::$lng

protected

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

Referenced by insertTimings().

---

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

• components/ILIAS/COPage/PC/Section/class.ilPCSection.php