) */
38 | code { background-color: #f2f8f9; color: #062873; }
39 |
40 | /* dark blue color text on light blue/grey background */
41 |
--------------------------------------------------------------------------------
/common/themes/dnn/navbarlinks.html:
--------------------------------------------------------------------------------
1 | {%- for link in theme_navbar_links %}
2 | {% if link[3] %}
3 |
4 | {{ link[0] }}
5 |
8 |
17 |
18 | {% else %}
19 | {% if link[2] %}
20 | {{ link[0] }}
21 | {% else %}
22 | {{ link[0] }}
23 | {% endif %}
24 | {% endif %}
25 | {%- endfor %}
26 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | The MIT License (MIT)
2 |
3 | Copyright (c) 2015 DNN Software
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
23 |
--------------------------------------------------------------------------------
/common/samples/theme/MyAwesomeLayout.css:
--------------------------------------------------------------------------------
1 | /* Header Skin Objects */
2 | #logo {
3 | display: inline-block;
4 | margin: 20px 0 0 20px;
5 | }
6 | #login_style {
7 | position: absolute;
8 | bottom: 10px;
9 | right: 10px;
10 | }
11 | .linkseparator {
12 | padding: 0 5px;
13 | }
14 | #login_style .linkseparator{
15 | color: white;
16 | font-weight: bold;
17 | }
18 | .user, a.user:link, a.user:active, a.user:visited {
19 | color: white;
20 | font-size: 1.1em;
21 | font-weight:bold;
22 | text-shadow: 1px 1px 1px #000;
23 | }
24 | a.user:hover {
25 | color: #C00;
26 | text-shadow: 2px 2px 2px #fff;
27 | }
28 |
29 | /* Footer Skin Objects */
30 | .linkscontainer {
31 | padding-top: 30px;
32 | text-align: center;
33 | font-size: 1.2em;
34 | text-transform: uppercase;
35 | }
36 | .links, a.links:link, a.links:active, a.links:visited {
37 | font-weight: bold;
38 | color: #28879B;
39 | }
40 | a.links:hover {
41 | color: #C00;
42 | }
43 | #terms_style{
44 | position: absolute;
45 | bottom: 10px;
46 | left: 10px;
47 | display:inline-block;
48 | }
49 | #copy_style{
50 | position: absolute;
51 | bottom: 10px;
52 | right: 10px;
53 | display:inline-block;
54 | }
55 |
--------------------------------------------------------------------------------
/common/themes/dnn/searchresults.html:
--------------------------------------------------------------------------------
1 | {#
2 | basic/searchresults.html
3 | ~~~~~~~~~~~~~~~~~~~~~~~~
4 |
5 | Template for the body of the search results page.
6 |
7 | :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS.
8 | :license: BSD, see LICENSE for details.
9 | #}
10 | Search
11 |
12 | From here you can search these documents. Enter your search
13 | words into the box below and click "search".
14 |
15 |
16 |
21 |
22 | {%- if search_performed %}
23 | Search Results
24 | {%- if not search_results %}
25 | Your search did not match any results.
26 | {%- endif %}
27 | {%- endif %}
28 |
29 | {%- if search_results %}
30 |
31 | {% for href, caption, context in search_results %}
32 | - {{ caption }}
33 | {{ context|e }}
34 |
35 | {% endfor %}
36 |
37 | {%- endif %}
38 |
39 |
--------------------------------------------------------------------------------
/copy-files.ps1:
--------------------------------------------------------------------------------
1 | # Copy-Docs C:\Websites\development\DNN-Docs\ C:\Websites\demo\dnn-docs-combined
2 |
3 | function Copy-Docs(){
4 | Param(
5 | [string]$from,
6 | [string]$to,
7 | [string]$buildPath ="_build/html"
8 | )
9 |
10 | $mainFrom = [io.path]::combine($from, 'main', $buildPath)
11 | $mainTo = $to
12 | Get-ChildItem -path $mainFrom -Recurse *.snag | remove-item
13 | Get-ChildItem -Path $mainFrom | % {
14 | Copy-Item $_.fullname "$mainTo" -Recurse -Force
15 | }
16 |
17 | $adminFrom = [io.path]::combine($from, 'admin', $buildPath)
18 | $adminTo = join-path $to 'admin'
19 | Get-ChildItem -path $adminFrom -Recurse *.snag | remove-item
20 | Get-ChildItem -Path $adminFrom | % {
21 | Copy-Item $_.fullname "$adminTo" -Recurse -Force
22 | }
23 |
24 | $devFrom = [io.path]::combine($from, 'dev', $buildPath)
25 | $devTo = join-path $to 'dev'
26 | Get-ChildItem -path $devFrom -Recurse *.snag | remove-item
27 | Get-ChildItem -Path $devFrom | % {
28 | Copy-Item $_.fullname "$devTo" -Recurse -Force
29 | }
30 |
31 | $designFrom = [io.path]::combine($from, 'design', $buildPath)
32 | $designTo = join-path $to 'design'
33 | Get-ChildItem -path $designFrom -Recurse *.snag | remove-item
34 | Get-ChildItem -Path $designFrom | % {
35 | Copy-Item $_.fullname "$designTo" -Recurse -Force
36 | }
37 | }
38 |
39 |
--------------------------------------------------------------------------------
/common/themes/dnn/theme.conf:
--------------------------------------------------------------------------------
1 | # DNN Theme
2 | [theme]
3 | inherit = basic
4 | stylesheet = basic.css
5 | pygments_style = tango
6 |
7 | # Configurable options.
8 | [options]
9 | # Navigation bar title. (Default: ``project`` value)
10 | navbar_title =
11 |
12 | # A list of tuples containting pages to link to. The value should be
13 | # in the form [(name, page), ..]
14 | navbar_links =
15 |
16 | # Navigation bar title. (Default: true)
17 | navbar_version =
18 |
19 | site_home = "#"
20 |
21 | # Global TOC depth for "site" navbar tab. (Default: 1)
22 | # Switching to -1 shows all levels.
23 | globaltoc_depth = 1
24 |
25 | # Include hidden TOCs in Site navbar?
26 | #
27 | # Note: If this is "false", you cannot have mixed ``:hidden:`` and
28 | # non-hidden ``toctree`` directives in the same page, or else the build
29 | # will break.
30 | #
31 | # Values: "true" (default) or "false"
32 | globaltoc_includehidden = true
33 |
34 | # Fix navigation bar to top of page?
35 | # Values: "true" (default) or "false"
36 | navbar_fixed_top = true
37 |
38 | # Location of link to source.
39 | # Options are "nav" (default), "footer" or anything else to exclude.
40 | source_link_position = nav
41 |
42 | # Hide the sidebars on specific pages.
43 | # If sidebars are defined for the site, then they will not be displayed
44 | # on the pages defined in this list. The value should be a list of
45 | # pagenames in the form [page1, page2, ..]
46 | hide_sidebar = []
47 |
48 | # When generating paths, add the following root path.
49 | link_root = ''
--------------------------------------------------------------------------------
/_unused/PaneLayoutTemplates-drawio.xml:
--------------------------------------------------------------------------------
1 | 7Vrfl6I2FP5rfHSOEER9HK1tH9pzes489HFPlAjpBkIxjs7+9XsDuQINOuwCM7NbfJHc/OT7vpvcG52QTXz5LaNp9KcMmJi4s+AyIb9MXNeZuTP40pYXtCyWhSXMeGBspeGJf2HY0FhPPGDHWkMlpVA8rRv3MknYXtVsNMvkud7sIEV91pSGOGNpeNpTYVv/5oGKCuvS9Uv774yHEc7s+KuiZkf3n8NMnhIz38Qlh/xTVMcUx8pflGwBxUxKGEY/xZcNExpJxKhA49cbtddFZiwxC7nfgRQdnqk4mfcsDEf1gi9+jrhiTynd6/IZ2J2QdaRiASUHHlNBeTINMwrErqngYQIVe5ieZWB4ZpniAOKjqVBSdz/IRD2ZGfQYeblgHNZL1rF8prtrbcaO/Eu1LBVVlTJIjVXLRgEVi42KAUovj6FGr/CDiJmMmcpeoImpXRm1onx9I8tzqQXXN+BFFR3MsSE1+guvQ5e0wINh5gatrpm9wlNKE2ZxdYxoqh/ZBaZfB/JUYvAKjdAzkGcoaPyPKpOf2UYKCRzCuORxtfG2a80UF6JiX2wf/a3uAfwHHNDFukTC6mxidbnSfZZ/mnRTrAAdjWidsYwDcCzT78CT0CxV6pLSrMx1sQemXc84LlKNG1WF6tXcZtoztk5EE6+zQ16ZbPKs1gQUbr3LV3GL3R7AdhyDmgEbELDAdvDsqKLtAN09wG1273twv6lPGWR/IndyiCEKGV7YDKPrVAle9sLvYuR3aH6RqG/k1+uFX/tcHPkdll/SsEMPxi8OUuPXF5pIjV2NaP/fk46a84opRIxgfYQG8PqXshKeQv0t6Is8Qf9iLFhHMVxRaUkIoNL2qjRqakB6bSG8GhDHPAj0NI1alND6IHIJRtCOQYebx7vj2YLy809POsAud3QASd1AQsDT/sM4+k8a/FqnNWaIbxH8YuDdhuT4Aqin0UOR2j/8c4rTKU8+5cVPmtMKvehzf9AdE3/JI1dcasB3UikZ38xS6zQAaLY0rhzWFPT9OrnrxJZO8kS4eJXpctXXdm9cGLMf3P4rAmjKc9HWzcvNIO+e/fR9AdE+m7KYauDzzh5d9965Z/Kbt8mm5i1uk/5X0dgw91jdJELqCfd8aUukKZxzAIoeFNLiemNUyDsrZPkfhczbKWTVi0DMwKNAfhyB+A2nzGAZIYpxFMgPdMa03EEw9+gmkBZXfh/sBr0b2E79lynSELAPGfONN3B1f+zFf0wgbSj1kL63idG+IQsfGW17ZL4no/gT9MjocD5KMPx95aIMie9GaFMQNF6Lf+e1eMcrl/p9mdd0/A52Le43BTujED6CEJqyor6EAMXyL2J5XeVfd2T7FQ==
2 |
34 |
35 |
--------------------------------------------------------------------------------
/common/ext/div.py:
--------------------------------------------------------------------------------
1 | import sys
2 | from docutils import nodes
3 | from docutils.parsers.rst import Directive
4 | from docutils.parsers.rst import directives
5 |
6 |
7 | def setup(app):
8 | app.add_node(DivNode, html=(DivNode.visit_div, DivNode.depart_div))
9 | app.add_directive('div', DivDirective)
10 | return {'version': '0.1'}
11 |
12 | class DivNode(nodes.General, nodes.Element):
13 |
14 | def __init__(self, text):
15 | super(DivNode, self).__init__()
16 |
17 | @staticmethod
18 | def visit_div(self, node):
19 | self.body.append(self.starttag(node, 'div'))
20 |
21 | @staticmethod
22 | def depart_div(self, node=None):
23 | self.body.append('\n')
24 |
25 | class DivDirective(Directive):
26 |
27 | optional_arguments = 1
28 | final_argument_whitespace = True
29 | option_spec = {'name': directives.unchanged}
30 | has_content = True
31 |
32 | def run(self):
33 | self.assert_has_content()
34 | text = '\n'.join(self.content)
35 | try:
36 | if self.arguments:
37 | classes = directives.class_option(self.arguments[0])
38 | else:
39 | classes = []
40 | except ValueError:
41 | raise self.error(
42 | 'Invalid class attribute value for "%s" directive: "%s".'
43 | % (self.name, self.arguments[0]))
44 | node = DivNode(text)
45 | node['classes'].extend(classes)
46 | self.add_name(node)
47 | self.state.nested_parse(self.content, self.content_offset, node)
48 | return [node]
49 |
50 |
51 |
--------------------------------------------------------------------------------
/main/DNN8-Requirements.rst:
--------------------------------------------------------------------------------
1 | ===========================
2 | DNN Platform Requirements
3 | ===========================
4 |
5 | DNN 8.0/Evoq 8.3
6 | ----------------
7 |
8 | Supported Operating Systems
9 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^
10 |
11 | .. class:: collapse-list
12 |
13 | * Windows Vista
14 | * Windows 7
15 | * Windows 8
16 | * Windows 8.1
17 | * Windows Server 2008
18 | * Windows Server 2008 R2
19 | * Windows Server 2012
20 | * Windows Server 2012 R2
21 | * Windows 10
22 |
23 | .NET Framework
24 | ^^^^^^^^^^^^^^
25 |
26 | .. class:: collapse-list
27 |
28 | * 4.5.1
29 | * 4.5.2
30 | * 4.6.0
31 | * 4.6.1
32 |
33 | Web Server
34 | ^^^^^^^^^^
35 |
36 | * Microsoft IIS 7.0, 7.5, 8.0, 8.5, 10
37 |
38 | Database Server
39 | ^^^^^^^^^^^^^^^
40 |
41 | .. class:: collapse-list
42 |
43 | * Microsoft SQL Server 2008
44 | * Microsoft SQL Server 2008 Express
45 | * Microsoft SQL Server 2008 R2
46 | * Microsoft SQL Server 2008 Express R2
47 | * Microsoft SQL Server 2012
48 | * Microsoft SQL Server 2012 Express
49 | * Microsoft SQL Server 2014
50 | * Microsoft SQL Server Azure
51 |
52 | Browsers
53 | ^^^^^^^^
54 |
55 | .. class:: collapse-list
56 |
57 | * Chrome
58 | * Firefox
59 | * IE 9+
60 | * Microsoft Edge
61 | * Safari for Mac
62 |
63 | .. note::
64 | Unless specified, DNN and Evoq are only tested and certified on the latest browser versions at the time of the release. It is possible that DNN and Evoq will run on older versions without issue.
65 |
66 | Recommended Environment
67 | -----------------------
68 |
69 | .. class:: collapse-list
70 |
71 | * Windows Server 2012 R2
72 | * IIS 8.5
73 | * SQL Server 2012
74 | * .NET Framework 4.5.2
75 |
76 |
77 |
--------------------------------------------------------------------------------
/common/Extensions/Create-Package.inc:
--------------------------------------------------------------------------------
1 | Overview
2 | ---------
3 |
4 | For easier distribution and installation, the components of an extension (theme or module) can be bundled into a package.
5 |
6 | An extension package is simply a zip file that contains all the files required by your extension. The most important part of the process is creating the DNN Manifest, which provides information required by the installer, such as the target locations for the files.
7 |
8 | If you use the DNN templates and compile in Visual Studio, the Release build creates the zip file for you.
9 |
10 |
11 | Steps
12 | -----
13 |
14 | #. Prepare your files in folders.
15 |
16 | * Files that are common among all packages:
17 |
18 | .. class:: collapse-list
19 |
20 | * (Optional) **MyLicense.txt** is displayed to the user during package installation.
21 | * (Optional) **MyReleaseNotes.txt** lists the changes for the current version of the package and is also provided during installation.
22 |
23 | .. tip::
24 | The license and release notes are HTML files, so you can include special offers, including a call to action and other details.
25 |
26 | **Reminder:** Include the version number of your extension in the release notes.
27 |
28 | #. Create the :doc:`DNN Manifest `
29 |
30 | #. Zip up your files, including the DNN Manifest in the root folder.
31 |
32 |
33 | See Also
34 | --------
35 |
36 | * :doc:`Install an Extension `
37 |
38 | Sources
39 | -------
40 |
41 | * DNN Professional Training video: `Skinning 5: Packaging `_
42 |
--------------------------------------------------------------------------------
/dev/Concepts/ModuleDevelopment/Unsupported-MVC-Features.rst:
--------------------------------------------------------------------------------
1 | ==========================
2 | Unsupported MVC Features
3 | ==========================
4 |
5 | Overview
6 | --------
7 |
8 | Some MVC features were not fully implemented in DNN 8 due to the differences between ASP.Net MVC and ASP.Net Web Forms frameworks.
9 |
10 | Not Implemented
11 | ---------------
12 |
13 | * HTML Helpers
14 |
15 | .. class:: collapse-list
16 |
17 | * FormExtensions (BeginForm, BeginRouteForm, EndForm)
18 | * Html.RouteLink
19 | * All ChildActionExtensions i.e. Html.Action, Html.RenderAction
20 |
21 | * Url Helpers
22 |
23 | .. class:: collapse-list
24 |
25 | * Url.Action(string actionName, string controllerName, RouteValueDictionary routeValues, string protocol)
26 | * Url.Action(string actionName, string controllerName, object routeValues, string protocol)
27 | * Url.Action(string actionName, string controllerName, RouteValueDictionary routeValues, string protocol, string hostName)
28 | * Url.RouteUrl
29 | * Url.HttpRouteUrl
30 |
31 | * Controller Action Return Types - DNN 8 expects actions to return an ActionResult. All other result types are currently unsupported
32 |
33 | .. class:: collapse-list
34 |
35 | * PartialViewResult,
36 | * JsonResult
37 | * ContentResult
38 | * EmptyResult
39 | * FileResult
40 | * FileStreamResult
41 | * JavaScriptResult
42 | * RedirectResults
43 | * RedirectToRouteResult
44 |
45 | * AsyncControllers
46 |
47 | * Attribute Routing
48 |
49 | * Bundles - DNN implements a different minification and bundling API which is available for MVC modules.
50 |
51 | Coming in DNN 8.0.1
52 | -------------------
53 |
54 | * Ajax Helpers
55 |
56 | * Partial View support
--------------------------------------------------------------------------------
/common/themes/dnn/styles/sphinx.less:
--------------------------------------------------------------------------------
1 | .well {
2 | background: #f5f5f5;
3 | border: 1px solid #e3e3e3;
4 | padding: 1em;
5 | }
6 |
7 | .admonition {
8 | padding: 1em;
9 | border-radius: 3px;
10 | }
11 |
12 | /* Tips: blue color */
13 |
14 | .tip {
15 | background-color: #e8fcff;
16 | border: 1px solid #c0eaef;
17 |
18 | p.admonition-title{
19 | color: #7eb9c1;
20 | }
21 | }
22 |
23 | .tip.has-title{
24 | .admonition-title {
25 | display: none;
26 | }
27 |
28 | p:nth-of-type(2) {
29 | font-weight: 700;
30 | color: #7eb9c1;
31 | }
32 | }
33 |
34 | /* Notes: yellow color */
35 | .note {
36 | background-color: #ffffdb;
37 | border: 1px solid #e6df8f;
38 |
39 | p.admonition-title{
40 | color: #c2bc69;
41 | }
42 | }
43 |
44 | .note.has-title{
45 | .admonition-title {
46 | display: none;
47 | }
48 |
49 | p:nth-of-type(2) {
50 | font-weight: 700;
51 | color: #c2bc69;
52 | }
53 | }
54 |
55 | .warning {
56 | background-color: #ffdbdb;
57 | border: 1px solid #e68f8f;
58 |
59 | p.admonition-title{
60 | color: #c64f4f;
61 | }
62 | }
63 |
64 | /* Inline Code () */
65 | code {
66 | background-color: #f2f8f9;
67 | color: #062873;
68 | }
69 |
70 | /* dark blue color text on light blue/grey background */
71 |
72 | table.docutils{
73 | margin-bottom: 2em;
74 | }
75 |
76 | table.dnn-table {
77 | border-collapse: separate !important;
78 | border-spacing: 0;
79 |
80 | th {
81 | padding: 5px 10px;
82 | background-color: #f5f5f5;
83 |
84 | &:first-of-type {
85 | border-top-left-radius: 3px;
86 | }
87 | &:last-of-type {
88 | border-top-right-radius: 3px;
89 | }
90 | }
91 |
92 | td {
93 | padding: 10px;
94 |
95 | p {
96 | margin: 0;
97 | }
98 | }
99 | }
100 |
101 | div.figure p.caption {
102 | font-weight: bold;
103 | width: 600px;
104 | text-align: center;
105 | }
--------------------------------------------------------------------------------
/common/img/DNNRoles-drawio.xml:
--------------------------------------------------------------------------------
1 | 7VtNc+I4E/4te6Bq97ApjAOE4yQMO2/V7FSqUluze1RsgbUjLL/+CLC/flp2S5YtAyZmIFMxB7Bbn+5+uvWohQfuw3r7R0yi4E/hUz4YDf3twJ0PRiPHnY7gR0p2KHGGKFnFzEdZKXhi/1EUDlGaMZ8mlYqpEDxlUVXoiTCkXlqRkTgWm2q1peDVUSOyUiOWgiePcFv6lflpoB8D5ycLPlG2CnDouzEWPBPv2yoWWYjjDUbuMv8UxWui+srrux9Bi7EQ0Iu8Wm8fKJeaVDrCTpN0pyY2cO+DdM3hxoHLvHixpzE+w+HG8CQxDfEpiuH29Te9LVq8EJ5hh/MvX0DwGAuPJok1XLJha05CuDOH9QLG/c9kJzI5apKCwtTdPdzFKaLhVk43CYgvNnA3zEtj8Y0+CC7ifAB3Np0Pp1NdoiwlGy4Z50bNxWI+m0xAvoqJz+CBVVko8vktRajGBS0U90bzYf4BOeFsFYLMgy4oFDYoEdX+QuOUKofQtgaPoWJN03gHVbBUWRl9Rd1uStzdKdgFBuQmqiJBrK90z6UR4QLtuMemY8umg9GE57aISAjXK3k9py+UiwieGAuhX7O8pekt89ra0yA7rj7UF3RU19eoSV/j6V13fd0p65b6eqIpCLIIvgp3EKCWIRcQTHKHB7yH9MbWkAVZU1EBiWS99RbwGgU3Sy42XgDKu4nQ19z7TcBS+hQRT1bcQLW6u1zPBTSqXusDEzSVYVNn0mDT6Rlc4M4Oaw8xJSmVy0uWpGItzSj8jPdWPM2KziXNOEMzGsahPqzpeCviNBArERL+sZTe5ws1lT1InRimo1uW/i3FN2O8+8coeaQxgwlKveUNQWXxzqgub2V9XVZvoC2so+IHSVpKM+ayBZhe9+KrGh4nScK8QohVZDf/0jTdoelJlgoQlQ/9WQhAFg5XW0U1Jqpgdk9A037wJCKLc2wbwROebQVBs+J90lYHIRZTTlL2UuVnXQDjOBPL8R+BjLxHt7dcvMmYrQnMZHo5t3ecWSe/lwbr/b6b39d8t0UgQKc3AwG64wUcf2r7/Zwm4BeS3l6Bx2ovqrrRZXktDtbz2oOMSCHnp+C19tbO5rVpQNe9Ed8yrVXhs6e1b4LWIngqqxnGzgqtRbNdg9Yi+zpAa9+J1x9jtXsIx1tgtQ2Z34ux2vdIUpvces+mp7XHYtNHwWAYDSt9hKBxhWOrLoowgq1qkNHTaImibotHj6ITUaRSUAaKdJahsjp03erkTUFbRLZSFSIJmfwUph3y3FnBY/R5T63++HB9uChm8Hp4Kq/r4dkZnidztVfjGZfB8+PZAqCrToPVjvi2ttPdEypPdQzQ4ptyDDjSbHMo90kkclK/Jll+MDfMEhr/9pYO6LD09pqJDce9IpPqN1AtggyC3QwyU8zpVmJM+YeJH5wexMGPpsI29FnOm8bgCu8shaIC1E+RB8M+mvJgYMIEtJz05nu7GbCCXFTs978Q4mBeiW5TGiZMhDDAB7X2+eylXPfMddMw8OT/mfzX1T2HJPbvasrQw9C5kYstlhrdkLW0YPicyJ8opj5dQlMfZq/SKnsW3r1zMkTFOSNQlEWemoEL3VlDw3bSHtAHAF1jlq4CmQloFThMQOs9VCdEu2fN6Z6PZJQUwuQZxSA/iGdoXnPGHG1bRoE2P1+O9sjuo0Mq5w4Dbg+Zi0FGwcMmoddJ6/e5vGsnS44iphkdF8mVWMm923ZpZaujWa2fca2f4oFPyLl0iHoqAWBQv68FY5cj+WsmaVadSz2A0aWZ5H8UQvibPqRGFtRnKaCgJVO6XGpkcs3UyKzbP6f6o+Uzr0FqiTcjSkOyFZONV1iD1GwMd/wr8qs76TwPycKVbFbs0uQeydynwRzg5RgJO5idV7zDIx32ne3BVWh79ZZF9XB0y+LgdqNTrLAj8WP2zFkS/NKb7ZTUydixQ3xj6qR+1vEqh7VTmXbIb4qTVYOZgfcHE3GMUkdjm6E99eZdZX1EWWdSVc1a1vb+e6iQ1Y1qp7JntW7OeODvNti3+yZBXecLtF7e+7ML/YaltWs8O72fqGMsRRRVQO4MIrgtX0Atqpfv9LofvwM= 7Vtdk6I4FP01PnaXCqI+tt32zMNu1VR11X48TaUlanaAuBi7dX793JBcCBAVNbg9s/qgcAMh3HPycW6uHe8x3n5KyWr5Ow9p1Ol3w23He+r0+0Ewgm9p2GnD2FeGRcpCZeoVhhf2nWpjV1s3LKTr0oWC80iwVdk440lCZ6JkI2nK38uXzXlUfuqKLPCJheFlRqK69U8WiqWyjvpBYf9M2WKJT+4FY1XySmbfFinfJPp5nb43zz6qOCZYV/ai3hR8mHIO1cijePtII+lH9JHyxvOe0ryRKU10Qw7f4Kkb3ki00e+pDGuxwxd/XzJBX1ZkJs/fAduON1mKOIKzHhyuIsKSu0VKANcJidgigYIZPJ6mYHijqWDgxAddILi8fc4T8aKfIOvIzhXi0F5vEvM38pqXpnTNvpvnXBBhnAPRqHmuGWBY6l7RjpLNo5qhmUl76RPlMRXpDi7BUl/zUNM35+V7QQZfO7u7NIjgD7SRaAIu8roLXOBAQ7MH15HuLBcAtV6SkL/v8bg8f+QRB8ygKq+bfWyAKrhfs1ZMAPWQQQnemfBEmqugv3IheOwIh8GghIMX1HHoITYmDr2u7qkX4eD9TDg4cLffH5Zpjw4w3W2jfc8J7T2N2SF3gz9X8pBu4dGTkG+Kft8UCenhtUj5N2r4/mH86E8nEhMWRRXP7nH42Wiqh+O84kl8acrAXzSVzWfJQreSyzMhwQD/ukHY1y5FhHFeNgc23edMgEdO8NXsuuHbHr7j8/DF+e4yfPWi74bv1fD1LCN0a/hiJSV8g0gCKX1XAjr4dyNXtVnBHazowPoAF8Drb4tCOFrI34js+AbuV3VBO1R1qrBGIXCVtJvUKLEB4a0T4eiCNWZhKB9j5SKHq+dRRsElXEfhhr3Te8+vEyrIPo544Om1/AEe9Lp6vHVOBJztP0xHB/tw+hBM5R2/8mzt11Ee23q7tl0Gsq7kEMg0CR+k2i7cvG/pW8Mxx6vu36b9CByb7v7SD8hO/pZQ3A/k6ZYJWSSfII+Lkr24rPkmzShpUlyQdEHzVa7uUDQsRQ/q+Bn4YEUmPmhLaUQEeyvHHGyg6Sd84SwbZjU9BrXFXKUK9Ub6LjMuUK1oVKkIV+JYkfJCraKMQ/lrN6SVbRHoYhJZESBgwynkFNFmnVzKpJW0On84Osjx2nDkYFjxvLKq7qPsM2g7tAU3XMwdqOA/iKbeQfNkXS2q6nyIxrl6bAlitKeqA2xw+5P11efYZhhWuubz89PY1TrMw+CTxjaP/11DTwcayP8vsi4QxAHpRATdDIYNIvI3BE9F0DK+toegLUTsZjkDa8yzFfEHUbqnj8+l9VULXOnqWw5wpT3dHDSQVLfufuqUC+9xNVE81NQwNTCIQdze5KlY8gVPSDQtrLCFCdvBVFYhHWUglovU+yFq1kynmtoWy3J5W9cnJBWowmcRWa/ZDM3P0LNyfZxL9eIiMBqXNFA6FXluo9bxMFdJaMOldaGNxqNCu7GCbt5H65tQMQ83AOTlIrKkFxt6cY9u0VvwbY2T1Y1XH/Mbjm28DvSIdhkGDTYSWpbwF20dtKreK8OfJTPBKiZxkXQZMJoFN2A+GDAYrjGAgQkAVnwqR0rIt3I3foETLh+/aLasbJhUojKJakHk8fCpC1Oyo2B7OfnBtwGIa41SmMaJmB/awjSnCYmebxMSLAYlsXYdGbXuzeRwWOjyU3RhH+UccgChNTiAY6BJAc8JA2zhHBcMyOThDf8z8B/09DLoKvjbgkEu8KcCpoEb/GfA79dXva3Bj3twBvzhLiHxLzOH5yGnVqfxPMiCGOLEemwaxyXUZSCeENCNt+C41fJe5aurn68RnVdCeejG38grjb7wNROMl/JsD62VTLRrbs+DQOXI0ZXyKuYRW302k7zVa0FAzg0PRhUe9C1DuW2T00Xi8OCETLgKDf7ZxKs7lnxVdJDO+Y+4kMV5r7SpbXLBRYiwkr7vdS15MxbsRy6wx0puQ0DjIcBVulQ1MoyK7kg6jpMuP7p1+bO6vCPs87H8VPXu5g87DeJiN/Dt4MvjP9yN/VUiDDDmdjSM03MxDOC0csuBP5QVW4PTAnrjlZ2HwvkaOTeYYmkR6SF7K3S1Mq0hKbF5CoDyTzdiCb3DhmelVlWPu1K5sFcPKzcAzJZmXbmlUryCXgTenNbYXzPv/zLuY/rsgc1va/7CGbsMcFr8NVml+hb/9famPwA= `_ in detail.
14 |
15 | ..
16 | Cover older versions in the next iteration of the docs website.
17 | **Determine what DNN version to install.** Decide on the oldest DNN version that you are willing to support.
18 |
19 | - What is the oldest DNN version that you or your clients have in production?
20 |
- If there is a specific feature that you want to use, which DNN version introduced that feature?
21 |
22 | **Note:** DNN 8.0 is mostly backward-compatible, except where noted in DNN 8 compatibility page. If you compile your module on an older DNN version, it will likely be compatible with newer versions; however, you should test your module on newer versions to ensure compatibility.
23 |
24 |
25 | Requirements
26 | ------------
27 |
28 | .. class:: collapse-list
29 |
30 | * `DNN 8.0 Requirements `_
31 | * (Optional) **Developers:** Visual Studio 2015 is the recommended IDE for developing DNN modules. It is required if you are contributing to the DNN Platform.
32 |
33 |
34 | Steps
35 | -----
36 |
37 | .. class:: collapse-list
38 |
39 | 1. :doc:`Download DNN and set up folder permissions for the user account that will run your website. `
40 | #. :doc:`Enable and set up IIS. `
41 | #. :doc:`Install and set up SQL. `
42 | #. :doc:`Run the DNN Installation Wizard. `
43 |
44 | ..
45 |
56 |
57 |
58 | See Also
59 | --------
60 |
61 | * :doc:`Install an Extension `
62 |
63 | .. include:: /../common/gettingstarted/Set-Up-Sources.inc
64 |
--------------------------------------------------------------------------------
/common/themes/dnn/search.html:
--------------------------------------------------------------------------------
1 | {#
2 | basic/search.html
3 | ~~~~~~~~~~~~~~~~~
4 |
5 | Template for the search page.
6 |
7 | :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
8 | :license: BSD, see LICENSE for details.
9 | #}
10 | {%- extends "layout.html" %}
11 | {% set title = _('Search') %}
12 | {% set script_files = script_files + ['_static/searchtools.js'] %}
13 | {% block extrahead %}
14 |
17 | {# this is used when loading the search index using $.ajax fails,
18 | such as on Chrome for documents on localhost #}
19 |
20 | {{ super() }}
21 | {% endblock %}
22 | {% block body %}
23 | {{ _('Search') }}
24 |
25 |
26 |
27 | {% trans %}Please activate JavaScript to enable the search
28 | functionality.{% endtrans %}
29 |
30 |
31 |
32 | {% trans %}From here you can search these documents. Enter your search
33 | words into the box below and click "search". Note that the search
34 | function will automatically search for all of the words. Pages
35 | containing fewer words won't appear in the result list.{% endtrans %}
36 |
37 |
38 |
45 |
46 | {% if search_performed %}
47 | {{ _('Search Results') }}
48 | {% if not search_results %}
49 | {{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}
50 | {% endif %}
51 | {% endif %}
52 |
53 | {% if search_results %}
54 |
55 | {% for href, caption, context in search_results %}
56 | - {{ caption }}
57 | {{ context|e }}
58 |
59 | {% endfor %}
60 |
61 | {% endif %}
62 |
63 | {% endblock %}
64 |
--------------------------------------------------------------------------------
/gulpfile.js:
--------------------------------------------------------------------------------
1 | var gulp = require('gulp');
2 | var shell = require('gulp-shell');
3 | var argv = require('yargs').argv;
4 | var less = require('gulp-less');
5 | var sourcemaps = require('gulp-sourcemaps');
6 |
7 | gulp.task('compile-styles', function () {
8 | gulp.src('./common/themes/dnn/styles/dnn.styles.less')
9 | .pipe(sourcemaps.init())
10 | .pipe(less())
11 | .pipe(sourcemaps.write('.'))
12 | .pipe(gulp.dest('./common/themes/dnn/static'))
13 | });
14 |
15 | gulp.task('build-main',
16 | ['compile-styles'],
17 | shell.task('make html', { cwd: './main' })
18 | );
19 |
20 | gulp.task('build-main-all',
21 | ['compile-styles'],
22 | shell.task('sphinx-build -b html -a -E . _build/html',
23 | { cwd: './main' }
24 | )
25 | );
26 |
27 | gulp.task('build-admin',
28 | ['compile-styles'],
29 | shell.task('make html', { cwd: './admin' })
30 | );
31 |
32 | gulp.task('build-admin-all',
33 | ['compile-styles'],
34 | shell.task('sphinx-build -b html -a -E . _build/html',
35 | { cwd: './admin' }
36 | )
37 | );
38 |
39 | gulp.task('build-dev',
40 | ['compile-styles'],
41 | shell.task('make html', { cwd: './dev' })
42 | );
43 |
44 | gulp.task('build-dev-all',
45 | ['compile-styles'],
46 | shell.task('sphinx-build -b html -a -E . _build/html',
47 | { cwd: './dev' }
48 | )
49 | );
50 |
51 | gulp.task('build-design',
52 | ['compile-styles'],
53 | shell.task('make html', { cwd: './design' })
54 | );
55 |
56 | gulp.task('build-design-all',
57 | ['compile-styles'],
58 | shell.task('sphinx-build -b html -a -E . _build/html',
59 | { cwd: './design' }
60 | )
61 | );
62 |
63 | gulp.task('build-all', ['build-main-all', 'build-admin-all', 'build-dev-all', 'build-design-all']);
64 |
65 | gulp.task('watch', function () {
66 | switch (argv.proj) {
67 | case 'main':
68 | gulp.watch(['./{common,main}/**/*.{rst,py,html,css,js,txt}', '!./**/_build/**/*'], ['build-main'])
69 | break;
70 | case 'admin':
71 | gulp.watch(['./{common,admin}/**/*.{rst,py,html,css,js,txt}', '!./**/_build/**/*'], ['build-admin'])
72 | break;
73 | case 'dev':
74 | gulp.watch(['./{common,dev}/**/*.{rst,py,html,css,js,txt}', '!./**/_build/**/*'], ['build-dev'])
75 | break;
76 | case 'design':
77 | gulp.watch(['./{common,design}/**/*.{rst,py,html,css,js,txt}', '!./**/_build/**/*'], ['build-design'])
78 | break;
79 | default:
80 | gulp.watch(['./{admin,common,design,dev,main}/**/*.{rst,py,html,css,js,txt}', '!./**/_build/**/*'], ['build-all'])
81 | }
82 |
83 | });
84 |
85 | gulp.task('default', ['build-all']);
--------------------------------------------------------------------------------
/common/samples/theme/MyAwesomeLayout.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
10 | |
11 |
14 |
15 |
16 |
24 |
29 |
30 |
31 |
32 |
33 |
56 |
--------------------------------------------------------------------------------
/common/themes/dnn/styles/footer.less:
--------------------------------------------------------------------------------
1 | .footer{
2 | background:@brown;
3 | clear:both;
4 | position: relative;
5 | border-top: 5px solid @blue;
6 | padding: 0 75px;
7 |
8 | &:before, &:after{
9 | content:' ';
10 | clear:both;
11 | display: table;
12 | }
13 | &:before{
14 | position: absolute;
15 | left:0;
16 | right:50%;
17 | height:5px;
18 | background: @red;
19 | display: block;
20 | top:-5px;
21 | }
22 |
23 | .row + .row {
24 | border-top:1px solid @brown-light;
25 | }
26 |
27 | h3{
28 | color:white;
29 | font-size: 40px;
30 | margin: 30px 0;
31 | }
32 |
33 | h4{
34 | font-size: 20px;
35 | font-weight: bold;
36 | margin: 0 0 5px;
37 | }
38 |
39 | h4, p{
40 | color:@brown-lighter;
41 | }
42 |
43 | p{
44 | font-size: 16px;
45 | margin-bottom:60px;
46 | padding-right: 45px;
47 | line-height: 1.75;
48 | }
49 |
50 | .quick-links, .horizontal-list{
51 | font-size: 16px;
52 | margin-bottom:30px;
53 |
54 | a{
55 | color:white;
56 | }
57 |
58 | li:before{
59 | color:@brown-lighter;
60 | }
61 |
62 | .glyphicon{
63 | margin-right: 5px;
64 | position: relative;
65 | top: 3px;
66 | }
67 | }
68 |
69 | .quick-links{
70 | .c-B;
71 |
72 | padding:30px 0 0;
73 | margin:0;
74 |
75 | li{
76 | float: left;
77 | display: block;
78 | padding: 0 30px 0 0;
79 | color: white;
80 |
81 | &.social-media-wrapper{
82 | position: relative;
83 | margin-top: -5px;
84 |
85 | span{
86 | vertical-align: middle;
87 | }
88 | }
89 | }
90 |
91 | >li{
92 | margin-bottom: 20px;
93 | }
94 | }
95 |
96 | .social-media{
97 | display: inline-block;
98 | padding: 0;
99 | white-space: nowrap;
100 | vertical-align: middle;
101 |
102 | li{
103 | padding: 0 5px;
104 | display: inline-block;
105 | float: none;
106 | }
107 |
108 | a{
109 | background-image: url(social-media.jpg);
110 | display: block;
111 | height:27px;
112 | width: 28px;
113 |
114 | &.twitter{
115 | background-position: -28px 0;
116 | }
117 | &.linkedin{
118 | background-position: -57px 0;
119 | }
120 | &.youtube{
121 | background-position: -85px 0;
122 | }
123 | }
124 | }
125 |
126 | .footer-policy{
127 | padding:15px 0;
128 | margin-left: -30px;
129 | margin-right: -30px;
130 |
131 | .horizontal-list{
132 | padding: 0;
133 | margin: 0;
134 |
135 | a, li, li:before{
136 | color: #473737;
137 | }
138 | }
139 | }
140 | }
--------------------------------------------------------------------------------
/design/HowTo/CreatingThemes/Create-Container.rst:
--------------------------------------------------------------------------------
1 | ====================
2 | Create a Container
3 | ====================
4 |
5 | Overview
6 | ---------
7 |
8 | Containers allow designers to seamlessly integrate modules from many different developers into a cohesive website design. Containers can also include visual elements that allow website users to interact with the module.
9 |
10 | .. class:: collapse-list
11 |
12 | * You can have a default container, which would be overridden by individual panes or modules if they provide their own style definitions.
13 | * You can use different containers in a single page.
14 | * You can mix and match any container with any theme layout.
15 |
16 | Steps
17 | -----
18 |
19 | 1. Create a new file for the container.
20 |
21 | .. note::
22 | .. class:: collapse-list
23 |
24 | * The container must contain exactly one pane called **ContentPane**.
25 | * The single pane must be defined as a server control by adding **runat="server"** to the element.
26 | * A pane can be one of the following HTML elements: (table cells), , , and .
27 |
28 | **Example:** A very basic container.
29 |
30 | * HTML
31 |
32 | .. code-block:: html
33 |
34 |
35 |
36 | * ASCX
37 |
38 | .. code-block:: html
39 |
40 | <%@ Control AutoEventWireup="false" Explicit="True" Inherits="DotNetNuke.UI.Containers.Container" %>
41 |
42 |
43 | #. (Optional) Add theme objects to your container for a more dynamic page.
44 |
45 | The following theme objects are relevant to containers:
46 |
47 | .. hlist::
48 | :columns: 3
49 |
50 | * ACTIONBUTTON
51 | * DROPDOWNACTIONS
52 | * ICON
53 | * LINKACTIONS
54 | * PRINTMODULE
55 | * TITLE
56 | * VISIBILITY
57 |
58 | .. include:: /../common/bptext/TipSkinningTool.inc
59 |
60 |
61 | See Also
62 | --------
63 |
64 | .. class:: collapse-list
65 |
66 | * DNN Wiki: `DotNetNuke Skins `_
67 | * :doc:`Create CSS `
68 | * :doc:`Create Layout Template `
69 |
70 | Sources
71 | -------
72 |
73 | .. class:: collapse-list
74 |
75 | * DNN Community blog: `DotNetNuke Skinning 101 (Part 3) `_ by `Joe Brinkman `_
76 | * DNN Professional Training: `Creating HTML Skins `_
77 |
78 |
--------------------------------------------------------------------------------
/main/index.rst:
--------------------------------------------------------------------------------
1 | .. title:: DNN Documentation Center
2 |
3 | .. toctree::
4 | :hidden:
5 |
6 | Overview-DNN-Platform
7 | DNN8-Requirements
8 | DNN8-Whats-New
9 |
10 | .. div:: row
11 |
12 | .. div:: col-xs-12 welcome-hero-wrapper
13 |
14 | |hero|
15 |
16 | .. div:: row card-row
17 |
18 | .. div:: container
19 |
20 | .. div:: col-sm-4 col-xs-12
21 |
22 | .. link:: ~/dev/index.html
23 | :class: home-card dev-card
24 |
25 | .. div:: card-title
26 |
27 | Developer
28 |
29 | .. div:: card-img-wrapper
30 |
31 | |dev-icon|
32 |
33 | .. div:: col-sm-4 col-xs-12
34 |
35 | .. link:: ~/admin/index.html
36 | :class: home-card admin-card
37 |
38 | .. div:: card-title
39 |
40 | Admin
41 |
42 | .. div:: card-img-wrapper
43 |
44 | |admin-icon|
45 |
46 | .. div:: col-sm-4 col-xs-12
47 |
48 | .. link:: ~/design/index.html
49 | :class: home-card designer-card
50 |
51 | .. div:: card-title
52 |
53 | Designer
54 |
55 | .. div:: card-img-wrapper
56 |
57 | |design-icon|
58 |
59 | .. div:: row link-row
60 |
61 | .. div:: container
62 |
63 | .. div:: col-sm-4 col-xs-12 page-link
64 |
65 | :doc:`Overview-DNN-Platform`
66 |
67 | .. div:: col-sm-4 col-xs-12 page-link
68 |
69 | :doc:`DNN8-Requirements`
70 |
71 | .. div:: col-sm-4 col-xs-12 page-link
72 |
73 | :doc:`DNN8-Whats-New`
74 |
75 | .. div:: row
76 |
77 | .. div:: container
78 |
79 | |coming-soon|
80 |
81 | .. role:: hidden
82 |
83 | .. ***** Image Substitutions *****
84 |
85 | .. |hero| image:: ../common/img/welcome-hero.jpg
86 | :class: welcome-hero
87 | :alt: Welcome to the DNN Documentation Center
88 |
89 | .. |dev-icon| image:: ../common/img/developer.jpg
90 | :class: card-img
91 | :alt: Developer Center
92 |
93 | .. |admin-icon| image:: ../common/img/admin.jpg
94 | :class: card-img
95 | :alt: Admin Center
96 |
97 | .. |design-icon| image:: ../common/img/designer.jpg
98 | :class: card-img
99 | :alt: Design Center
100 |
101 | .. |coming-soon| image:: ../common/img/home-comming-soon.jpg
102 | :class: comming-soon
103 | :alt: Comming Soon
104 |
--------------------------------------------------------------------------------
/design/HowTo/CreatingThemes/Create-Doctype.rst:
--------------------------------------------------------------------------------
1 | ==============================
2 | Create a Doctype Declaration
3 | ==============================
4 |
5 | Overview
6 | --------
7 |
8 | When creating themes, designers often rely on specific HTML and CSS versions in order to achieve the desired design. A design intended to be viewed using HTML 5 will not look correct if rendered using the XHTML or HTML 4 specification.
9 | Theme designers can set the doctype of the theme to any valid HTML doctype by creating a doctype declaration file.
10 |
11 | A theme may contain a single doctype file called skin.doctype.xml which will apply to all layouts in the theme. Additionally, themes may contain a separate doctype file specific to an individual layout. This layout specific doctype will override the theme wide doctype.
12 |
13 | .. note::
14 | If no doctype is specified by the theme designer then the fallback doctype configured in **Host Settings** will be used. By default DNN uses the HTML 4.0 Transitional doctype (:code:``)
15 |
16 | Steps
17 | -----
18 |
19 | 1. Create a theme doctype file named **skin.doctype.xml**.
20 |
21 | **Example:** If your layout template file is called **MyAwesomeLayout.html**, give your doctype file the name **MyAwesomeLayout.doctype.xml**.
22 |
23 |
24 | #. Enter one of the following in your DocType file:
25 |
26 | * HTML 4.01 Transitional
27 |
28 | .. code-block:: xml
29 |
30 |
31 | ]]>
32 |
33 |
34 | * XHTML Strict
35 |
36 | .. code-block:: xml
37 |
38 |
39 | ]]>
40 |
41 |
42 | * XHTML Transitional
43 |
44 | .. code-block:: xml
45 |
46 |
47 | ]]>
48 |
49 |
50 | * HTML5
51 |
52 | .. code-block:: xml
53 |
54 |
55 | ]]>
56 |
57 |
58 |
59 | See Also
60 | --------
61 |
62 | * DNN Wiki: `DotNetNuke Skins `_
63 |
64 | Sources
65 | -------
66 |
67 | * DNN Community blog: `>DotNetNuke Skinning 101 (Part 2) `_ by `Joe Brinkman `_
68 |
--------------------------------------------------------------------------------
/.gitattributes:
--------------------------------------------------------------------------------
1 | ###############################################################################
2 | # Set default behavior to automatically normalize line endings.
3 | ###############################################################################
4 | * text=auto
5 |
6 | ###############################################################################
7 | # Set default behavior for command prompt diff.
8 | #
9 | # This is need for earlier builds of msysgit that does not have it on by
10 | # default for csharp files.
11 | # Note: This is only used by command line
12 | ###############################################################################
13 | #*.cs diff=csharp
14 |
15 | ###############################################################################
16 | # Set the merge driver for project and solution files
17 | #
18 | # Merging from the command prompt will add diff markers to the files if there
19 | # are conflicts (Merging from VS is not affected by the settings below, in VS
20 | # the diff markers are never inserted). Diff markers may cause the following
21 | # file extensions to fail to load in VS. An alternative would be to treat
22 | # these files as binary and thus will always conflict and require user
23 | # intervention with every merge. To do so, just uncomment the entries below
24 | ###############################################################################
25 | #*.sln merge=binary
26 | #*.csproj merge=binary
27 | #*.vbproj merge=binary
28 | #*.vcxproj merge=binary
29 | #*.vcproj merge=binary
30 | #*.dbproj merge=binary
31 | #*.fsproj merge=binary
32 | #*.lsproj merge=binary
33 | #*.wixproj merge=binary
34 | #*.modelproj merge=binary
35 | #*.sqlproj merge=binary
36 | #*.wwaproj merge=binary
37 |
38 | ###############################################################################
39 | # behavior for image files
40 | #
41 | # image files are treated as binary by default.
42 | ###############################################################################
43 | #*.jpg binary
44 | #*.png binary
45 | #*.gif binary
46 | *.ico binary
47 |
48 | ###############################################################################
49 | # diff behavior for common document formats
50 | #
51 | # Convert binary document formats to text before diffing them. This feature
52 | # is only available from the command line. Turn it on by uncommenting the
53 | # entries below.
54 | ###############################################################################
55 | #*.doc diff=astextplain
56 | #*.DOC diff=astextplain
57 | #*.docx diff=astextplain
58 | #*.DOCX diff=astextplain
59 | #*.dot diff=astextplain
60 | #*.DOT diff=astextplain
61 | #*.pdf diff=astextplain
62 | #*.PDF diff=astextplain
63 | #*.rtf diff=astextplain
64 | #*.RTF diff=astextplain
65 |
--------------------------------------------------------------------------------
/common/themes/dnn/layout.html:
--------------------------------------------------------------------------------
1 | {% extends "basic/layout.html" %}
2 |
3 | {# Silence the sidebar's, relbar's #}
4 | {% block header %}{% endblock %}
5 | {% block relbar1 %}{% endblock %}
6 | {% block relbar2 %}{% endblock %}
7 | {% block sidebarsourcelink %}{% endblock %}
8 |
9 | {% set debug = false %}
10 | {% set theme_css_files = [
11 | 'http://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css',
12 | '_static/dnn.styles.css'
13 | ]
14 | %}
15 |
16 | {% set css_files = css_files + theme_css_files %}
17 |
18 | {% set script_files = script_files + [
19 | 'http://code.jquery.com/jquery-1.11.3.min.js',
20 | 'http://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js',
21 | '_static/dnn.theme.js'
22 | ]
23 | %}
24 |
25 | {%- set rendersidebar = (not embedded) and sidebars and (pagename not in theme_hide_sidebar) %}
26 |
27 | {% macro navBar() %}
28 | {% include "navbar.html" %}
29 | {% endmacro %}
30 |
31 | {%- macro bsidebar() %}
32 | {%- if rendersidebar %}
33 |
38 | {%- endif %}
39 | {%- endmacro %}
40 |
41 | {%- block doctype -%}
42 |
43 | {%- endblock %}
44 |
45 | {%- block extrahead %}
46 |
47 |
48 |
49 | {% endblock %}
50 |
51 | {%- block content %}
52 | {{ navBar() }}
53 |
54 | {% if debug == true %}
55 |
56 | Embedded: {{embedded}}
57 | Sidebars: {{sidebars}}
58 | PageName: {{pagename}}
59 | HideSidebar: {{theme_hide_sidebar}}
60 | Show: {{ pagename not in theme_hide_sidebar }}
61 | Render: {{(not embedded) and sidebars and (pagename not in theme_hide_sidebar)}}
62 | Render Sidebar: {{ rendersidebar }}
63 | Debug: {{debug}}
64 |
65 | {% endif %}
66 |
67 | {% if rendersidebar %}
68 |
69 | {%- block sidebar1 %}{{ bsidebar() }}{% endblock %}
70 |
71 |
72 | {% include "breadcrumbs.html" %}
73 | {% else %}
74 |
75 |
76 | {% endif %}
77 |
78 | {% block body %}{% endblock %}
79 |
80 | {% if rendersidebar %}
81 |
82 |
86 |
87 |
88 | {% else %}
89 |
90 |
91 | {% endif %}
92 | {%- endblock %}
93 |
94 | {%- block footer %}
95 | {% include "footer.html" %}
96 | {%- endblock %}
97 |
--------------------------------------------------------------------------------
/main/Overview-DNN-Platform.rst:
--------------------------------------------------------------------------------
1 | ==================
2 | The DNN Platform
3 | ==================
4 |
5 | The **DNN Platform** is an open, extensible, secure, and scalable content management system for ASP.NET. Hundreds of thousands of businesses around the world, `from small local businesses to Global 1000 companies `_, depend on the DNN Platform as their website authoring environment.
6 |
7 | This site is organized according to roles:
8 |
9 | * **Administrators** could be *hosts (super users)* who manage the web servers or *website admins* who manage the individual websites. The Admin Center also includes information for content managers/editors who create and manage content on the websites.
10 | * **Developers** create modules that extend the functionality of the DNN Platform.
11 | * **Designers** create themes that customize the look of a website.
12 |
13 | |dnnroles|
14 |
15 | ..
16 | Administrator
17 |
18 | - Set up the DNN Platform on a web server.
19 |
20 | - Install extensions (modules and themes) on the web server.
21 | - DNN 8.0 User Guide
22 | - Evoq 8.x User Guide
23 |
28 |
29 |
30 | Developer
31 |
32 | - Set up the DNN Platform in your local development environment.
33 | - Create a module.
34 | - Create a package containing your module.
35 | - API Reference
36 |
37 |
38 | Designer
39 |
40 | - Set up the DNN Platform in your local development environment.
41 | - Create a theme.
42 | - Create a package containing your theme.
43 | - UX Guide
44 |
45 |
46 |
47 |
48 | .. ***** Image Substitutions *****
49 |
50 | .. |dnnroles| image:: ../common/img/DNNRoles.png
51 | :class: img-responsive
52 | :alt: DNN workflow with roles
53 |
--------------------------------------------------------------------------------
/common/img/SkinTheme-drawio.xml:
--------------------------------------------------------------------------------
1 | 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
2 |
3 | Hello World
4 | A simple hello world
5 |
7 | MyOrganizationName
8 | MyOrganizationName
9 |
12 | The license for this package is not currently included within the installation file, please check with the vendor for full license details.
13 | This package has no Release Notes.
14 |
15 |
16 |
17 | MyOrganizationName.HelloWorld
18 | MyOrganizationName/HelloWorld
19 |
22 | Hello World
23 | ~/Icons/Sigma/Extensions_16X16_Standard.png
24 | ~/Icons/Sigma/Extensions_32X32_Standard.png
25 | Example hello world module
26 |
27 |
28 |
29 | MyOrganizationName.HelloWorld
30 | MyOrganizationName.HelloWorld
31 | 0
32 |
33 |
34 | DesktopModules/MyOrganizationName/HelloWorld/View.ascx
36 | False
37 | View
39 | False
42 | 0
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 | DesktopModules\MyOrganizationName\HelloWorld
52 |
53 | App_LocalResources
54 | View.ascx.resx
55 |
56 |
57 | readme.txt
58 |
59 |
60 | View.ascx
61 |
62 |
63 | View.ascx.cs
64 |
65 |
66 |
67 |
68 |
--------------------------------------------------------------------------------
/dev/Concepts/ModuleDevelopment/Develop-Modules.rst:
--------------------------------------------------------------------------------
1 | ================================
2 | Overview of Module Development
3 | ================================
4 |
5 | .. toctree::
6 | :hidden:
7 |
8 | Module-Features
9 | Module-Architecture
10 | Web-Forms-Module-Development
11 | MVC-Module-Development
12 | SPA-Module-Development
13 | Unsupported-MVC-Features
14 |
15 | The DNN platform provides many benefits to web developers. DNN provides common features like user management, role-based security, file management, and more. In this topic we'll cover how DNN Module Development which is the primary method for building web applications and web sites that run on DNN. You'll learn what a module is and the high-level concepts involved in module development.
16 |
17 | What is a Module?
18 | -----------------
19 | When looking at a typical web page, you can often identify separate page elements and content blocks. In DNN, page elements (e.g. site menu, login link, search bar) are included as part of the Theme. Content blocks are normally managed using DNN modules.
20 |
21 | |module-overview|
22 |
23 | The module is a foundational building block for extending DNN, and is the primary extension type that enables users to view, create and edit content. All DNN administrative features are implemented as modules.
24 |
25 | .. tip::
26 | The DNN platform source code provides more than two dozen modules that you can use as examples of how to build modules for DNN.
27 |
28 | Due to the modular nature of page composition in DNN, modules are usually built to manage and display a single content type.
29 |
30 | .. tip::
31 | Consider creating multiple modules when managing complex content types, or include rich templating support so that administrators can control the layout of content on the page.
32 |
33 | There are many different frameworks and approaches to developing modules. The three primary frameworks are:
34 |
35 | * Web Forms - This is the traditional framework for creating DNN modules that uses ASP.Net Web Forms based controls.
36 | * MVC - This framework was introduced in DNN 8 and utilizes ASP.Net MVC framework for creating modules.
37 | * SPA - This framework enables you to build modules using plain HTML, JavaScript and CSS. Developers are free to use their preferred SPA framework.
38 |
39 | Once you have selected the framework you will use, then you need to identify the development approach you will follow. Often this is a choice between choosing a manual development approach where the entire module is built by hand, or a more automated approach where the basic module foundation is created using a template or other automation tool.
40 |
41 | **Next:** :doc:`Module-Features`
42 |
43 | See Also
44 | --------
45 |
46 | * :doc:`/HowTo/CreatingModules/Creating-Modules`
47 |
48 | .. ***** Image Substitutions *****
49 |
50 | .. |module-overview| image:: /../common/img/module-overview.png
51 | :class: img-responsive img-600 dnn-border
52 | :alt: Modules are used to manage and display content on the page.
53 |
--------------------------------------------------------------------------------
/common/themes/dnn/footer.html:
--------------------------------------------------------------------------------
1 |
62 |
--------------------------------------------------------------------------------
/main/OverviewDNNPlatform.shtml:
--------------------------------------------------------------------------------
1 | .. raw:: html
2 |
3 | The DNN Platform
4 |
5 |
6 | The DNN Platform is an open, extensible, secure, and scalable content management system for ASP.NET. Hundreds of thousands of businesses around the world, from small local businesses to Global 1000 companies, depend on the DNN Platform as their website authoring environment.
7 |
8 | This site is organized according to role:
9 |
10 | - Administrators could be hosts (super users) who manage the web servers or website admins who manage the individual websites.
11 |
12 |
13 | - Developers create modules that extend the functionality of the DNN Platform.
14 | - Designer create themes that customize the look of a website.
15 |
16 |
17 |
18 | 
19 |
20 |
21 |
22 | Administrator
23 |
24 | - Set up the DNN Platform on a web server.
25 |
26 | - Install extensions (modules and themes) on the web server.
27 | - DNN 8.0 User Guide
28 | - Evoq 8.x User Guide
29 |
34 |
35 |
36 |
37 | Developer
38 |
39 | - Set up the DNN Platform in your local development environment.
40 | - Create a module.
41 | - Create a package containing your module.
42 | - API Reference
43 |
44 |
45 |
46 | Designer
47 |
48 | - Set up the DNN Platform in your local development environment.
49 | - Create a theme.
50 | - Create a package containing your theme.
51 | - UX Guide
52 |
53 |
54 |
55 | References
56 |
57 | - DNN 8.0 What's New
58 | - DNN Requirements
59 | - Glossary
60 |
61 |
62 |
--------------------------------------------------------------------------------
/common/gettingstarted/Run-Install-Wizard.inc:
--------------------------------------------------------------------------------
1 | Prerequisites
2 | -------------
3 |
4 | .. class:: collapse-list
5 |
6 | * :doc:`DNN installed with folder permissions for the user account that will run your website. `
7 |
8 | * :doc:`IIS enabled and set up. `
9 |
10 | * :doc:`SQL installed and set up. `
11 |
12 |
13 | Steps
14 | -----
15 |
16 | #. Run the DNN Installation Wizard.
17 |
18 | .. Verify the actual names of the UI objects. Need screenshots. -->
19 |
20 | a. Open your website (:code:`http://www.dnndev.me`) in a browser.
21 |
22 | #. Under **Administrative Information**, enter the username, password, and email address for the host / super user account to create. This account will have permissions for all websites created in this DNN installation.
23 |
24 | .. note::
25 |
26 | Remember the host's username and password, which you will need to manage your websites.
27 |
28 | #. Under **Website Information**, enter the name, template, and language to use for the first website.
29 |
30 | #. Under **Database Information**,
31 |
32 | * **Database Setup:** Custom
33 | * **Database Type:** SQL Server/SQL Server Express Database
34 | * **Server Name:**
35 |
36 | .. note:: Developers and Designers:
37 | :class: has-title
38 |
39 | You can use the default value (example: :code:`.\SQLExpress` or :code:`(local)`).
40 |
41 | .. note:: Administrators:
42 | :class: has-title
43 |
44 | Set the value to the name of your database server (example :code:`mydbserver`).
45 |
46 | * **Database Name:** Enter the name of the SQL database you created earlier.
47 |
48 | * **Object Qualifier:**
49 |
50 | .. note:: Developers:
51 | :class: has-title
52 |
53 | You should always set **objectQualifier** to :code:`dnn` to prepend :code:`dnn_` to all DNN-generated objects, such as tables and stored procedures. This practice is recommended in your local development environment, so that you can catch name-matching errors that could occur if the target DNN installation's **objectQualifier** setting (found in web.config) is not blank.
54 |
55 | * **Security:** User Defined
56 |
57 | * For **Database Username / Password**, enter the information for the SQL user you created earlier.
58 |
59 | #. Follow the prompts to the end of the wizard.
60 |
61 | |install-wiz|
62 |
63 |
64 | #. Test the installation by viewing the first website.
65 |
66 | #. (optional) To assist with localization, modify the web.config file to set ShowMissingKeys to :code:`true`.
67 |
68 | .. code-block:: xml
69 |
70 | Create a Module Inline
4 |
5 |
6 | Overview
7 | Note: These instructions use the DNN Module Creator, which is generally recommended only for very simple modules. For more complex modules, you can create a Web Forms Module using templates.
8 |
9 |
10 | Prerequisites
11 |
12 |
13 | - A local DNN installation with Host permissions.
14 |
15 |
16 |
17 |
18 | Steps
19 |
20 | - Go to Host > Extensions.
21 |
22 |
23 |
24 | - Click Create New Module.
25 |
26 |
27 |
28 | - For Create Module From, choose New.
29 |
30 |
31 |
32 | - In Edit Module Definition,
33 |
34 | - For Owner Folder and Module Folder, click Add Folder.
35 |
36 | - Enter the folder names and click Create Folder for each.
37 |
- Choose the language you prefer (C# or VB).
38 | - Enter the filename and the module name.
39 | - (Optional) Add a description.
40 | - Check Add Test Page?
41 |
42 |
43 |
44 |
45 | - You'll see the test page with the name of your module.
46 |
47 |
48 |
49 | - To modify the module,
50 |
51 | - Click the gear icon and choose Develop.
52 |
53 |
54 | - Delete all the lines, except the first one.
55 |
56 |
57 | - Add the following line which says "Hello" and add the current user's display name.
58 |
59 | <h1>Hello, <%: UserInfo.DisplayName %></h1>
60 |
61 |
62 |
63 | - Click Update.
64 |
65 |
66 |
67 | - The test page displays the new functionality.
68 |
69 |
70 |
71 |
72 |
73 | See Also
74 |
75 | - Creating Modules
76 | - Create an MVC module.
77 | - Create a SPA module.
78 | - DNN 8 API Reference
79 |
80 |
81 |
82 | Sources
83 |
84 | - Walker, Shaun. Professional DNN7 Open Source. Indianapolis, IN: Wrox, 2015.
85 |
86 |
--------------------------------------------------------------------------------
/common/samples/theme/MyThemeManifest.dnn:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | My Sample Theme
6 | My Sample Theme is a demonstration theme.
7 | MyIcon.png
8 |
9 | MyCompany
10 | MyCompany Corporation
11 | www.example.com
12 | support@example.com
13 |
14 | true
17 |
18 | 08.00.00
19 |
20 |
21 |
22 |
23 |
24 | MyPackageLicense.txt
25 |
26 |
27 | MyPackageReleaseNotes.txt
28 |
29 |
30 |
31 |
32 |
33 | MyThemeName
35 |
36 |
37 |
38 | css
39 | skin.css
40 |
41 | ...
42 |
43 |
44 |
45 | fonts
46 | NameOfFont.ttf
47 |
48 | ...
49 |
50 |
51 |
52 | images
53 | MyImage.png
54 |
55 | ...
56 |
57 |
58 | ...
59 |
60 |
61 |
62 |
63 | ...
64 |
68 |
69 |
70 | MyContainerName
72 |
73 |
74 |
75 | MyContainer.ascx
76 |
77 |
78 |
80 | ...
81 |
82 |
83 | ...
84 |
85 |
86 |
87 |
88 |
89 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | _build/
2 |
3 | ## Ignore Visual Studio temporary files, build results, and
4 | ## files generated by popular Visual Studio add-ons.
5 |
6 | # User-specific files
7 | *.suo
8 | *.user
9 | *.userosscache
10 | *.sln.docstates
11 |
12 | # User-specific files (MonoDevelop/Xamarin Studio)
13 | *.userprefs
14 |
15 | # Build results
16 | [Dd]ebug/
17 | [Dd]ebugPublic/
18 | [Rr]elease/
19 | [Rr]eleases/
20 | x64/
21 | x86/
22 | build/
23 | bld/
24 | [Bb]in/
25 | [Oo]bj/
26 |
27 | # Visual Studo 2015 cache/options directory
28 | .vs/
29 |
30 | # MSTest test Results
31 | [Tt]est[Rr]esult*/
32 | [Bb]uild[Ll]og.*
33 |
34 | # NUNIT
35 | *.VisualState.xml
36 | TestResult.xml
37 |
38 | # Build Results of an ATL Project
39 | [Dd]ebugPS/
40 | [Rr]eleasePS/
41 | dlldata.c
42 |
43 | *_i.c
44 | *_p.c
45 | *_i.h
46 | *.ilk
47 | *.meta
48 | *.obj
49 | *.pch
50 | *.pdb
51 | *.pgc
52 | *.pgd
53 | *.rsp
54 | *.sbr
55 | *.tlb
56 | *.tli
57 | *.tlh
58 | *.tmp
59 | *.tmp_proj
60 | *.log
61 | *.vspscc
62 | *.vssscc
63 | .builds
64 | *.pidb
65 | *.svclog
66 | *.scc
67 |
68 | # Chutzpah Test files
69 | _Chutzpah*
70 |
71 | # Visual C++ cache files
72 | ipch/
73 | *.aps
74 | *.ncb
75 | *.opensdf
76 | *.sdf
77 | *.cachefile
78 |
79 | # Visual Studio profiler
80 | *.psess
81 | *.vsp
82 | *.vspx
83 |
84 | # TFS 2012 Local Workspace
85 | $tf/
86 |
87 | # Guidance Automation Toolkit
88 | *.gpState
89 |
90 | # ReSharper is a .NET coding add-in
91 | _ReSharper*/
92 | *.[Rr]e[Ss]harper
93 | *.DotSettings.user
94 |
95 | # JustCode is a .NET coding addin-in
96 | .JustCode
97 |
98 | # TeamCity is a build add-in
99 | _TeamCity*
100 |
101 | # DotCover is a Code Coverage Tool
102 | *.dotCover
103 |
104 | # NCrunch
105 | _NCrunch_*
106 | .*crunch*.local.xml
107 |
108 | # MightyMoose
109 | *.mm.*
110 | AutoTest.Net/
111 |
112 | # Web workbench (sass)
113 | .sass-cache/
114 |
115 | # Installshield output folder
116 | [Ee]xpress/
117 |
118 | # DocProject is a documentation generator add-in
119 | DocProject/buildhelp/
120 | DocProject/Help/*.HxT
121 | DocProject/Help/*.HxC
122 | DocProject/Help/*.hhc
123 | DocProject/Help/*.hhk
124 | DocProject/Help/*.hhp
125 | DocProject/Help/Html2
126 | DocProject/Help/html
127 |
128 | # Click-Once directory
129 | publish/
130 |
131 | # Publish Web Output
132 | *.[Pp]ublish.xml
133 | *.azurePubxml
134 | # TODO: Comment the next line if you want to checkin your web deploy settings
135 | # but database connection strings (with potential passwords) will be unencrypted
136 | *.pubxml
137 | *.publishproj
138 |
139 | # NuGet Packages
140 | *.nupkg
141 | # The packages folder can be ignored because of Package Restore
142 | **/packages/*
143 | # except build/, which is used as an MSBuild target.
144 | !**/packages/build/
145 | # Uncomment if necessary however generally it will be regenerated when needed
146 | #!**/packages/repositories.config
147 |
148 | # Windows Azure Build Output
149 | csx/
150 | *.build.csdef
151 |
152 | # Windows Store app package directory
153 | AppPackages/
154 |
155 | # Others
156 | *.[Cc]ache
157 | ClientBin/
158 | [Ss]tyle[Cc]op.*
159 | ~$*
160 | *~
161 | *.dbmdl
162 | *.dbproj.schemaview
163 | *.pfx
164 | *.publishsettings
165 | node_modules/
166 | bower_components/
167 |
168 | # RIA/Silverlight projects
169 | Generated_Code/
170 |
171 | # Backup & report files from converting an old project file
172 | # to a newer Visual Studio version. Backup files are not needed,
173 | # because we have git ;-)
174 | _UpgradeReport_Files/
175 | Backup*/
176 | UpgradeLog*.XML
177 | UpgradeLog*.htm
178 |
179 | # SQL Server files
180 | *.mdf
181 | *.ldf
182 |
183 | # Business Intelligence projects
184 | *.rdl.data
185 | *.bim.layout
186 | *.bim_*.settings
187 |
188 | # Microsoft Fakes
189 | FakesAssemblies/
190 |
191 | # Node.js Tools for Visual Studio
192 | .ntvs_analysis.dat
193 |
194 | # Visual Studio 6 build log
195 | *.plg
196 |
197 | # Visual Studio 6 workspace options file
198 | *.opt
199 |
200 | project.lock.json
201 | common/ext/__pycache__/
202 |
--------------------------------------------------------------------------------
/common/gettingstarted/Install-Extensions.inc:
--------------------------------------------------------------------------------
1 |
2 | Overview
3 | ---------
4 |
5 | A DNN extension can contain a module, a theme, or other components that extend the functionality of the DNN Platform.
6 |
7 | .. include:: /../common/bptext/3rdPartyExtensions.inc
8 |
9 | You can also create your custom `modules `_ and `themes `_.
10 |
11 |
12 | The extension must be added by the host / super user account to the DNN installation before it can be used in any of the websites.
13 |
14 | Prerequisites
15 | --------------
16 |
17 | * .. include:: /../common/bptext/PrereqHost.inc
18 |
19 | Steps
20 | ------
21 |
22 | 1. Go to **Host** > **Extensions**.
23 |
24 | |host-ext|
25 |
26 | #. Click **Install Extension Wizard**.
27 |
28 | |ext-wiz|
29 |
30 | #. Click **Choose File** and select the zip file of the extension. The button name changes to the name of the zip file.
31 |
32 | |choose-zip|
33 |
34 | #. Informational pages will be displayed one after the other:
35 |
36 | 1. **Package Information** includes the extension's version and description, as well as information about the creator.
37 |
38 | |pkg-info|
39 |
40 | #. **Release Notes** displays what's new in the current release of the extension.
41 |
42 | |release-notes|
43 |
44 | #. **License** displays the creator's license terms. Accept the license to continue.
45 |
46 | |license|
47 |
48 | #. **Package Installation Report** displays a log of actions performed by the installation.
49 |
50 | |pkg-report|
51 |
52 | #. Verify that the newly installed extension appears in the list under the **Installed Extensions** tab.
53 |
54 | |done|
55 |
56 |
57 | See Also
58 | --------
59 |
60 | .. The following sections will cause warnings
61 |
62 | .. only:: design
63 |
64 | .. class:: collapse-list
65 |
66 | * :doc:`../HowTo/PackagingThemes/Creating-Package`
67 | * :doc:`../HowTo/PackagingThemes/Dnn-Manifest`
68 |
69 |
70 | .. only:: dev
71 |
72 | .. class:: collapse-list
73 |
74 | * :doc:`../HowTo/PackagingExtensions/Creating-Package`
75 | * :doc:`../HowTo/PackagingExtensions/Dnn-Manifest`
76 |
77 | Sources
78 | -------
79 |
80 | .. class:: collapse-list
81 |
82 | * DNN Community blog: `Installing Our Module in Another DNN Instance `_ by `Clinton Patterson `_
83 |
84 | * DNN Forge: `2sxc 8.0.11 - Amazing Content and Apps `_ by `2sxc `_
85 |
86 | .. ***** Image Substitutions *****
87 |
88 | .. |host-ext| image:: /../common/img/scr-InstallExt-1.png
89 | :class: img-responsive img-600
90 | :alt: Host Extensions
91 |
92 | .. |ext-wiz| image:: /../common/img/scr-InstallExt-3.png
93 | :class: img-responsive img-600
94 | :alt: Install Extension Wizard
95 |
96 | .. |choose-zip| image:: /../common/img/scr-InstallExt-4.png
97 | :class: img-responsive img-600
98 | :alt: Choose zip file of the extension
99 |
100 | .. |pkg-info| image:: /../common/img/scr-InstallExt-6.png
101 | :class: img-responsive img-600
102 | :alt: Package Information
103 |
104 | .. |release-notes| image:: /../common/img/scr-InstallExt-7.png
105 | :class: img-responsive img-600
106 | :alt: Release Notes
107 |
108 | .. |license| image:: /../common/img/scr-InstallExt-8.png
109 | :class: img-responsive img-600
110 | :alt: License
111 |
112 | .. |pkg-report| image:: /../common/img/scr-InstallExt-10.png
113 | :class: img-responsive img-600
114 | :alt: Package Installation Report
115 |
116 | .. |done| image:: /../common/img/scr-InstallExt-11.png
117 | :class: img-responsive img-600
118 | :alt: New extension appears under Installed Extensions.
119 |
--------------------------------------------------------------------------------
/common/gettingstarted/Set-Up-SQL-Server.inc:
--------------------------------------------------------------------------------
1 |
2 | Steps
3 | -----
4 |
5 | #. Install SQL. (`Check compatible versions. `_)
6 |
7 | a. Choose **New SQL Server stand-alone installation...**.
8 |
9 | |new-server|
10 |
11 | #. Include any product updates.
12 |
13 | #. Accept the defaults in **Feature Selection**, **Instance Configuration**, and **Server Configuration**.
14 |
15 | #. In **Database Engine Configuration**, under **Authentication Mode**, choose **Mixed Mode**.
16 |
17 | |mixed-mode|
18 |
19 | #. Accept the defaults in remaining dialogs.
20 |
21 |
22 | #. **Create a SQL database for your website.**
23 |
24 | a. In the **Microsoft SQL Server Management Studio** > **Object Explorer**, right-click on **Databases**, and choose **New Database...**.
25 |
26 | |new-db|
27 |
28 | #. Enter the name of the new database. Click OK.
29 |
30 | |db-name|
31 |
32 | .. note::
33 |
34 | Remember the database name, because it will be required by the DNN Installation Wizard.
35 |
36 | #. **Create a SQL user account.**
37 |
38 | a. Under **Security**, right-click on **Logins**, and choose **New Login...**.
39 |
40 | |new-login|
41 |
42 | #. Enter the username, choose **SQL Server authentication**, add a password, uncheck **Enforce password policy**, and choose the database.
43 |
44 | |sql-auth|
45 |
46 | .. note::
47 |
48 | Remember the username and password, because they will be required by the DNN Installation Wizard.
49 |
50 |
51 | #. Give the new SQL user **db_owner** access to the new database.
52 |
53 | a. In **Object Explorer**, under your database > **Security**, right-click on **Users**, and choose **New User...**.
54 |
55 | |new-user|
56 |
57 | #. Set **User type** to **SQL user with login**.
58 |
59 | |user-type|
60 |
61 | #. Enter the username of the account you just created, then click **Check Names**.
62 |
63 | |win-features|
64 |
65 | #. Under **Select a page**, select **Membership**, and check the **db_owner** database role membership.
66 |
67 | |db-owner|
68 |
69 | .. include:: /../common/gettingstarted/Set-Up-Sources.inc
70 |
71 | .. ***** Image Substitutions *****
72 |
73 | .. |new-server| image:: /../common/img/scr-InstallSQL-1.png
74 | :class: img-responsive img-600
75 | :alt: New SQL Server stand-alone installation
76 |
77 | .. |mixed-mode| image:: /../common/img/scr-InstallSQL-6.png
78 | :class: img-responsive img-600
79 | :alt: Database Engine Conf > Authentication Mode > Mixed Mode
80 |
81 | .. |new-db| image:: /../common/img/scr-SetupSQL-2.png
82 | :class: img-responsive img-600
83 | :alt: In Object Explorer, right-click Databases, choose New Database.
84 |
85 | .. |db-name| image:: /../common/img/scr-SetupSQL-3.png
86 | :class: img-responsive img-600
87 | :alt: Enter new database name.
88 |
89 | .. |new-login| image:: /../common/img/scr-SetupSQL-4.png
90 | :class: img-responsive img-600
91 | :alt: Under Security, right-click Logins, choose New Login.
92 |
93 | .. |sql-auth| image:: /../common/img/scr-SetupSQL-5.png
94 | :class: img-responsive img-600
95 | :alt: Choose SQL Server authentication. Uncheck Enforce password policy.
96 |
97 | .. |new-user| image:: /../common/img/scr-SetupSQL-6.png
98 | :class: img-responsive img-600
99 | :alt: Under your database > Security, right-click Users, choose New User.
100 |
101 | .. |user-type| image:: /../common/img/scr-SetupSQL-7.png
102 | :class: img-responsive img-600
103 | :alt: User type = SQL user with login
104 |
105 | .. |win-features| image:: /../common/img/scr-SetupSQL-8.png
106 | :class: img-responsive img-600
107 | :alt: Enter the new account's login name, then click Check Names.
108 |
109 | .. |db-owner| image:: /../common/img/scr-SetupSQL-10.png
110 | :class: img-responsive img-600
111 | :alt: For Membership page, check db_owner
112 |
113 |
114 |
--------------------------------------------------------------------------------
/common/gettingstarted/Set-Up-DNN-Folder.inc:
--------------------------------------------------------------------------------
1 |
2 | Steps
3 | -----
4 |
5 | #. `Download DNN and extract the files. `_ The folder where you extract the files becomes the DNN installation folder.
6 |
7 | .. note:: Developers and Designers:
8 | :class: has-title
9 |
10 | For module or theme development, you don't need the DNN source files.
11 |
12 |
13 | #. Determine the user account used to run your website. The account name differs, depending on your IIS and Windows version:
14 |
15 | .. class:: table-bordered dnn-table
16 |
17 | +-------------------------+------------------------+---------------------------------------+
18 | |If your OS is |and your IIS version is |then the account name is |
19 | +=========================+========================+=======================================+
20 | |Windows Vista |IIS 7 |**localmachine\\Network Service** |
21 | | | | |
22 | |Windows Server 2008 | | |
23 | +-------------------------+------------------------+---------------------------------------+
24 | |Windows 7 |IIS 7.5 |the **NETWORK SERVICE** account, or |
25 | | | | |
26 | |Windows Server 2008 R2 | |the **IIS AppPool\\AppPoolName**, which|
27 | +-------------------------+------------------------+is the name of the automatically |
28 | |Windows 8 |IIS 8 |generated pool. |
29 | | | | |
30 | |Windows Server 2012 | | |
31 | +-------------------------+------------------------+ |
32 | |Windows 10 |IIS 10 | |
33 | +-------------------------+------------------------+---------------------------------------+
34 |
35 | #. Give **Full** or **Modify** permissions for the DNN installation folder to the user account that will run your website.
36 |
37 | .. Make this section expandable. Do we really want to go into this much detail?
38 |
39 | a. In Windows Explorer, right-click on the DNN installation folder, and choose **Properties**.
40 |
41 | |folder-perm|
42 |
43 | #. Go to the **Security** tab and click **Edit...**.
44 |
45 | |edit-security|
46 |
47 | #. Click **Add...**.
48 |
49 | |add-perm|
50 |
51 | #. In **Select Users or Groups**, enter the user name, then click **Check Names**. After the name is resolved, click OK.
52 |
53 | |check-name|
54 |
55 | #. Highlight the newly added user name and check **Full Control** and **Modify** under **Allow**.
56 |
57 | |full-control|
58 |
59 | .. include:: /../common/gettingstarted/Set-Up-Sources.inc
60 |
61 | .. ***** Image Substitutions *****
62 |
63 | .. |folder-perm| image:: /../common/img/scr-FolderPerms-1.png
64 | :class: img-responsive img-600
65 | :alt: Right-click on the DNN folder and choose Properties
66 |
67 | .. |edit-security| image:: /../common/img/scr-FolderPerms-2.png
68 | :class: img-responsive img-600
69 | :alt: In the Security tab, click Edit...
70 |
71 | .. |add-perm| image:: /../common/img/scr-FolderPerms-3.png
72 | :class: img-responsive img-600
73 | :alt: Click Add...
74 |
75 | .. |check-name| image:: /../common/img/scr-FolderPerms-5a.png
76 | :class: img-responsive img-600
77 | :alt: In Select Users or Groups, enter the user name, then click Check Names.
78 |
79 | .. |full-control| image:: /../common/img/scr-FolderPerms-6.png
80 | :class: img-responsive img-600
81 | :alt: Highlight the newly added user name and check Full Control and Modify under Allow.
82 |
83 |
--------------------------------------------------------------------------------
/design/Theme-Objects.rst:
--------------------------------------------------------------------------------
1 | ===============
2 | Theme Objects
3 | ===============
4 |
5 | .. Overview
6 | .. --------
7 |
8 | .. How to have checkboxes on top that would filter what's displayed; i.e., HTML vs ASCX vs object token, DNN version. -->
9 |
10 | Descriptions
11 | ------------
12 |
13 | ACTIONBUTTON
14 | Displays a an action from the :term:`module action menu`.
15 |
16 | BREADCRUMB
17 | Displays the path to the current tab in the format (**>** is the default separator):
18 |
19 | PageName1 > PageName2 > PageName3
20 |
21 | CONTROLPANEL
22 | Displays the DNN control panel. If no CONTROLPANEL theme object is defined in the theme, then a control panel control will be inserted at the top of the page.
23 |
24 | COPYRIGHT
25 | Displays the copyright notice for the website.
26 |
27 | CURRENTDATE
28 | Displays the current date on the server.
29 |
30 | DDRMENU
31 | Displays a menu using the DDRMenucontrol.
32 |
33 | DNNCSSEXCLUDE
34 | Prevents a stylesheet reference from being included in the page.
35 |
36 | DNNCSSINCLUDE
37 | Add a stylesheet reference to the page.
38 |
39 | DNNJSEXCLUDE
40 | Prevents a JavaScript file reference from being included in the page.
41 |
42 | DNNJSINCLUDE
43 | Add a JavaScript file reference to the page.
44 |
45 | DOTNETNUKE
46 | Displays the copyright notice for DotNetNuke. (optional)
47 |
48 | DROPDOWNACTIONS
49 | Displays the :term:`module action menu` as a drop down list.
50 |
51 | HELP
52 | Displays a Help link, which sends email to the website's administrator, using the user's default email client.
53 |
54 | HOSTNAME
55 | Displays the host title linked to the host URL. The host title and host URL are defined on the host settings page.
56 |
57 | ICON
58 | Displays the module icon.
59 |
60 | JQUERY
61 | Adds jQuery JavaScript reference to the page.
62 |
63 | LANGUAGE
64 | Displays the language selector dropdown list or the language flags based on the theme object attribute settings.
65 |
66 | LEFTMENU
67 | Displays a vertical menu layout.
68 |
69 | LINKACTIONS
70 |
71 | LINKS
72 | Displays a flat menu of links associated with the current tab level and the parent node.
73 |
74 | LOGIN
75 | Displays “Login” for anonymous users and “Logout” for authenticated users.
76 |
77 | LOGO
78 | Displays the website's logo.
79 |
80 | NAV
81 | Displays a menu, according to the type specified in the ProviderName attribute.
82 |
83 | PRINTMODULE
84 | Displays a link for the Print action from the :term:`module action menu`
85 |
86 | PRIVACY
87 | Displays a link to the Privacy Information page for the website.
88 |
89 | SEARCH
90 | Displays the search input box.
91 |
92 | SIGNIN
93 | Displays the login control.
94 |
95 | STYLES
96 | Allows you to add Internet Explorer-specific stylesheets to your theme.
97 |
98 | TAGS
99 | Displays the Tag control allowing users to view and edit tags associated with the page or module.
100 |
101 | TERMS
102 | Displays a link to the Terms and Conditions page of the website.
103 |
104 | TEXT
105 | Displays localized text in your theme and supports the use of token replacement.
106 |
107 | TITLE
108 | Displays the module title.
109 |
110 | Toast
111 | Adds the toast notification control to the page. Toast messages will be shown when a new user notification or message is received.
112 |
113 | TREEVIEW
114 | Displays a menu, similar to the Windows Explorer menu, using the DNN Treeview Control.
115 |
116 | USER
117 | Displays a “Register” link for anonymous users or the user's name for authenticated users.
118 |
119 | VISIBILITY
120 | Displays a visibility control for the module allowing users to show or hide a given module on the page.
121 |
122 | Sources
123 | -------
124 |
125 | .. class:: collapse-list
126 |
127 | * `Timo Breumelhof `_
130 |
--------------------------------------------------------------------------------
/common/gettingstarted/Set-Up-IIS.inc:
--------------------------------------------------------------------------------
1 |
2 | You can create a new IIS website or set up an existing one.
3 |
4 | Prerequisites
5 | -------------
6 |
7 | * :doc:`DNN installed with folder permissions for the user account that will run your website.`
8 |
9 |
10 | Steps
11 | -----
12 |
13 | #. Enable IIS. (`Check compatible versions. `_)
14 |
15 | a. Go to **Control Panel** > **Programs and Features** > **Turn Windows features on or off**.
16 |
17 | |win-features|
18 |
19 | #. Under **Internet Information Services**, turn on the following:
20 |
21 | * **Web Management Tools**: IIS Management Console
22 |
23 | * **World Wide Web Services**
24 |
25 | .. class:: collapse-list
26 |
27 | * **Application Development Features**: ASP.NET 3.5 and 4.6
28 |
29 | * **Common HTTP Features**: Default Document and Static Content
30 |
31 | * (Optional) **Security**: Basic Authentication
32 |
33 | .. TODO: Per Joe's tech review on 20160106: Add Windows Authentication here and in the screenshot.
34 |
35 | #. **Internet Information Services Hostable Web Core**
36 |
37 | |IIS-options|
38 |
39 | .. TODO: Per Joe's tech review on 20160106: Add (Optional) Performance Features: Static Content Compression
40 |
41 |
42 | #. You can create a new website or set up an existing one for use with DNN.
43 |
44 | * To create a new website and point it to the DNN installation folder:
45 |
46 | a. Go to **Control Panel** > **Administrative Tools** > **Internet Information Services (IIS) Manager**.
47 |
48 | #. In the **Connections** panel, expand your host tree, right-click on **Sites**, and choose **Add Website**.
49 |
50 | |add-website|
51 |
52 | #. Enter the new site's name and choose the location.
53 |
54 | |site-name|
55 |
56 | #. **Developers and Designers:** If setting up a local development environment, you can use :code:`www.dnndev.me` (or any subdomain) as the Host name. DNNDEV.ME is a registered domain which points to the loopback address of 127.0.0.1, so it will always resolve locally.
57 |
58 | **Administrators:** If setting up a live site, use your site's domain.
59 |
60 | |dnndev-me|
61 |
62 | * To use an existing IIS website:
63 |
64 | a. In the **Connections** panel, right-click on the name of the existing site, and choose **Edit Bindings...**.
65 |
66 | |edit-bindings|
67 |
68 | #. In **Site Bindings**, click **Add...**. Then, in **Add Site Binding**, enter :code:`www.dnndev.me` as the Host name.
69 |
70 | |site-binding|
71 |
72 |
73 | #. If you do not use **NETWORK SERVICE** as the user account to run your website, verify that the automatically created :code:`IIS AppPool\AppPoolName` has **Full** or **Modify** permissions for the DNN installation folder. See :doc:`Set Up DNN Folder and the User Account `
74 |
75 | .. include:: /../common/gettingstarted/Set-Up-Sources.inc
76 |
77 | .. ***** Image Substitutions *****
78 |
79 | .. |win-features| image:: /../common/img/scr-InstallIIS-1.png
80 | :class: img-responsive img-600
81 | :alt: Turn Windows features on or off
82 |
83 | .. |IIS-options| image:: /../common/img/scr-InstallIIS-6.png
84 | :class: img-responsive img-600
85 | :alt: IIS options to turn on
86 |
87 | .. |add-website| image:: /../common/img/scr-NewSiteInIIS-1.png
88 | :class: img-responsive img-600
89 | :alt: In Connections, Sites, then Add Website
90 |
91 | .. |site-name| image:: /../common/img/scr-NewSiteInIIS-2.png
92 | :class: img-responsive img-600
93 | :alt: Enter the new site's name and choose the location.
94 |
95 | .. |dnndev-me| image:: /../common/img/scr-NewSiteInIIS-4.png
96 | :class: img-responsive img-600
97 | :alt: For local, use www.dnndev.me.
98 |
99 | .. |edit-bindings| image:: /../common/img/scr-NewSiteInIIS-6.png
100 | :class: img-responsive img-600
101 | :alt: Right-click on the site and choose Edit Bindings.
102 |
103 | .. |site-binding| image:: /../common/img/scr-NewSiteInIIS-7.png
104 | :class: img-responsive img-600
105 | :alt: For local, use www.dnndev.me.
106 |
107 |
--------------------------------------------------------------------------------
/design/HowTo/CreatingThemes/Create-CSS.rst:
--------------------------------------------------------------------------------
1 | ==================
2 | Style Your Theme
3 | ==================
4 |
5 | Overview
6 | --------
7 |
8 | Modern webpage design relies heavily on the use of Cascading Style Sheets (CSS). Theme designers need a way to associate style sheets with their themes and containers in order to create designs that can fully leverage the capabilities of modern browsers.
9 |
10 | Themes and container packages can utilize master style sheets that apply to all layouts or containers in the package. In addition, a CSS file can be associated with a specific layout template or container by giving it the same filename and placing it in the same folder. When a layout template (or container) is applied to a webpage (or module), all of the associated CSS files are automatically applied. Example: These three files are automatically associated with each other:
11 |
12 | .. class:: collapse-list
13 |
14 | * MyLayout.ascx
15 | * MyLayout.css
16 | * MyLayout.doctype.xml
17 |
18 | CSS files are applied hierarchically. If a style is defined for an element in multiple CSS files with equal specificity, the last CSS that mentions the same element overrides the style definitions in previously loaded CSS files (See `W3C specification on Cascading and Inheritance `_). By default, the CSS files are loaded in this order:
19 |
20 | 1. **Default.css** (~/Portals/_default/default.css) - The default CSS for the website.
21 |
22 | #. **module.css** (~/DesktopModules/ModuleName/module.css) - The CSS file for every module type that appears on the page.
23 |
24 | #. **Skin.css** (~/Portals/_default/Skins/SkinPackageName/skin.css) - The master CSS for the theme must be called skin.css.
25 |
26 | #. **MyThemeTemplate.css** (~/Portals/_default/Skins/SkinPackageName/MyThemeTemplate.css) - The CSS for a specific layout template.
27 |
28 | #. **Container.css** (~/Portals/_default/Containers/ContainerPackageName/container.css) - The master CSS for the theme containerss must be called container.css.
29 |
30 | #. **MyContainer.css**
31 | (~/Portals/_default/Containers/ContainerPackageName/container.css) - The CSS for all containers in your theme.
32 |
33 | #. **Portal.css** (~/Portals/PortalID/portal.css) - The CSS that can override elements in the installed themes. Website administrators can use this to override any styles in the theme or containers.
34 |
35 | Steps
36 | -----
37 |
38 | 1. Create a master style sheet for your theme (skin.css).
39 |
40 | This style sheet should contain the following styles:
41 |
42 | .. class:: collapse-list
43 |
44 | * common styles that apply for all of the layouts in your theme.
45 | * styles for theme objects used in all of your layouts.
46 |
47 | #. Create a separate style sheet for each layout in your theme (MyThemeLayout.css)
48 |
49 | Each style sheet should contain the following styles:
50 |
51 | .. class:: collapse-list
52 |
53 | * styles that are specific to a layout
54 | * styles for themes object that are only used in the associated layout
55 |
56 | #. Create a master style sheet for your containers (container.css).
57 |
58 | This style sheet should contain the following styles:
59 |
60 | .. class:: collapse-list
61 |
62 | * common styles that apply for all of the containers in your theme.
63 | * styles for theme objects used in all of your containers.
64 |
65 | #. Create a separate style sheet for each container type in your theme (MyThemeLayout.css)
66 |
67 | Each style sheet should contain the following styles:
68 |
69 | .. class:: collapse-list
70 |
71 | * styles that are specific to a container
72 | * styles for themes object that are only used in the associated container
73 |
74 | .. note::
75 | These style sheets are not required. You may include all of your styles in one master theme style sheet (skin.css). If you combine container styles in the style sheet for your theme, then the container will only display properly when used with your theme.
76 |
77 | See Also
78 |
79 | .. class:: collapse-list
80 |
81 | * DNN Wiki: `DotNetNuke Skins `_
82 | * :doc:`Create Layout Template `
83 | * :doc:`Create Container `
84 |
85 | Sources
86 | -------
87 |
88 | * DNN Professional Training: `Creating HTML Skins `_
89 |
--------------------------------------------------------------------------------
/design/HowTo/CreatingThemes/Test-Html-Layout.rst:
--------------------------------------------------------------------------------
1 | ===================
2 | Test HTML Layouts
3 | ===================
4 |
5 | Overview
6 | --------
7 |
8 | Although you can define your layout templates or containers in either HTML or ASCX, DNN uses ASCX internally. During development, if you are using HTML based layouts, you will need to convert them to ascx format in order to test your layout.
9 |
10 | .. note::
11 |
12 | DNN will automatically convert HTML layouts when a skin or container package is installed. There is no requirement to include ascx files in your HTML based theme.
13 |
14 | The conversion:
15 |
16 | .. class:: collapse-list
17 |
18 | * adds the **Control** directive code at the top of the file,
19 |
20 | * adds **Register** directive code for each token used within the file, and
21 |
22 | * replaces the HTML tokens with the appropriate ASP.Net controls.
23 |
24 | Prerequisites
25 | -------------
26 |
27 | .. include:: /../common/bptext/PrereqHost.inc
28 |
29 | Steps
30 | -----
31 |
32 | 1. Add your theme to your local DNN installation.
33 |
34 | a. Create a folder for your theme inside the :code:`Portals\`*websitename*:code:`\Skins folder` of your DNN installation. (*websitename* could be a number representing the PortalID.) The folder name becomes your theme name. Example: If you create the folder :code:`C:\DNN8\Portals\MyWebsite\Skins\MyTheme`, **MyTheme** becomes your theme's name.
35 |
36 | #. Copy your files to the new theme folder.
37 |
38 | #. In :code:`www.dnndev.me`, log in as an admin or host, and go to **Admin** > **Advanced Settings** (double-gear tab) > **Themes**.
39 |
40 | |themes|
41 |
42 |
43 | #. Choose your new theme in the **Themes** dropdown, then click **Parse Theme Package**.
44 |
45 | |parse-theme|
46 |
47 |
48 | #. Confirm:
49 |
50 | * That a section appears under **Themes** for each converted HTML file.
51 | * That no errors appear in the log.
52 | * That the new ASCX file appears in the same folder as the HTML file.
53 |
54 | |error-check|
55 |
56 | .. note::
57 | The conversion only goes in one direction (from HTML to ASCX). To make changes to the layout template:
58 |
59 | * Make changes directly to the ASCX file.
60 | * Make the changes in your original HTML file and reconvert it to ASCX. **Warning:** This overrides prior changes made directly to the ASCX file.
61 |
62 | Example 1
63 | ---------
64 |
65 | This simple HTML layout template or container:
66 |
67 | .. code-block:: aspx-vb
68 |
69 |
70 |
71 | is converted to this ASCX layout template:
72 |
73 | .. code-block:: aspx-vb
74 |
75 | <%@ Control language="vb" AutoEventWireup="false" Explicit="True" Inherits="DotNetNuke.UI.Skins.Skin">
76 |
77 |
78 | Example 2
79 | ---------
80 |
81 | This HTML layout template or container, which includes the :code:`[COPYRIGHT]` token:
82 |
83 | .. code-block:: aspx-vb
84 |
85 |
86 | [COPYRIGHT]
87 |
88 |
89 | is converted to this ASCX layout template:
90 |
91 | .. code-block:: aspx-vb
92 |
93 | <%@ Control language="vb" AutoEventWireup="false" Explicit="True" Inherits="DotNetNuke.UI.Skins.Skin" %>
94 | <%@ Register TagPrefix="dnn" TagName="COPYRIGHT" Src="~/Admin/Skins/Copyright.ascx" %>
95 |
96 | `_
105 |
106 | * :doc:`Create Layout Template `
107 |
108 | * :doc:`Create a Container `
109 |
110 |
111 | Sources
112 | -------
113 |
114 | * DNN Community Blog: `DotNetNuke Skinning 101 (Part 1) `_ by `Joe Brinkman `_
115 |
116 | .. ***** Image Substitutions *****
117 |
118 | .. |themes| image:: /../common/img/scr-HTMLtoASCX-4.png
119 | :class: img-responsive img-600
120 | :alt: Navigate to the themes page
121 |
122 | .. |parse-theme| image:: /../common/img/scr-HTMLtoASCX-10.png
123 | :class: img-responsive img-600
124 | :alt: Parse the theme
125 |
126 | .. |error-check| image:: /../common/img/scr-HTMLtoASCX-11.png
127 | :class: img-responsive img-600
128 | :alt: Ensure there are no errors
129 |
--------------------------------------------------------------------------------
/common/themes/dnn/styles/home.less:
--------------------------------------------------------------------------------
1 | .welcome-hero-wrapper{
2 | padding-top: 40px;
3 | background: white;
4 | margin: 0 0 60px;
5 | text-align: center;
6 |
7 | .welcome-hero{
8 | display: inline-block;
9 | max-width: 800px;
10 | width: 100%;
11 | }
12 | }
13 |
14 | // Card Styles
15 | .card-row{
16 | .c-B;
17 | background-image: linear-gradient(to bottom, white 12%, #f4f4f4 30%);
18 | margin: 0 -15px;
19 | }
20 | .home-card{
21 | background: white;
22 | display: block;
23 | border-bottom-style: solid;
24 | border-bottom-width: 10px;
25 | transition:all .18s ease-in;
26 | box-shadow: 0 0 0 #333;
27 | transform-origin:bottom;
28 | margin-bottom: 50px;
29 |
30 | &:hover{
31 | transform: scale3d(1.05, 1.05, 1.05);
32 | box-shadow:0 0 15px #333;
33 |
34 | text-decoration: none;
35 | }
36 |
37 | > .card-title{
38 | color: white;
39 | padding: 45px 0;
40 | display: block;
41 | text-align: center;
42 | width: 100%;
43 | font-size: 2em;
44 | text-transform: uppercase;
45 | }
46 |
47 | .card-img-wrapper{
48 | padding:45px 80px;
49 | border-color: #ccc;
50 | border-style: solid;
51 | border-width: 0 1px;
52 |
53 | @media(min-width: 992px){
54 | padding:45px 120px;
55 | }
56 | }
57 | .card-img{
58 | width:100%;
59 | display: block;
60 | }
61 |
62 |
63 | &.dev-card{
64 | border-bottom-color: @purple;
65 |
66 | > .card-title {
67 | background: @purple;
68 | }
69 | }
70 |
71 | &.admin-card{
72 | border-bottom-color: @green;
73 |
74 | > .card-title {
75 | background: @green;
76 | }
77 | }
78 |
79 | &.designer-card{
80 | border-bottom-color: @orange;
81 |
82 | > .card-title {
83 | background: @orange;
84 | }
85 | }
86 | }
87 |
88 | // Link Row styles
89 | .link-row{
90 | margin: 0 -15px 30px;
91 | .box-shadow(0 0px 5px);
92 |
93 | .page-link{
94 | text-align: center;
95 | font-size: 1.2em;
96 |
97 | a{
98 | display: block;
99 | padding: 1em 0;
100 | color: @gray-medium;
101 |
102 | &:hover{
103 | background:#ddd;
104 | text-decoration: none;
105 | color:@blue-light;
106 | }
107 | }
108 | }
109 | }
110 |
111 | // Listing Styles
112 | .listing-wrapper{
113 | margin-bottom: 75px;
114 | }
115 | .listing-header{
116 | border-bottom: 10px solid @blue-dark;
117 |
118 | h2{
119 | color:@blue-light;
120 | text-align: center;
121 | font-size: 1.4em;
122 | }
123 | }
124 | .listing-img-wrapper{
125 | text-align: center;
126 | max-width: 75%;
127 | margin: 0 auto;
128 | position: relative;
129 | }
130 | .listing-img{
131 | display: inline-block;
132 | width: 100%;
133 | }
134 | .listing{
135 | background: #f7f7f7;
136 | padding:0;
137 | margin: 0;
138 |
139 | li{
140 | display: block;
141 | padding: 0 15px;
142 |
143 | > a{
144 | .c-B;
145 | display: block;
146 | padding: 10px 0;
147 | }
148 |
149 | + li > a{
150 | border-top: 1px solid @blue-light;
151 | }
152 |
153 | &:hover{
154 | background: #e2e2e2;
155 |
156 | .listing-more{
157 | background: #e2e2e2;
158 |
159 | &:before{
160 | background: #e2e2e2;
161 | }
162 | }
163 | }
164 | }
165 |
166 | h3{
167 | color: @blue-light;
168 | padding: 0;
169 | margin: 0;
170 | text-transform: uppercase;
171 | font-size: 1.2em;
172 | }
173 | p{
174 | color:#888;
175 | overflow: hidden;
176 | height: 2.5em;
177 | margin: 0;
178 | }
179 | }
180 | .listing-icon-wrapper{
181 | width: 20%;
182 | float: left;
183 | padding: 10px 15px;
184 | }
185 | .listing-icon{
186 | }
187 |
188 | .listing-info{
189 | width: 80%;
190 | float: left;
191 | position: relative;
192 | }
193 | .listing-more{
194 | position: absolute;
195 | right: 0;
196 | bottom: -5px;
197 | background: #f7f7f7;
198 |
199 | &:before{
200 | content:'...';
201 | display: inline-block;
202 | background: #f7f7f7;
203 | padding:0 5px 0 0;
204 | }
205 | }
206 |
207 | .listing-details{
208 | margin: 0;
209 |
210 | dt{
211 | color: #888;
212 | float: left;
213 | margin-right: 5px;
214 |
215 | &:after{
216 | content: ':';
217 | }
218 | }
219 |
220 | dd{
221 | color: @blue-light;
222 | font-weight: bold;
223 | }
224 | }
225 |
226 | .listing-footer{
227 | border-top: 2px solid @blue-light;
228 | padding:5px 0;
229 |
230 | a{
231 | font-weight: bold;
232 | }
233 | }
234 |
235 | .comming-soon{
236 | margin: 0 0 2em;
237 | }
238 |
239 |
--------------------------------------------------------------------------------
/common/ext/link.py:
--------------------------------------------------------------------------------
1 | import sys
2 | from docutils import nodes
3 | from docutils.parsers.rst import Directive
4 | from docutils.parsers.rst import directives
5 |
6 |
7 | def setup(app):
8 | app.add_node(LinkNode, html=(LinkNode.visit_link, LinkNode.depart_link))
9 | app.add_directive('link', LinkDirective)
10 | return {'version': '0.1'}
11 |
12 | class LinkNode(nodes.General, nodes.Element):
13 |
14 | def __init__(self, text, **options):
15 | super(LinkNode, self).__init__(text, **options)
16 |
17 | def starttag(self, node, tagname, suffix='\n', empty=False, **attributes):
18 | """
19 | Construct and return a start tag given a node (id & class attributes
20 | are extracted), tag name, and optional attributes.
21 | """
22 | tagname = tagname.lower()
23 | prefix = []
24 | atts = {}
25 | ids = []
26 | for (name, value) in attributes.items():
27 | atts[name.lower()] = value
28 | classes = []
29 | languages = []
30 | # unify class arguments and move language specification
31 | for cls in node.get('classes', []) + atts.pop('class', '').split() :
32 | if cls.startswith('language-'):
33 | languages.append(cls[9:])
34 | elif cls.strip() and cls not in classes:
35 | classes.append(cls)
36 | if languages:
37 | # attribute name is 'lang' in XHTML 1.0 but 'xml:lang' in 1.1
38 | atts[self.lang_attribute] = languages[0]
39 | if classes:
40 | atts['class'] = ' '.join(classes)
41 | assert 'id' not in atts
42 | ids.extend(node.get('ids', []))
43 | if 'ids' in atts:
44 | ids.extend(atts['ids'])
45 | del atts['ids']
46 | if ids:
47 | atts['id'] = ids[0]
48 | for id in ids[1:]:
49 | # Add empty "span" elements for additional IDs. Note
50 | # that we cannot use empty "a" elements because there
51 | # may be targets inside of references, but nested "a"
52 | # elements aren't allowed in XHTML (even if they do
53 | # not all have a "href" attribute).
54 | if empty:
55 | # Empty tag. Insert target right in front of element.
56 | prefix.append('' % id)
57 | else:
58 | # Non-empty tag. Place the auxiliary tag
59 | # *inside* the element, as the first child.
60 | suffix += '' % id
61 | attlist = atts.items()
62 | attlist.sort()
63 | parts = [tagname]
64 | for name, value in attlist:
65 | # value=None was used for boolean attributes without
66 | # value, but this isn't supported by XHTML.
67 | assert value is not None
68 | if isinstance(value, list):
69 | values = [unicode(v) for v in value]
70 | parts.append('%s="%s"' % (name.lower(),
71 | self.attval(' '.join(values))))
72 | else:
73 | parts.append('%s="%s"' % (name.lower(),
74 | self.attval(unicode(value))))
75 | if empty:
76 | infix = ' /'
77 | else:
78 | infix = ''
79 | return ''.join(prefix) + '<%s%s>' % (' '.join(parts), infix) + suffix
80 |
81 | @staticmethod
82 | def visit_link(self, node):
83 | atts = {}
84 | atts['href'] = node['href']
85 | self.body.append(self.starttag(node, 'a', '', **atts))
86 |
87 | @staticmethod
88 | def depart_link(self, node=None):
89 | self.body.append('\n')
90 |
91 | class LinkDirective(Directive):
92 |
93 | required_arguments = 1
94 | optional_arguments = 0
95 | final_argument_whitespace = True
96 | option_spec = {
97 | 'class': directives.class_option
98 | }
99 | has_content = True
100 |
101 | def run(self):
102 | self.assert_has_content()
103 | env = self.state.document.settings.env
104 | config = env.config
105 | linkRoot = config["link_root"]
106 | text = '\n'.join(self.content)
107 |
108 | node = LinkNode(text, **self.options)
109 | node['classes'] += self.options.get('class', [])
110 |
111 | if self.arguments[0].startswith('~'):
112 | node['href'] = self.arguments[0].replace('~', linkRoot, 1)
113 | else:
114 | node['href'] = self.arguments[0]
115 |
116 | self.add_name(node)
117 | self.state.nested_parse(self.content, self.content_offset, node)
118 | return [node]
119 |
120 |
121 |
--------------------------------------------------------------------------------
/dev/HowTo/CreatingModules/Module-Templates.rst:
--------------------------------------------------------------------------------
1 | ==============================
2 | Using Module Templates
3 | ==============================
4 |
5 | Prerequisites
6 | -------------
7 |
8 | .. class:: collapse-list
9 |
10 | * :doc:`A local DNN installation <../../GettingStarted/Set-Up-DNN>` with **Host** permissions.
11 |
12 | * Visual Studio 2015 is the recommended IDE for developing DNN modules.
13 |
14 |
15 | Steps
16 | -----
17 |
18 | #. **Download and install the templates.**
19 |
20 | * For Chris Hammond's templates,
21 |
22 | a. Run Visual Studio as an administrator.
23 |
24 | #. Go to **Tools** > **Extensions and Updates**.
25 |
26 | |extensions|
27 |
28 | #. Highlight the **Online** > **Visual Studio Gallery** tree and search for :code:`DotNetNuke`.
29 |
30 | |search-dnn|
31 |
32 | #. Click the **Download** button for the **DotNetNuke Project Templates**.
33 |
34 | .. note::
35 |
36 | See `Chris Hammond's instructions `_ for other installation methods.
37 |
38 | * For the DNN 8 templates,
39 |
40 | a. `Download the appropriate .vsix file. `_ Two are included:
41 |
42 | .. class:: collapse-list
43 |
44 | * Dnn.Mvc.Module.vsix
45 |
46 | * Dnn.Spa.Module.vsix
47 |
48 | |download-templates|
49 |
50 | #. In your download folder, double-click the .vsix file to install the template in Visual Studio.
51 |
52 | #. **Create a new Visual Studio project.**
53 |
54 | a. Run Visual Studio as an administrator.
55 |
56 | #. **File** > **New** > **Project**
57 |
58 | #. Select the template for the new project.
59 |
60 | * For Chris Hammond's templates, go to **Installed** > **Templates** > **Visual C#** or **Visual Basic** > **DotNetNuke**
61 |
62 | |chris-templates|
63 |
64 | * For the DNN 8 templates, go to **Installed** > **Templates** > **Visual C#** > **Dnn**.
65 |
66 | |dnn8-templates|
67 |
68 | #. Set the following:
69 |
70 | .. class:: collapse-list
71 |
72 | * **Name:** the name of your new module
73 | * **Location:** a subfolder inside the :code:`DesktopModules` folder of your DNN installation folder
74 |
75 | .. tip::
76 |
77 | Use your company name or a unique name as the subfolder name to avoid conflicts with other module creators in a production environment.
78 |
79 | #. Uncheck **Create directory for solution**. The templates expect Visual Studio's solution file (.sln) to be in the same folder as the project file. Checking this option puts the solution file in a different folder, which can cause build errors.
80 |
81 | See Also
82 | --------
83 |
84 | .. class:: collapse-list
85 |
86 | * :doc:`Creating Modules `
87 |
88 | .. * :doc:`Create a Web Forms module. `
89 | .. * :doc:`Create an MVC module. `
90 | .. * :doc:`Create a SPA module.`
91 |
92 | Sources
93 | -------
94 |
95 | .. class:: collapse-list
96 |
97 | * DNN Community Blog: `Module Development for Non-Developers, Skinners, & DNN Beginners - Blog Series