home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 April / PCWorld_2005-04_cd.bin / akce / web / phpnuke / PHP-Nuke-7.5.exe / Install.txt < prev    next >
Text File  |  2003-12-31  |  8KB  |  198 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 services 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 or Windows Box installed and working properly.
  29. - Apache Web Server (http://www.apache.org)
  30. - PHP version 4.2.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. Unzip 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.  
  54. Now go to the directory where you uncompressed all files and edit the
  55. file "config.php". Change all the fields until you are happy with the
  56. changes and they fits the need of your web site. Give special attention
  57. to the database configuration section. When you have finished to edit
  58. config.php file change to the /sql/ directory and there is a file called
  59. "nuke.sql" this file contains the commands to build the database structure,
  60. tables and the default data.
  61.  
  62. If you're using a software like phpMyAdmin go to step 3.
  63.  
  64. 1) Create a database called, for example, nuke:
  65.  
  66.     mysqladmin create nuke
  67.     
  68. 2) Now fill the databases with the tables in nuke.sql file:
  69.  
  70.     mysql nuke < nuke.sql
  71.  
  72. 3) In order to use the ultramode.txt news file please be sure to chmod 666.
  73.    This file is used to show news from your site in some old programs and
  74.    frontends and is reserved to future use in PHP-Nuke. For backend use
  75.    backend.php file instead.
  76.  
  77. 4) That's it!... now you need to edit the file "config.php" to set the
  78. database options. Please read carefully the instruction on that file!
  79. After that, point your browser to:
  80.  
  81.     http://yourdomain.com/admin.php
  82.     
  83.     We use MySQL as the example and nuke.sql file is in MySQL format
  84. because PHP-Nuke was made using this database server. You can find
  85. many programs out there to convert the database schema from MySQL to
  86. whatever else you want. But this is a task for you.
  87.  
  88.  
  89. First Run
  90. ---------
  91.  
  92.     Create your Super User following the on-screen instructions.
  93.     Now click on "Preferences" and change whatever you want to fit your
  94. site info. All the options you need to change are in the Preferences
  95. menu. If you need help just click con the help icon at the right-top
  96. of the Administration Menu. This will open a new window with the help
  97. you need for each section in the administration system.
  98.  
  99. SECURITY TIP: It's a good choice to put your config.php file outside the
  100. Web Server path, then you can create a new config.php with the line:
  101.  
  102. <?php include("../config.php"); ?>
  103.  
  104.  
  105. Upgrading from previous versions
  106. --------------------------------
  107.  
  108.     To upgrade a prevoius PHP-Nuke installation to this new version you
  109. need to edit the selected upgrade file from upgrades directory and launch
  110. your web browser to:
  111.  
  112.     http://www.yourdomain.com/upgrade35-4.php
  113.  
  114.     all the new tables will be added and updated automagically without touch
  115. your old data.
  116.  
  117. IMPORTANT: Remember to backup always your database before any upgrade, just
  118. in case. If something goes wrong don't come crying to me.
  119.  
  120.  
  121. Testing the Installation
  122. ------------------------
  123.  
  124. Go to your homepage, for example:
  125.  
  126.     http://yourdonaim.com/index.php
  127.     
  128. To initiate your activities in your site, you need to login as Administrator at:
  129.  
  130.     http://yourdomain.com/admin.php
  131.     
  132.     this will give you full administrator priviledges to your installation of Nuke.
  133.  
  134. *** For security reasons please remember to create a Super User IMMEDIATELY!!! ***
  135.  
  136.     Remember to "Logout" from admin after you use it, from this area you can
  137. delete or add content on your site, never leave your computer without logggin out
  138. from the admin account. If something bad happens don't come crying to me.
  139.  
  140.     I recommend the use of phpMyAdmin. It's a good administration system for
  141. MySQL databases. To download it just go to http://phpmyadmin.net
  142.  
  143.     I also recommend to set a password for your MySQL access. This is important
  144. as some data in the nuke database is not encrypted, so for security reasons you
  145. need to set a password, not only that, it's a good practice!
  146.  
  147.     For Banners System, when you setup a new client, you need to assign a new
  148. login/password for him. The login and password is used by the client at the url:
  149.  
  150.     http://yourdomain.com/banners.php?op=login
  151.     
  152.     in order to let the    client view and track the banners stats in real time
  153. just pass that url to your clients. Take a look yourself before you do.
  154.  
  155.  
  156. Final Notes
  157. -----------    
  158.  
  159.     That's it! You're done with PHP-Nuke. Just navigate around, play with it, 
  160. abuse it and if you like PHP-Nuke, use it. Spend some time getting used to the 
  161. administration interface.
  162.  
  163.     To change your site's logo, go to the themes directory and make a custom
  164. logo for each individual theme. Just navigate around all themes and change
  165. the graphics you want.
  166.  
  167.     A note for the PHP-Nuke site's administrators: Only admins (authors) can
  168. view the following data in the site:
  169.  
  170.     - Administration Menu
  171.     - Number of New Submissions
  172.     - Edit button for each link in Web Links
  173.     - Edit and Delete options for each Article
  174.     - Delete option for each comment
  175.     - IP/Host address of the comment poster
  176.     - Moderation option and button (if set for admin only)
  177.     - and MANY more...
  178.  
  179.     If you plan to give something in change for PHP-Nuke as a contribution,
  180. please read the file SUPPORT included in this package to have some ideas.
  181.     
  182. PS: When you e-mail me asking something, just remember that I receive A LOT
  183. of e-mails per day!!! so I can't answer to all you, but for sure I'll read it.
  184. But please don't wait for an answer.
  185.  
  186.  
  187.  
  188. *** Special Thanks to all the people who help sending bugs reports, fixes, new
  189. add-ons, requests for new features, etc... I really appreciate you all! ***
  190.  
  191. ************************************
  192. * PHP-Nuke URL: http://phpnuke.org *
  193. ************************************
  194.  
  195. Enjoy!
  196.  
  197. -- Francisco Burzi
  198.