Instructions for a NEW installation (or an UPGRADE) of the Plus version you just downloaded.
Note: This version comes with a fully automated wizard to help you install phpMyChat-Plus on your site.
Alternatively there is a manual install folder which contains more instructions for a manual install.
If you fail to successfully run the automated install or if you choose the manual installation, please read step 6 then go to the manual install folder and follow those instructions (step 2a below).
1. Extract plus.zip
2a. Important: if you want to upgrade (or encounter troubles with this installer), read the file manual installation/Manual Instructions.txt for things you need to take into account before next step!
2b. Upload the plus directory into your public_html folder.
Note: index.php must be in the plus folder, not plus/chat/ as for the previous versions.
3. Optionally, rename the plus folder to whatever you’d like (chat, mychat).
4. Open http://yoursiteurl.com/plus (plus is the name you used in step 3.). The setup will load automatically.
5. Pick up an available language and go through the installer (thanks to Thomas Pschernig and Ciprian).
Note: If your FTP username looks like an email address (specific to hosting on shared servers), try with an empty/null “FTP root path (relative)” field on the first page of the installer wizard.
6. Make sure the file install/install.php is deleted from your chat, otherwise you won’t be able to open the chat login page.
7. Test your site functionality by opening http://yoursiteurl.com/plus (plus is the name you used in step 3.) in your browser. Note that there is only one admin right now: the one defined during setup.
8. Open the Administration menu/link (Admin Panel) and customize your chat (do not rename your bot yet).
That’s it! It should fly!
A: If you don’t intend to use the bot, edit the quick menu in the admin config panel to eliminate the bot commands from the quick list.
If the bot answers you (posts any content) then you can change it’s name in Admin Panel now – it’s safe.
This version comes only with the English and German bot files.
B: If you get into trouble with the bot, you need to uninstall and reinstall it to make it work again:
B1. Stop the bot in the chat rooms it is started in, using the “/bot stop” command (if it doesn’t work, just delete the bot records in c_users table – with phpmyadmin – and botfb folder).
B2. Rename the bot to “plusbot” in Admin panel.
B3. Use phpmyadmin to “empty” the following tables: bot_bot, bot_bots, bot_patterns and bot_templates.
B4. Reupload back (restore) the file called botloader.php (or botloaderinc.php, if the first freezes).
B5. Make sure all the original distributed AIMLs are in the bot/aiml/ folder (startup.xml and *.aiml files).
B6. Make sure the plus/bot/subs.inc file is CHMODed to 777.
B7. Reinstall the bot following the steps described in paragraph A. (A1-A8)
C: To add other chat languages by yourself, download and edit the existing language files from the standard pack and add the new folder into /localization/ Plus folder. (well, the best way is to contact me and get the latest templates in a Word format…)
Please note that there is a new approach to Plus, each language folder includes an /images/ folder with it’s own images (flag.gif – 3D, flag0.gif – 2D, exitdoor.gif, exitdoorRoll.gif, helpOn.gif and helpOff.gif). Required only are the corresponding flag images for your language (2D could be also copied from the standard version and just renamed to flag0.gif). If not added, the help and door images will be automatically shown from the English.
Insert, modify and translate according to the modified/new lines added in the English Plus version (use a Text Compare software). To be compatible with Plus, the new files should be encoded into “UTF8 without BOM” (just a few text editors can convert and keep this format – I personally prefer Notepad++ (free and powerful!) – never use the Windows Notepad or Wordpad). If everything goes fine, you can make your translation available to other users by contacting me at my email address (last line in this document).
D. This chat comes with several different skins (skins/style1-NN.css.php).
You can build your own styles. (please do not modify the provided ones!)
One single style is composed of two files: styleN.css.php (main css style) and styleN.php (skin settings). Copy these two files and rename them by increasing the overall number (e.g. if style17.php is the biggest number, rename to style18.css.php and style18.php) then start to customize them to match your needs. The main colors are in style18.php. Don’t forget to give it a name and add your credits then test it. The new skin will automatically become available in the Admin Panel/Configuration/Menu/Rooms & Colors, as well as in the Skins Preview popup.
Note: if you’d like to share the new skin, feel free to send it by email to Ciprian to be included in future versions.
For more instructions (e.g. how to upgrade the c_reg_users table) read the Plus FAQ.txt in the “docs/plus docs” folder. Actually, also read the Fixes readme.txt which might give you some more hints about new features/fixes and other stuff.
That’s all for now! Have a nice one and let me know how it goes!
Do you need some more tries at different configurations before applying to your chat server? Don’t hesitate to use the Demo/Try me server at http://ciprianmp.com/latest/ (use admin/admin or moderator/moderator as login for different powers – no registration required)
My best regards,
ciprianmp at yahoo dot com