home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 March / PCWorld_2001-03_cd.bin / KOMUNIK / progweb / progweb.exe / phpnuke / INSTALL < prev    next >
Text File  |  2000-12-05  |  7KB  |  191 lines
  1. PHP-Nuke: Web Portal System
  2. ===========================
  3.  
  4. Base Requirements
  5. -----------------
  6.  
  7. In order to setup Nuke the folowing prerequisits are necessary.
  8.  
  9. A Linux Box (http://www.linux.org) Installed and working properly.
  10. Apache Web Server (http://www.apache.org)
  11. PHP (mod_php) Apache module (http://www.php.net)
  12. MySQL database server (http://www.mysql.com)
  13.  
  14. The above doesn't mean it work with other configurations, OS's, DB's etc,
  15. but we only provide INSTALL instructions for the above configuration.
  16.  
  17. Set-up of these required packages is beyond the scope of this document
  18. and if you are unsure you should check with each of the appropriate web
  19. sites for further details.
  20.  
  21. At this moment is known that PHP-Nuke has some problems working with PHP4,
  22. when I have some money to buy a test machine to install in my LAN I promise
  23. that I'll look into this to make it 100% compatible with PHP 3 and 4.
  24.  
  25.  
  26. Installing the Package
  27. ----------------------
  28.  
  29. Unzip and Untar the package into the directory you want to use on you web
  30. server, if you're unsure where that is, ask you system administrator.
  31.  
  32. tar -zxvf PHP-Nuke.tar.gz
  33.  
  34. Change to the sql/ directory and there is a file called "nuke.sql"
  35. this file contains the commands to build the database structure, 
  36. tables and the default data.
  37.  
  38. 1) Create a database called, for example, nuke:
  39.  
  40.     mysqladmin create nuke
  41.     
  42. 2) Now fill the databases with the tables in nuke.sql file:
  43.  
  44.     mysql nuke < nuke.sql
  45.  
  46. 3) In order to use the File Manager, please be sure to chmod 666 ALL
  47. files and 777 ALL directories.
  48.     
  49. 4) That's it!... now you need to edit the file "config.php" to set the
  50. database options. Please read carefully the instruction on that file!
  51. After that, point your browser to:
  52.  
  53.     http://yourdomain.com/admin.php
  54.     
  55.     Login with the following data at the prompt:
  56.     
  57.             AdminID: God
  58.             Password: Password
  59.     
  60.     Now click on "Preferences" and change whatever you want to fit your
  61. site info. All the options you need to change are in the Preferences
  62. menu. If you need help just click con the help icon at the right-top
  63. of the Administration Menu. This will open a new window with the help
  64. you need for each section in the administration system.
  65.  
  66. NOTE: If you want to edit config.php file from web browser remember to
  67. chmod 666 the file config.php or your changes will not be saved! If can't
  68. execute chmod just edit the file by hand.
  69.  
  70.  
  71. Upgrading from previous versions
  72. --------------------------------
  73.  
  74.     To upgrade a prevoius PHP-Nuke installation to this new version you
  75. need to edit the selected upgrade file from upgrades directory and launch
  76. your web browser to:
  77.  
  78.     http://www.yourdomain.com/upgrade35-4.php
  79.  
  80.     all the new tables will be added and updated automagically without touch
  81. your old data, then you need to reconfigure the file config.php to match
  82. your site's info.
  83.  
  84.  
  85. Testing the Installation
  86. ------------------------
  87.  
  88. Go to your homepage, for example:
  89.  
  90.     http://yourdonaim.com/index.php
  91.     
  92. To initiate your activities in your site, you need to login as Administrator at:
  93.  
  94.     http://yourdomain.com/admin.php
  95.     
  96. at the login prompt enter the following:
  97.  
  98.             AdminID: God
  99.             Password: Password
  100.  
  101.     this will give you full administrator priviledges to your installation of Nuke.
  102. For security reasons please remember to change the admin password and nickname 
  103. "immediately". You can do this by clicking on the "Edit Admins" option.
  104.     Remember to "Logout" from admin after you use it, from this area you can
  105. delete or add content on your site, never leave your computer without logggin out
  106. from the admin account. If something bad happens don't come crying to me.
  107.  
  108.     I recommend the use of phpMyAdmin. It's a good administration system for
  109. MySQL databases. To download it just go to http://phpwizard.net/phpMyAdmin
  110.  
  111.     I also recommend to set a password for your MySQL access. This is important
  112. as some data in the nuke database is not encrypted, so for security reasons you
  113. need to set a password, not only that, it's good practice!
  114.  
  115.     For Banners System, when you setup a new client, you need to assign a new
  116. login/password for him. The login and password is used by the client at the url:
  117.  
  118.     http://yourdomain.com/banners.php?op=login
  119.     
  120.     in order to let the    client view and track the banners stats in real time
  121. just pass that url to your clients. Take a look yourself before you do.
  122.  
  123.  
  124. Final Notes
  125. -----------    
  126.  
  127.     That's it! You're done with PHP-Nuke. Just navigate around, play with it, 
  128. abuse it and if you like PHP-Nuke, use it. Spend some time getting used to the 
  129. administration interfaces.
  130.  
  131.     To change your site's logo, go to the themes directory and make a custom
  132. logo for each individual theme. Just navigate around all themes and change
  133. the graphics you want.
  134.  
  135.     A note for the PHP-Nuke site's administrators: Only admins (authors) can
  136. view the following data in the site:
  137.  
  138.     - Administration Menu
  139.     - Number of New Submissions
  140.     - Edit button for each link in Web Links
  141.     - Edit and Delete options for each Article
  142.     - Delete option for each comment
  143.     - IP/Host address of the comment poster
  144.     - Moderation option and button (if set for admin only)
  145.     - more in the future versions...
  146.  
  147.     I made this software free, and released it under GPL, so this software
  148. costs you exactly "nothing". All that I ask you is, if you use it "please"
  149. try to leave a link from your pages to http://phpnuke.org and let others
  150. know that you're using PHP-Nuke. That's all I ask. If you want to make me
  151. a donation, please contact me by email at fburzi@ncc.org.ve
  152. I'll appreciate any money, books or new/used hardware you want to donate to
  153. me. I promise to improve this software and make more for web production.
  154.     If you want to donate something without mail me, just send your donation to:
  155.     
  156.     Francisco Burzi C.
  157.     Av. Principal Pueblo Nuevo
  158.     Via Poligono de Tiro
  159.     Casa # Z-1315
  160.     San Cristobal, 5001
  161.     Estado Tachira
  162.     VENEZUELA
  163.  
  164.     If you send me any Windows related stuff you will be burn in hell, for sure! 
  165. Send all you want for Linux, or anything that works in Linux.
  166.     Finally, if you use PHP-Nuke in your site, please let me know and I'll put
  167. a link back to your site from mine in the PHP-Nuke page. Ok?
  168.  
  169.     Enjoy this software!
  170.     
  171. PS: When you e-mail me asking something, just remember that I receive more
  172. than 600 e-mails per day!!! so I can't answer to all you, but for sure
  173. I'll read it. But please don't expect an answer if your mail is a question
  174. about how to do this or that.
  175.  
  176. Due to the high number of Emails, I want to say:
  177.  
  178.     - I'm not participating nor reading SourceForge forums.
  179.     - I really hate the CVS. So, not CVS for now, maybe in the future.
  180.     - Thanks for understand the above issues!
  181.  
  182. *** Special Thanks to all the people who help sending bugs reports, fixes, new
  183. add-ons, requests for new features, etc... I really appreciate you all!
  184.  
  185. ************************************
  186. * PHP-Nuke URL: http://phpnuke.org *
  187. ************************************
  188.  
  189. Enjoy!
  190.  
  191. -- Francisco Burzi