-
Notifications
You must be signed in to change notification settings - Fork 52
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
DNN
committed
Apr 21, 2024
1 parent
ce2910f
commit 2e1eb8d
Showing
6 changed files
with
3,752 additions
and
3,441 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
286 changes: 286 additions & 0 deletions
286
docs/content/tutorials/themes/theme-objects/text/readme.html
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,286 @@ | ||
<!DOCTYPE html> | ||
<!--[if IE]><![endif]--> | ||
<html> | ||
|
||
<head> | ||
<meta charset="utf-8"> | ||
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> | ||
<title>TEXT Theme object -- DNN Docs</title> | ||
<meta name="viewport" content="width=device-width"> | ||
<meta name="title" content="TEXT Theme object -- DNN Docs"> | ||
<meta name="generator" content="docfx "> | ||
|
||
<link rel="shortcut icon" href="../../../../../favicon.ico"> | ||
<link rel="stylesheet" href="../../../../../styles/docfx.vendor.css"> | ||
<link rel="stylesheet" href="../../../../../styles/docfx.css"> | ||
<link rel="stylesheet" href="../../../../../styles/main.css"> | ||
<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.7.2/css/all.css" integrity="sha384-fnmOCqbTlWIlj8LyTjo7mOUStjsKC4pOpQbqyi7RrhN7udi9RwhKkMHpvLbHG9Sr" crossorigin="anonymous"> | ||
<link rel="preconnect" href="https://ZPKP9SED9P-dsn.algolia.net" crossorigin=""> | ||
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@alpha"> | ||
<meta property="docfx:navrel" content="../../../../../toc.html"> | ||
<meta property="docfx:tocrel" content="../../../toc.html"> | ||
<meta property="og:title" content="TEXT Theme object -- DNN Docs"> | ||
<meta property="og:image" content="../../../../../images/dnn_docs_logo.png"> | ||
<meta property="og:description" content="TEXT Theme object -- DNN Docs"> | ||
<meta property="og:url" content="https://docs.dnncommunity.org/content/tutorials/themes/theme-objects/text/readme.html"> | ||
|
||
|
||
|
||
<!-- Global site tag (gtag.js) - Google Analytics --> | ||
<script async="" src="https://www.googletagmanager.com/gtag/js?id=UA-137422488-1"></script> | ||
<script> | ||
window.dataLayer = window.dataLayer || []; | ||
function gtag(){dataLayer.push(arguments);} | ||
gtag('js', new Date()); | ||
|
||
gtag('config', 'UA-137422488-1'); | ||
</script> </head> | ||
<body data-spy="scroll" data-target="#affix" data-offset="120"> | ||
<div id="wrapper"> | ||
<header> | ||
|
||
<nav id="autocollapse" class="navbar navbar-inverse ng-scope" role="navigation"> | ||
<div class="container"> | ||
<div class="navbar-header"> | ||
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#navbar"> | ||
<span class="sr-only">Toggle navigation</span> | ||
<span class="icon-bar"></span> | ||
<span class="icon-bar"></span> | ||
<span class="icon-bar"></span> | ||
</button> | ||
|
||
<a class="navbar-brand" href="../../../../../index.html"> | ||
<img id="logo" class="svg" src="../../../../../images/dnn_docs_logo.png" alt=""> | ||
</a> | ||
</div> | ||
<div class="collapse navbar-collapse" id="navbar"> | ||
<div class="navbar-right"> | ||
<div id="docsearch-navbar" class="navbar-form navbar-right"></div> | ||
</div> | ||
</div> | ||
</div> | ||
</nav> | ||
|
||
<div class="subnav navbar navbar-default"> | ||
<div class="container"> | ||
<div class="hide-when-search pull-left" id="breadcrumb"> | ||
<ul class="breadcrumb"> | ||
<li></li> | ||
</ul> | ||
</div> | ||
<div class="pull-right"> | ||
<ul class="nav nav-pills"> | ||
<li role="presentation dropdown"> | ||
<a class="dropdown-toggle" id="shareMenu" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true"> | ||
<i class="glyphicon glyphicon-share"></i> Share | ||
</a> | ||
<ul class="dropdown-menu" aria-labelledby="shareMenu"> | ||
<li><a href="https://twitter.com/intent/tweet?original_referer=https%3A%2F%2Fdocs.dnncommunity.org%2Fcontent%2Ftutorials%2Fthemes%2Ftheme-objects%2Ftext%2Freadme.html&text=TEXT%20Theme%20object%20%7C%20DNN%20Docs%20%7C%20%23DNNCMS&tw_p=tweetbutton&url=https%3A%2F%2Fdocs.dnncommunity.org%2Fcontent%2Ftutorials%2Fthemes%2Ftheme-objects%2Ftext%2Freadme.html" target="_blank"><i class="fab fa-twitter"></i> Twitter</a></li> | ||
<li><a href="https://www.linkedin.com/cws/share?url=https%3A%2F%2Fdocs.dnncommunity.org%2Fcontent%2Ftutorials%2Fthemes%2Ftheme-objects%2Ftext%2Freadme.html" target="_blank"><i class="fab fa-linkedin-in"></i> LinkedIn</a></li> | ||
<li><a href="https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fdocs.dnncommunity.org%2Fcontent%2Ftutorials%2Fthemes%2Ftheme-objects%2Ftext%2Freadme.html" target="_blank"><i class="fab fa-facebook-square"></i> Facebook</a></li> | ||
<li role="separator" class="divider"></li> | ||
<li><a href="mailto:?subject=[Shared%20Article]%20TEXT%20Theme%20object%20|%20DNN%20Docs&body=TEXT%20Theme%20object%20|%20DNN%20Docs%0A%0Ahttps%3A%2F%2Fdocs.dnncommunity.org%2Fcontent%2Ftutorials%2Fthemes%2Ftheme-objects%2Ftext%2Freadme.html%0A%0A"><i class="fas fa-envelope"></i> Email</a></li> | ||
</ul> | ||
</li> | ||
<li role="presentation"> | ||
<a href="https://github.com/DNNCommunity/DNNDocs/issues/new?title=Feedback for TEXT Theme object&body=%0A%0A%5BEnter%20feedback%20here%5D%0A%0A%0A---%0A%23%23%23%23%20Document%20Details%0A%0A%E2%9A%A0%20*Do%20not%20edit%20this%20section.%20It%20is%20required%20for%20docs.dnncommunity.org%20%E2%9E%9F%20Core%20Team%20processing.*%0A%0A*%20Content%20Source%3A%20%5Btext%5D(https%3A%2F%2Fgithub.com%2FDNNCommunity%2FDNNDocs%2Fblob%2Fmain%2Fcontent%2Ftutorials%2Fthemes%2Ftheme-objects%2Ftext%2Freadme.md%2F%23L1)" target="_blank"><i class="glyphicon glyphicon-comment"></i> Feedback</a> | ||
</li> | ||
<li role="presentation"> | ||
<a href="https://github.com/DNNCommunity/DNNDocs/blob/main/content/tutorials/themes/theme-objects/text/readme.md/#L1" target="_blank"><i class="glyphicon glyphicon-new-window"></i> Improve this Doc</a> | ||
</li> | ||
</ul> | ||
</div> | ||
</div> | ||
</div> </header> | ||
<div role="main" class="container body-content hide-when-search"> | ||
|
||
<div class="sidenav hide-when-search"> | ||
<a class="btn toc-toggle collapse" data-toggle="collapse" href="#sidetoggle" aria-expanded="false" aria-controls="sidetoggle"></a> | ||
<div class="sidetoggle collapse" id="sidetoggle"> | ||
<div id="sidetoc"></div> | ||
</div> | ||
</div> | ||
<div class="article row grid-right"> | ||
<div class="col-md-10"> | ||
<article class="content wrap" id="_content" data-uid="text"> | ||
<h1 id="text-theme-object-introduction">TEXT Theme Object Introduction</h1> | ||
<div class="page-version"> | ||
DNN Version: <span class="dnn-version">09.02.00</span> | ||
|
||
</div> | ||
<div class="page-stats row visible-xs"> | ||
<div class="pull-left"> • 3 minutes to read</div> | ||
</div> | ||
<div class="page-stats row visible-sm visible-md visible-lg visible-xl"> | ||
<span class="pull-left"> • 3 minutes to read</span> | ||
</div> | ||
|
||
<p>Displays Localized text in your theme / skin, also supports the use of DNN Core Token replacement.</p> | ||
<p>The text will be loaded from a resource file (*.resx), you need a separate resx file per language.</p> | ||
<p>These should be located in a folder named "App_LocalResources" (in the Theme folder).</p> | ||
<h2 id="naming-convention">Naming convention:</h2> | ||
<p>When your skin file = index.ascx: | ||
Default language: index.ascx.resx | ||
French: index.ascx.fr-FR.resx | ||
German: index.ascx.de-DE.resx</p> | ||
<h2 id="resource-file-content">Resource file content:</h2> | ||
<pre><code><?xml version="1.0" encoding="utf-8"?> | ||
<root> | ||
<data name="Welcome.Text"> | ||
<value>Welcome</value> | ||
</data> | ||
</root> | ||
</code></pre> | ||
<p><strong>Current Version:</strong> 01.00.00</p> | ||
<h2 id="include-in-theme">Include in Theme</h2> | ||
<h3 id="ascx">ASCX</h3> | ||
<pre><code class="lang-html"><%@ Register TagPrefix="dnn" TagName="TEXT" Src="~/Admin/Skins/Text.ascx" %> | ||
<dnn:TEXT runat="server" id="dnnTEXT-Welcome" ShowText="Welcome, " ResourceKey="Welcome.Text" ReplaceTokens="False" /> | ||
</code></pre> | ||
<h3 id="html-token">HTML Token</h3> | ||
<p>[TEXT]</p> | ||
<h3 id="html-object-token">HTML Object Token</h3> | ||
<pre><code class="lang-html"><object id="dnnTEXT" codetype="dotnetnuke/server" codebase="TEXT"></object> | ||
</code></pre> | ||
<table> | ||
<thead> | ||
<tr> | ||
<th>Attribute</th> | ||
<th>Description</th> | ||
<th>Default</th> | ||
<th>Posssible Values</th> | ||
<th>DNN Version</th> | ||
</tr> | ||
</thead> | ||
<tbody> | ||
<tr> | ||
<td>ShowText</td> | ||
<td>The text to display if there is no text<br>available from a resource file.</td> | ||
<td></td> | ||
<td></td> | ||
<td>01.00.00</td> | ||
</tr> | ||
<tr> | ||
<td>CssClass</td> | ||
<td>This value is the name of a CSS class that will be added to the rendered HTML.<br>(the text will be rendered inside a span)</td> | ||
<td>Normal</td> | ||
<td></td> | ||
<td>01.00.00</td> | ||
</tr> | ||
<tr> | ||
<td>ResourceKey</td> | ||
<td>The name of XML element's content in the resource file (*.resx) to be used.</td> | ||
<td></td> | ||
<td>Hello.Text</td> | ||
<td>01.00.00</td> | ||
</tr> | ||
<tr> | ||
<td>ReplaceTokens</td> | ||
<td>This true/false value will tell DNN to look for system tokens and replace them with the appropriate text</td> | ||
<td>False</td> | ||
<td>True<br>False</td> | ||
<td>01.00.00</td> | ||
</tr> | ||
</tbody> | ||
</table> | ||
<h2 id="tokens">Tokens</h2> | ||
<div class="NOTE"> | ||
<h5>Note</h5> | ||
</div> | ||
<p>Below is only a small selection of the tokens that can be useful, but you can use all of the supported Core Tokens</p> | ||
<table> | ||
<thead> | ||
<tr> | ||
<th>Name</th> | ||
<th>Value</th> | ||
<th>Description</th> | ||
</tr> | ||
</thead> | ||
<tbody> | ||
<tr> | ||
<td>User Display name</td> | ||
<td>[User:displayname]</td> | ||
<td>The display name of the current user</td> | ||
</tr> | ||
<tr> | ||
<td>User First Name</td> | ||
<td>[User:firstname]</td> | ||
<td>The first name of the current user</td> | ||
</tr> | ||
<tr> | ||
<td>User Lastname</td> | ||
<td>[User:lastname]</td> | ||
<td>The last name of the current user</td> | ||
</tr> | ||
<tr> | ||
<td>Portal Name</td> | ||
<td>[Portal:portalname]</td> | ||
<td>The name of the current Portal</td> | ||
</tr> | ||
</tbody> | ||
</table> | ||
<h2 id="examples">Examples:</h2> | ||
<h3 id="text-theme-object-fallback-text">Text Theme Object Fallback text</h3> | ||
<p>Show Fallback text as the Resourcekey is not found</p> | ||
<pre><code class="lang-html"><dnn:TEXT runat="server" id="dnnTEXT-fallback" ShowText="Fallback" CssClass="dnn-text" ResourceKey="Main.Text" ReplaceTokens="False" /> | ||
|
||
|
||
</code></pre> | ||
<h3 id="text-theme-object-en-fr-nl-text">Text Theme Object EN, FR, NL text</h3> | ||
<p>Example for English, French and Dutch</p> | ||
<pre><code class="lang-html"><dnn:TEXT runat="server" id="dnnTEXT-Demo" ShowText="Demo" CssClass="dnn-text" ResourceKey="Example.Text" ReplaceTokens="False" /> | ||
</code></pre> | ||
<h3 id="text-skin-object-tokens">Text Skin Object Tokens</h3> | ||
<p>Use Tokens for a personalized message</p> | ||
<pre><code class="lang-html"><dnn:TEXT runat="server" id="dnnTEXT-Tokens" ShowText="Tokens" CssClass="dnn-text" ResourceKey="Token.Text" ReplaceTokens="True" /> | ||
</code></pre> | ||
</article> | ||
</div> | ||
|
||
<div class="hidden-sm col-md-2" role="complementary"> | ||
<div class="sideaffix"> | ||
<div class="contribution"> | ||
<ul class="nav"> | ||
</ul> | ||
</div> | ||
<nav class="bs-docs-sidebar hidden-print hidden-xs hidden-sm affix" id="affix"> | ||
<!-- <p><a class="back-to-top" href="#top">Back to top</a><p> --> | ||
</nav> | ||
</div> | ||
</div> | ||
</div> | ||
</div> | ||
|
||
<footer> | ||
<div class="grad-bottom"></div> | ||
<div class="footer"> | ||
<div class="container"> | ||
<span class="pull-right"> | ||
<a href="#top">Back to top</a> | ||
</span> | ||
|
||
<span>by the community, for the community... <strong>#DNNCMS</strong></span> | ||
</div> | ||
</div> | ||
</footer> | ||
</div> | ||
|
||
<script type="text/javascript" src="../../../../../styles/docfx.vendor.js"></script> | ||
<script type="text/javascript" src="../../../../../styles/docfx.js"></script> | ||
<script type="text/javascript" src="../../../../../styles/main.js"></script> | ||
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/@docsearch/js@alpha"></script> | ||
<script type="text/javascript"> | ||
document.dnndocs = { | ||
algolia: function(selector) { | ||
return { | ||
container: selector, | ||
appId: 'ZPKP9SED9P', | ||
indexName: 'dnnsoftware', | ||
apiKey: '37bfc247275fb9e8fcecbda599134a30', | ||
} | ||
} | ||
}; | ||
docsearch(document.dnndocs.algolia('#docsearch-navbar')); | ||
</script> | ||
</body> | ||
</html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.