

flf histotag for Coppermine - version 0.9

requires COPPERMINE version 1.5.2 (tell me, if it works with older versions)

==============================================================================================================
brickware - released free of charge
==============================================================================================================
This plugin is released free of charge under the Attribution-Noncommercial-Share Alike 3.0 Unported License.
I coded this plugin, because I had fun doing it, not because I want to make money out of it.
However, writing good code is a time consuming effort that limits the time you can 
spend with your loved ones. I share the work, because I believe it can be of good use 
to others so that they can spend an afternoon with their partners or kids instead
of writing something similar themselves.

I'm not asking for something in return. But if you do like this plugin and want to 
appreciate a little bit of the time I put into it, my son would be happy if you could add
to his LEGO(tm) collection. So I call this plugin "brickware" - send him some of your used 
(but preferably still usable!) LEGO(tm) parts, modules, anything. A single brick will do just 
the same as the big Millenium Falcon in mint condition ;-).
So if you have some unused LEGO(tm) bricks (parts from the LEGO(tm) space collection preferrably) 
that you want to give freely in appreciation for the use of this plugin, please send them with regular mail to:

	Florian Lechner
	29589255
	Packstation 103
	D-85057 Ingolstadt
	Germany

Leave your email-address and I'll send you a thank-you picture of your bricks in action.
==============================================================================================================
Credits
==============================================================================================================
- This plugin for Coppermine was inspired and is in part based upon "easyMap for Pixelpost" by http://maximee.de
- To display the map, lytebox is used. Lytebox is (c) by http://www.dolem.com/lytebox/
- Credits to Doug Pillow for the geodata conversion algorithm http://www.weberdev.com/get_example-3548.html
- Credits to eenemeenemuu for his fav_button Plugin that showed me how to add buttons to the navbar
- The function to generate the histograms was adapted from the Pixelpost addon by Kevin Crafts http://blog.kevincrafts.com/
==============================================================================================================
Installation & Configuration
==============================================================================================================
Install plugin with COPPERMINE Plugin Manager.
Edit /plugins/plugins/flf_histotag/include/plugins/flf_histotag_configuration.php before first running the tool!

You need to have your own GOOGLE MAP API KEY before you can use this map. If you don't yet have one, get yours
free at http://code.google.com/apis/maps/ 
and enter it into the appropriate variable. ('apikey')

All other options should be self explanatory.

								 
								 
==============================================================================================================
What it does
=============================================================================================================
The Plugin serves two purposes:
 - provide Geotag support for Coppermine
 - provide histogram suppport for Coppermine
 
Geotag support:
Upon installation a new table is generated into the coppermine schema. This table holds all the EXIF data from 
images it can find. Right now, I'm extracting more data than I use for the geotagging feature. I don't know,
yet what to do with them in the future ;-)
The EXIF-Data are pulled from images upon upload. If you want to generate the EXIFs from all the existing
images in your database, a special function is nested inside the Plugin-Manager page.
Upon displaying of an image, it is checked, whether Geotag-Data is inside the plugin's table. If the 
required Geodata exists, an icon is displayed that can be clicked to open the location in a 
Google Maps view. If no Geodata is available, you can choose to hide the image or display an image without
a link.

Histogram support
If activated a histogram is created upon upload of an image. The settings are fully configurable. 
All histograms are stored in a directory call "histograms" and have a filename 
	hist_<coppermine_id><original filename>.jpg
If you want to generate histograms for all the images inside your database, i provided a function in the
plugin manager page. However, since Timeouts of your webserver may occur, this function is not 
very reliable. I'll have to think of something better in the future. To compensate this, you can
activate an option to generate the histograms upon displaying of an image. Downside: First visitor
to your image takes longer to show the image, Upside: No unnecessary histograms included.
This feature will be tweaked some more in future versions.


==============================================================================================================
Things on my To-Do-List
==============================================================================================================
- currently you can only use the histogram feature if you also use the geobutton feature
- Supply standalone script to generate all histograms on disk (avoid Timeout)
- give user the chance to change tablename
- supply pure text file for initial sql configuration (not in plugins/install.inc.php)
- generate histograms on the fly only when clicking the "show histogram" button (currently created, when no
  histogram is found upon loading)

==============================================================================================================

 2010 Florian Lechner - http://lounge-lizard.org/cms

flf histotag by http://lounge-lizard.org is licensed under a Attribution-Noncommercial-Share Alike 3.0 Unported License.
visit http://creativecommons.org/licenses/by-nc-nd/3.0/ for more details.