. * */ /** * @brief make OC_Helper::linkTo available as a simple function * @param $app app * @param $file file * @returns link to the file * * For further information have a look at OC_Helper::linkTo */ function link_to( $app, $file ){ return OC_Helper::linkTo( $app, $file ); } /** * @brief make OC_Helper::imagePath available as a simple function * @param $app app * @param $image image * @returns link to the image * * For further information have a look at OC_Helper::imagePath */ function image_path( $app, $image ){ return OC_Helper::imagePath( $app, $image ); } /** * @brief make OC_Helper::mimetypeIcon available as a simple function * @param $mimetype mimetype * @returns link to the image * * For further information have a look at OC_Helper::mimetypeIcon */ function mimetype_icon( $mimetype ){ return OC_Helper::mimetypeIcon( $mimetype ); } /** * @brief make OC_Helper::humanFileSize available as a simple function * @param $bytes size in bytes * @returns size as string * * For further information have a look at OC_Helper::humanFileSize */ function human_file_size( $bytes ){ return OC_Helper::humanFileSize( $bytes ); } function simple_file_size($bytes) { $mbytes = round($bytes/(1024*1024),1); if($bytes == 0) { return '0'; } else if($mbytes < 0.1) { return '< 0.1'; } else if($mbytes > 1000) { return '> 1000'; } else { return number_format($mbytes, 1); } } function relative_modified_date($timestamp) { $l=OC_L10N::get('template'); $timediff = time() - $timestamp; $diffminutes = round($timediff/60); $diffhours = round($diffminutes/60); $diffdays = round($diffhours/24); $diffmonths = round($diffdays/31); $diffyears = round($diffdays/365); if($timediff < 60) { return $l->t('seconds ago'); } else if($timediff < 120) { return $l->t('1 minute ago'); } else if($timediff < 3600) { return $l->t('%d minutes ago',$diffminutes); } //else if($timediff < 7200) { return '1 hour ago'; } //else if($timediff < 86400) { return $diffhours.' hours ago'; } else if((date('G')-$diffhours) > 0) { return $l->t('today'); } else if((date('G')-$diffhours) > -24) { return $l->t('yesterday'); } else if($timediff < 2678400) { return $l->t('%d days ago',$diffdays); } else if($timediff < 5184000) { return $l->t('last month'); } else if((date('n')-$diffmonths) > 0) { return $l->t('months ago'); } else if($timediff < 63113852) { return $l->t('last year'); } else { return $l->t('years ago'); } } function html_select_options($options, $selected, $params=array()) { if (!is_array($selected)){ $selected=array($selected); } if (isset($params['combine']) && $params['combine']){ $options = array_combine($options, $options); } $value_name = $label_name = false; if (isset($params['value'])){ $value_name = $params['value']; } if (isset($params['label'])){ $label_name = $params['label']; } $html = ''; foreach($options as $value => $label){ if ($value_name && is_array($label)){ $value = $label[$value_name]; } if ($label_name && is_array($label)){ $label = $label[$label_name]; } $select = in_array($value, $selected) ? ' selected="selected"' : ''; $html .= ''."\n"; } return $html; } /** * This class provides the templates for owncloud. */ class OC_Template{ private $renderas; // Create a full page? private $application; // template Application private $vars; // Vars private $template; // The path to the template private $l10n; // The l10n-Object private $headers=array(); //custom headers /** * @brief Constructor * @param $app app providing the template * @param $file name of the template file (without suffix) * @param $renderas = ""; produce a full page * @returns 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 = "" ){ // Set the private data $this->renderas = $renderas; $this->application = $app; $this->vars = array(); $this->l10n = OC_L10N::get($app); header('X-Frame-Options: Sameorigin'); header('X-XSS-Protection: 1; mode=block'); header('X-Content-Type-Options: nosniff'); $this->findTemplate($name); } /** * @brief Returns the formfactor extension for current formfactor */ static public function getFormFactorExtension() { $formfactor=$_SESSION['formfactor']; if($formfactor=='default') { $fext=''; }elseif($formfactor=='mobile') { $fext='.mobile'; }elseif($formfactor=='tablet') { $fext='.tablet'; }elseif($formfactor=='standalone') { $fext='.standalone'; }else{ $fext=''; } return $fext; } /** * @brief find the template with the given name * @param $name of the template file (without suffix) * * Will select the template file for the selected theme and formfactor. * Checking all the possible locations. */ protected function findTemplate($name) { // Read the selected theme from the config file $theme=OC_Config::getValue( "theme" ); // Read the detected formfactor and use the right file name. $fext = self::getFormFactorExtension(); $app = $this->application; // Check if it is a app template or not. if( $app != "" ){ // Check if the app is in the app folder or in the root if( file_exists( OC::$APPSROOT."/apps/$app/templates/" )){ // Check if the template is overwritten by the selected theme if ($this->checkPathForTemplate(OC::$SERVERROOT."/themes/$theme/apps/$app/templates/", $name, $fext)) { }elseif ($this->checkPathForTemplate(OC::$APPSROOT."/apps/$app/templates/", $name, $fext)) { } }else{ // Check if the template is overwritten by the selected theme if ($this->checkPathForTemplate(OC::$SERVERROOT."/themes/$theme/$app/templates/", $name, $fext)) { }elseif ($this->checkPathForTemplate(OC::$SERVERROOT."/$app/templates/", $name, $fext)) { }else{ echo('template not found: template:'.$name.' formfactor:'.$fext.' webroot:'.OC::$WEBROOT.' serverroot:'.OC::$SERVERROOT); die(); } } }else{ // Check if the template is overwritten by the selected theme if ($this->checkPathForTemplate(OC::$SERVERROOT."/themes/$theme/core/templates/", $name, $fext)) { } elseif ($this->checkPathForTemplate(OC::$SERVERROOT."/core/templates/", $name, $fext)) { }else{ echo('template not found: template:'.$name.' formfactor:'.$fext.' webroot:'.OC::$WEBROOT.' serverroot:'.OC::$SERVERROOT); die(); } } } /** * @brief check Path For Template with and without $fext * @param $path to check * @param $name of the template file (without suffix) * @param $fext formfactor extension * @return bool true when found * * Will set $this->template and $this->path if there is a template at * the specifief $path */ protected function checkPathForTemplate($path, $name, $fext) { if ($name =='') return false; $template = null; if( is_file( $path.$name.$fext.'.php' )){ $template = $path.$name.$fext.'.php'; }elseif( is_file( $path.$name.'.php' )){ $template = $path.$name.'.php'; } if ($template) { $this->template = $template; $this->path = $path; return true; } return false; } /** * @brief Assign variables * @param $key key * @param $value value * @param $sanitizeHTML false, if data shouldn't get passed through htmlentities * @returns true * * This function assigns a variable. It can be accessed via $_[$key] in * the template. * * If the key existed before, it will be overwritten */ public function assign( $key, $value, $sanitizeHTML=true ){ if(is_array($value) && $sanitizeHTML) { array_walk_recursive($value,'OC_Template::sanitizeHTML'); $this->vars[$key] = $value; return true; } if($sanitizeHTML) { $this->vars[$key] = htmlentities($value, ENT_QUOTES); return true; } $this->vars[$key] = $value; return true; } /** * @brief Internaly used to sanitze HTML * * This function is internally used to sanitize HTML. */ private function sanitizeHTML( &$value ){ $value = htmlentities( $value, ENT_QUOTES ); } /** * @brief Appends a variable * @param $key key * @param $value value * @returns true * * This function assigns a variable in an array context. If the key already * exists, the value will be appended. It can be accessed via * $_[$key][$position] in the template. */ public function append( $key, $value ){ if( array_key_exists( $key, $this->vars )){ $this->vars[$key][] = $value; } else{ $this->vars[$key] = array( $value ); } } /** * @brief Add a custom element to the header * @param string tag tag name of the element * @param array $attributes array of attrobutes 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); } /** * @brief Prints the proceeded template * @returns true/false * * This function proceeds the template and prints its output. */ public function printPage(){ $data = $this->fetchPage(); if( $data === false ){ return false; } else{ print $data; return true; } } /* * @brief append the $file-url if exist at $root * @param $type of collection to use when appending * @param $root path to check * @param $web base for path * @param $file the filename */ public function appendIfExist($type, $root, $web, $file) { if (is_file($root.'/'.$file)) { $pathes = explode('/', $file); if($type == 'cssfiles' && $root == OC::$APPSROOT && $pathes[0] == 'apps'){ $app = $pathes[1]; unset($pathes[0]); unset($pathes[1]); $path = implode('/', $pathes); $this->append( $type, OC_Helper::linkTo($app, $path)); }else{ $this->append( $type, $web.'/'.$file); } return true; } return false; } /** * @brief Proceeds the template * @returns content * * This function proceeds the template. If $this->renderas is set, it * will produce a full page. */ public function fetchPage(){ $data = $this->_fetch(); if( $this->renderas ){ // Decide which page we show if( $this->renderas == "user" ){ $page = new OC_Template( "core", "layout.user" ); $page->assign('searchurl',OC_Helper::linkTo( 'search', 'index.php' )); if(array_search(OC_APP::getCurrentApp(),array('settings','admin','help'))!==false){ $page->assign('bodyid','body-settings'); }else{ $page->assign('bodyid','body-user'); } // Add navigation entry $navigation = OC_App::getNavigation(); $page->assign( "navigation", $navigation); $page->assign( "settingsnavigation", OC_App::getSettingsNavigation()); foreach($navigation as $entry) { if ($entry['active']) { $page->assign( 'application', $entry['name'] ); break; } } }else{ $page = new OC_Template( "core", "layout.guest" ); } // Read the selected theme from the config file $theme=OC_Config::getValue( "theme" ); // Read the detected formfactor and use the right file name. $fext = self::getFormFactorExtension(); $page->assign('jsfiles', array()); // Add the core js files or the js files provided by the selected theme foreach(OC_Util::$scripts as $script){ // Is it in 3rd party? if($page->appendIfExist('jsfiles', OC::$THIRDPARTYROOT, OC::$THIRDPARTYWEBROOT, $script.'.js')) { // Is it in apps and overwritten by the theme? }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/apps/$script$fext.js" )) { }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/apps/$script.js" )) { // Is it part of an app? }elseif($page->appendIfExist('jsfiles', OC::$APPSROOT, OC::$APPSWEBROOT, "apps/$script$fext.js" )) { }elseif($page->appendIfExist('jsfiles', OC::$APPSROOT, OC::$APPSWEBROOT, "apps/$script.js" )) { // Is it in the owncloud root but overwritten by the theme? }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/$script$fext.js" )) { }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/$script.js" )) { // Is it in the owncloud root ? }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "$script$fext.js" )) { }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "$script.js" )) { // Is in core but overwritten by a theme? }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/core/$script$fext.js" )) { }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/core/$script.js" )) { // Is it in core? }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "core/$script$fext.js" )) { }elseif($page->appendIfExist('jsfiles', OC::$SERVERROOT, OC::$WEBROOT, "core/$script.js" )) { }else{ echo('js file not found: script:'.$script.' formfactor:'.$fext.' webroot:'.OC::$WEBROOT.' serverroot:'.OC::$SERVERROOT); die(); } } // Add the css files $page->assign('cssfiles', array()); foreach(OC_Util::$styles as $style){ // is it in 3rdparty? if($page->appendIfExist('cssfiles', OC::$THIRDPARTYROOT, OC::$THIRDPARTYWEBROOT, $style.'.css')) { // or in apps? }elseif($page->appendIfExist('cssfiles', OC::$APPSROOT, OC::$APPSWEBROOT, "apps/$style$fext.css" )) { }elseif($page->appendIfExist('cssfiles', OC::$APPSROOT, OC::$APPSWEBROOT, "apps/$style.css" )) { // or in the owncloud root? }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "$style$fext.css" )) { }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "$style.css" )) { // or in core ? }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "core/$style$fext.css" )) { }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "core/$style.css" )) { }else{ echo('css file not found: style:'.$style.' formfactor:'.$fext.' webroot:'.OC::$WEBROOT.' serverroot:'.OC::$SERVERROOT); die(); } } // Add the theme css files. you can override the default values here if(!empty($theme)) { foreach(OC_Util::$styles as $style){ if($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/apps/$style$fext.css" )) { }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/apps/$style.css" )) { }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/$style$fext.css" )) { }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/$style.css" )) { }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/core/$style$fext.css" )) { }elseif($page->appendIfExist('cssfiles', OC::$SERVERROOT, OC::$WEBROOT, "themes/$theme/core/$style.css" )) { } } } // Add custom headers $page->assign('headers',$this->headers); foreach(OC_Util::$headers as $header){ $page->append('headers',$header); } // Add css files and js files $page->assign( "content", $data ); return $page->fetchPage(); } else{ return $data; } } /** * @brief doing the actual work * @returns content * * Includes the template file, fetches its output */ private function _fetch(){ // Register the variables $_ = $this->vars; $l = $this->l10n; // Execute the template ob_start(); include( $this->template ); // <-- we have to use include because we pass $_! $data = ob_get_contents(); @ob_end_clean(); // return the data return $data; } /** * @brief Include template * @returns returns content of included template * * Includes another template. use inc('template'); ?> to * do this. */ public function inc( $file, $additionalparams = null ){ // $_ erstellen $_ = $this->vars; $l = $this->l10n; if( !is_null($additionalparams)){ $_ = array_merge( $additionalparams, $this->vars ); } // Einbinden ob_start(); include( $this->path.$file.'.php' ); $data = ob_get_contents(); @ob_end_clean(); // Daten zurückgeben return $data; } /** * @brief Shortcut to print a simple page for users * @param $application The application we render the template for * @param $name Name of the template * @param $parameters Parameters for the template * @returns true/false */ 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(); } /** * @brief Shortcut to print a simple page for admins * @param $application The application we render the template for * @param $name Name of the template * @param $parameters Parameters for the template * @returns true/false */ 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(); } /** * @brief Shortcut to print a simple page for guests * @param $application The application we render the template for * @param $name Name of the template * @param $parameters Parameters for the template * @returns true/false */ 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(); } }