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
  1. But de l'application :
    Entreposer des signets sur une page internet, leur associer un ensemble d'outils de gestion

  2. Avantages/Inconvénients d'une telle solution
    AvantagesInconvénients
    Accès à partir de n'importe quel ordinateur connecté à Internet Signet un peu plus compliqué à mémoriser
    Signets non perdus en cas de panne de son ordinateur Necessite un espace (< 1 Mo) Internet supportant PHP/MySsQL
    D'avantage d'outils de gestion que dans un navigateur
    Mise en page beaucoup plus agréable et pratique à utiliser
    Permet de mémoriser une description (et aussi des mots-clés)
    pour chaque signet, facilement modifiables
    Pour ceux qui développent des sites internet avec des pages de liens, permet une gestion beaucoup plus efficace : chaque page de lien pourra ętre une catégorie (module déjŕ développé et utilisé entre autres dans AtelierPHP pour les pages de ressource HTML et PHP)

  3. Limitations _ 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)
    • Versions necessaires : PHP4 ou supérieur et MySQL 4 ou supérieur
    • Si l'url est de type https:// (et non http://) le titre du site, les mots clés... ne sont pas détectés
      ces url ne sont pour l'instant pas gérées au niveau de l'importation/exportation des catégories
  4. Compatibilité
    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 sufffit alors de réactualiser la page.
  5. Résumé des fonctionnalités

  6. 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     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 ovh.com
      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
    2. 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

    Dans tous les cas vous aurez à installer sur votre ordinateur un logiciel de transfer ftp, qui va vous permettre de transferrer sur internet le dossier décompressé de l'application. Un tel logiciel fonctionne à la manière de l'explorateur de fichiers (windows ou autre) , mais vous aurez d'abord à fournir un nom de serveur, nom d'utilisateur et mot de passe (port : mettre 21).

  7. 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) qui seront à renseigner dans /mysql_connexion/mysql_connexion.php : ($host (serveur) $user (utilisateur) $pass (mot de passe) $db (nom de la base de données)

      Si vous installez sur Internet, vérifiez que
    • L'espace que vous utilisez est bien suporte PHP/MySQL
    • Que vous avez l'autorisation necessaire 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     atelierPHP.net

  8. 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é.

  9. Menus de gestion courante des signets
  10. 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

  11. 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
  12. Page principale dutilisation des signets

    C'est la page qui vous permet d'accéder à vos signets
    • Menu du haut
      1. Favoris : vous permet d'afficher vos signets favoris, c'est la page qui s'ouvre par défaut lorsque l'application est activée
      2. Recents : vous permet d'afficher les 10 derniers saisis dans la base
      3. Hasard : prend 10 signets au hasard dans la base
      4. 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", "modofier 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

  13. 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
    14. Logiciel sous General Public License (GPL)

    CONTACT : CONTACT2 (arobase) ATELIERPHP (point) NET    		 Page d'accueil de l'application