1. jsCacher takes a piece of HTML code that is embraced by the {jscacher}{/jscacher} tags.
   
   
2. the piece of HTML is stored on the WWW server inside pregenerated Javascript file (ie: jsc_0000001.js.php)
   
   
3. the piece of HTML code is replaced by the external Javascript code reference.
   HTTP headers make this external Javascript code remain in the client's cache for quite some time.
   
   
4. Each piece of HTML code has it's unique identifier on which javascript filenames are based.
   The unique identifier is based on the content (crc32 or md5).
   Thus, every change to the piece of cached HTML code forces new cache file generation, keeping the website content seamlessly up-to-date for users.

• [+] You will save your server's bandwidth by significantly cutting the size of HTML that your server sends to users who visit your website more then once in a period of time.
  
  
• [+] Users who use low-bandwidth connection will experience a major speed-up in page loading as they will not download cached parts of the HTML code.
  
  
• [-] Keep in mind that most of search engines and web spiders are unable to download the cached parts of the HTML code as they igore content "injected" by the javascript. If search engines are your concern it's a good idea to enable jsCacher for, say, logged users only.
  
  

• PHP engine
  
  
• SMARTY template engine
  
  
• fairly good understanding of how SMARTY block functions work.
  
  
• basic familiarity with the HTTP protocol would be a plus.
  
  
• a directory inside script's DOCUMENT_ROOT (usually /jscache) in which jsCacher can create cache files.
  
  

• Download the jsCacher SMARTY plugin
  
  
• unzip the block.jscacher.zip file, copy the block.jscacher.php file to the /smarty/plugins directory.
  
  -- OR --
  
  if you don't have access to the /smarty/plugins directory or you simply don't want to mess with it, use the following PHP code to explicitly enable the jsCacher plugin:
  

  <?
  include_once("block.jscacher.php");
  $smarty->register_block("jscacher","smarty_block_jscacher");
  ?>

  
  
• create the /jscache directory inside the website's DOCUMENT_ROOT directory. Make sure that the WWW server's process has permission to create new files there.
  
  

my HEADER
{jscacher}
	my cacheable HTML content my cacheable HTML content
{/jscacher}
my FOOTER

my HEADER
<script src='/jscache/jsc_1826279287.js.php'></script>
my FOOTER

<?
header("Content-Type: application/x-javascript;");
header("Cache-Control: max-age=604800");
header("Expires: ".gmdate("D, d M Y H:i:s", time()+604800)." GMT");
?>
//file generated by JS Cacher
document.write("my cacheable HTML content my cacheable HTML content");

<?
//Enables/disables jsCacher
$GLOBALS['JSCACHER_DISABLE']=false;
 
//jsCacher default settings
$GLOBALS['JSCACHER_DEFAULTS']['charsetConvert'] = "win2iso";
$GLOBALS['JSCACHER_DEFAULTS']['charsetEncoding'] = "iso-8859-2";
$GLOBALS['JSCACHER_DEFAULTS']['cacheMaxAgeTime'] = (3600*24*7);
$GLOBALS['JSCACHER_DEFAULTS']['cacheBaseDir'] = "./jscache";
$GLOBALS['JSCACHER_DEFAULTS']['cacheBaseUrl'] = "/jscache";
?>

• JSCACHER_DISABLE - enables/disables the jsCacher system.
  
  
• charsetConvert - performs content charset conversion before HTML code is cached.
  
  
• charsetEncoding - adds the "content-type charset" header to the JS cachefiles.
  
  
• cacheMaxAgeTime - how long (in sec) the JS files are cached on the client side.
  
  
• cacheBaseDir - base directory where cache files are stored.
  
  
• cacheBaseUrl - base URL where cache files are accessible via HTTP/HTTPS.
  
  

my HEADER
{jscacher}
	Hello World. There are <#loggedUsers#> logged in.
{/jscacher}
my FOOTER