Collaboration diagram for ilForumPostDraft:

Public Member Functions
	__construct (int $user_id=0, int $post_id=0, int $draft_id=0)

	getRCID ()

	setRCID (string $rcid)

	isPostNotificationEnabled ()

	setPostNotificationStatus (bool $post_notify)

	isNotificationEnabled ()

	setNotificationStatus (bool $notify)

	getDraftId ()

	setDraftId (int $draft_id)

	getPostId ()

	setPostId (int $post_id)

	getForumId ()

	setForumId (int $forum_id)

	getThreadId ()

	setThreadId (int $thread_id)

	getPostSubject ()

	setPostSubject (string $post_subject)

	getPostMessage ()

	setPostMessage (string $post_message)

	getPostDate ()

	setPostDate (string $post_date)

	getPostUpdate ()

	setPostUpdate (string $post_update)

	getUpdateUserId ()

	setUpdateUserId (int $update_user_id)

	getPostUserAlias ()

	setPostUserAlias (string $post_user_alias)

	getPostAuthorId ()

	setPostAuthorId (int $post_author_id)

	getPostDisplayUserId ()

	setPostDisplayUserId (int $post_display_user_id)

	saveDraft ()

	update ()

	updateDraft ()

	deleteDraft ()

	deleteDraftsByPostIds (array $post_ids=[])

	deleteDraftsByDraftIds (array $draft_ids=[])

Static Public Member Functions
static	getSortedDrafts (int $usrId, int $threadId, int $sorting=ilForumProperties::VIEW_DATE_ASC)

static	getDraftInstancesByUserId (int $user_id)

static	newInstanceByDraftId (int $draft_id)

static	deleteMobsOfDraft (int $draft_id)

static	deleteDraftsByUserId (int $user_id)

static	isSavePostDraftAllowed ()

static	isAutoSavePostDraftAllowed ()

static	lookupAutosaveInterval ()

static	getDraftsStatisticsByRefId (int $ref_id)

static	moveDraftsByMergedThreads (int $source_thread_id, int $target_thread_id)

static	getThreadDraftData (int $post_author_id, int $forum_id)

static	createDraftBackup (int $draft_id)

Data Fields
const	MEDIAOBJECT_TYPE = 'frm~d:html'

const	NO_RCID = '-'

Protected Member Functions
	readDraft ()

Static Protected Member Functions
static	readDrafts (int $user_id)

Static Private Member Functions
static	populateWithDatabaseRecord (ilForumPostDraft $draft, array $row)

Private Attributes
readonly ilDBInterface	$db

int	$draft_id = 0

int	$post_id = 0

int	$forum_id = 0

int	$thread_id = 0

string	$post_subject = ''

string	$post_message = ''

string	$post_date = '0000-00-00 00:00:00'

string	$post_update = '0000-00-00 00:00:00'

int	$update_user_id = 0

string	$post_user_alias = ''

int	$post_author_id = 0

int	$post_display_user_id = 0

bool	$notify = false

bool	$post_notify = false

string	$rcid = ''

Static Private Attributes
static array	$instances = []

static array	$forum_statistics_cache = []

static array	$drafts_settings_cache = []

Detailed Description

Class ilForumPostDraft.

Author: Nadia Matuschek nmatu.nosp@m.sche.nosp@m.k@dat.nosp@m.abay.nosp@m..de

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

Constructor & Destructor Documentation

◆ __construct()

ilForumPostDraft::__construct	(	int	$user_id = `0`,
		int	$post_id = `0`,
		int	$draft_id = `0`
	)

Definition at line 52 of file class.ilForumPostDraft.php.

    {
        global $DIC;
 
        $this->db = $DIC->database();
 
        if ($user_id && $post_id && $draft_id) {
            $this->setPostAuthorId($user_id);
            $this->setPostId($post_id);
            $this->setDraftId($draft_id);
            $this->readDraft();
        }
    }

References $DIC, $draft_id, $post_id, $user_id, readDraft(), setDraftId(), setPostAuthorId(), and setPostId().

Here is the call graph for this function:

Member Function Documentation

◆ createDraftBackup()

static ilForumPostDraft::createDraftBackup ( int $draft_id )

static

Definition at line 618 of file class.ilForumPostDraft.php.

                                                           : void
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $res = $ilDB->queryF(
            'SELECT * FROM frm_posts_drafts WHERE draft_id = %s',
            ['integer'],
            [$draft_id]
        );
 
        $tmp_obj = new self();
        while ($row = $ilDB->fetchAssoc($res)) {
            self::populateWithDatabaseRecord($tmp_obj, $row);
        }
 
        $history_obj = new ilForumDraftsHistory();
        $history_obj->deleteHistoryByDraftIds([$draft_id]);
 
        $history_obj->setDraftId($draft_id);
        $history_obj->setPostSubject($tmp_obj->getPostSubject());
        $history_obj->setPostMessage($tmp_obj->getPostMessage());
        $history_obj->addDraftToHistory();
 
        ilForumUtil::moveMediaObjects(
            $tmp_obj->getPostMessage(),
            self::MEDIAOBJECT_TYPE,
            $draft_id,
            ilForumDraftsHistory::MEDIAOBJECT_TYPE,
            $history_obj->getHistoryId()
        );
    }

References $DIC, $ilDB, $res, ilForumDraftsHistory\MEDIAOBJECT_TYPE, and ilForumUtil\moveMediaObjects().

Referenced by ilObjForumGUI\doHistoryCheck(), and ilObjForumGUI\restoreFromHistoryObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteDraft()

ilForumPostDraft::deleteDraft ( )

Definition at line 391 of file class.ilForumPostDraft.php.

                                 : void
    {
        $this->db->manipulateF(
            'DELETE FROM frm_posts_drafts WHERE draft_id = %s',
            ['integer'],
            [$this->getDraftId()]
        );
    }

Referenced by ilObjForumGUI\createThread().

Here is the caller graph for this function:

◆ deleteDraftsByDraftIds()

ilForumPostDraft::deleteDraftsByDraftIds ( array $draft_ids = [] )

Parameters

int[] $draft_ids

Definition at line 452 of file class.ilForumPostDraft.php.

                                                                 : void
    {
        foreach ($draft_ids as $draft_id) {
            self::deleteMobsOfDraft($draft_id);
        }
 
        $objFileDataForumDrafts = new ilFileDataForumDrafts();
        $objFileDataForumDrafts->delete($draft_ids);
 
        $this->db->manipulate('DELETE FROM frm_drafts_history WHERE ' . $this->db->in(
            'draft_id',
            $draft_ids,
            false,
            'integer'
        ));
        $this->db->manipulate('DELETE FROM frm_posts_drafts WHERE ' . $this->db->in(
            'draft_id',
            $draft_ids,
            false,
            'integer'
        ));
    }

◆ deleteDraftsByPostIds()

ilForumPostDraft::deleteDraftsByPostIds ( array $post_ids = [] )

Parameters

int[] $post_ids

Definition at line 415 of file class.ilForumPostDraft.php.

                                                               : void
    {
        $draft_ids = [];
        $res = $this->db->query('SELECT draft_id FROM frm_posts_drafts WHERE ' . $this->db->in(
            'post_id',
            $post_ids,
            false,
            'integer'
        ));
        while ($row = $this->db->fetchAssoc($res)) {
            $draft_ids[] = (int) $row['draft_id'];
        }
 
        foreach ($draft_ids as $draft_id) {
            self::deleteMobsOfDraft($draft_id);
        }
 
        $objFileDataForumDrafts = new ilFileDataForumDrafts();
        $objFileDataForumDrafts->delete($draft_ids);
 
        $this->db->manipulate('DELETE FROM frm_drafts_history WHERE ' . $this->db->in(
            'draft_id',
            $draft_ids,
            false,
            'integer'
        ));
        $this->db->manipulate('DELETE FROM frm_posts_drafts WHERE ' . $this->db->in(
            'draft_id',
            $draft_ids,
            false,
            'integer'
        ));
    }

References $res, and ILIAS\Repository\int().

Here is the call graph for this function:

◆ deleteDraftsByUserId()

static ilForumPostDraft::deleteDraftsByUserId ( int $user_id )

static

Definition at line 475 of file class.ilForumPostDraft.php.

                                                             : void
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $res = $ilDB->queryF(
            'SELECT draft_id FROM frm_posts_drafts WHERE post_author_id = %s',
            ['integer'],
            [$user_id]
        );
 
        $draft_ids = [];
        while ($row = $ilDB->fetchAssoc($res)) {
            $draft_ids[] = (int) $row['draft_id'];
        }
 
        foreach ($draft_ids as $draft_id) {
            self::deleteMobsOfDraft($draft_id);
        }
 
        $objFileDataForumDrafts = new ilFileDataForumDrafts();
        $objFileDataForumDrafts->delete($draft_ids);
 
        $ilDB->manipulate('DELETE FROM frm_drafts_history WHERE ' . $ilDB->in(
            'draft_id',
            $draft_ids,
            false,
            'integer'
        ));
        $ilDB->manipulateF(
            'DELETE FROM frm_posts_drafts WHERE post_author_id = %s',
            ['integer'],
            [$user_id]
        );
    }

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

Here is the call graph for this function:

◆ deleteMobsOfDraft()

static ilForumPostDraft::deleteMobsOfDraft ( int $draft_id )

static

Definition at line 400 of file class.ilForumPostDraft.php.

                                                           : void
    {
        $oldMediaObjects = ilObjMediaObject::_getMobsOfObject('frm~d:html', $draft_id);
        foreach ($oldMediaObjects as $oldMob) {
            if (ilObjMediaObject::_exists($oldMob)) {
                ilObjMediaObject::_removeUsage($oldMob, 'frm~d:html', $draft_id);
                $mob_obj = new ilObjMediaObject($oldMob);
                $mob_obj->delete();
            }
        }
    }

References ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), and ilObjMediaObject\_removeUsage().

Here is the call graph for this function:

◆ getDraftId()

ilForumPostDraft::getDraftId ( )

Definition at line 115 of file class.ilForumPostDraft.php.

                                : int
    {
        return $this->draft_id;
    }

References $draft_id.

Referenced by ilObjForumGUI\createThread(), ilObjForumGUI\createTopLevelPostObject(), ilObjForumGUI\hasDraftAccess(), and readDraft().

Here is the caller graph for this function:

◆ getDraftInstancesByUserId()

static ilForumPostDraft::getDraftInstancesByUserId ( int $user_id )

static

Returns: array<int, ilForumPostDraft>

Definition at line 319 of file class.ilForumPostDraft.php.

                                                                  : array
    {
        if (!isset(self::$instances[$user_id])) {
            self::readDrafts($user_id);
        }
 
        return self::$instances[$user_id]['draft_ids'];
    }

References $user_id.

Referenced by ilObjForumGUI\confirmDeleteThreadDraftsObject(), ilObjForumGUI\deleteThreadDraftsObject(), and ilForumDraftsDerivedTaskProvider\getTasks().

Here is the caller graph for this function:

◆ getDraftsStatisticsByRefId()

static ilForumPostDraft::getDraftsStatisticsByRefId ( int $ref_id )

static

Definition at line 548 of file class.ilForumPostDraft.php.

                                                                  : array
    {
        global $DIC;
        $ilDB = $DIC->database();
        $ilUser = $DIC->user();
 
        if (!isset(self::$forum_statistics_cache[$ref_id][$ilUser->getId()])) {
            $forumId = ilObjForum::lookupForumIdByRefId($ref_id);
 
            $res = $ilDB->queryF(
                '
                                SELECT COUNT(draft_id) num_drafts, thread_id FROM frm_posts_drafts 
                                LEFT JOIN frm_posts ON pos_pk = post_id 
                                WHERE forum_id = %s AND post_author_id = %s AND (frm_posts.pos_pk IS NOT NULL OR post_id = 0)
                                GROUP BY thread_id',
                ['integer', 'integer'],
                [$forumId, $ilUser->getId()]
            );
 
            $num_drafts_total = 0;
 
            while ($row = $ilDB->fetchAssoc($res)) {
                $num_drafts_total += $row['num_drafts'];
                self::$forum_statistics_cache[$ref_id][$ilUser->getId()][(int) $row['thread_id']] = (int) $row['num_drafts'];
            }
 
            self::$forum_statistics_cache[$ref_id][$ilUser->getId()]['total'] = $num_drafts_total;
        }
        return self::$forum_statistics_cache[$ref_id][$ilUser->getId()];
    }

References $DIC, $ilDB, $ref_id, $res, ILIAS\Repository\int(), and ilObjForum\lookupForumIdByRefId().

Referenced by ilObjForumListGUI\getProperties().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getForumId()

ilForumPostDraft::getForumId ( )

Definition at line 135 of file class.ilForumPostDraft.php.

                                : int
    {
        return $this->forum_id;
    }

References $forum_id.

◆ getPostAuthorId()

ilForumPostDraft::getPostAuthorId ( )

Definition at line 215 of file class.ilForumPostDraft.php.

                                     : int
    {
        return $this->post_author_id;
    }

References $post_author_id.

Referenced by ilObjForumGUI\createThread(), ilObjForumGUI\hasDraftAccess(), and readDraft().

Here is the caller graph for this function:

◆ getPostDate()

ilForumPostDraft::getPostDate ( )

Definition at line 175 of file class.ilForumPostDraft.php.

                                 : string
    {
        return $this->post_date;
    }

References $post_date.

◆ getPostDisplayUserId()

ilForumPostDraft::getPostDisplayUserId ( )

Definition at line 225 of file class.ilForumPostDraft.php.

                                          : int
    {
        return $this->post_display_user_id;
    }

References $post_display_user_id.

Referenced by ilObjForumGUI\createThread().

Here is the caller graph for this function:

◆ getPostId()

ilForumPostDraft::getPostId ( )

Definition at line 125 of file class.ilForumPostDraft.php.

                               : int
    {
        return $this->post_id;
    }

References $post_id.

◆ getPostMessage()

ilForumPostDraft::getPostMessage ( )

Definition at line 165 of file class.ilForumPostDraft.php.

                                    : string
    {
        return $this->post_message;
    }

References $post_message.

◆ getPostSubject()

ilForumPostDraft::getPostSubject ( )

Definition at line 155 of file class.ilForumPostDraft.php.

                                    : string
    {
        return $this->post_subject;
    }

References $post_subject.

◆ getPostUpdate()

ilForumPostDraft::getPostUpdate ( )

Definition at line 185 of file class.ilForumPostDraft.php.

                                   : string
    {
        return $this->post_update;
    }

References $post_update.

◆ getPostUserAlias()

ilForumPostDraft::getPostUserAlias ( )

Definition at line 205 of file class.ilForumPostDraft.php.

                                      : string
    {
        return $this->post_user_alias;
    }

References $post_user_alias.

Referenced by ilObjForumGUI\createThread().

Here is the caller graph for this function:

◆ getRCID()

ilForumPostDraft::getRCID ( )

Definition at line 85 of file class.ilForumPostDraft.php.

                             : string
    {
        return $this->rcid;
    }

References $rcid.

Referenced by ilObjForumGUI\createThread().

Here is the caller graph for this function:

◆ getSortedDrafts()

static ilForumPostDraft::getSortedDrafts	(	int	$usrId,
		int	$threadId,
		int	$sorting = `ilForumProperties::VIEW_DATE_ASC`
	)

static

Returns: ilForumPostDraft[]|array<int, ilForumPostDraft[]>

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

     : array {
        global $DIC;
        $ilDB = $DIC->database();
 
        $drafts = [];
 
        $orderColumn = ' ';
        $orderDirection = ' ';
 
        if ($sorting !== ilForumProperties::VIEW_TREE) {
            $orderColumn = ' ORDER BY post_date ';
            $orderDirection = 'ASC';
            if ($sorting === ilForumProperties::VIEW_DATE_DESC) {
                $orderDirection = 'DESC';
            }
        }
 
        $res = $ilDB->queryF(
            'SELECT * FROM frm_posts_drafts WHERE post_author_id = %s AND thread_id = %s' .
            $orderColumn . $orderDirection,
            ['integer', 'integer'],
            [$usrId, $threadId]
        );
 
        while ($row = $ilDB->fetchAssoc($res)) {
            $draft = new ilForumPostDraft();
            self::populateWithDatabaseRecord($draft, $row);
            $drafts[] = $draft;
            self::$instances[$usrId][$threadId][$draft->getPostId()][] = $draft;
        }
 
        if (ilForumProperties::VIEW_TREE === $sorting) {
            return self::$instances[$usrId][$threadId] ?? [];
        }
 
        return $drafts;
    }

References ilForumProperties\VIEW_DATE_DESC.

Referenced by ilObjForumGUI\viewThreadObject().

Here is the caller graph for this function:

◆ getThreadDraftData()

static ilForumPostDraft::getThreadDraftData	(	int	$post_author_id,
		int	$forum_id
	)

static

Definition at line 591 of file class.ilForumPostDraft.php.

                                                                                 : array
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $res = $ilDB->queryF(
            'SELECT * FROM frm_posts_drafts 
                                WHERE post_author_id = %s
                                AND forum_id = %s 
                                AND thread_id = %s
                                AND post_id = %s
                                ORDER BY post_date DESC',
            ['integer', 'integer', 'integer', 'integer'],
            [$post_author_id, $forum_id, 0, 0]
        );
        $draft_data = [];
        while ($row = $ilDB->fetchAssoc($res)) {
            $tmp_obj = new self();
            self::populateWithDatabaseRecord($tmp_obj, $row);
            $draft_data[] = ['subject' => $tmp_obj->getPostSubject(),
                             'post_update' => $tmp_obj->getPostUpdate(),
                             'draft_id' => $tmp_obj->getDraftId()
            ];
        }
        return $draft_data;
    }

References $DIC, $ilDB, and $res.

Referenced by ilObjForumGUI\addDraftButtonIfDraftsExists(), ilObjForumGUI\confirmDeleteThreadDraftsObject(), and ILIAS\Forum\Drafts\ForumDraftsTable\initRecords().

Here is the caller graph for this function:

◆ getThreadId()

ilForumPostDraft::getThreadId ( )

Definition at line 145 of file class.ilForumPostDraft.php.

                                 : int
    {
        return $this->thread_id;
    }

References $thread_id.

◆ getUpdateUserId()

ilForumPostDraft::getUpdateUserId ( )

Definition at line 195 of file class.ilForumPostDraft.php.

                                     : int
    {
        return $this->update_user_id;
    }

References $update_user_id.

◆ isAutoSavePostDraftAllowed()

static ilForumPostDraft::isAutoSavePostDraftAllowed ( )

static

Definition at line 521 of file class.ilForumPostDraft.php.

                                                       : bool
    {
        if (!self::isSavePostDraftAllowed()) {
            return false;
        }
 
        if (!isset(self::$drafts_settings_cache['autosave_drafts'])) {
            global $DIC;
 
            self::$drafts_settings_cache['autosave_drafts'] = (bool) $DIC->settings()->get('autosave_drafts', '0');
            self::$drafts_settings_cache['autosave_drafts_ival'] = (int) $DIC->settings()->get(
                'autosave_drafts_ival',
                '30'
            );
        }
 
        return self::$drafts_settings_cache['autosave_drafts'];
    }

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

Referenced by ilForumThreadFormGUI\addAutosaveInfo(), ilObjForumGUI\decorateWithAutosave(), ilObjForumGUI\doHistoryCheck(), ilForumAutoSaveAsyncDraftAction\executeAndGetResponseObject(), and ilObjForumGUI\initReplyEditForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isNotificationEnabled()

ilForumPostDraft::isNotificationEnabled ( )

Definition at line 105 of file class.ilForumPostDraft.php.

                                           : bool
    {
        return $this->notify;
    }

References $notify.

Referenced by ilObjForumGUI\createThread().

Here is the caller graph for this function:

◆ isPostNotificationEnabled()

ilForumPostDraft::isPostNotificationEnabled ( )

Definition at line 95 of file class.ilForumPostDraft.php.

                                               : bool
    {
        return $this->post_notify;
    }

References $post_notify.

Referenced by ilObjForumGUI\createThread().

Here is the caller graph for this function:

◆ isSavePostDraftAllowed()

static ilForumPostDraft::isSavePostDraftAllowed ( )

static

Definition at line 511 of file class.ilForumPostDraft.php.

                                                   : bool
    {
        if (!isset(self::$drafts_settings_cache['save_post_drafts'])) {
            global $DIC;
            self::$drafts_settings_cache['save_post_drafts'] = (bool) $DIC->settings()->get('save_post_drafts', '0');
        }
 
        return self::$drafts_settings_cache['save_post_drafts'];
    }

References $DIC.

Here is the caller graph for this function:

◆ lookupAutosaveInterval()

static ilForumPostDraft::lookupAutosaveInterval ( )

static

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

                                                   : int
    {
        if (self::isAutoSavePostDraftAllowed()) {
            return (int) self::$drafts_settings_cache['autosave_drafts_ival'];
        }
        return 0;
    }

Referenced by ilForumThreadFormGUI\addAutosaveInfo(), ilObjForumGUI\decorateWithAutosave(), and ilObjForumGUI\initReplyEditForm().

Here is the caller graph for this function:

◆ moveDraftsByMergedThreads()

static ilForumPostDraft::moveDraftsByMergedThreads	(	int	$source_thread_id,
		int	$target_thread_id
	)

static

Definition at line 579 of file class.ilForumPostDraft.php.

                                                                                                  : void
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $ilDB->update(
            'frm_posts_drafts',
            ['thread_id' => ['integer', $target_thread_id]],
            ['thread_id' => ['integer', $source_thread_id]]
        );
    }

References $DIC, and $ilDB.

◆ newInstanceByDraftId()

static ilForumPostDraft::newInstanceByDraftId ( int $draft_id )

static

Definition at line 328 of file class.ilForumPostDraft.php.

                                                              : ilForumPostDraft
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $res = $ilDB->queryF(
            'SELECT * FROM frm_posts_drafts WHERE draft_id = %s',
            ['integer'],
            [$draft_id]
        );
 
        $tmp_obj = new ilForumPostDraft();
        while ($row = $ilDB->fetchAssoc($res)) {
            self::populateWithDatabaseRecord($tmp_obj, $row);
        }
        return $tmp_obj;
    }

References $DIC, $ilDB, and $res.

Referenced by ilForumThreadFormGUI\addFileUploadInput(), ilObjForumGUI\addThreadObject(), ilObjForumGUI\cancelDraftObject(), ilObjForumGUI\cancelPostObject(), ilMobStakeholder\checkAccessMobUsage(), ilObjForumGUI\checkDraftAccess(), ilObjForumGUI\deliverDraftZipFileObject(), ilObjForumGUI\editThreadDraftObject(), ilForumAutoSaveAsyncDraftAction\executeAndGetResponseObject(), ilFileDataForumDraftsRCImplementation\getDraftById(), ilObjForumGUI\hasDraftAccess(), ilObjForumGUI\publishThreadDraftObject(), ilForumDraftsHistory\rollbackAutosave(), ilObjForumGUI\saveAsDraftObject(), ilObjForumGUI\saveThreadAsDraftObject(), and ilObjForumGUI\updateThreadDraftObject().

Here is the caller graph for this function:

◆ populateWithDatabaseRecord()

static ilForumPostDraft::populateWithDatabaseRecord	(	ilForumPostDraft	$draft,
		array	$row
	)

staticprivate

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

                                                                                           : void
    {
        $draft->setDraftId((int) $row['draft_id']);
        $draft->setForumId((int) $row['forum_id']);
        $draft->setThreadId((int) $row['thread_id']);
        $draft->setPostId((int) $row['post_id']);
        $draft->setPostAuthorId((int) $row['post_author_id']);
        $draft->setPostDisplayUserId((int) $row['pos_display_usr_id']);
        $draft->setUpdateUserId((int) $row['update_user_id']);
        $draft->setPostSubject((string) $row['post_subject']);
        $draft->setPostMessage((string) $row['post_message']);
        $draft->setPostDate((string) $row['post_date']);
        $draft->setPostUpdate((string) $row['post_update']);
        $draft->setPostUserAlias((string) $row['post_user_alias']);
        $draft->setNotificationStatus((bool) $row['notify']);
        $draft->setPostNotificationStatus((bool) $row['post_notify']);
        $draft->setRCID((string) ($row['rcid']));
    }

References setDraftId(), setForumId(), setNotificationStatus(), setPostAuthorId(), setPostDate(), setPostDisplayUserId(), setPostId(), setPostMessage(), setPostNotificationStatus(), setPostSubject(), setPostUpdate(), setPostUserAlias(), setRCID(), setThreadId(), and setUpdateUserId().

Referenced by readDraft(), and readDrafts().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ readDraft()

ilForumPostDraft::readDraft ( )

protected

Definition at line 235 of file class.ilForumPostDraft.php.

                                  : void
    {
        $res = $this->db->queryF(
            'SELECT * FROM frm_posts_drafts WHERE post_author_id = %s AND draft_id = %s',
            ['integer', 'integer'],
            [$this->getPostAuthorId(), $this->getDraftId()]
        );
 
        if ($row = $this->db->fetchAssoc($res)) {
            self::populateWithDatabaseRecord($this, $row);
        }
    }

References $res, getDraftId(), getPostAuthorId(), and populateWithDatabaseRecord().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ readDrafts()

static ilForumPostDraft::readDrafts ( int $user_id )

staticprotected

Definition at line 248 of file class.ilForumPostDraft.php.

                                                      : void
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $res = $ilDB->queryF(
            'SELECT * FROM frm_posts_drafts WHERE post_author_id = %s',
            ['integer'],
            [$user_id]
        );
 
        self::$instances[$user_id] = [
            'draft_ids' => [],
        ];
 
        while ($row = $ilDB->fetchAssoc($res)) {
            $draft = new ilForumPostDraft();
            self::populateWithDatabaseRecord($draft, $row);
            self::$instances[$user_id][$row['thread_id']][$draft->getPostId()][] = $draft;
            self::$instances[$user_id]['draft_ids'][$draft->getDraftId()] = $draft;
        }
    }

References $DIC, $ilDB, $res, $user_id, and populateWithDatabaseRecord().

Here is the call graph for this function:

◆ saveDraft()

ilForumPostDraft::saveDraft ( )

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

                               : int
    {
        $draft_id = $this->db->nextId('frm_posts_drafts');
        $post_date = date("Y-m-d H:i:s");
 
        $this->db->insert('frm_posts_drafts', [
            'draft_id' => ['integer', $draft_id],
            'post_id' => ['integer', $this->getPostId()],
            'thread_id' => ['integer', $this->getThreadId()],
            'forum_id' => ['integer', $this->getForumId()],
            'post_author_id' => ['integer', $this->getPostAuthorId()],
            'post_subject' => ['text', $this->getPostSubject()],
            'post_message' => ['clob', $this->getPostMessage()],
            'notify' => ['integer', (int) $this->isNotificationEnabled()],
            'post_notify' => ['integer', (int) $this->isPostNotificationEnabled()],
            'post_date' => ['timestamp', $post_date],
            'post_update' => ['timestamp', $post_date],
            'post_user_alias' => ['text', $this->getPostUserAlias()],
            'pos_display_usr_id' => ['integer', $this->getPostDisplayUserId()]
        ]);
        $this->setDraftId($draft_id);
        return $draft_id;
    }

◆ setDraftId()

ilForumPostDraft::setDraftId ( int $draft_id )

Definition at line 120 of file class.ilForumPostDraft.php.

                                             : void
    {
        $this->draft_id = $draft_id;
    }

References $draft_id.

Referenced by __construct(), and populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setForumId()

ilForumPostDraft::setForumId ( int $forum_id )

Definition at line 140 of file class.ilForumPostDraft.php.

                                             : void
    {
        $this->forum_id = $forum_id;
    }

References $forum_id.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setNotificationStatus()

ilForumPostDraft::setNotificationStatus ( bool $notify )

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

                                                       : void
    {
        $this->notify = $notify;
    }

References $notify.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostAuthorId()

ilForumPostDraft::setPostAuthorId ( int $post_author_id )

Definition at line 220 of file class.ilForumPostDraft.php.

                                                        : void
    {
        $this->post_author_id = $post_author_id;
    }

References $post_author_id.

Referenced by __construct(), and populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostDate()

ilForumPostDraft::setPostDate ( string $post_date )

Definition at line 180 of file class.ilForumPostDraft.php.

                                                  : void
    {
        $this->post_date = $post_date;
    }

References $post_date.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostDisplayUserId()

ilForumPostDraft::setPostDisplayUserId ( int $post_display_user_id )

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

                                                                   : void
    {
        $this->post_display_user_id = $post_display_user_id;
    }

References $post_display_user_id.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostId()

ilForumPostDraft::setPostId ( int $post_id )

Definition at line 130 of file class.ilForumPostDraft.php.

                                           : void
    {
        $this->post_id = $post_id;
    }

References $post_id.

Referenced by __construct(), and populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostMessage()

ilForumPostDraft::setPostMessage ( string $post_message )

Definition at line 170 of file class.ilForumPostDraft.php.

                                                        : void
    {
        $this->post_message = $post_message;
    }

References $post_message.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostNotificationStatus()

ilForumPostDraft::setPostNotificationStatus ( bool $post_notify )

Definition at line 100 of file class.ilForumPostDraft.php.

                                                                : void
    {
        $this->post_notify = $post_notify;
    }

References $post_notify.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostSubject()

ilForumPostDraft::setPostSubject ( string $post_subject )

Definition at line 160 of file class.ilForumPostDraft.php.

                                                        : void
    {
        $this->post_subject = $post_subject;
    }

References $post_subject.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostUpdate()

ilForumPostDraft::setPostUpdate ( string $post_update )

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

                                                      : void
    {
        $this->post_update = $post_update;
    }

References $post_update.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setPostUserAlias()

ilForumPostDraft::setPostUserAlias ( string $post_user_alias )

Definition at line 210 of file class.ilForumPostDraft.php.

                                                             : void
    {
        $this->post_user_alias = $post_user_alias;
    }

References $post_user_alias.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setRCID()

ilForumPostDraft::setRCID ( string $rcid )

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

                                         : void
    {
        $this->rcid = $rcid;
    }

References $rcid.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setThreadId()

ilForumPostDraft::setThreadId ( int $thread_id )

Definition at line 150 of file class.ilForumPostDraft.php.

                                               : void
    {
        $this->thread_id = $thread_id;
    }

References $thread_id.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ setUpdateUserId()

ilForumPostDraft::setUpdateUserId ( int $update_user_id )

Definition at line 200 of file class.ilForumPostDraft.php.

                                                        : void
    {
        $this->update_user_id = $update_user_id;
    }

References $update_user_id.

Referenced by populateWithDatabaseRecord().

Here is the caller graph for this function:

◆ update()

ilForumPostDraft::update ( )

Definition at line 370 of file class.ilForumPostDraft.php.

                            : void
    {
        $this->updateDraft();
    }

◆ updateDraft()

ilForumPostDraft::updateDraft ( )

Definition at line 375 of file class.ilForumPostDraft.php.

                                 : void
    {
        $this->db->update(
            'frm_posts_drafts',
            [
                'post_subject' => ['text', $this->getPostSubject()],
                'post_message' => ['clob', $this->getPostMessage()],
                'post_user_alias' => ['text', $this->getPostUserAlias()],
                'post_update' => ['timestamp', date("Y-m-d H:i:s")],
                'update_user_id' => ['integer', $this->getUpdateUserId()],
                'rcid' => ['text', $this->getRCID()]
            ],
            ['draft_id' => ['integer', $this->getDraftId()]]
        );
    }

Field Documentation

◆ $db

readonly ilDBInterface ilForumPostDraft::$db

private

Definition at line 35 of file class.ilForumPostDraft.php.

◆ $draft_id

int ilForumPostDraft::$draft_id = 0

private

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

Referenced by __construct(), getDraftId(), and setDraftId().

◆ $drafts_settings_cache

array ilForumPostDraft::$drafts_settings_cache = []

staticprivate

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

◆ $forum_id

int ilForumPostDraft::$forum_id = 0

private

Definition at line 38 of file class.ilForumPostDraft.php.

Referenced by getForumId(), and setForumId().

◆ $forum_statistics_cache

array ilForumPostDraft::$forum_statistics_cache = []

staticprivate

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

◆ $instances

array ilForumPostDraft::$instances = []

staticprivate

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

◆ $notify

bool ilForumPostDraft::$notify = false

private

Definition at line 48 of file class.ilForumPostDraft.php.

Referenced by isNotificationEnabled(), and setNotificationStatus().

◆ $post_author_id

int ilForumPostDraft::$post_author_id = 0

private

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

Referenced by getPostAuthorId(), and setPostAuthorId().

◆ $post_date

string ilForumPostDraft::$post_date = '0000-00-00 00:00:00'

private

Definition at line 42 of file class.ilForumPostDraft.php.

Referenced by getPostDate(), and setPostDate().

◆ $post_display_user_id

int ilForumPostDraft::$post_display_user_id = 0

private

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

Referenced by getPostDisplayUserId(), and setPostDisplayUserId().

◆ $post_id

int ilForumPostDraft::$post_id = 0

private

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

Referenced by __construct(), getPostId(), and setPostId().

◆ $post_message

string ilForumPostDraft::$post_message = ''

private

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

Referenced by getPostMessage(), and setPostMessage().

◆ $post_notify

bool ilForumPostDraft::$post_notify = false

private

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

Referenced by isPostNotificationEnabled(), and setPostNotificationStatus().

◆ $post_subject

string ilForumPostDraft::$post_subject = ''

private

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

Referenced by getPostSubject(), and setPostSubject().

◆ $post_update

string ilForumPostDraft::$post_update = '0000-00-00 00:00:00'

private

Definition at line 43 of file class.ilForumPostDraft.php.

Referenced by getPostUpdate(), and setPostUpdate().

◆ $post_user_alias

string ilForumPostDraft::$post_user_alias = ''

private

Definition at line 45 of file class.ilForumPostDraft.php.

Referenced by getPostUserAlias(), and setPostUserAlias().

◆ $rcid

string ilForumPostDraft::$rcid = ''

private

Definition at line 50 of file class.ilForumPostDraft.php.

Referenced by getRCID(), and setRCID().

◆ $thread_id

int ilForumPostDraft::$thread_id = 0

private

Definition at line 39 of file class.ilForumPostDraft.php.

Referenced by getThreadId(), and setThreadId().

◆ $update_user_id

int ilForumPostDraft::$update_user_id = 0

private

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

Referenced by getUpdateUserId(), and setUpdateUserId().

◆ MEDIAOBJECT_TYPE

const ilForumPostDraft::MEDIAOBJECT_TYPE = 'frm~d:html'

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

Referenced by ilObjForumGUI\cancelDraftObject(), ilForumAutoSaveAsyncDraftAction\executeAndGetResponseObject(), and ilForumDraftsHistory\rollbackAutosave().

◆ NO_RCID

const ilForumPostDraft::NO_RCID = '-'

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

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

components/ILIAS/Forum/classes/class.ilForumPostDraft.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Static Protected Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ createDraftBackup()

◆ deleteDraft()

◆ deleteDraftsByDraftIds()

◆ deleteDraftsByPostIds()

◆ deleteDraftsByUserId()

◆ deleteMobsOfDraft()

◆ getDraftId()

◆ getDraftInstancesByUserId()

◆ getDraftsStatisticsByRefId()

◆ getForumId()

◆ getPostAuthorId()

◆ getPostDate()

◆ getPostDisplayUserId()

◆ getPostId()

◆ getPostMessage()

◆ getPostSubject()

◆ getPostUpdate()

◆ getPostUserAlias()

◆ getRCID()

◆ getSortedDrafts()

◆ getThreadDraftData()

◆ getThreadId()

◆ getUpdateUserId()

◆ isAutoSavePostDraftAllowed()

◆ isNotificationEnabled()

◆ isPostNotificationEnabled()

◆ isSavePostDraftAllowed()

◆ lookupAutosaveInterval()

◆ moveDraftsByMergedThreads()

◆ newInstanceByDraftId()

◆ populateWithDatabaseRecord()

◆ readDraft()

◆ readDrafts()

◆ saveDraft()

◆ setDraftId()

◆ setForumId()

◆ setNotificationStatus()

◆ setPostAuthorId()

◆ setPostDate()

◆ setPostDisplayUserId()

◆ setPostId()

◆ setPostMessage()

◆ setPostNotificationStatus()

◆ setPostSubject()

◆ setPostUpdate()

◆ setPostUserAlias()

◆ setRCID()

◆ setThreadId()

◆ setUpdateUserId()

◆ update()

◆ updateDraft()

Field Documentation

◆ $db

◆ $draft_id

◆ $drafts_settings_cache

◆ $forum_id

◆ $forum_statistics_cache

◆ $instances

◆ $notify

◆ $post_author_id

◆ $post_date

◆ $post_display_user_id

◆ $post_id

◆ $post_message

◆ $post_notify

◆ $post_subject

◆ $post_update

◆ $post_user_alias