# $Id$
# Main page of 'My::Project::postget'
# Copyright (C) 2003-2005 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
# 
# 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; exactly version 2 of June 1991 is required
# 
# 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


package project::postget::Index;
require 5.6.0;	# at least 'use warnings;' but we need some 5.6.0+ modules anyway
our $VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
our $CVS_ID=q$Id$;
use strict;
use warnings;

use My::Web;
Wuse 'project::Lib';


our @ListItem=(
		"name"=>"postget",
		"platform"=>"web",
		"trivia"=>1,
		"priority"=>380,
#		"download"=>'http://git.jankratochvil.net/?p=nethome.git;a=blob_plain;hb=HEAD;f=WWW/cgi-bin/postget.php',
		"download"=>"postget.php",
		"summary"=>sub {
				return "Bookmark ".a_href('http://www.w3.org/TR/html4/interact/forms.html#h-17.13.1','POST')
						.' forms, hide passwords';
				},
		"license"=>"PD",
		"maintenance"=>"ready",
		"language"=>"PHP",
		"description"=>sub { return <<"HERE"; },
<p>You cannot bookmark pre-filled forms to your browser bookmarks. Although
browsers support storing of form data you still have to load the form page and
click its submit button. This script will allow you to:</p>
<ul>
	<li>Store all @{[ a_href 'http://www.w3.org/TR/html4/interact/forms.html#h-17.13.1','POST' ]}ed
			form data as @{[ a_href 'http://www.w3.org/TR/html4/interact/forms.html#h-17.13.1','GET' ]} data
			(after '<b>?</b>' URL delimiter).</li>
	<li>Replace all sensitive passwords by indirect references to your <b>priv</b> directory
			to allow you to make your bookmark file itself public.</li>
</ul>
HERE
		);

sub handler
{
project::Lib->init();


print <<"HERE";

<ul>
	<li>
		<p>Store the
				@{[ a_href "postget.php",'downloaded file' ]}
		as <b>/home/lace/WWW/cgi-bin/postget.php</b>.</p>
	</li>
	<li>
		<p>Edit path to your <b>priv</b> directory in the stored
		<b>@{[ a_href "postget.php",'postget.php' ]}</b>.</p>
	</li>
	<li>
		<p>Bookmark the following @{[ a_href 'http://freshmeat.net/','Freshmeat' ]} URL:
				@{[ escapeHTML(q{http://localhost/~lace/cgi-bin/postget.php?_postget=http%3A%2F%2Ffreshmeat.net%2Flogin%2F&url=%2F&username=YOUR_USERNAME&password=_priv_postget.freshmeat.net.pwd&persistent=1}) ]}
		</p>
		<p>(Replace <b>YOUR_USERNAME</b> with your @{[ a_href 'http://freshmeat.net/','Freshmeat' ]}
		account name.</p>
	</li>
	<li>
		<p>Store your @{[ a_href 'http://freshmeat.net/','Freshmeat' ]} account password
		to: <b>~/priv/postget.freshmeat.net.pwd</b></p>
		<p>Protect it by '<i>chgrp nobody postget.freshmeat.net.pwd</i>' and
		'<i>chmod 640 postget.freshmeat.net.pwd</i>' (it is not secure as long as
		someone else can supply pages served by the same
		@{[ a_href 'http://httpd.apache.org/','Apache webserver' ]}.</p>
	</li>
</ul>

HERE


exit;
}
1;