CFX_TIMESTAMP File date modification Copyright Albedo Systems Ltd 2001 http://www.albedo.co.uk/ 14 January 2001 CONTENTS Summary Conditions of use Installation Usage Other tags from Albedo Legal disclaimer SUMMARY CFX_TIMESTAMP is a Windows 95/98/NT tag that allows you to change the creation and modification dates of individual files on the server from Cold Fusion. (It was written to make freer use of the date spanning search capabilities of a popular site search engine. Our thanks to Tony Sellen for the inspiration here.) CONDITIONS CFX_TIMESTAMP is freeware. As such, it may be freely distributed in the form of this zip file, provided this readme file is retained. All technical queries, bug reports etc. with regard to its use should be addressed to admin@albedo.co.uk. We'd, of course, appreciate it if you credited us/linked to us, but you know you don't have to. We'll be doing more stuff soon, so please do drop by our website at http://www.albedo.co.uk/ For more information on Cold Fusion itself and other custom tags, check out Allaire's site at http://www.allaire.com/. INSTALLATION The zip file that contains this file should contain: readme.htm: this file (plus some optional graphics). readme.txt: text version of this file cfx_timestamp.dll: the Cold Fusion extension dll To get started, decide, or get your server admin person to decide, where you are going to put extension Cold Fusion tags on your server, then put CFX_TIMESTAMP.dll in that directory. Then fire up the Cold Fusion administrator program - With Cold Fusion 2 on O'Reilly Website, it's called cfmadm20.exe in website/cfusion/bin. Cold Fusion 3 uses a different method - the administrator program is itself written in Cold Fusion, and is in website/cfide/administrator. Click on the 'cfx tags' tab or button, then click on Add. Enter your chosen name (we recommend CFX_TIMESTAMP), and make sure the library is not persistent in memory. USAGE Here's an example, with all the attributes on separate lines to make it clear... (Bear in mind that not all of these parameters are mandatory). <CFX_TIMESTAMP FILENAME="C:\WEBSITES\MYSITE\MYFILE.HTM" CREATION_DATE="04/03/1998" CREATION_TIME="14:12:00" MOD_DATE="11/04/1999" MOD_TIME="18:12:00" FORMAT="DD/MM/YYYY" > ...and the tag returns a Cold Fusion variable, #result_code#, which will be 0 if the process is successful, 1 if not. NOTES: The parameters should be self-explanatory, with the exception of FORMAT - this allows for transatlantic differences and only takes two possibilities, "dd/mm/yyyy" or "mm/dd/yyyy" (upper or lower case) - if omitted, this parameter defaults to European standard. If you wish to change Creation and/or Modification dates, you must include both date *and* time. Perhaps this will change in a later version. If Creation date/time and/or Modification date/time are omitted, they will not be changed, so you can change one or the other as you wish. The separators (above, "/" for date and ":" for time) can be any character you wish. It should be noted that the tag is fairly unforgiving and contains little validation, so check your date formats carefully before doing a big batch run. OTHER ALBEDO TAGS If you liked this, check out our CFX_FONT tag, downloadable from http://www.albedo.co.uk/goodies/cfusion.cfm. It allows you to create masses of anti-aliased text graphics and has oodles of options. Use and enjoy. Fin Fahey Fiona Daly LEGAL DISCLAIMER Neither Albedo Systems Ltd. nor anyone else who has been involved in the creation, production or delivery of this product shall be liable for any direct, indirect, consequential or incidental damages (including damages for loss of business profits, business interruption, loss of business information, and the like) arising out of the use or inability to use this product even if Albedo Systems Ltd. has been advised of the possibility of such damages.