CHANGELOG - cls_fast_template.php

1.6.0 Changes:

$IE_UTF_INCLUDE=true; -  using base href as he should. Set true if IE7 is not working

Rewrite of documentation style, we hope is much more cleaner.

==================================

1.5.3 Changes: 16 August 2007 

Niels Bugge found a bug in rewrite_src_path, in CSS files 
it didnt support the background images style="background:url(...);"

if utf file includes are done, IE is not using base href as he should. 
Set true if IE7 is not working.
var $IE_UTF_INCLUDE=false; (default false)

ereg_replace in one place was left, now is str_replace. We still prefer ereg_replace, 
but seems in many hosting companies are disabled.

function value_defined / if (isset($field{0}) && $field{0}=='.')

function parse_template /  file_get_contents($file_path) : implode("\n", file($file_path));

==================================
1.5.2 Changes: 31 December 2006 

If one of template file (usually page header) contains link to external
style file (like this <link rel="STYLESHEET" type="text/css" href="st.css">)
teplate parser returns HTML gererated with an error.
Live example <link rel="STYLESHEET" type="text/css" href="st.css" st.css>

Removed because it deletes newline in textareas.
TX to Martin Fasani
$template = ereg_replace("([\n]+)", "\n", $template);

var $CACHE_PATH =   '/tmp'; instead of var $CACHE_PATH =   './tmp';

some other small corrections.

==================================
1.5.1 Changes: 6 June 2006 

In the script ' was used instead of \” for the html code which made the javascript crash (FireFox 1.5.0.4)

==================================
1.5.0 Changes: 31 May 2006 

Documentation now is in DOCS folder, we hope better documented.

function rewrite_link_href_callback

function rewrite_src_path - Rewrite js, css, and img src from template to a
custom path

function set_output_rewrite_src_path - Rewrite all src="template_path/file"
found in the document, very helpful when you want to edit the work template 
in a visual editor without any connection to the script path that will 
summon the work template output content.

function pre_filter - very helpful when we want to run some filter before
the template being parsed

FastWrite and FastPrint improved

Anyway, there are a lot of improvements, documented in the DOCS folder.
Please review it.
Also, we have included 1.3.0 to have the possibility to view a DIFF.

==================================
1.3.0 Changes: 24 March 2005 

Added DELETE_CACHE function, to delete files what is older then expire time.

Added file extension to cache for example now a cache file name will be 
62327a34b389dca70c7c15e9d81e57bd.ft (notice the extension .ft) This was
necessary because of DELETE_CAHCE function

Added include block which include another template by statement (like SSI do)
<!--#include file="include2.html"-->
It is usefull if you have several different templates for different parts of 
page and you dont need to write any php code to gather all "blocks" of the page.
Also is very helpfull from designer point of view, he will see in a visual editor te result.

==================================
1.2.0 Changes: 18 January 2005 

Added FastTemplate::parse_and_return($template_name) method. Parse template and return it as string
Can be used instead FastTemplate::parse() && FastTemplate::fetch

Added FastTemplate::get_root() method. Returns root template dir. Use this method insted 
direct access to FastTemplate::ROOT variable to follow OOP paradigm

Added templates comments. Smth like {* This is a comment *} This will be parsed and
get out from final page.

Added support for inline dynamic blocks.
In this new way, now lines are parsed and if needed, then will be corrected to put it
new lines, to avoid errors <!-- BEGIN or END -->.

Added support for access object fields using get() or getId() methods from templates
(For ex. {Object.field} = Object->get('field')  && {Object.id} = Object->getId() )
It is something like using JavaBeans in JSP

New FastTemplate::define() - now supports array and name and value as parameter

Added FastTemplate::assign_from_array($array, $keys)
Assign template variables from assoc. array with same name.  For ex.
FastTemplate::assign_from_array($_SERVER, array('SERVER_NAME','QUERY_SRING'));

==================================
1.1.9 Changes: 28 December 2004 

var $CACHING = ""; was added, missed in 1.1.8

FastWrite function was modified, added an IF for empty templates.

function setCacheTime($time), this will overwrite cache defined in 
var $UPDT_TIME  =   '60'; Usage is now 
// ex. CACHE will be used
$ft->setCacheTime(300);
$ft->USE_CACHE();
So for example in some pages you want to use default value, 60 second,
but on the other page you want 300 seconds.

function self_script was modified, $fname = $_SERVER['REQUEST_URI'];
ex: http://yourdomain.com/products.php?id=13 was ok, but
http://yourdomain.com/products.php/productname/13/ cached same page.
Now cache is working right.
      
Some ereg_replace was left and changed to str_replace

Other minor cosmetics on source

==================================
1.1.8 Changes: 3 November 2004 

FastWrite function was cleaned up. In some cases not worked.

ereg_replace for some unknown reason was uncommented in 1.1.7, now is OK again.
// $template = ereg_replace("{([A-Z0-9_]+)}","",$template);
$template = str_replace("{([A-Z0-9_]+)}","",$template); // GRAFX

==================================
1.1.7 Changes: 12 August 2004 

function self_script () was improved by P Pavlovic ppavlovic@mail.ru
Problem with current function is that ignores GET parameters and it 
serves same cached page for different GET parameters. With this modification,
this problem is overcomed.

Set internal character encoding to UTF-8. We added a header which make that 
every header to be transofrmed into UTF-8. This is not a Fast Template function, 
but help to send in all files a header and is work very well. 
We are looking for testers!!! If you don't want this features, uncomment this line
header("Content-Type: text/html; charset=UTF-8"); 

var $CACHE_PATH =   './cache'; was renamed to var $CACHE_PATH =   './tmp';

==================================
1.1.6 Changes: 29 April 2004 

get_magic_quotes_gpc() problem on some servers are fixed. Seems that some 
servers not read magic quotes correcttly and template files are messed up.

==================================
1.1.5 Changes: 8 March 2004 

Allyson Francisco de Paula Reis came out with some improvements on cache function. 
Wilfried Trinkl added Fast Write function, usefull when you want to write to a file. 
Some clean-up on examples and on FastWrite and Language Assign new examples. 

==================================
1.1.4 Changes: 18 February 2004 

We have found an older modification of Allyson Francisco de Paula Reis, 
who added "Cache functions". We merge into our version. 

==================================
1.1.3 Changes: 05 January 2004 

used str_replace instead of ereg_replace, this latest is not installed 
on a lot of servers and give out error.

added Pattern Assign - when variables or constants are the same as the 
template keys, these functions may be used as they are. Using these 
functions, can help you reduce the number of the assign functions in the 
php files, very useful for language files

Changed back to .html files all .tpl, is more easier to edit to dummy users. 

Renamed class.FastTemplate.php3 to cls_fast_template.php 

modified debug module to Level 1 is showing all info + added WARNINGS, 
Level 2 will popup the window only if WARNINGS are present, very helpfull 
only when you want to see BUGS on your page

==================================
1.1.2 Changes: 06 July 2002 - Added debug console, silient removal 
of not-assigned dynamic blocks, ability of including php code into 
templates 

==================================
1.1.1 Changes: 24 April 2002 - Adopted for PHP4 

==================================
1.1.0 Changes: Jun 27 1999  13:32:00

	This is a major update. Version jump due to finally getting my code
	converted over to CVS.

	Added clear_dynamic():
		Ran into a few instances where a dynamic block was not going to be
		used, so now there's a way to remove it from a template.

	Added get_assigned(): Christian Brandel cbrandel@gmx.de
		Returns the value of a variable previously set using assign(), if
		any.

	Modified FastPrint():
		FastPrint would have been an illegal construct in PHP4/Zend. Fixed. 
		Personal Note: I don't have access to the PHP4 beta even though I've
		asked repeatedly, so pardon me if I get a bit irritated when I'm
		told that what I write would be a "Bug" in something that doesn't
		exist yet, I don't have access to, isn't in public use yet, and I
		can't test my code against.

		The next PHP4 Beta user that sends me a "bug report" had better be
		wearing asbestos underwear.

	Modified assign(): (numerous)
		You can now assign(BLAH,"") and get away with it. (Empty values for
		a key outside of an array context)

	Modified is_safe():
		It now just checks to be sure the template file exists. All of the
		other file checks have been ditched. (Speed speed speed, that's all
		I want damn it! :)

	Modified set_root(): 
		I ditched the regexes used here in favor of substr() and ord()
		and chr() calls. It's faster and much more accurate. See below as to
		why this was done.

	Modified get_template():
		Speed tweek. implode( file() ) is faster than the combined fopen(),
		fread( filesize() ), fclose()

		****************************************************
		****   WARNING WARNING WARNING WARNING WARNING	****
		****    POSSIBLE CONFLICT IN OLDER TEMPLATES	****
		****************************************************

	Modified parse_dynamic(): Chad Cunningham, ccunning@math.ohio-state.edu
		Now allows arbitrary whitespace before and after the beginning of
		the <!-- BEGIN DYNAMIC BLOCK tags.  This may cause problems in
		existing templates!  The only allowed text on the line is the BEGIN
		and END syntax! If there's =anything= else on the line other than
		whitespace, it'll fail.

	Modified (template wide) regex use:

	I went on a regex rampage. Regular Expressions are expensive and the
	more you use them the slower your program becomes. I've been weak and
	have been using regular expressions where they really weren't needed. To
	increase processing speed, whenever possible, all regular expressions
	have been ditched.  This affects set_root, parse_dynamic, clear_dynamic,
	and parse.  (Basically, all the routines that make this class work :-)

	The major change was in the parse_dynamic() routine.  This used two
	regular expressions for every line of every template.  That was way too
	expensive. Those two regex calls have since been replaced with a single
	trim() on each line of the template. This greatly increases dynamic
	template parsing speed.

	The crude benchmark I set up shows that the change was definitely worth
	it, with  10% to 20% speed increases.

	Removed a few useless escapes from most of the regex's. (numerous)

	Once again, I tried to replace as many regexes as possible with
	str_replace().  Once again, no matter what build I use, str_replace
	randomly core dumps the httpd process. (3.0.0, 3.0.5, 3.0.6, 3.0.7) I
	left the lines there, just search for str_replace in the code and change
	the comments if you want to try using str_replace. I'd love to hear if
	someone has a build of PHP where this doesn't core dump Apache.


==================================
0.8 Changes: Apr 03 1999  08:00:00

	Maintenance released. Fixed a few typos that snuck into the last
	revision. (Mostly in areas I couldn't test, like WIN32 stuff)

==================================
0.7	Changes:

	Added define_dynamic() and parse_dynamic(). (parse_dynamic() is an
	internal method, if you call it you bought it.) See the man page for
	more information on define_dynamic().

==================================
0.6	Changes: (never released)

	Fixed a minor bug in the set_root() when used on a WIN32 box.

	Removed most of the fatal exits from calls to error(). The class will
	only exit if the get_template() method fails to load a template file.

==================================
0.5	Initial Public Release 1999/21/01 19:09:00