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