🌍
English
Differences
This shows you the differences between two versions of the page.
|
en:faq [2011/04/19 15:45] plg removed |
— (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. | ||
| - | ====== FAQ ====== | ||
| - | |||
| - | FAQ stands for Frequently Asked Questions. | ||
| - | |||
| - | ===== Prior to installation ===== | ||
| - | |||
| - | I haven't yet installed PWG and I have many questions. I will find [[en:faq-before|here the answers]]. | ||
| - | |||
| - | ==== 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 MAc OS 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 unable 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.\\ | ||
| - | * It's not necessary 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 essential database in order to run 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 doesn't appear in the lists below and you know where to add it, please do so. | ||
| - | === ISP setups that don't allow PhpWebGallery to run 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 running of PhpWebGallery: === | ||
| - | |||
| - | * Free | ||
| - | * Club-Internet | ||
| - | * Wanadoo (supplemental package) | ||
| - | |||
| - | ===== Installation/Migration ===== | ||
| - | |||
| - | I have decided to install PWG, but it's the first time I will do that job. Where I'll find the [[en:faq-install|answers]] to all my questions. | ||
| - | |||
| - | ===== Initial configuration issues ===== | ||
| - | |||
| - | ==== How do I change the gallery title? ==== | ||
| - | |||
| - | Admin -> Configuration -> General | ||
| - | |||
| - | ==== How to maintain sub-categories folded in the menu?==== | ||
| - | |||
| - | Admin + Configuration + Default display\\ | ||
| - | Unfold all categories Yes / No | ||
| - | |||
| - | ===== 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). | ||
| - | * For one or a few numbers of pictures, it's possible, as a temporary solution. | ||
| - | * When working with a remote installation using FTP, it is usually more efficient to generate the thumbnails externally and then send tehm by FTP to the galleries/ directory. By default, thumbnails are given the original picture name prepended with "TN-". | ||
| - | * Only .jpg and .png thumbnail picture generation is currently supported by PWG. Other picture formats will require external thumbnail generation / conversion and eventually you have to rename thumbnails wich name doesn't start by TN- prefix. | ||
| - | |||
| - | On dedicated server (or on your own server), you must test if it supports thumbnail generation, because of its configuration (number of processors and external access). | ||
| - | |||
| - | ==== Parameters 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: | ||
| - | |||
| - | <code php><?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; | ||
| - | ? ></code> | ||
| - | |||
| - | FIXME: Link to en:Configuration | ||
| - | |||
| - | ===== Using remote sites ===== | ||
| - | |||
| - | Images total size is growing quickly and maybe your server does not support it. PhpWebGallery allows you to manage [[en:remote_site|remote sites]]. | ||
| - | |||
| - | ===== Mods and extensions ===== | ||
| - | |||
| - | ===== Things to avoid ===== | ||