]>
src.bluestatic.org Git - isso.git/blob - printer_css.php
2 /*=====================================================================*\
3 || ###################################################################
4 || # Blue Static ISSO Framework [#]issoversion[#]
5 || # Copyright ©2002-[#]year[#] Blue Static
7 || # This program is free software; you can redistribute it and/or modify
8 || # it under the terms of the GNU General Public License as published by
9 || # the Free Software Foundation; version [#]gpl[#] of the License.
11 || # This program is distributed in the hope that it will be useful, but
12 || # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
13 || # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 || # You should have received a copy of the GNU General Public License along
17 || # with this program; if not, write to the Free Software Foundation, Inc.,
18 || # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
19 || ###################################################################
20 \*=====================================================================*/
23 * Printer - CSS Blocks
30 * Printer - CSS Blocks
32 * This framework works in conjunction with ISSO.Printer to create a unique
33 * CSS editor enviornment.
36 * $this->fetch_modified_link_hook - Required hook that is run when
37 * preparing revert links for properties
40 * @copyright Copyright ©2002 - [#]year[#], Blue Static
48 * Framework registry object
51 private $registry = null;
57 private $descriptors = array();
63 private $masterdata = array();
69 private $customdata = array();
72 * Valid properties that can be used in CSS
75 private $properties = array(
76 'background' => 'background',
78 'font-style' => 'font_style',
79 'font-size' => 'font_size',
80 'font-family' => 'font_family',
81 'text-decoration' => 'text_decoration'
85 * Hook ran in fetch_modified_link; takes three params: $descriptor, $property, $name
88 private $fetch_modified_link_hook = ':=NO METHOD=:';
94 private $fields = array(
95 'fetch_modified_link_hook' => array(REQ_YES
, null, false)
98 // ###################################################################
102 public function __construct(&$registry)
104 $this->registry
=& $registry;
107 // ###################################################################
111 * @param string Field name
112 * @param mixed Value of the field
114 public function set($name, $value)
116 $this->registry
->do_set($name, $value, 'printer_css');
119 // ###################################################################
123 * @param string Field name
125 * @return mixed Value of the field
127 public function get($fieldname)
129 return $this->registry
->do_get($fieldname, 'printer_css');
132 // ###################################################################
134 * Adds a CSS information block to the array for later use
136 * @param string Block title to display in thead
137 * @param string CSS class/descriptor/element name
138 * @param bool Show the link CSS information
140 public function add_block($title, $descriptor, $dolink)
142 if (isset($this->descriptors
["$descriptor"]))
144 trigger_error('The descriptor `' . $descriptor . '` already exists');
148 $this->descriptors["$descriptor"] = array(
150 'descriptor' => $descriptor,
155 // ###################################################################
157 * Sets a master data key for a given descriptor and property
159 * @param string Descriptor
160 * @param string Property
161 * @param string Value
163 public function set_master_data($descriptor, $property, $value)
165 $this->masterdata
["$descriptor"]["$property"] = $value;
168 // ###################################################################
170 * Sets a custom data key for a given descriptor and property
172 * @param string Descriptor
173 * @param string Property
174 * @param string Value
176 public function set_custom_data($descriptor, $property, $value)
178 $this->customdata
["$descriptor"]["$property"] = $value;
181 // ###################################################################
183 * Generates the HTML needed to output the CSS editing blocks; this is
184 * done in the form of using ISSO.Printer
186 public function generate_blocks()
188 $print =& $this->registry
->modules
['printer'];
191 'standard_css_attributes' => $this->registry
->modules
['localize']->string('Standard CSS Attributes'),
192 'extra_css_attributes' => $this->registry
->modules
['localize']->string('Extra CSS Attributes'),
194 'links_normal' => $this->registry
->modules
['localize']->string('Normal CSS Links'),
195 'links_visited' => $this->registry
->modules
['localize']->string('Visited CSS Links'),
196 'links_hover' => $this->registry
->modules
['localize']->string('Hover CSS Links'),
198 'background' => $this->registry
->modules
['localize']->string('Background'),
199 'font_color' => $this->registry
->modules
['localize']->string('Font Color'),
200 'font_style' => $this->registry
->modules
['localize']->string('Font Style'),
201 'font_size' => $this->registry
->modules
['localize']->string('Font Size'),
202 'font_family' => $this->registry
->modules
['localize']->string('Font Family'),
204 'text_decoration' => $this->registry
->modules
['localize']->string('Text Decoration'),
206 'css_selector' => $this->registry
->modules
['localize']->string('CSS Selector'),
207 'save_css' => $this->registry
->modules
['localize']->string('Save CSS')
210 foreach ($this->descriptors
AS $descriptor)
215 $desc = $descriptor['descriptor'];
217 $print->table_start();
218 $print->table_head($descriptor['title']);
220 foreach ($this->properties
AS $prop => $name)
222 $value["$name"] = $this->fetch_value($descriptor['descriptor'], $prop);
223 $status["$name"] = $this->fetch_modified_status($descriptor['descriptor'], $prop);
226 $value['extra'] = $this->fetch_value($descriptor['descriptor'], 'extra');
228 $html = "<table cellspacing=\"0\" cellpadding=\"4\" border=\"0\" width=\"100%\">
232 <legend><strong>$lang[standard_css_attributes]</strong></legend>
234 <table cellspacing=\"0\" cellpadding=\"2\" border=\"0\" width=\"100%\">
236 <td width=\"45%\">" . $this->fetch_modified_link($desc, 'background', $lang['background']) . "</td>
237 <td><input name=\"css[$descriptor[descriptor]][background]\" class=\"input\" style=\"width: 100%\" value=\"$value[background]\" /></td>
240 <td width=\"45%\">" . $this->fetch_modified_link($desc, 'color', $lang['font_color']) . "</td>
241 <td><input name=\"css[$descriptor[descriptor]][color]\" class=\"input\" style=\"width: 100%\" value=\"$value[color]\" /></td>
244 <td width=\"45%\">" . $this->fetch_modified_link($desc, 'font-style', $lang['font_style']) . "</td>
245 <td><input name=\"css[$descriptor[descriptor]][font-style]\" class=\"input\" style=\"width: 100%\" value=\"$value[font_style]\" /></td>
248 <td width=\"45%\">" . $this->fetch_modified_link($desc, 'font-size', $lang['font_size']) . "</td>
249 <td><input name=\"css[$descriptor[descriptor]][font-size]\" class=\"input\" style=\"width: 100%\" value=\"$value[font_size]\" /></td>
252 <td width=\"45%\">" . $this->fetch_modified_link($desc, 'font-family', $lang['font_family']) . "</td>
253 <td><input name=\"css[$descriptor[descriptor]][font-family]\" class=\"input\" style=\"width: 100%\" value=\"$value[font_family]\" /></td>
260 <fieldset style=\"height: 115px\">
261 <legend><strong>" . $this->fetch_modified_link($desc, 'extra', $lang['extra_css_attributes']) . "</strong></legend>
262 <textarea name=\"css[$descriptor[descriptor]][extra]\" style=\"width: 100%; height: 90%\">$value[extra]</textarea>
267 if ($descriptor['dolink'])
269 foreach (array('a:link' => 'a_link', 'a:visited' => 'a_visited', 'a:hover' => 'a_hover') AS $sel => $selname)
271 foreach (array('background' => 'background', 'color' => 'color', 'text-decoration' => 'text_decoration') AS $prop => $name)
273 $value["{$selname}_{$name}"] = $this->fetch_value($descriptor['descriptor'] . ' ' . $sel, $prop);
274 $status["{$selname}_{$name}"] = $this->fetch_modified_status($descriptor['descriptor'] . ' ' . $sel, $prop);
280 <table cellspacing=\"0\" cellpadding=\"4\" border=\"0\" width=\"100%\">
284 <legend><strong>$lang[links_normal]</strong></legend>
286 <table cellspacing=\"0\" cellpadding=\"2\" border=\"0\" width=\"100%\">
288 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:link', 'background', $lang['background']) . "</td>
289 <td><input name=\"css[$descriptor[descriptor] a:link][background]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_link_background]\" /></td>
292 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:link', 'color', $lang['font_color']) . "</td>
293 <td><input name=\"css[$descriptor[descriptor] a:link][color]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_link_color]\" /></td>
296 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:link', 'text-decoration', $lang['text_decoration']) . "</td>
297 <td><input name=\"css[$descriptor[descriptor] a:link][text-decoration]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_link_text_decoration]\" /></td>
305 <legend><strong>$lang[links_visited]</strong></legend>
307 <table cellspacing=\"0\" cellpadding=\"2\" border=\"0\" width=\"100%\">
309 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:visited', 'background', $lang['background']) . "</td>
310 <td><input name=\"css[$descriptor[descriptor] a:visited][background]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_visited_background]\" /></td>
313 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:visited', 'color', $lang['font_color']) . "</td>
314 <td><input name=\"css[$descriptor[descriptor] a:visited][color]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_visited_color]\" /></td>
317 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:visited', 'text-decoration', $lang['text_decoration']) . "</td>
318 <td><input name=\"css[$descriptor[descriptor] a:visited][text-decoration]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_visited_text_decoration]\" /></td>
326 <legend><strong>$lang[links_hover]</strong></legend>
328 <table cellspacing=\"0\" cellpadding=\"2\" border=\"0\" width=\"100%\">
330 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:hover', 'background', $lang['background']) . "</td>
331 <td><input name=\"css[$descriptor[descriptor] a:hover][background]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_hover_background]\" /></td>
334 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:hover', 'color', $lang['font_color']) . "</td>
335 <td><input name=\"css[$descriptor[descriptor] a:hover][color]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_hover_color]\" /></td>
338 <td width=\"45%\">" . $this->fetch_modified_link($desc . ' a:hover', 'text-decoration', $lang['text_decoration']) . "</td>
339 <td><input name=\"css[$descriptor[descriptor] a:hover][text-decoration]\" class=\"input\" style=\"width: 100%\" value=\"$value[a_hover_text_decoration]\" /></td>
348 $print->row_span($html, 'alt2', 'left', 1);
351 <div class="alt1" style="border: inset 1px; padding: 2px 5px 2px 5px; float: left">' . $lang['css_selector'] . ': <code>' . $descriptor['descriptor'] . '</code></div>
352 <input type="submit" name="submit" value="' . $lang['save_css'] . '" class="button" />', 'tfoot', 'right', 1);
358 // ###################################################################
360 * Returns the value of a given descriptor and property by comparing
361 * the mater set and custom set then returning the right one
363 * @param string Descriptor
364 * @param string Property
366 * @return string Value of the given property
368 private function fetch_value($descriptor, $property)
370 if (!isset($this->customdata
["$descriptor"]["$property"]))
372 return $this->masterdata
["$descriptor"]["$property"];
376 return $this->customdata
["$descriptor"]["$property"];
380 // ###################################################################
382 * Returns the state modified state (false for untouched and true
383 * for modified) from the descriptor-property value between the master
384 * set and the custom set of data
386 * @param string Descriptor
387 * @param string Property
389 * @return bool Modified from the master value?
391 private function fetch_modified_status($descriptor, $property)
393 if ($this->masterdata
["$descriptor"]["$property"] != $this->customdata
["$descriptor"]["$property"] AND isset($this->customdata
["$descriptor"]["$property"]))
401 // ###################################################################
403 * Fetches a link that shows a revert link for a given property
404 * that uses AJAX to revert when clicked
406 * @param string Descriptor
407 * @param string Property
408 * @param string Nominalized text
410 * @return string Output HTML
412 private function fetch_modified_link($descriptor, $property, $name)
414 $status = $this->fetch_modified_status($descriptor, $property);
418 if (is_callable($this->fetch_modified_link_hook
))
420 return call_user_func($this->fetch_modified_link_hook
, $descriptor, $property, $name);
424 trigger_error('Printer_CSS::fetch_modified_link() needs to have the fetch_modified_link_hook( $descriptor , $property , $name ) defined');
433 // ###################################################################
435 * Generates an array of queries that should be run on your database to
436 * update CSS changes. All of the queries have sprintf() markers that
437 * need to be evaluated:
439 * %1$s - Database table
440 * %2$s - styleid field
441 * %3$s - descriptor field
442 * %4$s - property field
444 * %6$d - Styleid value
446 * @param array Array of user-inputted information to be transformed into queries
448 * @return array Queries that need to be evaluated then ran
450 public function generate_change_query($data)
452 $queries[0] = '--- RESERVED FOR LATER USE ---';
456 foreach ($this->descriptors
AS $descriptor => $opts)
458 $dolink = $opts['dolink'];
462 $loops = array('', ' a:link', ' a:visited', ' a:hover');
469 foreach ($loops AS $sel)
471 foreach ($data["$descriptor$sel"] AS $prop => $value)
473 // the given value matches the master -- no change
474 if ($this->masterdata["$descriptor$sel"]["$prop"] == $value)
478 // the given matches the custom -- no change
479 else if (isset($this->customdata["$descriptor$sel"]["$prop"]) AND $this->customdata["$descriptor$sel"]["$prop"] == $value)
483 // no matching, it's new
486 $value = str_replace('%', '%%', $value);
487 $deletes[] = "%
3\$s
= '" . $this->escape($descriptor . $sel) . "' AND %
4\$s
= '" . $this->escape($prop) . "'";
488 $queries[] = "INSERT INTO %
1\$s (%
2\$s
, %
3\$s
, %
4\$s
, %
5\$s
) VALUES (%
6\$d
, '" . $this->escape($descriptor . $sel) . "', '" . $this->escape($prop) . "', '" . $this->escape($value) . "')";
494 if (sizeof($deletes) < 1)
500 $queries[0] = "DELETE FROM %
1\$s WHERE styleid
= %
6\$d
AND ((" . implode(') OR (', $deletes) . "))";
506 // ###################################################################
508 * Wrapper for $this->registry->modules[ISSO_DB_LAYER]->escape_string()
510 * @param string Unprotected string
512 * @return string Sanitized string
514 private function escape($string)
516 return $this->registry->modules[ISSO_DB_LAYER]->escape_string($string);
519 // ###################################################################
521 * Generates a linkable/usable CSS stylehseet content file; this can
522 * be outputted to the browser
524 * @return string CSS output
526 public function generate_css_output()
530 foreach ($this->descriptors AS $descriptor => $opts)
532 $dolink = $opts['dolink'];
536 $loops = array('', ' a:link', ' a:visited', ' a:hover');
543 foreach ($loops AS $sel)
545 foreach ($this->masterdata["$descriptor$sel"] AS $prop => $value)
547 $data["$descriptor$sel"]["$prop"] = $value;
549 if (is_array($this->customdata
["$descriptor$sel"]))
551 foreach ($this->customdata["$descriptor$sel"] AS $prop => $value)
553 $data["$descriptor$sel"]["$prop"] = $value;
559 $output = '/* CSS Style Sheet (generated by ISSO.Printer.CSS $Revision$) */';
561 foreach ($data AS $selector => $props)
563 $output .= "\n\n$selector\n{";
564 foreach ($props AS $name => $value)
566 if ($name != 'extra' AND $value != '')
568 $output .= str_replace('"', '"', "\n\t$name: $value;");
574 $extra = explode("\n", $this->registry
->modules
['functions']->convert_line_breaks($props['extra']));
576 foreach ($extra AS $prop)
578 $output .= "\n\t$prop";
589 /*=====================================================================*\
590 || ###################################################################
593 || ###################################################################
594 \*=====================================================================*/