OpenMicroBlogger -- Standards-based Microblog
Copyright (C) 2009 Brian Hendrickson

This application is free software; you can redistribute it and/or
modify it under the terms of the MIT License.

This application is distributed in the hope that it will be useful,
but without any warranty; without even the implied warranty of
merchantability or fitness for a particular purpose.

Author
 Brian Hendrickson - http://brianhendrickson.com

Version 0.1, 1-Sep-2008
 initial release

Version 0.2, 22-Oct-2008
 sms, app store
 
Version 0.3, 10-May-2009
 admin, themes, intranet, tweetpass, search


REQUIREMENTS

   - PHP > 4.2
   - MySQL or PostgreSQL




INSTALLATION


/////////////////////
// 7 steps to install
/////////////////////

1. obtain OpenMicroBlogger http://dbscript.net/omb.zip

2. make a folder on your desktop and unzip the files in it

3. use a ftp-client to copy the unziped files to your webserver folder

4. open your Web browser and run
      yourdomain.com/install.php

5. Follow the installation instructions

6. If installation succeeded, open your Web browser and browse to the installation folder

7. set in app/config/config.yml your 

      site_title: Your Site Title
      site_subtitle: Your Site Subtitle
      site_description: Your Site Description

 [[ that is it! ]]




///////////////////////////////////////
// (optional) choose a file upload mode
///////////////////////////////////////

1) upload as SQL BLOBs (default)
      
      maximum upload size is 5MB or so, not that great for big MP3s, but maximizes privacy
      
      you must set the /cache folder permissions so the Flash uploader can put files there

2) upload as SQL BLOBs (WITH CACHING)

      first set up your /cache folder as described in option 1
      
      then, edit app/config/config.yml

   look for

      collection_cache:
      - posts:
        duration : 0        // and change this 0 to the number of seconds to cache
        location : cache

3) upload FILES to /uploads (do not create BLOBs)

      set permissions on the /cache and /uploads folders
      
      next, edit app/config/config.yml
   
   look for
   
      collection_cache:
      - posts:
        duration : 0
        location : cache    // and change 'cache' to 'uploads'

4) upload FILES to Amazon S3 (do not create BLOBs)

      set permissions on the /cache folder
      
      then, edit app/config/config.yml
   
   look for
   
      collection_cache:
      - posts:
        duration : 0
        location : cache    // and change 'cache' to 'aws'

   look for

      awsAccessKey:         // and put your AWS login info here
      awsSecretKey: 
      awsBucket: 




//////////////////
// use pretty URLs
//////////////////

Prety URL Requirements:
  - root site only (yes -> me.com/ no -> me.com/subfolder/)
  - two options to address mod_rewrite urlencode() bug
    1. replace "urlencode(" with "urlencode(urlencode(" yuck
    2. enable "AllowEncodedSlashes On" in VirtualHost (Apache > 2.0.46)
      todo: add a test for this problem

To enable pretty URLs:

1) uncomment lines 65 & 66 in /db/boot.php

2) type your own base URL in /db/boot.php

3) copy the file /resource/prettyurls/.htaccess to the top level folder

4) set "RewriteEngine on" in .htaccess

5) type your own base URL in .htaccess




UPDATING

/////////////////////////////
// use the /wp-content folder
/////////////////////////////

If you want to customize OpenMicroBlogger with your own theme and plugins:
  
1) copy /app/config/config.yml to /wp-content/config

2) duplicate a theme in /wp-content/themes

3) optionally, add plugins to /wp-content/plugins

    note: plugins in this folder override same-name plugins in /app/plugins




///////////////////////////
// get the latest build
///////////////////////////

you can grab the almost-nightly build from http://dbscript.net/omb.zip