E-signets.fr - Gérer vos signets sur Internet
Un logiciel libre utilisant le format XML

Aide pour l'application E-signets

1. But de l'application
2. Avantages/Inconvénients d'une telle solution
3. Limitations _ Compatibilité
4. Résumé des fonctionnalités
5. Préparation de l'installation de l'application
6. Procédure d'installation de l'application
7. Le menu d'accès aux tables
8. Menus de gestion courante des signets
9. Ajouter un signet
10. Désinstaller l'application
11. Description de la page principale
12. Accès en mode administration

But de l'application

Avantages/Inconvénients d'une telle solution

Limitations et Compatibilité

• Limitations connues
  
  • Comme le nom du dossier d'installation devient partie du nom des tables mysql, le nom du dossier de l'application doit être compatible avec les noms de table mysql, c'est à dire pas de point, pas de tiret...
  • C'est le nom du dossier qui est pris dans le nom de la table, et non le chemin complet, donc il ne peut y avoir deux applications installées sur la même machine dans deux dossiers portant le même nom (à des niveaux différents dans la structure des dossiers).
  • Deux catégories ne peuvent porter le même nom, même dans des groupes différents (voir ci-après)
• Compatibilité
  
  • Versions necessaires : PHP4 ou supérieur et MySQL 4 ou supérieur
  • L'application e-signets a été testée sur Linux et XP / Vista / Seven avec serveur Apache, Firefox 2 et 3 et Internet Explorer 7 et 8
  • Avec certaines versions d'Internet Explorer 6 (sous XP SP3 notemment), on obtient parfois une page blanche, il suffit alors de réactualiser la page.

Résumé des fonctionnalités

• Importation/exportation des signets d'Internet Explorer et Firefox
• Importation/exportation de catégories de signets par fichier XML, envoi par mel...
• Système participatif permettant à chacun de mettre ses catégories à disposition
• Plus de 100 catégories déjà disponibles en téléchargement libre et gratuit
• Moteur de recherche interne à l'application
• Disposition de l'affichage des signets très largement parammétrable
• Gestion des favoris
• Nombreux graphismes (skins) possibles, personnalisation de la page : titre, logo...
• Signets publics ou privés, signets actifs ou en hibernation
• Gestion des signets et administration des tables par mot de passe séparés
• Vérification de la validité des liens

Préparation de l'installation de l'application

En cas de difficulté pour cette opération, n'hésitez pas à poser votre question sur le forum de www.atelierphp.net
Les fichiers qui constituent l'application étant compressés dans un fichier zip, décompresser-les, (sous XP, clic droit, "extraire tout"...) copiez-les ensuite sur un espace accessible par un serveur HTTP :

1. Vous souhaitez installer votre page de liens sur un espace internet
   Même si vous "êtes" à Orange ou Club internet ou autre, un "bon plan" est de prendre un compte gratuit sur free, et d'y installer l'application, ainsi si vous changez de FAI, vos pages seront toujours actives (cliquer sur "accès gratuit" sur la page d'accueil de free.fr.
   Une alternative est de prendre un nom de domaine avec un espace internet : il vous en coutera environ 10 € par an, mais au moins vous serez "chez vous" avec une adresse internet du genre "votre_nom.xxx" et une adresse email du genre "votre_prenom@votre_nom.xxx" . Le prestataire utilisé pour e-signets est www.ovh.com
   
2. Si vous optez pour l'hébergement sur le portail de votre FAI (fournisseur d'accès internet : orange, free, darty, club-internet...), consultez ma page de notes sur le sujet : Aide pages perso
3. Vous souhaitez installer votre page de liens sur votre ordinateur :
   Cette solution est un peu plus complexe car elle necessite l'installation d'un serveur HTTP sur votre ordinateur
   Voir ma page de notes sur le sujet : www.atelierphp.net

Procédure d'installation de l'application

1. Une fois le dossier e-signets recopié dans un espace internet ou local mais accéssible par un serveur http
2. Activer l'adresse du dossier dans lequel vous avez copié les fichiers, si votre dossier se nomme "mes_signets" (pas d'espace dans le nom du dossier) l'adresse à activer sera : http://votre_domaine/mes_signets (respecter la casse).
3. Laissez-vous guider, vous aurez à définir vos mots de passe (qui devront être différents) pour la gestion courante et l'administration de l'application
4. Vous aurez aussi à connaitre vos parametres de connection mysql fournis par votre prestataire de service internet (serveur, utilisateur, mot de passe, nom de la base de donnée)

Si vous installez sur Internet, vérifiez que :

• L'espace que vous utilisez est bien suporte PHP/MySQL
• Que vous avez l'autorisation nécessaire pour créer une base de données

Si vous installez en local sur votre PC, vérifiez que votre installation de PHP/MySQL fonctionne, au besoin reportez-vous au premier chapitre de l'atelier PHP sur le site www.atelierPHP.net

Le menu d'accès aux tables

Comme on l'a vu ci-dessus, l'accès à ce menu se fait à l'aide du mot de passe pour l'administration de l'application.
Ce menu permet :

• D'initialiser les deux tables (liste des signets et catégories) pour une première utilisation
• D'effacer tous les signets
• D'effacer les tables : cette opération est necessaire pour désinstaller lapplication.
• De sauvegarder les signets au format texte : il est conseillé de sauvegarder ses tables de temps en temps, pour le cas où les tables seraient détruites pour une raison ou une autre (mauvaise manipulation...)
  Les signets sont suvegardés dans deux fichiers : data/url_list.txt et data/url_category.txt. Ce sont ces deux fichiers qui sont chargés dans les tables, et que vous devez recopier si vous voulez transferer vos signets sur un autre site.
  Contrairement au mot de passe pour l'administration courante, le mot de passe n'est pas mémorisé.

Menus de gestion courante des signets

Restriction : il ne peut y avoir deux catégories de męme nom, męme dans deux groupes différents
par contre il peut y avoir pluseurs sous-catégories de męme nom pourvu qu'elles soient dans des catégories différents.
Une fois que le mot de passe pour le menu "gestion courante" a été saisi :

• Deux liens se rajoutent à la fin de chaque signets, permettant de modifier ou supprimer le signet.
• D'autre part le bas de page comprend un lien supplémentaire permettant d'accéder au menu de rajout de signet.

Groupes :

Un groupe est un ensemble de catégories.
Les catégories peuvent contenir des sous-catégories ou directement des signets.
La particularité des groupes est que l'on peut composer sa propre pagination en se basant sur eux.
Lorsque l'on efface un groupe contenant des signets, ces derniers ne sont plus visibles qu'à partir du menu d'administration, ils sont dits en "hibernation".
Par contre le nom du groupe peut ętre changé sans impact sur le reste de l'application.
Les noms des groupes sont limités à 30 caractères.

Catégories :

Les catégories, à l'intérieur d'un groupe, sont toujours affichées par ordre alphabétique.
Par défaut, les catégories contiennent directement des signets.
Contrairement aux menu des groupes, le menu d'effacement de catégorie permet d'effacer complètement les signets d'une catégorie. On ne peut avoir deux noms de catégories identiques, même dans des groupes différents On peut expotrter une catégorie (ou une sous-catégorie par le męme menu) au format xml vers une adresse mél
On peut importer une catégorie, soit à partir d'un fichier sur son pc, soit à partir du site internet e-signets.fr, menu "catégories".
Les noms des catégories sont limités à 30 caractères.

Sous-catégories :

Lorsque l'on crée une sous-catégorie, automatiquement le nom de la catégorie s'affiche dans un ascenseur, de façon à pouvoir accéder à la sous-catégorie.
Les noms des sous-catégories sont limités à 30 caractères.

Validité des signets

Ce traitement peut durer plusieurs heures, le programme interroge chaque signet "non en hibernation" un à un pour vérifier le lien.
Si le lien ne "répond pas", le programme considère que le lien est invalide, et ce signet n'apparaitra plus tant que :

• Le lien aura été déclaré valide à nouveau lors d'un traitement ultérieur
• Le lien aura été "forcé" manuellement : il arrive que le lien soit déclaré invalide, si la page renvoie sur une autre page. Dans ce cas il est possible de "forcer" manuellement le signet comme valide. Attention un signet "forcé" manuellement n'est plus jamais revérifié par le prcessus automatique. Si au contraire vous modifiez l'URL, ne le forcez pas comme valide, relancez plutôt la vérification automatique. Aprés avoir exécuté cette routine, il sera donc utile de verifier les "liens morts" de façon à voir s'il s'agit d'une erreur de saisie du lien, d'une adresse changée..., l'option "modifier" pour chaque lien permet de prendre l'action adéquoite.

Importation/Exportation des signets de ou vers Firefox ou Internet Explorer

Le fonctionnement de ces utilitaires est implicite, ils vous permettent

• Charger dans e-signets tout ou partie des signets d'Internet Explorer (menu "Fichier", "Importer/Exporter" enregistrer le fichier bookmark.htm sur dans un dossier ou sur le bureau) ou de Firefox (menu "Signets", "organiser les signets", "Exporter", enregistrer le fichier bookmarks.html dans un dossier ou sur le bureau)
• En cas de difficulté dans l'opération précédente, vous pouvez aussi utiliser le fichier xbel.xml généré par l'extension de Firefox "bookmark sync and sort". Pour ce faire voir la notice Utilisation de l'extension de Firefox bookmark sync and sort
• Sauvegarder tout ou partie de vos signets sous forme de page HTML, utilisable telle qu'elle sur le serveur, ou, une fois enregistrée sur votre ordinateur, peut être transformée en signets d'Internet Explorer (menu "Fichier", "Importer/Exporter") ou de Firefox (menu "Signets", "organiser les signets", "Importer", "parcourir"...)

Echanger des signets

Pour une compatibilité maximum entre les différents systèmes d'exploitation, des utilitaires ont été développés pour créer, lire, envoyer, recevoir, des fichiers xml correspondant à des catégories e-signets
Le site e-signets.fr dispose d'un espace d'échange pour ces fichiers dans lequel chacun doit pouvoir librement puiser. Les utilisateurs de e-signets peuvent ainsi proposer des catégories à entreposer dans cet espace (menu 2_2, "exporter...", cocher la case "Envoyer cette catégorie à web-signets pour qu'elle soit mise à disposition"
Note : les fichiers XML produits ne s'ouvrent en dehors de l'application qu'avec Firefox (ne s'ouvrent pas avec I.E.)

Graphisme - skins

Plusieurs graphismes sont disponibles, en terme de couleur et de disposition.
Voir les captures d'écran disponibles à partir de la page d'accueil du site
Cocher simplement la case correspondant à la couleur et à la combinaison que vous désirez, validez.
Pour ceux qui voudraient aller plus loin, ces graphismes sont générés par les fichiers

• ../styles/e_signets_style_01.css (bleu standard)
• ../styles/e_signets_style_02.css (vert)
• ../styles/e_signets_style_03.css (violet/rose)
• ..............................................

Lecture des tables

Option surtout utile pour ceux qui voudraient prolonger le développement de cette application.

Rajouter un signet

C'est le formulaire qui vous permet de rajouter un signet dans la base
Il sera souvent pratique (et aussi plus fiable...) d'utiliser la fonctionnalité 'copier/coller' :

1. Ouvrir le formulaire de saisie d'un nouveau signet
2. Aller sur le site dont on veut mémoriser l'adresse
3. Copier l'adresse de cette page : cliquer sur le bord bas de la barre d'adresse pour mettre ce-ci en surbrillance, puis "edition", "copier"
4. Valider l'étape 1 (1_Charger description et mots clés)
5. Vérifier/completer/modifier eventuellement les informations extraites automatiquement : titre, sous-titre, description, mots-clés .
   Les champs obligatoires sont marqués d'un astérisque
6. Ne pas oublier de choisir une catégorie,
7. Valider

Désinstallation de l'application

Deux opérations simples sont nécéssaires pour désinstaller entièrement l'application

• Dans le menu d'administration des tables, cliquer sur "Effacer les tables et leur contenu"
• Effacer tous les dossiers et fichiers de l'application

Page principale d'utilisation des signets

C'est la page qui vous permet d'accéder à vos signets
Menu du haut

• Favoris : vous permet d'afficher vos signets favoris, c'est la page qui s'ouvre par défaut lorsque l'application est activée
• Recents : vous permet d'afficher les 10 derniers saisis dans la base
• Hasard : prend 10 signets au hasard dans la base
• Recherche : par défaut ce contrôle est activé au chargement de la page, c'est à dire que si vous tapez des caractères au clavier dès que la page est chargée, ceux-ci iront directement dans ce champ; le principe est le męme que dans les principaux moteurs de recherche : insensible à la casse si la saisie est en minuscule, mots entiers seulement (ne fait pas de recherche sur des fractions de mot), mots de plus de trois caractères. A ce niveau la recherche s'effectue sur les quatres champs suivants :
  • Titres des signets
  • Sous-titre
  • Description
  • Mots-clés

Cadre des groupes, catégories et sous-catégories :

• Goupes : A l'aide du menu d'administration générale "groupe", "modifier un groupe" , deux éléments sont modifiables
• La colonne dans laquelle s'affiche le groupe
• Si le groupe est public (s'affiche tout le temps) ou privé (ne s'affiche qu'une fois que l'on a saisi le mot de passse d'administration courante
• Catégories : sont constituées uniquement d'un lien si l'on n'a pas créé de sous-catégorie, ou d'un ascenseur si au moins une sous-catégorie a été créée
• Sous-catégories: sont "cliquables" uniquement les lignes précédées du symbole ">".
  L'ascenseur des sous-catégories se crée dès que l'on crée une sous-catégorie (si le "skin" le permet)

• Cadre des signets : Si l'on a saisi le mot de passe d'administration courante, chaque signet est suivi en gris du numéro du lien, de sa date de saisie et d'un lien permettant de le modifier ou de le supprimer
• Champ "Google" : permet au besoin de lancer directement une recherche sur google

Page principale de visualisation des signets, en mode administration

Lorsque l'on accède à la page d'affichage des signets à partir du menu d'administration, on dispose à la fin de chaque description de signet, de deux liens marqués "modif" (en bleu en principe) et "sup" (en rouge) permettant de modifier ou supprimer ce signet.