To install PHPix2, you must have the following:

o	make (I like GNU Make)
o	a C compiler (I like GNU CC)
o	The "convert" program from ImageMagick (version 4.2.0 or newer)
o	A web server set up to run files with a ".php" extension through
 	PHP


I've tried to make this as simple as PHPix-1.0.  Please let me know if you
have any comments or suggestions.


There are three install methods:

*  Secure (suid)
*  Unsecure (non-suid)
*  FTP-only (manual)

You should start with the first one, if you can, and if that doesn't
work, try the next one.  Since the first two methods require a shell
account, some people might no other option than the manual install.

-----------------------------------------------------
-- Secure (suid) Install:

The default installation installs an suid shell script wrapper, so
you don't have to make publically-writeable directories.  The
benefits of doing this are debatable, but I still haven't had enough
complaints yet to warrant making non-suid the default.

Here's how to install suid:

1.	Log in as the user who will own these files (don't log in as
        root!)
2.	Untar phpix-x.x.tar.gz somewhere in your web tree, with a
	command like this: "zcat phpix-2.0.1.tar.gz | tar xvf -"
3.	cd to the new diriectory, and type "make suid"
4.	Load up the "phpix" directory (or whatever you renamed it
	to) in a web browser!
5.	Subscribe to the phpix2-announce mailing list by going to
        http://lists.sourceforge.net/mailman/listinfo/phpix2-announce
	This is a low-volume list that will keep you up to date about
	new releases and bug fixes.

Note that you no longer need to chown or chmod the albums directory, and
in fact doing so would defeat the whole purpose of doing an suid
install.


-----------------------------------------------------
-- Unsecure (non-suid) Install:

If for some reason the suid install doesn't work, you can try a
non-suid install.  This will make your cache directory wide open to
anyone with access to the machine; anyone with an account can do
pretty much whatever they want to within your cache directory.  That
includes overwriting thumbnails with pictures of goats, overwriting
image descriptions with rude letters to the president, placing
full-length movies in hidden areas, and other much more nefarious
things.


Here's how to install non-suid:

1.	Log in as the user who will own these files (root is okay)
2.	Untar phpix-x.x.tar.gz somewhere in your web tree, with a
	command like this: "zcat phpix-2.0.1.tar.gz | tar xvf -".  If
	you've already untarred, do a "make clean" in the directory.
3.	cd to the new diriectory, and type "make nosuid"
4.	Load up the "phpix" directory (or whatever you renamed it
	to) in a web browser!
5.	Subscribe to the phpix2-announce mailing list by going to
        http://lists.sourceforge.net/mailman/listinfo/phpix2-announce
	This is a low-volume list that will keep you up to date about
	new releases and bug fixes.


----------------------------------------------------
-- FTP-only (manual) Install:

Some people don't have access to a shell account.  Fear not!  You
can still run PHPix2, although it will not be suid.  See the
previous section for the dangers of this.

Here's how to install ftp-only:

1.	Untar phpix-x.x.tar.gz somewhere on your local machine.  In
	Unix, use a command like this: "zcat phpix-2.0.1.tar.gz | tar
	xvf -".  In Windows, use a program like Power Archiver to
	get at the files.
	
2.      Rename all the files that begin with "dfl_" to the same
	filename without the "dfl_".  (eg. "dfl_config.inc" gets
	renamed to "config.inc")
	
3.	Edit the newly-renamed "config.inc" file to change the
	"./convert" program to "./convert.sh".  This is the line
	starting with "$convert".
	
4.	Upload the whole ball of goo into a new folder in your web
	space, making sure the "cache" directory, and every
	directory underneath it, has world-write permissions.  The 
	way to do this depends on your FTP program.  You want to
	have the file mode "777" or "drwxrwxrwx".


----------------------------------------------------
CONFIGURATION

There are two files you may be interested in:

config.inc
	This contains some run-time settings.  PHPix2 should work out of
	the box for most people, but if you have special needs, or you
	just like to twiddle with things, check this file out.

style.css
	The style sheet that's used for all PHPix2 output.  The style
	sheet that comes with the distribution makes it sort of look
	like google (http://www.google.com/) but you could use this to
	change all manner of color, border sizes, etc.  If you come up
	with a good one, email it to me and I'll include it in the next
	distribution.


----------------------------------------------------
STUCK?  NEED HELP?


PHPix has its own page on sourceforge: http://phpix2.sourceforge.net/.
There you will find all kinds of neat PHPix2 paraphernalia, including a
help forum which I read and respond to regularly (sorry, no coffee mugs
yet).

There may be more info in the README.

If you need additional help, go to the phpix2 page
(http://phpix2.sourceforge.net/) and check out the lists.

If you find a bug, you can file it at that same page.

If you have suggestions about anything at all, don't hesitate to
mail phpix2-devel@lists.sourceforge.net.  We want to make PHPix2
better, and your suggestions help a lot!
