[ConvertWords db=xx.db]Any Text[/ConvertWords]
New in 4.0
Changes specified words in a string of text to different words, based on a database of conversions.

To automatically convert certain words into other words, create a database of words to be changed, and put the text to be converted inside a [ConvertWords] context. Any matching words will be changed to corresponding words in the database lookup table.

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

[ConvertWords db=glossary.db]A HTTP request first uses DNS to look up the ip address[/ConvertWords]

The above line of WebDNA would produce the following (given the proper glossary.db):

A Hypertext Transport Protocol request first uses Domain Name System to look up the Internet Protocol address

Here's what the glossary.db file would look like for the example above:

-- glossary.db --
HTTP<tab>Hypertext Transport Protocol
DNS<tab>Dynamic Naming System
ip<tab>Internet Protocol

Anywhere the words in the from column appear in the text, they are replaced with whatever is in the to column. There is no limit to the length text in either the from or to columns. You may put any kind of text into either column; for example, HTML is legal in either column.

 Parameter  Description
(Required) path to conversion database which contains list of "from" and "to" conversions of words to other words
(Optional) T or F to indicate that word comparisons should be case-sensitive or not. Default is F, case-insensitive
(Optional) SS, WW, SW to indicate that words should be matched as SubString, Whole Word, or Start of Word, same as search parameters when matching text in a database

Some handy uses for [ConvertWords] include removing foul language from online message boards, spelling out acronyms, changing nicknames to full names, inserting hyperlinks, and expanding glossary terms. The following conversion database may give you some ideas:

-- conversion.db --
Smith Micro<tab><a href="www.smithmicro.com">Smith Micro Software</a>
support<tab><a href="mailto:support@smithmicro.com">support</a>
logo<tab><img src="companylogo.gif">