Developing ColdFusion Applications
Building Custom CFXAPI Tags

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.

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).

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:

1. 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."
   

2. 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:

1. 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"
   

2. In the install script, import the registry entry by including the following command in the install script:

   regedit importfilename
   

Copyright © 2001, Macromedia Inc. All rights reserved.

LiveDocs comments are not longer enabled for ColdFusion 5.0. Please use one of the following resources instead.

ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 5.0