Codulle - L'explorateur de code sources

Accueil>> AlBulle >> AlBulle0.8 >> photos

Informations fichier

Nom du fichier : lisezmoi.txt
Taille du fichier : 11 Ko (279 lignes)
Language :

    :: AlBulle - Lisez moi :: Version 0.8 :: Auteur : SamRay1024 :: http://jebulle.net - http://forums.jebulle.net :: webmaster@jebulle.net // Encodage du fichier : ISO-8859-1 (8 bits) // Fin de ligne : CR + LF SOMMAIRE -------- * REMERCIEMENTS * INTRODUCTION * CONFIGURATION REQUISE * AVERTISSEMENT (Si vous ne devez lire qu'un seul paragraphe, lisez celui-là !) * MISE-A-JOUR DEPUIS LA VERSION PRECEDENTE * UTILISATION * PARAMETRAGE DU PROGRAMME * REDEFINIR SON PROPRE CLASSEMENT * UTILISATION D'ALBULLE EN CENTRE DE TELECHARGEMENT * INTEGRER ALBULLE DANS UN SITE INTERNET * CHANGER LE STYLE DE LA PAGE * PROBLEMES CONNUS * AUTRES QUESTIONS REMERCIEMENTS ------------- Je remercie pour leur aide précieuse au développement d'AlBulle les personnes suivantes : - CyberBob002 - http://lecyber.net - Olivier Matheret - Kew1 - Tous les visiteurs et autres membres du forum qui proposent des suggestions, rapporte les erreurs qu'ils peuvent rencontrer... qui se reconnaîtront ;-). INTRODUCTION ------------ AlBulle est une galerie photo basée sur la classe PanierDeFichiers que vous pouvez trouvez sur le site. AlBulle permet l'exploration de dossiers dans lesquels vous pouvez classer vos photos. Le script gère automatiquement la création des miniatures des photos que vous ajoutez dans vos albums et supporte les 3 formats que sont : GIF, JPEG et PNG. AlBulle propose un panier dans lequel vous pouvez ajouter des photos au grès de votre navigation dans les albums. Lorsque votre sélection est terminée, vous pouvez alors la télecharger directement via une archive au format de compression ZIP. Il ne vous reste plus qu'à la décompresser pour profiter de ces photos sur votre ordinateur ! CONFIGURATION REQUISE --------------------- Vous devez, pour pouvoir utiliser AlBulle, disposer d'un serveur web qui permette l'exécution de code PHP. Ce serveur web doit avoir les caractéristiques suivantes : - PHP version 4.1.x, - Extension GD active sur le serveur PHP (pour le traitement des images), - Extension zlib active (pour l'utilisation du panier d'images). Aucune base de données n'est nécessaire pour l'utilisation d'AlBulle. AVERTISSEMENT ------------- Tous les fichiers php que vous trouverez dans ce projet sont encodés au format UTF-8. Ainsi, VOUS NE DEVEZ EN AUCUN CAS LES EDITER AUTREMENT QU'EN UTF-8 ! Si par mégarde vous en ouvrez un, ne l'enregistrez pas tant que votre logiciel n'a pas été configuré pour enregistrer ses fichiers dans ce format ; vous risquer d'endommager les fichiers et d'avoir alors des erreurs lors de leur exécution. DE PLUS, en raison de disparités dans le format UTF-8, tous les éditeurs ne sont pas recommandés pour effectuer cette tâche (le format UTF-8 est décliné en deux versions, dont l'une ne convient pas aux serveurs PHP et peut provoquer des erreurs). Les éditeurs que je vous recommande sont les suivants : - Unired : http://unired.sourceforge.net/, pour Windows uniquement. - Jext : http://jext.sourceforge.net/, multi plates-formes (écrit en Java). - Scite : http://www.scintilla.org/, linux et Windows (mon préféré ;-)). Attention : avec Scite, deux formats d'encodage UTF-8 sont disponibles ! L'UTF-8 et l'UTF-8 Cookie. C'est ce dernier que vous devrez utiliser pour éditer correctement les fichiers, car l'autre ajoute un caractère non visible en tout début de fichier. - Vim : http://www.vim.org/, multi plates-formes. - Emacs : http://www.gnu.org/software/emacs/, multi plates-formes. (Pour les plus curieux d'entres vous, voici un explication beaucoup plus complète que ces quelques lignes que je viens d'écrire : http://openweb.eu.org/articles/jeux_caracteres/ ) MISE-A-JOUR DEPUIS LA VERSION PRECEDENTE ---------------------------------------- * Si vous venez d'une version autre que la 0.6, vous devez supprimer tous les fichiers. Vous pouvez garder votre dossier de photos mais devez supprimer tous les dossiers qui contiennent les miniatures. * Si vous venez de la version 0.6, supprimez tous les fichiers et mettez les nouveaux. Vous pouvez garder vos dossiers de photos ainsi que les dossiers de miniatures. Ouvrez le fichier config.php pour l'adapter selon vos besoins. Si vous aviez des thèmes installés, vous devrez télécharger les nouvelles versions de ceux ci pour la cette version d'AlBulle. * Si vous venez de la version 0.7.x, seuls les fichiers suivants ont changés : - explore.php - includes/config.php - classes/panierdefichiers.class.php - classes/util.class.php UTILILISATION ------------- Vous avez dû trouver après décompression de l'archive d'AlBulle, des fichiers textes à la racine (dont celui que vous lisez actuellement), ainsi qu'un dossier, nommé AlBulle qui contient les fichiers du script. Ils peuvent être utilisés aussi bien sur un serveur PHP4 que PHP5. Pour utiliser le script, vous devez envoyer le dossier 'AlBulle' sur votre serveur Web (par l'intermédiaire de votre client FTP). Envoyer le dossier si vous souhaitez inclure AlBulle dans votre site, ou bien uniquement son contenu si AlBulle doit être votre page principale. Le fichier à lancer est explore.php. Si AlBulle doit être votre site principal, renommez ce fichier en index.php. Sinon, incluez explore.php dans votre site. Une fois le script placé là où vous le souhaitiez sur votre serveur, vous pouvez y placer vos photos. Vous devez créer des répertoires dans le dossier 'photos/'. Placez dans ces répertoires vos photos et autres sous-dossiers. ATTENTION : ne mettez pas de photos directement à la racine du dossier 'photos/'. Elles ne seront jamais affichées. Lors de l'envoi de vos photos, faites attention à ne pas envoyer les fichiers cachés qui peuvent être présents. N'étant pas au format image, AlBulle générera une erreur lorsqu'il rencontrera des fichiers autres que gif, jpg et png. ---- ATTENTION (bis) : LORSQUE VOUS AJOUTEZ UN DOSSIER DE PHOTOS DANS VOTRE REPERTOIRE D'ALBUM, VOUS DEVEZ LUI ATTRIBUER LES DROITS D'ECRITURE : C'EST-A-DIRE QUE CHAQUE DOSSIER DOIT ETRE EN 777. POUR CE FAIRE, UTILISEZ VOTRE CLIENT FTP ET CHANGEZ LES DROITS DANS LES PROPRIETES DU/DES DOSSIERS AJOUTES. SI VOUS NE FAITES PAS CELA, LES MINIATURES NE POURRONT PAS ETRE CREEES ET LE SCRIPT GENERERA UNE ERREUR POUR VOUS LE SIGNALER. ---- AlBulle pouvant naviguer dans une arborescence. Vous pouvez faire autant de dossiers et sous-dossiers que nécessaire pour organiser au mieux vos photos. Il est possible de remplacer dans les noms des dossiers de vos photos les espaces par des tirets bas ('_'). Ils seront automatiquement affichés avec des espaces dans l'explorateur d'AlBulle. La même chose est désormais aussi possible depuis la version 0.8 (cf. paramètrage du programme). PARAMETRAGE DU PROGRAMME ------------------------ Vous pouvez parametrer le script pour l'adapter à vos besoins. Pour cela, vous devrez éditer le fichier "config.php". Ce fichier contient toutes les explications nécessaires pour le paramètrage d'AlBulle prenez le temps de lire les commentaires pour ne pas faire de fausse manipulation. REDEFINIR SON PROPRE CLASSEMENT ------------------------------- Les dossiers et fichiers sont automatiquement classés par ordre alphabétique par le système d'exploitation. Ainsi, si vous souhaitez changer cet ordre (pour faire un classement chronologique par exemple) il vous faut surement avoir recours à un préfixe devant les noms (Ex : 01_..., 02_..., etc). Hors vous ne souhaitez peut-être pas que ce préfixe apparaisse dans la page d'AlBulle. Vous pouvez, depuis la version 0.8, indiquer à AlBulle que vous utilisez des préfixes et que vous ne souhaitez pas qu'ils apparaissent ! Une explication complète du paramètrage à effectuer se trouve directement dans le fichier de configuration (includes/config.php). Rassurez-vous, ce paramètrage est extrèmement simple ! UTILISATION D'ALBULLE EN CENTRE DE TELECHARGEMENT ------------------------------------------------- En activant le mode "centre de téléchargement" d'AlBulle, vous devez créer un dossier du même nom que celui que vous indiquerez dans la configuration ('centre' par défaut) à la racine d'AlBulle. Désormais, chaque photo que vous ajouterez correspondra à un fichier que vous mettez à disposition de vos internautes. Ce fichier devra être placé dans le dossier 'centre', devra OBLIGATOIREMENT porter le MEME NOM que le nom de la photo qui lui est associée et être de l'extension que vous aurez défini dans la configuration. Donc par exemple, si vous ajoutez une photo MaPhoto_01.png dans n'importe quel dossier dans vos albums, vous devrez mettre dans centre/ un fichier MaPhoto_01.zip (Zip car c'est cette extension que j'ai pris ici, mais si vous changez, il faudra adapter dans le dossier). Pour le reste, le fonctionnement ne change pas. INTEGRER ALBULLE DANS UN SITE INTERNET -------------------------------------- Rendez-vous sur le forum http://forums.jebulle.net rubrique Script, classes et ressources PHP pour lire l'astuce qui traite ce sujet. CHANGER LE STYLE DE LA PAGE --------------------------- Pour créer un nouveau thème pour AlBulle, je ne saurais que vous conseiller de prendre le thème par défaut, livré avec AlBulle, d'en faire une copie au nom de votre nouveau thème et de partir de lui. Toute la structure HTML d'AlBulle est contenu dans le fichier html.php. Ce fichier contient du code php qu'il est obligatoire de conserver ! Vous devez respecter la structure PHP et articuler votre structure HTML autour. La structure HTML est accompagné d'un fichier CSS (style.css) qui vous permet de spécifier les couleurs, les images et autres placements des objets HTML. Pour vous aider dans votre intégration du script, j'ai joint à l'archive un dossier 'Ressources' dans lequel vous trouverez les fichiers PSD originaux qui m'ont servit à créer les images d'AlBulle (ainsi que la police de caractère utilisée). Vous pourrez alors repartir de ces PSD pour changer les polices de textes, ou les couleurs de fonds, par exemples ! Autrement dit, pour faire un nouveau thème, vous devez avoir quelques connaissances en HTML et CSS ;-). PROBLEMES CONNUS ---------------- Il se peut que, selon le serveur sur lequel vous allez mettre AlBulle, vous ayez des problèmes avec les noms de dossiers qui comportent des accents et autres caractères spéciaux. Cela vient du fait que chaque serveur, selon sa nature (windows, linux, mac,...), peut avoir un encodage différent. Or, selon cet encodage, AlBulle peut ne pas afficher correctement les dossiers. Cela ne devrait normalement pas porter préjudice au fonctionnement général et ne devrait pas empêcher la navigation. Pour les mêmes raisons, il se peut aussi que les accents passent mals dans l'archive que vous générerez (selon sur quel type de machine vous ouvrirez l'archive ; chaque machine décodant plus ou moins bien les différents charset). Si ce problème était bloquant chez vous (c'est-à-dire qu'une archive serait illisible car corrompue ou que la navigation provoquerait une erreur), n'hésitez pas à vous rendre sur le forum et signaler votre erreur ou m'ecrire un courriel. AUTRES QUESTIONS ---------------- Si vous avez des problèmes, des questions, des suggestions, des critiques ou tout autre chose, un forum est à votre disposition à l'adresse suivante : http://forums.jebulle.net, Rubrique "Scripts, classes et ressources PHP".

Liste des projets

Téléchargez Codulle

Publié par Codulle - v0.1.1 - © Bubulles Creations