---------------------------------------- newsPHP v200 Preview Release Readme By Ben O'Neill ---------------------------------------- 1) Installing newsPHP a) UNIX/Linux b) Windows Servers c) Upgrading 2) Getting Help 3) Advanced Usage 4) What's New 5) Known Issues 6) License 7) GETTING THE NEWS ONTO YOUR SITE ---------------------------------------- 1) INSTALLING newsPHP ---------------------------------------- a) On a UNIX/Linux machine. The first thing to do, is unzip the file, which, if you are reading this, you've probably already done. 1) Connect to your FTP server. 2) Create a directory called "nphp" 3) Upload all the files in the zip from the "nphp" directory in ASCII format. 4) You will need to CHMOD these important files to these modes. nconf.php 666 or 777 news.txt 666 or 777 archive.txt 666 or 777 headlines.txt 666 or 777 maillist.txt 666 or 777 nphpd.dat 666 or 777 This allows the script to edit it's files. 5) Goto the script via a web browser eg. http://www.yoursite.com/nphp/nphpd.php You will then be presented with the newsPHP First-Time setup screen. Enter a User Name, Password and E-mail address. These are the details of your administrator, don't forget them! Once newsPHP has added the user you are taken to the newsPHP installation complete page. If you need to buy a book or something, click on the book button ;) Also, if you could rate our script we'd love that too! A 10 and excellent would make me very happy and probably get tech. emails done quicker. Now goto the script via your web browser again, eg. http://www.yoursite.com/nphp/nphpd.php 6) Fill in the details you just entered, and click submit. You're then logged in! 7) GOTO THE SETTINGS PAGE!! 8) Please please please check all the settings, they are not all going to be the way you want, so make sure you check! b) On a Windows machine. The first thing to do, is unzip the file, which, if you are reading this, you've probably already done. 1) Connect to your FTP server. 2) Create a directory called "nphp" 3) Upload all the files in the zip from the "nphp" directory in ASCII format. 4) CHMOD doesn't really exist in Windows, so you need to do this, first of all, check if it works by skipping this step, if it doesn't work, do this. If you ask your hoster to "Create an Application" on the "nphp" folder, and to make sure it has script read/write priviledges. That should do it. 5) Goto the script via a web browser eg. http://www.yoursite.com/nphp/nphpd.php You will then be presented with the newsPHP First-Time setup screen. Enter a User Name, Password and E-mail address. These are the details of your administrator, don't forget them! Once newsPHP has added the user you are taken to the newsPHP installation complete page. If you need to buy a book or something, click on the book button ;) Also, if you could rate our script we'd love that too! A 10 and excellent would make me very happy and probably get tech. emails done quicker. Now goto the script via your web browser again, eg. http://www.yoursite.com/nphp/nphpd.php 6) Fill in the details you just entered, and click submit. You're then logged in! If you find it doesn't show the login page, but shows the first-time page again, then newsPHP wasn't able to save your settings and stage 5 wasn't worked. Check out the Server Support forum on our web site for help ( http://www.nphp.net ). 7) GOTO THE SETTINGS PAGE!! 8) Please please please check all the settings, they are not all going to be the way you want, so make sure you check! c) Upgrading newsPHP v200 is not compatible with other version. This is a preview release, once the final is released there will almost certainly be a script included to convert older versions to v200. ---------------------------------------- 2) GETTING HELP ---------------------------------------- If you have any problems, there are lots of places you can turn to. First of all, check out our forums at: http://www.nphp.net If you are still having problems, read the documentation again. If you still don't find the help you need, come onto IRC. Server: Undernet - uworld.undernet.org:6667 Channel: #nphp Still having problems, please contact the tech. support email groupies. They won't be happy if you ask a question that was in the docs.. support@nphp.net ---------------------------------------- 3) ADVANCED USAGE ---------------------------------------- There are a few options you can set inside the "nphpd.php" file. You can change the name of common files like the config file, but you must edit the "nphpd.php" file and tell it what it's file is called. eg. $nphp_files["config"] = "nconf.php"; // The nPHP configuration file. ^^^^^^^^^ Change this part. ---------------------------------------- 4) WHAT'S NEW ---------------------------------------- Well, what is new? All of it" v200 is a total remake. ---------------------------------------- 5) KNOWN ISSUES ---------------------------------------- The follow are known by the newsPHP team and should not be reported. * Sessions do not currently work as they should with newsPHP. PHP's sessions are too unreliable to logout a user, then they can't login. It's very odd and we're looking into it. For now, stick with cookies. * When using an extension not all extensions may appear on the toolbar. This is due to the way extension files are included. Not all extensions are included before the extension page shows. ---------------------------------------- 6) LICENSE ---------------------------------------- Copyright 2000 Ben O'Neill All rights reserved. This script is currently FREE of charge. You may modify this script, but you may NOT redistribute it in any way. The price of this script may change in the future. This script may not be used on web sites with pornographic content. Open "nphpd.php" for more information and copyright details. The authors cannot take responsibility for loss of data or anything else. Website: http://www.nphp.net/ ---------------------------------------- 7) GETTING THE NEWS ONTO YOUR WEB SITE ---------------------------------------- There are two ways of doing this, using PHP or SSI. If you pages are already PHP files then use the PHP way. If they are .shtml or .shtm then use the SSI method. PHP Method: SSI Method: If your pages are just .html then you will need to rename them and use the correct method. I reccommend renaming to .PHP and using the PHP method. PHP method only works with .PHP extensions, SSI only works with .SHTML, .SHTM extensions.