Inheritance diagram for ilObjPoll:

Collaboration diagram for ilObjPoll:

Public Member Functions
	__construct (int $a_id=0, bool $a_reference=true)
	Constructor. More...

	setAccessType (int $a_value)

	getAccessType ()

	setAccessBegin (int $a_value)

	getAccessBegin ()

	setAccessEnd (int $a_value)

	getAccessEnd ()

	setAccessVisibility (bool $a_value)

	getAccessVisibility ()

	setQuestion (string $a_value)

	getQuestion ()

	setViewResults (int $a_value)

	getViewResults ()

	setVotingPeriod (bool $a_value)

	getVotingPeriod ()

	setVotingPeriodBegin (int $a_value)

	getVotingPeriodBegin ()

	setVotingPeriodEnd (int $a_value)

	getVotingPeriodEnd ()

	setMaxNumberOfAnswers (int $a_value)

	getMaxNumberOfAnswers ()

	setSortResultByVotes (bool $a_value)

	getSortResultByVotes ()

	setNonAnonymous (bool $a_value)

	getNonAnonymous ()

	setShowComments (bool $a_value)

	getShowComments ()

	setShowResultsAs (int $a_value)

	getShowResultsAs ()

	uploadImage (string $file_path, string $file_name)

	getAnswers ()

	getAnswer (int $a_id)

	saveAnswer (string $a_text, ?int $a_pos=null)

	updateAnswer (int $a_id, string $a_text)

	rebuildAnswerPositions ()

	updateAnswerPositions (array $a_pos)

	deleteAnswer (int $a_id)

	deleteAllVotes ()

	saveAnswers (array $a_answers)

	saveVote (int $a_user_id, array $a_answers)

	hasUserVoted (int $a_user_id)

	countVotes ()

	getVotePercentages ()

	getVotesByUsers ()

Public Member Functions inherited from ilObject2
	__construct (int $a_id=0, bool $a_reference=true)
	Constructor. More...

	read ()

	create (bool $a_clone_mode=false)

	update ()

	delete ()
	delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More...

	cloneMetaData (ilObject $target_obj)
	Copy meta data. More...

	cloneObject (int $target_id, int $copy_id=0, bool $omit_tree=false)

Public Member Functions inherited from ilObject
	getObjectProperties ()

	flushObjectProperties ()

	withReferences ()
	determines whether objects are referenced or not (got ref ids or not) More...

	processAutoRating ()

	read ()

	getId ()

	setId (int $id)

	setRefId (int $ref_id)

	getRefId ()

	getType ()

	setType (string $type)

	getPresentationTitle ()
	get presentation title Normally same as title Overwritten for sessions More...

	getTitle ()

	getUntranslatedTitle ()
	Get untranslated object title WebDAV needs to access the untranslated title of an object. More...

	setTitle (string $title)

	getDescription ()

	setDescription (string $description)

	getLongDescription ()
	get object long description (stored in object_description) More...

	getImportId ()

	setImportId (string $import_id)

	setOfflineStatus (bool $status)

	getOfflineStatus ()

	supportsOfflineHandling ()

	getOwner ()

	getOwnerName ()
	get full name of object owner More...

	setOwner (int $usr_id)

	getCreateDate ()
	Get create date in YYYY-MM-DD HH-MM-SS format. More...

	getLastUpdateDate ()
	Get last update date in YYYY-MM-DD HH-MM-SS format. More...

	create ()
	note: title, description and type should be set when this function is called More...

	update ()

	MDUpdateListener (string $element)
	Metadata update listener. More...

	createMetaData ()

	updateMetaData ()

	deleteMetaData ()

	updateOwner ()
	update owner of object in db More...

	putInTree (int $parent_ref_id)
	maybe this method should be in tree object!? More...

	setPermissions (int $parent_ref_id)

	setParentRolePermissions (int $parent_ref_id)
	Initialize the permissions of parent roles (local roles of categories, global roles...) This method is overwritten in e.g. More...

	createReference ()
	creates reference for object More...

	countReferences ()

	delete ()
	delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More...

	initDefaultRoles ()
	init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type. More...

	applyDidacticTemplate (int $tpl_id)

	getXMLZip ()

	getHTMLDirectory ()

	appendCopyInfo (int $target_id, int $copy_id, int $new_obj_id)
	Prepend Copy info if object with same name exists in that container. More...

	cloneDependencies (int $target_id, int $copy_id)
	Clone object dependencies. More...

	cloneMetaData (ilObject $target_obj)
	Copy meta data. More...

	selfOrParentWithRatingEnabled ()

	getPossibleSubObjects (bool $filter=true)
	get all possible sub objects of this type the object can decide which types of sub objects are possible jut in time overwrite if the decision distinguish from standard model More...

Static Public Member Functions
static	getImageSize ()

Static Public Member Functions inherited from ilObject
static	_lookupObjIdByImportId (string $import_id)
	Get (latest) object id for an import id. More...

static	_lookupImportId (int $obj_id)

static	_lookupOwnerName (int $owner_id)
	Lookup owner name for owner id. More...

static	_getIdForImportId (string $import_id)

static	_getAllReferences (int $id)
	get all reference ids for object ID More...

static	_lookupTitle (int $obj_id)

static	lookupOfflineStatus (int $obj_id)
	Lookup offline status using objectDataCache. More...

static	_lookupOwner (int $obj_id)
	Lookup owner user ID for object ID. More...

static	_getIdsForTitle (string $title, string $type='', bool $partial_match=false)

static	_lookupDescription (int $obj_id)

static	_lookupLastUpdate (int $obj_id, bool $formatted=false)

static	_getLastUpdateOfObjects (array $obj_ids)

static	_lookupObjId (int $ref_id)

static	_setDeletedDate (int $ref_id, int $deleted_by)

static	setDeletedDates (array $ref_ids, int $user_id)

static	_resetDeletedDate (int $ref_id)

static	_lookupDeletedDate (int $ref_id)

static	_writeTitle (int $obj_id, string $title)
	write title to db (static) More...

static	_writeDescription (int $obj_id, string $desc)
	write description to db (static) More...

static	_writeImportId (int $obj_id, string $import_id)
	write import id to db (static) More...

static	_lookupType (int $id, bool $reference=false)

static	_isInTrash (int $ref_id)

static	_hasUntrashedReference (int $obj_id)
	checks whether an object has at least one reference that is not in trash More...

static	_lookupObjectId (int $ref_id)

static	_getObjectsDataForType (string $type, bool $omit_trash=false)
	get all objects of a certain type More...

static	_exists (int $id, bool $reference=false, ?string $type=null)
	checks if an object exists in object_data More...

static	_getObjectsByType (string $obj_type="", ?int $owner=null)

static	_prepareCloneSelection (array $ref_ids, string $new_type, bool $show_path=true)
	Prepare copy wizard object selection. More...

static	getIconForType (string $type)

static	_getIcon (int $obj_id=0, string $size="big", string $type="", bool $offline=false)
	Get icon for repository item. More...

static	collectDeletionDependencies (array &$deps, int $ref_id, int $obj_id, string $type, int $depth=0)
	Collect deletion dependencies. More...

static	getDeletionDependencies (int $obj_id)
	Get deletion dependencies. More...

static	getLongDescriptions (array $obj_ids)

static	getAllOwnedRepositoryObjects (int $user_id)

static	fixMissingTitles ($type, array &$obj_title_map)
	Try to fix missing object titles. More...

static	_lookupCreationDate (int $obj_id)

static	_getObjectTypeIdByTitle (string $type, ?\ilDBInterface $ilDB=null)

Data Fields
const int	VIEW_RESULTS_ALWAYS = 1

const int	VIEW_RESULTS_NEVER = 2

const int	VIEW_RESULTS_AFTER_VOTE = 3

const int	VIEW_RESULTS_AFTER_PERIOD = 4

const int	SHOW_RESULTS_AS_BARCHART = 1

const int	SHOW_RESULTS_AS_STACKED_CHART = 2

Data Fields inherited from ilObject
const	TITLE_LENGTH = 255

const	DESC_LENGTH = 128

const	LONG_DESC_LENGTH = 4000

const	TABLE_OBJECT_DATA = "object_data"

array	$objectList

string	$untranslatedTitle

Protected Member Functions
	initType ()

	doRead ()

	propertiesToDB ()

	doCreate (bool $clone_mode=false)

	doUpdate ()

	doDelete ()

	doCloneObject (ilObject2 $new_obj, int $a_target_id, ?int $a_copy_id=0)

	deleteAllAnswers ()

Protected Member Functions inherited from ilObject2
	initType ()

	doRead ()

	doCreate (bool $clone_mode=false)

	beforeCreate ()
	If overwritten this method should return true, there is currently no "abort" handling for cases where "false" is returned. More...

	doUpdate ()

	beforeUpdate ()

	doDelete ()

	beforeDelete ()

	doCloneObject (ilObject2 $new_obj, int $a_target_id, ?int $a_copy_id=null)

	beforeCloneObject ()

Protected Member Functions inherited from ilObject
	doMDUpdateListener (string $a_element)

	beforeMDUpdateListener (string $a_element)

	doCreateMetaData ()

	beforeCreateMetaData ()

	doUpdateMetaData ()

	beforeUpdateMetaData ()

	doDeleteMetaData ()

	beforeDeleteMetaData ()

	handleAutoRating ()

	hasAutoRating ()

Protected Attributes
PollImageFactory	$poll_image_factory

NotesService	$notes

DataFactory	$data_factory

int	$access_type = 0

int	$access_begin = 0

int	$access_end = 0

bool	$access_visibility = false

string	$question = ""

string	$image = ""

int	$view_results = 0

bool	$period = false

int	$period_begin = 0

int	$period_end = 0

int	$max_number_answers = 0

bool	$result_sort_by_votes = false

bool	$mode_non_anonymous = false

bool	$show_comments = false

int	$show_results_as = 1

Protected Attributes inherited from ilObject
ilLogger	$obj_log

ILIAS	$ilias

ilObjectDefinition	$obj_definition

ilDBInterface	$db

ilLogger	$log

ilErrorHandling	$error

ilTree	$tree

ilAppEventHandler	$app_event_handler

ilRbacAdmin	$rbac_admin

ilRbacReview	$rbac_review

ilObjUser	$user

ilLanguage	$lng

LOMServices	$lom_services

bool	$call_by_reference

int	$max_title = self::TITLE_LENGTH

int	$max_desc = self::DESC_LENGTH

bool	$add_dots = true

int	$ref_id = null

string	$type = ""

string	$title = ""

string	$desc = ""

string	$long_desc = ""

int	$owner = 0

string	$create_date = ""

string	$last_update = ""

string	$import_id = ""

bool	$register = false

Detailed Description

Class ilObjPoll.

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 33 of file class.ilObjPoll.php.

Constructor & Destructor Documentation

◆ __construct()

ilObjPoll::__construct	(	int	$a_id = `0`,
		bool	$a_reference = `true`
	)

Constructor.

Parameters

int	$a_id	reference_id or object_id
bool	$a_reference	treat the id as reference_id (true) or object_id (false)

Reimplemented from ilObject2.

Definition at line 63 of file class.ilObjPoll.php.

    {
        global $DIC;
 
        $this->db = $DIC->database();
        // default
        $this->setViewResults(self::VIEW_RESULTS_AFTER_VOTE);
        $this->setAccessType(ilObjectActivation::TIMINGS_DEACTIVATED);
        $this->setVotingPeriod(false);
        $this->notes = $DIC->notes();
        $this->poll_image_factory = new PollImageFactory();
        $this->data_factory = new DataFactory();
        parent::__construct($a_id, $a_reference);
    }

References $DIC, ILIAS\GlobalScreen\Provider\__construct(), setAccessType(), setViewResults(), setVotingPeriod(), and ilObjectActivation\TIMINGS_DEACTIVATED.

Here is the call graph for this function:

Member Function Documentation

◆ countVotes()

ilObjPoll::countVotes ( )

Definition at line 621 of file class.ilObjPoll.php.

                                : int
    {
        $sql = "SELECT COUNT(DISTINCT(user_id)) cnt" .
            " FROM il_poll_vote" .
            " WHERE poll_id = " . $this->db->quote($this->getId(), "integer");
        $set = $this->db->query($sql);
        $row = $this->db->fetchAssoc($set);
        return (int) $row["cnt"];
    }

References ilObject\getId().

Referenced by getVotePercentages().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteAllAnswers()

ilObjPoll::deleteAllAnswers ( )

protected

Definition at line 520 of file class.ilObjPoll.php.

                                         : void
    {
        $ilDB = $this->db;
 
        if ($this->getId()) {
            $this->deleteAllVotes();
 
            $ilDB->manipulate("DELETE FROM il_poll_answer" .
                " WHERE poll_id = " . $ilDB->quote($this->getId(), "integer"));
        }
    }

References ilObject\$db, $ilDB, deleteAllVotes(), and ilObject\getId().

Referenced by doDelete().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteAllVotes()

ilObjPoll::deleteAllVotes ( )

Definition at line 532 of file class.ilObjPoll.php.

                                    : void
    {
        $ilDB = $this->db;
 
        if ($this->getId()) {
            $ilDB->manipulate("DELETE FROM il_poll_vote" .
                " WHERE poll_id = " . $ilDB->quote($this->getId(), "integer"));
        }
    }

References ilObject\$db, $ilDB, and ilObject\getId().

Referenced by deleteAllAnswers().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteAnswer()

ilObjPoll::deleteAnswer ( int $a_id )

Definition at line 507 of file class.ilObjPoll.php.

                                           : void
    {
        $ilDB = $this->db;
 
        if ($a_id) {
            $ilDB->manipulate("DELETE FROM il_poll_vote" .
                " WHERE answer_id = " . $ilDB->quote($this->getId(), "integer"));
 
            $ilDB->manipulate("DELETE FROM il_poll_answer" .
                " WHERE id = " . $ilDB->quote($a_id, "integer"));
        }
    }

References ilObject\$db, and $ilDB.

Referenced by saveAnswers().

Here is the caller graph for this function:

◆ doCloneObject()

ilObjPoll::doCloneObject	(	ilObject2	$new_obj,
		int	$a_target_id,
		?int	$a_copy_id = `0`
	)

protected

Reimplemented from ilObject2.

Definition at line 341 of file class.ilObjPoll.php.

                                                                                               : void
    {
        assert($new_obj instanceof ilObjPoll);
 
        // question/image
        $new_obj->setQuestion($this->getQuestion());
 
        $this->poll_image_factory->handler()->cloneImage(
            $this->data_factory->objId($this->id),
            $this->data_factory->objId($new_obj->getId()),
            $this->user->getId()
        );
 
        //copy online status if object is not the root copy object
        $cp_options = ilCopyWizardOptions::_getInstance($a_copy_id);
 
        if ($cp_options->isRootNode($this->getRefId())) {
            $new_obj->setOfflineStatus(true);
        }
 
        $view_results = $this->getViewResults();
        if ($view_results === ilObjPoll::VIEW_RESULTS_AFTER_PERIOD) {
            // default view results setting to always, since
            // voting period is not copied.
            $view_results = ilObjPoll::VIEW_RESULTS_ALWAYS;
        }
        $new_obj->setViewResults($view_results);
        $new_obj->setShowComments($this->getShowComments());
        $new_obj->setShowResultsAs($this->getShowResultsAs());
        $new_obj->setMaxNumberOfAnswers($this->getMaxNumberOfAnswers());
        $new_obj->setSortResultByVotes($this->getSortResultByVotes());
        $new_obj->setNonAnonymous($this->getNonAnonymous());
        $new_obj->update();
 
        // answers
        $answers = $this->getAnswers();
        if ($answers) {
            foreach ($answers as $item) {
                $new_obj->saveAnswer($item["answer"]);
            }
        }
    }

References $view_results, ilCopyWizardOptions\_getInstance(), getAnswers(), ilObject\getId(), getMaxNumberOfAnswers(), getNonAnonymous(), getQuestion(), getShowComments(), getShowResultsAs(), getSortResultByVotes(), getViewResults(), ilObject\setOfflineStatus(), ilObject2\update(), VIEW_RESULTS_AFTER_PERIOD, and VIEW_RESULTS_ALWAYS.

Here is the call graph for this function:

◆ doCreate()

ilObjPoll::doCreate ( bool $clone_mode = false )

protected

Reimplemented from ilObject2.

Definition at line 270 of file class.ilObjPoll.php.

                                                         : void
    {
        $ilDB = $this->db;
 
        if ($this->getId()) {
            $fields = $this->propertiesToDB();
            $fields["id"] = array("integer", $this->getId());
            $fields["migrated"] = array("integer", "1");
 
            $ilDB->insert("il_poll", $fields);
 
 
            // object activation default entry will be created on demand
 
 
            // block handling
            $block = new ilPollBlock();
            $block->setType("poll");
            $block->setContextObjId($this->getId());
            $block->setContextObjType("poll");
            $block->create();
        }
    }

References ilObject\$db, $ilDB, ilObject\getId(), and propertiesToDB().

Here is the call graph for this function:

◆ doDelete()

ilObjPoll::doDelete ( )

protected

Reimplemented from ilObject2.

Definition at line 321 of file class.ilObjPoll.php.

                                 : void
    {
        $ilDB = $this->db;
 
        if ($this->getId()) {
            $this->poll_image_factory->handler()->deleteImage(
                $this->data_factory->objId($this->getId()),
                $this->user->getId()
            );
            $this->deleteAllAnswers();
 
            if ($this->ref_id) {
                ilObjectActivation::deleteAllEntries($this->ref_id);
            }
 
            $ilDB->manipulate("DELETE FROM il_poll" .
                " WHERE id = " . $ilDB->quote($this->id, "integer"));
        }
    }

References ilObject\$db, $ilDB, deleteAllAnswers(), ilObjectActivation\deleteAllEntries(), and ilObject\getId().

Here is the call graph for this function:

◆ doRead()

ilObjPoll::doRead ( )

protected

Reimplemented from ilObject2.

Definition at line 223 of file class.ilObjPoll.php.

                               : void
    {
        $ilDB = $this->db;
 
        $set = $ilDB->query("SELECT * FROM il_poll" .
                " WHERE id = " . $ilDB->quote($this->getId(), "integer"));
        $row = $ilDB->fetchAssoc($set);
        $this->setQuestion((string) ($row["question"] ?? ''));
        $this->setViewResults((int) ($row["view_results"] ?? self::VIEW_RESULTS_AFTER_VOTE));
        $this->setVotingPeriod((bool) ($row["period"] ?? 0));
        $this->setVotingPeriodBegin((int) ($row["period_begin"] ?? 0));
        $this->setVotingPeriodEnd((int) ($row["period_end"] ?? 0));
        $this->setMaxNumberOfAnswers((int) ($row["max_answers"] ?? 0));
        $this->setSortResultByVotes((bool) ($row["result_sort"] ?? 0));
        $this->setNonAnonymous((bool) ($row["non_anon"] ?? 0));
        $this->setShowResultsAs((int) ($row["show_results_as"] ?? self::SHOW_RESULTS_AS_BARCHART));
 
        // #14661
        $this->setShowComments($this->notes->domain()->commentsActive($this->getId()));
 
        if ($this->ref_id) {
            $activation = ilObjectActivation::getItem($this->ref_id);
            $this->setAccessType((int) ($activation["timing_type"] ?? ilObjectActivation::TIMINGS_DEACTIVATED));
            if ($this->getAccessType() === ilObjectActivation::TIMINGS_ACTIVATION) {
                // default entry values should not be loaded if not activated
                $this->setAccessBegin((int) ($activation["timing_start"] ?? time()));
                $this->setAccessEnd((int) ($activation["timing_end"] ?? time()));
                $this->setAccessVisibility((bool) ($activation["visible"] ?? false));
            }
        }
    }

References ilObject\$db, $ilDB, getAccessType(), ilObjectActivation\getItem(), setAccessBegin(), setAccessEnd(), setAccessType(), setAccessVisibility(), setMaxNumberOfAnswers(), setNonAnonymous(), setQuestion(), setShowComments(), setShowResultsAs(), setSortResultByVotes(), setViewResults(), setVotingPeriod(), setVotingPeriodBegin(), setVotingPeriodEnd(), ilObjectActivation\TIMINGS_ACTIVATION, and ilObjectActivation\TIMINGS_DEACTIVATED.

Here is the call graph for this function:

◆ doUpdate()

ilObjPoll::doUpdate ( )

protected

Reimplemented from ilObject2.

Definition at line 294 of file class.ilObjPoll.php.

                                 : void
    {
        $ilDB = $this->db;
 
        if ($this->getId()) {
            $fields = $this->propertiesToDB();
 
            $ilDB->update(
                "il_poll",
                $fields,
                array("id" => array("integer", $this->getId()))
            );
 
            // #14661
            $this->notes->domain()->activateComments($this->getId(), $this->getShowComments());
 
            if ($this->getRefId()) {
                $activation = new ilObjectActivation();
                $activation->setTimingType($this->getAccessType());
                $activation->setTimingStart($this->getAccessBegin());
                $activation->setTimingEnd($this->getAccessEnd());
                $activation->toggleVisible($this->getAccessVisibility());
                $activation->update($this->ref_id);
            }
        }
    }

References ilObject\$db, $ilDB, getAccessBegin(), getAccessEnd(), getAccessType(), getAccessVisibility(), ilObject\getId(), ilObject\getRefId(), getShowComments(), and propertiesToDB().

Here is the call graph for this function:

◆ getAccessBegin()

ilObjPoll::getAccessBegin ( )

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

                                    : int
    {
        return $this->access_begin;
    }

References $access_begin.

Referenced by doUpdate(), and ilPollStateInfo\isOfflineOrUnavailable().

Here is the caller graph for this function:

◆ getAccessEnd()

ilObjPoll::getAccessEnd ( )

Definition at line 108 of file class.ilObjPoll.php.

                                  : int
    {
        return $this->access_end;
    }

References $access_end.

Referenced by doUpdate(), and ilPollStateInfo\isOfflineOrUnavailable().

Here is the caller graph for this function:

◆ getAccessType()

ilObjPoll::getAccessType ( )

Definition at line 88 of file class.ilObjPoll.php.

                                   : int
    {
        return $this->access_type;
    }

References $access_type.

Referenced by doRead(), doUpdate(), and ilPollStateInfo\isOfflineOrUnavailable().

Here is the caller graph for this function:

◆ getAccessVisibility()

ilObjPoll::getAccessVisibility ( )

Definition at line 118 of file class.ilObjPoll.php.

                                         : bool
    {
        return $this->access_visibility;
    }

References $access_visibility.

Referenced by doUpdate().

Here is the caller graph for this function:

◆ getAnswer()

ilObjPoll::getAnswer ( int $a_id )

Definition at line 424 of file class.ilObjPoll.php.

                                        : array
    {
        $ilDB = $this->db;
 
        $sql = "SELECT * FROM il_poll_answer" .
            " WHERE id = " . $ilDB->quote($a_id, "integer");
        $set = $ilDB->query($sql);
        return (array) $ilDB->fetchAssoc($set);
    }

References ilObject\$db, and $ilDB.

◆ getAnswers()

ilObjPoll::getAnswers ( )

Definition at line 408 of file class.ilObjPoll.php.

                                : array
    {
        $ilDB = $this->db;
 
        $res = [];
 
        $sql = "SELECT * FROM il_poll_answer" .
            " WHERE poll_id = " . $ilDB->quote($this->getId(), "integer") .
            " ORDER BY pos ASC";
        $set = $ilDB->query($sql);
        while ($row = $ilDB->fetchAssoc($set)) {
            $res[] = $row;
        }
        return $res;
    }

References ilObject\$db, $ilDB, $res, and ilObject\getId().

Referenced by ilPollAnswersHandler\__construct(), doCloneObject(), ilPollStateInfo\hasQuestion(), rebuildAnswerPositions(), and saveAnswers().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getImageSize()

static ilObjPoll::getImageSize ( )

static

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

                                         : string
    {
        // :TODO:
        return "600x600";
    }

Referenced by ilObjPollGUI\initQuestionForm().

Here is the caller graph for this function:

◆ getMaxNumberOfAnswers()

ilObjPoll::getMaxNumberOfAnswers ( )

Definition at line 178 of file class.ilObjPoll.php.

                                           : int
    {
        return $this->max_number_answers;
    }

References $max_number_answers.

Referenced by ilPollAnswersHandler\__construct(), doCloneObject(), and propertiesToDB().

Here is the caller graph for this function:

◆ getNonAnonymous()

ilObjPoll::getNonAnonymous ( )

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

                                     : bool
    {
        return $this->mode_non_anonymous;
    }

References $mode_non_anonymous.

Referenced by doCloneObject(), and propertiesToDB().

Here is the caller graph for this function:

◆ getQuestion()

ilObjPoll::getQuestion ( )

Definition at line 128 of file class.ilObjPoll.php.

                                 : string
    {
        return $this->question;
    }

References $question.

Referenced by doCloneObject(), and propertiesToDB().

Here is the caller graph for this function:

◆ getShowComments()

ilObjPoll::getShowComments ( )

Definition at line 208 of file class.ilObjPoll.php.

                                     : bool
    {
        return $this->show_comments;
    }

References $show_comments.

Referenced by doCloneObject(), and doUpdate().

Here is the caller graph for this function:

◆ getShowResultsAs()

ilObjPoll::getShowResultsAs ( )

Definition at line 218 of file class.ilObjPoll.php.

                                      : int
    {
        return $this->show_results_as;
    }

References $show_results_as.

Referenced by doCloneObject(), and propertiesToDB().

Here is the caller graph for this function:

◆ getSortResultByVotes()

ilObjPoll::getSortResultByVotes ( )

Definition at line 188 of file class.ilObjPoll.php.

                                          : bool
    {
        return $this->result_sort_by_votes;
    }

References $result_sort_by_votes.

Referenced by ilPollResultsHandler\__construct(), doCloneObject(), and propertiesToDB().

Here is the caller graph for this function:

◆ getViewResults()

ilObjPoll::getViewResults ( )

Definition at line 138 of file class.ilObjPoll.php.

                                    : int
    {
        return $this->view_results;
    }

References $view_results.

Referenced by ilPollStateInfo\areResultsVisible(), doCloneObject(), propertiesToDB(), and ilPollStateInfo\willResultsBeShown().

Here is the caller graph for this function:

◆ getVotePercentages()

ilObjPoll::getVotePercentages ( )

Definition at line 631 of file class.ilObjPoll.php.

                                        : array
    {
        $res = [];
        $cnt = 0;
 
        $sql = "SELECT answer_id, count(*) cnt" .
            " FROM il_poll_vote" .
            " WHERE poll_id = " . $this->db->quote($this->getId(), "integer") .
            " GROUP BY answer_id";
        $set = $this->db->query($sql);
        while ($row = $this->db->fetchAssoc($set)) {
            $cnt += (int) $row["cnt"];
            $res[(int) $row["answer_id"]] = array("abs" => (int) $row["cnt"], "perc" => 0);
        }
 
        foreach ($res as $id => $item) {
            $abs = (int) ($item['abs'] ?? 0);
            $id = (int) ($id ?? 0);
            if ($cnt === 0) {
                $res[$id]["perc"] = 0;
            } else {
                $res[$id]["perc"] = $abs / $cnt * 100;
            }
        }
 
        return array("perc" => $res, "total" => $this->countVotes());
    }

References $id, $res, countVotes(), ilObject\getId(), and ILIAS\Repository\int().

Referenced by ilPollResultsHandler\__construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getVotesByUsers()

ilObjPoll::getVotesByUsers ( )

Definition at line 659 of file class.ilObjPoll.php.

                                     : array
    {
        $ilDB = $this->db;
 
        $res = [];
 
        $sql = "SELECT answer_id, user_id, firstname, lastname, login" .
            " FROM il_poll_vote" .
            " JOIN usr_data ON (usr_data.usr_id = il_poll_vote.user_id)" .
            " WHERE poll_id = " . $ilDB->quote($this->getId(), "integer");
        $set = $ilDB->query($sql);
        while ($row = $ilDB->fetchAssoc($set)) {
            $user_id = (int) ($row["user_id"] ?? 0);
            if (!isset($res[$user_id])) {
                $res[$user_id] = $row;
            }
            $res[$user_id]["answers"][] = (int) ($row["answer_id"] ?? 0);
        }
 
        return $res;
    }

References ilObject\$db, $ilDB, $res, $user_id, ilObject\getId(), and ILIAS\Repository\int().

Here is the call graph for this function:

◆ getVotingPeriod()

ilObjPoll::getVotingPeriod ( )

Definition at line 148 of file class.ilObjPoll.php.

                                     : bool
    {
        return $this->period;
    }

References $period.

Referenced by propertiesToDB().

Here is the caller graph for this function:

◆ getVotingPeriodBegin()

ilObjPoll::getVotingPeriodBegin ( )

Definition at line 158 of file class.ilObjPoll.php.

                                          : int
    {
        return $this->period_begin;
    }

References $period_begin.

Referenced by propertiesToDB().

Here is the caller graph for this function:

◆ getVotingPeriodEnd()

ilObjPoll::getVotingPeriodEnd ( )

Definition at line 168 of file class.ilObjPoll.php.

                                        : int
    {
        return $this->period_end;
    }

References $period_end.

Referenced by propertiesToDB().

Here is the caller graph for this function:

◆ hasUserVoted()

ilObjPoll::hasUserVoted ( int $a_user_id )

Definition at line 610 of file class.ilObjPoll.php.

                                                : bool
    {
        $sql = "SELECT user_id" .
            " FROM il_poll_vote" .
            " WHERE poll_id = " . $this->db->quote($this->getId(), "integer") .
            " AND user_id = " . $this->db->quote($a_user_id, "integer");
        $this->db->setLimit(1, 0);
        $set = $this->db->query($sql);
        return (bool) $this->db->numRows($set);
    }

References ilObject\getId().

Referenced by ilPollStateInfo\hasUserAlreadyVoted(), and saveVote().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initType()

ilObjPoll::initType ( )

protected

Reimplemented from ilObject2.

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

                                 : void
    {
        $this->type = "poll";
    }

◆ propertiesToDB()

ilObjPoll::propertiesToDB ( )

protected

Definition at line 255 of file class.ilObjPoll.php.

                                       : array
    {
        return array(
            "question" => array("text", $this->getQuestion()),
            "view_results" => array("integer", $this->getViewResults()),
            "period" => array("integer", $this->getVotingPeriod()),
            "period_begin" => array("integer", $this->getVotingPeriodBegin()),
            "period_end" => array("integer", $this->getVotingPeriodEnd()),
            "max_answers" => array("integer", $this->getMaxNumberOfAnswers()),
            "result_sort" => array("integer", $this->getSortResultByVotes()),
            "non_anon" => array("integer", $this->getNonAnonymous()),
            "show_results_as" => array("integer", $this->getShowResultsAs()),
        );
    }

References getMaxNumberOfAnswers(), getNonAnonymous(), getQuestion(), getShowResultsAs(), getSortResultByVotes(), getViewResults(), getVotingPeriod(), getVotingPeriodBegin(), and getVotingPeriodEnd().

Referenced by doCreate(), and doUpdate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ rebuildAnswerPositions()

ilObjPoll::rebuildAnswerPositions ( )

Definition at line 476 of file class.ilObjPoll.php.

                                            : void
    {
        $answers = $this->getAnswers();
 
        $pos = [];
        foreach ($answers as $item) {
            $id = (int) ($item['id'] ?? 0);
            $pos[$id] = (int) ($item["pos"] ?? 10);
        }
 
        $this->updateAnswerPositions($pos);
    }

References $id, getAnswers(), ILIAS\Repository\int(), and updateAnswerPositions().

Here is the call graph for this function:

◆ saveAnswer()

ilObjPoll::saveAnswer	(	string	$a_text,
		?int	$a_pos = `null`
	)

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

                                                                  : ?int
    {
        $ilDB = $this->db;
 
        if (!trim($a_text)) {
            return null;
        }
 
        $id = $ilDB->nextId("il_poll_answer");
 
        if (!$a_pos) {
            // append
            $sql = "SELECT max(pos) pos" .
                " FROM il_poll_answer" .
                " WHERE poll_id = " . $ilDB->quote($this->getId(), "integer");
            $set = $ilDB->query($sql);
            $a_pos = $ilDB->fetchAssoc($set);
            $a_pos = (int) ($a_pos["pos"] ?? 0) + 10;
        }
 
        $fields = array(
            "id" => array("integer", $id),
            "poll_id" => array("integer", $this->getId()),
            "answer" => array("text", trim($a_text)),
            "pos" => array("integer", $a_pos)
        );
        $ilDB->insert("il_poll_answer", $fields);
 
        return $id;
    }

References ilObject\$db, $id, $ilDB, ilObject\getId(), and ILIAS\Repository\int().

Referenced by saveAnswers().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveAnswers()

ilObjPoll::saveAnswers ( array $a_answers )

Definition at line 542 of file class.ilObjPoll.php.

                                                 : int
    {
        $existing = $this->getAnswers();
 
        $ids = [];
        $pos = 0;
        $id = null;
        foreach ($a_answers as $answer) {
            if (trim($answer)) {
                // existing answer?
                $found = false;
                foreach ($existing as $idx => $item) {
                    if (trim($answer) === (string) ($item["answer"] ?? '')) {
                        $found = true;
                        unset($existing[$idx]);
 
                        $id = (int) ($item["id"] ?? 0);
                    }
                }
 
                // create new answer
                if (!$found) {
                    $id = $this->saveAnswer($answer);
                }
 
                // add existing answer id to order
                if (isset($id) && is_int($id)) {
                    $ids[$id] = ++$pos;
                }
            }
        }
 
        // remove obsolete answers
        if (count($existing)) {
            foreach ($existing as $item) {
                if (isset($item["id"])) {
                    $this->deleteAnswer((int) $item["id"]);
                }
            }
        }
 
        // save current order
        if (count($ids)) {
            $this->updateAnswerPositions($ids);
        }
 
        return count($ids);
    }

References $id, deleteAnswer(), getAnswers(), ILIAS\Repository\int(), saveAnswer(), and updateAnswerPositions().

Here is the call graph for this function:

◆ saveVote()

ilObjPoll::saveVote	(	int	$a_user_id,
		array	$a_answers
	)

Definition at line 596 of file class.ilObjPoll.php.

                                                              : void
    {
        if ($this->hasUserVoted($a_user_id)) {
            return;
        }
 
        foreach ($a_answers as $answer_id) {
            $fields = array("user_id" => array("integer", $a_user_id),
                "poll_id" => array("integer", $this->getId()),
                "answer_id" => array("integer", $answer_id));
            $this->db->insert("il_poll_vote", $fields);
        }
    }

References ilObject\getId(), and hasUserVoted().

Here is the call graph for this function:

◆ setAccessBegin()

ilObjPoll::setAccessBegin ( int $a_value )

Definition at line 93 of file class.ilObjPoll.php.

                                                : void
    {
        $this->access_begin = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setAccessEnd()

ilObjPoll::setAccessEnd ( int $a_value )

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

                                              : void
    {
        $this->access_end = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setAccessType()

ilObjPoll::setAccessType ( int $a_value )

Definition at line 83 of file class.ilObjPoll.php.

                                               : void
    {
        $this->access_type = $a_value;
    }

Referenced by __construct(), and doRead().

Here is the caller graph for this function:

◆ setAccessVisibility()

ilObjPoll::setAccessVisibility ( bool $a_value )

Definition at line 113 of file class.ilObjPoll.php.

                                                      : void
    {
        $this->access_visibility = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setMaxNumberOfAnswers()

ilObjPoll::setMaxNumberOfAnswers ( int $a_value )

Definition at line 173 of file class.ilObjPoll.php.

                                                       : void
    {
        $this->max_number_answers = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setNonAnonymous()

ilObjPoll::setNonAnonymous ( bool $a_value )

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

                                                  : void
    {
        $this->mode_non_anonymous = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setQuestion()

ilObjPoll::setQuestion ( string $a_value )

Definition at line 123 of file class.ilObjPoll.php.

                                                : void
    {
        $this->question = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setShowComments()

ilObjPoll::setShowComments ( bool $a_value )

Definition at line 203 of file class.ilObjPoll.php.

                                                  : void
    {
        $this->show_comments = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setShowResultsAs()

ilObjPoll::setShowResultsAs ( int $a_value )

Definition at line 213 of file class.ilObjPoll.php.

                                                  : void
    {
        $this->show_results_as = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setSortResultByVotes()

ilObjPoll::setSortResultByVotes ( bool $a_value )

Definition at line 183 of file class.ilObjPoll.php.

                                                       : void
    {
        $this->result_sort_by_votes = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setViewResults()

ilObjPoll::setViewResults ( int $a_value )

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

                                                : void
    {
        $this->view_results = $a_value;
    }

Referenced by __construct(), and doRead().

Here is the caller graph for this function:

◆ setVotingPeriod()

ilObjPoll::setVotingPeriod ( bool $a_value )

Definition at line 143 of file class.ilObjPoll.php.

                                                  : void
    {
        $this->period = $a_value;
    }

Referenced by __construct(), and doRead().

Here is the caller graph for this function:

◆ setVotingPeriodBegin()

ilObjPoll::setVotingPeriodBegin ( int $a_value )

Definition at line 153 of file class.ilObjPoll.php.

                                                      : void
    {
        $this->period_begin = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ setVotingPeriodEnd()

ilObjPoll::setVotingPeriodEnd ( int $a_value )

Definition at line 163 of file class.ilObjPoll.php.

                                                    : void
    {
        $this->period_end = $a_value;
    }

Referenced by doRead().

Here is the caller graph for this function:

◆ updateAnswer()

ilObjPoll::updateAnswer	(	int	$a_id,
		string	$a_text
	)

Definition at line 465 of file class.ilObjPoll.php.

                                                           : void
    {
        $ilDB = $this->db;
 
        $ilDB->update(
            "il_poll_answer",
            array("answer" => array("text", $a_text)),
            array("id" => array("integer", $a_id))
        );
    }

References ilObject\$db, and $ilDB.

◆ updateAnswerPositions()

ilObjPoll::updateAnswerPositions ( array $a_pos )

Definition at line 489 of file class.ilObjPoll.php.

                                                       : void
    {
        $ilDB = $this->db;
 
        asort($a_pos);
 
        $pos = 0;
        foreach (array_keys($a_pos) as $id) {
            $pos += 10;
 
            $ilDB->update(
                "il_poll_answer",
                array("pos" => array("integer", $pos)),
                array("id" => array("integer", $id))
            );
        }
    }

References ilObject\$db, $id, and $ilDB.

Referenced by rebuildAnswerPositions(), and saveAnswers().

Here is the caller graph for this function:

◆ uploadImage()

ilObjPoll::uploadImage	(	string	$file_path,
		string	$file_name
	)

Definition at line 384 of file class.ilObjPoll.php.

                                                                     : void
    {
        if (!$this->getId() or $file_path === "") {
            return;
        }
        $this->poll_image_factory->handler()->uploadImage(
            $this->data_factory->objId($this->getId()),
            $file_path,
            $file_name,
            $this->user->getId()
        );
    }

References ilObject\getId().

Here is the call graph for this function:

Field Documentation

◆ $access_begin

int ilObjPoll::$access_begin = 0

protected

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

Referenced by getAccessBegin().

◆ $access_end

int ilObjPoll::$access_end = 0

protected

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

Referenced by getAccessEnd().

◆ $access_type

int ilObjPoll::$access_type = 0

protected

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

Referenced by getAccessType().

◆ $access_visibility

bool ilObjPoll::$access_visibility = false

protected

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

Referenced by getAccessVisibility().

◆ $data_factory

DataFactory ilObjPoll::$data_factory

protected

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

◆ $image

string ilObjPoll::$image = ""

protected

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

◆ $max_number_answers

int ilObjPoll::$max_number_answers = 0

protected

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

Referenced by getMaxNumberOfAnswers().

◆ $mode_non_anonymous

bool ilObjPoll::$mode_non_anonymous = false

protected

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

Referenced by getNonAnonymous().

◆ $notes

NotesService ilObjPoll::$notes

protected

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

◆ $period

bool ilObjPoll::$period = false

protected

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

Referenced by getVotingPeriod().

◆ $period_begin

int ilObjPoll::$period_begin = 0

protected

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

Referenced by getVotingPeriodBegin().

◆ $period_end

int ilObjPoll::$period_end = 0

protected

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

Referenced by getVotingPeriodEnd().

◆ $poll_image_factory

PollImageFactory ilObjPoll::$poll_image_factory

protected

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

◆ $question

string ilObjPoll::$question = ""

protected

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

Referenced by getQuestion().

◆ $result_sort_by_votes

bool ilObjPoll::$result_sort_by_votes = false

protected

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

Referenced by getSortResultByVotes().

◆ $show_comments

bool ilObjPoll::$show_comments = false

protected

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

Referenced by getShowComments().

◆ $show_results_as

int ilObjPoll::$show_results_as = 1

protected

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

Referenced by getShowResultsAs().

◆ $view_results

int ilObjPoll::$view_results = 0

protected

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

Referenced by doCloneObject(), and getViewResults().

◆ SHOW_RESULTS_AS_BARCHART

const int ilObjPoll::SHOW_RESULTS_AS_BARCHART = 1

Definition at line 60 of file class.ilObjPoll.php.

Referenced by ilObjPollGUI\initEditCustomForm().

◆ SHOW_RESULTS_AS_STACKED_CHART

const int ilObjPoll::SHOW_RESULTS_AS_STACKED_CHART = 2

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

Referenced by ilObjPollGUI\initEditCustomForm().

◆ VIEW_RESULTS_AFTER_PERIOD

const int ilObjPoll::VIEW_RESULTS_AFTER_PERIOD = 4

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

Referenced by ilPollStateInfo\areResultsVisible(), doCloneObject(), ilObjPollGUI\initEditCustomForm(), ilObjPollGUI\validateCustom(), and ilPollStateInfo\willResultsBeShown().

◆ VIEW_RESULTS_AFTER_VOTE

const int ilObjPoll::VIEW_RESULTS_AFTER_VOTE = 3

Definition at line 57 of file class.ilObjPoll.php.

Referenced by ilPollStateInfo\areResultsVisible(), and ilObjPollGUI\initEditCustomForm().

◆ VIEW_RESULTS_ALWAYS

const int ilObjPoll::VIEW_RESULTS_ALWAYS = 1

Definition at line 55 of file class.ilObjPoll.php.

Referenced by ilPollStateInfo\areResultsVisible(), doCloneObject(), and ilObjPollGUI\initEditCustomForm().

◆ VIEW_RESULTS_NEVER

const int ilObjPoll::VIEW_RESULTS_NEVER = 2

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

Referenced by ilPollStateInfo\areResultsVisible(), and ilObjPollGUI\initEditCustomForm().

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

components/ILIAS/Poll/classes/class.ilObjPoll.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ countVotes()

◆ deleteAllAnswers()

◆ deleteAllVotes()

◆ deleteAnswer()

◆ doCloneObject()

◆ doCreate()

◆ doDelete()

◆ doRead()

◆ doUpdate()

◆ getAccessBegin()

◆ getAccessEnd()

◆ getAccessType()

◆ getAccessVisibility()

◆ getAnswer()

◆ getAnswers()

◆ getImageSize()

◆ getMaxNumberOfAnswers()

◆ getNonAnonymous()

◆ getQuestion()

◆ getShowComments()

◆ getShowResultsAs()

◆ getSortResultByVotes()

◆ getViewResults()

◆ getVotePercentages()

◆ getVotesByUsers()

◆ getVotingPeriod()

◆ getVotingPeriodBegin()

◆ getVotingPeriodEnd()

◆ hasUserVoted()

◆ initType()

◆ propertiesToDB()

◆ rebuildAnswerPositions()

◆ saveAnswer()

◆ saveAnswers()

◆ saveVote()

◆ setAccessBegin()

◆ setAccessEnd()

◆ setAccessType()

◆ setAccessVisibility()

◆ setMaxNumberOfAnswers()

◆ setNonAnonymous()

◆ setQuestion()

◆ setShowComments()

◆ setShowResultsAs()

◆ setSortResultByVotes()

◆ setViewResults()

◆ setVotingPeriod()

◆ setVotingPeriodBegin()

◆ setVotingPeriodEnd()

◆ updateAnswer()

◆ updateAnswerPositions()

◆ uploadImage()

Field Documentation

◆ $access_begin

◆ $access_end

◆ $access_type

◆ $access_visibility

◆ $data_factory

◆ $image

◆ $max_number_answers

◆ $mode_non_anonymous

◆ $notes

◆ $period

◆ $period_begin

◆ $period_end

◆ $poll_image_factory

◆ $question

◆ $result_sort_by_votes

◆ $show_comments

◆ $show_results_as

◆ $view_results