How to use Zig4u - Comment utiliser Zig4u

Zig4u

Présentation

Zig4u (pour zig4u is good for you) est une application Zope très simple qui permet la mise en place d'un intranet de gestion documentaire. Elle est très fortement inspirée de l'exemple intranet du livre vert dont elle reprend une partie du code (merci pj Grizel). La lecture du livre vert (chapitre 15) permettra donc à chacun de l'adapter à ses propres besoins.

Cette gestion documentaire se fait de manière interactive très simple et permet de gérer dossier, sous dossiers et documents avec recherche par mots-clés. Elle utilise toutes les fonctionnalités les plus sympatiques de Zope ce qui permet en terme de sécurité de déléguer la gestion d'un dossier ou d'un sous-dossier.

Installation

Zig4u ne contient que des éléments simples de Zope, aucun autre produit n'est nécessaire. Pour installer Zig4u, il suffit de placer le fichier zig4u.zexp dans le répertoire import de Zope, puis dans Zope au niveau du dossier root folder faire un import de zig4u.zexp. C'est tout zig4u est déjà fonctionnel.

Utilisation

Tapez l'adresse de Zig4u http://monserveur:monport/zig4u

L'image de zig4u se décompose en 5 parties. Nous verrons plus tard comment modifier chacune d'elles.

En haut à gauche le logo et à côté du logo le bandeau d'information. Ces 2 informations peuvent êtres simplement adaptées à votre site.

En dessous du bandeau, le menu est composé à l'origine de 2 dossiers. A chaque fois que vous rajouterez un dossier, il ira se placer au menu.

Toute la partie centrale est réservée pour l'affichage des documents.

La dernière partie, barre de gauche comprend 3 boites:

• une boite actualité et une boite dossiers ouverts. Ces deux boites contiennent des informations modifiables simplement. De plus ces informations évoluent en fonction du contexte.

• Une boite de commandes dans laquelle par défaut vous avez la fonction recherche et le bouton espace sécurisé. Cette boite contiendra les boutons de modification de l'espace documentaire.

Votre site zig4u est consultable par tous et modifiable par certains. Pour passer en modification, il faut entrer dans l'espace sécurisé avec la touche prévue à cet effet.

Un code utilisateur zig4u avec pour mot de passe zig4u est créé (il faudra penser à le changer).

Voilà, vous êtes signé en tant que manager, vous avez donc tous les droits. Si vous aviez un profil d'utilisateur de type «administrateur », vous n'auriez pas les boutons « gestion utilisateurs » et « version».

Tous les boutons sont contextuels, ils s'appliquent toujours au niveau dans lequel vous êtes, ici en l'occurrence vous êtes dans la racine de zig4u, la gestion des utilisateur, des actualités, ... s'appliquera donc à l'ensemble du site zig4u.

Comme vous êtes à la racine, vous ne pourrez rajouter que des dossiers qui viendront se mettre au menu sous le bandeau. Le dossier initial de zig4u s'appelle « arch_contenu », il n'est jamais au menu de zig4u, mais quand vous êtes à la racine, vous voyez apparaître un bouton « page accueil » vous permettant d'aller modifier son contenu.

Faites ajout dossier:

Donnez un nom de dossier qui ne contiendra que des caractères alphabétiques, numériques et le caractère souligné (pas d'espace ni de caractères spéciaux). C'est le nom du dossier qui servira à l'adresse html pour la navigation. Le titre au menu apparaitra dans la barre de menu sous le bandeau.

Le titre du dossier est utilisé comme commentaire, il apparaîtra en haut de la zone documentaire dès que le dossier sera ouvert.

Dans le titre au menu et le titre du dossier vous avez le droit à tout caractère.

Une fois le nom du dossier saisi, vous ne pourrez plus changer celui-ci, mais vous pourrez changer sans problème le titre au menu.

Voilà vous pouvez remarquer sur l'image suivante que vous avez rajouté un dossier au menu. En allant cliquer sur le nom de ce dossier vous voyez apparaître maintenant des boutons supplémentaires.

Vous voyez sur la barre d'adresse que vous êtes maintenant sur le dossier demo et le travail des boutons s'appliquera à ce dossier.

Si vous ajoutez maintenant un dossier ce sera un sous dossier de demo. De même si vous ajoutez un utilisateur, de l'information, cela ne s'appliquera qu'à votre dossier.

Voyons l'ajout d'un document:

Un document est un document qui existe sur votre poste de travail. L'utilisateur, s'il possède les outils nécessaire à l'affichage de ce document pourra directement visualiser ce document. Dans tous les cas, il pourra le sauvegarder sur son poste de travail.

Le nom du document et le titre du document sont géré comme dans le dossier vu précédemment.

La zone contenu du document apparaîtra dans le corps central de votre intranet, il faut être le plus explicite possible. Dans la zone mots clés, mettez tous les mos clés qui serviront à la recherche. Aller chercher le fichier que vous souhaitez mettre en ligne grâce à la touche parcourir.

Si dans la zone contenu vous indiquez « $HTML » (en majuscule), le contenu du fichier sera affichée directement au sein de la zone contenu, (plutôt que lke résumé) dans ce cas votre fichier devra être affichable par le navigateur.

Voilà votre nouveau document est créé le code « modif» entre parenthèses vous servira à aller modifier le titre, le contenu, les mots clés ou le fichier de votre document.

Contrairement au dossier, vous n'entrez jamais dans un document et vous n'avez donc pas de menu contextuel pour un document.

Voici maintenant ce que vous avez en cliquant sur le bouton « ajout dossier ». Comme vous êtes à l'intérieur d'un dossier c'est un sous dossier que vous aller créer, un sous dossier contient comme un document une zone contenu et une zone mots-clés.

Et voilà le résultat:

En cliquant sur le bouton « gestion actualités » vous vous retrouvez directement sur les actualités contextuelles du dossier. Vous pouvez très simplement ajouter des actualités contextuelles ou en supprimer. Noubliez pas que ces actualités vont se cumuler aux actualités des dossiers de niveau supérieur.

C'est simple non ! C'est tout pour la partie administrateur, qui permet déjà de tout modifier le site. Voyons maintenant la partie Manager puis la modification du site. Attention: maintenant il va falloir connaître un minimum de Zope pour avancer.

Utilisation avec un profil manager

Vous le voyez, là vous êtes en Zope manager, cette partie n'a pas été adaptée aux utilisateurs pour l'instant (et oui faut bien laisser un peu de boulot aux informaticiens).

De la même façon, la gestion des utilisateur vous fera enter au niveau du contexte dans la gestion du dossier des utilisateurs. Si vous demandez à accéder à la gestion des utilisateurs en étant à l'intérieur d'un sous-dossier, vous ne vous occuperez que des utilisateurs de ce sous-dossier. Ceci va vous permettre d'autoriser, mais aussi d'interdire, un sous dossier en gestion « administration », voire « manager ».

Zig4u vous permet aussi d'utiliser très simplement la gestion de version. Zig4u a une version test par défaut mais si vous connaissez zope, ajooutez d'autres versions dans le répertoire racine de zig4u et elles seront accessibles par leur bouton.

Vous êtes sur l'espace management, faites retour page précédente et rafraichir, vous aurez maintenant l'indication de la version dans laquelle vous vous trouvez et un bouton pour la quitter si vous le désirez.

La couleur dans laquelle tout cela s'affiche n'est pas belle, je le reconnais, mais c'est très visible.

Vous utilisez à ce niveau toutes les capacités de gestion de version de zope. La prise en compte des modifs se fera en recliquant sur le bouton de version.

Voilà nous avons vu tous les points accessibles de Zig4u.

Mais Zig4u n'est qu'un départ pour vous, vous allez vouloir l'adapter à vos propres besoins alors Zopez maintenant!

Les principaux objets de Zig4u à modifier

Zig4u n'est pas un produit mais un exemple modifiable, si vous voulez un produit paramétrable allez voir plutôt l'excellent Popoto ou si vous êtes plus avancé CMF.

Zig4u va lui vous servir à débuter.

Changez le logo en allant éditer l'objet « html_logo »

Changez le bandeau en modifiant « html_bandeau »

Allez mettre votre domaine de mail en modifiant « html_cartouche » (et oui il faudrait pas que tous les mails m'arrivent !!)

Avec ces trois modifs vous avez déjà votre propre site.

Si le nom zig4u ne vous plait pas, vous pouvez le renommer, mais allez ensuite changer les objets dans lesquels zig4u est référencé en dur ! (un bon moyen pour tester la commande find)

Si la mise en forme ne vous plaît pas, allez voir du côté de html_contenu_dossier pour la partie centrale et puis oubliez pas que le livre vert vous permettra de maitriser le tout.

Zopez bien !

C'est vrai pour Zig4u ça roule au GPL bien sûr et pour les commentaires

c'est mailto://jacques.adamski@ch-roubaix.fr