application/PageBuilder.php

   1 <?php
   2
   3 /**
   4  * This class is in charge of building the final page.
   5  * (This is basically a wrapper around RainTPL which pre-fills some fields.)
   6  * $p = new PageBuilder();
   7  * $p->assign('myfield','myvalue');
   8  * $p->renderPage('mytemplate');
   9  */
  10 class PageBuilder
  11 {
  12     /**
  13      * @var RainTPL RainTPL instance.
  14      */
  15     private $tpl;
  16
  17     /**
  18      * @var ConfigManager $conf Configuration Manager instance.
  19      */
  20     protected $conf;
  21
  22     /**
  23      * PageBuilder constructor.
  24      * $tpl is initialized at false for lazy loading.
  25      *
  26      * @param ConfigManager $conf Configuration Manager instance (reference).
  27      */
  28     function __construct(&$conf)
  29     {
  30         $this->tpl = false;
  31         $this->conf = $conf;
  32     }
  33
  34     /**
  35      * Initialize all default tpl tags.
  36      */
  37     private function initialize()
  38     {
  39         $this->tpl = new RainTPL();
  40
  41         try {
  42             $version = ApplicationUtils::checkUpdate(
  43                 shaarli_version,
  44                 $this->conf->get('resource.update_check'),
  45                 $this->conf->get('updates.check_updates_interval'),
  46                 $this->conf->get('updates.check_updates'),
  47                 isLoggedIn(),
  48                 $this->conf->get('updates.check_updates_branch')
  49             );
  50             $this->tpl->assign('newVersion', escape($version));
  51             $this->tpl->assign('versionError', '');
  52
  53         } catch (Exception $exc) {
  54             logm($this->conf->get('resource.log'), $_SERVER['REMOTE_ADDR'], $exc->getMessage());
  55             $this->tpl->assign('newVersion', '');
  56             $this->tpl->assign('versionError', escape($exc->getMessage()));
  57         }
  58
  59         $this->tpl->assign('feedurl', escape(index_url($_SERVER)));
  60         $searchcrits = ''; // Search criteria
  61         if (!empty($_GET['searchtags'])) {
  62             $searchcrits .= '&searchtags=' . urlencode($_GET['searchtags']);
  63         }
  64         if (!empty($_GET['searchterm'])) {
  65             $searchcrits .= '&searchterm=' . urlencode($_GET['searchterm']);
  66         }
  67         $this->tpl->assign('searchcrits', $searchcrits);
  68         $this->tpl->assign('source', index_url($_SERVER));
  69         $this->tpl->assign('version', shaarli_version);
  70         $this->tpl->assign('scripturl', index_url($_SERVER));
  71         $this->tpl->assign('privateonly', !empty($_SESSION['privateonly'])); // Show only private links?
  72         $this->tpl->assign('pagetitle', $this->conf->get('general.title', 'Shaarli'));
  73         if ($this->conf->exists('general.header_link')) {
  74             $this->tpl->assign('titleLink', $this->conf->get('general.header_link'));
  75         }
  76         $this->tpl->assign('shaarlititle', $this->conf->get('general.title', 'Shaarli'));
  77         $this->tpl->assign('openshaarli', $this->conf->get('security.open_shaarli', false));
  78         $this->tpl->assign('showatom', $this->conf->get('feed.show_atom', false));
  79         $this->tpl->assign('hide_timestamps', $this->conf->get('privacy.hide_timestamps', false));
  80         if (!empty($GLOBALS['plugin_errors'])) {
  81             $this->tpl->assign('plugin_errors', $GLOBALS['plugin_errors']);
  82         }
  83         $this->tpl->assign('token', getToken($this->conf));
  84         // To be removed with a proper theme configuration.
  85         $this->tpl->assign('conf', $this->conf);
  86     }
  87
  88     /**
  89      * The following assign() method is basically the same as RainTPL (except lazy loading)
  90      *
  91      * @param string $placeholder Template placeholder.
  92      * @param mixed  $value       Value to assign.
  93      */
  94     public function assign($placeholder, $value)
  95     {
  96         if ($this->tpl === false) {
  97             $this->initialize();
  98         }
  99         $this->tpl->assign($placeholder, $value);
 100     }
 101
 102     /**
 103      * Assign an array of data to the template builder.
 104      *
 105      * @param array $data Data to assign.
 106      *
 107      * @return false if invalid data.
 108      */
 109     public function assignAll($data)
 110     {
 111         if ($this->tpl === false) {
 112             $this->initialize();
 113         }
 114
 115         if (empty($data) || !is_array($data)){
 116             return false;
 117         }
 118
 119         foreach ($data as $key => $value) {
 120             $this->assign($key, $value);
 121         }
 122         return true;
 123     }
 124
 125     /**
 126      * Render a specific page (using a template file).
 127      * e.g. $pb->renderPage('picwall');
 128      *
 129      * @param string $page Template filename (without extension).
 130      */
 131     public function renderPage($page)
 132     {
 133         if ($this->tpl === false) {
 134             $this->initialize();
 135         }
 136
 137         $this->tpl->draw($page);
 138     }
 139
 140     /**
 141      * Render a 404 page (uses the template : tpl/404.tpl)
 142      * usage : $PAGE->render404('The link was deleted')
 143      *
 144      * @param string $message A messate to display what is not found
 145      */
 146     public function render404($message = 'The page you are trying to reach does not exist or has been deleted.')
 147     {
 148         header($_SERVER['SERVER_PROTOCOL'] . ' 404 Not Found');
 149         $this->tpl->assign('error_message', $message);
 150         $this->renderPage('404');
 151     }
 152 }