Blame view

sources/lib/private/template.php 8.91 KB
31b7f2792   Kload   Upgrade to ownclo...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
  <?php
  /**
   * ownCloud
   *
   * @author Frank Karlitschek
   * @author Jakob Sack
   * @copyright 2012 Frank Karlitschek frank@owncloud.org
   *
   * This library is free software; you can redistribute it and/or
   * modify it under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE
   * License as published by the Free Software Foundation; either
   * version 3 of the License, or any later version.
   *
   * This library is distributed in the hope that it will be useful,
   * but WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   * GNU AFFERO GENERAL PUBLIC LICENSE for more details.
   *
   * You should have received a copy of the GNU Affero General Public
   * License along with this library.  If not, see <http://www.gnu.org/licenses/>.
   *
   */
  
  require_once __DIR__.'/template/functions.php';
  
  /**
   * This class provides the templates for ownCloud.
   */
  class OC_Template extends \OC\Template\Base {
  	private $renderas; // Create a full page?
  	private $path; // The path to the template
  	private $headers=array(); //custom headers
6d9380f96   Cédric Dupont   Update sources OC...
33
  	protected $app; // app id
31b7f2792   Kload   Upgrade to ownclo...
34
35
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
36
  	 * Constructor
31b7f2792   Kload   Upgrade to ownclo...
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
  	 * @param string $app app providing the template
  	 * @param string $name of the template file (without suffix)
  	 * @param string $renderas = ""; produce a full page
  	 * @return OC_Template object
  	 *
  	 * This function creates an OC_Template object.
  	 *
  	 * If $renderas is set, OC_Template will try to produce a full page in the
  	 * according layout. For now, renderas can be set to "guest", "user" or
  	 * "admin".
  	 */
  	public function __construct( $app, $name, $renderas = "" ) {
  		// Read the selected theme from the config file
  		$theme = OC_Util::getTheme();
  
  		// Read the detected formfactor and use the right file name.
  		$fext = self::getFormFactorExtension();
  
  		$requesttoken = OC::$session ? OC_Util::callRegister() : '';
  
  		$parts = explode('/', $app); // fix translation when app is something like core/lostpassword
  		$l10n = OC_L10N::get($parts[0]);
  		$themeDefaults = new OC_Defaults();
  
  		list($path, $template) = $this->findTemplate($theme, $app, $name, $fext);
  
  		// Set the private data
  		$this->renderas = $renderas;
  		$this->path = $path;
6d9380f96   Cédric Dupont   Update sources OC...
66
  		$this->app = $app;
31b7f2792   Kload   Upgrade to ownclo...
67
68
  
  		parent::__construct($template, $requesttoken, $l10n, $themeDefaults);
31b7f2792   Kload   Upgrade to ownclo...
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
  	}
  
  	/**
  	 * autodetect the formfactor of the used device
  	 * default -> the normal desktop browser interface
  	 * mobile -> interface for smartphones
  	 * tablet -> interface for tablets
  	 * standalone -> the default interface but without header, footer and
  	 *	sidebar, just the application. Useful to use just a specific
  	 *	app on the desktop in a standalone window.
  	 */
  	public static function detectFormfactor() {
  		// please add more useragent strings for other devices
  		if(isset($_SERVER['HTTP_USER_AGENT'])) {
  			if(stripos($_SERVER['HTTP_USER_AGENT'], 'ipad')>0) {
  				$mode='tablet';
  			}elseif(stripos($_SERVER['HTTP_USER_AGENT'], 'iphone')>0) {
  				$mode='mobile';
  			}elseif((stripos($_SERVER['HTTP_USER_AGENT'], 'N9')>0)
  				and (stripos($_SERVER['HTTP_USER_AGENT'], 'nokia')>0)) {
  				$mode='mobile';
  			}else{
  				$mode='default';
  			}
  		}else{
  			$mode='default';
  		}
  		return($mode);
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
100
  	 * Returns the formfactor extension for current formfactor
31b7f2792   Kload   Upgrade to ownclo...
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
  	 */
  	static public function getFormFactorExtension()
  	{
  		if (!\OC::$session) {
  			return '';
  		}
  		// if the formfactor is not yet autodetected do the
  		// autodetection now. For possible formfactors check the
  		// detectFormfactor documentation
  		if (!\OC::$session->exists('formfactor')) {
  			\OC::$session->set('formfactor', self::detectFormfactor());
  		}
  		// allow manual override via GET parameter
  		if(isset($_GET['formfactor'])) {
  			\OC::$session->set('formfactor', $_GET['formfactor']);
  		}
  		$formfactor = \OC::$session->get('formfactor');
  		if($formfactor==='default') {
  			$fext='';
  		}elseif($formfactor==='mobile') {
  			$fext='.mobile';
  		}elseif($formfactor==='tablet') {
  			$fext='.tablet';
  		}elseif($formfactor==='standalone') {
  			$fext='.standalone';
  		}else{
  			$fext='';
  		}
  		return $fext;
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
133
  	 * find the template with the given name
31b7f2792   Kload   Upgrade to ownclo...
134
135
136
137
  	 * @param string $name of the template file (without suffix)
  	 *
  	 * Will select the template file for the selected theme and formfactor.
  	 * Checking all the possible locations.
6d9380f96   Cédric Dupont   Update sources OC...
138
139
140
141
  	 * @param string $theme
  	 * @param string $app
  	 * @param string $fext
  	 * @return array
31b7f2792   Kload   Upgrade to ownclo...
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
  	 */
  	protected function findTemplate($theme, $app, $name, $fext) {
  		// Check if it is a app template or not.
  		if( $app !== '' ) {
  			$dirs = $this->getAppTemplateDirs($theme, $app, OC::$SERVERROOT, OC_App::getAppPath($app));
  		} else {
  			$dirs = $this->getCoreTemplateDirs($theme, OC::$SERVERROOT);
  		}
  		$locator = new \OC\Template\TemplateFileLocator( $fext, $dirs );
  		$template = $locator->find($name);
  		$path = $locator->getPath();
  		return array($path, $template);
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
157
  	 * Add a custom element to the header
31b7f2792   Kload   Upgrade to ownclo...
158
159
160
161
162
163
164
165
166
  	 * @param string $tag tag name of the element
  	 * @param array $attributes array of attributes for the element
  	 * @param string $text the text content for the element
  	 */
  	public function addHeader( $tag, $attributes, $text='') {
  		$this->headers[]=array('tag'=>$tag,'attributes'=>$attributes, 'text'=>$text);
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
167
168
  	 * Process the template
  	 * @return boolean|string
31b7f2792   Kload   Upgrade to ownclo...
169
170
171
172
173
174
175
176
  	 *
  	 * This function process the template. If $this->renderas is set, it
  	 * will produce a full page.
  	 */
  	public function fetchPage() {
  		$data = parent::fetchPage();
  
  		if( $this->renderas ) {
6d9380f96   Cédric Dupont   Update sources OC...
177
  			$page = new OC_TemplateLayout($this->renderas, $this->app);
31b7f2792   Kload   Upgrade to ownclo...
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
  
  			// Add custom headers
  			$page->assign('headers', $this->headers, false);
  			foreach(OC_Util::$headers as $header) {
  				$page->append('headers', $header);
  			}
  
  			$page->assign( "content", $data, false );
  			return $page->fetchPage();
  		}
  		else{
  			return $data;
  		}
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
194
  	 * Include template
31b7f2792   Kload   Upgrade to ownclo...
195
196
197
198
199
200
201
202
203
204
  	 * @return string returns content of included template
  	 *
  	 * Includes another template. use <?php echo $this->inc('template'); ?> to
  	 * do this.
  	 */
  	public function inc( $file, $additionalparams = null ) {
  		return $this->load($this->path.$file.'.php', $additionalparams);
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
205
  	 * Shortcut to print a simple page for users
31b7f2792   Kload   Upgrade to ownclo...
206
207
208
  	 * @param string $application The application we render the template for
  	 * @param string $name Name of the template
  	 * @param array $parameters Parameters for the template
6d9380f96   Cédric Dupont   Update sources OC...
209
  	 * @return boolean|null
31b7f2792   Kload   Upgrade to ownclo...
210
211
212
213
214
215
216
217
218
219
  	 */
  	public static function printUserPage( $application, $name, $parameters = array() ) {
  		$content = new OC_Template( $application, $name, "user" );
  		foreach( $parameters as $key => $value ) {
  			$content->assign( $key, $value );
  		}
  		print $content->printPage();
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
220
  	 * Shortcut to print a simple page for admins
31b7f2792   Kload   Upgrade to ownclo...
221
222
223
224
225
226
227
228
229
230
231
232
233
234
  	 * @param string $application The application we render the template for
  	 * @param string $name Name of the template
  	 * @param array $parameters Parameters for the template
  	 * @return bool
  	 */
  	public static function printAdminPage( $application, $name, $parameters = array() ) {
  		$content = new OC_Template( $application, $name, "admin" );
  		foreach( $parameters as $key => $value ) {
  			$content->assign( $key, $value );
  		}
  		return $content->printPage();
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
235
  	 * Shortcut to print a simple page for guests
31b7f2792   Kload   Upgrade to ownclo...
236
237
  	 * @param string $application The application we render the template for
  	 * @param string $name Name of the template
6d9380f96   Cédric Dupont   Update sources OC...
238
  	 * @param array|string $parameters Parameters for the template
31b7f2792   Kload   Upgrade to ownclo...
239
240
241
242
243
244
245
246
247
248
249
  	 * @return bool
  	 */
  	public static function printGuestPage( $application, $name, $parameters = array() ) {
  		$content = new OC_Template( $application, $name, "guest" );
  		foreach( $parameters as $key => $value ) {
  			$content->assign( $key, $value );
  		}
  		return $content->printPage();
  	}
  
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
250
  		* Print a fatal error page and terminates the script
31b7f2792   Kload   Upgrade to ownclo...
251
252
253
254
255
256
257
258
259
260
261
  		* @param string $error_msg The error message to show
  		* @param string $hint An optional hint message
  		* Warning: All data passed to $hint needs to get sanitized using OC_Util::sanitizeHTML
  		*/
  	public static function printErrorPage( $error_msg, $hint = '' ) {
  		$content = new OC_Template( '', 'error', 'error' );
  		$errors = array(array('error' => $error_msg, 'hint' => $hint));
  		$content->assign( 'errors', $errors );
  		$content->printPage();
  		die();
  	}
6d9380f96   Cédric Dupont   Update sources OC...
262

31b7f2792   Kload   Upgrade to ownclo...
263
264
265
266
  	/**
  	 * print error page using Exception details
  	 * @param Exception $exception
  	 */
31b7f2792   Kload   Upgrade to ownclo...
267
268
269
270
271
272
273
274
275
276
  	public static function printExceptionErrorPage(Exception $exception) {
  		$error_msg = $exception->getMessage();
  		if ($exception->getCode()) {
  			$error_msg = '['.$exception->getCode().'] '.$error_msg;
  		}
  		if (defined('DEBUG') and DEBUG) {
  			$hint = $exception->getTraceAsString();
  			if (!empty($hint)) {
  				$hint = '<pre>'.$hint.'</pre>';
  			}
31b7f2792   Kload   Upgrade to ownclo...
277
  			while (method_exists($exception, 'previous') && $exception = $exception->previous()) {
a293d369c   Kload   Update sources to...
278
  				$error_msg .= '<br/>Caused by:' . ' ';
31b7f2792   Kload   Upgrade to ownclo...
279
280
281
282
283
284
285
286
287
288
289
290
291
292
  				if ($exception->getCode()) {
  					$error_msg .= '['.$exception->getCode().'] ';
  				}
  				$error_msg .= $exception->getMessage();
  			};
  		} else {
  			$hint = '';
  			if ($exception instanceof \OC\HintException) {
  				$hint = $exception->getHint();
  			}
  		}
  		self::printErrorPage($error_msg, $hint);
  	}
  }