ResooSite
ResooDoc v.0.9

Aide ResooSite


1. Présentation générale
2. Action Administrateur
3. Action Modérateur
4. Action Super Administrateur
5. F.A.Q.
6. Annexes

1. Présentation générale
  • 1.1. Généralités
  • Le concept de départ:
    la création et la mise à jour simplifiées "au maximum" d'un site internet reprenant la mise en page et la fonction d'un journal électronique.

    Le cahier des charges:
    1 - autoriser un accès rapide et confortable au infos du site pour un maximum de visiteurs (création de pages "légères", indépendance par rapport au logiciel de navigation utilisé, lecture à l'écran favorisée même avec une petite résolution d'écran).
    2 - autoriser la mise à jour et le contrôle du site du site à un nombre quelconque d'utilisateurs, quelle que soit leurs localisations, leurs matériels, ou leurs connaissances en informatique.
    3 - l'utilisation exclusive de logiciels libres pour une libre mise à disposition du résultat final.

    Les options retenues:
    - Perl: pour l'écriture des scripts, présent sur la quasi totalité des serveurs internet, et garantissant un accès équivalent au très petites et très grosses configurations.
    - Html 3.2: pour la création des pages, compatibilité assurée jusqu'au navigateur en mode texte (optimised for lynx ;)
    - une présentation résolument "texte", et une mise en page autorisant l'impression de document pas trop ...vilaine.

    [ retour index ]

  • 1.2. Architecture ResooSite
  • Dans sa forme la plus réduite, le site s'articule autour d'une unique "page index" (la première ayant pour titre "accueil") sur laquelle viennent s'ajouter des "pages article" au fur et à mesure de leur création:

    # Pour chaque création de "page article", son titre, son résumé, et un lien "lire la suite" (donnant accès à cette "page article") s'ajoute en tête de la liste des articles de la page index. Si l'on supprime la "page article", elle disparaît aussi de la liste proposée sur la page index correspondante.

    # Et sur chaque page article, un lien intitulé "retour" permet au visiteur de retourner sur la "page index" qui lui a permis de consulter la "page article" en question.

    C'est le fonctionnement de base du site: de simples aller-retours entre la "page index" et les "pages article" qu'elle héberge.

    Se rajoutent à cela trois options majeures:

    1 - la possibilité de changer l'ordre des résumés d'articles présents sur la page index (avec la fonction "réactivation" qui permet lors de la "modification" d'une page article de la faire revenir en tête de liste sur la "page index" correspondante).

    2 - la possibilité de créer d'autres "pages index" (c'est une action "Super Administrateur"), on passe d'une page index à une autre en cliquant sur un lien (qui se crée ou se supprime automatiquement) situé dans le cadre en haut à gauche de chaque "page index".

    3 - la possibilité de déplacer le résumé et le lien relatif à une "page article" d'une page index à une autre: lors de la "création" ou "modification" d'une "page article", il est proposé de choisir ou de modifier la page de "retour" qui n'est autre que sa "page index" de référence (ce choix ne sera bien sûr possible que lorsque au moins deux "pages index" seront disponibles sur le site).

    Pour terminer la présentation rapide, cette version de ResooSite propose en option de faire fonctionner sur le site:

    - un forum (fonctionnement classique: envoi de message, réponse au message, etc.) avec comme la possibilité d'y pratiquer une modération (avant d'apparaître sur le forum, le message doit être validé par le modérateur du forum).

    - une page téléchargement: simplement une page qui indexe les fichiers d'un répertoire précis de votre site (et de ses sous-répertoires).

    - une fonction d'affichage "d'image du jour", "de la semaine", etc.

    [ retour index ]

  • 1.3. Accès par mot de passe
  • 3 sortes de mot de passe peuvent être utilisés sur le site:

    I - Les mots de passe "d'administration":
    Ce sont les mots de passe qui autorisent l'accès aux pages "administration" de votre site. La création ou suppression de ces mots de passe est une action réservée au Super Administrateur
    Il en existe trois niveaux:
    - Super Administrateur: qui donne accès aux pages de configuration du site (créer des compte d'administration, créer ou renommer des pages index, modifier les données permanentes du site comme le titre, l'adresse internet, mettre en route certaine option du site comme la page téléchargement, le forum, etc.)
    - Administrateur: qui donne accès aux pages d'administration du site (créer un article, le modifier, le supprimer, modifier une page index)
    - Modérateur: qui donne accès à la fonction modération du forum du site (valider, modifier ou supprimer les messages posté sur le forum)

    Un Administrateur n'a pas accès aux fonctions Super Aministrateur, et inversement un Super Aministrateur n'a pas accès aux fontions Administrateur (sous réserve qu'il a la possibilité de créer un compte...). Pour donner les deux fonctions à un même utilisateur, il est necessaire de lui créer les deux comptes. Mais le même nom et le même mot de passe peuvent être utilisés.
    Par défaut, tous les Administrateurs sont aussi Modérateur. Pour supprimer l'accès Modérateur à un Administrateur, il suffit de créer un compte Modérateur avec son nom, mais sans lui communiquer le mot de passe (le mot de passe Modérateur est prioritaire sur celui d'Administrateur concernant les actions de modération du forum).
    Les mots de passe d'administration (Super Administrateur, Administrateur, Modérateur) sont stockés sur votre site sous une forme crypté, et il n'est pas possible de les lire ou de les modifier. Si tel était le besoin (oublis de mot de passe...) la seule solution consiste à supprimer le compte et à le recréer.
    Pour l'ensemble de ces noms et mots de passe, il est conseillé de choisir des mots mélangeant chiffre et lettre d'au moins 6 caractères.
    Note: il n'y a pas de limite minimum ou maximum de la taille des noms ou des mots de passe, mais concernant le cryptage des mots de passe, seuls les 8 premiers caractères du mot de passe sont significatifs ("jeanclaude" est équivalent à "jeanclau").

    Les pages d'accès aux pages protégées fonctionnent sur le même schéma: il est demandé à l'utilisateur d'indiqué son nom d'utilisateur et son mot de passe (qui ne s'affiche pas en clair), après deux essais infructeux, il apparait une page demandant à l'utilisateur de contacter l'administrateur du site.

    A moins que ce ne soit votre machine personnelle, si le navigateur vous propose d'enregistrer le mot de passe que vous venez d'indiquer, choisissez "non", sinon quiconque se servirait de cette machine après vous se verrait automatiquement offrir la possibilité d'utiliser ce même mot de passe.

    Important: le site est conçu pour laisser un maximum de liberté aux "Administrateur" et "Super Administrateur" du site. Lorsque l'accès protégé par mot de passe est franchi, très peu de sécurité s'applique aux actions proposées. Ces comptes ne devraient donc jamais être rendus public!

    II - Les mots de passe "utilisateur":
    Ce sont les mots de passe que vous pouvez distribuer à certains utilisateurs / visiteurs de votre site pour leur permettre certaines actions particulières (par exemple de poster un message directement sur le forum même si l'option modération est activée)
    Lorsque vous utilisez cette sorte de mots de passe, ils sont stockés dans des listes spécifiques (1 mot de passe par ligne) dont la tenue (création / suppression / consultation) est une action réservée au Super Administrateur

    III - Les mots de passe "compte FTP":
    C'est le mot de passe qui vous est communiqué par l'hébergeur de votre site (par ex. resoo.com) et qui vous permet en utilisant un logiciel spécifique d'accéder aux répertoires de votre site sur la machine distante qui les héberge.
    Ce type d'accès permet tous types d'action sur les fichiers de votre site (suppression, etc.) et ce mot de passe ne doit jamais être largement communiquer.

    [ retour index ]

  • 1.4. Versions et mises à jour
  • La page actualisée concernant cette rubrique se trouve à l'adresse:
    resoo.org/resoosite

    (La configuration du site qui vous est personnelle est stockée dans une série de fichiers dynamiques (qui se complètent en fonction de la version utilisée) et reste préservée quelle que soit la mise à jour des scripts.)

    Resoo Site v.0.9.4 du 06/07/2003
    # correction de bug divers.
    # création de deux nouveaux types d'articles: article/liste (page article faisant office de page index) et article/lien (page de liens)
    # création d'une page index "lien"
    # création de page index "invisibles"
    # boite à outils administrateur: archivage et suppression d'article globale pour une page index, réorganisation d'une page index, téléchargement vers les répertoires img et doc
    # standardisation de tous les fonds de page administrateur (rubrique "autres choix")

    Resoo Site v.0.9.3 du 28/05/2003
    # correction de bug divers.
    # réécriture totale du forum qui respecte maintenant la stucture des autres scripts ResooSite. Rajout de fonctionnalité de modération complète (suppression/ édition des messages, archivage, mot de passe utilisateurs). Les pages index étant maintenant dynamiques, sans aucune manipulation administrateur, le fonctionnement du forum n'est en rien altéré par le nombre de messages présents.
    # cryptage de tous les mots de passe stockés sur votre site.
    # page index: rajout du mode "condensé" et "lien seul" pour la mise en page de la liste des articles.

    Resoo Site v.0.9.2 du 15/05/2003
    # correction de bug divers.
    # modification page téléchargement, possibilité de lister les sous répertoire de votre répertoire principal, ajout de texte d'aide.
    # page index: création d'un lien "info spéciale"
    # affichage: possibilité d'afficher la liste des pages index sous forme "resooclick" (liste déroulante).

    Resoo Site v.0.9.1 du 19/04/2003
    # correction d'une montagne de bug, principalement ceux touchant aux noms de pages index qui selon le cas pouvaient planter le script
    # page article: possibilité d'annuler le formatage html automatique permettant de reprendre du code html "clair" dans le cadre article.

    Resoo Site v.0.9 du 01/08/2002
    # première version diffusée des scripts.

    [ retour index ]


2. Action Administrateur
  • 2.1. Généralités
  • On accède au mode administrateur après la validation d'un mot de passe par le lien existant en bas à gauche de chaque page index ou article.
    Les actions administrateur autorisent la modification des pages index, la création, modification et suppression des pages articles.


    [ retour index ]

  • 2.2. Modification Page Index
  • En bas à gauche de chaque page index se trouve un lien "Accès Administrateur", une fois la page "Saisie de mot de passe" franchie, vous accédez à la page "Modification Page Index"

    Rubrique "Titre":
    en cours de rédaction...

    Rubrique "Mise à jour du":
    en cours de rédaction...

    Rubrique "Image":
    en cours de rédaction...

    Rubrique "Titre manchette":
    en cours de rédaction...

    Rubrique "Manchette":
    en cours de rédaction...

    Rubrique "Titre encart":
    en cours de rédaction...

    Rubrique "Encart":
    en cours de rédaction...

    Rubrique "Info Spéciale":
    en cours de rédaction...

    Rubrique "Mise en page des articles":
    en cours de rédaction...

    Bouton "Modifier cette page":
    en cours de rédaction...

    Bouton "Créer un nouvel article":
    en cours de rédaction...

    Lien "Accès mode Super-Administrateur":
    en cours de rédaction...

    Lien "Administration Forum":
    en cours de rédaction...

    [ retour index ]

  • 2.3. Création Page Article
  • En bas de la page "Modification page index" se trouve un bouton "Créer un nouvel article", vous accédez à la page "Création"

    Rubrique "Date de création":
    en cours de rédaction...

    Rubrique "Titre":
    en cours de rédaction...

    Rubrique "Email auteur":
    en cours de rédaction...

    Rubrique "Retour":
    en cours de rédaction...

    Rubrique "Lettrine":
    en cours de rédaction...

    Rubrique "Résumé":
    en cours de rédaction...

    Rubrique "Article":
    en cours de rédaction...

    Rubrique "Note":
    en cours de rédaction...

    Bouton "Créer l'article":
    en cours de rédaction...

    Bouton "Annuler l'article":
    en cours de rédaction...

    [ retour index ]

  • 2.4. Modification/Suppression Page Article
  • En bas à gauche de chaque page article se trouve un lien "Accès Administrateur", une fois la page "Saisie de mot de passe" franchie, vous accédez à la page "Modification Page Article"

    Rubrique "Réactivation":
    en cours de rédaction...

    Rubrique "Mise à jour du":
    en cours de rédaction...

    Rubrique "Titre":
    en cours de rédaction...

    Rubrique "Email auteur":
    en cours de rédaction...

    Rubrique "Retour":
    en cours de rédaction...

    Rubrique "Lettrine":
    en cours de rédaction...

    Rubrique "Résumé":
    en cours de rédaction...

    Rubrique "Article":
    en cours de rédaction...

    Rubrique "Note":
    en cours de rédaction...

    Bouton "Modifier l'article":
    en cours de rédaction...

    Bouton "Supprimer l'article":
    en cours de rédaction...

    [ retour index ]


3. Action Modérateur
  • 3.1. Généralités
  • le forum est prévu pour fonctionner sous 3 modes de modération différents,

    1- mode "dur": (qui décourage rapidement les attaques), les messages ne sont pas postés directement sur le forum, mais seulement après qu'un modérateur du forum ait validé / modifié ou supprimé les dits messages

    2- mode "libre": il n'y a pas de modération "a priori" et les messages sont directement postés sur le forum. Les modérateurs du forum se réservant le droit à postériori de modifier, supprimer ou effacer les messages postés quelle que soit leur position dans le fil de discussion (cette possibilité est de toute façon acquise quelque soit le mode de modération choisi).

    3- mode "intermédiaire": le forum est modéré "dur", mais il peut etre mis à la disposition de certains utilisateurs un (ou plusieurs) mots de passe qui permettent de court-circuiter la modération, et donc d'alléger d'autant la tache des modérateurs.

    le passage d'un mode à l'autre, tout comme la création ou suppression de compte "modérateur", est immédiate et se fait en ligne depuis n'importe quel poste relié à internet (Action Super Administrateur).
    (idem pour toutes les autres options disponibles)

    [ retour index ]

  • 3.2. Page Administration Forum
  • En bas à gauche de chaque message ou de la page index du forum se trouve un lien "Accès Modérateur", une fois la page "Saisie de mot de passe" franchie, vous accédez à la page "Page Administration Forum"
    (si l'option forum est validé sur votre site, vous trouverez aussi le lien "Administration forum" au bas de chaque page "Saisie du mot de passe")

    Rubrique "Liste des message à modérer":
    en cours de rédaction...

    Rubrique "Console Admin - LISTE COMP":
    en cours de rédaction...

    Rubrique "Console Admin - LISTE ARCH":
    en cours de rédaction...

    Rubrique "Console Admin - LISTE LOG_":
    en cours de rédaction...

    Rubrique "Console Admin - EDIT_":
    en cours de rédaction...

    Rubrique "Console Admin - EFF__":
    en cours de rédaction...

    Rubrique "Console Admin - SUPP_":
    en cours de rédaction...

    Rubrique "Console Admin - T_SUPP":
    en cours de rédaction...

    Rubrique "Envoyer un message (direct)":
    en cours de rédaction...

    [ retour index ]


4. Action Super Administrateur
  • 4.1. Généralités
  • en cours de rédaction...

    [ retour index ]

  • 4.2. Page Super Administrateur
  • Au bas de chaque page "Saisie du mot de passe" (voir "Accès Adminstrateur") se trouve un lien "Accès mode Super-Administrateur", une fois la nouvelle page "Saisie de mot de passe (super-admin)" franchie, vous accédez à la page "Page Super Administrateur"

    Rubrique "Création d'une page index - Titre":
    en cours de rédaction...

    Rubrique "Modification du titre d'une page index - Titre":
    en cours de rédaction...

    Rubrique "Modification du titre d'une page index - Nouveau Titre":
    en cours de rédaction...

    Rubrique "Suppression d'une page index - Titre":
    en cours de rédaction...

    Rubrique "Création d'un administrateur - Nom":
    en cours de rédaction...

    Rubrique "Création d'un administrateur - mot de passe":
    en cours de rédaction...

    Rubrique "Création d'un administrateur - 2° saisie":
    en cours de rédaction...

    Rubrique "Suppression d'un administrateur - Nom":
    en cours de rédaction...

    Rubrique "Création d'un SUPERadministrateur - Nom":
    en cours de rédaction...

    Rubrique "Création d'un SUPERadministrateur - mot de passe":
    en cours de rédaction...

    Rubrique "Création d'un SUPERadministrateur - 2° saisie":
    en cours de rédaction...

    Rubrique "Suppression d'un SUPERadministrateur - Nom":
    en cours de rédaction...

    Rubrique "Configuration du site":
    Ce bouton vous donne accès à la Page configuration (1).

    Rubrique "Configuration des scripts":
    Ce bouton vous donne accès à la Page configuration (2).

    Rubrique "Configuration du forum":
    Ce bouton vous donne accès à la Page configuration (forum).

    Rubrique "Statistiques du site":
    en cours de rédaction...

    [ retour index ]

    • 4.2.1. Page Configuration (1)
    • On accède à cette page depuis la "Page Super Administrateur"

      [ retour index ]

    • 4.2.2. Page Configuration (2)
    • On accède à cette page depuis la "Page Super Administrateur"

      [ retour index ]

    • 4.2.3. Page Configuration (forum)
    • On accède à cette page depuis la "Page Super Administrateur"

      Rubrique "Création d'un modérateur - Nom":
      en cours de rédaction...

      Rubrique "Création d'un modérateur - mot de passe":
      en cours de rédaction...

      Rubrique "Création d'un modérateur - 2° saisie":
      en cours de rédaction...

      Rubrique "Suppression d'un modérateur - Nom":
      en cours de rédaction...

      Rubrique "Option modération - Mode modération":
      en cours de rédaction...

      Rubrique "Option modération - Autoriser mot de passe utilisateur":
      en cours de rédaction...

      Rubrique "Option modération - Email modérateur":
      en cours de rédaction...

      Rubrique "Option modération - Nom du modérateur":
      en cours de rédaction...

      Rubrique "Option modération - Titre 'éffacé'":
      en cours de rédaction...

      Rubrique "Option modération - Message 'éffacé'":
      en cours de rédaction...

      Rubrique "Configuration du script - Lien 'Voir l'aide'":
      en cours de rédaction...

      Rubrique "Configuration du script - Autoriser du code html":
      en cours de rédaction...

      Rubrique "Configuration du script - Reprendre le 'titre'":
      en cours de rédaction...

      Rubrique "Configuration du script - Indiquer l'heure":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Lister les messages":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Nombre de sujets...":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Nombre de messages...":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Décalage maximum des réponses":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Afficher haut de page":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Afficher cadre message":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Police":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Taille police":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Couleur police":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Couleur cadre 1":
      en cours de rédaction...

      Rubrique "Configuration de l'affichage - Couleur cadre 2":
      en cours de rédaction...

      Bouton "Valider les modifications":
      en cours de rédaction...

      Bouton "Annuler les modifications":
      en cours de rédaction...

      Rubrique "Page F.A.Q.":
      en cours de rédaction...

      Rubrique "Modérateurs":
      en cours de rédaction...

      Rubrique "mot de passe utilisateur":
      en cours de rédaction...

      Bouton "Valider les modifications":
      en cours de rédaction...

      Bouton "Annuler les modifications":
      en cours de rédaction...

      Bouton "retour page Super Admin":
      en cours de rédaction...

      [ retour index ]


5. F.A.Q.
6. Annexes
  • 6.1. Perl
  • Qu'est ce que Perl?

    Perl est un langage de programmation de haut niveau avec un héritage éclectique écrit par Larry Wall et un bon millier de développeurs. Il dérive de l'omniprésent langage C et, dans une moindre mesure, de Sed, Awk, du shell Unix et d'au moins une douzaine d'autres langages et outils. Son aisance à manipuler les processus, les fichiers et le texte le rend particulièrement bien adapté aux tâches faisant intervenir le prototypage rapide, les utilitaires système, les outils logiciels, les gestionnaires de tâches, l'accès aux bases de données, la programmation graphique, les réseaux, et la programmation web. Ces points forts en font un langage particulièrement populaire auprès des administrateurs système et des auteurs de scripts CGI, mais l'utilisent également des mathématiciens, des généticiens, des journalistes et même des managers. Et peut être vous aussi ?

    Qui supporte Perl? Qui le développe? Pourquoi est-il gratuit?

    La culture d'origine d'Internet et les croyances profondément ancrées de l'auteur de Perl, Larry Wall, ont donné naissance à la politique de distribution gratuite et ouverte de perl. Perl est soutenu par ses utilisateurs. Le noyau, les bibliothèques standards Perl, les modules optionnels, et la documentation que vous êtes en train de lire ont tous été rédigés par des volontaires. Vous pouvez consulter les notes personnelles à la fin du fichier README de la distribution du code source de Perl pour plus de détails. L'historique des versions de Perl (jusqu'à la 5.005) est disponible ici: la page de manuel perlhist.
    En particulier, l'équipe principale de développement (connue sous le nom 'Perl Porters') est une bande hétéroclite d'individus des plus altruistes engagés à faire un logiciel gratuit meilleur que tout ce que vous pourriez trouver dans le commerce. Vous pouvez glaner des informations sur les développements en cours sur news://news.perl.com/perl.porters-gw/ et l'archive Deja sur http://www.deja.com/ en utilisant le groupe perl.porters-gw, ou vous pouvez vous inscrire à la liste de diffusion en envoyant une demande d'inscription à perl5-porters-request@perl.org .
    Bien que le projet GNU inclue Perl dans ses distributions, il n'y a pas à proprement parler de "GNU Perl". Perl n'est pas produit ni entretenu par la Free Software Foundation. Les termes de la licence de Perl sont aussi moins restrictifs que ceux de la licence GNU.

    (extraits de la faq perl disponible en français à l'adresse: http://www.enstimac.fr/Perl/)

    [ retour index ]

  • 6.2. Html
  • hypertexte
    Texte auquel sont rattachées par un lien électronique des informations connexes situées dans d'autres documents que l'on peut afficher en cliquant sur le mot en hypertexte. Par extension, un système hypertexte est un logiciel capable d'afficher ce type de texte et d'assurer des parcours non linéaires

    Hyper Text Markup Language (HTML)
    Langage de description de page avec lequel sont conçues les pages du WWW. Il sert à décrire la présentation de la page, et surtout les liens avec d'autres documents (textes, pages, etc.) situés sur le réseau

    Hyper Text Transfer Protocol (HTTP)
    Protocole de communication utilisé entre les clients et les serveurs du WWW

    [ retour index ]

  • 6.3. FTP
  • File Transfer Protocol (FTP)
    Domaine de l'Internet régi par un protocole relativement simple, qui permet de télécharger des fichiers sans toutefois que l'on puisse les afficher au préalable

    [ retour index ]

  • 6.4. Graphisme
  • en cours de rédaction...

    [ retour index ]

  • 6.5. Copies d'écran
  • en cours de rédaction...

    [ retour index ]

  • 6.6. Liens
  • - Resoo

  • Resoo.org / ResooSite - Aide
    http://www.resoo.org/resoodoc/aide.html (ce document en ligne)
  • Resoo.com
    http://www.resoo.com (l'hébergement de projets ResooSite)
  • - Perl

  • La documentation Perl en français
    http://www.enstimac.fr/Perl/
  • La documentation originale de Perl (5.6.1)
    http://www.perldoc.com/perl5.6/pod/perl.html
  • Le CPAN (Comprehensive Perl Archive Network)
    http://www.perl.com/CPAN
  • perl.com - The source for Perl
    http://www.perl.com/
  • Perl Mongers - The Perl advocacy people
    http://www.perl.org/
  • Online Perl Library
    http://learn.perl.org/library/ (quelques livres en ligne)
  • - Autres

  • GNU's Not Unix!
    http://www.gnu.org/
  • The Apache HTTP Server Project
    http://httpd.apache.org/
  • Mozilla - open source browser
    http://mozilla.org/why/users.html


  • [ retour index ]


resoodoc ©2002-2004 resoo.org / resOOsite