class.ilPreviewGUI.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once("./Services/Preview/classes/class.ilPreviewSettings.php");
require_once("./Services/Preview/classes/class.ilPreview.php");

class ilPreviewGUI
{

    private $node_id = null;
    private $obj_id = null;
    private $preview = null;
    private $access_handler = null;
    private $context = null;
    private $ctrl = null;
    private $lng = null;
    private static $initialized = false;

    const CONTEXT_REPOSITORY = 1;
    const CONTEXT_WORKSPACE = 2;
    
    public function __construct($a_node_id = null, $a_context = self::CONTEXT_REPOSITORY, $a_obj_id = null, $a_access_handler = null)
    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
        $ilAccess = $DIC['ilAccess'];
        
        // if we are the base class, get the id's from the query string
        if (strtolower($_GET["baseClass"]) == "ilpreviewgui") {
            $this->node_id = (int) $_GET["node_id"];
            $this->context = (int) $_GET["context"];
            $a_obj_id = (int) $_GET['obj_id'];
        } else {
            $this->node_id = $a_node_id;
            $this->context = $a_context;
        }
        
        // assign values
        $this->ctrl = $ilCtrl;
        $this->lng = $lng;
        
        // access handler NOT provided?
        if ($a_access_handler == null) {
            if ($this->context == self::CONTEXT_WORKSPACE) {
                include_once("./Services/PersonalWorkspace/classes/class.ilWorkspaceAccessHandler.php");
                $a_access_handler = new ilWorkspaceAccessHandler();
            } else {
                $a_access_handler = $ilAccess;
            }
        }
        $this->access_handler = $a_access_handler;
        
        // object id NOT provided?
        if ($a_obj_id == null) {
            if ($this->context == self::CONTEXT_WORKSPACE) {
                $a_obj_id = $this->access_handler->getTree()->lookupObjectId($this->node_id);
            } else {
                $a_obj_id = ilObject::_lookupObjId($this->node_id);
            }
        }
        $this->obj_id = $a_obj_id;
        
        // create preview object
        $this->preview = new ilPreview($this->obj_id);
        
        // if the call is NOT async initialize our stuff
        if (!$ilCtrl->isAsynch()) {
            ilPreviewGUI::initPreview();
        }
    }


    public function executeCommand()
    {
        $cmd = $this->ctrl->getCmd("getPreviewHTML");
        $next_class = $this->ctrl->getNextClass($this);

        switch ($next_class) {
            default:
                return $this->$cmd();
                break;
        }
    }
    
    public function getJSCall($a_html_id)
    {
        $status = $this->preview->getRenderStatus();
        $command = $status == ilPreview::RENDER_STATUS_NONE ? "renderPreview" : "";
        $loading_text = self::jsonSafeString($this->lng->txt($status == ilPreview::RENDER_STATUS_NONE ? "preview_status_creating" : "preview_loading"));
        
        // build the url
        $link = $this->buildUrl($command);
        return "il.Preview.toggle(event, { id: '{$this->node_id}', htmlId: '{$a_html_id}', url: '$link', status: '$status', loadingText: '$loading_text' });";
    }
    
    public function getPreviewHTML()
    {
        require_once('./Services/WebAccessChecker/classes/class.ilWACSignedPath.php');
        // load the template
        $tmpl = new ilTemplate("tpl.preview.html", true, true, "Services/Preview");
        $tmpl->setVariable("PREVIEW_ID", $this->getHtmlId());
        
        // check for read access and get object id
        $preview_status = $this->preview->getRenderStatus();
        
        // has read access?
        if ($this->access_handler->checkAccess("read", "", $this->node_id)) {
            // preview images available?
            $images = $this->preview->getImages();
            if (count($images) > 0) {
                $title = ilObject2::_lookupTitle($this->obj_id);
                $index = 1;
                foreach ($images as $image) {
                    $tmpl->setCurrentBlock("preview_item");
                    $tmpl->setVariable("IMG_URL", ilWACSignedPath::signFile($image["url"]));
                    $tmpl->setVariable("WIDTH", $image["width"]);
                    $tmpl->setVariable("HEIGHT", $image["height"]);
                    $tmpl->setVariable("ALT_TEXT", sprintf(
                        $this->lng->txt('preview_caption'),
                        (string) $index . ' ',
                        $title
                    ));
                    $tmpl->parseCurrentBlock();
                    $index++;
                }
            } else {
                // set text depending on the status
                $tmpl->setCurrentBlock("no_preview");
                switch ($preview_status) {
                    case ilPreview::RENDER_STATUS_PENDING:
                        $tmpl->setVariable("TXT_NO_PREVIEW", $this->lng->txt("preview_status_pending"));
                        break;
                    
                    case ilPreview::RENDER_STATUS_FAILED:
                        $tmpl->setVariable("TXT_NO_PREVIEW", $this->lng->txt("preview_status_failed"));
                        break;
                    
                    default:
                        $tmpl->setVariable("TXT_NO_PREVIEW", $this->lng->txt("preview_status_missing"));
                        break;
                }
                $tmpl->parseCurrentBlock();
            }
        } else {
            // display error message
            $tmpl->setVariable("TXT_NO_PREVIEW", $this->lng->txt("no_access_item"));
        }
        
        // output
        if ($this->ctrl->isAsynch()) {
            include_once("./Services/JSON/classes/class.ilJsonUtil.php");
            
            $response = new stdClass();
            $response->html = $tmpl->get();
            $response->status = $preview_status;
            
            // send response object (don't use 'application/json' as IE wants to download it!)
            header('Vary: Accept');
            header('Content-type: text/plain');
            echo ilJsonUtil::encode($response);

            // no further processing!
            exit;
        } else {
            return $tmpl->get();
        }
    }
    
    public function getInlineHTML()
    {
        $tmpl = new ilTemplate("tpl.preview_inline.html", true, true, "Services/Preview");
        $tmpl->setVariable("PREVIEW", $this->getPreviewHTML());
        
        // rendering allowed?
        if ($this->access_handler->checkAccess("read", "", $this->node_id)) {
            $this->renderCommand(
                $tmpl,
                "render",
                "preview_create",
                "preview_status_creating",
                array(ilPreview::RENDER_STATUS_NONE, ilPreview::RENDER_STATUS_FAILED)
            );
        }
        
        // delete allowed?
        if ($this->access_handler->checkAccess("write", "", $this->node_id)) {
            $this->renderCommand(
                $tmpl,
                "delete",
                "preview_delete",
                "preview_status_deleting",
                array(ilPreview::RENDER_STATUS_CREATED)
            );
        }
        
        return $tmpl->get();
    }
    
    private function renderCommand($tmpl, $a_cmd, $btn_topic, $loading_topic, $a_display_status)
    {
        $preview_html_id = $this->getHtmlId();
        $preview_status = $this->preview->getRenderStatus();
        $loading_text = self::jsonSafeString($this->lng->txt($loading_topic));
        
        $link = $this->buildUrl($a_cmd . "Preview");
        $script_args = "event, { id: '{$this->node_id}', htmlId: '$preview_html_id', url: '$link', loadingText: '$loading_text' }";
        
        $action_class = "";
        if (!is_array($a_display_status) || !in_array($preview_status, $a_display_status)) {
            $action_class = "ilPreviewActionHidden";
        }
        
        $tmpl->setCurrentBlock("preview_action");
        $tmpl->setVariable("CLICK_ACTION", "il.Preview.$a_cmd($script_args);");
        $tmpl->setVariable("ACTION_CLASS", "$action_class");
        $tmpl->setVariable("ACTION_ID", "preview_{$a_cmd}_" . $preview_html_id);
        $tmpl->setVariable("TXT_ACTION", $this->lng->txt($btn_topic));
        $tmpl->parseCurrentBlock();
    }
    
    public function renderPreview()
    {
        // has read access?
        if ($this->access_handler->checkAccess("read", "", $this->node_id)) {
            // get the object
            $obj = ilObjectFactory::getInstanceByObjId($this->obj_id);
            $this->preview->create($obj);
        }

        return $this->getPreviewHTML();
    }
    
    public function deletePreview()
    {
        // has read access?
        if ($this->access_handler->checkAccess("write", "", $this->node_id)) {
            // get the preview
            require_once("./Services/Preview/classes/class.ilPreview.php");
            $this->preview->delete();
        }

        return $this->getPreviewHTML();
    }
    
    private function getHtmlId()
    {
        return "preview_" . $this->node_id;
    }
    
    private function buildUrl($a_cmd = "", $a_async = true)
    {
        $link = "ilias.php?baseClass=ilPreviewGUI&node_id={$this->node_id}&context={$this->context}&obj_id={$this->obj_id}";
        
        if ($a_async) {
            $link .= "&cmdMode=asynch";
        }
        
        if (!empty($a_cmd)) {
            $link .= "&cmd=$a_cmd";
        }
        
        return $link;
    }


    public static function initPreview()
    {
        if (self::$initialized) {
            return;
        }

        global $DIC;
        // jquery
        iljQueryUtil::initjQuery();

        // load qtip
        ilTooltipGUI::init();

        // needed scripts & styles
        $DIC->ui()->mainTemplate()->addJavaScript("./libs/bower/bower_components/jquery-mousewheel/jquery.mousewheel.js");
        $DIC->ui()->mainTemplate()->addJavaScript("./Services/Preview/js/ilPreview.js");

        // create loading template
        $tmpl = new ilTemplate("tpl.preview.html", true, true, "Services/Preview");
        $tmpl->setCurrentBlock("no_preview");
        $tmpl->setVariable("TXT_NO_PREVIEW", "%%0%%");
        $tmpl->parseCurrentBlock();

        $initialHtml = str_replace(array("\r\n", "\r"), "\n", $tmpl->get());
        $lines = explode("\n", $initialHtml);
        $new_lines = array();
        foreach ($lines as $i => $line) {
            if (!empty($line)) {
                $new_lines[] = trim($line);
            }
        }
        $initialHtml = implode($new_lines);

        // add default texts and values
        $DIC->ui()->mainTemplate()->addOnLoadCode("il.Preview.texts.preview = \"" . self::jsonSafeString($DIC->language()->txt("preview")) . "\";");
        $DIC->ui()->mainTemplate()->addOnLoadCode("il.Preview.texts.showPreview = \"" . self::jsonSafeString($DIC->language()->txt("preview_show"))
                                                  . "\";");
        $DIC->ui()->mainTemplate()->addOnLoadCode("il.Preview.texts.close = \"" . ilUtil::prepareFormOutput($DIC->language()->txt("close")) . "\";");
        $DIC->ui()->mainTemplate()->addOnLoadCode("il.Preview.previewSize = " . ilPreviewSettings::getImageSize() . ";");
        $DIC->ui()->mainTemplate()->addOnLoadCode("il.Preview.initialHtml = " . json_encode($initialHtml) . ";");
        $DIC->ui()->mainTemplate()->addOnLoadCode("il.Preview.highlightClass = \"ilContainerListItemOuterHighlight\";");
        $DIC->ui()->mainTemplate()->addOnLoadCode("il.Preview.init();");

        self::$initialized = true;
    }
    
    private static function jsonSafeString($text)
    {
        if (!is_string($text)) {
            return $text;
        }
        
        $text = htmlentities($text, ENT_COMPAT | ENT_HTML401, "UTF-8");
        $text = str_replace("'", "&#039;", $text);
        return $text;
    }
}