🌍
English
This shows you the differences between two versions of the page.
en:faq [2006/07/04 20:21] brian |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | 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: [[http://www.php.net/|{{fr:php-logo.gif}}]] and [[http://www.mysql.com/|{{fr:mysql.gif}}]] | ||
- | |||
- | ==== 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 [[http://www2.entropy.ch/download/Entropy-PHP-5.1.2-1.dmg|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 **Php**WebGallery, 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 {{http://demo.phpwebgallery.net/template/yoga/theme/category_children.png}} after selecting the physical category you want to add a virtual category under. | ||
- | |||
- | ===== | ||
- | |||
- | ===== Using remote sites ===== | ||
- | |||
- | ===== Mods and extensions ===== | ||
- | |||
- | ===== Things to avoid ===== |