ilRatingGUI 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 ilRatingGUI:

Public Member Functions
	__construct ()
	executeCommand ()
	execute command More...
	setObject (int $a_obj_id, string $a_obj_type, ?int $a_sub_obj_id=0, ?string $a_sub_obj_type="")
	Set Object. More...
	setUserId (int $a_userid)
	getUserId ()
	setYourRatingText (string $a_val)
	getYourRatingText ()
	enableCategories (bool $a_value)
	setCtrlPath (array $a_value)
	getHTML (bool $a_show_overall=true, bool $a_may_rate=true, ?string $a_onclick=null, ?string $a_additional_id=null)
	getBlockHTML (string $a_title)
	saveRating ()
	Save Rating. More...
	setUpdateCallback ($a_callback)
	resetUserRating ()
	setExportCallback ($a_callback, string $a_subobj_title)
	getListGUIProperty (int $a_ref_id, bool $a_may_rate, string $a_ajax_hash, int $parent_ref_id)

Protected Member Functions
	renderDetails (string $a_js_id, bool $a_may_rate, ?array $a_categories=null, ?string $a_onclick=null, bool $a_average=false, bool $add_tooltip=false)
	getTooltipTopics (int $cnt=0, float $avg=0, int $user=0)

Protected Attributes
ilLanguage	$lng
ilCtrl	$ctrl
ilObjUser	$user
string	$id = "rtg_"
	$export_callback
string	$export_subobj_title = ""
array	$ctrl_path = []
bool	$enable_categories = false
string	$your_rating_text = ""
ILIAS DI UIServices	$ui
int	$obj_id
string	$obj_type
int	$sub_obj_id
string	$sub_obj_type
int	$userid
	$update_callback = null
array	$requested_ratings = null
int	$requested_rating

Detailed Description

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

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class ilRatingGUI. User interface class for rating.

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de ilRatingGUI: ilRatingCategoryGUI

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

Constructor & Destructor Documentation

__construct()

ilRatingGUI::__construct

(

)

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

References $DIC, $params, ILIAS\Repository\ctrl(), ILIAS\Repository\int(), ILIAS\Repository\lng(), ilLanguage\loadLanguageModule(), null, ILIAS\Repository\ui(), and ILIAS\Repository\user().

    {
        global $DIC;

        $this->lng = $DIC->language();
        $this->ctrl = $DIC->ctrl();
        $this->user = $DIC->user();
        $lng = $DIC->language();

        $this->ui = $DIC->ui();

        $params = $DIC->http()->request()->getQueryParams();
        $body = $DIC->http()->request()->getParsedBody();

        if (isset($body["rating"]) && is_array($body["rating"])) {
            $this->requested_ratings = ($body["rating"] ?? null);
        }
        $this->requested_rating = (int) ($params["rating"] ?? 0);

        $lng->loadLanguageModule("rating");
    }

Here is the call graph for this function:

Member Function Documentation

enableCategories()

ilRatingGUI::enableCategories

(

bool

$a_value

)

Definition at line 141 of file class.ilRatingGUI.php.

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

executeCommand()

ilRatingGUI::executeCommand

(

)

execute command

Definition at line 72 of file class.ilRatingGUI.php.

References $ctrl, and ilCtrl\getNextClass().

                                    : void
    {
        $ilCtrl = $this->ctrl;

        $next_class = $ilCtrl->getNextClass($this);
        $cmd = $ilCtrl->getCmd();

        switch ($next_class) {
            case "ilratingcategorygui":
                $gui = new ilRatingCategoryGUI($this->obj_id, $this->export_callback, $this->export_subobj_title);
                $ilCtrl->forwardCommand($gui);
                break;

            default:
                $this->$cmd();
                break;
        }
    }

Here is the call graph for this function:

getBlockHTML()

ilRatingGUI::getBlockHTML

(

string

$a_title

)

Definition at line 635 of file class.ilRatingGUI.php.

References $ui, ANONYMOUS_USER_ID, ilRatingCategory\getAllForObject(), getUserId(), null, and renderDetails().

                                                 : string
    {
        $ui = $this->ui;

        $categories = array();
        if ($this->enable_categories) {
            $categories = ilRatingCategory::getAllForObject($this->obj_id);
        }

        $may_rate = ($this->getUserId() != ANONYMOUS_USER_ID);


        $panel = $ui->factory()->panel()->secondary()->legacy(
            $a_title,
            $ui->factory()->legacy(
                $this->renderDetails("rtsb_", $may_rate, $categories, null, true, true)
            )
        );

        return $ui->renderer()->render($panel);
    }

Here is the call graph for this function:

getHTML()

ilRatingGUI::getHTML	(	bool	$a_show_overall = true,
		bool	$a_may_rate = true,
		?string	$a_onclick = null,
		?string	$a_additional_id = null
	)

Definition at line 458 of file class.ilRatingGUI.php.

References Vendor\Package\$f, $id, $lng, $r, ANONYMOUS_USER_ID, ilRatingCategory\getAllForObject(), ilUtil\getImagePath(), ilRating\getOverallRatingForObject(), ilRating\getRatingForUserAndObject(), getTooltipTopics(), getUserId(), renderDetails(), ilLanguage\txt(), and ILIAS\Repository\ui().

Referenced by getListGUIProperty().

     : string {
        $f = $this->ui->factory();
        $r = $this->ui->renderer();
        $lng = $this->lng;
        $unique_id = $this->id;
        if ($a_additional_id) {
            $unique_id .= "_" . $a_additional_id;
        }

        $categories = array();
        if ($this->enable_categories) {
            $categories = ilRatingCategory::getAllForObject($this->obj_id);
        }

        $may_rate = ($this->getUserId() != ANONYMOUS_USER_ID);
        if ($may_rate && !$a_may_rate) {
            $may_rate = false;
        }

        $has_overlay = false;
        if ($may_rate || $categories) {
            $has_overlay = true;
        }

        $ttpl = new ilTemplate("tpl.rating_input.html", true, true, "components/ILIAS/Rating");

        // user rating
        $user_rating = 0;
        if ($may_rate || !$a_show_overall) {
            $user_rating = round(ilRating::getRatingForUserAndObject(
                $this->obj_id,
                $this->obj_type,
                $this->sub_obj_id,
                $this->sub_obj_type,
                $this->getUserId()
            ));
        }

        // (1) overall rating
        if ($a_show_overall) {
            $rating = ilRating::getOverallRatingForObject(
                $this->obj_id,
                $this->obj_type,
                $this->sub_obj_id,
                $this->sub_obj_type
            );
        } else {
            $rating = array("avg" => $user_rating);
        }

        for ($i = 1; $i <= 5; $i++) {
            if ($a_show_overall &&
                $i == $user_rating) {
                $ttpl->setCurrentBlock("rating_mark");
                $ttpl->setVariable(
                    "SRC_MARK",
                    ilUtil::getImagePath("standard/icon_rate_marker.svg")
                );
                $ttpl->parseCurrentBlock();
            }

            $ttpl->setCurrentBlock("rating_icon");
            if ($rating["avg"] >= $i) {
                $ttpl->setVariable(
                    "SRC_ICON",
                    ilUtil::getImagePath("standard/icon_rate_on.svg")
                );
            } elseif ($rating["avg"] + 1 <= $i) {
                $ttpl->setVariable(
                    "SRC_ICON",
                    ilUtil::getImagePath("standard/icon_rate_off.svg")
                );
            } else {
                $nr = round(($rating["avg"] + 1 - $i) * 10);
                $ttpl->setVariable(
                    "SRC_ICON",
                    ilUtil::getImagePath("standard/icon_rate_$nr.svg")
                );
            }
            $ttpl->setVariable("ALT_ICON", "");
            $ttpl->parseCurrentBlock();
        }
        $ttpl->setCurrentBlock("rating_icon");

        if ($a_show_overall) {
            if ($rating["cnt"] > 0) {
                $ttpl->setCurrentBlock("rat_nr");
                $ttpl->setVariable("RT_NR", $rating["cnt"]);
                $ttpl->parseCurrentBlock();
            }
        }

        // add overlay (trigger)
        if ($has_overlay) {
            $ttpl->setCurrentBlock("act_rat_start");
            $ttpl->setVariable("ID", $unique_id);
            $ttpl->setVariable("TXT_OPEN_DIALOG", $lng->txt("rating_open_dialog"));
            $ttpl->parseCurrentBlock();

            $ttpl->touchBlock("act_rat_end");
        }

        $ttpl->parseCurrentBlock();


        // (2) user rating

        $ttpl->setVariable("TTID", $unique_id);
        $rating_html = $ttpl->get();

        $tt_topics = $this->getTooltipTopics(
            (int) ($rating["cnt"] ?? 0),
            (float) ($rating["avg"] ?? 0),
            (int) ($user_rating ?? 0)
        );


        $button = $f->button()->shy('###button###', '#');
        if ($has_overlay) {
            $ttpl->setVariable(
                "RATING_DETAILS",
                $this->renderDetails("rtov_", $may_rate, $categories, $a_onclick)
            );

            $popover = $f->popover()->standard(
                $f->legacy($this->renderDetails("rtov_", $may_rate, $categories, $a_onclick))
            );
            $button = $button->withOnClick($popover->getShowSignal());
            $button = $button->withHelpTopics(
                ...$f->helpTopics(...$tt_topics)
            );
            $elements = [$popover, $button];
        } else {
            $button = $button->withOnLoadCode(function ($id) {
                return "return false;";
            });
            $button = $button->withHelpTopics(
                ...$f->helpTopics(...$tt_topics)
            );
            $elements = [$button];
        }
        $html = $r->render($elements);
        $html = str_replace("###button###", $rating_html, $html);

        return $html;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getListGUIProperty()

ilRatingGUI::getListGUIProperty	(	int	$a_ref_id,
		bool	$a_may_rate,
		string	$a_ajax_hash,
		int	$parent_ref_id
	)

Definition at line 730 of file class.ilRatingGUI.php.

References getHTML().

     : string {
        return $this->getHTML(
            true,
            $a_may_rate,
            "il.Object.saveRatingFromListGUI(" . $a_ref_id . ", '" . $a_ajax_hash . "', %rating%);",
            $parent_ref_id
        );
    }

Here is the call graph for this function:

getTooltipTopics()

ilRatingGUI::getTooltipTopics ( int  $cnt = 0, float  $avg = 0, int  $user = 0  )

protected

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

References $lng, ILIAS\GlobalScreen\Scope\$topics, $user, and ilLanguage\txt().

Referenced by getHTML(), and renderDetails().

     : array {
        $topics = [];
        $lng = $this->lng;

        if ($cnt == 0) {
            $topics[] = $lng->txt("rat_not_rated_yet");
        } else {
            if ($cnt == 1) {
                $topics[] = $lng->txt("rat_one_rating");
            } else {
                $topics[] = sprintf($lng->txt("rat_nr_ratings"), $cnt);
            }
            $topics[] = $lng->txt("rating_avg_rating") . ": " . round($avg, 1);
        }

        if ($user > 0) {
            $topics[] = $lng->txt("rating_personal_rating") . ": " . $user;
        }
        return $topics;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getUserId()

ilRatingGUI::getUserId

(

)

Definition at line 126 of file class.ilRatingGUI.php.

References $userid.

Referenced by getBlockHTML(), getHTML(), renderDetails(), resetUserRating(), and saveRating().

                               : int
    {
        return $this->userid;
    }

Here is the caller graph for this function:

getYourRatingText()

ilRatingGUI::getYourRatingText

(

)

Definition at line 136 of file class.ilRatingGUI.php.

References $your_rating_text.

Referenced by renderDetails().

                                       : string
    {
        return $this->your_rating_text;
    }

Here is the caller graph for this function:

renderDetails()

ilRatingGUI::renderDetails ( string  $a_js_id, bool  $a_may_rate, ?array  $a_categories = null, ?string  $a_onclick = null, bool  $a_average = false, bool  $add_tooltip = false  )

protected

Definition at line 152 of file class.ilRatingGUI.php.

References Vendor\Package\$b, $ctrl, Vendor\Package\$f, $lng, $r, ILIAS\GlobalScreen\Scope\$topics, ilUtil\getImagePath(), ilRating\getOverallRatingForObject(), ilRating\getRatingForUserAndObject(), getTooltipTopics(), getUserId(), getYourRatingText(), null, ilLanguage\txt(), and ILIAS\Repository\ui().

Referenced by getBlockHTML(), and getHTML().

     : string {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        $f = $this->ui->factory();
        $r = $this->ui->renderer();

        $ttpl = new ilTemplate("tpl.rating_details.html", true, true, "components/ILIAS/Rating");

        $rate_text = null;
        if ($this->getYourRatingText() != "#") {
            $rate_text = ($this->getYourRatingText() != "")
                ? $this->getYourRatingText()
                : $lng->txt("rating_your_rating");
        }

        // no categories: 1 simple rating (link)
        if (!$a_categories) {
            if ($a_may_rate) {
                $rating = ilRating::getRatingForUserAndObject(
                    $this->obj_id,
                    $this->obj_type,
                    $this->sub_obj_id,
                    $this->sub_obj_type,
                    $this->getUserId(),
                    0
                );
                $overall_rating = [
                    "avg" => 0,
                    "cnt" => 0
                ];
                if ($a_average) {
                    $overall_rating = ilRating::getOverallRatingForObject(
                        $this->obj_id,
                        $this->obj_type,
                        $this->sub_obj_id,
                        $this->sub_obj_type
                    );
                }

                // user rating links
                for ($i = 1; $i <= 5; $i++) {
                    $star_tpl = new ilTemplate("tpl.rating_star.html", true, true, "components/ILIAS/Rating");
                    if ($a_average &&
                        $i == $rating) {
                        $star_tpl->setCurrentBlock("rating_mark_simple");
                        $star_tpl->setVariable(
                            "SRC_MARK_SIMPLE",
                            ilUtil::getImagePath("standard/icon_rate_marker.svg")
                        );
                        $star_tpl->parseCurrentBlock();
                    }

                    $ttpl->setCurrentBlock("rating_link_simple");
                    if (stristr((string) $a_onclick, "%rating%")) {
                        $url_save = "#";
                    } else {
                        $ilCtrl->setParameter($this, "rating", $i);
                        if (!$this->ctrl_path) {
                            $url_save = $ilCtrl->getLinkTarget($this, "saveRating");
                        } else {
                            $url_save = $ilCtrl->getLinkTargetByClass($this->ctrl_path, "saveRating");
                        }
                    }
                    $b = $this->ui->factory()->button()->shy("###star###", $url_save);

                    if ($a_onclick) {
                        $onclick = str_replace("%rating%", $i, $a_onclick);
                        $b = $b->withOnLoadCode(function ($id) use ($onclick) {
                            return
                                "$('#" . $id . "').click(function() { $onclick; return false;});";
                        });
                    }

                    if ($a_average) {
                        $ref_rating = $overall_rating["avg"];
                    } else {
                        $ref_rating = $rating;
                    }

                    if ($ref_rating >= $i) {
                        $star_tpl->setVariable(
                            "SRC_ICON",
                            ilUtil::getImagePath("standard/icon_rate_on.svg")
                        );
                    } else {
                        $star_tpl->setVariable(
                            "SRC_ICON",
                            ilUtil::getImagePath("standard/icon_rate_off.svg")
                        );
                    }
                    $star_tpl->setVariable(
                        "ALT_ICON",
                        sprintf($lng->txt("rating_rate_x_of_5"), $i)
                    );

                    if ($add_tooltip) {
                        $topics = $this->getTooltipTopics(
                            (int) ($overall_rating["cnt"] ?? 0),
                            (float) ($overall_rating["avg"] ?? 0),
                            (int) ($rating ?? 0)
                        );
                        $b = $b->withHelpTopics(...$f->helpTopics(...$topics));
                    }

                    $star_html = $this->ui->renderer()->render($b);
                    $star_html = str_replace("###star###", $star_tpl->get(), $star_html);

                    $ttpl->setVariable("STAR_BUTTON", $star_html);

                    $ttpl->parseCurrentBlock();
                }

                // remove
                if ($rating) {
                    $ttpl->setCurrentBlock("rating_simple_del_bl");
                    $ttpl->setVariable("CAPTION_RATING_DEL", $lng->txt("rating_remove"));

                    if (stristr((string) $a_onclick, "%rating%")) {
                        $url_save = "#";
                    } else {
                        $ilCtrl->setParameter($this, "rating", 0);
                        if (!$this->ctrl_path) {
                            $url_save = $ilCtrl->getLinkTarget($this, "saveRating");
                        } else {
                            $url_save = $ilCtrl->getLinkTargetByClass($this->ctrl_path, "saveRating");
                        }
                    }
                    $ttpl->setVariable("HREF_RATING_DEL", $url_save);

                    if ($a_onclick) {
                        $onclick = str_replace("%rating%", 0, $a_onclick);
                        $ttpl->setVariable("ONCLICK_RATING_DEL", ' onclick="' . $onclick . '"');
                    }

                    $ttpl->parseCurrentBlock();
                }

                if ($rate_text) {
                    $ttpl->setCurrentBlock("rating_simple_title");
                    $ttpl->setVariable("TXT_RATING_SIMPLE", $rate_text);
                    $ttpl->parseCurrentBlock();
                }

                if ($a_average &&
                    $overall_rating["cnt"]) {
                    $ttpl->setCurrentBlock("number_votes_simple");
                    $ttpl->setVariable("NUMBER_VOTES_SIMPLE", $overall_rating["cnt"]);
                    $ttpl->parseCurrentBlock();
                }

                // user rating text
                $ttpl->setCurrentBlock("user_rating_simple");
                $ttpl->parseCurrentBlock();
            }
        }
        // categories: overall & user (form)
        else {
            $has_user_rating = false;
            $overall_rating = [
                "avg" => 0,
                "cnt" => 0
            ];
            foreach ($a_categories as $category) {
                $user_rating = round(ilRating::getRatingForUserAndObject(
                    $this->obj_id,
                    $this->obj_type,
                    $this->sub_obj_id,
                    $this->sub_obj_type,
                    $this->getUserId(),
                    $category["id"]
                ));

                $overall_rating = ilRating::getOverallRatingForObject(
                    $this->obj_id,
                    $this->obj_type,
                    $this->sub_obj_id,
                    $this->sub_obj_type,
                    $category["id"]
                );

                for ($i = 1; $i <= 5; $i++) {
                    $star_tpl = new ilTemplate("tpl.js_rating_star.html", true, true, "components/ILIAS/Rating");
                    if ($a_may_rate && $i == $user_rating) {
                        $has_user_rating = true;

                        $star_tpl->setCurrentBlock("rating_mark");
                        $star_tpl->setVariable(
                            "SRC_MARK",
                            ilUtil::getImagePath("standard/icon_rate_marker.svg")
                        );
                        $star_tpl->parseCurrentBlock();
                    }

                    $ttpl->setCurrentBlock("user_rating_icon");
                    if ($overall_rating["avg"] >= $i) {
                        $star_tpl->setVariable(
                            "SRC_ICON",
                            ilUtil::getImagePath("standard/icon_rate_on.svg")
                        );
                    } elseif ($overall_rating["avg"] + 1 <= $i) {
                        $star_tpl->setVariable(
                            "SRC_ICON",
                            ilUtil::getImagePath("standard/icon_rate_off.svg")
                        );
                    } else {
                        $nr = round(($overall_rating["avg"] + 1 - $i) * 10);
                        $star_tpl->setVariable(
                            "SRC_ICON",
                            ilUtil::getImagePath("standard/icon_rate_$nr.svg")
                        );
                    }
                    $star_tpl->setVariable(
                        "ALT_ICON",
                        sprintf($lng->txt("rating_rate_x_of_5"), $i)
                    );

                    $b = $f->button()->shy("###star###", "#");
                    if ($a_may_rate) {
                        $ttpl->setVariable("HREF_RATING", "il.Rating.setValue(" . $category["id"] . "," . $i . ", '" . $a_js_id . "')");
                        $star_tpl->setVariable("CATEGORY_ID", $category["id"]);
                        $star_tpl->setVariable("ICON_VALUE", $i);
                        $star_tpl->setVariable("JS_ID", $a_js_id);
                        $b = $b->withOnLoadCode(function ($id) use ($category, $i, $a_js_id) {
                            return
                                "$('#" . $id . "').click(function() { il.Rating.setValue(" . $category["id"] . "," . $i . ", '" . $a_js_id . "'); return false;});";
                        });

                        /*
                        $ttpl->setVariable("ICON_MOUSEACTION", " onmouseover=\"il.Rating.toggleIcon(this," . $i . ")\"" .
                            " onmouseout=\"il.Rating.toggleIcon(this," . $i . ",1)\"");*/
                    }
                    if ($add_tooltip) {
                        $topics = $this->getTooltipTopics(
                            (int) ($overall_rating["cnt"] ?? 0),
                            (float) ($overall_rating["avg"] ?? 0),
                            (int) ($user_rating ?? 0)
                        );
                        $b = $b->withHelpTopics(...$f->helpTopics(...$topics));
                    }
                    $button_html = $r->render($b);
                    $button_html = str_replace("###star###", $star_tpl->get(), $button_html);
                    $ttpl->setVariable("RATE_BUTTON", $button_html);
                    $ttpl->parseCurrentBlock();
                }

                if ($a_may_rate) {
                    $ttpl->setCurrentBlock("user_rating_category_column");
                    $ttpl->setVariable("JS_ID", $a_js_id);
                    $ttpl->setVariable("CATEGORY_ID", $category["id"]);
                    $ttpl->setVariable("CATEGORY_VALUE", $user_rating);
                    $ttpl->parseCurrentBlock();
                }


                // category title
                $ttpl->setCurrentBlock("user_rating_category");
                $ttpl->setVariable("TXT_RATING_CATEGORY", $category["title"]);
                $ttpl->parseCurrentBlock();
            }

            if ($overall_rating["cnt"] > 0) {
                $ttpl->setCurrentBlock("votes_number_bl");
                $ttpl->setVariable("NUMBER_VOTES", sprintf($lng->txt("rating_number_votes"), $overall_rating["cnt"]));
                $ttpl->parseCurrentBlock();
            }

            if ($a_may_rate) {
                // remove
                if ($has_user_rating) {
                    $ttpl->setCurrentBlock("user_rating_categories_del_bl");
                    $ttpl->setVariable("CAPTION_RATING_DEL_CAT", $lng->txt("rating_remove"));

                    $ilCtrl->setParameter($this, "rating", 0);
                    if (!$this->ctrl_path) {
                        $url_save = $ilCtrl->getLinkTarget($this, "resetUserRating");
                    } else {
                        $url_save = $ilCtrl->getLinkTargetByClass($this->ctrl_path, "resetUserRating");
                    }
                    $ttpl->setVariable("HREF_RATING_DEL_CAT", $url_save);

                    $ttpl->parseCurrentBlock();
                }

                if (!$this->ctrl_path) {
                    $url_form = $ilCtrl->getFormAction($this, "saveRating");
                } else {
                    $url_form = $ilCtrl->getFormActionByClass($this->ctrl_path, "saveRating");
                }
                $ttpl->setVariable("FORM_ACTION", $url_form);
                $ttpl->setVariable("TXT_SUBMIT", $lng->txt("rating_overlay_submit"));
                $ttpl->setVariable("CMD_SUBMIT", "saveRating");
                $ttpl->touchBlock("user_rating_categories_form_out");
            }
        }

        return $ttpl->get();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

resetUserRating()

ilRatingGUI::resetUserRating

(

)

Definition at line 712 of file class.ilRatingGUI.php.

References getUserId(), and ilRating\resetRatingForUserAndObject().

Referenced by saveRating().

                                     : void
    {
        ilRating::resetRatingForUserAndObject(
            $this->obj_id,
            $this->obj_type,
            (int) $this->sub_obj_id,
            $this->sub_obj_type,
            $this->getUserId()
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveRating()

ilRatingGUI::saveRating

(

)

Save Rating.

Definition at line 660 of file class.ilRatingGUI.php.

References $ctrl, $requested_rating, exit, getUserId(), resetUserRating(), and ilRating\writeRatingForUserAndObject().

                                : void
    {
        $ilCtrl = $this->ctrl;

        if (!is_array($this->requested_ratings)) {
            $rating = $this->requested_rating;
            if ($rating == 0) {
                $this->resetUserRating();
            } else {
                ilRating::writeRatingForUserAndObject(
                    $this->obj_id,
                    $this->obj_type,
                    $this->sub_obj_id,
                    $this->sub_obj_type,
                    $this->getUserId(),
                    $rating
                );
            }
        } else {
            foreach ($this->requested_ratings as $cat_id => $rating) {
                ilRating::writeRatingForUserAndObject(
                    $this->obj_id,
                    $this->obj_type,
                    $this->sub_obj_id,
                    $this->sub_obj_type,
                    $this->getUserId(),
                    $rating,
                    $cat_id
                );
            }
        }

        if ($this->update_callback) {
            call_user_func(
                $this->update_callback,
                $this->obj_id,
                $this->obj_type,
                $this->sub_obj_id,
                $this->sub_obj_type
            );
        }

        if ($ilCtrl->isAsynch()) {
            exit();
        }
    }

Here is the call graph for this function:

setCtrlPath()

ilRatingGUI::setCtrlPath

(

array

$a_value

)

Definition at line 146 of file class.ilRatingGUI.php.

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

setExportCallback()

ilRatingGUI::setExportCallback	(		$a_callback,
		string	$a_subobj_title
	)

Definition at line 723 of file class.ilRatingGUI.php.

                                                                          : void
    {
        $this->export_callback = $a_callback;
        $this->export_subobj_title = $a_subobj_title;
    }

setObject()

ilRatingGUI::setObject	(	int	$a_obj_id,
		string	$a_obj_type,
		?int	$a_sub_obj_id = 0,
		?string	$a_sub_obj_type = ""
	)

Set Object.

Parameters

int	$a_obj_id	Object ID
string	$a_obj_type	Object Type
int	$a_sub_obj_id	Subobject ID
string	$a_sub_obj_type	Subobject Type

Definition at line 99 of file class.ilRatingGUI.php.

References $sub_obj_type, $user, and setUserId().

     : void {
        $ilUser = $this->user;

        if (!trim((string) $a_sub_obj_type)) {
            $a_sub_obj_type = "-";
        }

        $this->obj_id = $a_obj_id;
        $this->obj_type = $a_obj_type;
        $this->sub_obj_id = $a_sub_obj_id;
        $this->sub_obj_type = $a_sub_obj_type;
        $this->id = "rtg_" . $this->obj_id . "_" . $this->obj_type . "_" . $this->sub_obj_id . "_" .
            $this->sub_obj_type;

        $this->setUserId($ilUser->getId());
    }

Here is the call graph for this function:

setUpdateCallback()

ilRatingGUI::setUpdateCallback

(

$a_callback

)

Definition at line 707 of file class.ilRatingGUI.php.

                                                  : void
    {
        $this->update_callback = $a_callback;
    }

setUserId()

ilRatingGUI::setUserId

(

int

$a_userid

)

Definition at line 121 of file class.ilRatingGUI.php.

Referenced by setObject().

                                            : void
    {
        $this->userid = $a_userid;
    }

Here is the caller graph for this function:

setYourRatingText()

ilRatingGUI::setYourRatingText

(

string

$a_val

)

Definition at line 131 of file class.ilRatingGUI.php.

                                                    : void
    {
        $this->your_rating_text = $a_val;
    }

Field Documentation

$ctrl

ilCtrl ilRatingGUI::$ctrl

protected

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

Referenced by executeCommand(), renderDetails(), and saveRating().

$ctrl_path

array ilRatingGUI::$ctrl_path = []

protected

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

$enable_categories

bool ilRatingGUI::$enable_categories = false

protected

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

$export_callback

ilRatingGUI::$export_callback

protected

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

$export_subobj_title

string ilRatingGUI::$export_subobj_title = ""

protected

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

$id

string ilRatingGUI::$id = "rtg_"

protected

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

Referenced by getHTML().

$lng

ilLanguage ilRatingGUI::$lng

protected

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

Referenced by getHTML(), getTooltipTopics(), and renderDetails().

$obj_id

int ilRatingGUI::$obj_id

protected

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

$obj_type

string ilRatingGUI::$obj_type

protected

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

$requested_rating

int ilRatingGUI::$requested_rating

protected

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

Referenced by saveRating().

$requested_ratings

array ilRatingGUI::$requested_ratings = null

protected

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

$sub_obj_id

int ilRatingGUI::$sub_obj_id

protected

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

$sub_obj_type

string ilRatingGUI::$sub_obj_type

protected

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

Referenced by setObject().

$ui

ILIAS DI UIServices ilRatingGUI::$ui

protected

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

Referenced by getBlockHTML().

$update_callback

ilRatingGUI::$update_callback = null

protected

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

$user

ilObjUser ilRatingGUI::$user

protected

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

Referenced by getTooltipTopics(), and setObject().

$userid

int ilRatingGUI::$userid

protected

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

Referenced by getUserId().

$your_rating_text

string ilRatingGUI::$your_rating_text = ""

protected

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

Referenced by getYourRatingText().

---

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

• components/ILIAS/Rating/classes/class.ilRatingGUI.php