ilPollContentRenderer Class Reference

Collaboration diagram for ilPollContentRenderer:

Public Member Functions
	__construct (ilLanguage $lng, UIFactory $ui_factory, UIRenderer $ui_renderer, Refinery $refinery, ilPollStateInfo $availability, ilPollCommentsHandler $comments, ilPollAnswersHandler $answers, ilPollAnswersRenderer $answers_renderer, ilPollResultsHandler $results, ilPollResultsRenderer $results_renderer, ilPollImageFactoryInterface $poll_image_factory)
	render (ilTemplate $tpl, int $ref_id, int $user_id, ilObjPoll $poll, bool $admin_view=false)

Protected Member Functions
	renderAnswersAndResults (ilTemplate $tpl, ilObjPoll $poll, int $user_id)
	renderAnswers (ilTemplate $tpl, ilObjPoll $poll, int $user_id)
	renderResults (ilTemplate $tpl, ilObjPoll $poll)
	renderTotalParticipantsInfo (ilTemplate $tpl, int $total)
	renderNotAbleToVoteMessage (ilTemplate $tpl, bool $has_voted, bool $results_in_future, int $voting_end_date)
	renderQuestion (ilTemplate $tpl, string $text, ?string $img_path)
	renderMiscVoteInfo (ilTemplate $tpl, ?int $answer_limit, int $deadline)
	renderAnonimityInfo (ilTemplate $tpl, bool $anonymous)
	renderNotWithinVotingPeriodMessage (ilTemplate $tpl, int $vote_start, int $vote_end)
	renderNoQuestionMessage (ilTemplate $tpl)
	renderAnchor (ilTemplate $tpl, int $obj_id)
	renderDescription (ilTemplate $tpl, string $description)
	renderAvailability (ilTemplate $tpl, ilObjPoll $poll)
	renderAlertForAnonymousUser (ilTemplate $tpl)
	renderComments (ilTemplate $tpl, int $ref_id)
	getMessageBox (string $message)
	getFormattedDate (int $date)

Protected Attributes
ilPollStateInfo	$state
ilPollCommentsHandler	$comments
ilPollAnswersHandler	$answers
ilPollAnswersRenderer	$answers_renderer
ilPollResultsHandler	$results
ilPollResultsRenderer	$results_renderer
ilLanguage	$lng
UIFactory	$ui_factory
UIRenderer	$ui_renderer
Refinery	$refinery
ilPollImageFactoryInterface	$poll_image_factory

Detailed Description

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

Constructor & Destructor Documentation

__construct()

ilPollContentRenderer::__construct	(	ilLanguage	$lng,
		UIFactory	$ui_factory,
		UIRenderer	$ui_renderer,
		Refinery	$refinery,
		ilPollStateInfo	$availability,
		ilPollCommentsHandler	$comments,
		ilPollAnswersHandler	$answers,
		ilPollAnswersRenderer	$answers_renderer,
		ilPollResultsHandler	$results,
		ilPollResultsRenderer	$results_renderer,
		ilPollImageFactoryInterface	$poll_image_factory
	)

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

      {
        $this->lng = $lng;
        $this->ui_factory = $ui_factory;
        $this->ui_renderer = $ui_renderer;
        $this->refinery = $refinery;
        $this->state = $availability;
        $this->comments = $comments;
        $this->answers = $answers;
        $this->answers_renderer = $answers_renderer;
        $this->results = $results;
        $this->results_renderer = $results_renderer;
        $this->poll_image_factory = $poll_image_factory;
    }

References $answers, $answers_renderer, $comments, $lng, $poll_image_factory, $refinery, $results, $results_renderer, $ui_factory, $ui_renderer, ILIAS\Repository\lng(), and ILIAS\Repository\refinery().

Here is the call graph for this function:

Member Function Documentation

getFormattedDate()

ilPollContentRenderer::getFormattedDate ( int  $date )

protected

Definition at line 355 of file class.ilPollContentRenderer.php.

                                                  : string
    {
        return ilDatePresentation::formatDate(
            new ilDateTime($date, IL_CAL_UNIX)
        );
    }

References ilDatePresentation\formatDate(), and IL_CAL_UNIX.

Here is the call graph for this function:

getMessageBox()

ilPollContentRenderer::getMessageBox ( string  $message )

protected

Definition at line 348 of file class.ilPollContentRenderer.php.

                                                     : string
    {
        return $this->ui_renderer->render(
            $this->ui_factory->messageBox()->info($message)
        );
    }

render()

ilPollContentRenderer::render	(	ilTemplate	$tpl,
		int	$ref_id,
		int	$user_id,
		ilObjPoll	$poll,
		bool	$admin_view = false
	)

Definition at line 67 of file class.ilPollContentRenderer.php.

     : void {
        $this->renderAnchor($tpl, $poll->getId());
        $this->renderAvailability($tpl, $poll);
        $this->renderDescription($tpl, $poll->getLongDescription());
 
        if (!$this->state->hasQuestion($poll)) {
            $this->renderNoQuestionMessage($tpl);
        } elseif ($this->state->hasVotingPeriodNotStarted($poll, false)) {
            $this->renderNotWithinVotingPeriodMessage(
                $tpl,
                $poll->getVotingPeriodBegin(),
                $poll->getVotingPeriodEnd()
            );
        } else {
            $this->renderQuestion(
                $tpl,
                $poll->getQuestion(),
                $this->poll_image_factory->handler()->getProcessedImageURL(new ObjectId($poll->getId()))
            );
            if (!$admin_view) {
                $this->renderAnswersAndResults($tpl, $poll, $user_id);
            }
        }
 
        if ($poll->getShowComments()) {
            $this->renderComments($tpl, $ref_id);
        }
 
        if ($this->state->isUserAnonymous($user_id)) {
            $this->renderAlertForAnonymousUser($tpl);
        }
    }

renderAlertForAnonymousUser()

ilPollContentRenderer::renderAlertForAnonymousUser ( ilTemplate  $tpl )

protected

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

                                                                   : void
    {
        $tpl->setVariable("TXT_ANON", $this->lng->txt('no_access_item_public'));
    }

References ILIAS\Repository\lng(), and HTML_Template_IT\setVariable().

Here is the call graph for this function:

renderAnchor()

ilPollContentRenderer::renderAnchor ( ilTemplate  $tpl, int  $obj_id  )

protected

Definition at line 303 of file class.ilPollContentRenderer.php.

                                                                 : void
    {
        $tpl->setVariable("ANCHOR_ID", $obj_id);
    }

References HTML_Template_IT\setVariable().

Here is the call graph for this function:

renderAnonimityInfo()

ilPollContentRenderer::renderAnonimityInfo ( ilTemplate  $tpl, bool  $anonymous  )

protected

Definition at line 268 of file class.ilPollContentRenderer.php.

     : void {
        if ($anonymous) {
            $info = $this->lng->txt("poll_anonymous_warning");
        } else {
            $info = $this->lng->txt("poll_non_anonymous_warning");
        }
        $tpl->setVariable("ANONIMITY_INFO", $info);
    }

References $info, and ILIAS\Repository\lng().

Here is the call graph for this function:

renderAnswers()

ilPollContentRenderer::renderAnswers ( ilTemplate  $tpl, ilObjPoll  $poll, int  $user_id  )

protected

Definition at line 147 of file class.ilPollContentRenderer.php.

     : void {
        $this->renderMiscVoteInfo(
            $tpl,
            $this->answers->getAnswerLimitForInfo(),
            $poll->getVotingPeriodEnd()
        );
        $this->answers_renderer->render(
            $tpl,
            $this->answers,
            !$this->state->mayUserVote($user_id)
        );
        $this->renderAnonimityInfo($tpl, !$poll->getNonAnonymous());
    }

renderAnswersAndResults()

ilPollContentRenderer::renderAnswersAndResults ( ilTemplate  $tpl, ilObjPoll  $poll, int  $user_id  )

protected

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

     : void {
        $either_is_shown = false;
        if (
            !$this->state->hasUserAlreadyVoted($user_id, $poll) &&
            !$this->state->hasVotingPeriodEnded($poll, false)
        ) {
            $this->renderAnswers($tpl, $poll, $user_id);
            $either_is_shown = true;
        }
 
        if (
            $this->state->areResultsVisible($user_id, $poll) &&
            $this->results->getTotalVotes()
        ) {
            $this->renderResults($tpl, $poll);
            $this->renderTotalParticipantsInfo(
                $tpl,
                $this->results->getTotalVotes()
            );
            $either_is_shown = true;
        } elseif ($this->state->areResultsVisible($user_id, $poll)) {
            $this->renderTotalParticipantsInfo(
                $tpl,
                $this->results->getTotalVotes()
            );
        }
 
        if (!$either_is_shown) {
            $this->renderNotAbleToVoteMessage(
                $tpl,
                $this->state->hasUserAlreadyVoted($user_id, $poll),
                $this->state->willResultsBeShown($poll),
                $poll->getVotingPeriodEnd()
            );
        }
    }

References $user_id.

renderAvailability()

ilPollContentRenderer::renderAvailability ( ilTemplate  $tpl, ilObjPoll  $poll  )

protected

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

                                                                           : void
    {
        if ($this->state->isOfflineOrUnavailable($poll)) {
            $tpl->setVariable("TXT_OFFLINE", $this->lng->txt('offline'));
        }
    }

References ILIAS\Repository\lng(), and HTML_Template_IT\setVariable().

Here is the call graph for this function:

renderComments()

ilPollContentRenderer::renderComments ( ilTemplate  $tpl, int  $ref_id  )

protected

Definition at line 333 of file class.ilPollContentRenderer.php.

                                                                   : void
    {
        $tpl->setVariable("LANG_COMMENTS", $this->lng->txt('poll_comments'));
        $tpl->setVariable("COMMENT_JSCALL", $this->comments->commentJSCall($ref_id));
        $tpl->setVariable("COMMENTS_COUNT_ID", $ref_id);
 
        $comments_count = $this->comments->getNumberOfComments($ref_id);
 
        if ($comments_count > 0) {
            $tpl->setVariable("COMMENTS_COUNT", "(" . $comments_count . ")");
        }
 
        $tpl->setVariable("COMMENTS_REDRAW_URL", $this->comments->getRedrawURL());
    }

References $ref_id, ILIAS\Repository\lng(), and HTML_Template_IT\setVariable().

Here is the call graph for this function:

renderDescription()

ilPollContentRenderer::renderDescription ( ilTemplate  $tpl, string  $description  )

protected

Definition at line 308 of file class.ilPollContentRenderer.php.

     : void {
        $description = trim($description);
        if ($description) {
            $tpl->setVariable(
                "TXT_DESC",
                nl2br($this->refinery->encode()->htmlSpecialCharsAsEntities()->transform($description))
            );
        }
    }

References ILIAS\Repository\refinery(), and HTML_Template_IT\setVariable().

Here is the call graph for this function:

renderMiscVoteInfo()

ilPollContentRenderer::renderMiscVoteInfo ( ilTemplate  $tpl, ?int  $answer_limit, int  $deadline  )

protected

Definition at line 242 of file class.ilPollContentRenderer.php.

     : void {
        $infos = [];
 
        if ($answer_limit) {
            $infos[] = sprintf(
                $this->lng->txt('poll_max_number_of_answers_info'),
                $answer_limit
            );
        }
 
        if ($deadline) {
            $infos[] = sprintf(
                $this->lng->txt("poll_voting_period_info"),
                $this->getFormattedDate($deadline)
            );
        }
 
        if ($infos) {
            $tpl->setVariable('VOTE_INFO', implode(' ', $infos));
        }
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

renderNoQuestionMessage()

ilPollContentRenderer::renderNoQuestionMessage ( ilTemplate  $tpl )

protected

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

                                                               : void
    {
        $tpl->setVariable(
            "MESSAGE_BOX",
            $this->getMessageBox(
                $this->lng->txt("poll_block_message_no_answers")
            )
        );
    }

References ILIAS\Repository\lng(), and HTML_Template_IT\setVariable().

Here is the call graph for this function:

renderNotAbleToVoteMessage()

ilPollContentRenderer::renderNotAbleToVoteMessage ( ilTemplate  $tpl, bool  $has_voted, bool  $results_in_future, int  $voting_end_date  )

protected

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

     : void {
        $messages = [];
 
        if ($has_voted) {
            $messages[] = $this->lng->txt("poll_block_message_already_voted");
        } else {
            $messages[] = sprintf(
                $this->lng->txt("poll_voting_period_ended_info"),
                $this->getFormattedDate($voting_end_date)
            );
        }
 
        if ($results_in_future && $has_voted) {
            $messages[] = sprintf(
                $this->lng->txt("poll_block_results_available_on"),
                $this->getFormattedDate($voting_end_date)
            );
        }
 
        $tpl->setVariable(
            "MESSAGE_BOX",
            $this->getMessageBox(
                implode(' ', $messages)
            )
        );
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

renderNotWithinVotingPeriodMessage()

ilPollContentRenderer::renderNotWithinVotingPeriodMessage ( ilTemplate  $tpl, int  $vote_start, int  $vote_end  )

protected

Definition at line 280 of file class.ilPollContentRenderer.php.

     : void {
        $message = sprintf(
            $this->lng->txt("poll_voting_period_full_info"),
            $this->getFormattedDate($vote_start),
            $this->getFormattedDate($vote_end)
        );
        $tpl->setVariable("MESSAGE_BOX", $this->getMessageBox($message));
    }

renderQuestion()

ilPollContentRenderer::renderQuestion ( ilTemplate  $tpl, string  $text, ?string  $img_path  )

protected

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

     : void {
        $tpl->setVariable(
            "TXT_QUESTION",
            $this->refinery->encode()->htmlSpecialCharsAsEntities()->transform(nl2br(trim($text)))
        );
        if ($img_path) {
            $tpl->setVariable(
                "URL_IMAGE",
                $img_path
            );
        }
    }

References HTML_Template_IT\setVariable().

Here is the call graph for this function:

renderResults()

ilPollContentRenderer::renderResults ( ilTemplate  $tpl, ilObjPoll  $poll  )

protected

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

     : void {
        $this->results_renderer->render(
            $tpl,
            $this->results,
            $poll->getShowResultsAs()
        );
    }

renderTotalParticipantsInfo()

ilPollContentRenderer::renderTotalParticipantsInfo ( ilTemplate  $tpl, int  $total  )

protected

Definition at line 176 of file class.ilPollContentRenderer.php.

     : void {
        if ($total === 1) {
            $tpl->setVariable(
                "TOTAL_ANSWERS",
                $this->lng->txt("poll_population_singular")
            );
            return;
        }
        $tpl->setVariable(
            "TOTAL_ANSWERS",
            sprintf($this->lng->txt("poll_population"), $total)
        );
    }

References ILIAS\Repository\lng(), and HTML_Template_IT\setVariable().

Here is the call graph for this function:

Field Documentation

$answers

ilPollAnswersHandler ilPollContentRenderer::$answers

protected

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

Referenced by __construct().

$answers_renderer

ilPollAnswersRenderer ilPollContentRenderer::$answers_renderer

protected

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

Referenced by __construct().

$comments

ilPollCommentsHandler ilPollContentRenderer::$comments

protected

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

Referenced by __construct().

$lng

ilLanguage ilPollContentRenderer::$lng

protected

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

Referenced by __construct().

$poll_image_factory

ilPollImageFactoryInterface ilPollContentRenderer::$poll_image_factory

protected

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

Referenced by __construct().

$refinery

Refinery ilPollContentRenderer::$refinery

protected

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

Referenced by __construct().

$results

ilPollResultsHandler ilPollContentRenderer::$results

protected

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

Referenced by __construct().

$results_renderer

ilPollResultsRenderer ilPollContentRenderer::$results_renderer

protected

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

Referenced by __construct().

$state

ilPollStateInfo ilPollContentRenderer::$state

protected

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

$ui_factory

UIFactory ilPollContentRenderer::$ui_factory

protected

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

Referenced by __construct().

$ui_renderer

UIRenderer ilPollContentRenderer::$ui_renderer

protected

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

Referenced by __construct().

---

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

• components/ILIAS/Poll/classes/BlockGUI/class.ilPollContentRenderer.php