The Logger Product

 The Logger product allows sending messages to Zope's Log system from
 DTML. For example::

   <dtml-log>Log this mesage!</dtml-log>

   <dtml-log severity=INFO subsystem=MyApp>
      This is some logged text!
   <dtml-logdetail>
     This is the detail section of the log.
     See doc/LOGGING.txt for details.
   </dtml-log>

   <dtml-log severity=blather>Current namespace: <dtml-var id></dtml-log>

 Severity is case insensitive, and can be one of::
   
  BLATHER - Somebody shut this app up.
  INFO    - For things like startup and shutdown.
  PROBLEM - This isn't causing any immediate problems, but deserves attention.
  WARNING - A wishy-washy alias for PROBLEM.
  ERROR   - This is going to have adverse effects.
  PANIC   - We're dead!

 Subsystem can be any string of your choosing.

 Note that depending on your current Zope logging system, some parameters
 may not be used and low severity messages may be silently dropped.  
 For example, when using Syslog logging as documented in doc/LOGGING.txt, 
 the subsytem parameter and the logdetail messages appear to have no effect, 
 and BLATHER severity messages are dropped.

Security Concerns

 Using this product could open your site up to a denial of service attack.
 A user with the rights to add DTML code to your Zope installation could
 easily spam your logging system. This could have all sorts of wierd
 effects depending on your installation, but I doubt they would be desirable
 effects.

 Note that these concerns are also true of other DTML tags, such as
 &LT;dtml-sendmail&GT;

Transactions

 Even if a Zope transaction is aborted, log tags that have already been
 parsed will have been sent to the Logging system and will not be rolled
 back. This is desirable, as it makes this tag useful for debugging
 DTML code. 

Author, Licence & Disclaimer

 This software was written by Stuart 'Zen' Bishop <zen@cs.rmit.edu.au>
 11 Oct 1999 and is released as Open Source. Sending T-Shirts to the author 
 is greatly encouraged. The author makes no promises as to the suitability
 of this software for any purpose whatsoever and can not be held liable
 for any direct or indirect effects of its use, including but not limited
 to spontaneous human combustion.

