ilPollStateInfo Class Reference

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

Collaboration diagram for ilPollStateInfo:

Public Member Functions
	isOfflineOrUnavailable (ilObjPoll $poll)
	hasQuestion (ilObjPoll $poll)
	hasVotingPeriodNotStarted (ilObjPoll $poll, bool $default)
	returns default if no voting period is set More...
	hasVotingPeriodEnded (ilObjPoll $poll, bool $default)
	returns default if no voting period is set More...
	hasUserAlreadyVoted (int $user_id, ilObjPoll $poll)
	mayUserVote (int $user_id)
	isUserAnonymous (int $user_id)
	areResultsVisible (int $user_id, ilObjPoll $poll)
	willResultsBeShown (ilObjPoll $poll)

Protected Attributes
array	$cached_user_status = []

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

Definition at line 22 of file class.ilPollStateInfo.php.

Member Function Documentation

areResultsVisible()

ilPollStateInfo::areResultsVisible	(	int	$user_id,
		ilObjPoll	$poll
	)

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

References ilObjPoll\getViewResults(), hasUserAlreadyVoted(), hasVotingPeriodEnded(), ilObjPoll\VIEW_RESULTS_AFTER_PERIOD, ilObjPoll\VIEW_RESULTS_AFTER_VOTE, ilObjPoll\VIEW_RESULTS_ALWAYS, and ilObjPoll\VIEW_RESULTS_NEVER.

                                                                    : bool
    {
        switch ($poll->getViewResults()) {
            case ilObjPoll::VIEW_RESULTS_NEVER:
                return false;

            case ilObjPoll::VIEW_RESULTS_ALWAYS:
                return true;

            case ilObjPoll::VIEW_RESULTS_AFTER_PERIOD:
                return $this->hasVotingPeriodEnded($poll, true);

            case ilObjPoll::VIEW_RESULTS_AFTER_VOTE:
                if ($this->hasUserAlreadyVoted($user_id, $poll)) {
                    return true;
                }
                return false;
        }
        return false;
    }

Here is the call graph for this function:

hasQuestion()

ilPollStateInfo::hasQuestion

(

ilObjPoll

$poll

)

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

References ilObjPoll\getAnswers().

                                                : bool
    {
        if (count($poll->getAnswers())) {
            return true;
        }
        return false;
    }

Here is the call graph for this function:

hasUserAlreadyVoted()

ilPollStateInfo::hasUserAlreadyVoted	(	int	$user_id,
		ilObjPoll	$poll
	)

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

References ilObjPoll\hasUserVoted().

Referenced by areResultsVisible().

                                                                      : bool
    {
        if (!array_key_exists($user_id, $this->cached_user_status)) {
            $this->cached_user_status[$user_id] = $poll->hasUserVoted($user_id);
        }
        return $this->cached_user_status[$user_id];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

hasVotingPeriodEnded()

ilPollStateInfo::hasVotingPeriodEnded	(	ilObjPoll	$poll,
		bool	$default
	)

returns default if no voting period is set

Definition at line 65 of file class.ilPollStateInfo.php.

References ilObjPoll\getVotingPeriod(), and ilObjPoll\getVotingPeriodEnd().

Referenced by areResultsVisible(), and willResultsBeShown().

     : bool {
        if (!$poll->getVotingPeriod()) {
            return $default;
        }
        if ($poll->getVotingPeriodEnd() < time()) {
            return true;
        }
        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

hasVotingPeriodNotStarted()

ilPollStateInfo::hasVotingPeriodNotStarted	(	ilObjPoll	$poll,
		bool	$default
	)

returns default if no voting period is set

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

References ilObjPoll\getVotingPeriod(), and ilObjPoll\getVotingPeriodBegin().

     : bool {
        if (!$poll->getVotingPeriod()) {
            return $default;
        }
        if ($poll->getVotingPeriodBegin() > time()) {
            return true;
        }
        return false;
    }

Here is the call graph for this function:

isOfflineOrUnavailable()

ilPollStateInfo::isOfflineOrUnavailable

(

ilObjPoll

$poll

)

Definition at line 26 of file class.ilPollStateInfo.php.

References ilObjPoll\getAccessBegin(), ilObjPoll\getAccessEnd(), ilObjPoll\getAccessType(), ilObject\getOfflineStatus(), and ilObjectActivation\TIMINGS_ACTIVATION.

                                                           : bool
    {
        $offline = $poll->getOfflineStatus();
        $before_start = false;
        $after_end = false;
        if ($poll->getAccessType() === ilObjectActivation::TIMINGS_ACTIVATION) {
            $before_start = $poll->getAccessBegin() > time();
            $after_end = $poll->getAccessEnd() < time();
        }
        return $offline || $before_start || $after_end;
    }

Here is the call graph for this function:

isUserAnonymous()

ilPollStateInfo::isUserAnonymous

(

int

$user_id

)

Definition at line 91 of file class.ilPollStateInfo.php.

References ANONYMOUS_USER_ID.

Referenced by mayUserVote().

                                                 : bool
    {
        return $user_id === ANONYMOUS_USER_ID;
    }

Here is the caller graph for this function:

mayUserVote()

ilPollStateInfo::mayUserVote

(

int

$user_id

)

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

References isUserAnonymous().

                                             : bool
    {
        return !$this->isUserAnonymous($user_id);
    }

Here is the call graph for this function:

willResultsBeShown()

ilPollStateInfo::willResultsBeShown

(

ilObjPoll

$poll

)

Definition at line 117 of file class.ilPollStateInfo.php.

References ilObjPoll\getViewResults(), hasVotingPeriodEnded(), and ilObjPoll\VIEW_RESULTS_AFTER_PERIOD.

                                                       : bool
    {
        if (
            $poll->getViewResults() !== ilObjPoll::VIEW_RESULTS_AFTER_PERIOD ||
            $this->hasVotingPeriodEnded($poll, false)
        ) {
            return false;
        }
        return true;
    }

Here is the call graph for this function:

Field Documentation

$cached_user_status

array ilPollStateInfo::$cached_user_status = []

protected

Definition at line 24 of file class.ilPollStateInfo.php.

---

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

• Modules/Poll/classes/BlockGUI/class.ilPollStateInfo.php