ilPCContentInclude Class Reference

Class ilPCContentInclude. More...

Inheritance diagram for ilPCContentInclude:

Collaboration diagram for ilPCContentInclude:

Public Member Functions
	init ()
	Init page content component. More...
	create (ilPageObject $a_pg_obj, string $a_hier_id, string $a_pc_id="")
	setContentId (int $a_id)
	Set content id. More...
	getContentId ()
	Get content id. More...
	setContentType (string $a_type)
	Set content type. More...
	getContentType ()
	Get content type. More...
	setInstId (string $a_id)
	Set installation id. More...
	getInstId ()
	Get installation id. More...
	getContentIncludeAttribute (string $a_attr)
	Get content include tag attribute. More...
	modifyPageContentPostXsl (string $a_output, string $a_mode, bool $a_abstract_only=false)
	Modify page content after xsl. More...
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	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	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	saveContentIncludeUsage (ilPageObject $a_page, DOMDocument $a_domdoc, int $a_old_nr=0)
	save content include usages More...
static	collectContentIncludes (ilPageObject $a_page, DOMDocument $a_domdoc)
	get all content includes that are used within the page 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...
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 Member Functions
	setContentIncludeAttribute (string $a_attr, string $a_value)
	Set attribute of content include tag. More...
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=[])

Protected Attributes
ilLanguage	$lng
ilAccessHandler	$access
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 = ""

Detailed Description

Class ilPCContentInclude.

Content include object (see ILIAS DTD). Inserts content snippets from other source (e.g. media pool)

Author

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

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

Member Function Documentation

afterPageHistoryEntry()

static ilPCContentInclude::afterPageHistoryEntry ( ilPageObject  $a_page, DOMDocument  $a_old_domdoc, string  $a_old_xml, int  $a_old_nr  )

static

After page history entry has been created.

Reimplemented from ilPageContent.

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

     : void {
        self::saveContentIncludeUsage($a_page, $a_old_domdoc, $a_old_nr);
    }

afterPageUpdate()

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

static

After page has been updated (or created)

Reimplemented from ilPageContent.

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

     : void {
        // pc content include
        self::saveContentIncludeUsage($a_page, $a_domdoc);
    }

beforePageDelete()

static ilPCContentInclude::beforePageDelete ( ilPageObject  $a_page )

static

Before page is being deleted.

Reimplemented from ilPageContent.

Definition at line 146 of file class.ilPCContentInclude.php.

                                                                 : void
    {
        ilPageContentUsage::deleteAllUsages("incl", $a_page->getParentType() . ":pg", $a_page->getId(), 0, $a_page->getLanguage());
    }

References ilPageContentUsage\deleteAllUsages(), ilPageObject\getId(), ilPageObject\getLanguage(), and ilPageObject\getParentType().

Here is the call graph for this function:

collectContentIncludes()

static ilPCContentInclude::collectContentIncludes ( ilPageObject  $a_page, DOMDocument  $a_domdoc  )

static

get all content includes that are used within the page

Definition at line 190 of file class.ilPCContentInclude.php.

     : array {
        $xpath = new DOMXPath($a_domdoc);
        $nodes = $xpath->query('//ContentInclude');
 
        $ci_ids = array();
        foreach ($nodes as $node) {
            $type = $node->getAttribute("ContentType");
            $id = $node->getAttribute("ContentId");
            $inst_id = $node->getAttribute("InstId");
            $ci_ids[$type . ":" . $id . ":" . $inst_id] = array(
                "type" => $type, "id" => $id, "inst_id" => $inst_id);
        }
 
        return $ci_ids;
    }

Referenced by ilPageObjectGUI\showPage(), and PCContentIncludeTest\testCollectContentIncludes().

Here is the caller graph for this function:

create()

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

Definition at line 47 of file class.ilPCContentInclude.php.

     : void {
        $this->createInitialChildNode($a_hier_id, $a_pc_id, "ContentInclude");
    }

deleteHistoryLowerEqualThan()

static ilPCContentInclude::deleteHistoryLowerEqualThan ( string  $parent_type, int  $page_id, string  $lang, int  $delete_lower_than_nr  )

static

Overwrite in derived classes, if old history entries are being deleted.

Reimplemented from ilPageContent.

Definition at line 284 of file class.ilPCContentInclude.php.

     : void {
        global $DIC;
 
        $usage_repo = $DIC->copage()
                          ->internal()
                          ->repo()
                          ->usage();
 
        $usage_repo->deleteHistoryUsagesLowerEqualThan(
            "incl",
            $parent_type . ":pg",
            $page_id,
            $delete_lower_than_nr,
            $lang
        );
    }

getContentId()

ilPCContentInclude::getContentId

(

)

Get content id.

Definition at line 66 of file class.ilPCContentInclude.php.

                                  : int
    {
        return (int) $this->getContentIncludeAttribute("ContentId");
    }

getContentIncludeAttribute()

ilPCContentInclude::getContentIncludeAttribute

(

string

$a_attr

)

Get content include tag attribute.

Definition at line 122 of file class.ilPCContentInclude.php.

                                                              : string
    {
        if (is_object($this->getChildNode())) {
            return  $this->getChildNode()->getAttribute($a_attr);
        }
        return "";
    }

getContentType()

ilPCContentInclude::getContentType

(

)

Get content type.

Definition at line 82 of file class.ilPCContentInclude.php.

                                    : string
    {
        return $this->getContentIncludeAttribute("ContentType");
    }

getInstId()

ilPCContentInclude::getInstId

(

)

Get installation id.

Definition at line 98 of file class.ilPCContentInclude.php.

                               : string
    {
        return $this->getContentIncludeAttribute("InstId");
    }

init()

ilPCContentInclude::init

(

)

Init page content component.

Reimplemented from ilPageContent.

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

                          : void
    {
        global $DIC;
 
        $this->lng = $DIC->language();
        $this->setType("incl");
        $this->access = $DIC->access();
    }

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

Here is the call graph for this function:

modifyPageContentPostXsl()

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

Modify page content after xsl.

Reimplemented from ilPageContent.

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

     : string {
        $lng = $this->lng;
 
        $end = 0;
        $start = strpos($a_output, "{{{{{ContentInclude;");
        if (is_int($start)) {
            $end = strpos($a_output, "}}}}}", $start);
        }
        $i = 1;
        $parent_lang = $this->getPage()->getLanguage();
        if ($parent_lang == "-" && $this->getPage()->getConcreteLang() != "") {
            $parent_lang = $this->getPage()->getConcreteLang();
        }
        while ($end > 0) {
            $param = substr($a_output, $start + 20, $end - $start - 20);
            $param = explode(";", $param);
 
            if ($param[0] == "mep" && is_numeric($param[1])) {
                $html = "";
                $snippet_lang = $parent_lang;
                if (!ilPageObject::_exists("mep", (int) $param[1], $snippet_lang)) {
                    $snippet_lang = "-";
                }
                if (($param[2] <= 0 || $param[2] == IL_INST_ID) && ilPageObject::_exists("mep", (int) $param[1])) {
                    $page_gui = new ilMediaPoolPageGUI((int) $param[1], 0, true, $snippet_lang);
                    if ($a_mode != "offline") {
                        $page_gui->setFileDownloadLink($this->getFileDownloadLink());
                        $page_gui->setProfileBackUrl($this->getProfileBackUrl());
                        $page_gui->setFullscreenLink($this->getFullscreenLink() . "&pg_type=mep");
                        $page_gui->setSourcecodeDownloadScript($this->getSourcecodeDownloadScript());
                    } else {
                        $page_gui->setOutputMode(ilPageObjectGUI::OFFLINE);
                    }
 
                    $html = $page_gui->getRawContent();
                    if ($a_mode == "edit") {
                        $par_id = $page_gui->getPageObject()->getParentId();
                        $info = "";
                        foreach (ilObject::_getAllReferences($par_id) as $ref_id) {
                            if ($this->access->checkAccess("write", "", $ref_id)) {
                                $info = " " . $lng->txt("title") . ": " . ilMediaPoolItem::lookupTitle($page_gui->getPageObject()->getId()) .
                                    ", " . $lng->txt("obj_mep") . ": <a href='" . ilLink::_getLink($ref_id) . "'>" . ilObject::_lookupTitle($par_id) . "</a>";
                            }
                        }
                        $html = '<p class="small light">' . $lng->txt("copg_snippet_cannot_be_edited") . $info . '</p>' . $html;
                    }
                } else {
                    if ($a_mode == "edit") {
                        if ($param[2] <= 0) {
                            $html = "// " . $lng->txt("cont_missing_snippet") . " //";
                        } else {
                            $html = "// " . $lng->txt("cont_snippet_from_another_installation") . " //";
                        }
                    }
                }
                $h2 = substr($a_output, 0, $start) .
                    $html .
                    substr($a_output, $end + 5);
                $a_output = $h2;
                $i++;
            }
 
            $start = strpos($a_output, "{{{{{ContentInclude;", $start + 5);
            $end = 0;
            if (is_int($start)) {
                $end = strpos($a_output, "}}}}}", $start);
            }
        }
        return $a_output;
    }

saveContentIncludeUsage()

static ilPCContentInclude::saveContentIncludeUsage ( ilPageObject  $a_page, DOMDocument  $a_domdoc, int  $a_old_nr = 0  )

static

save content include usages

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

     : void {
        $ci_ids = self::collectContentIncludes($a_page, $a_domdoc);
        ilPageContentUsage::deleteAllUsages("incl", $a_page->getParentType() . ":pg", $a_page->getId(), $a_old_nr, $a_page->getLanguage());
        foreach ($ci_ids as $ci_id) {
            if ((int) $ci_id["inst_id"] <= 0 || $ci_id["inst_id"] == IL_INST_ID) {
                ilPageContentUsage::saveUsage(
                    "incl",
                    (int) $ci_id["id"],
                    $a_page->getParentType() . ":pg",
                    $a_page->getId(),
                    $a_old_nr,
                    $a_page->getLanguage()
                );
            }
        }
    }

setContentId()

ilPCContentInclude::setContentId

(

int

$a_id

)

Set content id.

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

                                           : void
    {
        $this->setContentIncludeAttribute("ContentId", (string) $a_id);
    }

setContentIncludeAttribute()

ilPCContentInclude::setContentIncludeAttribute ( string  $a_attr, string  $a_value  )

protected

Set attribute of content include tag.

Definition at line 106 of file class.ilPCContentInclude.php.

     : void {
        if (!empty($a_value)) {
            $this->getChildNode()->setAttribute($a_attr, $a_value);
        } else {
            if ($this->getChildNode()->hasAttribute($a_attr)) {
                $this->getChildNode()->removeAttribute($a_attr);
            }
        }
    }

setContentType()

ilPCContentInclude::setContentType

(

string

$a_type

)

Set content type.

Definition at line 74 of file class.ilPCContentInclude.php.

                                                  : void
    {
        $this->setContentIncludeAttribute("ContentType", $a_type);
    }

setInstId()

ilPCContentInclude::setInstId

(

string

$a_id

)

Set installation id.

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

                                           : void
    {
        $this->setContentIncludeAttribute("InstId", $a_id);
    }

Field Documentation

$access

ilAccessHandler ilPCContentInclude::$access

protected

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

$lng

ilLanguage ilPCContentInclude::$lng

protected

Definition at line 31 of file class.ilPCContentInclude.php.

---

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

• components/ILIAS/COPage/PC/ContentInclude/class.ilPCContentInclude.php