logo phpwebgallery
"simplement puissant"
Dernière version:
1.7.2 - 24 juillet 2008
PhpWebGallery
 Documentation

QUICK START GUIDE for new users

Your are a new user of PhpWebGallery, or a “newbie”, both wanted only to put your photos on the web with the best program : PhpWebGallery.

Here you will find a simple and effective procedure, without blah blah (...).

Note : if you already use PWG (PhpWebGallery), don’t miss upgrade procedure, or reinstall all your PWG.

Installation

Version 1.7

There are some specific tutorials for 1.6. You can find them here:

Method below is functionnal, but more generic to these versions.

Version 1.6

There are some specific tutorials for 1.6. You can find them here:

Method below is functional, but more generic to these versions.

Versions 1.4 and 1.5

  • Download the pack (archive) corresponding to the last version in Downloads

section, release directory and select the most recent release.

http://download.gna.org/phpwebgallery/release/

  • Once the pack is stored on your hard disk, unzip it
  • Put the phpwebgallery directory at the root of your site (you can rename it as you want)
  • Send this unzip directory to your web site, if this is a remote one.
  • Generally, you will tranfer it with your FTP client.
  • Once all files are sent to your web server, open your Web browser
  • In the address bar, write the following address:

http://www.mysite.com/phpwebgallery/

  • (with your owned parameters, for instance

http://toto.free.fr/phpwebgallery/)

  • You will be directed on the setup page (install.php)
  • Enter information about your database and administrator profile
  • Follow the link for connecting with your administrator profile
  • On your Web server, by FTP, delete install.php file, as it would be indicated

That’s all ! Welcome in your PhpWebGallery !

First photos on the Web

Now, you wish to put on it your photos. Here is the solution.

  • Manipulate your photos with a software (like phpMyVignettes) in order to have your photos with a certain resolution, accompanied by their corresponding thumbnails. These thumbnail’s filenames MUST be preceded by the prefix TN-. For instance, other/thumbnail/TN-wedding.jpg is the associated thumbnail to the photo other/wedding.jpg.
  • Begin by creating a sub-directory (or sub-folder) which will represent the store place and the future category’s name. This sub-directory MUST be put in the galleries directory of phpwebgallery on your Web server (\phpwebgallery\galleries\)
  • For instance you will have: \phpwebgallery\galleries\cats\

Of course, you can also create all the directories (or folders) in local, then upload all of them on your Web server

  • In this directory “\cats” create a sub-directory \thumbnail
  • For example: \phpwebgallery\galleries\cats\thumbnail
  • Optionnaly, if you wish to view your photos with the original definition, create another sub-directory \pwg_high
  • For example : \phpwebgallery\galleries\cats\pwg_high
  • Now you will store your photos:

\phpwebgallery\galleries\cats\ ← viewed photos (ex 800×600)

\phpwebgallery\galleries\cats\thumbnail ← thumbnails (ex 150×110)

\phpwebgallery\galleries\cats\pwg_high ← true resolution photos (ex 1600×1200)

Viewed and true(or high) resolution photos MUST have the SAME name (ex kittie.jpg).

Thumbnails photos MUST have the SAME name preceded by PREFIX TN- (ex TN-kittie.jpg)

Warning : the filename’s extension of the different photos format MUST be exactly the SAME : for example kittie.JPEG will be bound to TN-kittie.JPEG, and NOT to TN-kittie.jpeg (which be bound to kittie.jpeg) ; Verify this point when you’ll use a photos manipulation software.

  • If you have worked on local, upload all your directory \cats and sub-directories on your Web server
  • Go again on your PhpWebGallery and connect as administrator (or Webmaster).
  • Click on the link “Administration” (at the bottom) of the navigation bar
  • In “General” menu’s tab (at the top of the navigation bar), click on the link “Synchronize”
  • Notch “Categories and files” box and let the box “Simulate” notched for the moment (NOTHING all is notched !)
  • Click on the “Validate” button

You will have to see informations on the page. If no errors are signaled:

  • Strip the box “Simulate” (”Categories and files” must ALWAYS be notched)
  • Click on “Validate” button

That’s all. In the menu’s “Links” tab, click on the “Home” link and go to admire your cats photos. !!!

If you’ll not wish to see some photos, delete all the files concerned (thumbnails, pwd_high and so on...) with eventually client FTP, and strip “Simulate only” before synchronize, because if not there will be a synchronization error.

Photos Préparation

Tips

Synchronization errors

Most of synchronization errors came from a bad photo’s filename. Don’t put any accent, nor & or blank space. Use instead underscore and dash.

bad good
mémémeme
moi mêmemoi-meme
papa&mamanpapa_maman
miaou le chatmiaou_le_chat

French Free provider [[free.fr]]

For those who have a Web site on “Free” servers, you can automatically install PhpWebGallery. Just connect to your admin interface on the “Free” Web site and click on : “Manage my account toto@free.fr”. Enter user login and password, click on the red button to validate. In the tab “Manage your personal pages”, click on “Activate modules for your personal pages (blog, forum, wiki, sondage...etc)”. Notch the module Phpwebgallery and click on the Submit red button. You must wait about one hour.

But “Free” sometimes is generating errors and the used version is somehow old. You’ll better off to choose your own installation.

Installation by Free (Version 1.6.2 since january 2007):

Description : Galleries photo.
Login: admin, pass : your_Free_password
Default directory : phpwebgallery
Tables prefix : phpwebgallery_

Note: if your Web site is designed for French visitors, think of changing the description “Galleries” (in english) for something like “Galerie de photos” (one “L” only in French ;-)).

 
en/quick_user_guide_and_for_new_users.txt · Dernière modification: 2008.05.16 00:21 par vdigital
 
Driven by DokuWiki - RSS notification feed