Source for file jResponseXul.class.php

Documentation is available at jResponseXul.class.php

<?php
/**
* @package jelix
* @subpackage core_response
* @author Laurent Jouanneau
* @contributor Dominique Papin, Julien Issler
* @link http://www.jelix.org
* @licence GNU Lesser General Public Licence see LICENCE file or http://www.gnu.org/licenses/lgpl.html
*/
/**
*
*/
require_once(JELIX_LIB_PATH.'tpl/jTpl.class.php');
/**
* Generate a XUL window
* @package jelix
* @subpackage core_response
* @see jResponse
*/
class jResponseXul extends jResponse {
/**
* @var string
*/
protected $_type = 'xul';
/**
* header content : list of overlay links
* @var array
*/
protected $_overlays = array ();
/**
* header content : list of css file links
* @var array
*/
protected $_CSSLink = array ();
/**
* header content : list of javascript file links
* @var array
*/
protected $_JSLink = array ();
/**
* header content : list of piece of javascript code
* @var array
*/
protected $_JSCode = array ();
/**
* root tag name.
* could be override into child class for other xul document
*/
protected $_root = 'window';
/**
* list of attributes and their values for the root element
* @var array
*/
public $rootAttributes= array();
/**
* Title of the window
* @var string
*/
public $title = '';
/**
* template engine to generate the window content
* @var jTpl
*/
public $body = null;
/**
* selector of the template to use
* @var string
*/
public $bodyTpl = '';
/**
* says if an event is sent to retrieve overlays url for the xul content
* @var boolean
*/
public $fetchOverlays=false;
protected $_bodyTop = array();
protected $_bodyBottom = array();
protected $_headSent = false;
/**
* constructor
*/
function __construct (){
$this->body = new jTpl();
parent::__construct();
}
/**
* generate the xul content.
* @return boolean true if it's ok
*/
public function output(){
if($this->_outputOnlyHeaders){
$this->sendHttpHeaders();
return true;
}
$this->doAfterActions();
if($this->bodyTpl != '') {
$this->body->meta($this->bodyTpl);
$content = $this->body->fetch($this->bodyTpl, 'xul', true, false);
}
else
$content = '';
// retrieve errors messages and log messages
jLog::outputLog($this);
$this->_httpHeaders['Content-Type']='application/vnd.mozilla.xul+xml;charset='.jApp::config()->charset;
$this->sendHttpHeaders();
$this->outputHeader();
echo implode('',$this->_bodyTop);
echo $content;
echo implode('',$this->_bodyBottom);
echo '</',$this->_root,'>';
return true;
}
public function outputErrors(){
header("HTTP/1.0 500 Internal Server Error");
header('Content-Type: application/vnd.mozilla.xul+xml;charset='.jApp::config()->charset);
echo '<?xml version="1.0" encoding="'.jApp::config()->charset.'" ?>'."\n";
echo '<',$this->_root,' title="Errors" xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">';
echo '<vbox>';
$message = jApp::coord()->getGenericErrorMessage();
echo "<description style=\"color:#FF0000;\">".htmlspecialchars($message, ENT_NOQUOTES, jApp::config()->charset)."</description>";
echo '</vbox></',$this->_root,'>';
}
/**
* call it to add manually content before or after the main content
* @param string $content xul content
* @param boolean $beforeTpl true if you want to add before, false for after
*/
function addContent($content, $beforeTpl = false){
if($beforeTpl){
$this->_bodyTop[]=$content;
}else{
$this->_bodyBottom[]=$content;
}
}
/**
* add a link to a xul overlay for the xul page
* @param string $src url of a xul overlay
*/
function addOverlay ($src){
$this->_overlays[$src] = true;
}
/**
* add a link to a javascript file
* @param string $src url
*/
function addJSLink ($src, $params=array()){
if (!isset ($this->_JSLink[$src])){
$this->_JSLink[$src] = $params;
}
}
/**
* add a link to a css stylesheet
* @param string $src url
*/
function addCSSLink ($src, $params=array ()){
if (!isset ($this->_CSSLink[$src])){
$this->_CSSLink[$src] = $params;
}
}
/**
* add a piece of javascript code
* @param string $code javascript source code
*/
function addJSCode ($code){
$this->_JSCode[] = $code;
}
protected function outputHeader (){
$charset = jApp::config()->charset;
echo '<?xml version="1.0" encoding="'.$charset.'" ?>'."\n";
// css link
foreach ($this->_CSSLink as $src=>$param){
if(is_string($param))
echo '<?xml-stylesheet type="text/css" href="',htmlspecialchars($src,ENT_COMPAT, $charset),'" '.$param.'?>',"\n";
else
echo '<?xml-stylesheet type="text/css" href="',htmlspecialchars($src,ENT_COMPAT, $charset),'" ?>',"\n";
}
$this->_otherthings();
echo '<',$this->_root;
foreach($this->rootAttributes as $name=>$value){
echo ' ',$name,'="',htmlspecialchars($value,ENT_COMPAT, $charset),'"';
}
echo " xmlns:html=\"http://www.w3.org/1999/xhtml\"
xmlns=\"http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul\">\n";
// js link
foreach ($this->_JSLink as $src=>$params){
echo '<script type="application/x-javascript" src="',htmlspecialchars($src),'" />',"\n";
}
// js code
if(count($this->_JSCode)){
echo '<script type="application/x-javascript">
<![CDATA[
'.implode ("\n", $this->_JSCode).'
]]>
</script>';
}
}
/**
* The method you can overload in your inherited XUL response
* overload it if you want to add processes (stylesheet, head settings, additionnal content etc..)
* after all actions
* @since 1.1
*/
protected function doAfterActions(){
}
/**
*
*/
protected function _otherthings(){
// overlays
// browser sniffing, because "&" should be escaped in a xul-overlay PI in gecko 1.9+
$escape = false;
if(preg_match('!^Mozilla/5.0 $.* rv:(\d)\.(\d).*$ Gecko/\d+.*$!',$_SERVER["HTTP_USER_AGENT"],$m)){
if(version_compare($m[1].'.'.$m[2], '1.9') >= 0) {
$escape = true;
}
}
if($this->fetchOverlays){
$sel = new jSelectorTpl($this->bodyTpl);
$eventresp = jEvent::notify ('FetchXulOverlay', array('tpl'=>$sel->toString()));
foreach($eventresp->getResponse() as $rep){
if(is_array($rep)){
$this->_overlays[jUrl::get($rep[0],$rep[1])]=true;
}elseif(is_string($rep)){
$this->_overlays[jUrl::get($rep)]=true;
}
}
}
foreach ($this->_overlays as $src=>$ok){
echo '<?xul-overlay href="',($escape?htmlspecialchars($src):$src),'" ?>',"\n";
}
$this->rootAttributes['title']=$this->title;
}
/**
* clear all header informations
* @var array list of keyword
*/
public function clearHeader ($what){
$cleanable = array ('CSSLink', 'JSLink', 'JSCode', 'overlays');
foreach ($what as $elem){
if (in_array ($elem, $cleanable)){
$name = '_'.$elem;
$this->$name = array ();
}
}
}
public function getFormatType(){ return 'xul';}
}

Documentation generated on Mon, 26 Oct 2015 21:55:55 +0100 by phpDocumentor 1.4.3