OpenMicroBlogger -- Standards-based Microblog
Copyright (C) 2008 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, 31-Mar-2009
 admin, themes, intranet, tweetpass, search


REQUIREMENTS

   - PHP > 4.2
   - MySQL or PostgreSQL




INSTALLATION


///////////////////////
// set up your database
///////////////////////

edit the file: app/config/config.yml

  look for the database settings

     # database settings

      development:
        adapter: mysql        // 'mysql' or 'postgresql'
        database: microblog   // name of database
        username: jacques     // name of database user
        password: shhh        // password of database user
        host: localhost       // name or IP address of database server

  and find the email settings too
      
      email_from: root@localhost     // "From address" for email msgs from this service
      email_name: Notifier           // Name of email sender


////////////////////////////
// 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 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 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 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