From RNWiki
Jump to: navigation, search
(What Is Included: I had lost some of my updates)
(What Is Included)
 
(10 intermediate revisions by 5 users not shown)
Line 4: Line 4:
 
== Introduction ==
 
== Introduction ==
  
'''Welcome to RavenNuke™!'''
+
'''Welcome to {{RN}}!'''
  
Congratulations! You have chosen to install one of the most secure and fast Content Management Systems (CMS) available. And the even greater news is that it is Free and Open Source! The RavenNuke™ distribution comes with the most up to date -- as of original distribution -- patches from Chatserv and of NukeSentinel™. In addition, NukeSentinel™ is fully installed and configured except for one feature which requires additional instruction (dealt with later on in this manual). RavenNuke™ has its roots in PHP-Nuke version 7.6. But, there is no comparing the latest version of RavenNuke™ with its roots! The appearance is much the same but the underlying code is vastly different. As of version {{RNVersion}}, RavenNuke™ has over 20,000 changes, bug fixes, PHP notice fixes, compliance fixes, operational enhancements, and security enhancements.
+
Congratulations! You have chosen to install one of the most secure and fast Content Management Systems (CMS) available. And the even greater news is that it is Free and Open Source! The {{RN}} distribution comes with the most up to date -- as of original distribution -- patches from Chatserv and of {{NS}}. In addition, {{NS}} is fully installed and configured except for one feature which requires additional instruction (dealt with later on in this manual). While {{RN}} has its roots in PHP-Nuke version 7.6, there is no comparing the latest version of {{RN}} with its roots! The appearance is much the same but the underlying code is vastly different. As of version {{RNVersion}}, {{RN}} has over 20,000 changes, bug fixes, PHP notice fixes, compliance fixes, operational enhancements, and security enhancements.
 
 
Please be sure to follow every step in the order listed. This is vital to the successful setup of your site.
 
  
 
In summary, this wiki will walk you through the following steps:
 
In summary, this wiki will walk you through the following steps:
  
* Set up an empty RavenNuke™ database
+
* Setting up an empty {{RN}} database
* Prepare/install the files
+
* Preparing and installing the files
* Install the RavenNuke™ tables
+
* Installing the {{RN}} tables
* Configure the main site settings
+
* Configuring the main site settings and {{NS}}
* Configure NukeSentinel™
+
* Configuring add-ons (if desired)
* Configure add-ons (if desired)
 
  
If you like this software and want to help support the ongoing development, please make a contribution at [http://www.ravenphpscripts.com Raven PHP Scripts].
+
If you like this software and want to help support the on-going development, please make a contribution at [http://www.ravenphpscripts.com Raven PHP Scripts].
  
This is a self contained package and there is no additional code to download and/or install. Also, if you are upgrading from an earlier RavenNuke™ release or migrating from another PHP-Nuke installation to RavenNuke™, read our page on [[RavenNuke2:Upgrades_and_Migrations|Upgrades and Migations]].
+
This is a self contained package and there is no additional code to download and/or install. Also, if you are upgrading from an earlier {{RN}} release or migrating from another PHP-Nuke installation to {{RN}}, read our page on [[RavenNuke2:Upgrades_and_Migrations|Upgrades and Migations]].
  
RavenNuke™ is application software that must be installed on a server. As with any software that you expose to the Internet, there may be bugs or security problems. Do not install RavenNuke™ unless you intend to keep up with security upgrades (please visit [http://www.ravenphpscripts.com Raven PHP Scripts] for announcements about security updates and code fixes).
+
{{RN}} is application software that must be installed on a server. As with any software that you expose to the Internet, there may be bugs or security problems. Do not install {{RN}} unless you intend to keep up with security upgrades (please visit [http://www.ravenphpscripts.com Raven PHP Scripts] for announcements about security updates and code fixes).
  
 
== What Is Included ==
 
== What Is Included ==
Line 29: Line 26:
 
Rather than repeat all the credits/contributions here, please refer to the full list of all [[RavenNuke2:Credits|Credits and Contributions]] for who did what to whom.
 
Rather than repeat all the credits/contributions here, please refer to the full list of all [[RavenNuke2:Credits|Credits and Contributions]] for who did what to whom.
  
The latest release is {{RNVersion}}. Included in this distribution (Distro) are too many fixes and tweaks to mention them all! For a complete list of changes see the Change Log. Here are some highlights.
+
The latest release is {{RNVersion}}. Included in this distribution (Distro) are too many fixes and tweaks to mention them all! For a complete list of changes see the Change Log. Here are some highlights:
  
 
* As of version {{RNVersion}}, {{RN}} has over 20,000 changes, bug fixes, PHP notice fixes, compliance fixes, operational enhancements, and security enhancements.
 
* As of version {{RNVersion}}, {{RN}} has over 20,000 changes, bug fixes, PHP notice fixes, compliance fixes, operational enhancements, and security enhancements.
* The latest release of {{NS}, which is {{NSVersion}} as of this writing.
+
* The latest release of {{NS}}, which is {{NSVersion}} as of this writing.
 +
* A web based table installer for all of the tables use in the Distro.
 +
* A web based configuration tool for all of the most important settings in the Distro.
 +
* Tricked Out News (v2.6) replacement for News module.
 +
* TegoNuke™ Downloads (NSNGD) (v1.1.3) replacement for Downloads.
 
* BBtoNuke (phpBB) {{phpBB2Version}} as well as made as fully XHTML 1.0 Transitional compliant as possible.
 
* BBtoNuke (phpBB) {{phpBB2Version}} as well as made as fully XHTML 1.0 Transitional compliant as possible.
* The latest Forum Attachment Mod is included as a simple add-on but is not installed as default.
+
* The latest Forum Attachment Mod is included as a simple add-on.
 
* An enhanced Topics module.
 
* An enhanced Topics module.
 
* An enhanced Recommend Us and Feedback module.
 
* An enhanced Recommend Us and Feedback module.
* Content Plus 2.2.0 from slaytanic.sourceforge.net. Replacement for the old Content module.
+
* Content Plus (v2.2.2) replacement for the Content module.
 +
* HTML Newsletter module (v1.4.0).
 +
* GCalendar module (v1.7.0).
 
* Tweaked NSN Groups (v1.7.1).
 
* Tweaked NSN Groups (v1.7.1).
 
* Fixes to the Blocks admin screen to correctly order the blocks and to work correctly with NSN Groups.
 
* Fixes to the Blocks admin screen to correctly order the blocks and to work correctly with NSN Groups.
 
* A recoded AdvantGo module to correctly use your theme and is also W3C Compliant.
 
* A recoded AdvantGo module to correctly use your theme and is also W3C Compliant.
 
* Enhanced and Fixed MetAuthors module.
 
* Enhanced and Fixed MetAuthors module.
* A web based table installer for all of the tables use in the Distro.
 
* A web based configuration tool for all of the most important settings in the Distro.
 
 
* Integration of nukeWYSIWYG™ featuring FCKeditor {{FCKVersion}} and the kses filter class.
 
* Integration of nukeWYSIWYG™ featuring FCKeditor {{FCKVersion}} and the kses filter class.
 +
* Integration of nukeSEO™ DH (dynamic generation of title, META description and keywords tags).
 
* Integration of nukeFEED™ feed generator (v1.1.1) - create syndication feeds in various formats (RSS/ATOM/OPML) using content on your site, and allow visitors to subscribe to your feeds directly or via Feedburner.com.
 
* Integration of nukeFEED™ feed generator (v1.1.1) - create syndication feeds in various formats (RSS/ATOM/OPML) using content on your site, and allow visitors to subscribe to your feeds directly or via Feedburner.com.
 
* Integration of nukePIE™ feed reader (v1.1.1) - a replacement for the block feed reader that uses SimplePie to read feeds from other sites in modern feed formats (including RSS 2.0 and ATOM).
 
* Integration of nukePIE™ feed reader (v1.1.1) - a replacement for the block feed reader that uses SimplePie to read feeds from other sites in modern feed formats (including RSS 2.0 and ATOM).
* Integration of the HTML Newsletter module (v1.3.2).
+
* Integration of TegoNuke™ ShortLinks (aka: GoogleTap, GT-NextGEn) (v1.3.1).
* Integration of the GCalendar module (v1.7.0).
+
* Integration of TegoNuke™ Mailer (v1.1) - allows for SMTP authenticated mailing option.
* Integration of TegoNuke(tm) ShortLinks (aka: GoogleTap, GT-NextGEn) (v1.2.2).
+
* Integration of an Error Documents module.
* Integration of TegoNuke(tm) Mailer (v1.0.1) - allows for SMTP authenticated mailing option.
 
 
* Integration of Raven's resend email hack and user info hack.
 
* Integration of Raven's resend email hack and user info hack.
 
* Most themes are now 100% W3C CSS and HTML compliant, and the fisubice theme made fully compliant, even in the BBtoNuke modules.
 
* Most themes are now 100% W3C CSS and HTML compliant, and the fisubice theme made fully compliant, even in the BBtoNuke modules.
 +
* Integration of nukeNAV™ (dynamic, user-aware navigation - requires compatible themes).
 
* The blocks and modules are almost 100% XHTML 1.0 Transitional compliant (with the exception of module admin pages) - we only say "almost" because we may not have tested absolutely every script path!
 
* The blocks and modules are almost 100% XHTML 1.0 Transitional compliant (with the exception of module admin pages) - we only say "almost" because we may not have tested absolutely every script path!
 
* Tons of code clean-up (readability) and performance enhancements.
 
* Tons of code clean-up (readability) and performance enhancements.
 
* All applications are fully configured but some settings will/may need changing for security.
 
* All applications are fully configured but some settings will/may need changing for security.
 
* Shout Box from ourscripts.net (v8.5.2) - not integrated, but provided in the download package (tweaked by Gremmie and Testy1 to work under {{RN}}.
 
* Shout Box from ourscripts.net (v8.5.2) - not integrated, but provided in the download package (tweaked by Gremmie and Testy1 to work under {{RN}}.
* Integration of an Error Documents module.
 
  
 
== Resource Requirements Needed ==
 
== Resource Requirements Needed ==
Line 85: Line 86:
 
|  align="left" | PHP
 
|  align="left" | PHP
 
|  align="left" | 5.2 +
 
|  align="left" | 5.2 +
|  align="left" | 4.1
+
|  align="left" | 5.2 +
 
|  align="left" | Although core {{RN}} is certified to run on 5.2, some add-on modules and hacks may not. {{RN}} currently has some issues on 5.3 +.<br />http://www.php.net<br /><span style="color:red">The GD extension with FreeType 2.x support is also required for the security captcha to work properly.</span>
 
|  align="left" | Although core {{RN}} is certified to run on 5.2, some add-on modules and hacks may not. {{RN}} currently has some issues on 5.3 +.<br />http://www.php.net<br /><span style="color:red">The GD extension with FreeType 2.x support is also required for the security captcha to work properly.</span>
 
|}
 
|}

Latest revision as of 22:44, 10 January 2012

Home>Introduction/About

Introduction

Welcome to RavenNuke™!

Congratulations! You have chosen to install one of the most secure and fast Content Management Systems (CMS) available. And the even greater news is that it is Free and Open Source! The RavenNuke™ distribution comes with the most up to date -- as of original distribution -- patches from Chatserv and of NukeSentinel™. In addition, NukeSentinel™ is fully installed and configured except for one feature which requires additional instruction (dealt with later on in this manual). While RavenNuke™ has its roots in PHP-Nuke version 7.6, there is no comparing the latest version of RavenNuke™ with its roots! The appearance is much the same but the underlying code is vastly different. As of version 2.50.00, RavenNuke™ has over 20,000 changes, bug fixes, PHP notice fixes, compliance fixes, operational enhancements, and security enhancements.

In summary, this wiki will walk you through the following steps:

  • Setting up an empty RavenNuke™ database
  • Preparing and installing the files
  • Installing the RavenNuke™ tables
  • Configuring the main site settings and NukeSentinel™
  • Configuring add-ons (if desired)

If you like this software and want to help support the on-going development, please make a contribution at Raven PHP Scripts.

This is a self contained package and there is no additional code to download and/or install. Also, if you are upgrading from an earlier RavenNuke™ release or migrating from another PHP-Nuke installation to RavenNuke™, read our page on Upgrades and Migations.

RavenNuke™ is application software that must be installed on a server. As with any software that you expose to the Internet, there may be bugs or security problems. Do not install RavenNuke™ unless you intend to keep up with security upgrades (please visit Raven PHP Scripts for announcements about security updates and code fixes).

What Is Included

Rather than repeat all the credits/contributions here, please refer to the full list of all Credits and Contributions for who did what to whom.

The latest release is 2.50.00. Included in this distribution (Distro) are too many fixes and tweaks to mention them all! For a complete list of changes see the Change Log. Here are some highlights:

  • As of version 2.50.00, RavenNuke™ has over 20,000 changes, bug fixes, PHP notice fixes, compliance fixes, operational enhancements, and security enhancements.
  • The latest release of NukeSentinel™, which is 2.6.03 as of this writing.
  • A web based table installer for all of the tables use in the Distro.
  • A web based configuration tool for all of the most important settings in the Distro.
  • Tricked Out News (v2.6) replacement for News module.
  • TegoNuke™ Downloads (NSNGD) (v1.1.3) replacement for Downloads.
  • BBtoNuke (phpBB) 2.0.23 as well as made as fully XHTML 1.0 Transitional compliant as possible.
  • The latest Forum Attachment Mod is included as a simple add-on.
  • An enhanced Topics module.
  • An enhanced Recommend Us and Feedback module.
  • Content Plus (v2.2.2) replacement for the Content module.
  • HTML Newsletter module (v1.4.0).
  • GCalendar module (v1.7.0).
  • Tweaked NSN Groups (v1.7.1).
  • Fixes to the Blocks admin screen to correctly order the blocks and to work correctly with NSN Groups.
  • A recoded AdvantGo module to correctly use your theme and is also W3C Compliant.
  • Enhanced and Fixed MetAuthors module.
  • Integration of nukeWYSIWYG™ featuring FCKeditor 2.6.4 and the kses filter class.
  • Integration of nukeSEO™ DH (dynamic generation of title, META description and keywords tags).
  • Integration of nukeFEED™ feed generator (v1.1.1) - create syndication feeds in various formats (RSS/ATOM/OPML) using content on your site, and allow visitors to subscribe to your feeds directly or via Feedburner.com.
  • Integration of nukePIE™ feed reader (v1.1.1) - a replacement for the block feed reader that uses SimplePie to read feeds from other sites in modern feed formats (including RSS 2.0 and ATOM).
  • Integration of TegoNuke™ ShortLinks (aka: GoogleTap, GT-NextGEn) (v1.3.1).
  • Integration of TegoNuke™ Mailer (v1.1) - allows for SMTP authenticated mailing option.
  • Integration of an Error Documents module.
  • Integration of Raven's resend email hack and user info hack.
  • Most themes are now 100% W3C CSS and HTML compliant, and the fisubice theme made fully compliant, even in the BBtoNuke modules.
  • Integration of nukeNAV™ (dynamic, user-aware navigation - requires compatible themes).
  • The blocks and modules are almost 100% XHTML 1.0 Transitional compliant (with the exception of module admin pages) - we only say "almost" because we may not have tested absolutely every script path!
  • Tons of code clean-up (readability) and performance enhancements.
  • All applications are fully configured but some settings will/may need changing for security.
  • Shout Box from ourscripts.net (v8.5.2) - not integrated, but provided in the download package (tweaked by Gremmie and Testy1 to work under RavenNuke™.

Resource Requirements Needed

Software Recommended Minimum More information
Operating System Linux/UNIX/Windows N/A Other operating systems may work, but are not supported.
Apache 2.x + 1.3 Other web servers are known to work, but are not supported.
http://www.apache.org
If shortened links are desired, the Apache mod_rewrite module will be required.
MySQL 5.1 + 4.1 Only MySQL is now supported and all others have been removed from the distribution.
http://www.mysql.com
PHP 5.2 + 5.2 + Although core RavenNuke™ is certified to run on 5.2, some add-on modules and hacks may not. RavenNuke™ currently has some issues on 5.3 +.
http://www.php.net
The GD extension with FreeType 2.x support is also required for the security captcha to work properly.

It is highly recommended that you run your production site on Linux, Apache, MySQL, and PHP (LAMP), OR Windows, Apache, MySQL, and PHP (WAMP) for the best protection and performance.

Tools to help you customize RavenNuke™

XAMPP: It is highly recommended that you use this bundled distribution of Apache, MySQL, and PHP (there is more too) so that you can "test drive" your upgrade on your PC or home server rather than doing this on a live production site. The folks at Apache Friends make this so easy (install and "go") we cannot emphasize enough that folks get this and use it. You do not have to be a programmer in order to get a fully functional WAMP or LAMP environment up-and-running on a local system.

Text Editor: It is highly recommended that you use a good text editor for editing your files. Notepad and Wordpad should NOT be used as they often times add extra characters and/or lines to the end of your files, which can cause browsers to misinterpret the HTTP Header responses. NotePad++, Textpad, Crimson Editor, and several others are good and reliable alternatives.

File Comparison: A good file compare/merge utility. There are several out there, some free and some not. CompareIT, ExamDiff Pro, Beyond Compare, WinMerge (free), etc. all get the job done. These tools are invaluable for upgrading your site.

FTP Client: In most cases required to upload and download files from your web site. WS_FTP, CuteFTP, FileZilla (free), etc. should all work very well for uploading the files for this Distro.

There many other tools that can aid you in developing and maintaining your site, but these are the necessities in our opinion.