WHAT IS WAPMESS?
----------------
Wapmess is a system that runs on any webserver (using PHP and MySQL) and enables the webserver-admin to set up a WAP-ICQ portal. This means that anyone with a mobile-phone (PDA or similar is also fine) that supports Wap 1.2 or higher can use the webserver to connect to an ICQ-account and send/receive messages via ICQ.
The goal with this project was to make it possible for almost any mobile-phone to use ICQ and be able to communicate with other users!
One other goal with this project was to lower the GPRS-traffic in the phone and make the ICQ-ing cheaper.
A third goal was to make this service as easy to log-in to as possible. Anyone tried to fill a log-in screen with a WAP-browser should know what I mean.
With Wapmess all you have to do is to write your login-url ONCE and then bookmark it in your phone, to make it available fast. :)
The protocol supported is ICQ 8.0 (Tested with ICQ 2002, ICQ 2003, ICQ Lite etc.)
SYSTEM REQUIREMENTS
-------------------
As of now the system should work on any Win32 webserver (We want help to develop a *nix working version of Wapmess aswell)
MySQL 3.2 http://www.mysql.com (or higher)
PHP 4.3 http://www.php.net (or higher. Must have support for CLI)
INSTALLATION
------------
This is how to install Wapmess on win32 systems. Installation on other systems supporting PHP and MySQL should be possible, but have not been tested as of yet.
This instruction assumes that your have MySQL and PHP already installed and working properly. It also assumes that you have a basic knowledge in configuring your webserver and understanding how webservers work.
1) Create a directory(eg. wapmess) on the web-server where you want to deploy Wapmess. Copy all php-files(*.php) from the Wapmess-archive to the web-server directory.
EDIT CONFIG.PHP
---------------
2) Edit config.php with a texteditor and set the MySQL database server, username, password and the name of the database you want to use.
The PHP CLI home directory should be set to where your PHP installation keeps it CLI-PHP executable file. (Most commonly c:/php/cli/). Do NOT forget the trailing /-sign!
The Steps 3-5 can be done automaticly with the install-script install.php, just make sure that you have the right settings in config.php!
To use the install script just open a webbrowser (eg. Internet Explorer) and Go to http://[YOUR WEBSERVER]/[PATH TO WAPMESS]/install.php and the installation should be done quickly! :)
If you do not want to use the install-script, just follow step 3-5 below.
CREATE DATABASE AND TABLES
--------------------------
We recommend that you use phpMyAdmin (http://www.phpmyadmin.net/) or similar when setting up your database, or refer to the documentation on www.mysql.com for more info
3) Create a database in your MySQL-database server and name it the same as you set in the config.php file (above).
4) Run the icqtalk.sql SQL-script file on your MySQL-server in the database you just created. The tables: alive, contactlist, cookies, incoming, outgoing and uinstatus should have been created.
5) Now copy the file bgrun.exe from the Wapmess-archive to your PHP CLI home directory. (Most commonly c:/php/cli/). NOTE!!! This file bgrun.exe does NOT work on any other system but Win32 as of now. If you are installing this system on a system other that that you will have to make changes in index.php to make it work.
USAGE
-----
To use Wapmess just point your wap-phone or wap-unit to:
http://[yourdomain and path to wapmess]/index.php?u=1234567&p=password (OR if you have made index.php the default start-page of your server, then you can skip the index.php in your URL (eg. http://mydomain.com/wapmess/index.php?u=1234567&p=password becomes http://mydomain.com/wapmess/?u=1234567&p=password)
where 1234567 should be replaced by your icq UIN
and password should be replaced by your icq password.
If you have a lot of contacts on your current UIN contactlist, we suggest you create a special icq-account that you have when wap-ing and that you only include your most important friends in this account.
When started it logs in to the icq-server, downloads your contactlist and presents you with a very simple wap-gui.
The usage is as simple as:
The wap-page refreshes each 10 seconds the first minute and then 15, 20, 30, 60 and so on.
If a user sends you a message wapmess will show you the message when the page has reloaded. You will se the time(date) when the msg has arrived, the message itself and a you have two options: if you do not want to answer the message, just select back and the message will be ignored. Any other waiting messages will now be shown.
If you want to answer, just fill the textbox and select Send reply. When the message has been sent you see the standard "empty screen" again, until a new message arrives.
wapmess will timeout when you have been unactive for aprox 6 minutes, which means that you will be logged out from the icq server. Just select reconnect to log in again. We will try to find a limit suitable for most users.
To handle(add/remove/edit) your contacts, we suggest you use icq, icq-lite or similiar at a standard computer. Wapmess is made with speed and ease at priority so we have no functionality for this in the wap-service.
TECHNIQUE
---------
How does Wapmess work?
Wapmess uses PHP as the main script-language and also uses CLI-php to run and control the server-part of Wapmess. CLI-php is Command Line Interface for PHP, read more about it at http://www.php.net
When the user logs on to the icq-server, first a login is made to the icq-server and when the reply comes, both the wap-script (main.php) and a background-process script (icqtalk.php) is started which works together and communicates with each other via the database. The wap-script(main.php) shows a simple wap 1.2 compatible wap-page that refreshes it-self in a regular basis. The server-background process(icqtalk.php) is the one keeping the connection to the icq-server open and as soon as it gets a new message from the icq-server it sends it to the wap-script and vice versa.
VERSION HISTORY
---------------
0.01a
First public release
TODO
----
Fix the bugs that are still bugging us.
Implement more comments in the code and translate the Swedish comments to English ones.
HELP NEEDED!
------------
As I dont have time or even the hardware and knowledge to make this system work on other systems than Win32-systems, I would like to get help to adapt this system so it can be used on all types of servers, where PHP and MySQL is available, eg. Linux, Unix, Free BSD, Mac etc.
If you think you can adapt this software-bundle to make it work on any system except for Win32 systems, contact us below!
CONTACT
-------
We want all the help with developing, bug-reports, tips etc. that we can get.
Please visit
http://sourceforge.net/projects/wapmess/
to download new versions or contribute to the project in any way you want.
/ Wapmess Crew