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