Dotnetnuke 5 User's Guide get your website up and running excerpt 2

Setting up your web server

Now that you have your files configured for your dnn installation, you must configure a website, or web application, within your local web server. if you are running Windows XP on the computer that you will be installing dnn on you will be limited to running ing dnn as a virtual directory/application on the machine, or replacing the default website available in XP. in Windows 2000/2003/Vista/2008, you actually have the ability to configure multiple websites in IIS, which means that you can configure dnn in its own website. the difference between a website and a virtual directory/application is pretty simple. A website can be thought of as a domain name or computer name, such as http://www.dotnetnuke.com or http: // computername/, whereas a virtual directory generally has the format of http: // computername/dotnetnuke /. for the purposes of this book, we will be using ing dnn as a website.

 

Portals

Dnn provides the ability to host multiple websites on one installation, or instance, of the software. these individual websites are known as portals, so your dnn instance can have a single portal, or multiple portals, depending on your configuration. we will talk more about portals later in this chapter, as well as in chapter 8.

 

Pages

With any website, you will have pages. these pages are generally files located on the Web server and returned by the server to the user's browser. with a dynamic content management system such as dnn, these pages are not individual files stored on the file system but dynamically generated files that are built with information from the database and returned to the browser. each page generated within dnn will have its own unique address, or URL (Uniform Resource Locator ).

 

Tabs and pages

In dnn, the terms ''page ''and ''tab'' are interchangeable. we primarily will use ''page, ''but there will be a few references to ''tabs. ''just understand that when we are talking about a tab, we are talking about a page.

 

URLs

A URL is basically an address that a browser and web server use to locate the information requested by a visiting user. a URL generally consists of a domain name, such as www.wrox.com, followed by a directory structure, and then a page (File)-for example, http://www.wrox.com/WileyCDA/ or

Http://www.wrox.com/WileyCDA/Section/Home.id-105001.html.

In most cases, files of the type. htm and. HTML are static, as they actually exist as an individual file on the Web server. using dynamic content management systems will build URLs that use what are known as query string parameters, which are name/value pairs that are passed after a filename in a URL. for example, previous versions of dnn wocould build their URLs as follows: http://www.dotnetnuke.com/ Default. aspx? Tabid = 825,

Where default. aspx is the filename and Tabid = 825 is the query string parameter. this parameter tells dnn to load page number 825 from the database and return the content for that page to the user. dnn uses query string parameters in a number of ways, more than just for the page ID. in the past, these parameters generally were not thought of as being a good practice. the generally accepted theory wa S that search engines treated pages that had query string parameters with less weight than pages that appeared to be a static file. it was assumed that search engines wowould pick up on the fact that a page was being loaded dynamically and treat the content on that page with less respect than they might a static HTML page. although engineers from Google have debunked this theory, it is still General Ly recommended to avoid using query string parameters where possible. the recent versions of dnn avoid using query strings in URLs by using what are known as friendly URLs. friendly URLs can take your forms, but the default in all basic dnn installations will be of the following format. the URL we looked at earlier, http://www.dotnetnuke.com/default.aspx? Tabid = 825,

Wocould become

Http://www.dotnetnuke.com/tabid/825/default.aspx

Using the friendly URL formatting. to the search engines and individual users, this looks like a static page that exists on the server, when in fact there is no directory with the path of Tabid/825 and a page called default. aspx within that directory. dnn dynamically parses the URL to figure out which page is being loaded and still treats that URL as query-string-based. it is possible to change the formatting of the URLs on your dnn website by plugging in a new friendly URL provider. these providers are developed by individuals or companies usually not directly affiliated with the dnn project ..

 

Skins

There are a number of ways to manipulate and control the layout of the content of your dnn website. the primary layout configuration is handled through the use of a skin. A skin is a file consisting of HTML and other code that provides formatting and styling information for your site. A skin also provides the location (s) available for placing content on a page. these locations are called panes. all skins have at least one pane, called contentpane. beyond that, it is up to the skin developer to provide additional panes. skins generally are constructed with HTML code, although they may also have VB. net or C # code embedded within them to provide additional functionality. the important thing to realize with skins in dnn is that a website will have a default skin defined, but this setting can be overridden at the page level, meaning that you can control the look and feel of individual pages. the flexibility of dnn and its skinning engine lets you change the look and feel of your website by choosing a new skin through the page settings. changing skins is a pretty straightforward process that requires only a few mouse clicks to change a few settings. dnn comes with one skin package by default, the minimalextropy skin. while there are no other skin

Packages currently available on your dnn site, you can use the extensions page to install skins that you have developed, gathered, or purchased from other sources. any skin that is installed from the host/extensions page will be available to all portals within an instance of dnn.

 

Modules

In addition to the layout and styling, the other basic component of a dnn web page is the page's content. as content is generally key to having a good website, it is an important aspect of any web page. in dnn, content is provided through the use of modules, mini-applications that are one of the key strengths of dnn's flexibility. although there are thousands of modules available for dnn, we will focus on the modules available with the basic installation package downloaded from dotnetnuke.com. (refer to chapter 1 for a brief description of each module's functionality .)

To provide content and functionality to a page, a module must be placed on the page in one of the available panes. you can have multiple modules within a pane and multiple panes on a page, so when tively you are not limited in the number of modules you can place on a page, although good web practice wowould lean toward not weighing a page down with too much content. we will discuss how modules are installed later in this chapter, and then, in chapter 4, we will cover the basics of using modules within your dnn pages.

 

Containers

A container is to a module what a skin is to a page. containers are HTML snippets that wrap around modules within a pane and define any borders, a title for the module, and other design elements for modules on a page. at the portal level, you can define a default container for all modules on your website, which can be overridden at the page level, defining a default for the page and then again at the individual module level.

Containers also have an HTML section, called contentpane; the difference between a container and a skin, however, is that a container can have only one of these panes, not multiple ones. the contentpane within a container provides the location for the content and functionality of a module to be displayed. although containers typically provide some other basic functionality to all users, such as links to syndication data (RSS), to a printer-friendly view, and to the actions a module can perform, the most important functionality is reserved for users who have edit rights to the module.

You can administer modules by selecting a menu or buttons within the container that link to the actions available for that module. although a number of actions are common to all modules, some actions are specific to the individual module. chapter 4 describes the common module actions in more detail and then subsequent chapters cover actions available to specific les, as we walk through varous scenario-based websites.