Article Index

An overlooked new feature of the DNN 4.6+ releases is the ability to add tokens to the text/html module. This has been a long awaited feature that will finally allow you to add personalization to your content.

Thanks to Mitchell Sellers for bringing  this enhancement to my attention.

Minimum Version and Enabling

First of all this function is ONLY supported with Text/HTML version 4.06.00, this comes packaged with DotNetNuke version 4.6.0.  If you are upgrading to 4.6.0 you will want to be sure that this upgrade is installed.  (It might not be installed if you used the upgrade package).  By default the support for tokens is disabled so you will need to enable it on a per instance basis.  You can access the token processing settings via the "Settings" option from the module's action menu, below is a screencapture of the settings available.

As Mitchell points out, the available options you are given three distinct options for token replacement support.  The default option of "no replace" will result in a module that functions just like all previous versions of the module.  The use of ANY other setting will result in module caching and inline editing being disabled.  This is done because since tokens are used it cannot rely on the caching to display appropriate information.

Using Tokens

Using these tokens is quite easy. Anyone that has had experience using XMod constants or using the Ventrian products should be quite used to working with tokens. As an example, if you want to show the portal name, you would use Portal:PortalName]. If you want to personalize a home page greeting, you coud use [User:Username|Welcome {0}!] . Optional formating can be added by using the | (pipe bar character) after the initaial token. 

The information after the word welcome is a placeholder that informs the module where the token should be placed in the sentence structure.  The {0} tells the token engine to put the value for that token in for that value.

Below is a list of the current available tokens that you can use on your DNN site:

For date/time and numeric values, you can also append a <format> string defined by the .Net framework, for example: [DateTime:Now|<format>] current date/time formatted according to <format>, e. g. [DateTime:Now|f] displays current date in short format (does not apply to expressions of calculated columns)