[WriteFile FileName]Text[/WriteFile]

Writes the specified text to a file, replacing any previous text.

To write text to an arbitrary text file, put a [WriteFile] context into a template. WriteFile creates a new file if one does not exist already, and erases any existing text if the file was already there. The file should not be a database file that WebCatalog currently has open. See [AppendFile].

Note: WriteFile does not 'understand' databases. If you want to write a new record to the end of a database, use Append instead.

Example (normally you would put the following text into a .tpl file on your server and use a web browser to link to it):

[WriteFile SomeTextFile]Hello, my name is Grant. The time is [time]
This is a second line[/WriteFile]

Try It!

The text file "SomeTextFile" is created and opened, and the text

Hello, my name is Grant. The time is 13:43:01
This is a second line

is written to the file. Notice that carriage returns inside the context are written to the file exactly as they appear. Also notice that any WebCatalog [xxx] tags inside the context are substituted for their real values before being written to the file. You may specify a full or partial URL to the file, as in "/Some Folder/file.txt" or "LocalFolder/file.txt".

Security Note: By default, all files created by WebCatalog are tagged with a special code that tells WebSTAR not to display them via URL. If you want files to be visible to outside browsers, use the optional settings below.

Parameter Description

secure

"T" for files that should be secure -- WebSTAR won't display them
"F" for files that should be visible via URL -- WebSTAR will display them
Example: [WriteFile secure=F&file=SomeFile]...[/WriteFile]

file

When you use the secure option above, you must also provide the name (or URL path) of the file to create.