Inheritance diagram for ilBlogPosting:

Collaboration diagram for ilBlogPosting:

Public Member Functions
	getParentType ()
	Get parent type. More...

	setTitle ($a_title)
	Set title. More...

	getTitle ()
	Get title. More...

	setBlogId ($a_id)
	Set blog object id. More...

	getBlogId ()
	Get blog object id. More...

	setCreated (ilDateTime $a_date)
	Set creation date. More...

	getCreated ()
	Get creation date. More...

	setAuthor ($a_id)
	Set author user id. More...

	getAuthor ()
	Get author user id. More...

	setApproved ($a_status)
	Toggle approval status. More...

	isApproved ()
	Get approved status. More...

	setWithdrawn (ilDateTime $a_date)
	Set last withdrawal date. More...

	getWithdrawn ()
	Get last withdrawal date. More...

	create ($a_import=false)
	Create new blog posting. More...

	update ($a_validate=true, $a_no_history=false, $a_notify=true, $a_notify_action="update")
	Update blog posting. More...

	read ()
	Read blog posting. More...

	checkApproval ()

	delete ()
	Delete blog posting and all related data. More...

	unpublish ()
	Unpublish. More...

	setBlogNodeId ($a_id, $a_is_in_workspace=false)
	Set blog node id (needed for notification) More...

	getNotificationAbstract ()

	getMDSection ()

	updateKeywords (array $keywords)

	handleNews ($a_update=false)
	Handle news item. More...

Public Member Functions inherited from ilPageObject
	__construct ($a_id=0, $a_old_nr=0, $a_lang="-")
	Constructor @access public. More...

	afterConstructor ()
	After constructor. More...

	getParentType ()
	Get parent type. More...

	initPageConfig ()
	Init page config. More...

	setLanguage ($a_val)
	Set language. More...

	getLanguage ()
	Get language. More...

	setConcreteLang ($a_val)

	getConcreteLang ()

	setPageConfig ($a_val)
	Set page config object. More...

	getPageConfig ()
	Get page config object. More...

	setRenderMd5 ($a_rendermd5)
	Set Render MD5. More...

	getRenderMd5 ()
	Get Render MD5. More...

	setRenderedContent ($a_renderedcontent)
	Set Rendered Content. More...

	getRenderedContent ()
	Get Rendered Content. More...

	setRenderedTime ($a_renderedtime)
	Set Rendered Time. More...

	getRenderedTime ()
	Get Rendered Time. More...

	setLastChange ($a_lastchange)
	Set Last Change. More...

	getLastChange ()
	Get Last Change. More...

	setLastChangeUser ($a_val)
	Set last change user. More...

	getLastChangeUser ()
	Get last change user. More...

	setShowActivationInfo ($a_val)
	Set show page activation info. More...

	getShowActivationInfo ()
	Get show page activation info. More...

	read ()
	Read page data. More...

	buildDom ($a_force=false)

	freeDom ()

	getDom ()
	Deprecated php4DomDocument. More...

	getDomDoc ()
	Get dom doc (php5 dom document) More...

	setId ($a_id)
	set id More...

	getId ()

	setParentId ($a_id)

	getParentId ()

	addUpdateListener (&$a_object, $a_method, $a_parameters="")

	callUpdateListeners ()

	setActive ($a_active)
	set activation More...

	getActive ($a_check_scheduled_activation=false)
	get activation More...

	setActivationStart ($a_activationstart)
	Set Activation Start. More...

	getActivationStart ()
	Get Activation Start. More...

	setActivationEnd ($a_activationend)
	Set Activation End. More...

	getActivationEnd ()
	Get Activation End. More...

	getContentObject ($a_hier_id, $a_pc_id="")
	Get a content object of the page. More...

	getContentObjectForPcId ($pcid)
	Get content object for pc id. More...

	getParentContentObjectForPcId ($pcid)
	Get parent content object for pc id. More...

&	getContentNode ($a_hier_id, $a_pc_id="")
	Get content node from dom. More...

	checkForTag ($a_content_tag, $a_hier_id, $a_pc_id="")
	Get content node from dom. More...

	lookforhier ($a_hier_id)

&	getNode ()

	setXMLContent ($a_xml, $a_encoding="UTF-8")
	set xml content of page, start with <PageObject...>, end with </PageObject>, comply with ILIAS DTD, omit MetaData, use utf-8! More...

	appendXMLContent ($a_xml)
	append xml content to page setXMLContent must be called before and the same encoding must be used More...

	getXMLContent ($a_incl_head=false)
	get xml content of page More...

	copyXmlContent ($a_clone_mobs=false)
	Copy content of page; replace page components with copies where necessary (e.g. More...

	handleCopiedContent ($a_dom, $a_self_ass=true, $a_clone_mobs=false)
	Handle copied content This function copies items, that must be copied, if page content is duplicated. More...

	newIIMCopies ($temp_dom)
	Replaces media objects in interactive images with copies of the interactive images. More...

	newMobCopies ($temp_dom)
	Replaces media objects with copies. More...

	newQuestionCopies (&$temp_dom)
	Replaces existing question content elements with new copies. More...

	removeQuestions (&$temp_dom)
	Remove questions from document. More...

	countPageContents ()
	Remove questions from document. More...

	getXMLFromDom ( $a_incl_head=false, $a_append_mobs=false, $a_append_bib=false, $a_append_str="", $a_omit_pageobject_tag=false, $style_id=0)
	get xml content of page from dom (use this, if any changes are made to the document) More...

	getLanguageVariablesXML ($style_id=0)
	Get language variables as XML. More...

	appendLangVarXML (&$xml, $var)

	getFirstParagraphText ()

	getParagraphForPCID ($pcid)

	setParagraphContent ($a_hier_id, $a_content)
	Set content of paragraph. More...

	setContainsIntLink ($a_contains_link)
	lm parser set this flag to true, if the page contains intern links (this method should only be called by the import parser) todo: move to ilLMPageObject !? More...

	containsIntLink ()
	returns true, if page was marked as containing an intern link (via setContainsIntLink) (this method should only be called by the import parser) More...

	setImportMode ($a_val)
	Set import mode. More...

	getImportMode ()
	Get import mode. More...

	needsImportParsing ($a_parse="")

	setContainsQuestion ($a_val)
	Set contains question. More...

	getContainsQuestion ()
	Get contains question. More...

	collectMediaObjects ($a_inline_only=true)
	get all media objects, that are referenced and used within the page More...

	getInternalLinks ($a_cnt_multiple=false)
	get all internal links that are used within the page More...

	getMultimediaXML ()
	get a xml string that contains all media object elements, that are referenced by any media alias in the page More...

	getMediaAliasElement ($a_mob_id, $a_nr=1)
	get complete media object (alias) element More...

	validateDom (bool $throw=false)
	Validate the page content agains page DTD. More...

	addHierIDs ()
	Add hierarchical ID (e.g. More...

	getHierIds ()
	get all hierarchical ids More...

	getFirstRowIds ()
	get ids of all first table rows More...

	getFirstColumnIds ()
	get ids of all first table columns More...

	getListItemIds ()
	get ids of all list items More...

	getFileItemIds ()
	get ids of all file items More...

	stripHierIDs ()
	strip all hierarchical id attributes out of the dom tree More...

	getHierIdsForPCIds ($a_pc_ids)
	Get hier ids for a set of pc ids. More...

	getHierIdForPcId ($pcid)

	getPCIdsForHierIds ($hier_ids)
	Get hier ids for a set of pc ids. More...

	getPCIdForHierId ($hier_id)

	addFileSizes ()
	add file sizes More...

	resolveIntLinks ($a_link_map=null)
	Resolves all internal link targets of the page, if targets are available (after import) More...

	resolveMediaAliases ($a_mapping, $a_reuse_existing_by_import=false)
	Resolve media aliases (after import) More...

	resolveIIMMediaAliases ($a_mapping)
	Resolve iim media aliases (in ilContObjParse) More...

	resolveFileItems ($a_mapping)
	Resolve file items (after import) More...

	resolveQuestionReferences ($a_mapping)
	Resolve all quesion references (after import) More...

	moveIntLinks ($a_from_to)
	Move internal links from one destination to another. More...

	handleImportRepositoryLink ($a_rep_import_id, $a_rep_type, $a_rep_ref_id)

	handleRepositoryLinksOnCopy ($a_mapping, $a_source_ref_id)
	Handle repository links on copy process. More...

	createFromXML ()
	Create new page object with current xml content. More...

	updateFromXML ()
	Updates page object with current xml content This function is currently (4.4.0 alpha) called by: More...

	afterUpdate ()
	After update. More...

	update ($a_validate=true, $a_no_history=false)
	update complete page content in db (dom xml content is used) More...

	delete ()
	delete page object More...

	saveStyleUsage ($a_domdoc, $a_old_nr=0)
	Save all style class/template usages. More...

	deleteStyleUsages ($a_old_nr=0)
	Delete style usages. More...

	getLastUpdateOfIncludedElements ()
	Get last update of included elements (media objects and files). More...

	deleteInternalLinks ()
	Delete internal links. More...

	saveInternalLinks ($a_domdoc)
	save internal links of page More...

	create ()
	create new page (with current xml data) More...

	deleteContent ($a_hid, $a_update=true, $a_pcid="")
	delete content object with hierarchical id $a_hid More...

	deleteContents ($a_hids, $a_update=true, $a_self_ass=false)
	Delete multiple content objects. More...

	cutContents ($a_hids)
	Copy contents to clipboard and cut them from the page. More...

	copyContents ($a_hids)
	Copy contents to clipboard. More...

	pasteContents ($a_hier_id, $a_self_ass=false)
	Paste contents from pc clipboard. More...

	switchEnableMultiple ($a_hids, $a_update=true, $a_self_ass=false)
	(De-)activate elements More...

	deleteContentFromHierId ($a_hid, $a_update=true)
	delete content object with hierarchical id >= $a_hid More...

	deleteContentBeforeHierId ($a_hid, $a_update=true)
	delete content object with hierarchical id < $a_hid More...

	insertContent (&$a_cont_obj, $a_pos, $a_mode=IL_INSERT_AFTER, $a_pcid="", bool $remove_placeholder=true)
	insert a content node before/after a sibling or as first child of a parent More...

	insertContentNode (&$a_cont_node, $a_pos, $a_mode=IL_INSERT_AFTER, $a_pcid="")
	insert a content node before/after a sibling or as first child of a parent More...

	moveContentBefore ($a_source, $a_target, $a_spcid="", $a_tpcid="")
	move content object from position $a_source before position $a_target (both hierarchical content ids) More...

	moveContentAfter ($a_source, $a_target, $a_spcid="", $a_tpcid="")
	move content object from position $a_source before position $a_target (both hierarchical content ids) More...

	bbCode2XML (&$a_content)
	transforms bbCode to corresponding xml More...

	insertInstIntoIDs ($a_inst, $a_res_ref_to_obj_id=true)
	inserts installation id into ids (e.g. More...

	checkPCIds ()
	Check, whether (all) page content hashes are set. More...

	getAllPCIds ()
	Get all pc ids. More...

	hasDuplicatePCIds ()
	Get all pc ids. More...

	getDuplicatePCIds ()
	Get all duplicate PC Ids. More...

	existsPCId ($a_pc_id)
	existsPCId More...

	generatePcId ($a_pc_ids=false)
	Generate new pc id. More...

	insertPCIds ()
	Insert Page Content IDs. More...

	getPageContentsHashes ()
	Get page contents hashes. More...

	getQuestionIds ()
	Get question ids. More...

	send_paragraph ($par_id, $filename)

	getFO ()
	get fo page content More...

	registerOfflineHandler ($handler)

	getOfflineHandler ()
	Get offline handler. More...

	containsDeactivatedElements ($a_content)
	Check whether content contains deactivated elements. More...

	getHistoryEntries ()
	Get History Entries. More...

	getHistoryEntry ($a_old_nr)
	Get History Entry. More...

	getHistoryInfo ($a_nr)
	Get information about a history entry, its predecessor and its successor. More...

	addChangeDivClasses ($a_hashes)

	compareVersion ($a_left, $a_right)
	Compares to revisions of the page. More...

	increaseViewCnt ()
	Increase view cnt. More...

	writeRenderedContent ($a_content, $a_md5)
	Write rendered content. More...

	containsIntLinks ($a_content)
	Check whether content contains internal links. More...

	performAutomaticModifications ()
	Perform automatic modifications (may be overwritten by sub classes) More...

	saveInitialOpenedContent ($a_type, $a_id, $a_target)
	Save initial opened content. More...

	getInitialOpenedContent ()
	Get initial opened content. More...

	beforePageContentUpdate ($a_page_content)
	Before page content update Note: This one is "work in progress", currently only text paragraphs call this hook It is called before the page content object invokes the update procedure of ilPageObject. More...

	copy ($a_id, $a_parent_type="", $a_parent_id=0, $a_clone_mobs=false)
	Copy page. More...

	copyPageToTranslation ($a_target_lang)
	Copy page to translation. More...

	getEditLock ()
	Get page lock. More...

	releasePageLock ()
	Release page lock. More...

	getEditLockInfo ()
	Get edit lock info. More...

	getContentTemplates ()
	Get content templates. More...

	getEffectiveEditLockTime ()

	getAllFileObjIds ()
	Get all file object ids. More...

	resolveResources ($ref_mapping)
	Resolve resources. More...

	getRepoObjId ()
	Get object id of repository object that contains this page, return 0 if page does not belong to a repo object. More...

	getPCModel ()
	Get page component model. More...

	assignCharacteristic ($targets, $char_par, $char_sec, $char_med)
	Assign characteristic. More...

Static Public Member Functions
static	deleteAllBlogPostings ($a_blog_id)
	Delete all postings for blog. More...

static	lookupBlogId ($a_posting_id)
	Lookup blog id. More...

static	getAllPostings ($a_blog_id, $a_limit=1000, $a_offset=0)
	Get all postings of blog. More...

static	exists ($a_blog_id, $a_posting_id)
	Checks whether a posting exists. More...

static	getLastPost ($a_blog_id)
	Get newest posting for blog. More...

static	searchBlogsByAuthor ($a_user_id)
	Get all blogs where user has postings. More...

static	getKeywords ($a_obj_id, $a_posting_id)

static	lookupTitle ($a_posting_id)
	Lookup title. More...

Static Public Member Functions inherited from ilPageObject
static	_exists ($a_parent_type, $a_id, $a_lang="", $a_no_cache=false)
	Checks whether page exists. More...

static	_existsAndNotEmpty ($a_parent_type, $a_id, $a_lang="-")
	Checks whether page exists and is not empty (may return true on some empty pages) More...

static	preloadActivationDataByParentId ($a_parent_id)
	Preload activation data by Parent Id. More...

static	_lookupActive ($a_id, $a_parent_type, $a_check_scheduled_activation=false, $a_lang="-")
	lookup activation status More...

static	_isScheduledActivation ($a_id, $a_parent_type, $a_lang="-")
	Check whether page is activated by time schedule. More...

static	_writeActive ( $a_id, $a_parent_type, $a_active, $a_reset_scheduled_activation=true, $a_lang="-")
	write activation status More...

static	_lookupActivationData ($a_id, $a_parent_type, $a_lang="-")
	Lookup activation data. More...

static	lookupParentId ($a_id, $a_type)
	Lookup parent id. More...

static	_writeParentId ($a_parent_type, $a_pg_id, $a_par_id)
	Write parent id. More...

static	_handleImportRepositoryLinks ($a_rep_import_id, $a_rep_type, $a_rep_ref_id)
	Change targest of repository links. More...

static	_moveContentAfterHierId (&$a_source_page, &$a_target_page, $a_hid)
	move content of hierarchical id >= $a_hid to other page More...

static	_lookupContainsDeactivatedElements ($a_id, $a_parent_type, $a_lang="-")
	lookup whether page contains deactivated elements More...

static	getRecentChanges ($a_parent_type, $a_parent_id, $a_period=30, $a_lang="")
	Get recent pages changes for parent object. More...

static	getAllPages ($a_parent_type, $a_parent_id, $a_lang="-")
	Get all pages for parent object. More...

static	getNewPages ($a_parent_type, $a_parent_id, $a_lang="-")
	Get new pages. More...

static	getParentObjectContributors ($a_parent_type, $a_parent_id, $a_lang="-")
	Get all contributors for parent object. More...

static	getPageContributors ($a_parent_type, $a_page_id, $a_lang="-")
	Get all contributors for parent object. More...

static	getPagesWithLinks ($a_parent_type, $a_parent_id, $a_lang="-")
	Get all pages for parent object that contain internal links. More...

static	lookupTranslations ($a_parent_type, $a_id)
	Lookup translations. More...

static	truncateHTML ( $a_text, $a_length=100, $a_ending='...', $a_exact=false, $a_consider_html=true)
	Truncate (html) string. More...

static	getLastChangeByParent ($a_parent_type, $a_parent_id, $a_lang="")
	Get all pages for parent object. More...

Static Protected Member Functions
static	lookup ($a_field, $a_posting_id)
	Lookup posting property. More...

Protected Attributes
	$title

	$created

	$blog_node_id

	$blog_node_is_wsp

	$author

	$approved

	$withdrawn

Protected Attributes inherited from ilPageObject
	$obj_definition

	$db

	$user

	$lng

	$tree

	$id

	$language = "-"

	$import_mode = false

	$log

	$page_record = array()

	$active = false

	$page_config

	$concrete_lang

Additional Inherited Members
Data Fields inherited from ilPageObject
	$dom

	$xml

	$encoding

	$node

	$cur_dtd = "ilias_pg_5_4.dtd"

	$contains_int_link

	$needs_parsing

	$parent_type

	$parent_id

	$update_listeners

	$update_listener_cnt

	$offline_handler

	$dom_builded

	$history_saved

Static Public Attributes inherited from ilPageObject
static	$exists = array()

Protected Member Functions inherited from ilPageObject
	__afterUpdate ($a_domdoc, $a_xml, $a_creation=false, $a_empty=false)
	After update event handler (internal). More...

	__beforeDelete ()
	Before deletion handler (internal). More...

	__afterHistoryEntry ($a_old_domdoc, $a_old_content, $a_old_nr)
	Before deletion handler (internal). More...

Static Protected Attributes inherited from ilPageObject
static	$activation_data = array()

Detailed Description

Class ilBlogPosting.

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 10 of file class.ilBlogPosting.php.

Member Function Documentation

◆ checkApproval()

ilBlogPosting::checkApproval ( )

Definition at line 243 of file class.ilBlogPosting.php.

    {
        if (!$this->getActive() && $this->isApproved()) {
            $this->approved = false;
            $this->update();
        }
    }

References ilPageObject\getActive(), isApproved(), and update().

Here is the call graph for this function:

◆ create()

ilBlogPosting::create ( $a_import = false )

Create new blog posting.

Definition at line 152 of file class.ilBlogPosting.php.

    {
        $ilDB = $this->db;
 
        $id = $ilDB->nextId("il_blog_posting");
        $this->setId($id);
        
        if (!$a_import) {
            $created = ilUtil::now();
        } else {
            $created = $this->getCreated()->get(IL_CAL_DATETIME);
        }
 
        // we are using a separate creation date to enable sorting without JOINs
 
        $query = "INSERT INTO il_blog_posting (id, title, blog_id, created, author, approved, last_withdrawn)" .
            " VALUES (" .
            $ilDB->quote($this->getId(), "integer") . "," .
            $ilDB->quote($this->getTitle(), "text") . "," .
            $ilDB->quote($this->getBlogId(), "integer") . "," .
            $ilDB->quote($created, "timestamp") . "," .
            $ilDB->quote($this->getAuthor(), "integer") . "," .
            $ilDB->quote($this->isApproved(), "integer") . "," . // #16526 - import
            $ilDB->quote($this->getWithdrawn(), "timestamp") . ")";
        $ilDB->manipulate($query);
 
        if (!$a_import) {
            parent::create();
            // $this->saveInternalLinks($this->getXMLContent());
        }
    }

References $created, ilPageObject\$db, ilPageObject\$id, $ilDB, $query, getAuthor(), getBlogId(), getCreated(), ilPageObject\getId(), getTitle(), getWithdrawn(), IL_CAL_DATETIME, isApproved(), ilUtil\now(), and ilPageObject\setId().

Here is the call graph for this function:

◆ delete()

ilBlogPosting::delete ( )

Delete blog posting and all related data.

Returns: bool

Reimplemented from ilPageObject.

Definition at line 256 of file class.ilBlogPosting.php.

    {
        $ilDB = $this->db;
 
        ilNewsItem::deleteNewsOfContext(
            $this->getBlogId(),
            "blog",
            $this->getId(),
            $this->getParentType()
        );
 
        $query = "DELETE FROM il_blog_posting" .
            " WHERE id = " . $ilDB->quote($this->getId(), "integer");
        $ilDB->manipulate($query);
        
        parent::delete();
 
        return true;
    }

References ilPageObject\$db, $ilDB, $query, ilNewsItem\deleteNewsOfContext(), getBlogId(), ilPageObject\getId(), and getParentType().

Here is the call graph for this function:

◆ deleteAllBlogPostings()

static ilBlogPosting::deleteAllBlogPostings ( $a_blog_id )

static

Delete all postings for blog.

Parameters

int $a_blog_id

Definition at line 300 of file class.ilBlogPosting.php.

    {
        global $DIC;
 
        $ilDB = $DIC->database();
        
        $query = "SELECT * FROM il_blog_posting" .
            " WHERE blog_id = " . $ilDB->quote($a_blog_id, "integer");
        $set = $ilDB->query($query);
        while ($rec = $ilDB->fetchAssoc($set)) {
            // delete all md keywords
            $md_obj = new ilMD($a_blog_id, $rec["id"], "blp");
            if (is_object($md_section = $md_obj->getGeneral())) {
                foreach ($md_section->getKeywordIds() as $id) {
                    $md_key = $md_section->getKeyword($id);
                    $md_key->delete();
                }
            }
            
            $post = new ilBlogPosting($rec["id"]);
            $post->delete();
        }
    }

References $DIC, ilPageObject\$id, $ilDB, and $query.

Referenced by ilObjBlog\doDelete().

Here is the caller graph for this function:

◆ exists()

static ilBlogPosting::exists	(	$a_blog_id,
		$a_posting_id
	)

static

Checks whether a posting exists.

Parameters

int	$a_blog_id
int	$a_posting_id

Returns: bool

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

    {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $query = "SELECT id FROM il_blog_posting" .
            " WHERE blog_id = " . $ilDB->quote($a_blog_id, "integer") .
            " AND id = " . $ilDB->quote($a_posting_id, "integer");
        $set = $ilDB->query($query);
        if ($rec = $ilDB->fetchAssoc($set)) {
            return true;
        }
        return false;
    }

References $DIC, $ilDB, and $query.

Referenced by ilObjBlogGUI\executeCommand().

Here is the caller graph for this function:

◆ getAllPostings()

static ilBlogPosting::getAllPostings	(	$a_blog_id,
		$a_limit = `1000`,
		$a_offset = `0`
	)

static

Get all postings of blog.

Parameters

int	$a_blog_id
int	$a_limit
int	$a_offset

Returns: array

Definition at line 353 of file class.ilBlogPosting.php.

    {
        global $DIC;
 
        $ilDB = $DIC->database();
        
        $pages = parent::getAllPages("blp", $a_blog_id);
 
        if ($a_limit) {
            $ilDB->setLimit($a_limit, $a_offset);
        }
        
        $query = "SELECT * FROM il_blog_posting" .
            " WHERE blog_id = " . $ilDB->quote($a_blog_id, "integer") .
            " ORDER BY created DESC";
        $set = $ilDB->query($query);
        $post = array();
        while ($rec = $ilDB->fetchAssoc($set)) {
            if (isset($pages[$rec["id"]])) {
                $post[$rec["id"]] = $pages[$rec["id"]];
                $post[$rec["id"]]["title"] = $rec["title"];
                $post[$rec["id"]]["created"] = new ilDateTime($rec["created"], IL_CAL_DATETIME);
                $post[$rec["id"]]["author"] = $rec["author"];
                $post[$rec["id"]]["approved"] = (bool) $rec["approved"];
                $post[$rec["id"]]["last_withdrawn"] = new ilDateTime($rec["last_withdrawn"], IL_CAL_DATETIME);
                                
                foreach (self::getPageContributors("blp", $rec["id"]) as $editor) {
                    if ($editor["user_id"] != $rec["author"]) {
                        $post[$rec["id"]]["editors"][] = $editor["user_id"];
                    }
                }
            }
        }
 
        return $post;
    }

References $DIC, $ilDB, $query, and IL_CAL_DATETIME.

Referenced by ilObjBlogGUI\buildPostingList(), ilObjBlog\deliverRSS(), ILIAS\Blog\Export\BlogHtmlExport\exportHTMLPages(), getLastPost(), ilBlogDraftsDerivedTaskProvider\getTasks(), ilBlogExporter\getXmlExportTailDependencies(), ilBlogPostingGUI\initKeywordsForm(), ilObjPortfolioGUI\initPDFSelectionForm(), ilPCBlogGUI\initPostingForm(), and ilObjPortfolioGUI\printView().

Here is the caller graph for this function:

◆ getAuthor()

ilBlogPosting::getAuthor ( )

Get author user id.

Returns: int

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

    {
        return $this->author;
    }

References $author.

Referenced by create(), and handleNews().

Here is the caller graph for this function:

◆ getBlogId()

ilBlogPosting::getBlogId ( )

Get blog object id.

Returns: int

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

    {
        return $this->getParentId();
    }

References ilPageObject\getParentId().

Referenced by create(), delete(), getMDSection(), handleNews(), and unpublish().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCreated()

ilBlogPosting::getCreated ( )

Get creation date.

Returns: ilDateTime

Definition at line 86 of file class.ilBlogPosting.php.

    {
        return $this->created;
    }

References $created.

Referenced by create(), and update().

Here is the caller graph for this function:

◆ getKeywords()

static ilBlogPosting::getKeywords	(	$a_obj_id,
		$a_posting_id
	)

static

Definition at line 503 of file class.ilBlogPosting.php.

    {
        return ilMDKeyword::lookupKeywords($a_obj_id, $a_posting_id);
    }

References ilMDKeyword\lookupKeywords().

Referenced by ilObjBlogGUI\filterItemsByKeyWord(), ilObjBlogGUI\getKeywords(), ilBlogPostingGUI\initKeywordsForm(), ilBlogDataSet\readData(), and ilObjBlogGUI\renderList().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLastPost()

static ilBlogPosting::getLastPost ( $a_blog_id )

static

Get newest posting for blog.

Parameters

int $a_blog_id

Returns: int

Definition at line 419 of file class.ilBlogPosting.php.

    {
        $data = self::getAllPostings($a_blog_id, 1);
        if ($data) {
            $keys = array_keys($data);
            return array_pop($keys);
        }
    }

References $data, $keys, and getAllPostings().

Here is the call graph for this function:

◆ getMDSection()

ilBlogPosting::getMDSection ( )

Definition at line 480 of file class.ilBlogPosting.php.

    {
        // general section available?
        $md_obj = new ilMD($this->getBlogId(), $this->getId(), "blp");
        if (!is_object($md_section = $md_obj->getGeneral())) {
            $md_section = $md_obj->addGeneral();
            $md_section->save();
        }
        
        return $md_section;
    }

References getBlogId(), and ilPageObject\getId().

Referenced by updateKeywords().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getNotificationAbstract()

ilBlogPosting::getNotificationAbstract ( )

Definition at line 464 of file class.ilBlogPosting.php.

    {
        $snippet = ilBlogPostingGUI::getSnippet($this->getId(), true);
        
        // making things more readable
        $snippet = str_replace('<br/>', "\n", $snippet);
        $snippet = str_replace('<br />', "\n", $snippet);
        $snippet = str_replace('</p>', "\n", $snippet);
        $snippet = str_replace('</div>', "\n", $snippet);
    
        return trim(strip_tags($snippet));
    }

References ilPageObject\getId(), and ilBlogPostingGUI\getSnippet().

Here is the call graph for this function:

◆ getParentType()

ilBlogPosting::getParentType ( )

Get parent type.

Returns: string parent type

Reimplemented from ilPageObject.

Definition at line 25 of file class.ilBlogPosting.php.

    {
        return "blp";
    }

Referenced by delete(), handleNews(), and unpublish().

Here is the caller graph for this function:

◆ getTitle()

ilBlogPosting::getTitle ( )

Get title.

Returns: string

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

    {
        return $this->title;
    }

References $title.

Referenced by create(), handleNews(), and update().

Here is the caller graph for this function:

◆ getWithdrawn()

ilBlogPosting::getWithdrawn ( )

Get last withdrawal date.

Returns: ilDateTime

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

    {
        return $this->withdrawn;
    }

References $withdrawn.

Referenced by create(), and update().

Here is the caller graph for this function:

◆ handleNews()

ilBlogPosting::handleNews ( $a_update = false )

Handle news item.

Parameters

bool $a_update

Definition at line 513 of file class.ilBlogPosting.php.

    {
        $lng = $this->lng;
        $ilUser = $this->user;
        
        // see ilWikiPage::updateNews()
 
        if (!$this->getActive()) {
            return;
        }
 
        $news_item = null;
        
        // try to re-use existing news item
        if ((bool) $a_update) {
            // get last news item of the day (if existing)
            $news_id = ilNewsItem::getLastNewsIdForContext(
                $this->getBlogId(),
                "blog",
                $this->getId(),
                $this->getParentType(),
                true
            );
            if ($news_id > 0) {
                $news_item = new ilNewsItem($news_id);
            }
        }
        
        // create new news item
        if (!$news_item) {
            $news_set = new ilSetting("news");
            $default_visibility = $news_set->get("default_visibility", "users");
            
            $news_item = new ilNewsItem();
            $news_item->setContext(
                $this->getBlogId(),
                "blog",
                $this->getId(),
                $this->getParentType()
            );
            $news_item->setPriority(NEWS_NOTICE);
            $news_item->setVisibility($default_visibility);
        }
        
        // news author
        $news_item->setUserId($ilUser->getId());
        
        
        // news title/content
        
        $news_item->setTitle($this->getTitle());
                
        $content = $a_update
            ? "blog_news_posting_updated"
            : "blog_news_posting_published";
        
        // news "author"
        $content = sprintf($lng->txt($content), ilUserUtil::getNamePresentation($ilUser->getId()));
        
        // posting author[s]
        $contributors = array();
        foreach (self::getPageContributors($this->getParentType(), $this->getId()) as $user) {
            $contributors[] = $user["user_id"];
        }
        if (sizeof($contributors) > 1 || !in_array($this->getAuthor(), $contributors)) {
            // original author should come first?
            $authors = array(ilUserUtil::getNamePresentation($this->getAuthor()));
            foreach ($contributors as $user_id) {
                if ($user_id != $this->getAuthor()) {
                    $authors[] = ilUserUtil::getNamePresentation($user_id);
                }
            }
            $content .= "\n" . sprintf($lng->txt("blog_news_posting_authors"), implode(", ", $authors));
        }
        
        $news_item->setContentTextIsLangVar(false);
        $news_item->setContent($content);
        
        $snippet = ilBlogPostingGUI::getSnippet($this->getId());
        $news_item->setContentLong($snippet);
            
        if (!$news_item->getId()) {
            $news_item->create();
        } else {
            $news_item->update(true);
        }
    }

References $ilUser, ilPageObject\$lng, ilPageObject\$user, ilPageObject\getActive(), getAuthor(), getBlogId(), ilPageObject\getId(), ilNewsItem\getLastNewsIdForContext(), ilUserUtil\getNamePresentation(), getParentType(), ilBlogPostingGUI\getSnippet(), getTitle(), and NEWS_NOTICE.

Here is the call graph for this function:

◆ isApproved()

ilBlogPosting::isApproved ( )

Get approved status.

Returns: bool

Definition at line 124 of file class.ilBlogPosting.php.

    {
        return (bool) $this->approved;
    }

References $approved.

Referenced by checkApproval(), create(), and update().

Here is the caller graph for this function:

◆ lookup()

static ilBlogPosting::lookup	(	$a_field,
		$a_posting_id
	)

staticprotected

Lookup posting property.

Parameters

string	$a_field	field
int	$a_posting_id	posting id

Returns: mixed

Definition at line 608 of file class.ilBlogPosting.php.

    {
        global $DIC;
 
        $db = $DIC->database();
 
        $set = $db->query("SELECT $a_field FROM il_blog_posting " .
            " WHERE id = " . $db->quote($a_posting_id, "integer"));
        $rec = $db->fetchAssoc($set);
 
        return $rec[$a_field];
    }

References ilPageObject\$db, and $DIC.

Referenced by lookupTitle().

Here is the caller graph for this function:

◆ lookupBlogId()

static ilBlogPosting::lookupBlogId ( $a_posting_id )

static

Lookup blog id.

Parameters

int $a_posting_id

Returns: int

Definition at line 330 of file class.ilBlogPosting.php.

    {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $query = "SELECT blog_id FROM il_blog_posting" .
            " WHERE id = " . $ilDB->quote($a_posting_id, "integer");
        $set = $ilDB->query($query);
        if ($rec = $ilDB->fetchAssoc($set)) {
            return $rec["blog_id"];
        }
        return false;
    }

References $DIC, $ilDB, and $query.

Referenced by ilObjBlogGUI\__construct(), ilBlogImporter\finalProcessing(), and ilBlogDataSet\readData().

Here is the caller graph for this function:

◆ lookupTitle()

static ilBlogPosting::lookupTitle ( $a_posting_id )

static

Lookup title.

Parameters

int $a_posting_id posting id

Returns: string

Definition at line 627 of file class.ilBlogPosting.php.

    {
        $t = self::lookup("title", $a_posting_id);
        return $t;
    }

References lookup().

Here is the call graph for this function:

◆ read()

ilBlogPosting::read ( )

Read blog posting.

Reimplemented from ilPageObject.

Definition at line 219 of file class.ilBlogPosting.php.

    {
        $ilDB = $this->db;
        
        $query = "SELECT * FROM il_blog_posting" .
            " WHERE id = " . $ilDB->quote($this->getId(), "integer");
        $set = $ilDB->query($query);
        $rec = $ilDB->fetchAssoc($set);
 
        $this->setTitle($rec["title"]);
        $this->setBlogId($rec["blog_id"]);
        $this->setCreated(new ilDateTime($rec["created"], IL_CAL_DATETIME));
        $this->setAuthor($rec["author"]);
        if ((bool) $rec["approved"]) {
            $this->setApproved(true);
        }
        $this->setWithdrawn(new ilDateTime($rec["last_withdrawn"], IL_CAL_DATETIME));
        
        // when posting is deactivated it should loose the approval
        $this->addUpdateListener($this, "checkApproval");
    
        parent::read();
    }

References ilPageObject\$db, $ilDB, $query, ilPageObject\addUpdateListener(), ilPageObject\getId(), IL_CAL_DATETIME, setApproved(), setAuthor(), setBlogId(), setCreated(), setTitle(), and setWithdrawn().

Here is the call graph for this function:

◆ searchBlogsByAuthor()

static ilBlogPosting::searchBlogsByAuthor ( $a_user_id )

static

Get all blogs where user has postings.

Parameters

int $a_user_id

Returns: array

Definition at line 446 of file class.ilBlogPosting.php.

    {
        global $DIC;
 
        $ilDB = $DIC->database();
        
        $ids = array();
        
        $sql = "SELECT DISTINCT(blog_id)" .
            " FROM il_blog_posting" .
            " WHERE author = " . $ilDB->quote($a_user_id);
        $set = $ilDB->query($sql);
        while ($row = $ilDB->fetchAssoc($set)) {
            $ids[] = $row["blog_id"];
        }
        return $ids;
    }

References $DIC, and $ilDB.

Referenced by ilBlogDraftsDerivedTaskProvider\getTasks(), and ilPCBlogGUI\initForm().

Here is the caller graph for this function:

◆ setApproved()

ilBlogPosting::setApproved ( $a_status )

Toggle approval status.

Definition at line 114 of file class.ilBlogPosting.php.

    {
        $this->approved = (bool) $a_status;
    }

Referenced by read(), and unpublish().

Here is the caller graph for this function:

◆ setAuthor()

ilBlogPosting::setAuthor ( $a_id )

Set author user id.

Parameters

int $a_id

Definition at line 96 of file class.ilBlogPosting.php.

    {
        $this->author = (int) $a_id;
    }

Referenced by read().

Here is the caller graph for this function:

◆ setBlogId()

ilBlogPosting::setBlogId ( $a_id )

Set blog object id.

Parameters

int $a_id

Definition at line 56 of file class.ilBlogPosting.php.

    {
        $this->setParentId($a_id);
    }

References ilPageObject\setParentId().

Referenced by read().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setBlogNodeId()

ilBlogPosting::setBlogNodeId	(	$a_id,
		$a_is_in_workspace = `false`
	)

Set blog node id (needed for notification)

Parameters

int	$a_id
bool	$a_is_in_workspace

Definition at line 434 of file class.ilBlogPosting.php.

    {
        $this->blog_node_id = (int) $a_id;
        $this->blog_node_is_wsp = (bool) $a_is_in_workspace;
    }

◆ setCreated()

ilBlogPosting::setCreated ( ilDateTime $a_date )

Set creation date.

Parameters

ilDateTime $a_date

Definition at line 76 of file class.ilBlogPosting.php.

    {
        $this->created = $a_date;
    }

Referenced by read().

Here is the caller graph for this function:

◆ setTitle()

ilBlogPosting::setTitle ( $a_title )

Set title.

Parameters

string $a_title

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

    {
        $this->title = $a_title;
    }

Referenced by read().

Here is the caller graph for this function:

◆ setWithdrawn()

ilBlogPosting::setWithdrawn ( ilDateTime $a_date )

Set last withdrawal date.

Parameters

ilDateTime $a_date

Definition at line 134 of file class.ilBlogPosting.php.

    {
        $this->withdrawn = $a_date;
    }

Referenced by read(), and unpublish().

Here is the caller graph for this function:

◆ unpublish()

ilBlogPosting::unpublish ( )

Unpublish.

Definition at line 279 of file class.ilBlogPosting.php.

    {
        $this->setApproved(false);
        $this->setActive(false);
        $this->setWithdrawn(new ilDateTime(ilUtil::now(), IL_CAL_DATETIME));
        $this->update(true, false, false);
 
        ilNewsItem::deleteNewsOfContext(
            $this->getBlogId(),
            "blog",
            $this->getId(),
            $this->getParentType()
        );
    }

References ilNewsItem\deleteNewsOfContext(), getBlogId(), ilPageObject\getId(), getParentType(), IL_CAL_DATETIME, ilUtil\now(), ilPageObject\setActive(), setApproved(), setWithdrawn(), and update().

Here is the call graph for this function:

◆ update()

ilBlogPosting::update	(	$a_validate = `true`,
		$a_no_history = `false`,
		$a_notify = `true`,
		$a_notify_action = `"update"`
	)

Update blog posting.

Parameters

bool	$a_validate
bool	$a_no_history
bool	$a_notify
string	$a_notify_action

Returns: boolean

Definition at line 193 of file class.ilBlogPosting.php.

    {
        $ilDB = $this->db;
 
        // blog_id, author and created cannot be changed
        
        $query = "UPDATE il_blog_posting SET" .
            " title = " . $ilDB->quote($this->getTitle(), "text") .
            ",created = " . $ilDB->quote($this->getCreated()->get(IL_CAL_DATETIME), "timestamp") .
            ",approved =" . $ilDB->quote($this->isApproved(), "integer") .
            ",last_withdrawn =" . $ilDB->quote($this->getWithdrawn()->get(IL_CAL_DATETIME), "timestamp") .
            " WHERE id = " . $ilDB->quote($this->getId(), "integer");
        $ilDB->manipulate($query);
        
        parent::update($a_validate, $a_no_history);
        
        if ($a_notify && $this->getActive()) {
            ilObjBlog::sendNotification($a_notify_action, $this->blog_node_is_wsp, $this->blog_node_id, $this->getId());
        }
 
        return true;
    }

References ilPageObject\$db, $ilDB, $query, ilPageObject\getActive(), getCreated(), ilPageObject\getId(), getTitle(), getWithdrawn(), IL_CAL_DATETIME, isApproved(), and ilObjBlog\sendNotification().

Referenced by checkApproval(), and unpublish().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateKeywords()

ilBlogPosting::updateKeywords ( array $keywords )

Definition at line 492 of file class.ilBlogPosting.php.

    {
        $ilUser = $this->user;
                
        // language is not "used" anywhere
        $ulang = $ilUser->getLanguage();
        $keywords = array($ulang => $keywords);
 
        ilMDKeyword::updateKeywords($this->getMDSection(), $keywords);
    }

References $ilUser, ilPageObject\$user, getMDSection(), and ilMDKeyword\updateKeywords().

Here is the call graph for this function:

Field Documentation

◆ $approved

ilBlogPosting::$approved

protected

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

Referenced by isApproved().

◆ $author

ilBlogPosting::$author

protected

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

Referenced by getAuthor().

◆ $blog_node_id

ilBlogPosting::$blog_node_id

protected

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

◆ $blog_node_is_wsp

ilBlogPosting::$blog_node_is_wsp

protected

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

◆ $created

ilBlogPosting::$created

protected

Definition at line 13 of file class.ilBlogPosting.php.

Referenced by create(), and getCreated().

◆ $title

ilBlogPosting::$title

protected

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

Referenced by getTitle().

◆ $withdrawn

ilBlogPosting::$withdrawn

protected

Definition at line 18 of file class.ilBlogPosting.php.

Referenced by getWithdrawn().

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

Modules/Blog/classes/class.ilBlogPosting.php

Public Member Functions

Static Public Member Functions

Static Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ checkApproval()

◆ create()

◆ delete()

◆ deleteAllBlogPostings()

◆ exists()

◆ getAllPostings()

◆ getAuthor()

◆ getBlogId()

◆ getCreated()

◆ getKeywords()

◆ getLastPost()

◆ getMDSection()

◆ getNotificationAbstract()

◆ getParentType()

◆ getTitle()

◆ getWithdrawn()

◆ handleNews()

◆ isApproved()

◆ lookup()

◆ lookupBlogId()

◆ lookupTitle()

◆ read()

◆ searchBlogsByAuthor()

◆ setApproved()

◆ setAuthor()

◆ setBlogId()

◆ setBlogNodeId()

◆ setCreated()

◆ setTitle()

◆ setWithdrawn()

◆ unpublish()

◆ update()

◆ updateKeywords()

Field Documentation

◆ $approved

◆ $author

◆ $blog_node_id

◆ $blog_node_is_wsp

◆ $created

◆ $title

◆ $withdrawn