ilPreviewGUI Class Reference

Collaboration diagram for ilPreviewGUI:

Public Member Functions
	__construct ($a_node_id=null, $a_context=self::CONTEXT_REPOSITORY, $a_obj_id=null, $a_access_handler=null)
	Creates a new preview GUI. More...
	executeCommand ()
	execute command More...
	getJSCall ($a_html_id)
	Gets the JavaScript code to show the preview. More...
	getPreviewHTML ()
	Gets the HTML that displays the preview. More...
	getInlineHTML ()
	Gets the HTML that is used for displaying the preview inline. More...
	renderPreview ()
	Renders the preview and returns the HTML code that displays the preview. More...
	deletePreview ()
	Deletes the preview and returns the HTML code that displays the preview. More...

Static Public Member Functions
static	initPreview ()
	Initializes the preview and loads the needed javascripts and styles. More...

Data Fields
const	CONTEXT_REPOSITORY = 1
const	CONTEXT_WORKSPACE = 2

Private Member Functions
	renderCommand ($tmpl, $a_cmd, $btn_topic, $loading_topic, $a_display_status)
	Renders a command to the specified template. More...
	getHtmlId ()
	Gets the HTML id for the preview. More...
	buildUrl ($a_cmd="", $a_async=true)
	Builds the URL to call the preview GUI. More...

Static Private Member Functions
static	jsonSafeString ($text)
	Makes the specified string safe for JSON. More...

Private Attributes
	$node_id = null
	$obj_id = null
	$preview = null
	$access_handler = null
	$context = null
	$ctrl = null
	$lng = null

Static Private Attributes
static	$initialized = false

Detailed Description

Definition at line 15 of file class.ilPreviewGUI.php.

Constructor & Destructor Documentation

__construct()

ilPreviewGUI::__construct	(		$a_node_id = null,
			$a_context = self::CONTEXT_REPOSITORY,
			$a_obj_id = null,
			$a_access_handler = null
	)

Creates a new preview GUI.

Parameters

int	$a_node_id	The node id.
int	$a_context	The context of the preview.
int	$a_obj_id	The object id.
object	$a_access_handler	The access handler to use.

Definition at line 61 of file class.ilPreviewGUI.php.

    {
        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();
        }
    }

References $_GET, $DIC, $lng, ilObject\_lookupObjId(), and initPreview().

Here is the call graph for this function:

Member Function Documentation

buildUrl()

ilPreviewGUI::buildUrl (   $a_cmd = "",   $a_async = true  )

private

Builds the URL to call the preview GUI.

Parameters

$a_cmd	string The command to call.
$a_async	bool true, to create a URL to call asynchronous; otherwise, false.

Returns

string The created URL.

Definition at line 332 of file class.ilPreviewGUI.php.

    {
        $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;
    }

Referenced by getJSCall(), and renderCommand().

Here is the caller graph for this function:

deletePreview()

ilPreviewGUI::deletePreview

(

)

Deletes the preview and returns the HTML code that displays the preview.

Returns

string The HTML code that displays the preview.

Definition at line 305 of file class.ilPreviewGUI.php.

    {
        // 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();
    }

References getPreviewHTML().

Here is the call graph for this function:

executeCommand()

ilPreviewGUI::executeCommand

(

)

execute command

Definition at line 116 of file class.ilPreviewGUI.php.

    {
        $cmd = $this->ctrl->getCmd("getPreviewHTML");
        $next_class = $this->ctrl->getNextClass($this);
 
        switch ($next_class) {
            default:
                return $this->$cmd();
                break;
        }
    }

getHtmlId()

ilPreviewGUI::getHtmlId ( )

private

Gets the HTML id for the preview.

Returns

string The HTML id to use for the preview.

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

    {
        return "preview_" . $this->node_id;
    }

References $node_id.

Referenced by getPreviewHTML(), and renderCommand().

Here is the caller graph for this function:

getInlineHTML()

ilPreviewGUI::getInlineHTML

(

)

Gets the HTML that is used for displaying the preview inline.

Returns

string The HTML that is used for displaying the preview inline.

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

    {
        $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();
    }

References getPreviewHTML(), ilPreview\RENDER_STATUS_CREATED, ilPreview\RENDER_STATUS_FAILED, ilPreview\RENDER_STATUS_NONE, and renderCommand().

Here is the call graph for this function:

getJSCall()

ilPreviewGUI::getJSCall

(

$a_html_id

)

Gets the JavaScript code to show the preview.

Parameters

$a_html_id

string The id of the HTML element that contains the preview.

Returns

string The JavaScript code to show the preview.

Definition at line 133 of file class.ilPreviewGUI.php.

    {
        $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' });";
    }

References buildUrl(), jsonSafeString(), and ilPreview\RENDER_STATUS_NONE.

Here is the call graph for this function:

getPreviewHTML()

ilPreviewGUI::getPreviewHTML

(

)

Gets the HTML that displays the preview.

Returns

string The HTML that displays the preview.

Definition at line 148 of file class.ilPreviewGUI.php.

    {
        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();
        }
    }

References $index, $response, ilObject2\_lookupTitle(), ilJsonUtil\encode(), exit, getHtmlId(), ilPreview\RENDER_STATUS_FAILED, ilPreview\RENDER_STATUS_PENDING, and ilWACSignedPath\signFile().

Referenced by deletePreview(), getInlineHTML(), and renderPreview().

Here is the call graph for this function:

Here is the caller graph for this function:

initPreview()

static ilPreviewGUI::initPreview ( )

static

Initializes the preview and loads the needed javascripts and styles.

Definition at line 351 of file class.ilPreviewGUI.php.

    {
        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;
    }

References $DIC, $i, ilPreviewSettings\getImageSize(), ilTooltipGUI\init(), iljQueryUtil\initjQuery(), and ilUtil\prepareFormOutput().

Referenced by __construct(), and ilObjCategoryGUI\addHeaderAction().

Here is the call graph for this function:

Here is the caller graph for this function:

jsonSafeString()

static ilPreviewGUI::jsonSafeString (   $text )

staticprivate

Makes the specified string safe for JSON.

Parameters

string

$text

The text to make JSON safe.

Returns

string The JSON safe text.

Definition at line 403 of file class.ilPreviewGUI.php.

    {
        if (!is_string($text)) {
            return $text;
        }
        
        $text = htmlentities($text, ENT_COMPAT | ENT_HTML401, "UTF-8");
        $text = str_replace("'", "'", $text);
        return $text;
    }

Referenced by getJSCall(), and renderCommand().

Here is the caller graph for this function:

renderCommand()

ilPreviewGUI::renderCommand (   $tmpl,   $a_cmd,   $btn_topic,   $loading_topic,   $a_display_status  )

private

Renders a command to the specified template.

Parameters

$tmpl	object The template.
$a_cmd	string The command to create.
$btn_topic	string The topic to get the button text.
$loading_topic	string The topic to get the loading text.
$a_display_status	array An array containing the statuses when the command should be visible.

Definition at line 263 of file class.ilPreviewGUI.php.

    {
        $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();
    }

References buildUrl(), getHtmlId(), and jsonSafeString().

Referenced by getInlineHTML().

Here is the call graph for this function:

Here is the caller graph for this function:

renderPreview()

ilPreviewGUI::renderPreview

(

)

Renders the preview and returns the HTML code that displays the preview.

Returns

string The HTML code that displays the preview.

Definition at line 289 of file class.ilPreviewGUI.php.

    {
        // 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();
    }

References ilObjectFactory\getInstanceByObjId(), and getPreviewHTML().

Here is the call graph for this function:

Field Documentation

$access_handler

ilPreviewGUI::$access_handler = null

private

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

$context

ilPreviewGUI::$context = null

private

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

$ctrl

ilPreviewGUI::$ctrl = null

private

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

$initialized

ilPreviewGUI::$initialized = false

staticprivate

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

$lng

ilPreviewGUI::$lng = null

private

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

Referenced by __construct().

$node_id

ilPreviewGUI::$node_id = null

private

Definition at line 21 of file class.ilPreviewGUI.php.

Referenced by getHtmlId().

$obj_id

ilPreviewGUI::$obj_id = null

private

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

$preview

ilPreviewGUI::$preview = null

private

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

CONTEXT_REPOSITORY

const ilPreviewGUI::CONTEXT_REPOSITORY = 1

Definition at line 51 of file class.ilPreviewGUI.php.

Referenced by ilDclFileuploadRecordRepresentation\getHTML(), ilObjFileGUI\infoScreenForward(), and ilObjectListGUI\insertTitle().

CONTEXT_WORKSPACE

const ilPreviewGUI::CONTEXT_WORKSPACE = 2

Definition at line 52 of file class.ilPreviewGUI.php.

Referenced by ilObjFileGUI\infoScreenForward(), and ilObjectListGUI\insertTitle().

---

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

• Services/Preview/classes/class.ilPreviewGUI.php