captcha-addon, version 0.4 beta 04-08-2006

changed stuff at bottom of file

based Connie's Anti-Comment-Spam-Addon, version 1.0.1 May 2005 

addon tries to prevent spam by using so called captchas 
(graphical numbers in this case)

please notice that this is a very basic version of the addon which
still needs heavy testing. local test runs were good so far.. 
real world will show

-------------------------------------------------------------------------
Pixelpost www: http://www.pixelpost.org/

tested with:
- pixelpost 1.5 final


Copyright (c) 2006 sentinel
blog@digitalview.at

License: http://www.gnu.org/copyleft/gpl.html

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program 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.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

---------------------------------------------------------------------------
delivery
---------------------------------------------------------------------------
readme.txt
index.php
includes/captcha.php
includes/anti_comment_spam.php
langauge/lang-english.php
language/lang-german.php
patch04.diff

---------------------------------------------------------------------------
installation
---------------------------------------------------------------------------

I.) 	extract the zip (.. you might not be able to read this file if not 
			already done ;)
			
II.) 	put captcha.php and anti_comment_spam.php into your includes/ folder 
			make sure they're readable by the webserver
			
III.) replace the language files for german and englisch with the ones in 
			this package.	'cause i just (more or less) know those two languages 
			i can not add more on my own. if you know swedish or swahili, mail 
			updated language files to me and i'll add 'em to the package.
			thx in advance.
			
			$wrong_captcha_title  		just the headline of the browser window 
																if the entry is incorrect
			$wrong_captcha_body   		the message if the entry is wrong
			$captcha_insert_message		the text next to the input field
			
IV) 	replace the original index.php with the index.php delivered within 
			this package. if you've shell access to your server (or maybe just 
			want to take a look at the changes) you might also want to use the 
			.diff file.
			(usage: put diff file into folder containing the index.php use 
			"patch -p0 < patch04.diff" to update the file).
			PLEASE REMEMBER THIS ADDON WONT WORK WHEN A NEW VERSION IS INSTALLED
			PLEASE CHECK THE REQUIRED VERSION (1.5 final 2006-08-04)
			
V.)		add the  <CAPTCHA> tag below the email-form-line in your image or 
			comments template (depends where your comments-form is)

VI.)	if you're satisfied with the standard look (white background, black 
			font, yellow lines) go to next step. otherwise you can now customize 
			the look of the captcha via variables in pixelpost.php. 
			
			there are three variables available for changing the color of the 
			background ($captcha_bgcolor), the font ($captcha_fontcolor)	and 
			the lines ($captcha_linecolor).	all three variable use RGB colors and
			look like  
			
			$var = "red,green,blue";
			
			the standard theme is like:
			
			$captcha_bgcolor="255,255,255"; #white
			$captcha_linecolor="255,204,0"; #yellow
			$captcha_fontcolor="0,0,0";			#black
			
			it's not necessary to add all three varialbe to the config. if you 
			just want to changes the color of the font just add 
			$captcha_fontcolor and the rest will stay the same.

VII.) test if the captcha and the input-field shows up in your comment 
			section

VIII.)	please test and give feedback

-------------------------------------------------------------------------
notes
-------------------------------------------------------------------------
his hack does _not_ show up in the admin section because atm it's not a 
real addon but more a hack.
unless workspaces are available to user side of pp in future releases 
a real plugin without modifications to index.php isn't possible. 



-------------------------------------------------------------------------
updates
-------------------------------------------------------------------------
#06-04-08 release of beta 0.1 as a real addon to pp 1.5 beta
#06-04-11 release of beta 0.2 as a hack to pp 1.5 beta
 fixes: - bots seem to POST stuff direclty to x=save_comment 
	  so the addon is senseless
	  now audit takes place directly in this codepart

 diffs: - move anti_comment_spam.php to includes and remove the 
	  save_comments part of index.php. now it only includes
	  the audit function
	- insert necessary code for tag replacement and audit-function-
	  call into index.php
	- remove <CAPTCHA_FORM> tag because stuff is added directly into
	  the org. save_comments function in index.php

#06-04-22 release of beta 0.3 as a hack to pp 1.5 rc1
	-	no code changes on the add-on itself, just ported into index.php
		of version rc1 

#06-08-05 release of v0.4 as a hack to pp 1.5 final
	- porting hack into new index.php of pp1.5 final
	- adding language support (files for german and englisch included)
	- adding "changeable-colors feature" to the captcha via additional lines 
		in pixelpost.php. you can now change the colors of the captcha so it 
		better fits into your template
		
	