Tutorials

January 27, 2008

Developing a C# WAP Module in DNN

Ever since OpenForce '07 in Las Vegas last year I have found myself answering more questions regarding module development and being asked to provide training to more individuals.  I have decided that I should start creating more tutorials here that explain the module development process, therefore this article will be the first in a hopefully long series of DotNetNuke module development tutorials.  This article will walk you through the process of creating a new DotNetNuke module using the C# WAP Templates that are available from BiteTheBullet.co.uk.

January 16, 2008

Installing DotNetNuke 4.8.0 on a Remote Host

In previous articles on this site I have provided tutorials for installing DotNetNuke to a local machine, however, I have never yet approached the topic of installing DotNetNuke to a remote web hosting provider.  I have been asked many times why and the answer is simple; installations to remote hosts are not really standardized as depending on the hosting providers environments the steps to install can differ greatly.  However, due to popular demand I have created this tutorial which will provide you the basic overview of how to perform a clean installation of DotNetNuke on a remote web hosting provider.  In the article I will try to point out the most common areas of difference between different hosting providers, I will also be providing specific examples regarding the use of the Plesk control panel which is what my hosting provider (3Essentials) uses.  This article is my second revision updated to add some more clarifying points, be sure to share any feedback in the comments section at the bottom of the article!

January 16, 2008

Installing DotNetNuke 4.8.0 Locally

Installing DotNetNuke can be somewhat difficult at times, therefore I am writing this article to give you a full step by step guide to installing DotNetNuke on a Windows XP Pro system. The instructions are similar for Windows 2000 but might vary slightly, I have tried to note as many differences as possible. Windows Vista installation is similar but requires a few different steps relating to IIS. for Vista information please view my video tutorial.  This guide is my fifth revision and includes additional steps and information based on feedback from previous users. 

Prior to following this instruction guide please ensure that you have downloaded the "install" version of DotNetNuke 4.8.0 from http://www.dotnetnuke.com.  You can save the zip file to your desktop for the time being.  You will also need to have SQL Server Express 2005 installed and correctly configured to allow mixed-mode authentication.  You can use windows authentication only, however, that configuration is NOT discussed in this article. (Other SQL Server versions work, but these instructions might not match 100% if using something other than 2005). You must also be logged into your machine with administrative permissions.

January 06, 2008

Semi-Automatic DNN Module Installation Packages

Recently I have been building more DotNetNuke modules than in previous months and I found myself spending a fair amount of time building installation packages to test my modules on my secondary DotNetNuke portal.  After spending more time than I care to admit manually copying these files over, I created a simple command line batch program and added it as a post build event in my project.  This way every time I re-compile my module Visual Studio will automatically create my installation package.  Below I will provide a bit of direction as well as providing a link to download my sample .bat file.

January 04, 2008

Upgrading to DotNetNuke 4.8.0 from 4.x

This is my sixth revision DNN Upgrade guide.  This version of the guide includes important updates for working with DNN 4.8.0 and customized SqlDataProvider configurations.  Many portions of this upgrade guide are the same as previous versions, however, there are some new items and many minor changes/clarifications.  This is simply due to the LIMITED changes that have truly occured in the area of DotNetNuke upgrades.  If a newer version of DNN has been released and I do not have a new version of this document, please use this version as there are most likely no breaking changes!

This guide is geared towards performing an upgrade in-place directly to the server.  If you are on a hosted web server you will need to make modifications to the instructions to fit your access to the production environment.  Additionally I STRONGLY suggest attempting to perform an upgrade locally BEFORE you update a production hosted site to check all processes, then use a method to deploy the upgrade in a prompt manner to minimize site downtime.  If there is enough demand I will post a "Upgrading DotNetNuke from 4.x to 4.8.0 (or later) on a Remote Host" guide.

January 04, 2008

Installing DotNetNuke Authentication Providers

DotNetNuke 4.6 and later provided us with a very helpful new development method known as Authentication Providers.  This process created a new development package that developers could use to replace the standard DotNetNuke authentication system.  When this was released three providers were provided by the core; DNN, LiveId, and OpenId.  These providers all came pre-installed, the true question then becomes how do we actually install a NEW authentication provider?  This was something that is very easy, but you must know where to look when doing so.  This tutorial will walk you through the installation process for a separate authentication provider.  I will walk through the installation of the Active Directory Authentication Provider on a DotNetNuke 4.7.0 site.

December 20, 2007

Debugging WAP DotNetNuke Modules

A question I have been asked many times recently is how do you debug a DotNetNuke module that has been developed using the WAP (Web Application Project) development model.  This is a question that I have known the general answer to for quite some time, but I have never actually had a need to truly debug one of my custom modules.  During the course of helping a client with an issue today I actually took the time to document all steps necessary to debug a WAP DotNetNuke Module within Visual Studio 2005.  This article will walk you through all steps necessary to debug your project.

November 19, 2007

How to Restore a DNN Installation

This tutorial is a followup to my DNN backup tutorial. This document will discuss how you can restore your DNN site from your database .bak file and your DotNetNuke .zip file. This could be to either restore a damaged DNN installation or to move a DNN installation to a new server. Below we will discuss the implementation to restore the database, validate user accounts, restore DotNetNuke files, configure a new virtual directory, and setup the web.config.  This is my second revision to the article.

November 19, 2007

How To Backup a DNN Installation

Another very common question that I see regarding DotNetNuke is when and how should I backup my DotNetNuke site. This topic is VERY important and requires a bit of planning, especially if you do not have direct access to your database server to perform your own backups. In the following sections I will first talk about what you must backup and why some of those items are very important. I will then discuss how to perform a DNN backup and SQL Server backup, both for SQL 2000 and 2005.  Finally I will discuss options available for third party modules for performing backups for individuals that do not have direct access to their servers.  This is a second revision of this article.

November 19, 2007

Installing DotNetNuke 4.7.0 Locally

Installing DotNetNuke can be somewhat difficult at times, therefore I am writing this article to give you a full step by step guide to installing DotNetNuke on a Windows XP Pro system. The instructions are similar for Windows 2000 and XP Home but might vary slightly, I have tried to note as many differences as possible. Windows Vista installation is similar but requires a few different steps relating to IIS. for Vista information please view my video tutorial.  This guide is my fourth revision and includes additional steps and information based on feedback from previous users. 

November 19, 2007

Installing DotNetNuke 4.7.0 on a Remote Host

In previous articles on this site I have provided tutorials for installing DotNetNuke to a local machine, however, I have never yet approached the topic of installing DotNetNuke to a remote web hosting provider.  I have been asked many times why and the answer is simple; installations to remote hosts are not really standardized as depending on the hosting providers environments the steps to install can differ greatly.  However, due to popular demand I have created this tutorial which will provide you the basic overview of how to perform a clean installation of DotNetNuke on a remote web hosting provider.  In the article I will try to point out the most common areas of difference between different hosting providers, I will also be providing specific examples regarding the use of the Plesk control panel which is what my hosting provider (3Essentials) uses.  This article is my third revision updated to add some more clarifying points, be sure to share any feedback in the comments section at the bottom of the article!

November 12, 2007

Upgrading to DotNetNuke 4.7.0 from 4.x

This is my fifth revision DNN Upgrade guide.  This version of the document includes important updates for the upgrade process to DotNetNuke 4.7.0.  Many portions of this upgrade guide are the same as previous versions, however, there are some new items and many minor changes/clarifications.  This is simply due to the LIMITED changes that have truly occured in the area of DotNetNuke upgrades.  If a newer version of DNN has been released and I do not have a new version of this document, please use this version as there are most likely no breaking changes!

This guide is geared towards performing an upgrade in-place directly to the server.  If you are on a hosted web server you will need to make modifications to the instructions to fit your access to the production environment.  Additionally I STRONGLY suggest attempting to perform an upgrade locally BEFORE you update a production hosted site to check all processes, then use a method to deploy the upgrade in a prompt manner to minimize site downtime.  If there is enough demand I will post a "Upgrading DotNetNuke from 4.x to 4.7.0 (or later) on a Remote Host" guide.

September 24, 2007

Social Bookmarking Links with Ventrian News Articles

Recently I have been fielding a number of requests regarding blog linking to Del.icio.us, Digg, DotNetKicks and a few of the others with Ventrian's News Articles module.  I decided that at this time it would be best for me to go ahead and share this informaiton publicly so that everyone can benefit.  (Not to mention Chad Voller requested a blog on this topic as well.....)  So without futher delay, below is information regarding adding these social networking links to your blog site.

September 21, 2007

Text/HTML 4.6.0 and Display Tokens

When playing around with DotNetNuke 4.6 I discovered a new feature that can be very helpful yet that I have not noticed any formal discussion about on the DNN site.  Therefore I am taking the time here to give you a breif overivew of this new function.  The feature I am talking about is the support for tokens wiithin the Text/HTML module. This new feature provides a MUCH needed enhancement to the Text/HTML Module and is something that I think many users will find to be very helpful.

September 21, 2007

Associating DNN Accounts With Windows Live

This article is a revisit to the Windows Live authentication functionality within DotNetNuke that I discussed earlier this week.  After creating the inital linking to my site I found that I was able to setup the link properly and that users were able to go out to Windows Live, however, they were never able to successfully associate their Windows Live account to their DNN account on my website.  After much research, and a helpful post from another DNN community member I have found out how to do it.

September 19, 2007

DNN 4.6.0 Upgrade and Whitespace Filter Errors

As noted in my previous blog posting I have upgraded this website to be running DotNetNuke 4.6.0.  Prior to the upgrade this site was running DNN 4.5.2 and I performed a direct upgrade to 4.6.0.  Also as I mentioned in my previous posting the upgrade didn't go all that smooth, with the site being down for almost an hour as I worked out the "bugs" that I identified with the 4.6.0 upgrade.  This article will discuss one of the issues that I encountered relating to the Whitespace Filter.

September 17, 2007

Windows Live and OpenId with DotNetNuke

DotNetNuke 4.6.0 provides built in support for the Windows Live and OpenId authentication systems, allowing you more ways to make your site easy for visitors to use.  The best part is that DotNetNuke makes it easy for you as a site administrator to enable these login features for your users.  This article will talk alittle bit about each authentication system and what is needed for integration, then we will actually implement both in a DNN 4.6 website.

September 17, 2007

Installing DotNetNuke 4.6.0 on Remote Host

In previous articles on this site I have provided tutorials for installing DotNetNuke to a local machine, however, I have never yet approached the topic of installing DotNetNuke to a remote web hosting provider.  I have been asked many times why and the answer is simple; installations to remote hosts are not really standardized as depending on the hosting providers environments the steps to install can differ greatly.  However, due to popular demand I have created this tutorial which will provide you the basic overview of how to perform a clean installation of DotNetNuke on a remote web hosting provider.  In the article I will try to point out the most common areas of difference between different hosting providers, I will also be providing specific examples regarding the use of the Plesk control panel which is what my hosting provider (3Essentials) uses.  This article is my second revision updated to add some more clarifying points, be sure to share any feedback in the comments section at the bottom of the full article!

September 17, 2007

Installing DotNetNuke 4.6.0 Locally

Installing DotNetNuke can be somewhat difficult at times, therefore I am writing this article to give you a full step by step guide to installing DotNetNuke on a Windows XP Pro system. The instructions are similar for Windows 2000 and XP Home but might vary slightly, I have tried to note as many differences as possible. Windows Vista installation is similar but requires a few different steps relating to IIS.  This guide is my third revision and includes additional steps and information based on feedback from previous users. 

September 17, 2007

Upgrading to DotNetNuke 4.6.0 from 4.x

This is my fourth revision DNN Upgrade guide.  This version of the document includes important updates for the upgrade process to DotNetNuke 4.6.  Many portions of this upgrade guide are the same as previous versions, however, there are some new items.  This is simply due to the LIMITED changes that have truly occured in the area of DotNetNuke upgrades.

This guide is geared towards performing an upgrade in-place directly to the server.  If you are on a hosted web server you will need to make modifications to the instructions to fit your access to the production environment.  Additionally I STRONGLY suggest attempting to perform an upgrade locally BEFORE you update a production hosted site to check all processes.

September 06, 2007

Installing DotNetNuke 4.5.5 on a Hosting Site

In previous articles on this site I have provided tutorials for installing DotNetNuke to a local machine, however, I have never yet approached the topic of installing DotNetNuke to a remote web hosting provider.  I have been asked many times why and the answer is simple; installations to remote hosts are not really standardized as depending on the hosting providers environments the steps to install can differ greatly.  However, due to popular demand I have created this tutorial which will provide you the basic overview of how to perform a clean installation of DotNetNuke on a remote web hosting provider.  In the article I will try to point out the most common areas of difference between different hosting providers, I will also be providing specific examples regarding the use of the Plesk control panel which is what my hosting provider (3Essentials) uses.

August 01, 2007

Fixing Lockout Due to Profile Property Requirement

One problem I recently encountered myself is one that I see appearing every so often on the DotNetNuke forums. I was working with profile properties and I set a property as required but accidentally forgot to set it to visible. I then proceeded to update the preferences that require a valid profile for login. I am now effectivly locked out of my site as I did not have that property set for my host or admin account. In this article I will provide you the information needed to reset the custom properties and to get you back into your site.

August 01, 2007

Resolving DNN Login Issues With Login Tab Selection

Recently I have answered a number of questions regarding what to do when you accidentially change the login tab setting in "Portal Settings" on a DotNetNuke website to a tab that does not have a login module. This situation which is very easy to get yourself into is also one that is VERY easy to get out of as long as you are able to directly connect to SQL Server. If you are unable to connect directly to the SQL Server to run queries it will be a bit more involved to resolve the issue. In this posting I will discuss the very simple SQL Script needed to reset the LoginTabId value and get you back into your site.

July 27, 2007

Migration of Existing Site to 3Essentials

Recently there have been numerous discussions on the DotNetNuke.com Forums regarding hosting providers and who one should go with and who they should switch to because they are unhappy with their current provider. During all of these discussions I have always recommended the company that I use for hosting 3Essentials. Since making this recommendation I have been receiving numerous e-mails regarding the process to actually migrate a live site over to 3Essentials so I thought I would write a short blog article that explains the basics of moving a website over to 3Essentials, in actuality these instructions SHOULD work for most providers, however there might be some differences.

July 27, 2007

Determing SQL Server Table Size

A common problem that I have recently encountered was trying to identify areas of my website database that were taking up the most physical storage space. At work I maintain a DotNetNuke installation that includes a 4.5 Gb reporting database and I was trying to pinpoint the exact sizes of ALL tables in my database and was having a few problems. I started using the "sp_spaceused" stored procedure but I had to run that for every table, I have over 200 tables in this database and it was just not feasiable for me to do it this way. Therefore I wrote a stored procedure that will perform all needed data calls and will return a result set with the data on all tables. In this post I will share the script as well as a few interesting things I learned while writing it.

July 26, 2007

Upgrade to DotNetNuke 4.5.5 From 4.x

Due to popular request this article is an updated version of my DNN upgrade process.  Below I will walk you through all steps necessary to upgrade your DNN website from a previous 4.x version to the most current version 4.5.5.  This article is the third revision of my upgrade process documents and has been enhanced with user recommended tips as well as includes new recommendations from my experiences installing new versionf of DotNetNuke.

July 26, 2007

Installing DotNetNuke 4.5.5 Locally

Installing DotNetNuke can be somewhat difficult at times, therefore I am writing this article to give you a full step by step guide to installing DotNetNuke on a Windows XP Pro system. The instructions are similar for Windows 2000 and XP Home but might vary slightly, I have tried to note as many differences as possible. Windows Vista installation is similar but requires a few different steps relating to IIS.  This article is a re-visit to my first article of this type geared towards DotNetNuke 4.4.1..

July 23, 2007

Using DotNetNuke Request Filter

DotNetNuke introduced a request filter option starting with DotNetNuke 4.5.3 that can allow you to take action on a user based on various request parameters. In this article I will walk you through how to setup the request filter to filter out requests from a specific IP address and will discuss in general what the settings are. In this example we will be placing a filter to block all traffic from a user with an IP of 13.12.15.45 and we will redirect them to google.com.

July 19, 2007

DNN Foum - Make "My Settings" open to new window

In the last month or so i was working on some modifications to the DotNetNuke forums module to meet some of their customers needs regarding usability. One of these items was to make the "My Settings" link open in a new window rather than moving the user from their current viewing page. This is a small modification that I thought was quite helpfule so I thought I would share the steps necessary to make the change.

July 18, 2007

Fixing DNN Errors that are Related to Search Scheduler

I have noticed a number of posts recently on the DotNetNuke.com forums regarding numerous errors being reported in the event log relating to portal id of -1 and typically with a InnerException of "Value cannot be null. Parameter name: type". This issue can become very annoying and can have an actual effect on your sites performance as when the size of the event log grows you will start to notice performance slow downs. This article will discuss the root cause of the issue and a solution.

June 28, 2007

Upgrading DNN 3.x to DNN 4.x

Recently I have noticed an increased number of questions regarding the upgrade process from DNN 3.x to DNN 4.x and overall I do not think there is very much good documentation available on how to actually complete the upgrade. Therefore with this article I will walk you through the process of upgrading a 3.x site to 4.x, I will try to cover as many of the "gotchas" as possible, but please remember as with all of my other tutorials PLEASE use these at your own risk!

June 01, 2007

Moving DNN Sites (Avodiding problems with the repository module)

Many of my regular readers have been using my guides for doing DNN site moves and performing backups and restores from a production environment to another. Overall I have not heard of any issues with the processes I have listed in the past. That was until I actually performed the migration of this site to it's new server the week before Memorial Day. This blog post will cover the issues I encountered while migrating the site to my new hosting provider, these issues were all caused by the Repository module.

May 30, 2007

Partial Rendering with DNN Core Modules Revisited (4.5.2 and later)

With the release of DNN 4.5.2 and the associated fixes to the AJAX implementation I thought i would revisit my "Core Modules" and AJAX testing that I had completed after the release of 4.5.0. The good news is that more modules can support AJAX since the issues with the URL Control have been resolved. This article will discusss individual modules and the functionality that is now available with the release of 4.5.2.

May 30, 2007

Integrating Google AdSense with DNN 4.5.2

DotNetNuke 4.5.2 has given us yet another great default function for our websites. Like many individuals I use Google AdSense to provide content based advertising to my users.  Traditionally to integrate Google Adsense you were forced to put a "Text/HTML" module on a page and then add the Javascript to either the source view of the editor, or to the header or footer of the module.  Well in DNN 4.5.2 the core team has added a "Google AdSense" module which makes the integration a breeze!  This article will walk you through the few short steps needed to configure the module and get you started!

May 14, 2007

Creating a Standard DotNetNuke User Via SQL

Due to popular request this article discusses the steps necessary to create a new standard DotNetNuke user account based on the password for an existing user.  This is a follow-up article from my creating a host account via SQL Server that was published about a month ago.

May 10, 2007

Resolving DNN Lock-out Due To Profile Field Definitions

So you modified your user profile fields for your DotNetNuke website and marked a new "Required" field, however you can no longer get into your website.  This has become a very common issue among DNN users and luckly there is a fairly easy way to let yourself back in.  I will discuss in this post the steps needed to modify your profile property declarations to remove a required field so you may login to your site and correct the underlying issue with the property.  Typically this issue is due to either an invalid validation script, a required field that is not displayed, or a list field that doesn't provide valid options.  This article will provide you with the scripts necessary to log back into your site.

Please click "Read More.." to view the full article.

May 04, 2007

Upgrading to DotNetNuke 4.5.1 from 4.x

Due to popular demand and numerous requests I have updated my DotNetNuke upgrade guide to ensure I cover all DNN 4.5.1 issues correctly.  Additionally as part of this update I have also included more detailed information regarding the codeSubDirectories and other configuration elements that must not be overlooked when performing the web.config merge.  Click "Read More.." to view the tutorial!

May 03, 2007

View Statistics of your News Article Module Blog

As I see more and more people using the Ventrian News Articles module for their blogs I have to imagine that others are curious as I am as to which blog posts are the most popular, the highest rated, or maybe even the lowest rated.  Yes I understand that I could look through my blog and find this out, but with as many posts as I have I decided to do some research and have made a few helpful queries that will provide this type of information.  This entry will walk you through each of the scripts.

Click "Read More..." to view the scripts and the remainder of the article

 

April 24, 2007

Simple DotNetNuke Performance Improvements

I have been seeing a large number of questions recently regarding DotNetNuke performance and things that can be done to help improve the performance of the site.  Typically these questions surround the SiteLog and EventLog tables so I thought I would post a few simple queries that you can run to help keep your database lean which will keep your DotNetNuke site running at peak performance.

Click "Read More..." to view the details!

April 23, 2007

DNN Guestbook 2.2 Released (And AJAX Implementation Info)

I announced via the forums on this website the release of my DotNetNuke Guestbook Module version 2.2 yesterday.  Now I would like to take this time to offically list the promised instructions to fully enable AJAX support for the module.  These items are required to be completed manually due to my previously mentioned bug in the DotNetNuke core regarding the use of the <supportspartialrendering> element within the .dnn files.

To view the instructions click on "Read More..."

April 16, 2007

AJAX and the DotNetNuke Repository

After upgrading my sites to DotNetNuke version 4.5.0 I have decided to start experimenting with the new AJAX support built into the DotNetNuke core. I thought the one of the best ways I could start would be to look into the various core modules that I use on a daily basis and see which of them could successfully handle enabling AJAX and still render appropriate page content. This blog entry provides the detail on my first module modification, the DNN Repository.

EDIT 5/31/2007 - Issues have been identified with this method that do not make it practical in all circumstances!

April 10, 2007

Adding Google Analytics to DotNetNuke

This entry explains an easy method to integrate Google Analytics into your DotNetNuke website using the Text/HTML module without the risk of loosing the integration data due to in-line editing!  Read the full article for the step-by-step instructions!
April 02, 2007

Changing Skins via Database (Emergency Procedures)

At one point or another it seems that almost everyone accidentally makes a change to a DNN installation that ends up breaking things. One of these situations that I never considered in the past was the accidental application of a skin with errors. I was contacted by someone today that accidentally applied a skin that caused a null reference exception, this caused the entire site to be unavailable. They couldn't access any pages and couldn't get back to the skin admin pages. Well, this lead me to find a method of resolving the issue via the database. In this entry I will describe the steps needed to change the skin to a default skin via the database.

March 29, 2007

Urgent Forum Security Information (DotNetNuke Core Forum)

As you all have noticed from my post above today I identified an issue with a javascript exploit on the forums module. This blog will give you step-by-step instructions on a few simple additions to the word filter that should prevent you from being affected by the exploit.

Content provided in this blog is provided "AS-IS" and the information should be used at your own discretion.  The thoughts and opinions expressed are the personal thoughts of Mitchel Sellers and do not reflect the opinions of his employer.

Content Copyright

Content in this blog is copyright protected.  Re-publishing on other websites is allowed as long as proper credit and backlink to the article is provided.  Any other re-publishing or distribution of this content is prohibited without written permission from Mitchel Sellers.