INSTALL

plog v0.7

Intro

plog is a perl-based pictures gallery (or photoblog like do you want) with support
to on-fly thumbs, image editor embedded, categories, users, and misc options like
browse view, JScript's slideshow and chronology view.

Remember, if you need any technical detail about installations, update, or use, not
doubt to ask us, we gonna help you as soon we can, ours email in footnote.

Requirements
	- Web Server with support to CGI Perl (like Apache with mod_perl)
	- Image::Magick, DBI::mysql, Net::SSLeay, HTTP::Request, MIME::Base64,
		Digest::MD5, Net::POP3 and Net::SMTP::SSL Packages
		(could requiere another packages that "must to be already" or dependecies)
	- MySQL Server (a valid user with a db owner)
	- SMTP Server (a valid user if your SMTP requiere Auth)
	- POP3 Server (if you want to use mobile module)
	NOTE: You can test your package, try to run 'packagetest.pl' if you get
	an error about @INC, you must to install that package.

Install Step-by-step
NOTE: If you update from 0.5 or 0.6 to 0.7 please read down (Update Step-by-step).

1 - EXTRACT AND SET PERMISSIONS
	After download the compress file extract the content to your target folder.
	You must need to set permissions to all perl scripts to 755 (chmod 755 *.pl),
	this for be executed.

2 - SET CONFIG
	Open 'config.pl', to configure the next vars:

		# --- General
		$plogname = "Plog";  			  <-- Set your plog name desired
		$theme = "default";  			  <-- Set your CSS file
		$version = "0.7";    			  <-- The version to display
		# --- Users
		$admin = "admin";	 			  <-- Set your admin user
		$adminemail = "piggy@hailstan.com";<-- Set admin email
		$uploadanonymous = "true"; 		  <-- Allow anonymous users upload pictures
		$anonymoustag = "guest";		  <-- Set the tag for anonymous pictures
		# --- GUI
		$navlayout = "right";			  <-- Layout for NavBar: right | left
		$maxpic = 6;		 			  <-- Set max pics on plog
		$listpic = "none";				  <-- Set listpic value: none | list | select
		$detailbar = "random";			  <-- Set detailbar mode: none | nav | random
		# --- Web
		$fspath = "/usr/local/www"; 	  <-- Set your Filesystem path
		$urlpath = "http://localhost";    <-- Set your Web path without the last slash
		$domain = "localhost";			  <-- Set your domain
		$cookiename = "cookiemonster";	  <-- Set your cookie name
		@allowedext=("jpeg","jpg","png"); <-- Set your allowed pictures formats
		# --- DB
		$dbhost = "localhost";			  <-- MySQL Server
		$dbname = "plogdb";  			  <-- MySQL Database name
		$dbusr = "admin";				  <-- MySQL User
		$dbpwd = "admin";  				  <-- MySQL Password
		$mysqlversion = "5";			  <-- MySQL Server Version
		# --- SMTP
		$smtpserver = "localhost";		  <-- SMTP Server
		$smtpauth = "true";				  <-- SMTP Auth
		$smtpusr = "admin";		 		  <-- SMTP Webmaster User
		$smtppwd = "admin";		          <-- SMTP Webmaster Password
		$smtpmail = "admin\@localhost";	  <-- SMTP Webmaster e-mail
		# --- Notifications
		$notifications = "false";		  <-- Set e-mail notifications, require SMTP
		$notificationmail = "someone\@localhost";<-- Email for notifications
		# --- Mobile
		$mobile = "true";				  <-- Set mobile module, more details below
		$mobilecatid = 1;				  <-- Set mobile categorie id
		$popserver = "localhost";		  <-- POP3 Server
		$popusr = "admin";				  <-- POP3 User
		$poppwd = "admin";				  <-- POP3 Password
		# --- Gravatar
		$gravatar = "true";				  <-- Enable gravatar system, details below
		$defaultpic = "$urlpath/face.gif";<-- Set default picture URL
		$sizepic = 30;					  <-- Set Avatar size
		# --- Language
		$lang = "en";					  <-- Set plog default language, see note below

3 - INSTALL SCRIPT
	Open your web browser, and go to http://<yourserver>/<youplog>/install.pl
	This gonna created your tables, add admin user and created the photos dir.

4 - BROWSE YOUR PLOG
	Now go to 'mein.pl' in your plog, if you can see a page (not a error) now go
	to your admin ('admin.pl') to add pictures and categories. So get fun.

Update Step-by-step

1 - REPLACE FILES
	You must to replace all files, if you like backup 'config.pl' you will need
	to set again your configuration. Don't forget change permissions again.

2 - SET AGAIN CONFIG
	Now set your settings into the new 'config.pl'. You can refer the new options
	in the install section.

3 - RUN UPDATE SCRIPT
	Open your browser to http://<yourserver>/<youplog>/update5.pl if you plog 
	is 0.5 or http://<yourserver>/<youplog>/update6.pl if your plog is version 
	0.6. The script gonna make some changes to your tables.

4 - BROWSE YOUR PLOG v0.7
	Check that all work, all the thumbs was deleted in the update proc. Check
	CHANGELOG for more information about changes.
	

About mobile module

This version introduce a new concept in plog, the possibility to publish a
picture with you mobile phone, the idea behind is easy.

1 - Took a picture with your mobile phone with camera, or similar.
2 - Sent this picture like attachment to your POP3 plog account.
3 - A little proc, that will run sometimes (random time) in your plog, will 
	check the POP3 account for new messages.
4 - If it found a new email, it will check it for images attachments, this 
	gonna be published and the email deleted.
5 - Now your picture is published, and you can shoot wherever you want, and
	without PC you gonna put your new pictues. So nice not?

NOTE: You can test your mobile module, send some mails to your plog mailbox
then try to run 'mobiletest.pl', if you can read the subjets of your emails,
you are in.

About language support

About the language support, currently is experimental, but right now some tags
can be displayed in English or Spanish, we hope soon improved all the GUI, and
add others language like French and German.

The files from language are switched with the global var $lang into config.pl,
you can play with this variable to try. The version 0.8 gonna introduced all
the needed tags.

About Gravatar support

Gravatar [ http://www.gravatar.com/ ] is a open avatar system cross site, that
allow have one unique avatar across the inet, just register your email, and
everywhere that you post something if it's gravatar enable, your avatar
gonna be displayed.

If you enable Gravatar support, register your admin email into Gravatar.

By hxxbin (hxxbin@gmail.com) and iunk (iunk@iunk.org) 2005