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!