WordPress MultiUser
-------------------

This INSTALL-WPMU file is only pertinent for WordPress MU (MultiUser) installations.
The thinking behind the MU commpatibility mode is that the account information
(access code and password) are hardcoded and are not editable by the WPMU blog's
owner.  The blog owner just has to enter their PIN code and the rest is dealt with
automagically.


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

PhoneBlogz is a system that allows you to leave a voice message by phone to be posted
to your Wordpress blog.  When a message is left, a page is requested on your
Wordpress site that tells it to check phoneblogz.com for new messages.
If any new messages are found, they are posted to your blog.


Requirements
------------

This plugin will only work under Wordpress 2.0 or greater under Linux.  
It hasn't been tested on Windows and WILL NOT work with Wordpress 1.5 or earlier.
You'll need to register at http://www.phoneblogz.com to get an access code and PIN number


Setup steps
-----------

There are several things you'll need to setup for the system to work:

1) Register and configure an account at http://www.phoneblogz.com
   - go to http://www.phoneblogz.com and register for an account
   - make note of your access code and PIN number you receive via e-mail

2) Modify .htaccess to allow access to the checkmessages.php page
   - edit your .htaccess file in the root of your MU installation and add
     the following line under the #### blogs section:

RewriteRule ^([_0-9a-zA-Z-]+)/wp-content/plugins/(.*)           /wp-inst/wp-content/plugins/$2 [L]


2) Install the code and configure your Wordpress site
   - unzip the .tar.gz file and move the entire phoneblogz directory to wp-inst/wp-content/plugins
   - under the main site admin user, go to Site Admin -> Options and enable the Plugins menu (checkbox at bottom of pag)
   - modify phoneblogz-config.php, changing the $WPMUMODE variable to "true" and entering
     your access code and account password (NOT PIN code!!)

3) Instruct each blog admin to setup PhoneBlogz:
   - login as the blog admin
   - go to Plugins and activate PhoneBlogz
   - under Plugins -> PhoneBlogz Configuration, enter your PIN code and click Submit Changes.

3) Using the system
   - call a PhoneBlogz access number (http://www.phoneblogz.com/help/howcanipost.php)
     or your dedicatged number if you've purchased on
   - enter your access code and PIN number if necessary, then leave a message and press #
   - PhoneBlogz should then call your checkmessages.php page which should
     post the message to your blog if you selected to publish your message after you recorded it


Known problems
--------------

If you're not running virtual hosts (ie your blogs are at http://www.domain.com/fredsblog instead
of http://fredsblog.domain.com), the MP3 files will not be found in the blogs.  This is because of a
bug in the .htaccess file - to fix just change the second RewriteRule line to:

RewriteRule ^([_0-9a-zA-Z-]+)/files/(.*)                        /wp-inst/wp-content/blogs.php?file=$2 [L]



Troubleshooting
---------------

If messages aren't appearing on your blog, check the following things:

1) On phoneblogz.com, make sure your message appears in the "Recent Blogz" page.
   If the message isn't there, contact us as something has gone wrong!

2) In the PhoneBlogz configuration page in wp-admin, click "Check for messages".
   You should see your message in a list.  If it's not there check the access
     and PIN codes.

3) In a browser, go to the URL you entered in the Notification URL area.
   If the URL can't be found you're using the wrong notification URL.

4) check that you have a wp-content/uploads directory and that it is writable by
   the linux user that your web server is running under (eg apache or nobody)

5) If you're still having problems visit the forums (http://www.phoneblogz.com/forums)
   or get in touch with me - matt@phoneblogz.com


Contact
-------

Feel free to get in touch with me about this plugin or any aspect of PhoneBlogz
by e-mail at matt@phoneblogz.com or on the forums at http://www.phoneblogz.com/forums