Distributing CFX Tags

If you are distributing a custom tag, you can automatically register it during the setup process by writing the registration entries directly into the registry. The following table lists the registry entries.

The following table lists the registry entries for Java:

Entry

Value

Hive
HKEY_LOCAL_MACHINE

Key
SOFTWARE\Allaire\ColdFusion\CurrentVersion\CustomTags\ TagName

ClassName
The name of the class to call.

Description
A description of the tag's functionality for browsing by end users.

Entry	Value
Hive	`HKEY_LOCAL_MACHINE`
Key	`SOFTWARE\Allaire\ColdFusion\CurrentVersion\CustomTags\` TagName
ClassName	The name of the class to call.
Description	A description of the tag's functionality for browsing by end users.

The following table lists the registry entries for C++:

Entry

Value

Hive
HKEY_LOCAL_MACHINE

Key
SOFTWARE\Allaire\ColdFusion\CurrentVersion\CustomTags\TagName

LibraryPath
The full path to the DLL (Windows NT) or shared object (UNIX) that implements the custom tag.

ProcedureName
The name of the procedure to call for processing tag requests.

Description
A description of the tag's functionality for browsing by end users.

CacheLibrary
Indicates whether to keep the DLL or shared object loaded in RAM (1 or 0).

Entry	Value
Hive	`HKEY_LOCAL_MACHINE`
Key	`SOFTWARE\Allaire\ColdFusion\CurrentVersion\CustomTags\`TagName
LibraryPath	The full path to the DLL (Windows NT) or shared object (UNIX) that implements the custom tag.
ProcedureName	The name of the procedure to call for processing tag requests.
Description	A description of the tag's functionality for browsing by end users.
CacheLibrary	Indicates whether to keep the DLL or shared object loaded in RAM (1 or 0).

You can create a file containing this information by using the Windows Regedit utility to export the registry entry from a machine on which the custom tag is already installed.

On Windows NT, use Regedit to import custom tags to the registry. On UNIX you must edit the registry data file, located in /opt/coldfusion/registry/cf.registry.

To import a Java custom tag:

Export the custom tag's registry entry by using the Regedit utility. This creates a file similar to the following:

REGEDIT4



[HKEY_LOCAL_MACHINE\SOFTWARE\Allaire\ColdFusion\CurrentVersion\ CustomTags\CFX_TEST]

"ClassName"="ProcessTagRequest"

"Description"="Sample CFX tag."

In the install script, import the registry entry by including the following command in the install script:
```
regedit importfilename
```

To import a C++ custom tag:

Export the custom tag's registry entry by using the Regedit utility. This creates a file similar to the following:

REGEDIT4



[HKEY_LOCAL_MACHINE\SOFTWARE\Allaire\ColdFusion\CurrentVersion\ CustomTags\CFX_TEST]

"LibraryPath"="C:\\cfusion\\cfx\\CFX_TEST\\test.dll"

"ProcedureName"="ProcessTagRequest"

"Description"="Sample CFX tag."

"CacheLibrary"="1"

In the install script, import the registry entry by including the following command in the install script:
```
regedit importfilename
```

Developing ColdFusion Applications
Building Custom CFXAPI Tags