mms2web.com

Mobile multimedia presence now !	mms2web.com
home \| services \| registration \| how to use \| download \| demo \| contact \| browse members \|

Detailed instructions for mms2web.com

See also MMS transfer process overview

Hosting MMS files at mms2web.com

Register a USERNAME and then send MMS (Multimedia Message) with your mobile phone to e-mail address: USERNAME@mms2web.com. View all your received messages (MMS Gallery) at URL: http://host.mms2web.com/USERNAME

You will need to have MMS service activated as part of your mobile subscription. Note that mobile prepaid services may or may not include this service. Please, contact your mobile operator helpdesk for further information.

Received MMS messages are hosted at mms2web.com secure webserver. Back-ups of the messages are done daily. You can send all types of files to your MMS gallery including images, sounds, videos and text. Minimum filesize is 10k and maximum 500k. GIF image transfer is inactivated by default as mobile operators usually add their own GIF images (ie logos) to the MMS messages. This setup can be changed in the user profile.

You can format the MMS�Gallery HTML code at the HOST OPTIONs when logged in to the member's area.

You may also embed the hosted gallery into your webpages with a PHP or ASP scripts that are provided in the download section.

Account profile information, account upgrade and transfer log

For the first 30 days each customer has full file transfer functionalities to transfer the MMS files to customer's own webserver. After this trial period the account will be automaticly converted to "Free Hosted MMS Gallery" service. To continue with the full file transfer functionalities the account needs to be upgraded to Premium or Professional account.

To configure the file transfer login to member's area and enter your FTP server (domain)�and login information or HTTP POST data transfer password at the "Change Profile" page.

After making changes make a test file transfer by pressing the button
"test file transfer". Make sure you have given write access at your web server
for the folder where the files are being transferred.

"MMS log" page displays all the MMS files that are being transferred via
mms2web.com mmsgateway. Last column will display the status of the transfer.

Setting up MMS Gallery on your Linux web server with PHP and Apache

Prerequisites for customer's web server

Required versions of web servers and other softwares are:
- Apache web server 1.3.7
- PHP v4.3.0
- Graphics library GD2.0

If HTTP POST data transfer method is chosen then PHP needs to be able to run
the XML expat library. This is enabled by default on Apache version 1.3.7 or
later. The PHP scripts have not been tested on a windows environment running
Apache and PHP.

Configuring MMS Gallery for the web server

Extract the files in the "mms_gallery.zip" file to your local PC.
Edit the file "mms_settings.inc" in the "mms_template"-folder.

Enter the full web server path to folder where the MMS files are transferred
from the mms2web.com. For example, if you have chosen to use anonymous FTP
account to receive the MMS files:
$mms_dir="/home/yourfolder/public_ftp/inbound";

If your FTP account (for example: mmsimages@yourdomain.com) saves files
directly to a folder at your web root then password protect this folder
with basic HTTP authentication (so that no-one can execute saved files).
For example: $mms_dir="/home/yourfolder/public_html/mmsimages";
Change the user rights for this folder to have read, write and execute
rights (see below).

If you have chosen to use HTTP POST data transfer then create a new folder
on your web server and enter the path of this new folder to the $mms_dir
variable. for example: $mms_dir="/home/yourfolder/mmsimages";
For security reasons it is recommended to create this folder off the web
root.

In your web server control panel or with linux shell command
(for example: chmod a=rwx /home/yourfolder/mmsimages) change the
user rights to your MMS folder to have read, write and execute rights
(0777). This is needed by the MMS Gallery to be able to save the
transferred MMS images and create thumbnail images. However, with HTTP POST
file transfer you have full control over which files are saved to
your server. You can edit the file "mms_receive.php" and remove the file
types that you do not want to be saved to your MMS Gallery (see below for
descriptions of the PHP files).

With HTTP POST file transfer you can define a password that is checked
during the file transfer. This will prevent outsiders to save files to your
web server MMS Gallery. Enter your password at the $http_password-variable
at the "mms_settings.php"-file. This same password will need to be entered
also at your profile information at mms2web.com members area. For example
the default value is: $http_password='changethis';

Saving PHP files to web server

Transfer all the contents including the subfolder of the "MMS_Gallery.zip"
file to your web root. Usually the web root is the "public_html"-folder.

Your web root will then have 2 files and subfolder "mms_templates" several
more files.

Files on the root:
mms_gallery.php
mms_receive.php

Files on the subfolder:
mms_template/get_file.php
mms_template/get_image.php
mms_template/get_image_nail.php
mms_template/mms_lib.php
mms_template/mms_settings.inc
mms_template/.... etc ...

Your MMS gallery can then be accessed at your web server address,
for example: HTTP://WWW.YOURDOMAIN.COM/MMS_GALLERY.PHP

Configuring email forwarding for MMS Gallery

If you want to receive the MMS files to an email address on your domain, there needs to be an email forward from your web (or email) server to the mmsgateway@mms2web.com and your registered mms2web.com account needs to be same as your email domain name. The forwarded email address needs to have your domain name in the address header or else the
gateway will not be able to know from which customer's domain name the mails are coming.

Recommended email address for forwarding is, for example:
mms@yourdomain.com where yourdomain.com is your registered account name.

Visitors of your web site will then send MMS messages from their mobile
phones to this email address mms@yourdomain.com and then these messages are
forwarded to mmsgateway@mms2web.com.

In your web server control panel create a forward for email address
mms@yourdomain.com to email address mmsgateway@mms2web.com.

You can also create forward by saving a file named ".forward" to your
/home/yourfolder-directory. This file needs to have a single row of text:
mmsgateway@mms2web.com

Then your email address yourfolder@yourdomain.com will be forwarded to the
mmsgateway@mms2web.com. Then your web site visitors would send
MMS messages to address yourfolder@yourdomain.com.

You do not need to create a real mailbox for the forwarded address.
The forward assigment will forward the mail even when there is no real
mailbox available.

Receiving MMS files from mms2web.com

You can choose between standard FTP file transfer or HTTP POST data transfer.
The method of transfer can be chosen in the customer's profile information.
If you change the file transfer method make sure to update the
FTP/HTTP password field in your profile information.

FTP file transfer:

Login to mms2web.com member's area and configure your FTP account details in
your "change profile" page. You need to specify your FTP server (domain), account and
FTP password.

Test that the FTP file transfer works to your web server by pressing the
"Test File Transfer" button.

The file types that qualify for transfer are image (jpg, gif, png, etc),
text (txt, imy), video (3gp, etc) and audio (amr, mid, etc). See complete
listing of all the allowed file types at the "mms_receive.php" file function
"file_check()".

Your FTP server needs to be of format ftp.yourdomain.com where
yourdomain.com is your internet domain name at mms2web.com.
The files are saved to the root of the destination folder that your
connecting FTP account has write access. You can change the destination
folder in your account profile.

Depending of your account service level the FTP file transfer will occur
either immediately upon MMS arrival to our mmsgateway or in every 10 minutes.
If your web server is down the file transfer will be tried again soon as
the gateway receives another MMS for your account.

HTTP POST data transfer:

HTTP POST file transfer is done vie HTTP POST request where the data is
included in the body of the HTTP POST request. The data is in XML format.
The XML format is created by standard XML-RPC interface. However, you will
not need to have XML-RPC installed on your web server.

The HTTP POST data is received at your web server by the file
"mms_receive.php". This file must be located on your web root. The file is
requested at path: http://www.yourdomain.com/mms_receive.php

The XML file contains three elements: HTTP password, Filename, and Filedata.
HTTP password is defined by you in the "mms_settings.php" file and
also in your profile at mms2web.com. The Filename is automaticly created by
the MMS gateway at mms2web.com and it contains important information about
the MMS (id, date, phone number, etc). The Filedata is base64 decoded raw
binary data of the MMS file content.

"mms_receive.php"-file saves the received MMS files to a path defined in
the "mms_template/mms_settings.inc" $mms_dir-variable.

Test that the HTTP POST data transfer works to your web server by pressing
the "Test File Transfer" button.

Depending of your account service level the HTTP POST data transfer will
occur either immediately upon MMS arrival to our mmsgateway or in every 10
minutes. If your web server is down the file transfer will be tried again
soon as the gateway receives another MMS for your account.

MMS Gallery functionalities

Description of the transfer process

MMS message consists of several dependent files. MMS message can contain
text, audio, video or sound files. MMS message sometimes also contains a
file called SMIL. This file explains the mobile phone's MMS browser how the
separate MMS files are sequenced when displayd to user.

When mobile phone user sends a MMS message from his mobile phone to your
email address (for example: mms@yourdomain.com) the mobile operator's MMS
center will convert the MMS message to email format. This email has all the
separate image, audio, video and text files attached from the original MMS
message.

Your web site forwards this MMS email to our mmsgateway email address and
our gateway will separate the email attachments and transfer them
individually back to your web site. Then "MMS_Gallery.php" file will display
the MMS message files saved on your web server. The MMS files are grouped
again to form a single MMS message entity.

MMS gateway will not transfer the SMIL file or any other application files.
Executable application files are not transferred because of security issues.

Testing and trouble shooting

Test the file transfer in your mms2web.com member's area "change profile"
page. This test will check that all the configurations are done correctly
and it will save a test file to your web server. This test file can be
deleted.

Make sure that you have the correct version of PHP and Apache installed on
the web server. Some functions used in the MMS gallery require these
versions.

Make sure that you have granted full read, write and execute access rights
for the MMS destination folder. Otherwise the thumbnails will not be written
to the gallery.