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.

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

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

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.

Referenced by getJSCall(), and renderCommand().

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

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.

References getPreviewHTML().

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

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.

References $node_id.

Referenced by getPreviewHTML(), and renderCommand().

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

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.

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

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

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.

References buildUrl(), and ilPreview\RENDER_STATUS_NONE.

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

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.

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().

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

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.

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

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

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

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("'", "&#039;", $text);
         return $text;
     }

◆ 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.

References buildUrl(), and getHtmlId().

Referenced by getInlineHTML().

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

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.

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

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

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

Public Member Functions

Static Public Member Functions

Data Fields

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ buildUrl()

◆ deletePreview()

◆ executeCommand()

◆ getHtmlId()

◆ getInlineHTML()

◆ getJSCall()

◆ getPreviewHTML()

◆ initPreview()

◆ jsonSafeString()

◆ renderCommand()

◆ renderPreview()

Field Documentation

◆ $access_handler

◆ $context

◆ $ctrl

◆ $initialized

◆ $lng

◆ $node_id

◆ $obj_id

◆ $preview

◆ CONTEXT_REPOSITORY

◆ CONTEXT_WORKSPACE