﻿ 

    Copyright 2007 Antonio Cordasco

    This file is part of Anto Web Gallery.

    Anto Web Gallery is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    Anto Web Gallery is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with Anto Web Gallery; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA










---------------- Anto Web Gallery 1.3 GUIDE  (ENGLISH)------------------------------------------------------------------------------------------------------
Automatic web gallery developed with HTML, Javascript and PHP by Antonio Cordasco

This script is for free, the only thing i want is that you don't delete the links to my web pages.


REQUIREMENTS:
* A web space. The amount of space depends on the number and the size of the pictures you want to show.
* PHP language support. (MySql or any other database is not needed)


FEATURES:
* consecutive visualization of the preview images
* organization with image groups
* fullsize images
* support for AVI videos
* captions associated to the previews
* multilanguage support (English, Italian, Dutch, Estonian, Polish)
* automatic preview files generation
* generation of direct url's to the pictures


DESCRIPTION:
This is a light nice and easy to use Automatic Web Gallery. You can display a lot of images of every dimension.

INSTALLATION:
1. To install the gallery on your website you have to make a directory on your web space that will contain it (this directory will be the main directory).
You must place in this directory the 3 files: gallery_structure.php, fullsize_pic.php, gallery_functions.js and the structure.images directory with its content.
Then you have to create inside the main directory a subdirectory for every group of pictures that you want in your gallery.
The names of these subdirectories must be like: xx-name of the group.
xx is a number between 00 and 99. This number specifies the order of the groups and it will not be displayed in the gallery page.

Every group folder must have 2 subdirectories called: full, redu.
In the redu folder you will place the preview images. The better size for the preview images is 400x300 px.
In the full directory you will place the fullsize pictures or the videos and the txt files for the pictures captions.
DON'T PLACE THE SAME FILES IN THE REDU AND IN THE FULL FOLDERS. The files in the redu directory should be smaller than the fullsize files.

If you don't know how, or you don't want to waste a lot of time creating the preview files yourself, you can let the gallery generate them automatically.
In this case, create only the subdirectories "full" in the groups directories and set the permissions of the groups directories to 777 (writable).
The script will automatically create the "redu" subdirectories and place the small preview files inside, when you load the gallery page.



Additionally, you can place txt files in the full directories containing some text that you want to display togheter with some pictuers.
You have to place a file with the same name of the preview file but with txt extension in the full directory, the text in the file will be displayed.

Placing a picture only in the full folder has no sense because it will not be available.


Then you have to put a .php file in the main gallery directory that will be the index file. In this file you have to include inside the <body>
tags the gallery_structure.php file. 

example:     <? include "./gallery_structure.php";?>

Also you have to define a javascript string variable called: language inside the <head> tags,that will set the language of the gallery.
Actually the gallery has 4 languages: English, Dutch, Estonian, Polish and Italian  ("ita"=italian, "eng"=english, "dut"=dutch, "est"=estonian, "pol"=polish)

example:
<script type="text/javascript">
<!--
language = "eng";
// -->
</script>

That's all! If you did correctly all the steps your gallery should now work fine!

Every time that you want you can modify your gallery, you can add or delete groups, images, videos and txt captions.
If you have a little experience in JavaScript and HTML programming you can also easily change some properties of the gallery.
For example it's very easy to change the colors.


KNOWN LIMITATIONS:
The gallery actually have some little limitations.

The names of the files are case sensitive!!!
If you have a fullsize file with the same of the preview file but with different letter case that fullsize image will not be available.
This also for the video files and the .txt files
I counsel to give to all files low case names, also for the extensions.

The captions in the txt files should be short, because the space to display them is little.

The best size for the preview images is: 400x300 pixels, this because of the fixed dimension of the rectangle that will contain them.


WHAT'S NEW IN Anto Web Gallery 1.3:
- new look
- generation of direct url's to the pictures


-----------------------------------------------------------------------------------------------------------------------------------

If you need help for the installation, if you want to suggest me how to improve the gallery or also if you only want to say me Hello
don't esitate to contact me trough the contact form of My web page (www.joujou.org)

------------------------------------------------------------------------------------------------------------------------------------










---------------- Anto Web Gallery 1.3 GUIDA  (ITALIANO)------------------------------------------------------------------------------------------------------
Galleria automatica per il web sviluppata in HTML, Javascript e PHP da Antonio Cordasco

Questo script � gratuito, l'unica cosa che voglio � che tu non cancelli il collegamento alla mia pagina web.


REQUISITI:
* uno spazio web. La quantit� di spazio dipende dal numero e dalla dimensione delle immagini che desideri visualizzare.
* Supporto al linguaggio PHP. (MySql o altri database non sono richiesti)


FUNZIONI:
* Visualizzazione consecutiva delle immagini anteprima
* organizzazione per gruppi di immagini
* immagini a dimensioni reali
* supporto per video AVI
* didascalie associate alle anteprime
* supporto multilingua (Inglese, Italiano, Olandese, Estone, Polacco)
* generazione automatica dei file di anteprima
* generazione di url diretti alle immagini


DESCRIZIONE:
E' una Galleria automatica leggera, bella e facile da usare. Puoi visualizzare innumerevoli immagini di qualsiasi dimensione.


INSTALLZIONE:
1. Per installare la galleria sul tuo sito devi creare una directory nello spazio web che la conterr� (questa sar� la directory principale).
Inserisci in questa directory i 3 files: gallery_structure.php, fullsize_pic.php, gallery_functions.js e structure.images con tutto il suo contenuto.
Poi devi creare una sottodirectory per ognuno dei gruppi di immagini che desideri nella tua galleria.
I nomi delle sottodirectory devono essere del tipo: xx-nome del gruppo.
xx � un numero compreso tra 00 e 99. Questo numero specifica l'ordine dei gruppi e non sar� visualizzato nella pagina della galleria.

Ognuna delle directory dei gruppi deve avere due sottodirectory: full, redu.
Nella cartella redu inserirai le anteprime. La dimensione migliore per le anteprime � 400x300 px.
Nella cartella full inserirai le immagini a dimensione reale oppure i video e i file txt per le didascalie.


In aggiunta, puoi inserire dei file txt nella directory full contenente del testo (didascalia) che vuoi rendere visibile assieme ad alcune immagini.
Devi inserire un file con lo stesso nome dell'anteprima ma con estensione .xt nella cartella full, il testo nel file sar� visualizzato.

Inserire un'imagine solamente nella directory full non ha senso perch� essa non sar� visibile.


Dopo di che devi creare un file .php nella directory principale della galleria che sar� la pagina index. In questo file devi inserire dentro i tag <body>
il file gallery_structure.php. 

esempio:     <? include "./gallery_structure.php";?>

Devi anche definire una variabile javascript stringa chiamata: language dentro i tag <head>, al fine di impostare la lingua della galleria.
Attualmente la galleria ha due lingue 4: Inglese, Olandese, Estone, Polacco e Italiano ("ita"=italiano, "eng"=inglese, "dut"=olandese, "est"=estone, "pol"=polacco)

esempio:
<script type="text/javascript">
<!--
language = "eng";
// -->
</script>

E' tutto! Se hai eseguito correttamente tutte le operazioni la tua galleria dovrebbe funzionare correttamente!

Puoi modificare la tua galleria ogni volta che vuoi, puoi aggiungere o cancellare gruppi, immagini, video e didascalie.
Se hai un po' di esperienza nella programmazione JavaScript e HTML puoi anche facilmente cambiare alcune propriet� della galleria.
Per esempio � particolarmente facile cambiarne i colori.







LIMITAZIONI CONOSCIUTE:
Attualmente la galleria ha alcune piccole limitazioni.

I nomi dei file sono case sensitive!!!
Se hai un file fullsize con lo stesso nome del file anteprima ma con maiuscole e minuscole diverse quell'immagine fullsize non sar� visibile.
Questo vale anche per i video e i file .txt delle didascalie.
Io consiglio di usare sempre lettere minuscole nei nomi dei file, anche per le estensioni.

Le didascalie nei file txt devono essere corte perch� lo spazio in cui esse vengono visualizzate � piccolo.

La misura migliore per le immagini anteprima �: 400x300 pixel, questo perch� il rettangolo che le contiene ha dimensione fissa.

NOVIT� DELLA Anto Web Gallery 1.3:
- nuovo look
- generazione di url diretti alle immagini

-----------------------------------------------------------------------------------------------------------------------------------

Se hai bisogno di aiuto per l'installazione, se vuoi suggerirmi come migliorare la galleria o anche semplicemente se vuoi salutarmi
non esitare a contattarmi tramite il form di contatto sul mio sito (www.joujou.org)

------------------------------------------------------------------------------------------------------------------------------------




