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

Inheritance diagram for ilBlogPosting:

Collaboration diagram for ilBlogPosting:

Public Member Functions
	getParentType ()

	setTitle (string $a_title)

	getTitle ()

	setBlogId (int $a_id)

	getBlogId ()

	setCreated (ilDateTime $a_date)

	getCreated ()

	setAuthor (int $a_id)

	getAuthor ()

	setApproved (bool $a_status)

	isApproved ()

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

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

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

	update (bool $a_validate=true, bool $a_no_history=false, bool $a_notify=true, string $a_notify_action="update")

	read ()
	Read blog posting. More...

	checkApproval ()

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

	unpublish ()
	Unpublish. More...

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

	getNotificationAbstract ()

	getMDSection ()

	updateKeywords (array $keywords)

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

Public Member Functions inherited from ilPageObject
	__construct (int $a_id=0, int $a_old_nr=0, string $a_lang="-")

	setContentIdManager (\ILIAS\COPage\ID\ContentIdManager $content_id_manager)

	afterConstructor ()

	getParentType ()

	initPageConfig ()

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

	getLanguage ()

	setPageConfig (ilPageConfig $a_val)

	setConcreteLang (string $a_val)

	getConcreteLang ()

	getPageConfig ()

	setRenderMd5 (string $a_rendermd5)

	getRenderMd5 ()

	setRenderedContent (string $a_renderedcontent)

	getRenderedContent ()

	setRenderedTime (string $a_renderedtime)

	getRenderedTime ()

	setLastChange (string $a_lastchange)

	getLastChange ()

	setLastChangeUser (int $a_val)

	getLastChangeUser ()

	setShowActivationInfo (bool $a_val)

	getShowActivationInfo ()

	getCreationUserId ()

	read ()
	Read page data. More...

	buildDom (bool $a_force=false)

	freeDom ()

	getDomDoc ()
	Get dom doc (DOMDocument) More...

	setId (int $a_id)

	getId ()

	setParentId (int $a_id)

	getParentId ()

	addUpdateListener (object $a_object, string $a_method, $a_parameters="")

	callUpdateListeners ()

	setActive (bool $a_active)

	getActive (bool $a_check_scheduled_activation=false)

	setActivationStart (?string $a_activationstart)

	getActivationStart ()

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

	getActivationEnd ()

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

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

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

	getContentDomNode (string $a_hier_id, string $a_pc_id="")

	getDomNodeForPCId (string $pc_id)

	setXMLContent (string $a_xml, string $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 (string $a_xml)
	append xml content to page setXMLContent must be called before and the same encoding must be used s More...

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

	copyXmlContent (bool $a_clone_mobs=false, int $a_new_parent_id=0, int $obj_copy_id=0, bool $self_ass=true)
	Copy content of page; replace page components with copies where necessary (e.g. More...

	handleDeleteContent (?DOMNode $a_node=null, $move_operation=false)
	Handle content before deletion This currently treats only plugged content If no node is given, then the whole dom will be scanned. More...

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

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

	getFirstParagraphText ()

	getParagraphForPCID (string $pcid)

	setContainsIntLink (bool $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 (bool $a_val)

	getImportMode ()

	needsImportParsing (?bool $a_parse=null)

	setContainsQuestion (bool $a_val)

	getContainsQuestion ()

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

	getInternalLinks ()
	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 (int $a_mob_id, int $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 ()

	stripHierIDs ()

	stripPCIDs ()

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

	getHierIdForPcId (string $pcid)

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

	getPCIdForHierId (string $hier_id)

	addFileSizes ()
	add file sizes More...

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

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

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

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

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

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

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

	setEmptyPageXml ()

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

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

	afterUpdate (DOMDocument $domdoc, string $xml)
	After update. More...

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

	delete ()

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

	deleteStyleUsages (int $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 (DOMDocument $a_domdoc)
	save internal links of page More...

	create (bool $a_import=false)
	create new page (with current xml data) More...

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

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

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

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

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

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

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

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

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

	insertInstIntoIDs (string $a_inst, bool $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 ()

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

	generatePCId ()

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

	sendParagraph (string $par_id, string $filename)

	registerOfflineHandler (object $handler)

	getOfflineHandler ()

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

	getHistoryEntries ()
	Get History Entries. More...

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

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

	preparePageForCompare (ilPageObject $page)

	increaseViewCnt ()
	Increase view cnt. More...

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

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

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

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

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

	beforePageContentUpdate (ilPageContent $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 (int $a_id, string $a_parent_type="", int $a_new_parent_id=0, bool $a_clone_mobs=false, int $obj_copy_id=0, bool $overwrite_existing=true)
	Copy page. More...

	copyPageToTranslation (string $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 ()

	resolveResources (array $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 (array $targets, string $char_par, string $char_sec, string $char_med)
	Assign characteristic. More...

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

static	lookupBlogId (int $a_posting_id)

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

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

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

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

static	getKeywords (int $a_obj_id, int $a_posting_id)

static	lookupTitle (int $a_posting_id)

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

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

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

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

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

static	_writeActive (int $a_id, string $a_parent_type, bool $a_active)
	write activation status More...

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

static	lookupParentId (int $a_id, string $a_type)

static	_writeParentId (string $a_parent_type, int $a_pg_id, int $a_par_id)

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

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

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

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

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

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

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

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

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

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

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

Protected Attributes
string	$title = ""

ilDateTime	$created = null

int	$blog_node_id = 0

bool	$blog_node_is_wsp = false

int	$author = 0

bool	$approved = false

ilDateTime	$withdrawn = null

Protected Attributes inherited from ilPageObject
ILIAS COPage Dom DomUtil	$dom_util

ILIAS COPage Link LinkManager	$link

ILIAS COPage PC PCDefinition	$pc_definition

int	$create_user = 0

array	$id_elements

bool	$page_not_found = false

bool	$show_page_act_info = false

ilObjectDefinition	$obj_definition

ilDBInterface	$db

ilObjUser	$user

ilLanguage	$lng

ilTree	$tree

int	$id

string	$language = "-"

bool	$import_mode = false

ilLogger	$log

array	$page_record = array()

bool	$active = false

ilPageConfig	$page_config

string	$rendermd5 = ""

string	$renderedcontent = ""

string	$renderedtime = ""

string	$lastchange = ""

bool	$contains_question = false

array	$hier_ids = []

string	$activationstart = null

string	$activationend = null

ILIAS COPage ReadingTime ReadingTimeManager	$reading_time_manager

	$concrete_lang = ""

ILIAS COPage ID ContentIdManager	$content_id_manager

ILIAS COPage Page PageManager	$page_manager

ILIAS COPage Style StyleManager	$style_manager

ILIAS COPage PC DomainService	$pc_service

Additional Inherited Members
Data Fields inherited from ilPageObject
int	$old_nr

DOMDocument	$dom = null

string	$xml = ""

string	$encoding = ""

DomNode	$node

string	$cur_dtd = "ilias_pg_9.dtd"

bool	$contains_int_link = false

bool	$needs_parsing = false

string	$parent_type = ""

int	$parent_id = 0

array	$update_listeners = []

int	$update_listener_cnt = 0

object	$offline_handler = null

bool	$dom_builded = false

bool	$history_saved = false

int	$last_change_user = 0

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

Protected Member Functions inherited from ilPageObject
	getIliasAbsolutePath ()

	getLangVarXML (string $var)

	__afterUpdate (DOMDocument $a_domdoc, string $a_xml, bool $a_creation=false, bool $a_empty=false)
	After update event handler (internal). More...

	isTranslationPage ()

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

	__afterDelete ()

	afterDelete ()

	__afterHistoryEntry (DOMDocument $a_old_domdoc, string $a_old_content, int $a_old_nr)

	getContentManager ()

	setCopyProperties (ilPageObject $new_page)

	setTranslationProperties (self $transl_page)

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

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 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 26 of file class.ilBlogPosting.php.

Member Function Documentation

◆ checkApproval()

ilBlogPosting::checkApproval ( )

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

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

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

Here is the call graph for this function:

◆ create()

ilBlogPosting::create ( bool $a_import = false )

Create new blog posting.

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

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

      : void {
         $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
         $withdrawn = $this->getWithdrawn()?->get(IL_CAL_DATETIME);
         $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($withdrawn, "timestamp") . ")";
         $ilDB->manipulate($query);
 
         if (!$a_import) {
             parent::create($a_import);
             // $this->saveInternalLinks($this->getXMLContent());
         }
     }

Here is the call graph for this function:

◆ delete()

ilBlogPosting::delete ( )

Delete blog posting and all related data.

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

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

                             : void
     {
         $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();
     }

Here is the call graph for this function:

◆ deleteAllBlogPostings()

static ilBlogPosting::deleteAllBlogPostings ( int $a_blog_id )

static

Delete all postings for blog.

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

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

Referenced by ilObjBlog\doDelete().

      : void {
         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();
         }
     }

Here is the caller graph for this function:

◆ exists()

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

static

Checks whether a posting exists.

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

References $DIC, and $ilDB.

Referenced by ilObjBlogGUI\executeCommand().

      : bool {
         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;
     }

Here is the caller graph for this function:

◆ getAllPostings()

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

static

Get all postings of blog.

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

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

Referenced by ilObjBlogGUI\buildPostingList(), ILIAS\Blog\Export\BlogHtmlExport\collectAllPagesPageElements(), ilObjBlog\deliverRSS(), ILIAS\Blog\Export\BlogHtmlExport\exportHTMLPages(), ILIAS\Blog\BlogPrintViewProviderGUI\getPages(), ILIAS\Portfolio\PortfolioPrintViewProviderGUI\getPages(), ILIAS\Portfolio\PortfolioPrintViewProviderGUI\getSelectionForm(), ILIAS\Blog\BlogPrintViewProviderGUI\getSelectionForm(), ilBlogDraftsDerivedTaskProvider\getTasks(), ilBlogExporter\getXmlExportTailDependencies(), ilBlogPostingGUI\initKeywordsForm(), and ilPCBlogGUI\initPostingForm().

      : array {
         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;
     }

Here is the caller graph for this function:

◆ getAuthor()

ilBlogPosting::getAuthor ( )

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

References $author.

Referenced by create(), and handleNews().

                                : int
     {
         return $this->author;
     }

Here is the caller graph for this function:

◆ getBlogId()

ilBlogPosting::getBlogId ( )

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

References ilPageObject\getParentId().

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

                                : int
     {
         return $this->getParentId();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCreated()

ilBlogPosting::getCreated ( )

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

References $created.

Referenced by create(), and update().

                                 : ilDateTime
     {
         return $this->created;
     }

Here is the caller graph for this function:

◆ getKeywords()

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

static

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

References ilMDKeyword\lookupKeywords().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLastPost()

static ilBlogPosting::getLastPost ( int $a_blog_id )

static

Get newest posting for blog.

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

References $data.

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

◆ getMDSection()

ilBlogPosting::getMDSection ( )

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

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

Referenced by updateKeywords().

                                   : ?ilMDGeneral
     {
         // 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;
         }
         return $md_section;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getNotificationAbstract()

ilBlogPosting::getNotificationAbstract ( )

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

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

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

Here is the call graph for this function:

◆ getParentType()

ilBlogPosting::getParentType ( )

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

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

                                    : string
     {
         return "blp";
     }

Here is the caller graph for this function:

◆ getTitle()

ilBlogPosting::getTitle ( )

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

References $title.

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

                               : string
     {
         return $this->title;
     }

Here is the caller graph for this function:

◆ getWithdrawn()

ilBlogPosting::getWithdrawn ( )

Get last withdrawal date.

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

References $withdrawn.

Referenced by create(), and update().

                                   : ?ilDateTime
     {
         return $this->withdrawn;
     }

Here is the caller graph for this function:

◆ handleNews()

ilBlogPosting::handleNews ( bool $a_update = false )

Handle news item.

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

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

      : void {
         $lng = $this->lng;
         $ilUser = $this->user;
 
         // see ilWikiPage::updateNews()
 
         if (!$this->getActive()) {
             return;
         }
 
         $news_item = null;
 
         // try to re-use existing news item
         if ($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 (count($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);
         }
     }

Here is the call graph for this function:

◆ isApproved()

ilBlogPosting::isApproved ( )

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

References $approved.

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

                                 : bool
     {
         return $this->approved;
     }

Here is the caller graph for this function:

◆ lookup()

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

staticprotected

Lookup posting property.

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

References ilPageObject\$db, $DIC, ilDBInterface\fetchAssoc(), ilDBInterface\query(), and ilDBInterface\quote().

      : ?string {
         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] ?? null;
     }

Here is the call graph for this function:

◆ lookupBlogId()

static ilBlogPosting::lookupBlogId ( int $a_posting_id )

static

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

References $DIC, and $ilDB.

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

      : ?int {
         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 (int) $rec["blog_id"];
         }
         return null;
     }

Here is the caller graph for this function:

◆ lookupTitle()

static ilBlogPosting::lookupTitle ( int $a_posting_id )

static

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

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

◆ read()

ilBlogPosting::read ( )

Read blog posting.

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

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

                           : void
     {
         $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 ($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();
     }

Here is the call graph for this function:

◆ searchBlogsByAuthor()

static ilBlogPosting::searchBlogsByAuthor ( int $a_user_id )

static

Get all blogs where user has postings.

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

References $DIC, $ilDB, and ILIAS\Repository\int().

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

      : array {
         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[] = (int) $row["blog_id"];
         }
         return $ids;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setApproved()

ilBlogPosting::setApproved ( bool $a_status )

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

Referenced by read(), and unpublish().

                                                : void
     {
         $this->approved = $a_status;
     }

Here is the caller graph for this function:

◆ setAuthor()

ilBlogPosting::setAuthor ( int $a_id )

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

Referenced by read().

                                         : void
     {
         $this->author = $a_id;
     }

Here is the caller graph for this function:

◆ setBlogId()

ilBlogPosting::setBlogId ( int $a_id )

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

References ilPageObject\setParentId().

Referenced by read().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setBlogNodeId()

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

Set blog node id (needed for notification)

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

      : void {
         $this->blog_node_id = $a_id;
         $this->blog_node_is_wsp = $a_is_in_workspace;
     }

◆ setCreated()

ilBlogPosting::setCreated ( ilDateTime $a_date )

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

Referenced by read().

                                                   : void
     {
         $this->created = $a_date;
     }

Here is the caller graph for this function:

◆ setTitle()

ilBlogPosting::setTitle ( string $a_title )

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

Referenced by read().

                                              : void
     {
         $this->title = $a_title;
     }

Here is the caller graph for this function:

◆ setWithdrawn()

ilBlogPosting::setWithdrawn ( ilDateTime $a_date )

Set last withdrawal date.

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

Referenced by read(), and unpublish().

      : void {
         $this->withdrawn = $a_date;
     }

Here is the caller graph for this function:

◆ unpublish()

ilBlogPosting::unpublish ( )

Unpublish.

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

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

                                : void
     {
         $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()
         );
     }

Here is the call graph for this function:

◆ update()

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

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

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

Referenced by checkApproval(), and unpublish().

       {
         $ilDB = $this->db;
 
         // blog_id, author and created cannot be changed
         $withdrawn = $this->getWithdrawn()?->get(IL_CAL_DATETIME);
         $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($withdrawn, "timestamp") .
             " WHERE id = " . $ilDB->quote($this->getId(), "integer");
         $ilDB->manipulate($query);
 
         $ret = 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 $ret;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateKeywords()

ilBlogPosting::updateKeywords ( array $keywords )

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

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

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

Here is the call graph for this function:

Field Documentation

◆ $approved

bool ilBlogPosting::$approved = false

protected

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

Referenced by isApproved().

◆ $author

int ilBlogPosting::$author = 0

protected

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

Referenced by getAuthor().

◆ $blog_node_id

int ilBlogPosting::$blog_node_id = 0

protected

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

◆ $blog_node_is_wsp

bool ilBlogPosting::$blog_node_is_wsp = false

protected

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

◆ $created

ilDateTime ilBlogPosting::$created = null

protected

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

Referenced by getCreated().

◆ $title

string ilBlogPosting::$title = ""

protected

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

Referenced by getTitle().

◆ $withdrawn

ilDateTime ilBlogPosting::$withdrawn = null

protected

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

Referenced by getWithdrawn().

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

Modules/Blog/Posting/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