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         $this->tpl->assign('token', getToken($this->conf));
  81         // To be removed with a proper theme configuration.
  82         $this->tpl->assign('conf', $this->conf);
  83     }
  84
  85     /**
  86      * The following assign() method is basically the same as RainTPL (except lazy loading)
  87      *
  88      * @param string $placeholder Template placeholder.
  89      * @param mixed  $value       Value to assign.
  90      */
  91     public function assign($placeholder, $value)
  92     {
  93         if ($this->tpl === false) {
  94             $this->initialize();
  95         }
  96         $this->tpl->assign($placeholder, $value);
  97     }
  98
  99     /**
 100      * Assign an array of data to the template builder.
 101      *
 102      * @param array $data Data to assign.
 103      *
 104      * @return false if invalid data.
 105      */
 106     public function assignAll($data)
 107     {
 108         if ($this->tpl === false) {
 109             $this->initialize();
 110         }
 111
 112         if (empty($data) || !is_array($data)){
 113             return false;
 114         }
 115
 116         foreach ($data as $key => $value) {
 117             $this->assign($key, $value);
 118         }
 119         return true;
 120     }
 121
 122     /**
 123      * Render a specific page (using a template file).
 124      * e.g. $pb->renderPage('picwall');
 125      *
 126      * @param string $page Template filename (without extension).
 127      */
 128     public function renderPage($page)
 129     {
 130         if ($this->tpl === false) {
 131             $this->initialize();
 132         }
 133
 134         $this->tpl->draw($page);
 135     }
 136
 137     /**
 138      * Render a 404 page (uses the template : tpl/404.tpl)
 139      * usage : $PAGE->render404('The link was deleted')
 140      *
 141      * @param string $message A messate to display what is not found
 142      */
 143     public function render404($message = 'The page you are trying to reach does not exist or has been deleted.')
 144     {
 145         header($_SERVER['SERVER_PROTOCOL'] . ' 404 Not Found');
 146         $this->tpl->assign('error_message', $message);
 147         $this->renderPage('404');
 148     }
 149 }