MDL-21695 adding help string
[moodle.git] / theme / styles.php
blob4ff9284650cf9c5b9a27d7edb6fa59102700c5ae
1 <?php
3 // This file is part of Moodle - http://moodle.org/
4 //
5 // Moodle is free software: you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License as published by
7 // the Free Software Foundation, either version 3 of the License, or
8 // (at your option) any later version.
9 //
10 // Moodle is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 // GNU General Public License for more details.
15 // You should have received a copy of the GNU General Public License
16 // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
18 /**
19 * This file is responsible for serving the one huge CSS of each theme.
21 * @package moodlecore
22 * @copyright 2009 Petr Skoda (skodak) {@link http://skodak.org}
23 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
27 // we need just the values from config.php and minlib.php
28 define('ABORT_AFTER_CONFIG', true);
29 require('../config.php'); // this stops immediately at the beginning of lib/setup.php
31 $themename = min_optional_param('theme', 'standard', 'SAFEDIR');
32 $type = min_optional_param('type', 'all', 'SAFEDIR');
33 $rev = min_optional_param('rev', 0, 'INT');
35 if (!in_array($type, array('all', 'ie', 'editor', 'plugins', 'parents', 'theme'))) {
36 header('HTTP/1.0 404 not found');
37 die('Theme was not found, sorry.');
40 if (file_exists("$CFG->dirroot/theme/$themename/config.php")) {
41 // exists
42 } else if (!empty($CFG->themedir) and file_exists("$CFG->themedir/$themename/config.php")) {
43 // exists
44 } else {
45 header('HTTP/1.0 404 not found');
46 die('Theme was not found, sorry.');
49 if ($type === 'ie') {
50 send_ie_css($themename, $rev);
53 $candidatesheet = "$CFG->dataroot/cache/theme/$themename/css/$type.css";
55 if (file_exists($candidatesheet)) {
56 if (!empty($_SERVER['HTTP_IF_NONE_MATCH'])) {
57 // we do not actually need to verify the etag value because our files
58 // never change in cache because we increment the rev parameter
59 header('HTTP/1.1 304 Not Modified');
60 die;
62 send_cached_css($candidatesheet, $rev);
65 //=================================================================================
66 // ok, now we need to start normal moodle script, we need to load all libs and $DB
67 define('ABORT_AFTER_CONFIG_CANCEL', true);
69 define('NO_MOODLE_COOKIES', true); // Session not used here
70 define('NO_UPGRADE_CHECK', true); // Ignore upgrade check
72 require("$CFG->dirroot/lib/setup.php");
73 // setup include path
74 set_include_path($CFG->libdir . '/minify/lib' . PATH_SEPARATOR . get_include_path());
75 require_once('Minify.php');
77 $theme = theme_config::load($themename);
79 if ($type === 'editor') {
80 $css = $theme->editor_css_content();
81 store_css($candidatesheet, $css);
82 } else {
83 $css = $theme->css_files();
84 $allfiles = array();
85 foreach ($css as $key=>$value) {
86 $cssfiles = array();
87 foreach($value as $val) {
88 if (is_array($val)) {
89 foreach ($val as $k=>$v) {
90 $cssfiles[] = $v;
92 } else {
93 $cssfiles[] = $val;
96 $cssfile = "$CFG->dataroot/cache/theme/$themename/css/$key.css";
97 store_css($theme, $cssfile, $cssfiles);
98 $allfiles = array_merge($allfiles, $cssfiles);
100 $cssfile = "$CFG->dataroot/cache/theme/$themename/css/all.css";
101 store_css($theme, $cssfile, $allfiles);
103 send_cached_css($candidatesheet, $rev);
105 //=================================================================================
106 //=== utility functions ==
107 // we are not using filelib because we need to fine tune all header
108 // parameters to get the best performance.
110 function store_css(theme_config $theme, $csspath, $cssfiles) {
111 $css = $theme->post_process(minify($cssfiles));
112 check_dir_exists(dirname($csspath), true, true);
113 $fp = fopen($csspath, 'w');
114 fwrite($fp, $css);
115 fclose($fp);
118 function send_ie_css($themename, $rev) {
119 $lifetime = 60*60*24*3;
121 $css = <<<EOF
122 /** Unfortunately IE6/7 does not support more than 4096 selectors in one CSS file, which means we have to use some ugly hacks :-( **/
123 @import url(styles.php?theme=$themename&rev=$rev&type=plugins);
124 @import url(styles.php?theme=$themename&rev=$rev&type=parents);
125 @import url(styles.php?theme=$themename&rev=$rev&type=theme);
127 EOF;
129 header('Etag: '.md5($rev));
130 header('Content-Disposition: inline; filename="styles.php"');
131 header('Last-Modified: '. gmdate('D, d M Y H:i:s', time()) .' GMT');
132 header('Expires: '. gmdate('D, d M Y H:i:s', time() + $lifetime) .' GMT');
133 header('Pragma: ');
134 header('Accept-Ranges: none');
135 header('Content-Type: text/css');
136 header('Content-Length: '.strlen($css));
138 echo $css;
139 die;
142 function send_cached_css($csspath, $rev) {
143 $lifetime = 60*60*24*20;
145 header('Content-Disposition: inline; filename="styles.php"');
146 header('Last-Modified: '. gmdate('D, d M Y H:i:s', filemtime($csspath)) .' GMT');
147 header('Expires: '. gmdate('D, d M Y H:i:s', time() + $lifetime) .' GMT');
148 header('Pragma: ');
149 header('Accept-Ranges: none');
150 header('Content-Type: text/css');
151 if (!min_enable_zlib_compression()) {
152 header('Content-Length: '.filesize($csspath));
155 readfile($csspath);
156 die;
159 function minify($files) {
160 if (0 === stripos(PHP_OS, 'win')) {
161 Minify::setDocRoot(); // IIS may need help
163 Minify::setCache('', true);
165 $options = array(
166 'bubbleCssImports' => false,
167 // Don't gzip content we just want text for storage
168 'encodeOutput' => false,
169 // Maximum age to cache, not used but required
170 'maxAge' => (60*60*24*20),
171 // The files to minify
172 'files' => $files,
173 // Turn orr URI rewriting
174 'rewriteCssUris' => false,
175 // This returns the CSS rather than echoing it for display
176 'quiet' => true
178 $result = Minify::serve('Files', $options);
179 return $result['content'];