gestion d'un annuaire

Loubechine, Christian -- on Apr. 17 2006, from Chonas l'Amballan
YACS team - responsable support
création site internet et annuaire pro Rhône-Alpes

dans la série yacs peut tout faire

bonjour, la nuit portant conseil et les longs WE aussi, j'aimerais savoir de quelle façon Yacs peut-il gérer un annuaire. La structure même de Yacs avec ses sections et catégories me semble parfaitement adapté à la gestion d'un annuaire. On peut aisement, à partir d'une arborescence de base, saisir des articles correspondant à des entrées d'annuaires. Mais bon, l'interface de saisie et de consultation me semble moins adaptées. La structure de la base l'est moins aussi. Alors voilà je lance l'idée : est-il opportun de développé un module annuaire ?

Christian, tête d'oeuf.

Page bottom

Bernard on Apr. 17 2006
L'une des premières choses à faire, c'est de proposer une mise en page type annuaire, avec un classement alphabétique par lettre : A, B, etc.

Ce besoin a été exprimé aussi par Agnès, et cette nouvelle mise en page devrait être disponible prochainement...

Agnès on Aug. 21 2006
Bernard : Je fais remonter ce fil, parce qu'on a un peu avancé sur cette question.

Nous avons un annuaire dans gresivaudan.org que nous avons structuré autour de sous-sections.

Nous voulions un affichage direct à partir de l'index de l'annuaire, déroulant, pour ne pas avoir systématiquement à cliquer sur les sections pour voir les infos "de base" de chaque entrée. De plus, nous souhaitions y faire apparaître une courte description et un logo.
Ensuite, il y a (ou pas) un certain nombre de pages dans ces sous-sections, et nous souhaitions que cela apparaisse.
Enfin, nous voulions que le lien vers la totalité de la section soit visuellement différencié de la liste des articles présents.

Le test avec le rendu "folder" pour l'index était moyennement satisfaisant, parce qu'il ne renvoyait que le titre de l'article. Du coup, toutes les infos à faire apparaître devaient être saisies dans le titre, ce qui n'était pas du tout idéal.

Nous avons du modifier le skin et attacher un skin particulier à cette section pour que l'affichage soit conforme à nos souhaits.

Allez voir ce que ça donne, et donnez-nous votre avis.

On vous mettra les codes très bientôt à dispo pour qui en veut.

Agnès
Il n'y a pas de problèmes, que des solutions.

Cloubech on Aug. 21 2006
Agnès : pour ma part j'utilise toujours l'option d'affichage "compact - Dans une liste compacte, comme DMOZ." et ca me satisfait tout a fait. Par contre j'ai toujours l'affichage de mon nombre de sections qui est superflu pour moi car j'affiche toujours une liste entière

Ceux qui ne sont pas nos clients ont juste droit à un article avec le minimum vital. Nos clients ont droit à une page plus détaillée voir des sous-sections ...

comme quoi le besoin évolue ...

Pour le moins ton principe est bon également. En fait le coeur du problème réside beaucoup dans la feuille de style et là c'est pas mon fort ...

Bernard on Aug. 22 2006
Agnès : Je suis preneur des codes bien sûr, parce que ce que vous avez fait est très chouette, comme d'hab... J'ai aussi commencé à exploiter est les liens "riches", à la nicetitle, qui affichent plein de choses lorsqu'on les survole. C'est assez efficace aussi. Juste une piste...

Une autre remarque, c'est l'intérêt de s'appuyer sur le binôme overlay/layout. L'overlay pour gérer les données structurées de l'annuaire (nom, prénom, adresse, etc.) Et le layout pour prendre en compte l'overlay dans la mise en page en liste (ce que YACS fait encore imparfaitement).

Dernière chose, il faudra bien un jour créer le layout alphabétique A | B | C etc. parce que c'est un moyen assez efficace de gérer des listes assez longues.

Merci d'avoir relancé le sujet, ça met en évidence le besoin assez urgent de créer un overlay pour la gestion de contact...

Tof on Aug. 22 2006
Bernard :

Pour notre présentation annuaire, je n'ai pas utilisé l'overlay puisque les données sont saisies au niveau de la section... et les behaviours se faisant toujours attendre (si tu as besoin d'une petite main, Bernard, je peux toujours dégager du temps).

Bref j'ai dupliqué notre skin entièrement juste pour utiliser la fonction layout_section() dans le skin.php - le problème étant que toute sous-section d'une entrée de l'annuaire utilisera ce skin sauf si on change les options (de chaque sous-section).

Je mets le code à la fin de ce message.

Avant cela, un petit mot pour Bernard pour lui dire que je n'ai pour l'instant pas eu le temps de faire de retour sur l'utilisation de yacs pour le site apmfrance.com mais que j'y pense tous les jours et que cela devrait bientôt être mûr.

Voici le layout des sections de l'annuaire :

Click to fold/unfold

/*
* Ajout&#233; par Christophe Battarel - altairis - christophe@altairis.fr
 * Ajout fonction layout_section pour affichage annuaire
 * Le but est d'afficher les informations concernant l'organisme
    reces&#233; dans l'annuaire, suivi du titre du dernier article publi&#233;
    et de la mention "Plus d'aricles" si n&#233;cessaire
 * Le titre  contient la raison sociale de l'organisme (ou son nom)
 * L'introduction contient ses coordonn&#233;es (adresse, tel, mel, ...)
 * La description contient la description de l'activit&#233; de l'organisme
 *
 * L'affichage est de type folder, c'est &#224; dire une boite
    d&#233;pliable par un clic sur  le "+" ou le titre de la section
 */
    function layout_section($item, $layout, $capability='?') {
        global $context, $local;
        
        
        switch($layout) {
            case 'decorated':
                // one box per section
                $box['title'] = '';
                $box['text'] = '';
                $elements = array();

                // start the label with family, if any
                if($item['family'])
                    $box['title'] = Skin::strip($item['family'], 30).' - ';

                // use the title to label the link
                $box['title'] .= Skin::strip($item['title'], 50);

                if ( $item['introduction'] != '') $box['text'] =
    Codes::beautify($item['introduction']).BR.'';
                if ($item['description'] != '')  $box['text'] .=
    Codes::beautify($item['description']).BR.'';
                
                include_once $context['path_to_root'].'articles/articles.php';
                $elements = array();
                /* on charge les 2 derniers artiicles publi&#233;s pour n'afficher que
    le premier et la mention "Plus d'articles" si il y en a pllus d'un. */
                $items= Articles::list_by_date_for_anchor('section:'.$item['id'], 0, 2,
    'compact');
                $i = 0;
                if(@count($items)) {
                    foreach($items as $url => $label) {
                        $i++;
                        if ($i == 2) break; // seul le dernier article publi&#233; nous
    int&#233;resse ici
                        $prefix = $suffix = '';
                        if(is_array($label)) {
                            $prefix = $label[0];
                            $suffix = $label[2];
                            $label = $label[1];
                        }
                        $elements[] = $prefix.Skin::build_link($url, $label,
    'article').$suffix;
                    }
                }
                // affichage du dernier article publi&#233;
                if(count($elements))
                    $box['text'] .= '<ul><li>'.implode('</li>'."n".'<li>',
    $elements).'</li></ul>'."n";
                // si il y a d'autres articles on met un lien vers la sous-section pour
    pouvoir consulter tous les articles
                if (count($items) > 1) {
                    include_once $context['path_to_root'].'sections/sections.php';
                    $section_url = Sections::get_url($item['id']);
                    $box['text'] .= Skin::build_link($section_url, 'Plus d'articles >>',
    'decouvrir');
                }

                // affichage d'une boite d&#233;pliable (type folder)
                if ($box['text'] != '') return Skin::build_box($box['title'],
    $box['text'], 'folder');
                else return $box['title'];

            default:
                Skin::debug($layout); //appelle la fonction javascript alert()
        }
    }

Tof

Bernard on Aug. 26 2006
Tof : pour continuer à lever les ambiguités : faudrait-il, pour l'annuaire, avoir un overlay aussi au niveau d'une section ? Les behaviors, eux, ne stockent pas de données supplémentaires.

Tof on Aug. 27 2006
Bernard :

Oui je pense que ça pourrait être intéressant d'avoir les overlays aussi bien au niveau des sections que - pourquoi pas ? - des catégories.

Cela rendrait l'outil plus souple.

Dans le cadre de l'annuaire, on pourrait ainsi définir au niveau de la section des champs "adresse", "tel", "mel", etc.

Ce qui me ramène à une question : que sont les behaviours ? si c'est pour gérer l'affichage d'une section, on a déjà le layout_section du skin. Peux-tu nous en dire plus sur ce projet que tu nous avais présenté - il me semble - comme l'équivalent des overlays des articles ?

Ach, il faut vraiment que je fasse mon CR d'APM pour te donner plein d'idées, de suggestions, et de critiques, lol.

A+

Tof

Bernard on Aug. 28 2006
Tof: Les behaviors sont des classes PHP implémentant l'interface du même nom. Leur invocation et paramétrage se fait à travers un nouveau champ à lignes multiples (un Textarea) dans les sections.

Par exemple, pour afficher une licence Creative Common avant le téléchargement d'un fichier, on ajoutera la ligne suivante dans la section:

agree_on_file_access creative_common.txt

Ceci provoque, lors du téléchargement (files/fetch.php), le chargement du script bevahiors/agree_on_file_access.php. Ce dernier affiche le fichier behaviors/agreements/creative_common.txt, puis des boutons pour enregistrer l'approbation par le surfeur. Ensuite seulement l'accès au fichier est autorisé.

Le code qui permet tout cela est écrit et fonctionnel, et je l'aurais livré depuis plus d'une semaine si je ne m'étais pas lancé à corps perdu dans le bétonnage de YACS (support safe mode, etc.)

8 comments

Rate this page
Posted by Cloubech on Apr. 17 2006, commented by Bernard on Apr. 17 2006, (popular)