******************************************************************** * KDPics * * v 1.16 * * * * David DUQUENOY * * * * * ******************************************************************** Sommaire I. Copyright II. Qu'est-ce que KDPics ? III. Matériel/Logiciel nécessaire IV. Installation/mise à jour de KDPics V. Documentation VI. Téléchargement VII. Contact VIII. Versions IX. ToDo I. Copyright Le logiciel Web de présentation de photos KDPics appartient à la licence GNU GPL (). Le texte est donc en anglais : KDPics, logiciel web de présentation de photos Copyright (c) 2003-2006 David DUQUENOY This program 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. This program 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 this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA II. Qu'est-ce que KDPics ? KDPics est un logiciel Web de présentation de photos. Largement inspiré de PPM pour la partie présentation (la partie administration est complètement originale), il a été développé au départ lors d'un TP avec un groupe de stagiaires (TIDMI). KDPics génére automatiquement des galeries de miniatures et permet de gérer les commentaires. Il possède trois niveaux : - Catégories - Galeries - Photos Donc les photos sont rangées dans des galeries, elles-mêmes classées par catégories. Les catégories peuvent être protégées par mot de passe depuis l'interface d'administration. Cette interface d'administration permet : la gestion des commentaires, les droits sur les catégories, la création/suppression de galeries et catégories, l'ajout de photos soit par fichier image (jpeg, gif et png) soit par fichier zip (extrait toutes les photos d'un fichier zip dans la galerie sélectionnée) et de nombreuses options définies en général, par catégorie, par galerie ou par photo. KDPics est multilangue. Il est construit en CSS, vous pouvez donc créer facilement votre propre thème (présentation et icones). Accès à la galerie : http://nomduserveur/repertoire_de/la_galerie/ Accès à l'administration : http://nomduserveur/repertoire_de/la_galerie/admin/ KDPics utilise les librairies PclZip pour l'extraction des fichiers zip, Htpasswd pour la gestion des comptes utilisateurs Apache, HTML.mime.mail pour l'envoi des mails et Exifer pour la lecture des informations JPEG sans la version PHP nécessaire. III. Matériel/Logiciel nécessaire Un serveur Web (Apache pour profiter de la protection des catégories, dans ce cas, il est nécessaire d'activer la gestion des fichiers .htaccess). PHP3 ou plus. L'extension PHP zlib pour profiter de l'ajout de photos par fichier zip (facultatif). L'extension PHP GD pour la miniaturisation des photos. PAS de serveur de base de données. IV. Installation/mise à jour de KDPics Installation (voir plutôt sur le site web pour une installation détaillée par système) : - Copier le contenu de l'archive dans un répertoire du serveur Web. - Donner si besoin les droits en écriture au répertoire qui accueille les photos (photos par défaut) au dossier appfiles, ainsi qu'au fichier .htpasswd (qui peut se trouver dans admin/htpasswd). - Accéder à l'interface d'administration (comme décrit plus haut), menu Options pour la configuration. - Si le serveur Web supporte cette fonctionnalité (.htaccess), bien indiquer le chemin du fichier .htpasswd (.htpasswd doit contenir au minimum un utilisateur nommé admin, et devrait se trouver de préférence dans un répertoire en dehors de l'arborescence Web ou dans un répertoire lui même protégé par .htaccess). - Dans Utilisateurs, changer le mot de passe de l' utilisateur 'admin' - Activer également la protection .htaccess de l'interface d'administration par la section Droits, en cliquant tout simplement sur Valider dans la partie Interface d'administration. - De nouveau dans Options (à ce moment là le login et le mot de passe sont demandés : admin et le mot de passe renseigné précédemment), Options générales, 'Afficher les menus d'administration aux utilisateurs autres qu'admin' : Non. Mise à jour : - Remplacer tous les fichiers A L'EXCEPTION DE : - le répertoire appfiles - le fichier .htpasswd - le répertoire photos - le fichier .htaccess du dossier admin - éventuellement les fichiers thèmes et langages personnels (voir les fichiers readme concernés pour les nouveautés) - Accéder à l'interface d'administration, dans Options, dans la catégorie Options générales, cliquer sur Valider. Pour d'autres renseignements, n'hésitez pas à consulter la section FAQ du site (). Le répertoire themes contient les styles utilisés. Pour les changements de couleur, voir la structure de ce répertoire. Pour des thèmes supplémentaires, consulter le site Web. Pour soumettre vos thèmes, voir également le site Web. Consulter également le fichier readme.themes.txt. V. Documentation Pas encore de documentation mis à part ce fichier. L'aide sera plutôt disponible sur le site sous forme de FAQ ou directement intégrée dans KDPics. VI. Téléchargement Vous pouvez télécharger la dernière version de KDPics sur : VII. Contacts Pour tout renseignement, bug, demande d'amélioration, conseil contactez moi : VIII. Versions Version 1.0 - Admin et galeries Version 1.01 - Tri des catégories, galeries et photos par ordre alphabétique - Séparation de galeries dans le menu par '-' - Affichage du nombre de photos dans les miniatures Version 1.02 (selon des idées de François B. alias MacFly) - Possibilité de réduire l'affichage des images si elles sont trop grandes - Possibilité de n'afficher que le commentaire quand il existe à la place du nom d'image Version 1.03 - Gestion des fichiers JPEG (plus seulement JPG) - Ajout du rappel de la catégorie/galerie/photo dans l'ajout de commentaire ou de photos (merci FB) - Ajout d'un commentaire lorsque les images trop grandes sont réduites (configurable) Version 1.04 - Affichage (paramètrable) ou non des catégories (et galeries) si pas les droits à ce répertoire (grand merci FB) - Création des catégories dans la pages de gestion des galeries/photos plutôt que dans la page des droits - Possibilité de n'allouer la création des catégories qu'à l'admin (configurable) - Possibilité d'ajout d'utilisateurs pouvant administrer les catégories dans lesquelles ils ont les droits - La scrollbar est jolie (css : merci FB) - Choix du style CSS dans le fichier de config Version 1.05 - Dans l'interface d'admin : supprimer photos/galerie/catégories plus possible pour non admin (configurable) - Possibilité de n'allouer la création des catégories qu'à l'admin (configurable) (bug résolu) - Correction du bug des catégories/galeries/photos contenant des ', ", ... - Photo aléatoire ou prédéfinie pour présenter chaque galerie ou chaque catégorie (configurable) - Ajout d'un haut et d'un bas de page (voir haut.inc.php3 et bas.inc.php3, accepte PHP et HTML) - Supprimer les caractères spéciaux des photos uploadées, nouvelles catégories et galeries Version 1.06 - Sécurité accrue dans l'admin (accès aux pages réservées à l'admin plus possible depuis URL) - Possibilité d'être prévenu par mail à l'ajout de photos (configurable) - Possibilité aux utilisateurs de s'inscrire à une catégorie pour être prévenu de l'ajout de photos (configurable) - Gestion des mails inscrits par l'interface d'admin Version 1.07 - Création galerie dans l'admin en haut de la page Catégories/galeries/photos - TreeView dans listes de photos de l'interface d'admin - Fusion dans l'admin des commentaires et des Catégories/galeries/photos - Afficher seulement la miniature de la photo dans l'admin - Catégories/galeries/photos dans Voir Version 1.08 - Le tri des catégories/galeries/photos est configurable individuellement par nom/date croissant/décroissant - Fusion dans l'admin des upload d'images et des Catégories/galeries/photos - Bug Alert : n'indique plus 2 Mo plutôt que la taille réelle - Un seul Parcourir... dans l'upload d'images qui différencie automatiquement les zip des jpeg - Possibilité pour les utilisateurs d'ajouter des commentaires sur une photo (configurable) - Tableau récapitulatif des derniers commentaires ajoutés aux photos d'une catégorie (nombre de commentaires configurable) - Affichage de 'New' sur les photos en cas de nouveau commentaire Version 1.09 - Toutes les options sont disponibles individuellement pour les catégories/galeries/photos - Cacher les menus spéciaux admin dans l'interface d'admin si l'utilisateur n'est pas admin (configurable maintenant) - L'envoi automatique de mail aux destinataires par défaut se déroule bien (même s'il n'y a pas de destinataires autres) - Vocabulaire : Modifier un commentaire plutôt qu'Ajouter selon les cas dans l'interface d'admin - Les commentaires avec des sauts de lignes apparaissent sur plusieurs lignes (sauf dans l'interface d'admin) - Treeview : un clic sur une catégorie = dérouler, un second clic = enrouler à nouveau - Principe de thèmes : les fichiers CSS et images se trouvent dans des répertoires dans le répertoire themes - Bouton rafraichir - Rafraichissement de la page principale après ajout de commentaire - Catégories/galeries vides mieux mises en valeur dans la partie navigation - Nouveaux styles CSS - Readme pour l'utilisation et la création des thèmes - Refonte du fichier de configuration pour une mise à jour plus simple et la modification de la config par l'interface d'admin - Découpage x photos par page (avec navigateur + possibilité de choisir le nombre de photos par page par l'utilisateur + admin) Version 1.10 - Procédure d'installation revue - Message si pas de .htpasswd dans la création d'utilisateurs et la gestion de droits dans l'interface d'admin - Message si pas de .htaccess pour protéger l'interface d'administration - Informations JPG disponibles - Les popup sont apparentes lorsqu'elles perdent le focus puis sont rappelées - Multilangue : galerie - Meilleure gestion du pluriel pour l'adaptation multilangue - Meilleure sécurité dans la gestion des utilisateurs et les droits - Après attribution des droits pour l'interface d'administration, la catégorie sélectionnée est vide - La déprotection de l'interface d'administration est possible (même si non conseillée) - Multilangue : interface d'administration - Option secureadmin dans l'interface d'administration - Problème d'ajout de commentaire résolu - Problème de tableau des derniers commentaires résolu - Problème de Popup avec des catégories/galeries/photos contenant des apostrophes résolu - Navigateur de galerie en bas de page des galeries Version 1.11 - Dans les données EXIF, le commentaire de la photo est affiché - Restructuration des répertoires photos pour avoir des répertoires 'propres' (qui ne contiennent que des photos) - Supprimer les fichiers kdcomments, kdpics, last.kdcomments et autres lors de la suppression - Protection de la suppression accrue - Problème de persitance de catégorie après suppression résolu - Problème de vocabulaire dans l'envoi de mail : _ML_CHANGED_CAT_ résolu - Case à cocher permettant la fermeture de la fenêtre de commentaires après ajout - Problème miniatures avec GD2 (manque de couleurs) résolu - Message sur la page d'accueil de l'administration si les extensions zip et GD ne sont pas chargées - Message d'erreur lors de l'ajout de photos par zip si l'extension zip n'est pas chargée - Option permettant de choisir le système de l'hébergeur pour la gestion de .htaccess : Linux, Windows ou Free (Windows ne fonctionne pas encore parfaitement) - Problème de rechargement de la page dans les options et droits de l'interface d'administration sous Windows - Bouton de connexion disponible sur la page d'accueil (si .htpasswd bien configuré, ne fonctionne pas sur Free) - Tri par dates réelles - Message d'aide à l'arrivée sur le site pour dire que la connexion est possible Version 1.12 - Procédure de mise à jour dans le fichier readme.txt - Problème de ' changées en \' dans les commentaires résolu - Problème de tri des x derniers commentaires quand la limite de x est atteinte résolu - Amélioration du style : le contenant du navigateur et des catégories/galeries/photos est un tableau avec un style - Possibilité d'enlever le droit de modification aux catégories publiques aux utilisateurs autres qu'admin (Options générales) - Fenêtre commentaires : le rafraichissement de la fenêtre principale se fait même s'il y a demande de fermeture de la fenêtre - Les fichiers utiles à KDPics sont centralisés dans un répertoire (appfiles) pour une meilleure protection et pour faciliter la mise à jour - Stat : module d'enregistrement des visiteurs - Problème d'affichage dans l'interface d'administration : clic sur voir avec des catégories/galeries/photos contenant une ' résolu - Même souci avec le tableau résumé des commentaires utilisateurs dans les catégories/galeries/photos contenant des ' : résolu - Diaporama : navigateur, contrôle de début/fin, délai configurable, plein écran, adaptation de la taille de l'image à celle de la fenêtre (+interface d'administration) - Navigateur inversé en dessous de la photo ou de la galerie (idée de KD) - Adaptation de l'envoi de mail pour Free - Statistiques de visites de la galerie (visible dans l'interface d'administration) - Choix dans l'administration pour l'affichage ou non de la liste complète galeries dans la page galeries (idée de Nico) - Gestion par l'interface d'administration des mots de passe avec un serveur Apache sous Windows (avec le fichier admin/tools/htpasswd.exe) - Fichiers haut et bas placés dans appfiles pour la future définition par catégorie/galerie/photo - Nouvelle option (n'apparaissant pas dans l'interface d'admin) permettant de déterminer la version de GD si ce n'est pas possible dans le code (bientôt automatique) Version 1.13 - Problème d'affichage des statistiques si le fichier stats_kdpics.csv est inexistant résolu - Gestion de l'impression des photos (retaillage automatique, taille du papier par défaut configurable dans les options) - Masque formaté pour les informations en bas de photos (configurable dans les options) (sur une idée de Nico) - Suppression de l'option permettant le remplacement du nom des fichiers en bas de photo par leur commentaire (plus utile) - Noms trop longs dans les statistiques tronqués (info bulle) - Indiquer si une photo a été ajoutée récemment dans une catégorie/galerie (+ configurable) - Problème de changement de répertoire par défaut résolu (merci NB) Version 1.14 - Amélioration de la présentation - Réduction automatique de la taille en ko dans la partie visualisation de la photo, pour un chargement plus rapide (configurable) - Ajout de la miniature de la photo suivante et précédente dans la visualisation de la photo - Affichage des miniatures dans le résumé des commentaires utilisateur - Retour à l'accueil, la catégorie et la galerie : arrivée à la bonne page et sur la ligne de la photo - Diapo amélioré : boutons fermer et afficher miniature - Miniature affichée dans l'ajout de commentaires utilisateur - Affichage du nom de la catégorie, galerie et photo sur les miniatures affichées aléatoirement - Extraction des variables en cas de register_global = off - Gestion des erreurs PHP (suppression des notices) - Gestion des mots de passe sous Apache Windows Version 1.15 - Flèches de navigateur autour de la liste déroulante de navigation par page (idée de steph) - Troncage des noms de photos dans la galerie pour éviter les pages trop larges - Nombre de photos dans les galeries dans la liste déroulante de navigation par galerie - Liste déroulante pour la liste des galeries dans la liste des photos et la liste des catégories les galeries - Icone pour aller directement sur la bonne photo incrustée dans la miniature dans les catégories/galeries - Nouvelle présentation des catégories et galeries (sous forme tabulaire comme pour les photos) - Meilleure gestion des miniatures plus hautes que larges (merci FB) - Correction de la gestion des pluriels : caractère espace géré - Effacement des miniatures (pour une photo, pour une galerie, pour une catégorie) - Rotation des photos dans l'administration (+ configurable) - Choix de gd1 ou gd2 dans les options de l'interface d'admin - Double confirmation à la suppression d'une catégorie dans l'interface d'admin (idée de docky99) - Option 'Afficher la liste des galeries disponibles dans la catégorie' supprimée (inutile grâce aux listes déroulantes) Version 1.16 - Bouton de connexion générale chez Free (possible maintenant, merci Free) - Confirmation lors de l'effacement des miniatures de la catégorie dans l'interface d'administration - Support PNG et Gif, configurable dans l'interface d'administration - Support des vidéos, configurable dans l'interface d'administration - Création de la miniature à la taille originale de l'image si celle-ci est plus petite que la miniature elle-même - Problème d'espace au début ou à la fin du nom des nouvelles catégories/galeries dans l'interface d'administration résolu - Refonte de toute la partie photos en CSS + une grande partie de l'interface d'administration - Sécurité ajout de catégories/galeries/photos corrigée - Commentaires ajoutée sous la photo - Vérification de la mémoire nécessaire à la création des miniatures et des photos de moindre poids, solutions si elle dépasse la mémoire allouée IX. ToDo - Multilangue : choix automatique par le navigateur - Download de photos d'une galerie/catégorie directement en zip - Icones pour plus d'intuitivité - Aide pour gérer les galeries, ajouter des photos, commentaires, ... pour les utilisateurs non initiés ayant certains droits d'admin - Renommer catégories/galeries/photos dans l'administration + renommer les fichiers attachés (kdpics, kdcomments, ...) - Déplacer galeries/photos dans l'administration - Popup configuration utilisateur (= nb photos par page, dates derniers commentaires, dates dernières photos, ordre de tri persos, thème, langue) - Bouton supprimer toutes les configurations particulières - Faire en sorte que si un mini-forum est ouvert dans une galerie mais pas dans la catégorie on aie quand même accès au tableau récapitulatif - Possibilité de créer une protection de tout KDPics - Possibilité d'affecter des fichiers haut et bas par catégorie/galerie/photo - Sélecteur de photo prédéfinie dans les options de l'interface d'administration - Bouton envoi de mail dans l'administration (+ configurable) - Page d'outils : protection du répertoire contenant .htpasswd, protéger KDPics, nettoyage options, commentaires, miniatures, ... - Préchargement de la photo suivante dans l'affichage des photos - Remplir l'option de version de GD automatiquement - Déplacement de fichiers - Gestion de la qualité des miniatures - Meilleure gestion des erreurs de login chez Free (idée de Torana) - Explorateur de fichiers pour sélectionner plus facilement le fichier .htpasswd - Pause du diaporama au passage du curseur sur la photo - Gestion des groupes d'utilisateurs (voir Free) - Changer la date de toutes les photos d'une galerie ou d'une photo en particulier - Les messages d'erreur ne sont pas traductibles dans la gestion des catégories/galeries/photos de l'interface d'administration - Ajouter l'option retour vers le site principal dans les options de l'interface d'administration - htmlentities ? dans les listes déroulantes (problème d'espace à la fin du nom de la galerie/catégorie) - Découper le fichier csv des statistiques - Modification des en-têtes et pieds de page dans l'interface d'administration - Ouvrir la photo en taille originale dans une popup - Problème d'affichage des miniatures avec un carré jaune dans IE si la catégorie/galerie/photo contient un accent dans son nom - Envoi de photos par mail - Nombre de visites pour une photo + vote + ... - Afficher les commentaires sous la photo - Intégrer FCKEditor - Gérer la sélection des photos pour amener à différentes actions (envoi par mail, récupérer par fichier zip, ...) - Photos sur plusieurs hébergements - Augmenter la taille des images et de la mémoire attribuée (tests chez Free : pas concluants) - Message d'assistance utilisateur