DotNetNuke 4.0 Module
Developers Guide (Part 1)
Michael Washington
Version 1.0.0
Last Updated: January 3, 2007
Category: DotNetNuke v4.3.7
DotNetNuke 4.0 Module Development
Copyright © 2003-2005 Perpetual Motion Interactive Systems, Inc. All Rights Reserved.
Information in this document, including URL and other Internet Web site references, is
subject to change without notice. The entire risk of the use or the results of the use of
this document remains with the user.
The example companies, organizations, products, domain names, e-mail addresses,
logos, people, places, and events depicted herein are fictitious. No association with any
real company, organization, product, domain name, email address, logo, person,
places, or events is intended or should be inferred.
Complying with all applicable copyright laws is the responsibility of the user. Without
limiting the rights under copyright, no part of this document may be reproduced,
stored in or introduced into a retrieval system, or transmitted in any form or by any
means (electronic, mechanical, photocopying, recording, or otherwise), or for any
purpose, without the express written permission of Perpetual Motion Interactive
Systems, Inc. Perpetual Motion Interactive Systems may have patents, patent
applications, trademarks, copyrights, or other intellectual property rights covering
subject matter in this document. Except as expressly provided in any written license
agreement from Perpetual Motion, the furnishing of this document does not give you
any license to these patents, trademarks, copyrights, or other intellectual property.
Copyright © 2005, Perpetual Motion Interactive Systems, Inc. All Rights Reserved.
DotNetNuke® and the DotNetNuke logo are either registered trademarks or
trademarks of Perpetual Motion Interactive Systems, Inc. in the United States and/or
other countries.
The names of actual companies and products mentioned herein may be the trademarks
of their respective owners.
DotNetNuke 4.0 Module Development
Copyright © 2003-2005 Perpetual Motion Interactive Systems, Inc. All Rights Reserved.
Abstract
This guide covers module development for the DotNetNuke framework, covering
DotNetNuke 4 (ASP.NET 2.0)
DotNetNuke 4.0 Module Development
Copyright © 2003-2005 Perpetual Motion Interactive Systems, Inc. All Rights Reserved.
Contents
Introduction to DotNetNuke Module Development ............ 1
What is a DotNetNuke Module?........................................................................................ 1
Installing a Module............................................................................................................3
A Look into the DotNetNuke Module Definition..............................................................8
A Module Can Have Multiple Instances ......................................................................... 13
Summary.......................................................................................................................... 15
Setting-up Your Development Environment..................... 16
What You Need:............................................................................................................... 16
Creating the Survey Module.............................................. 21
Are you ready to create the Module?............................................................................... 21
The DotNetNuke Architecture......................................................................................... 21
Creating the Module ........................................................................................................25
Create the Content ...........................................................................................................41
Build the Site....................................................................................................................42
Connect Your Module to the Database ...............................51
DAL & DAL+ .................................................................................................................... 51
Converting the Survey module to use the DAL+ ............................................................56
DotNetNuke 4.0 Module Development
Copyright © 2003-2005 Perpetual Motion Interactive Systems, Inc. All Rights Reserved.
Using the DotNetNuke API (Application Programming
Interface)..........................................................................65
Module Settings and Personalization: Easily Store Data for Your Module...................66
Localization: Easily Translate Your Module...................................................................70
NavigateURL: How to make a link..................................................................................74
IActionable: Add Items to Your Module Menu...............................................................79
ISearchable: Easily Make Your Module Searchable .......................................................84
IPortable: Easily export content from your module to deploy on your production
server................................................................................................................................89
Packaging and protecting your Module........................... 102
Using the DNN Web Controls...........................................112
Set up the Web Controls.................................................................................................112
The DNN Label Edit Control..........................................................................................113
The DNNTree Control.................................................................................................... 118
The DNN Text Suggest Control.....................................................................................122
Using Web Application Projects (WAP) ...........................125
Survey Module Source Code............................................ 134
The source code for the Survey module is listed in DotNetNuke 4.0 Module Developers
Guide (Part 2) available at DotNetNuke.com...............................................................134
Additional Information....................................................135