CPG-Nuke: Advanced Content Management System
--------------------------------------------

Please use our new HTML documentation, found in the /documentation
folder within this directory


Base Requirements
-----------------

In order to setup CPG-Nuke, the following prerequisites are necessary:

- a web server (Apache prefered)
- PHP 4.1 or higher (4.3.x prefered)
- an SQL server (MySQL 4.x and PostgreSQL 7.3.x or later are supported)

Setup of these required packages is beyond the scope of this document and if
you are unsure you should check with each of the appropriate web sites for
further details.


Installing the Package
----------------------

If you are going to upgrade your website start at step two...
If you want to run a CVSWeb read the CVS.txt documentation carefully before you
install our CVS bundle onto your website

1) Create a new database, for example, 'cpgnuke': mysqladmin create cpgnuke
   OR add a database through your web control panel.

2) Edit the file "config.php". Change all the fields until you are happy with
   the changes and they fit the need of your web site. Give special attention
   to the database configuration section. When you have finished editing
   config.php, save it.

3) Now upload all content from the /html directory to your webspace.

4) CHMOD the following file to 600 (622 if 600 fails):
   - cpg_error.log

5) CHMOD the following directories to 755 (777 if 755 fails):
   - cache
   - modules/coppermine/albums
   - modules/coppermine/albums/userpics
   - uploads/avatars
   - uploads/forums

6) In your web browser go to http://mydomain.tld/install.php
   The setup will install/update your database.

   After the database is created you will be prompted to insert additional
   information and, if it's a new install, to create the super user account.
   Create your super user following the on-screen instructions.

7) Login following the admin link (http://mydomain.tld/admin.php)

   Now click on "Main Settings" and change whatever you want to fit your site
   info. All the options you need to change are in the Settings menu.

8) After installing, delete install.php and the /install directory!


Testing the Installation
------------------------

Go to your homepage, for example:

    http://mydomain.tld/index.php

To login as administrator:

    http://mydomain.tld/admin.php

    This will give you full administrator privileges to your installation of
    CPG-Nuke.

    Remember to logout from admin after you use it. From this area you can
    delete or add content on your site, so never leave your computer without
    logging out from the admin account.

    We recommend the use of MySQL-Front or phpMyAdmin. Those are good
    administration systems for MySQL databases.
    www.cpgnuke.com/downloads/mysqlfront25.exe (free version)
    www.mysqlfront.de (30 days free)
    www.phpmyadmin.net/home_page

    We also recommend setting a password for your MySQL access. This is
    important as some data in the nuke database is not encrypted, so for
    security reasons you need to set a password. Not only that, it's a
    good practice!


Final Notes
-----------

  That's it! You're done with CPG-Nuke. Just navigate around, play with it,
abuse it and if you like CPG-Nuke, use it. Spend some time getting used to the
administration interface.

  To change your site's logo, go to the /themes directory and make a custom
logo for each individual theme. Just navigate around all themes and change
the graphics you want.

  We removed quite a few modules from the CPG-Nuke package and put them in
a directory called add-ons. You'll find the Blogs, Web Links, Downloads and
a few others in there. It's very easy to install them. Just copy the contents
of whatever module you want to install to your root directory. For example, to
install the Downloads add-on, copy the contents of the /add-ons/Downloads
directory (/admin, /blocks, /images, /modules) to your root directory.  Log in
as admin, then activate the module. That's all there is to it!  Your module is
now ready to use. Any blocks that come with the add-on are also now ready for
use. Add them the same way you'd add any other block.

  A note for the CPG-Nuke site's administrators: Only admins can view the
  following data in the site:

    - Administration Menu
    - Number of New Submissions
    - Edit button for each link in Web Links
    - Edit and Delete options for each Article
    - Delete option for each comment
    - IP/Host address of the comment poster
    - Moderation option and button (if set for admin only)
    - and MANY more...

PS: When you e-mail us asking something, just remember that we receive A LOT
of e-mails a day! We don't answer, but for sure we'll read it.
Your best bet is to visit the forums at www.cpgnuke.com/Forums.html and post
your questions there.

** A special thank you to all the people who have helped is in CREDITS.txt **

Enjoy!

-- CPG-Nuke Dev Team