class.ilWikiPagesTableGUI.php

Go to the documentation of this file.

<?php

const IL_WIKI_ALL_PAGES = "all";
const IL_WIKI_NEW_PAGES = "new";
const IL_WIKI_POPULAR_PAGES = "popular";
const IL_WIKI_WHAT_LINKS_HERE = "what_links";
const IL_WIKI_ORPHANED_PAGES = "orphaned";

class ilWikiPagesTableGUI extends ilTable2GUI
{
    protected int $requested_ref_id;
    protected int $page_id = 0;
    protected int $wiki_id = 0;
    protected string $pg_list_mode = "";

    public function __construct(
        object $a_parent_obj,
        string $a_parent_cmd,
        int $a_wiki_id,
        string $a_mode = IL_WIKI_ALL_PAGES,
        int $a_page_id = 0
    ) {
        global $DIC;

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

        $this->requested_ref_id = $DIC
            ->wiki()
            ->internal()
            ->gui()
            ->editing()
            ->request()
            ->getRefId();

        parent::__construct($a_parent_obj, $a_parent_cmd);
        $this->pg_list_mode = $a_mode;
        $this->wiki_id = $a_wiki_id;
        $this->page_id = $a_page_id;

        switch ($this->pg_list_mode) {
            case IL_WIKI_NEW_PAGES:
                $this->addColumn($lng->txt("created"), "created", "33%");
                $this->addColumn($lng->txt("wiki_page"), "title", "33%");
                $this->addColumn($lng->txt("wiki_created_by"), "user_sort", "34%");
                $this->setRowTemplate(
                    "tpl.table_row_wiki_new_page.html",
                    "Modules/Wiki"
                );
                break;

            case IL_WIKI_POPULAR_PAGES:
                $this->addColumn($lng->txt("wiki_page"), "title", "50%");
                $this->addColumn($lng->txt("wiki_page_hits"), "cnt", "50%");
                $this->setRowTemplate(
                    "tpl.table_row_wiki_popular_page.html",
                    "Modules/Wiki"
                );
                break;

            case IL_WIKI_ORPHANED_PAGES:
                $this->addColumn($lng->txt("wiki_page"), "title", "100%");
                $this->setRowTemplate(
                    "tpl.table_row_wiki_orphaned_page.html",
                    "Modules/Wiki"
                );
                break;

            default:
                $this->addColumn($lng->txt("wiki_page"), "title", "33%");
                $this->addColumn($lng->txt("wiki_last_changed"), "date", "33%");
                $this->addColumn($lng->txt("wiki_last_changed_by"), "user_sort", "34%");
                $this->setRowTemplate(
                    "tpl.table_row_wiki_page.html",
                    "Modules/Wiki"
                );
                break;
        }
        $this->setEnableHeader(true);
        $this->setFormAction($ilCtrl->getFormAction($a_parent_obj));
        $this->getPages();

        $this->setShowRowsSelector(true);

        switch ($this->pg_list_mode) {
            case IL_WIKI_WHAT_LINKS_HERE:
                $this->setTitle(
                    sprintf(
                        $lng->txt("wiki_what_links_to_page"),
                        ilWikiPage::lookupTitle($this->page_id)
                    )
                );
                break;

            default:
                $this->setTitle($lng->txt("wiki_" . $a_mode . "_pages"));
                break;
        }
    }

    public function getPages(): void
    {
        $pages = array();
        $this->setDefaultOrderField("title");

        switch ($this->pg_list_mode) {
            case IL_WIKI_WHAT_LINKS_HERE:
                $pages = ilWikiPage::getLinksToPage($this->wiki_id, $this->page_id);
                break;

            case IL_WIKI_ALL_PAGES:
                $pages = ilWikiPage::getAllWikiPages($this->wiki_id);
                break;

            case IL_WIKI_NEW_PAGES:
                $this->setDefaultOrderField("created");
                $this->setDefaultOrderDirection("desc");
                $pages = ilWikiPage::getNewWikiPages($this->wiki_id);
                break;

            case IL_WIKI_POPULAR_PAGES:
                $this->setDefaultOrderField("cnt");
                $this->setDefaultOrderDirection("desc");
                $pages = ilWikiPage::getPopularPages($this->wiki_id);
                break;

            case IL_WIKI_ORPHANED_PAGES:
                $pages = ilWikiPage::getOrphanedPages($this->wiki_id);
                break;
        }

        if ($pages) {
            // enable sorting
            foreach (array_keys($pages) as $idx) {
                if (isset($pages[$idx]["user"])) {
                    $pages[$idx]["user_sort"] = ilUserUtil::getNamePresentation($pages[$idx]["user"], false, false);
                }
            }
        }

        $this->setData($pages);
    }

    public function numericOrdering(string $a_field): bool
    {
        if ($a_field === "cnt") {
            return true;
        }
        return false;
    }

    protected function fillRow(array $a_set): void
    {
        $ilCtrl = $this->ctrl;

        if ($this->pg_list_mode === IL_WIKI_NEW_PAGES) {
            $this->tpl->setVariable("TXT_PAGE_TITLE", $a_set["title"]);
            $this->tpl->setVariable(
                "DATE",
                ilDatePresentation::formatDate(new ilDateTime($a_set["created"], IL_CAL_DATETIME))
            );
        } elseif ($this->pg_list_mode === IL_WIKI_POPULAR_PAGES) {
            $this->tpl->setVariable("TXT_PAGE_TITLE", $a_set["title"]);
            $this->tpl->setVariable("HITS", $a_set["cnt"]);
        } else {
            $this->tpl->setVariable("TXT_PAGE_TITLE", $a_set["title"]);
            $this->tpl->setVariable(
                "DATE",
                ilDatePresentation::formatDate(new ilDateTime($a_set["date"], IL_CAL_DATETIME))
            );
        }
        $this->tpl->setVariable(
            "HREF_PAGE",
            ilObjWikiGUI::getGotoLink(
                $this->requested_ref_id,
                $a_set["title"]
            )
        );

        // user name
        $this->tpl->setVariable(
            "TXT_USER",
            ilUserUtil::getNamePresentation(
                $a_set["user"] ?? 0,
                true,
                true,
                $ilCtrl->getLinkTarget($this->getParentObject(), $this->getParentCmd())
            )
        );
    }
}