PSB Readme File
There are actually three types of PSB™s: The first is the only free type of PSB™ and we refer to it as an MC PSB™. It uses only 1 user password and everyone uses it, and anyone can change anyone else's status at any time. The other 2 types are Social PSB™s and Business PSB™s wherein changing any one person's status and comment can be done only by that person himself or herself. For details, see:
—and get the full scoop.
MCS Investments, Inc. grants you the right to use this PSB™ software, subject to the following conditions:
By installing or using this software, you accept the terms of this licence with MCS Investments, Inc. This software and any accompanying documentation are the property of MCS Investments, Inc., and are licenced to you for your use only. Copying and/or distribution of the software or documentation in any form, except for the purpose of backup for your use only is strictly prohibited. You may use it on one database only and if you switch to a different database you must delete the tables from the first database, or move them to the new database. As host to administrators, you may sign up as many administrators as you like as long as you use only one database. MCS Investments, Inc. grants you the right to use one copy of this software for your use only. (The administrators and users that use it are fine, but only you may act as host of administrators.) This licence covers both the computer files (software) and the other content of the product. You may not reverse engineer, decompile, disassemble or create derivative works of the software. Any infringement of the above conditions will lead to automatic cancellation of the licence to use the software.
This Personal Status Board (PSB™) software is provided "as-is". No warranty of any kind is expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the authors or contributors be liable for any direct, indirect, incidental, special, exemplary,or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage. Use it at your own risk. By using this Personal Status Board (PSB™) software, you agree to the terms of this license.
The configure.php file is a file used on most of the pages of the administrator's area. It's brought into the code base as an include file, which makes it act as if it were a block of code on the page. All it does is connect the administrator to the host's server and MySQL database. The various database tables dealt with on the various administrator pages require this configure file to empower the necessary connections. You, the host of administrators, must replace the generic email, username, password, and database names between the quotes (all are marked EDIT ME here for clarity) with real ones, and there's a chance that "localhost" may even need adjustment—but that's very unlikely. Do NOT edit anything else, especially the mysql_connect and mysql_select_db lines.
$psbhostemailaddress = "thepsbhostemailaddress"; //EDIT ME
$roothostname = "localhost";
$psbhostusername = "thepsbhostusername"; //EDIT ME
$psbhostpassword = "thepsbhostpassword"; //EDIT ME
$psbhostdatabasename = "thepsbhostdatabasename"; //EDIT ME
mysql_connect("".$roothostname."","".$psbhostusername."","".$psbhostpassword."") or die(mysql_error());
mysql_select_db("".$psbhostdatabasename."") or die(mysql_error());
If captcha registration is desired, you, the host of administrators, need to sign up at google (since http://recaptcha.net/ died) and receive a public key and a private key to edit into the register-with-captcha.php file—otherwise, just use register.php, which requires no edits. About 80% of the way down the page you'll find code that looks like this:
$publickey = "publickeygoeshere"; $privatekey = "privatekeygoeshere";
OR LIKE THIS:
$publickey = "6jfjftyr476ufyf57857tuguit7678687tugi76t78789689";
$privatekey = "6gjkgjhv5778tgij897yhli77yghukgkjg8678yighu6698";
Use the keys you get when you sign up in place of the above keys in the register-with-captcha.php file and save it.
We could have added the register.php page to the rest of the administrator's utilities on the Administrator Page, but did not do so for 2 reasons: To get to the Administrator's Page, the administrator must be logged in. But to log in, s/he must have a username and password. But to get a username and password, administrators must register. So—it wouldn't work to put registration utilities with the other utilities. The second reason is that it's best to have no link anywhere connected to either the register.php or the register-with-captcha.php pages. That way the spam crawlers and other nefarious characters will not find the page and will not curse you with spam, fake registrations, or worse. If there's no path to a page, it's crawler-proof. Administrators need to type:
(depending on their choice of folder name and on whether they have the PSB™ Pro or Social PSB™ or Business PSB™) in the browser address bar in order to register. If they wish for a captcha sign-up, then the
files will be used instead. Is it safe (spambot-wise) to save these as Favorites? As far as we know. By the way, logically you shouldn't need the captcha registration because a spambot has no path to find your registration page. But for extra security, go captcha.
The file login.php, like the file register.php, should be saved as Favorites in administrator browsers (with full URLs), and neither these files nor any of the rest of the PSB™ and/or administrator files should be used in links in any web page. Just because the files are on your site doesn't mean there ought to be a link to them.
The USERS need only to have the administrator give or email them their usernames and passwords and the full URL to the psb.php file and they're all set. Users should save the full URL to the psb.php file in a Favorite. If they end up needing edited status code meanings, usernames, passwords, or whatever, they should tell or email the administrator about this. Their PSB™ Favorite should look like:
(depending on which of our products they have).
The file login.php has a code that happens when you click on a Home link: <a href="../index.html"> This assumes you have put all the administrator utility files in a folder on your site such as this:
http://your-website-address/PSB/ —for PSB™ Pro users or
http://your-website-address/Social-PSB/ —for Social PSB™ users or
http://your-website-address/Business-PSB/ —for Business PSB™ users.
If you put them in your root domain, like
then you need to change <a href="../index.html"> to <a href="index.html">. However, if your home page is index.php or home.htm or whatever, change the index.html page name to your home page name, using ../ if appropriate.
The file logout.php has a code that happens when you click on the Logout menu item in the Administrator Page: window.location = "../index.html"; This assumes you have put all the administrator utility files in a folder on your site such as this:
If you put them in your root domain, like
then you need to change window.location = "../index.html"; to window.location = "index.html"; However, if your home page is index.php or home.htm or whatever, change the index.html page name to your home page name, using ../ if appropriate.
Included is a diagram named psb.png that will help you see how all the parts fit together: Servers, databases, MySQL, host of administrators, administrators, users, and PSB™s. Check it out.
Want free hosting and MySQL databases? Here http://www.free-webhosts.com/free-mysql-database.php are 118 free website hosting sites that offer free MySQL databases to use on their web servers.
QUESTIONS? PLEASE GO TO: http://www.css-resources.com/PSB.html