This is an old revision of the document!


FIXME This FAQ is a work-in-progress. Visitors are invited and encouraged to add to this content; it is highly likely that you have worked through a problem someone else is currently wrestling with. The Table of Contents will automagically update with any new sections you add.

PhpWebGallery (PWG) Frequently Asked Questions (FAQ)

Prior to installation

What do I need to know?

The PhpWebGallery Development Team (DT) answer is:

  • You're not alone using PWG.
  • Currently, close to 40,000 downloads were made last year.

Obviously that hasn't resulted in as many new sites rather, some people have downloaded successive new versions of PhpWebGallery and some people, owing to incompatible web-server set ups on some free ISPs, have not been able install PWG correctly.

What do I need?

DT:

  • A web-server with support for Php and MySQL.

External links to official sites: and

Which Servers can I use?

Preferably an Apache server running on Linux.
IIS on a Windows 2000 sever works fine as well.

Mac OSX works also!

  • For 10.3.x users, the version of PHP shipped with the O/S is NOT enabled for gd2, which means you will not be able to generate thumbnails (and probably not be able to do other things as well). A binary PHP5 package for 10.3.9 is available here.
  • If you end up with a blank page while attempting to generate thumbnails for the first time, you probably don't have a gd-enabled PHP installation. See above.

To give an idea of your space requirements:

  • 100 High res images (corresponding to your images) ~75Mb.
  • 200 800x600px images and thumbnails ~15/20 Mb.
  • You dont just have to have the gallery on your site (what capacity!).
  • Videos?

PhP (the elephant): is “the” language behind PhpWebGallery, don't forget this. MySQL: is the database essential for running PhpWebGallery.

If you require more space than is available… less important data can be transfered to a “distant site”, that is to say, a second server containing less frequently accessed data.

If your ISP doesnt appear in the lists below and you know where to add it, please do so.

ISP setups that dont allow PhpWebGallery to function correctly:

  • Wanadoo (basic package)
  • US/UK ISP or any Hosts/Providers are obviously invited to complete list hereunder :) or above :(

ISP setups that allow correct functioning of PhpWebGallery:

  • Free
  • Club-Internet
  • Wanadoo (supplemental package)

Installation/Migration

Initial configuration issues

How do I change the gallery title?

Admin → Configuration → General

FIXME

Comment ne pas développer les sous-categories dans le menu?

Admin + Configuration + Affichage par défaut Développer toutes les catégories Oui / Non

Database issues

Where are the database parameters stored?

In the file include/mysql.inc.php. However, if you are asking this question, you probably have not yet gone through the installation process, and your mysql.inc.php is most likely an empty file.

Thumbnails

Reasons to avoid automatic thumbnail generation

  • Thumbnail quality may be an issue, especially with large original images.
  • There is no control of the compression ratio and/or image quality.
  • Generation of a large number of thumbnails will monopolize CPU time.
  • The PHP script maximum execution time default of 30 seconds will prevent the generation of a large number of thumbnails (but see below for a workaround if your installation is local).
  • When working with a remote installation using FTP, it is usually more efficient to generate the thumbnails externally and then FTP them to the galleries/ directory. By default, thumbnails are given the original image name prepended with “TN-”.
  • Only .jpg and .png thumbnail image generation is currently supported by PWG. Other image formats will require external thumbnail generation.

Reasons to use automatic thumbnail generation

  • You run PWG on a local machine, without access to the outside world. In this case, it would be safe to edit the 'max_execution_time' parameter in php.ini to a high value, such as 1000. Depending on the speed of your machine, this would allow for the generation of 300-600 thumbnails on average before the script “times out.” If that happens, simply click the “Thumbnail” link, select “All” for “Number of thumbnails to generate,” then submit.

Implementing categories

For detailed instructions, log in to your PWG installation and navigate to

Admin → General → Instructions

Physical categories

Physical categories (analagous to “albums”) must be created directly in the filesystem under the install_dir/galleries directory. There are a couple of ways to accomplish this:

  • If you have local access to the machine hosting PWG, simply create a subdirectory under the galleries directory. The name you give this subdirectory will be the name that is displayed in PWG. On *nix systems, this subdirectory MUST be writable by the user under which the web server is running.
  • Create the subdirectory locally, then upload using a suitable FTP client. Again, make sure the newly-created subdirectory is writable by the web server.
  • Directory names can contain ONLY alphanumeric characters, ”-”, “_”, or ”.” characters. Please, no whitespace or accented characters!

Virtual categories

While the creation of virtual categories is straightforward, associating elements with categories is somewhat more involved.

  • Creation of virtual categories is accomplished via the Admin menu:

Admin → Categories → Manage

  • Top-level virtual categories can be created in the Manage screen. These will display alongside top-level physical categories.
  • If you want to create virtual categories within a physical category, you must select the “Manage subcategories” icon (FIXME) after selecting the physical category you want to add a virtual category under.
  • To associate elements (images) with virtual catgories, you must select the virtual category, then the “Manage category elements” icon (FIXME). There are two modes to choose from:
    • Global mode: Allows the selection of images “in bulk” to associate with a virtual category. Any keywords or metadata added in this page is applied to all of the selected elements (remember, images themselves are not copied to the virtual category; links to the images are stored in the database).
    • Unit mode: Allows for the editing of keywords and other metadata for each individual element to be associated with the virtual category.

Controlling image upload parameters

How do I increase the upload image size limits?

Modify /include/config_local.inc.php as appropriate:

<?php    
 
//+-----------------------------------------------------------------------+
// |                            remote loading                             |
//+-----------------------------------------------------------------------+
 
//One speaks here about the remote loading by HTTP
//accessible optionnellement to
//users.
 
//upload_maxfilesize: maximum weight of the images
//to be downloaded, in kilo
//bytes.
$conf['upload_maxfilesize'] = 400;  
//upload_maxheight: maximum height of the images 
//to be downloaded, in pixels.
$conf['upload_maxheight'] = 800;  
//upload_maxwidth: maximum 
//width of the images to be downloaded, in pixels.
$conf['upload_maxwidth'] = 800;  
//upload_maxheight_thumbnail: maximum height of 
//the miniatures.
$conf['upload_maxheight_thumbnail'] = 128;  
//upload_maxwidth_thumbnail: 
//maximum width of the miniatures.
$conf['upload_maxwidth_thumbnail'] = 128;  
? >

FIXME: Link to en:Configuration

Using remote sites

Mods and extensions

Things to avoid

 
Back to top
en/faq.1152045475.txt.gz · Last modified: 2009/03/07 22:13 (external edit)
 
 
github twitter newsletter Donate Piwigo.org © 2002-2024 · Contact