HomeUtilitiesphpviewFAQ
en | fr
FAQ
(Frequently asked questions)
Lots of usefull infos behing this question/answers presentation
What is phpview ?
-----------------

Phpview is a php frontend to display conveniently a directory tree full of
photos.

It currently only support jpeg display.

phpview is a fairly young software that provides already enough for my needs
and is working well. But it can't be considered mature software. It must
be much more tested in different situation to gain stability.

Why do people want to use phpview ?
-----------------------------------

People often want to share via web pages their photos. Professional shots,
familly album, your last holiday's photos, or your collection of tolkien's
related arts... You've got the pictures, but don't have the time nor the
desire to create, AND update a HTML web site. PHPview manage dynamically your
HTML frontend, and take care of huge work of creating thumbnails, resizing
pictures without any configuration (except the installation part).

You'll need to have a linux-like http/php server with ImageMagick installed,
and rights to compile a binary, and a http/php server.

What can phpview do ?
---------------------

Phpview will handle in an efficient way your picture gallery, by :
- creating thumbnails on demand.
- creating lower resolution pictures on the fly (= quicker to download).
- generating optional comments, stats, using easy file format.
- displaying gallery in a customizable fashion.
- subdirectories are shown as sub-galleries.
- displaying additionals comments you'll have written easily.

The main idea when phpview was written is that it only need to know
where is your picture's directory. You do not need to copy pictures and
maintain additionnal directories full of picture.

How phpview work ?
------------------

Phpview uses a special caching filesystem, which handles files by their
md5 checksum. This ensure that a thumbnail or a resized version of a
picture isn't produced twice even if picture is renamed of moved across
the gallery directory structure.

Phpview use ImageMagick C++ library and the command line "convert" from
ImageMagick to generate thumbnail and resized pictures which ensures
maximum speed for these operations.

HTML output uses CSS massively to ensure a customizable display. While this
doesn't give you all latitude, it is quite open.

What are the Requirement for phpview to work ?
----------------------------------------------

Well, Phpview was only tested on Linux/Apache/Php with ImageMagick. It should
work with any UNIX like systems with a http server supporting PHP, and a
fresh install of ImageMagick package.

PHP must have GD built in (--with-gd). (well, this requirement is worked out
from phpview in 0.0.3+ ... but it may be some code relying on it... if yes
mail me please !). So YOU SHOULDN'T NEED lib GD anymore in your PHP install, if
you are using phpview version 0.0.3 or higher.

The requirement for ImageMagick could be removed in next versions...
This will normally make phpview work with only a http server and PHP install.

If you have succeeded installing phpview, please let me know to update these
documentations.

YOU'LL REQUIRE AUTOMAKE, AUTOCONF, AUTOTOOLS the most recent version. Otherwise it'll fail to install !! (well it fails on my Ubuntu dapper)

How do I contribute ?
---------------------

You can download the latest-package code and begin coding. Please send me your
modifications so I can merge them to the official code.
Phpview source code is on a subversion server which isn't publicly available
for now.

How do I install this package ?
-------------------------------

There are 2 phases : install the source. And configure a gallery.

You must install the source before configuring any gallery.

Note : You can configure as many galleries as you want once you've installed
the source.

Ok, so How do I install sources ?
---------------------------------

Download the source package. The file name should end with "tar.gz" or
"tar.bz2".

Unarchive the package accordingly to extension.

Then in package directory :

# ./configure --with-tmp-web=/home/robert/www/tmp/phpview \
--with-tmp-web-url=/~robert/tmp/phpview

Note : In version 0.0.2, you MUST specify the two options --with-tmp-web AND
--with-tmp-path. It'll autoconfigure and set up directories for you.

Note : You might want to add a --prefix=/path/to/pkg to install files
in "/path/to/pkg". Or whatever "--option" you want (See INSTALL for more
info on 'configure' script)

then type :

# make

This will compile the C library, and generate php files.
Once this is done, you can run :

# make install

This will install files in proper directory. Set default values in
configuration files, and set up file permissions.

Note : you need to have write permissions to where you wanted to install
the sources. (location to install sources is changed with '--prefix' while
in configure stage : see INSTALL for more information on GNU installation
process).

Ok, and now that I've installed the source,
How do I configure a gallery ?
------------------------------

You must copy some starting files in a browsable directory. By "browsable", we
mean that this directory must be accessible via a browser. You might have
to look at your http server config to know were is your web directory.

You must choose a location within the browsable directory to copy the starting
files. You might want to create a fresh directory.

Where are the starting files ? the default files are located in
"/usr/local/share/phpview/samples" (or "${prefix}/share/phpview/sample"
if you have installed the package with the '--prefix' options)

You must copy *ALL* the files located in this directory to your web browsable
directory of your choice. So you could use for example :

# mkdir -p /home/robert/www/photos
# cp /usr/local/share/phpview/samples/* /home/robert/www/photos

Once this is done, you can edit "config.inc" which is with the file you've
juste copied in. Read description of options in the file. This is php code,
so don't write anywhere, it should be straitforward to edit without messing
with the code.

Once 'config.inc' is edited accordingly to your needs. Phpview should be
accessible via the web, with the URL that correspond to the directory where
you have copied the files.

If you have any problem installing this software, please mail to
<vaab@free.fr>. I can help you, and I need to know what's going wrong for you,
to correct in next versions.

Just in case, where are the important config files ?
----------------------------------------------------

There's only 2 config files. The gallery one is the "config.inc" that you
can edit as you wish except for the "$sysconf" value.

In fact the "$sysconf" value shows the location of the second configuration
file. Normally located in "${prefix}/share/phpview/sysconf.inc". This file
has wider purpose, and mainly contains locations of the cache directory,
the temporary web directory (to store thumbnail pictures, or resized pictures
you might want to access via your web browser).

If you feel confident enough, or you think your problem as a solution in this
configuration file, you can edit it. But be aware that informations holded
in it are computed at "make install" time, and should be correct.

Okay, all works fine, how do I comment my photos ?
--------------------------------------------------

Phpview can show cool informations with your photo and you can edit comments
for galleries and photos.

As you don't want to touch anymore weird config files, phpview implement a
simple way to comment your gallerie and your photos. All you have to do
is to create a file with the same name as the photo you want to add comment,
but with the ".txt" postfix.

You can create this file with any text editor (this support DOS/Win32 and UNIX
text files). Be aware that :

1. The first line is the new title of the picture
2. The second line is a date for the picture
3+ The remaining lines are the description lines.

Leave blank line if you do not want to edit one or the other field.

For galleries, same idea. The text file is located IN the directory. And is
named "desc.nfo".

1. The first line is the new title of the gallery
2. The second line is a Date for the gallery
3. Third is the location (as dir/to/file.jpg) to a photo that will be used
to make the gallery thumbnail. Gallery thumbnail are seen in parent gallery.
4+ The remaining lines are the description lines.


Aargs, thumbs are not displayed !?
----------------------------------

If no thumb at all is displayed, then you might have a problem : PHP complains
about it's error in the image code, and scrambles it. Most browser won't
display such an image.

If PHP complains about an error, this mean something is wrong, and to see what
try this :

# wget <URL-of-thumb>

with <URL-of-thumb> the URL you get when viewing one image at a time. It can
be like this :

http://www.tharbad.ath.cx/~vaab/demo/phpview/?gallery=Alsace&img=P6081352.JPG&res=low

simply append to this URL the string : "&action=thumb" to get the
<URL-of-thumb> : This is exactly how thumbs are called in phpview.

If you type this location in a browser, it might complain about the fact that
the image is not correct or contains error (as i explained), this is why I
use "wget" : once saved, you can :

# cat <FILE-outputed>

to see the error.

If you have problem, send me a mail !
Contact meKalysto -- Personnal Work Web site - Copyright © 2007  LAB  Valentinmirrors :  chez.com | free.fr | kalysto.org