ASP-Nuke Installation

Downloaded version: v1.2
Date of last modification: January the 10th 2003

Introduction :

ASP-Nuke is a free webportal project, running with ASP (VBScript). It's an opensource and anyone can use and modify it to add new features. For them, let me know what you've done if you want it'll be included in the next version.
This version is the first release with all last patches.

You can find more information on the website : http://www.asp-nuke.com

1. Prérequis

You must have a webserver which execute ASP pages in order to use ASP-Nuke.

Examples : IIS5.0 and II4.0, PWS.

2. Installation

After dezipping aspnuke_rel1.1en.zip, you've got :

a directory called "aspnuke" with all needed files,
the file "changes.txt" explaining all the changes of this new version,
an english help file "readme_en.htm" that you're currently reading.
the GNU GPL licence (GPL.txt)

Copy all files in the "aspnuke" directory" to your website (with a FTP client for instance). Simply copy content's folder, not the aspnuke folder itself.

Then, you must browse the setup.asp on your webserver (ex: http://www.my-website.com/setup.asp if your website is located at http://www.my-website.com) and fill all information. Don't forget to delete the setup.asp from your website for preventing people to use it ! You will create an admin's account which have administrator's rights on the website, and the owner's rights on the forum. There can be only one owner, but you can add administrators and moderators for each sub-forum and sections.

Well, that's all !

3. Site map

There are 8 folders at the root of your website :

admin : contain all the administration part of your site. This section is only available for people whose flag is Newser or Admin.
db (default) : contain your databases. CAUTION: protect its access for the web !!! (by configuring IIS, or ask your host manager for this feature). If you do not protect this folder, people can steal yours databases and access to your administration's website. This folder must as well have read/write permissions.
forum : contain all forum's files.
imgs : contain your default graphic resources.
includes : contain all include files. There are a subdirectory called admin containing admin include files.
lang : contain all XML translations files. To add a new translation's pack, simply upload the XML, and also add this new version in the "Versions" part of the admin's site.
scripts : contain all generated scripts (you must have write access).
themes : contain all themes.
At the root, you can find all visitors pages.

4 . Appendum

By default, your mail manager use CDONTS . Another versions could be downloaded on the official website.
The database connection is done in the /includes/database-inc.asp. Edit it if you want to use DSN or another database type.
/includes/toppage-inc.asp and /includes/bottompage-inc.asp : these two files build your top and bottom page, like a template. Feel free to adapt them for your conveniance.
/includes/display-inc.asp : there are some important design functions : "CreateTable", "CreateTopTable" and "CreateBottomTable". You can edit them if you want another design for the small blocks.
/includes/webcounter-inc.asp : you can put here any HTML code you want, for counter generally. You must pust the code into the DisplayWebCounters() function.
/forum/includes/configuration-inc.asp : you can change the parameter "FORUM_TYPE" to 2 to change the design of the forum.

Gaëtan Bouveret alias Gat,
Webmaster ASP-Nuke (webmaster@asp-nuke.com)

For any questions, see the FAQ or the ASP-Nuke's forum.

LICENCE : This program is free software. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.