myPHPNuke: Web Portal System
============================
*based on PHP-Nuke 4.4.1a

Basic Requirements


Software
--------
Apache 1.3.xx
MySQL 3.23.xx
PHP 4.2.x


Database
--------
DB Name
Db User name
Db Password
Db table prefix

If hosted by an ISP, they will provide you with access to your MySQL account
with a User Name and Password. They may also tell you the database name to
use. You will create the tables within that database with the prefix you chose.
The use of a prefix allows you to host several different MySQL based
applications within one database.


Host Server
-----------
ftp Address
ftp User name
ftp Password

If hosted by an ISP, know where they want you to place your publicly accessible
file ie: your site. You use ftp to move files back and forth as well as change
the permissions on files and directories.


Your myPHPNuke Site
-------------------
Admin Login  
Your Name  
Admin Password  
Your Email  
Your Url  

Admin Login and Admin Password are used to safely maintain and modify your new
myPHPNuke site. These you get to choose.


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

1)  Unzip  package into the directory you want to use on you web server, if 
    you're unsure where that is, ask you system administrator.


    If you are hosting MPN on an Internet Service Provider (ISP) it is easiest 
    to Unzip the package locally and then use an ftp application to move
    the files to your online account.

    If you're on a shared server, 
    
    DIRECTORIES:
    chmod 777 admin/original
    chmod 777 admin/myphpnuke
    chmod 777 cache
    chmod 777 gallery/temp
    chmod 777 gallery/gallery
    chmod 777 gallery/gallery/Art
    chmod 777 uploads/mail

    FILES:
    chmod 666 dbconf.php
    chmod 666 ultramode.txt
    chmod 666 admin/blockcenter/config.php
    chmod 666 admin/download/config.inc.php
    chmod 666 admin/emailuser/html.inc.php
    chmod 666 admin/gallery/config.php
    chmod 666 admin/guestbook/config.php
    chmod 666 admin/original/dbconfig.php
    chmod 666 admin/rand_banners/config.php


2)  Point your browser to http://yourdomain.com/install.php

3)  Follow the instructions from this script.
    
    a)Review the GNU GENERAL PUBLIC LICENSE then hit NEXT.

    b)Enter your:
    
      DB Host  
      DB User Name  
      DB Password  
      DB Name  
      Table Prefix 

    c)At the bottom of the next page you are give the choice of creating a new
      database. If your ISP has created one for you, which you named on the
      previous page do not select Make the DB. Otherwise let myPHPNuke create a
      new database. 

    d)If the where no errors on the next page go ahead and press continue
      otherwise review the troubleshooting guide at the bottom of this document
      or post a message to the forums at www.myphpnuke.com.

    e)Enter your:
    
      Admin Login
      Your Name
      Admin Password
      Your Email
      Your Url
      
      If your permissions are not set correctly you will not be able to create
      the needed configuration file and at this point will see errors. Ftp to
      your site, chmod the files and directories correctly, then hit the back
      button on your browser and try again. 

      
4)  That's it!... Now you can login as an administrator using the Admin Login
    name and password above.

    
    Now click on "PHP-Nuke" and then on "Preferences" and change whatever you
    want to fit your site info. After that, click on "myPHPNuke" and make the
    necessary changes. All the options you need to change are in the
    Preferences menu. 

    If you need help just click on the help icon at the right-top of the
    Administration Menu. This will open a new window with the help you need for
    each section in the administration system.

5)  Also, to activate Headlines you need to chmod 777 the "cache" directory,
    otherwise headlines won't function.
    
6)  After the installation please delete or rename the install.php file.
    Failure to do this will leave you open to someone redirecting your site to
    a different DB server among other nasties.  
   
    NOTE: If you want to edit config.php file via Administration using your web
    browser remember to chmod 666 the files admin/original/config.php and
    admin/myphpnuke/original or your changes will not be saved! If can't
    execute chmod just edit the file by hand and re-upload it to your server.

    It is probably best to allow Changes to config.php file via Administration.
    
    NOTE: There are other config files in the admin section like blockscenter,
    downloads, and myegallery, that may need to have their particular config
    files chmod to 666 if you cannot change their settings from your web
    browser.


Upgrading from previous versions
--------------------------------

    To upgrade a previous myPHPNuke installation to this new version read
    upgrade.txt please.

		
Testing the Installation
------------------------
 
    Go to your homepage, for example:

    http://yourdomain.com/index.php
    
    To initiate your activities in your site, you need to login as
    Administrator at:

    http://yourdomain.com/admin.php
    
    at the login prompt enter the Admin Login and Password

   
    This will give you full administrator privileges to your installation of
    myPHPNuke.
    
    For security reasons please remember to change the admin password and
    nickname "immediately" if you used the default one in the install.php
    script. You can do this by clicking on the "Edit Admins" option.
    
    Remember to "Logout" from admin after you use it, from this area you can
    delete or add content on your site, never leave your computer without
    logging out from the admin account. If something bad happens don't come
    crying to us.

    We recommend the use of phpMyAdmin. It's a good administration system for
    MySQL databases. To download it just go to http://phpwizard.net/phpMyAdmin.
    As of version 1.8.8_8 RC2, phpMyAdmin is a standard part of myPHPNuke and 
    you can run it from the Admin menu.

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


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

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

    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.

    A note for the myPHPNuke site's administrators: Only admins (authors) 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)
    - Maintenance of users right from the memberslist
	- much more...

		
Support
-------

    If you need any support or looking for updates visit our website at
    http://www.myphpnuke.com


The Team
