home *** CD-ROM | disk | FTP | other *** search
/ Internet Magazine 2003 October / INTERNET108.ISO / pc / software / windows / building / php_nuke / install.txt next >
Encoding:
Text File  |  2003-03-17  |  8.1 KB  |  199 lines
  1. PHP-Nuke: Web Portal System
  2. ===========================
  3.  
  4. PLEASE READ CAREFULLY THE FOLLOWING INSTRUCTIONS. IF YOU DO THIS,
  5. YOU WILL HAVE YOUR SITE UP AND RUNNING IN JUST A FEW MINUTES.
  6.  
  7. ##############################################################################
  8. #                        I M P O R T A N T    N O T E                        #
  9. ##############################################################################
  10. # IMPORTANT: I saw many sites that removes the copyright line in the footer  #
  11. # of each page. YOU'RE NOT ALLOWED TO REMOVE NOR CHANGE/EDIT THAT NOTE. If I #
  12. # still see this problem happening I'll need to take extreme measures that   #
  13. # can include: to change the PHP-Nuke license, to encrypt some parts of the  #
  14. # code, stop distributing it for free and in an extreme case stop developing #
  15. # it. The decision is in your hands.                                         #
  16. # You can sell service based on PHP-Nuke, you can make money from it, you    #
  17. # can do almost whatever you want with PHP-Nuke but DO NOT REMOVE NOR EDIT   #
  18. # THE COPYRIGHT NOTICES!!! Fair Play.                                        #
  19. # If you do not agree with this simple rule, delete all PHP-Nuke files       #
  20. # rigth now and move away from it. Thanks.                                   #
  21. ##############################################################################
  22.  
  23. Base Requirements
  24. -----------------
  25.  
  26. In order to setup PHP-Nuke the folowing prerequisits are necessary.
  27.  
  28. - A Linux Box (http://www.linux.com) Installed and working properly.
  29. - Apache Web Server (http://www.apache.org)
  30. - PHP version 4.1.x or better (mod_php) Apache module (http://www.php.net)
  31. - MySQL database server (http://www.mysql.com)
  32.  
  33. NOTE: From PHP-Nuke version 5.3, I added a new SQL abstraction layer,
  34. this means that PHP-Nuke now supports MySQL, mSQL, PostgreSQL, PostgreSQL_local,
  35. ODBC, ODBC_Adabas, Sybase and Interbase servers. The official test server
  36. is MySQL which is used to develop PHP-Nuke. Any feedback about others SQL Servers
  37. and how it works will be very appreciated and useful.
  38.  
  39. The above doesn't mean it will not work with other configurations, OS's, DB's, etc,
  40. but we only provide INSTALL instructions for the above configuration.
  41. In fact PHP-Nuke works under Windows (all), FreeBSD, OS/2, MacOS, etc.
  42.  
  43. Setup of these required packages is beyond the scope of this document
  44. and if you are unsure you should check with each of the appropriate web
  45. sites for further details.
  46.  
  47.  
  48. Installing the Package
  49. ----------------------
  50.  
  51. Untar the package into the directory you want to use on you web
  52. server, if you're unsure where that is, ask you system administrator.
  53. (Windows users can use WinZip or WinRAR to uncompress .tar.gz files)
  54.  
  55. tar -zxvf PHP-Nuke.tar.gz
  56.  
  57. Now go to the directory where you uncompressed all files and edit the
  58. file "config.php". Change all the fields until you are happy with the
  59. changes and they fits the need of your web site. Give special attention
  60. to the database configuration section. When you have finished to edit
  61. config.php file change to the /sql/ directory and there is a file called
  62. "nuke.sql" this file contains the commands to build the database structure,
  63. tables and the default data.
  64.  
  65. 1) Create a database called, for example, nuke:
  66.  
  67.     mysqladmin create nuke
  68.     
  69. 2) Now fill the databases with the tables in nuke.sql file:
  70.  
  71.     mysql nuke < nuke.sql
  72.  
  73. 3) In order to use the ultramode.txt news file please be sure to chmod 666.
  74.    This file is used to show news from your site in some old programs and
  75.    frontends and is reserved to future use in PHP-Nuke. For backend use
  76.    backend.php file instead.
  77.  
  78. 4) That's it!... now you need to edit the file "config.php" to set the
  79. database options. Please read carefully the instruction on that file!
  80. After that, point your browser to:
  81.  
  82.     http://yourdomain.com/admin.php
  83.     
  84.     We use MySQL as the example and nuke.sql file is in MySQL format
  85. because PHP-Nuke was made using this database server. You can find
  86. many programs out there to convert the database schema from MySQL to
  87. whatever else you want. But this is a task for you.
  88.  
  89.  
  90. First Run
  91. ---------
  92.  
  93.     Create your Super User following the on-screen instructions.
  94.     Now click on "Preferences" and change whatever you want to fit your
  95. site info. All the options you need to change are in the Preferences
  96. menu. If you need help just click con the help icon at the right-top
  97. of the Administration Menu. This will open a new window with the help
  98. you need for each section in the administration system.
  99.  
  100. SECURITY TIP: It's a good choice to put your config.php file outside the
  101. Web Server path, then you can create a new config.php with the line:
  102.  
  103. <?php include("../config.php"); ?>
  104.  
  105.  
  106. Upgrading from previous versions
  107. --------------------------------
  108.  
  109.     To upgrade a prevoius PHP-Nuke installation to this new version you
  110. need to edit the selected upgrade file from upgrades directory and launch
  111. your web browser to:
  112.  
  113.     http://www.yourdomain.com/upgrade35-4.php
  114.  
  115.     all the new tables will be added and updated automagically without touch
  116. your old data.
  117.  
  118. IMPORTANT: Remember to backup always your database before any upgrade, just
  119. in case. If something goes wrong don't come crying to me.
  120.  
  121.  
  122. Testing the Installation
  123. ------------------------
  124.  
  125. Go to your homepage, for example:
  126.  
  127.     http://yourdonaim.com/index.php
  128.     
  129. To initiate your activities in your site, you need to login as Administrator at:
  130.  
  131.     http://yourdomain.com/admin.php
  132.     
  133.     this will give you full administrator priviledges to your installation of Nuke.
  134.  
  135. *** For security reasons please remember to create a Super User IMMEDIATELY!!! ***
  136.  
  137.     Remember to "Logout" from admin after you use it, from this area you can
  138. delete or add content on your site, never leave your computer without logggin out
  139. from the admin account. If something bad happens don't come crying to me.
  140.  
  141.     I recommend the use of phpMyAdmin. It's a good administration system for
  142. MySQL databases. To download it just go to http://phpwizard.net/phpMyAdmin
  143.  
  144.     I also recommend to set a password for your MySQL access. This is important
  145. as some data in the nuke database is not encrypted, so for security reasons you
  146. need to set a password, not only that, it's a good practice!
  147.  
  148.     For Banners System, when you setup a new client, you need to assign a new
  149. login/password for him. The login and password is used by the client at the url:
  150.  
  151.     http://yourdomain.com/banners.php?op=login
  152.     
  153.     in order to let the    client view and track the banners stats in real time
  154. just pass that url to your clients. Take a look yourself before you do.
  155.  
  156.  
  157. Final Notes
  158. -----------    
  159.  
  160.     That's it! You're done with PHP-Nuke. Just navigate around, play with it, 
  161. abuse it and if you like PHP-Nuke, use it. Spend some time getting used to the 
  162. administration interface.
  163.  
  164.     To change your site's logo, go to the themes directory and make a custom
  165. logo for each individual theme. Just navigate around all themes and change
  166. the graphics you want.
  167.  
  168.     A note for the PHP-Nuke site's administrators: Only admins (authors) can
  169. view the following data in the site:
  170.  
  171.     - Administration Menu
  172.     - Number of New Submissions
  173.     - Edit button for each link in Web Links
  174.     - Edit and Delete options for each Article
  175.     - Delete option for each comment
  176.     - IP/Host address of the comment poster
  177.     - Moderation option and button (if set for admin only)
  178.     - and MANY more...
  179.  
  180.     If you plan to give something in change for PHP-Nuke as a contribution,
  181. please read the file SUPPORT included in this package to have some ideas.
  182.     
  183. PS: When you e-mail me asking something, just remember that I receive A LOT
  184. of e-mails a day!!! so I can't answer to all you, but for sure I'll read it.
  185. But please don't wait for an answer.
  186.  
  187.  
  188.  
  189. *** Special Thanks to all the people who help sending bugs reports, fixes, new
  190. add-ons, requests for new features, etc... I really appreciate you all! ***
  191.  
  192. ************************************
  193. * PHP-Nuke URL: http://phpnuke.org *
  194. ************************************
  195.  
  196. Enjoy!
  197.  
  198. -- Francisco Burzi
  199.