phpmyadmin/libraries/Scripts.class.php

   1 <?php
   2 /* vim: set expandtab sw=4 ts=4 sts=4: */
   3 /**
   4  * JavaScript management
   5  *
   6  * @package PhpMyAdmin
   7  */
   8 if (! defined('PHPMYADMIN')) {
   9     exit;
  10 }
  11
  12 /**
  13  * Collects information about which JavaScript
  14  * files and objects are necessary to render
  15  * the page and generates the relevant code.
  16  *
  17  * @package PhpMyAdmin
  18  */
  19 class PMA_Scripts
  20 {
  21     /**
  22      * An array of SCRIPT tags
  23      *
  24      * @access private
  25      * @var array of strings
  26      */
  27     private $_files;
  28     /**
  29      * An array of discrete javascript code snippets
  30      *
  31      * @access private
  32      * @var array of strings
  33      */
  34     private $_code;
  35     /**
  36      * An array of event names to bind and javascript code
  37      * snippets to fire for the corresponding events
  38      *
  39      * @access private
  40      * @var array
  41      */
  42     private $_events;
  43
  44     /**
  45      * Returns HTML code to include javascript file.
  46      *
  47      * @param array $files The list of js file to include
  48      *
  49      * @return string HTML code for javascript inclusion.
  50      */
  51     private function _includeFiles($files)
  52     {
  53         $first_dynamic_scripts = "";
  54         $dynamic_scripts = "";
  55         $scripts = array();
  56         $separator = PMA_URL_getArgSeparator();
  57         foreach ($files as $value) {
  58             if (/*overload*/mb_strpos($value['filename'], "?") !== false) {
  59                 $file_name = $value['filename'] . $separator
  60                     . PMA_Header::getVersionParameter();
  61                 if ($value['before_statics'] === true) {
  62                     $first_dynamic_scripts
  63                         .= "<script data-cfasync='false' type='text/javascript' "
  64                         . "src='js/" . $file_name . "'></script>";
  65                 } else {
  66                     $dynamic_scripts .= "<script data-cfasync='false' "
  67                         . "type='text/javascript' src='js/" . $file_name
  68                         . "'></script>";
  69                 }
  70                 continue;
  71             }
  72             $include = true;
  73             if ($value['conditional_ie'] !== false
  74                 && PMA_USR_BROWSER_AGENT === 'IE'
  75             ) {
  76                 if ($value['conditional_ie'] === true) {
  77                     $include = true;
  78                 } else if ($value['conditional_ie'] == PMA_USR_BROWSER_VER) {
  79                     $include = true;
  80                 } else {
  81                     $include = false;
  82                 }
  83             }
  84             if ($include) {
  85                 $scripts[] = "scripts%5B%5D=" . $value['filename'];
  86             }
  87         }
  88         $separator = PMA_URL_getArgSeparator();
  89         $static_scripts = '';
  90         // Using chunks of 20 files to avoid too long URLs
  91         $script_chunks = array_chunk($scripts, 20);
  92         foreach ($script_chunks as $script_chunk) {
  93             $url = 'js/get_scripts.js.php?'
  94                 . implode($separator, $script_chunk)
  95                 . $separator . PMA_Header::getVersionParameter();
  96
  97             $static_scripts .= sprintf(
  98                 '<script data-cfasync="false" type="text/javascript" src="%s"></script>',
  99                 htmlspecialchars($url)
 100             );
 101         }
 102         return $first_dynamic_scripts . $static_scripts . $dynamic_scripts;
 103     }
 104
 105     /**
 106      * Generates new PMA_Scripts objects
 107      *
 108      */
 109     public function __construct()
 110     {
 111         $this->_files  = array();
 112         $this->_code   = '';
 113         $this->_events = array();
 114
 115     }
 116
 117     /**
 118      * Adds a new file to the list of scripts
 119      *
 120      * @param string $filename       The name of the file to include
 121      * @param bool   $conditional_ie Whether to wrap the script tag in
 122      *                               conditional comments for IE
 123      * @param bool   $before_statics Whether this dynamic script should be
 124      *                               included before the static ones
 125      *
 126      * @return void
 127      */
 128     public function addFile(
 129         $filename,
 130         $conditional_ie = false,
 131         $before_statics = false
 132     ) {
 133         $hash = md5($filename);
 134         if (!empty($this->_files[$hash])) {
 135             return;
 136         }
 137
 138         $has_onload = $this->_eventBlacklist($filename);
 139         $this->_files[$hash] = array(
 140             'has_onload' => $has_onload,
 141             'filename' => $filename,
 142             'conditional_ie' => $conditional_ie,
 143             'before_statics' => $before_statics
 144         );
 145     }
 146
 147     /**
 148      * Add new files to the list of scripts
 149      *
 150      * @param array $filelist       The array of file names
 151      * @param bool  $conditional_ie Whether to wrap the script tag in
 152      *                              conditional comments for IE
 153      *
 154      * @return void
 155      */
 156     public function addFiles($filelist, $conditional_ie = false)
 157     {
 158         foreach ($filelist as $filename) {
 159             $this->addFile($filename, $conditional_ie);
 160         }
 161     }
 162
 163     /**
 164      * Determines whether to fire up an onload event for a file
 165      *
 166      * @param string $filename The name of the file to be checked
 167      *                         against the blacklist
 168      *
 169      * @return int 1 to fire up the event, 0 not to
 170      */
 171     private function _eventBlacklist($filename)
 172     {
 173         if (strpos($filename, 'jquery') !== false
 174             || strpos($filename, 'codemirror') !== false
 175             || strpos($filename, 'messages.php') !== false
 176             || strpos($filename, 'ajax.js') !== false
 177             || strpos($filename, 'get_image.js.php') !== false
 178             || strpos($filename, 'cross_framing_protection.js') !== false
 179         ) {
 180             return 0;
 181         }
 182
 183         return 1;
 184     }
 185
 186     /**
 187      * Adds a new code snippet to the code to be executed
 188      *
 189      * @param string $code The JS code to be added
 190      *
 191      * @return void
 192      */
 193     public function addCode($code)
 194     {
 195         $this->_code .= "$code\n";
 196     }
 197
 198     /**
 199      * Adds a new event to the list of events
 200      *
 201      * @param string $event    The name of the event to register
 202      * @param string $function The code to execute when the event fires
 203      *                         E.g: 'function () { doSomething(); }'
 204      *                         or 'doSomething'
 205      *
 206      * @return void
 207      */
 208     public function addEvent($event, $function)
 209     {
 210         $this->_events[] = array(
 211             'event' => $event,
 212             'function' => $function
 213         );
 214     }
 215
 216     /**
 217      * Returns a list with filenames and a flag to indicate
 218      * whether to register onload events for this file
 219      *
 220      * @return array
 221      */
 222     public function getFiles()
 223     {
 224         $retval = array();
 225         foreach ($this->_files as $file) {
 226             //If filename contains a "?", continue.
 227             if (strpos($file['filename'], "?") !== false) {
 228                 continue;
 229             }
 230
 231             if (! $file['conditional_ie'] || PMA_USR_BROWSER_AGENT == 'IE') {
 232                 $retval[] = array(
 233                     'name' => $file['filename'],
 234                     'fire' => $file['has_onload']
 235                 );
 236             }
 237         }
 238         return $retval;
 239     }
 240
 241     /**
 242      * Renders all the JavaScript file inclusions, code and events
 243      *
 244      * @return string
 245      */
 246     public function getDisplay()
 247     {
 248         $retval = '';
 249
 250         if (count($this->_files) > 0) {
 251             $retval .= $this->_includeFiles(
 252                 $this->_files
 253             );
 254         }
 255
 256         $code = 'AJAX.scriptHandler';
 257         foreach ($this->_files as $file) {
 258             $code .= sprintf(
 259                 '.add("%s",%d)',
 260                 PMA_escapeJsString($file['filename']),
 261                 $file['has_onload'] ? 1 : 0
 262             );
 263         }
 264         $code .= ';';
 265         $this->addCode($code);
 266
 267         $code = '$(function() {';
 268         foreach ($this->_files as $file) {
 269             if ($file['has_onload']) {
 270                 $code .= 'AJAX.fireOnload("';
 271                 $code .= PMA_escapeJsString($file['filename']);
 272                 $code .= '");';
 273             }
 274         }
 275         $code .= '});';
 276         $this->addCode($code);
 277
 278         $retval .= '<script data-cfasync="false" type="text/javascript">';
 279         $retval .= "// <![CDATA[\n";
 280         $retval .= $this->_code;
 281         foreach ($this->_events as $js_event) {
 282             $retval .= sprintf(
 283                 "$(window).bind('%s', %s);\n",
 284                 $js_event['event'],
 285                 $js_event['function']
 286             );
 287         }
 288         $retval .= '// ]]>';
 289         $retval .= '</script>';
 290
 291         return $retval;
 292     }
 293 }