<!--  Listimg pour SPIP - V. 3.2 26 septembre 2003 --> 
<!--  Auteur: robert.sebille(at)cassiopea.org --> 
<!--  Sous licence GNU/GPL http://www.gnu.org/copyleft/gpl.html --> 
|°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°|
|     *         Cassiopea - http://www.cassiopea.org              |
|  *    *  *    Pour un InTERREnet associatif, libre et équitable |
|            *  Une alternative pour vos services internet        |
|                                                                 |
 °°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°
Adresse de publication originale: http://support.cassiopea.org/spip/spip-tech.shtml#listimg


   ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   + Liste les images des dossiers /IMG/gif, /IMG/jpg et /IMG/png +
   ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Fonctionnalités:
- Affiche la liste des images du dossier IMG.
- ou les images elles-mêmes sous forme de pseudo-vignettes max. 200 x 200. (Ce sont des pseudo-vignettes, car aucune nouvelle image n'est créée, ce sont les images réelles qui sont téléchargées et réduites[*].)
- Les noms des images et/ou vignettes sont cliquables et ouvrent l'image pleine dans une nouvelle fenêtre.
- Affiche 1 à 50 items par page, à partir de l'item n°X, avec nom, taille réelle et poid de l'image.
- Affiche les images .jpg, .gif, .png ou les 3 ensembles.
- Tri par ordre alphabétique croissant ou décroissant des noms des images.
- Fournit le nombre et le poid total des images par catégorie (.jpg, .gif, .png ou tout).
- Squelette spip publique ou privé (= réservé aux administrateurs et rédacteurs du site).
- Squelette indépendant ou article.
- Multilingue.

[*] Attention donc au poid des images! C'est éventuellement le moment d'apprendre à optimiser ;-)
   -------------------------------------------------------------------------------------------

Usage: 

1) Comme squelette indépendant:
Vous avez besoin de créer un squelette spip php3 / html. Appelons les ici squelimg.php3 et squelimg.html pour les besoins de l'explication, mais vous pouvez bien entendu les appaler autrement.

Vous configurez le squelimg.php3 comme un un squelette php3 spip normal: $delai, $fond, etc.
Dans squelimg.html, vous copiez/collez le code php ci dessous à l'endroit ou vous voulez voir apparaitre les images.

-----------------------------------------------
---- DEBUT du code à copier / coller DEBUT ----
-----------------------------------------------

<!-- listimg DEBUT -->
<?php
/* Configuration de listimg-inc.php3 */
// Respectez bien la syntaxe: guillemets, point-virgule, etc et la casse (MAJ/min): "oUi" est différent de "oui", etc.
$i_url_site_spip = "#URL_SITE_SPIP";
$i_article = "";  // squelette article: = "#URL_ARTICLE" | squelette indépendant: = ""
// Le squelette doit être soit un article, soit indépendant (= pas rubrique, mot, auteur, etc.)

$i_prive = "oui";  // Page privée? = "oui" (defaut) | Page publique? = "non"
$i_infoconnect = "oui";  // Afficher nom, pesudo: "oui" (defaut)[1] | "non"
$i_lien_ecrire = "oui";  // Afficher le lien vers page login: "oui" (defaut)[1] | "non"
$i_lien_prive = "oui";  // Afficher le lien vers l'espace privé: "oui" (defaut) | "non"
$i_lien_public = "oui";  // Afficher le lien vers la page d'accueil: "oui" (defaut)[2] | "non"
$i_ligne = "oui";  // Afficher une ligne entre les images: "oui" (defaut) | "non"
$i_copyleft = "oui"; // Afficher "Listimgp pour SPIP - V. ...": "oui" (defaut)[3] | "non" 
$i_repimg = "oui"; // images du rép. IMG/: "oui" | "non" (ou absence du param.) 

$i_langue = "francais"; // Choix de la langue par défaut 
// La valeur de ce paramètre = la valeur de nomlangue dans le fichier listimg-lang/listimg-nomlangue-inc.php3

//-------
//[1] Auto-désactivation si la page est publique
//[2] Auto-désactivation si le squelette est un article
//[3] Sympa ;-), mais pas obligatoire
?>
<INCLURE(listimg-inc.php3)>
<!-- listimg FIN -->

-------------------------------------------
---- FIN du code à copier / coller FIN ----
-------------------------------------------

Vous configurez ensuite les paramètres suivant ce que vous désirez, en faisant bien attention, comme annoncé, à  bien respecter la syntaxe: guillemets, point-virgule, etc et la casse (MAJ/min): "oUi" est différent de "oui", etc.

Vous téléchargez ensuite squelimg.php3, listimg-login.php3 ET listimg-inc.php3 à la racine de votre site. Vous téléchargez également squelimg.html et listimg-login.html soit à la racine de votre site, soit dans votre dossier squelette suivant votre configuration Spip. Vous téléchargez enfin le répertoire listimg-lang et tous ses fichiers à la racine de votre site.

Les fichiers "squel-listimg.php3" et "squel-listimg.html" que vous avez téléchargé avec l'ensemble, sont des exemples d'un squelette indépendant php3 / html pour listimg. Vous pouvez d'ailleurs les utiliser comme tel, si vous voulez: ils sont "prêt à l'emploi" ;-)



2) Comme squelette article:
La démarche est presque identique.
- Vous n'avez pas besoin évidemment d'un nouveau squelette php3, puisque vous avez certainement déjà le squelette article.php3 à la racine de votre site. Mais vous devez créer un modèle article.html spécial, du type article-aa.html, ou article=bb.html (sinon, tous vos articles afficheront les images). Pour créer un modèle d'article spécial, reférrez-vous à la documentation Spip, "Une interface différente dans le même site", à la page: http://www.uzine.net/article877.html.

- Une fois cela fait, comme pour le squelette indépendant, vous copiez/collez le code php ci dessus à l'endroit ou vous voulez voir apparaitre les images dans l'article.

- Le dernier changement à faire: Vous devez modifier la valeur de la variable $i_article comme suit:

$i_article = "#URL_ARTICLE";  // squelette article: = "#URL_ARTICLE" | squelette indépendant: = ""

(Vous pouvez copier / coller la ligne ci-dessus à la place de son équivalent dans le code php, et c bon!).

   -------------------------------------------------------------------------------------------

Demo:
- Accès public dans un squelette article:
   http://test.cassiopea.org/spip/article.php3?id_article=21
- Accès privé dans un squelette indépendant:
   http://test.cassiopea.org/spip/listimg.php3

   -------------------------------------------------------------------------------------------

Note sur la version 3.2:
Le logiciel a été testé 
- dans Galeon 1.3.3 et Mozilla 1.3.1. 
- La plupart des fonctionnalités ont été testées: squelette indépendant et article, page privée et publique, affichage des images, choix de la langue, affichage et fonctionnement des liens vers l'espace privé et le site, etc.
Tous ces tests ont fonctionné correctement. La version est donc théoriquement stable. 

un nouveau paramètre de configuration est disponible:

$i_repimg = "oui"; // images du rép. IMG/: "oui" | "non" (ou absence du param.) 

"oui": Les images du répertoire IMG/ sont affichées (et donc les logos de rubriques, articles, etc.). La liste de choix des images dans le formulaire de gestion d'affichage propose les répertoires:
- IMG/Tout //Les images des répertoires IMG/, IMG/gif, IMG/jpg et IMG/png
- IMG/gif  //Les images du répertoire IMG/gif
- IMG/jpg  //Les images du répertoire IMG/jpg
- IMG/png  //Les images du répertoire IMG/png
- IMG/     //Les images du répertoire IMG/

"non" (ou absence du paramètre): Les images du répertoire IMG/ ne sont pas affichées (et donc pas les logos de rubriques, articles, etc.). La liste de choix des images dans le formulaire de gestion d'affichage propose les répertoires:
- IMG/Tout //Les images des répertoires IMG/gif, IMG/jpg et IMG/png
- IMG/gif  //Les images du répertoire IMG/gif
- IMG/jpg  //Les images du répertoire IMG/jpg
- IMG/png  //Les images du répertoire IMG/png
(Ceci est identique à la version 3.1. Si vous omettez ce paramètre dans votre configuration de listimg, le résultat sera équivalent à $i_repimg = "non";)
   -------------------------------------------------------------------------------------------

Feuille de style: 
- Listimg utilise les styles de spip table.spip, hr.spip, etc.
- Le formulaire utilise la classe .forml
- Le bouton du formulaire est de style .spip_bouton.
- Vous pouvez formater indépendamment les autres éléments particuliers du formulaire (listes déroulantes, cases à cocher), en définissant et en ajoutant dans votre feuille de style la classe suivante:

.forml input, select {

	... Vos définitions de style ...

}

(Attention, dans les versions Netscape < 5 et IE < 4, ou si javascript n'est pas activé, le bouton "Mettre à jour" sera également de la classe input imbriquée dans .forml input, select - ou sans classe du tout (Netscape 4.7))

   -------------------------------------------------------------------------------------------

A propos des langues:

Créer une nouvelle langue est relativement aisé. Les fichiers langues, sont obligatoirement dans le répertoire listimg-lang obligatoirement situé à la racine de votre site spip (là ou vous mettez vos squelettes .php3). Leur nom est obligatoirement listimg-nomlangue-inc.php3, par exemple listimg-francais-inc.php3. ATTENTION, la partie nomlangue du fichier ne peut pas comporter de caractères accentués, ni de ç, ù, etc. francais est écrit ici "francais" et non "français".

Exemple: Si vous êtes francophone, et que vous voulez créer un fichier en langue allemande, vous éditez listimg-francais-inc.php3, vous l'enrgistrez sous listimg-deutsch-inc.php3 dans le répertoire listimg-lang, et vous commencez la traduction en respectant bien les instructions de traduction citées dans le fichier langue. Vous sauvez le nouveau fichier et vous le téléchargez éventuellement dans le répertoire listimg-lang de votre site spip en ligne. La prise en compte de la nouvelle langue est automatique au prochain recalcul de la page.

Recommandations:
- Pensez si vous créez une nouvelle langue à la proposer à la communauté ?
- Pensez à traduire également les commentaires dans le fichier langue, ce sera certainement plus qu'utile.
- Mettez votre nom d'auteur (si vous le voulez).
- Par souci de cohérence, pensez enfin dans vos traductions à:
  * Employer si possible les même termes que ceux de l'aide en ligne de la version multilingue de Spip (à partir de 1.6). (Du moins si cette langue existe dans Spip, bien entendu ;-). Ainsi, par exemple, dans le fichier de langue anglaise livré avce la version, "rédacteur" est traduit "editor" (et non "writer" ou autre chose) et "espace privé" est traduit "private area" (et non "back office", toujours par exemple), parce qu'ils sont également traduits ainsi dans l'aide en ligne de spip 1.6.
  * Eviter les confusions. Ainsi, l'affichage des pseudo-vignettes dans le script, n'est pas appelée "Vignette" mais "image réduite" en français et "reduced image" en anglais, pour ne pas semer la confusion avec le système de vignette de Spip, appelé lui "vignette" en anglais et en français.

Langues existantes au 27/05/03: francais, english.

   -------------------------------------------------------------------------------------------

Voilà. En cas de problème, -> http://support.cassiopea.org/questions.shtml