---------------------------------------------------
MMSLIB - By Stefan Hellkvist (http://hellkvist.org)
---------------------------------------------------

What is this?
-------------

Mmslib is a PHP library for encoding and decoding MMS:es. MMS is short
for Multimedia Messaging Service. In short it is the successor of SMS
(Short Message Service) with the enhancements that you can not only
send text but basically any content type your phone can handle such as
images, text, videos, ring signals and audio clips. 

With this library you can create messages and add multimedia parts
such as JPEG, GIF, AMR, MIDI and so on. The library also contains a
limited MMS sending functionality that uses a HTTP service to send
SMS:es. You would probably have to change the actual implementation of
the SMS sending to fit your way of sending SMS:es (if it is over
serial port, to a real SMSC or through some other type of HTTP
service).

Take a look in my other projects MMS Diary and Peffisaur (both at
http://hellkvist.org/software/ ) to see examples of what you can do
with this library. 


Where can I find the latest release?
------------------------------------

The latest release of this library will most likely be located on
http://hellkvist.org/software/ and most likely indexed by
http://freshmeat.net 


What license is this released under?
------------------------------------

The license is GPL - see file COPYING


What does this package contain?
-------------------------------

This package contains code for encoding MMS:es as well as sending them
using a simple notification scheme. The following files are contained:

* mmslib.php - the main code which contains three useful classes, the
MMSEncoder class, the MMSDecoder class and the MMSNotifyer class. 
MMSEncoder is used for encoding the message, MMSDecoder for decoding 
and the MMSNotifyer for sending out the SMS by using the SMS interface 
over HTTP

* samples/encode.php - contains sample code that shows how to use the
MMSEncoder class to encode messages of various content types

* samples/decode.php - contains sample code that shows how to decode
a message and extract its content

* samples/send.php - contains sample code that shows how to send out a
notification to a phone of an MMS stored at a certain URL

* README - this file

* content/ - contains sample content of various content types for use
with the sample code in the samples directory


Any known limitations?
----------------------

Yes, both for decoding and encoding there are limitations in how the
content-type header is handled (because it is a bloody messy part to
understand in the documentation I have only implemented what I needed
for my applications - feel free to make it more complete though). Only
simple support exists currently. What this means in practice for
instance is that you won't be able to extract a filename for an
attached file when decoding and you won't be able to send MMS:es of
type multipart/related where you can have a SMIL-part referencing the
other parts in the message.

UPDATE: In version 0.97 some encoding code for SMIL was added by Jakub
Haton. This has not been tested by me (Stefan) but feel free to try it
out. If it breaks anything you can always roll back to version 0.96.


Have fun!

Regards,
Stefan Hellkvist, http://hellkvist.org