TEXT Theme Object Introduction
DNN Version: 09.02.00
10/02/2024 • 3 minutes to read
Contributors
10/02/2024
• 3 minutes to read
• Contributors
Displays Localized text in your theme / skin, also supports the use of DNN Core Token replacement.
The text will be loaded from a resource file (*.resx), you need a separate resx file per language.
These should be located in a folder named "App_LocalResources" (in the Theme folder).
Naming convention:
When your skin file = index.ascx: Default language: index.ascx.resx French: index.ascx.fr-FR.resx German: index.ascx.de-DE.resx
Resource file content:
<?xml version="1.0" encoding="utf-8"?>
<root>
<data name="Welcome.Text">
<value>Welcome</value>
</data>
</root>
Current Version: 01.00.00
Include in Theme
ASCX
<%@ Register TagPrefix="dnn" TagName="TEXT" Src="~/Admin/Skins/Text.ascx" %>
<dnn:TEXT runat="server" id="dnnTEXT-Welcome" ShowText="Welcome, " ResourceKey="Welcome.Text" ReplaceTokens="False" />
HTML Token
[TEXT]
HTML Object Token
<object id="dnnTEXT" codetype="dotnetnuke/server" codebase="TEXT"></object>
| Attribute | Description | Default | Posssible Values | DNN Version |
|---|---|---|---|---|
| ShowText | The text to display if there is no text available from a resource file. |
01.00.00 | ||
| CssClass | This value is the name of a CSS class that will be added to the rendered HTML. (the text will be rendered inside a span) |
Normal | 01.00.00 | |
| ResourceKey | The name of XML element's content in the resource file (*.resx) to be used. | Hello.Text | 01.00.00 | |
| ReplaceTokens | This true/false value will tell DNN to look for system tokens and replace them with the appropriate text | False | True False |
01.00.00 |
Tokens
Note
Below is only a small selection of the tokens that can be useful, but you can use all of the supported Core Tokens
| Name | Value | Description |
|---|---|---|
| User Display name | The display name of the current user | The display name of the current user |
| User First Name | The first name of the current user | The first name of the current user |
| User Lastname | The last name of the current user | The last name of the current user |
| Portal Name | The name of the current Portal | The name of the current Portal |
Examples:
Text Theme Object Fallback text
Show Fallback text as the Resourcekey is not found
<dnn:TEXT runat="server" id="dnnTEXT-fallback" ShowText="Fallback" CssClass="dnn-text" ResourceKey="Main.Text" ReplaceTokens="False" />
Text Theme Object EN, FR, NL text
Example for English, French and Dutch
<dnn:TEXT runat="server" id="dnnTEXT-Demo" ShowText="Demo" CssClass="dnn-text" ResourceKey="Example.Text" ReplaceTokens="False" />
Text Skin Object Tokens
Use Tokens for a personalized message
<dnn:TEXT runat="server" id="dnnTEXT-Tokens" ShowText="Tokens" CssClass="dnn-text" ResourceKey="Token.Text" ReplaceTokens="True" />