webphotations Files

Webphotations

Mini-crowdsourcing for annotating photographs

Webphotations is a web application that allows a small group of people to work
together to annotate photographs.  The people can join a "group session" that
allows one person to choose which photograph everyone is looking at.  They
person can type a description of the photograph.  As the person types, the
other people in the session get the see what the user is typing.  You can use
Google Hangout or Skype to have a conference call with all the people and
work together to describe what is in the photo.  This software is great for
families that are spread out across the country that want to work together to
annotate photographs.

Bundled Software:

JSON/XML-RPC Server in PHP5 <http://code.google.com/p/json-xml-rpc/>
Javascript HTML Encoding library <http://www.strictly-software.com/htmlencode>
XHR Compat library
<http://blogs.msdn.com/xmlteam/archive/2006/10/23/using-the-right-version-of-msxml-in-internet-explorer.aspx>

Required PHP Modules:

	PDO/Sqlite	- for database
	gd		- for thumbnails and rotating images
	mhash		- For generating password hashes
	exif		- read exif information from jpeg files

Loading image was generated from:
http://preloaders.net/


Technical Details:

The webapp uses the Sqlite3 database.  The config.php file specifies the
location of the database file.  The Sqlite3 database was chosen because
it does not require any setup.  The database/schema gets created dynamically
during the first page hit.

Annotations and thumbnails are stored in the photo directories, right next
to the original photograph.  Annotations are stored as .txt files.

Installation:

Unpack.  Create a config.php file to specify the path to the database file,
and the path to the photographs.  The database file gets created dynamically
so the folder needs to be writable by the webserver.  The photo directory must
be writable as well.

<?php
global $CFG;

$CFG[ 'photo_folder' ] = "/path/to/pictures";
$CFG[ 'db_file' ] = "/path/to/database.db";
?>