Aide-mémoire et tableaux de synthèse. PMB Services PMB

Vous trouverez ci-dessous des informations concernant PMB. Ce manuel d'utilisation explique comment transformer l'OPAC en un portail documentaire. Il traite de la configuration du contenu éditorial et des pages, de l'utilisation des modules, des cadres et des feuilles de style CSS. Il fournit des conseils pratiques pour la construction du portail, ainsi que des exemples d'OPAC.

PDF Télécharger

Document

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 176

IDE

MÉMOIRE ET TABLEAUX DE SYNTHÈSE

Mon but n’est pas d’augmenter artificiellement le nombre de pages, et je sais que je n’ajoute ici que peu d’infos nouvelles par rapport à ce que j’ai déjà dit. Toutefois, j’ai décidé de fournir un résumé schématique sur certains sujets fondamentaux :

Les liens entre les modules, cadres et pages du portail Les templates Django

Les balises HTML Les requêtes SQL

En effet, les commentaires sur ces thèmes sont disséminés un peu partout, c’est pourquoi j’ai préféré regrouper les infos essentielles dans une synthèse. Ainsi, vous ne devrez pas parcourir plusieurs chapitres à la recherche de l’une ou l’autre explication ;-)

Liens entre modules, cadres et pages

ISTE DES MODULES DISPONIBLES

J’ai regroupé ces modules en diverses catégories, afin de donner une vue d’ensemble.

Les chapitres

Modules, cadres et pages

Exemples supplémentaires

contiennent des explications détaillées sur de nombreux modules.

PMB 4.0.13 PMB 4.1 Certains modules sont fondamentaux, car ils génèrent le cadre principal d’une des pages-outils du portail ; ils sont en général liés à une variable d’environnement



Module rubrique  variable id_rubrique  page qui affiche une rubrique



Module article  variable id_article  page qui affiche un article



Module notice  variable id_notice  page qui affiche une notice



Module agenda  variable id_date  page qui affiche une liste d’événements



Module liste d’articles  pas de variable  page qui affiche le résultat d’une

recherche dans le contenu éditorial : une liste d’articles

Listes présentées de manière « classique » ou en carrousel

 liste d’articles au choix : affichage sous forme de liste ou de carrousel

 liste de notices (défilement horizontal, vertical, en fondu enchaîné)

 liste de rubriques

 liste de bannettes un seul mode d’affichage : la liste

 liste d’étagères

 carrousel de notices  un seul mode d’affichage : le carrousel

Aide à la navigation

 menu créé sur base du contenu éditorial ou dans l’interface d’administration

 fil d’Ariane (fournir des liens en arrière sur les pages déjà parcourues)

Aide à la recherche interne ou externe

 recherche interne (dans le contenu bibliographique et/ou éditorial)

 recherche externe : interrogation SPARQL (accès au Web sémantique)

Insertion directe

 agenda (calendrier des activités organisées par la bibliothèque)

 code HTML (ajouter un cadre qui contient du code HTML)



éléments de l’OPAC (ex. infopages, navigateur de périodiques)

Insertion d’éléments externes à la base

 flux RSS

 portfolio (gérer une collection de documents numériques non catalogués)

5 modules doivent être configurés avant usage



Agenda

Définir les calendriers



Interrogation SPARQL (recherche externe)

Définir les sources de données



Menu : seulement s’il s’agit du menu créé dans l’interface d’administration o

Inutile pour un menu basé sur le contenu éditorial (rubriques) : on peut l’employer tout de suite



Portfolio

Paramétrer un répertoire d’upload (onglet Administration) et définir les Collections numériques (onglet Portail)



Recherche interne

Définir les types de recherche (contenu éditorial et bibliographique) et les pages de destination

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 177

NTERCONNEXION ENTRE LA PAGE D

’

ACCUEIL ET LES AUTRES PAGES

Liste de quelques modules et cadres du portail visibles dans la page d’accueil – dans les zones introduction et page centrale

En noir (police standard) : le nom du cadre

En rouge et en italiques : le nom du module

Menu

Menu

Carrousel d’articles (accueil)

Liste d’articles

Liste d'articles - sélections (accueil)

Liste d’articles

Liste de brèves (accueil)

Liste d’articles

Barre de recherche simple

Recherche

Agenda (accueil)

Agenda

Carrousel de notices (nouveautés - accueil)

Liste de notices

Si les pages-outils n’existaient pas, si elles ne contenaient pas le cadre fondamental lié à leur fonction, s’il n’y avait pas des variables d’environnement et des champs personnalisés pour transmettre des paramètres, si les templates Django ne créaient pas des URL de destination et ne spécifiaient pas ce qui est cliquable, il serait inutile d’insérer des cadres en page d’accueil, soit on n’irait nulle part ailleurs, soit on irait quelque part mais on ne pourrait rien y faire !

Interconnexion entre ces cadres visibles en page d’accueil et les pages-outils du portail

Il n’y a pas de variable d’environnement liée à la page qui affiche une liste d’articles (le résultat d’une recherche dans le contenu éditorial).

Menu

Cadres 

On ne va jamais « spontanément » vers une page, quelle qu’elle soit

C’est dans chaque cadre qu’on construit le lien vers « la suite du parcours ».

Variable d’environnement

 Pages de destination

(Le menu de la démo n’affiche que des titres de rubriques)

id_rubrique

Page qui affiche une rubrique

Clic sur un titre de rubrique

Carrousel d’articles (accueil)

Clic sur un article du carrousel

Liste d’articles - Sélections (étagères)

Clic sur un article de la liste

id_article

 Si on clique sur une sous-rubrique  page qui affiche une rubrique

 Si on clique sur un article  page qui affiche un article

Page qui affiche un article

L’aspect varie en fonction du type de

contenu de l’article (ce paramètre est

Coup de cœur :

identifiant_notice

Sélection :

etagere

Evénement (date précise) :

date

transmis par un champ personnalisé)

Evénement (période) :

date_debut, date_fin

Information : pas de champ personnalisé

Liste de brèves – pas de clic possible Pas de lien Aucune page de destination prévue dans le template de ce cadre

Barre de recherche dans les articles

Si on effectue une recherche

Pas de variable

Page qui affiche une liste d’articles : le résultat d’une recherche

 Si on clique sur un article de la liste  page qui affiche un article

Agenda (calendrier : choix d’une date)

S’il y a un seul événement

S’il y a plusieurs événements

Carrousel de notices (nouveautés)

Clic sur une notice du carrousel

id_article id_date id_notice

Page qui affiche un article

Page qui affiche une liste d’événements (module agenda)

 Si on clique sur un événement de la liste  page qui affiche un article

Page du portail qui affiche une notice

 Si on clique sur le permalink  page de l’OPAC qui affiche une notice

Ces variables se ressemblent : leurs noms sont similaires, et les questions de départ identiques : quelle notice ? ou quelle date ?

Mais elles n’ont pas la même fonction, ne les confondez pas !

id_notice

id_date

sont 2

variables d’environnement

 page qui affiche une notice ou page qui affiche une liste d’événements

identifiant_notice

date

sont 2

champs personnalisés

 types de contenu des articles : Coup de cœur ou Evénement à une date

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 178

YNTHÈSE DES PAGES

OUTILS DU PORTAIL

Vous pouvez cliquer sur n’importe quelle rubrique visible par exemple dans le menu principal

Le cadre du menu principal contient la question « Construction du lien vers une rubrique ? »

Et on a répondu « aller vers la page du portail qui affiche une rubrique »

C’est une page où on voit le contenu d’une rubrique, quel que soit son numéro d’id



Dans la démo, la page qui affiche une rubrique a le numéro d’id 6 (ce numéro ne change pas)

 la variable d’environnement id_rubrique transmet le numéro d’id de la rubrique à afficher (ce numéro varie donc)

 http://127.0.0.1/pmb4perso/opac_css/index.php?lvl=cmspage&pageid=6&id_rubrique=3

Afficher le contenu d’une rubrique, c’est montrer le titre et le résumé, et aussi les sous-rubriques et/ou articles qui en dépendent.

Le cadre « Afficher une rubrique » contient dès lors deux fois la question « Construction du lien vers ? »

« Construction du lien vers une rubrique ? » - « Construction du lien vers un article ? »



Un clic sur une sous-rubrique vous mène vers la page qui affiche une rubrique (id_rubrique change bien sûr de valeur)



Un clic sur un article vous mène vers la page qui affiche un article

Vous pouvez cliquer sur n’importe quel article visible dans une liste ou un carrousel d’articles

(sauf les Brèves en page d’accueil : ce template Django est particulier, car il ne prévoit pas de lien vers une autre page)

Le cadre de la liste d’articles ou du carrousel d’articles contient la question « Construction du lien vers un article ? »

Et on a répondu « aller vers la page du portail qui affiche un article et une liste de notices »

C’est une page où on voit le contenu d’un article, quel que soit son numéro d’id, et quel que soit son type de contenu éditorial



Dans la démo, la page qui affiche un article a le numéro d’id 4 (ce numéro ne change pas)



la variable d’environnement id_article transmet le numéro d’id de l’article à afficher (ce numéro varie donc)

 http://127.0.0.1/pmb4perso/opac_css/index.php?lvl=cmspage&pageid=4&id_article=9



Le template Django du cadre « Afficher un article » tient compte de la diversité des types de contenu éditorial

La page du portail qui affiche un article peut prendre des aspects différents.

Cela varie en fonction du type de contenu de l’article, et des autres cadres présents éventuellement dans cette page.

En effet, cette page ne contient pas uniquement le cadre « Afficher un article », il y en a deux autres.

Module Liste de notices  « Etagère associée à un article » et « Notices dans les mêmes catégories qu’un article »

Type Coup de cœur

Ce type d’article est lié à une notice

champ personnalisé :

identifiant_notice

On voit 1 ou 2 cadres : l’article et (parfois) un carrousel de notices sur le même sujet.

Type Evénement à une date

Ce type d’article est lié à une date précise

champ personnalisé :

date

On voit 1 ou 2 cadres : l’article et (parfois) un carrousel de notices sur le même sujet.

Type Sélection

Ce type d’article est lié à une étagère

champ personnalisé :

etagere

On voit deux cadres : l’article et la liste des notices de cette étagère.

En théorie, on pourrait aussi voir le 3 e

cadre : le carrousel de notices sur le même sujet.

Ce sont les 5 types de contenu définis dans la démo.

Voir configuration préliminaire du

Type Information

Ce type d’article n’est lié à aucun champ

personnalisé.

On voit 1 ou 2 cadres : l’article et (parfois)

Type Evénement sur une période

Ce type d’article est lié à deux dates précises :

la date de début et la date de fin de l’activité champs personnalisés : date_debut, date_fin

On voit 1 ou 2 cadres : l’article et (parfois) un

contenu éditorial

un carrousel de notices sur le même sujet. carrousel de notices sur le même sujet.

Le nom complet « page qui affiche un article et une liste de notices » se justifie souvent, mais pas dans tous les cas.

En effet, on voit toujours un article, mais pas nécessairement le contenu d’une étagère ou un carrousel de notices.



La présence de l’étagère liée à une liste de notices n’est possible que si l’article est de type Sélection, si on a enregistré le numéro d’id d’une étagère (dans le champ personnalisé lié à ce type d’article) … et si l’étagère contient des notices !



Le carrousel de notices sur le même sujet peut apparaître de manière automatique, quel que soit le type de contenu de

l’article. Sa présence éventuelle dépend des catégories communes à l’article et à certaines notices de la base. Ce carrousel est donc créé de manière dynamique, sur base des liens entre le contenu éditorial et le contenu bibliographique.

Ne confondez pas ces variables !

Leurs noms sont similaires, et les questions de départ identiques : quelle notice ? ou quelle date ?

id_notice

id_date

sont 2

variables d’environnement

 page qui affiche une notice ou page qui affiche une liste d’événements

identifiant_notice

date

sont 2

champs personnalisés

 types de contenu des articles : Coup de cœur ou Evénement à une date

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 179

Vous pouvez cliquer sur n’importe quelle notice visible dans un carrousel de notices.

Le cadre de ce carrousel contient la question « Construction du lien vers une notice ? »

Et on a répondu « aller vers la page du portail qui affiche une notice »

C’est une page où on voit le contenu d’une notice, quel que soit son numéro d’id



Dans la démo, la page du portail qui affiche une notice a le numéro d’id 7 (ce numéro ne change pas)



la variable d’environnement id_notice transmet le numéro d’id de la notice à afficher (ce numéro varie donc)

 http://127.0.0.1/pmb4perso/opac_css/index.php?lvl=cmspage&pageid=7&id_notice=88



Dans la démo, le cadre « Afficher une notice » montre une version abrégée de la notice, et aucun champ lié aux exemplaires



C’est pourquoi on affiche (à la dernière ligne) le permalink afin de consulter la notice et les exemplaires dans l’OPAC

La démo propose parfois aussi d’aller directement vers la page de l’OPAC qui affiche une notice

La liste de notices (étagère associée) et l’article de type « Coup de cœur » suggèrent de voir le document dans le catalogue, et contiennent donc un lien (le permalink) vers la page de l’OPAC qui affiche une notice.

 http://127.0.0.1/pmb4perso/opac_css/index.php?lvl=notice_display&id=88

Mais ce n’est pas un parcours obligatoire ! Ce que je viens d’expliquer ci-dessus, c’est le mode de fonctionnement dans la démo.

Dans votre portail, vous ne devez pas nécessairement faire les mêmes choix que dans la démo.

Ex. vous pouvez décider qu’un carrousel de notices mène directement vers la page de l’OPAC qui affiche une notice, sans transiter par la page du portail qui affiche une notice. Il suffit de modifier le paramétrage du carrousel de notices.

Vous pouvez cliquer sur n’importe quelle date visible dans l’agenda (en page d’accueil)

La page du portail qui affiche une liste d’événements est une page où on voit une série d’événements, quelle que soit la date choisie … mais à condition qu’il y ait des articles de type Evénement pour annoncer les activités !!

Attention ! On ne va pas nécessairement vers la page qui affiche une liste d’événements !

En effet, la date sélectionnée dans l’agenda peut être liée à zéro, une ou à plusieurs activités qui se déroulent précisément à la date choisie, ou qui s’étalent sur une période qui englobe la date choisie.

Le cadre « agenda » visible en page d’accueil contient dès lors deux fois la question « Construction du lien vers ? »

« Construction du lien vers un événement ? » - « Construction du lien vers plusieurs événements ? »



aucun événement

n’est prévu pour cette date, rien ne se passe ! On reste dans la page où on voit le calendrier.



un seul événement

est prévu pour cette date, on va directement

vers la page qui affiche l’article lié à cet événement



Dans la démo, la page qui affiche un article a le numéro d’id 4 (ce numéro ne change pas)



la variable d’environnement id_article transmet le numéro d’id de l’article à afficher (ce numéro varie donc)

 http://127.0.0.1/pmbv4perso/opac_css/index.php?lvl=cmspage&pageid=4&id_article=1



Si plusieurs événements sont prévus pour cette date, on va vers la page qui affiche une liste d’événements



Le cadre Liste d’événements est créé à partir du module agenda.



Dans la démo, la page qui affiche une liste d’événements a le numéro d’id 9 (ce numéro ne change pas)



la variable d’environnement id_date transmet la date sélectionnée (cette date varie donc)

 http://127.0.0.1/pmbv4perso/opac_css/index.php?lvl=cmspage&pageid=9&id_date=2013-01-09



Ensuite, si on clique sur le logo d’un événement, on ira vers la page qui affiche l’article adéquat

Les dates des événements ne sont pas le seul critère qui détermine l’affichage ou non de tel ou tel article de type Evénement !

Le statut de publication d’un article et ses dates de publication ont aussi un impact filtrant !

Voir configuration du contenu éditorial

Vous ne voyez donc pas tous les articles, seulement ceux dont le statut est « publié » et dont les dates de publication sont valides.

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 180

Vous pouvez effectuer une recherche dans le contenu éditorial, si la barre de recherche a été configurée en ce sens

La question « Construction du lien vers ? » n’est pas posée dans le formulaire de création de ce cadre.

C’est dans l’interface d’administration que vous sélectionnez la page du portail qui affiche le résultat d’une recherche.

C’est une page où on voit la liste des articles qui répondent au critère de recherche.



Dans la démo, la page qui affiche le résultat d’une recherche dans les articles a le numéro d’id 11 (ce numéro ne change pas)



Il n’y aucune variable d’environnement liée à cette page

 http://127.0.0.1/pmbv4perso/opac_css/index.php?lvl=cmspage&pageid=11



Si un ou plusieurs articles contiennent le(s) mot(s) recherché(s), on voit le titre et le résumé de cet article (ou de ces articles)



Un clic sur un de ces articles mène vers la page qui affiche un article.



Sinon, on voit le message « Pas de résultats » et on propose d’effectuer une recherche dans le catalogue.

Le mot recherché dans le contenu éditorial n’est pas le seul critère qui détermine l’affichage ou non de tel ou tel article !

Le statut de publication d’un article et ses dates de publication ont aussi un impact filtrant !

Voir configuration du contenu éditorial

Vous ne voyez donc pas tous les articles, seulement ceux dont le statut est « publié » et dont les dates de publication sont valides.

Vous pouvez effectuer une recherche dans le contenu bibliographique, si la barre de recherche a été configurée en ce sens

La question « Construction du lien vers ? » n’est pas posée dans le formulaire de création de ce cadre.

C’est dans l’interface d’administration que vous sélectionnez la page de l’OPAC qui affiche le résultat d’une recherche.

C’est une page où on voit la liste des notices qui répondent au critère de recherche.



La page qui affiche le résultat d’une recherche dans les notices correspond forcément à une adresse de type OPAC

 http://127.0.0.1/pmbv4perso2/opac_css/index.php?lvl=more_results



Si une ou plusieurs notices contiennent le(s) mot(s) recherché(s), on voit la liste des notices, qu’on peut déplier si nécessaire.



Un clic sur le permalink d’une notice mène vers la page de l’OPAC qui affiche cette notice dans son intégralité.



Sinon, on propose de faire une suggestion d’achat, ou bien d’interroger des sources externes.

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 181

Templates Django

Interface d’administration - Vues et templates

Exemple : module Liste d’articles – Vue : template Django avec lien - On a enregistré 4 modèles de template

Choix de la vue Choix du template Définition du template

Exemple : module Liste d’articles – Vue : carrousel - On a enregistré 1 modèle de template

Choix de la vue Choix du template Définition du template

Pour agrandir le cadre, amener le curseur dans le coin inférieur droit.

Une flèche bidirectionnelle apparaît.

La « vue » a un sens plus global que le template : c’est une manière générale d’afficher les données.

Pour chacune de ces vues, on peut prévoir un ou plusieurs templates, afin de diversifier la présentation.

Modules

ÉMO DU PORTAIL

ISTE DES MODULES

DES TEMPLATES

JANGO ET DES CADRES OÙ ILS SONT EMPLOYÉS

Templates Django Cadres où ces templates sont employés

Article

Notice

Rubrique

3 modules de base : un article - une notice - une rubrique

Affichage d’un article

 Cadre principal de la page qui affiche un article

Affichage d’une notice

 Cadre principal de la page qui affiche une notice

Affichage d’une rubrique

 Cadre principal de la page qui affiche une rubrique

Vues Templates Django Cadres où ces templates sont employés

Templates Django avec lien

Module liste d’articles

Liste d’articles – Sélections – Nouveautés

Sélection de nouveautés (symbolisées par les étagères)

Liste de brèves

Liste d’articles – Résultat d’une recherche dans les articles

Liste d’articles – Recherche dans le catalogue

Actualités en page d’accueil

Liste de brèves

 Cadre principal de la page qui affiche le résultat d’une recherche dans le contenu éditorial

Articles dans les mêmes catégories qu’une notice

Carrousel d’articles d’actualité

Carrousel

Vue Django

Vue en carrousel

Liste de notices

Module liste de notices

Notices d’une étagère associée à un article

Notices du même auteur qu’une notice

Notices du même auteur

Notices similaires

Notices sur la même étagère (cote de rangement proche)

Nouveautés en page d’accueil

Notices dans les mêmes catégories qu’un article

N.B. Ces 2 templates ne sont pas illustrés dans la démo.

Notices – Carrousel de nouveautés

Notices dans les mêmes catégories qu’un article

(même sujet)

Liste d’événements

Module agenda

Affichage d’une liste d’événements à partir de l’agenda

 Cadre principal de la page qui affiche une liste d’événements

Conclusion : à chaque cadre illustré dans la démo correspond au moins un template sauvegardé dans l’interface d’administration.

Comme vous pouvez le constater, tous les cadres et templates illustrés dans la démo ont été commentés dans ce manuel !

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 182

ISTE DES INSTRUCTIONS ET FONCTIONS DES TEMPLATES

JANGO

Les instructions entre {% %}

Les boucles de répétition

Exemple {% for article in articles %} … {{article.title}} … {{article.resume}} … {{article.content}} … {% endfor %}

Liste d’articles (template Django avec lien)

{% for article in articles %}

Article du contenu éditorial

{% for record in records %}

Liste de notices (vue Django ou carrousel)

Carrousel de notices

Carrousel d’articles

Carrousel de rubriques

Liste de rubriques (template Django avec lien)

Liste des sous-rubriques d’une rubrique parente

Agenda (vue d’une liste d’événements)

Liste d’étagères

Liste de bannettes

Pour toutes les listes de notices

Pour tous les carrousels

{% for section in sections %}

{% for child in children %}

{% for event in events %}

{% for shelve in shelves %}

A record = enregistrement

Suivant le cas, record =

une notice, un article ou une rubrique

Section = rubrique du contenu éditorial

Dans ce contexte, a child = une sous-rubrique

An event = un événement

A shelf (pluriel shelves) = une étagère

{% for bannette in bannettes %}

Les bannettes de la DSI

Contexte : un article est lié à une étagère.

On affiche l’article, et en-dessous, la liste des notices contenues dans cette étagère

N.B. J’ai abrégé le contenu du template, j’ai gardé les instructions essentielles pour comprendre le sens de la condition.

Les conditions : 2 exemples concrets

{% if records %}

<h3>Toutes les nouveautés</h3>

{% endif %}

{% for record in records %}

{% endfor %}

S’il y a des enregistrements (= notices) à afficher

On affiche le titre « Toutes les nouveautés »

Fin de la condition

Boucle qui va de la 1 e

à la dernière notice

On affiche le contenu de la notice

Fin de la boucle

La condition {% if records %} {% endif %} est nécessaire dans cet exemple

Inutile d’afficher le titre « Toutes les nouveautés » s’il n’y a pas d’étagère associée à l’article ou si elle est vide !

Contexte : page  résultat de recherche

On cherche un mot dans les articles. Si on le trouve, on affiche la liste des articles concernés.

N.B. J’ai abrégé le contenu du template, j’ai gardé les instructions essentielles pour comprendre le sens de la condition.

{% if articles %}

{% for article in articles %}

….

{% endfor %}

{% else %}

Pas de résultats

{% endif %}

S’il y a des articles à afficher

Boucle qui va du 1 er

au dernier article

On affiche la version abrégée (titre + résumé)

Fin de la boucle

Sinon

On affiche le message « Pas de résultats »

Fin de la condition

La condition {% if articles %} {% else %} {% endif %} est nécessaire dans cet exemple

On a une boucle qui va du 1 er

au dernier article seulement si on a trouvé le mot quelque part dans le contenu éditorial !

Et en toute logique, le message « Pas de résultats » n’a de sens que dans le cas d’une recherche infructueuse !

Condition « simple » : si … alors …

On n’envisage qu’un seul cas :

si la condition est vérifiée

Il n’y a rien à faire dans le cas contraire

{% if true %} Si la condition est vérifiée

Instruction à exécuter

{% endif %} Fin de la condition

Les conditions : synthèse schématique

Condition « si … alors … sinon … »

On peut imbriquer 2 conditions l’une dans l’autre

On envisage les 2 termes de l’alternative :

si la condition est vérifiée

si elle ne l’est pas

{% if true %} Si la condition est vérifiée

Instruction n° 1

{% else %} Sinon

Instruction n° 2

{% endif %} Fin de la condition

{% if true %} Si la condition n° 1 est vérifiée

Instruction n° 1

{% if true %} Si la condition n° 2 est vérifiée

Instruction n° 2

{% else %} Sinon

Instruction n° 3

{% endif %}

Fin de la condition n° 2

{% endif %} Fin de la condition n° 1

On symbolise en général une condition Django de cette manière :

(% if true %}  si c’est vrai, si la condition est vérifiée

On peut effectuer les tests classiques de comparaison

if {{variable1}} == {{variable2}} if {{variable1}} < {{variable2}} if {{variable1}} != {{variable2}} if {{variable1}} <= {{variable2}}

Par convention == signifie “égal à" (double signe =) if {{variable1}} > {{variable2}} if {{variable1}} >= {{variable2}}

Par convention != signifie “différent de"

On peut employer les opérateurs booléens habituels : and or not

if {{variable2}} >= {{variable1}} and {{variable2}} <= {{variable3}}

Infos complémentaires : https://docs.djangoproject.com/en/1.8/ref/templates/builtins/

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 183

Une fonction supplémentaire : limitstring

PMB a ajouté une fonction aux templates Django de base, la fonction limitstring

Attention à la syntaxe ! Le tout doit être entre {{ }}

Il faut une barre verticale | entre la variable et limitstring

La fonction limitstring permet de limiter la longueur d’une chaîne de caractères. Exemple {{record.title | limitstring,45,"..." }}

Cela signifie que la longueur du texte à afficher (le titre de la notice, record.title) sera limitée à 45 caractères, et que les caractères manquants seront remplacés par le texte entre guillemets (les 3 petits points).

Le découpage se fait à l’aveugle, et le résultat final est plus ou moins heureux suivant le cas = suivant le texte à afficher !

Si vous avez une série de titres assez longs dans un carrousel de notices, cette fonction est fort utile.

Bien entendu, son rôle n’est pas limité aux carrousels, elle peut aussi servir en d’autres circonstances.

ARIABLES UTILISABLES DANS LES TEMPLATES DU PORTAIL

Les noms des variables entre {{ }}

Les variables utilisables dans les templates ont un lien avec les champs de la base de données ou avec le contenu éditorial

Le sens de certaines variables comme {{article}} ou {{section}} est évident.

Mais …

Tous les carrousels (notices, articles, rubriques) emploient la boucle {% for record in records %}

Toutes les listes de notices (vue Django ou carrousel) emploie la boucle {% for record in records %}

La variable {{record}} a donc plusieurs significations : elle peut désigner une notice, un article ou une rubrique.

{{title}}

Le titre de l’article

Le titre de la rubrique

Le titre de l’enregistrement

Suivant le cas, titre de la notice, de l’article ou de la rubrique

Le titre de l’événement (Le terme événement a un sens global dans ce contexte : article qui décrit une activité à une date ou sur une période)

{{resume}}

Le « résumé » de l’article = le chapeau de l’article

Le « résumé » de la rubrique

Le « résumé » de l’enregistrement

Suivant le cas,

résumé de la notice, chapeau de l’article ou résumé de la rubrique

Le « résumé » de l’événement = le chapeau de l’article

{{content}}

Le contenu de l’article = le texte même de l’article

Le contenu de l’enregistrement - Suivant le cas

 le contenu de la notice = tous les champs

 le contenu de l’article = le texte même de l’article

N.B. Rappel : une rubrique n’a pas de champ « contenu »

Le contenu de l’événement = le texte même de l’article

{{link}}

Le lien = URL de l’article

Le lien = URL de la rubrique

Le lien = URL de l’enregistrement

Suivant le cas, URL de la notice, de l’article ou de la rubrique

Le lien = URL de l’événement

{{vign}}

La vignette de l’article

La vignette de la rubrique

La vignette de l’enregistrement

Suivant le cas, la vignette de la notice, de l’article ou de la rubrique

La vignette de l’événement

Exemples de champs personnalisés, qui correspondent aux types de contenu définis pour les articles

N.B. Le nom d’une variable associée à un champ personnalisé contient toujours ceci : {{fields_type}}

Evénement à une date précise

Evénement sur une période : date de début

Evénement sur une période : date de fin

Sélection : identifiant de l’étagère associée à un article

Coup de cœur : identifiant de la notice associée à un article

Lien : URL de la page à ouvrir

Ouvrir une page dans un autre onglet du navigateur ?

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 184

Balises HTML

Presque toutes les balises HTML vont deux par deux : il y a une balise ouvrante et une balise fermante, ex. <h2> et </h2>

N.B. HTML = HyperText Markup Language

La balise la plus importante : <a href=" … "> … </a>

Elle permet de créer des liens URL et comprend 2 éléments :



l’URL de destination : la page vers laquelle on ira



la source, le point de départ : les éléments sur lesquels on clique (texte et/ou image)

L’URL de destination peut être exprimée sous la forme d’une adresse absolue ou d’une adresse relative

Exemple : la page de l’OPAC qui affiche une notice dont le numéro d’id est 88

Adresse absolue de cette page :

http://127.0.0.1/pmbv4perso/opac_css/index.php?lvl=notice_display&id=88

Adresse relative de cette page – relative par rapport au répertoire /pmb/opac_css/ :

http://./index.php?lvl=notice_display&id=88

Comment rendre un texte cliquable en HTML ?

<a href="… : URL de destination

Texte entre <a> et </a> : source, d’où on part : on clique sur le texte

<a href="http://amcubat.be/docpmb">Site de Anne-Marie Cubat</a>

Comment rendre une image cliquable en HTML ?

<a href="… : URL de destination <img src="… : source, d’où on part : on clique sur l’image

N.B. Pour les balises alt=" " et title=" ", employez des guillemets, mais pas l’apostrophe. alt=" " : texte alternatif à afficher si l’image n’est pas disponible title=" " : infobulle - texte à afficher au survol de la souris sur l’image

L’apostrophe posera problème dès que le texte (dans le alt ou le title) contient des apostrophes.

Modifiez donc quelques templates Django si nécessaire. En effet, certains d’entre eux créent le contenu des balises alt ou title avec le titre d’une notice, or ces titres peuvent contenir des apostrophes, donc ils seraient tronqués dès la 1 e

apostrophe.

L’Avare de Molière se réduirait ainsi à la seule lettre “L” !!

Exemples corrects :

alt="{{record.title}}" ou title="{{record.title}}"

Comment rendre le texte et l’image cliquables en une seule balise HTML ? On combine le tout !

C’est d’ailleurs ce qui se passe dans beaucoup de templates : une seule balise <a href=" pour le texte et l’image

<a href="{{article.link}}"><img style="width:90px;" src='{{article.logo.large}}'/><h4>{{article.title}}</h4></a>

Des variables comme {{article.link}} ou {{record.link}} désignent l’URL de destination, leur contenu est créé de manière dynamique.

Exemples de contenu pour un lien vers la page qui affiche une notice (dans sa version portail et dans sa version OPAC classique)

Lien vers la page du portail : http://127.0.0.1/pmb4perso/opac_css/index.php?lvl=cmspage&pageid=7&id_notice=110

Lien vers la page de l’OPAC : http://127.0.0.1/pmbv4perso/opac_css/index.php?lvl=notice_display&id=110

Comment rendre un texte cliquable et ouvrir l’URL de destination dans un autre onglet du navigateur ?

<a href="… : URL de destination

Texte entre <a> et </a> : source, d’où on part : on clique sur le texte

Dans la partie qui contient l’URL de destination, ajouter l’instruction target="_blank"

<a href="http://amcubat.be/docpmb">Site de Anne-Marie Cubat</a> devient

<a href="http://amcubat.be/docpmb" target="_blank">Site de Anne-Marie Cubat</a>

Comment rendre une image cliquable et ouvrir l’URL de destination dans un autre onglet du navigateur ?

<a href="… : URL de destination

<img src="… : source, d’où on part : on clique sur l’image

Dans la partie qui contient l’URL de destination, ajouter l’instruction target="_blank"

<a href="http://www.sigb.net"><img src=" http://127.0.0.1/pmb/opac_css/images/site/pmb.png" alt="PMB" /></a> devient

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 185

Balises « simples » = qui n’ont pas de balise fermante

Image

Quelques balises HTML employées fréquemment dans les templates de notices ou les templates Django

Mise en forme du texte

La balise <br /> provoque un saut de ligne (br = break)

La balise <hr> trace une ligne horizontale (hr = horizontal rule)

Les balises <h2> </h2> (<h3> <h4>) reflètent la hiérarchie titre / sous-titres et déterminent la taille des caractères

Les balises <div style=" … > et </div> marquent le début et la fin d’un « bloc de texte » à mettre en forme.

L’affichage du texte situé entre ces 2 balises peut être personnalisé : marges, alignement, police de caractères …

La balise <blockquote> détermine un mode d’affichage (bloc de citation)

Les balises <p> et </p> marquent le début et la fin d’un paragraphe

La balise <img> signifie image.

<img … src=’ …’> signifie la source de l’image = l’URL de l’image (img src = image source).

<img style="… " src='…' />

Liste non ordonnée (liste à puces)

<ul>

</ul>

La partie style="… " permet de définir le mode d’affichage (ex. hauteur et largeur limitées à 120px – centré)

Les balises <ul> et </ul> marquent le début et la fin d’une liste non ordonnée = non numérotée (ul = unordered list)

Une liste non ordonnée peut prendre la forme d’une liste à puces, mais cela peut aussi signifier tout simplement une liste d’éléments non numérotés, ou une liste d’éléments qui figurent dans un carrousel.

N.B. Les balises <ol> et </ol> marquent le début et la fin d’une liste numérotée (ol = ordered list = liste ordonnée)

Les balises <li> et </li> marquent le début et la fin de chaque élément de la liste (non) ordonnée (li = list)

Les tableaux en HTML– Cet exemple est extrait du template de notices appelé « Portail – Liste de notices »

Voir

Notices d’une étagère associée à un article

Les balises <table> et </table> marquent le début et la fin d’un tableau.

On ne le croirait pas à première vue, mais cette notice est

Les balises <tbody> et </tbody> marquent le début et la fin de la définition du tableau.

Les balises <tr> et </tr> marquent le début et la fin de chaque ligne.

affichée dans un tableau dont les bordures sont invisibles !

Je trace ces bordures pour clarifier les choses ;-)

Les balises <td> et </td> marquent le début et la fin de chaque cellule.

En résumé

<table>

<tbody>

<tr> Début de l’unique ligne de ce tableau

<td> 1 e

cellule : la vignette </td>

<td> 2 e

cellule : titre, auteur et résumé de la notice </td>

</tr> Fin de la ligne

</tbody>

</table>

Ce tableau comprend donc

une seule ligne : l’ensemble des infos sur la notice

<tr> = table row (ligne, rangée)

2 cellules par ligne

<td> = table division (une cellule, dans ce contexte)

à gauche : la vignette

à droite : titre, auteur et résumé de la notice

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 186

Requêtes SQL utiles

J’ai repris ici la liste complète des requêtes et beaucoup de captures d’écran, mais pas toutes les explications !

En effet, ces procédures et les concepts qui y sont liés ont déjà fait l’objet de commentaires détaillés ailleurs :

Voir surtout

Contenu éditorial

Pages de l’OPAC et du portail

Modules, cadres et pages

Si vous avez restauré le jeu de sauvegarde cms_min (configuration du contenu éditorial), la plupart de ces requêtes sont

immédiatement prêtes à l’emploi, bien que certaines fassent appel aux champs personnalisés qu’on a pu créer.

Tout d’abord, un petit mot sur l’origine de ces requêtes

Toutes ces requêtes sont « de mon cru », mais je tiens quand même à remercier PMB Services, qui a fourni un point de départ utile, surtout un « petit bloc d’instructions » que j’ai pu insérer dans mes procédures.

Au terme de la formation initiale, nous avons en effet reçu de Camille Bénard une série de 8 requêtes liées au portail. Je les ai regardées attentivement, et j’y ai trouvé des idées intéressantes, surtout quelques lignes qui permettent d’afficher une partie de l’arbre du contenu

éditorial, afin de situer exactement chaque article (voir ci-dessous). J’ai donc intégré ce bloc d’instructions dans mes procédures.

On a une meilleure vue de l’arborescence si on sait par exemple qu’un article est dans

Rubrique Titre de l'article

Menu principal > Sélections > Coups de cœur Des bibliothèques pleines de fantômes

Menu principal > Sélections > Coups de cœur

C’est moins clair si on sait seulement qu’un article est dans la rubrique Coups de cœur.

C’est donc ce bloc-là d’instructions que j’ai repris des requêtes que nous avons reçues.

Menu principal > Sélections > Coups de cœur Georges : petit-petit-petit magazine

Menu principal > Sélections > Coups de cœur Poisson rouge

Menu principal > Animations > Evénements

Cultures d'Afrique noire contemporaine

Projections : journée Tim Burton

Menu principal > Animations > Heure du conte Lisez 5 fruits et légumes par jour !

Les requêtes SQL spécifiques au portail sont disponibles sur mon site, il y a un zip à télécharger à cette adresse :

http://amcubat.be/docpmb/portail-construction-concepts-exemples

N.B. Lorsqu’on décompresse le zip, cela crée automatiquement des dossiers dans lesquels les requêtes sont réparties.

Voici la liste des requêtes de chaque répertoire, et des copies d’écran pour illustrer les plus importantes.

Les requêtes qui figurent dans les deux premiers groupes (Utilitaires – Gestion de la base et Requêtes générales du portail) sont tout

à fait standards, et fonctionnent dans toutes les bases. Aucune adaptation n’est nécessaire.

Utilitaires – Gestion de la base en général

Etagères - Liste avec les autorisations accordées

Etagères - Liste des étagères et des paniers qui y sont associés - Avec les numéros d'id

Paniers (Catalogue : bulletins, exemplaires et notices) - Liste avec les autorisations accordées

Paniers – Contenu d’un panier de notices (monographies, périodiques, articles ou notices de bulletins)

Paramètres - Liste complète : type, nom, valeur, commentaire et section

Utilisateurs - Liste : login, nom, prénom et n° d'id

Exemple de liste des utilisateurs – avec le numéro d’id

N° id Login Nom Prénom admin

Eric

Super User

Eric

Florent

Camille

Florent

Camille

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 187

Exemple de liste de paniers – Avec le numéro d’id et le nombre de notices par panier

Type de panier Id Nom du panier

Bulletins 6 Exemple de panier de bulletins

Exemplaires

Notices

8 Exemple de panier d'exemplaires

11 Exemple de panier de notices

12 Nouveautés en page d'accueil

13 Nouveautés fiction adultes

Notices

14 Nouveautés fiction jeunesse

15 Nouveautés documentaires

16 Nouveautés CD

17 Nouveautés DVD

18 Nouveautés périodiques

Nombre Commentaire Utilisateurs

0 1

1 4 3 2

Exemple de contenu de 2 paniers de notices - avec indication du type de notice

Exemple de liste d’étagères – Avec le paramétrage pour l’OPAC

Id Nom de l'étagère Commentaire OPAC ? Validité De ... à ... Utilisateurs

3 Nouveautés

4 Nouveautés fiction adultes

Invisible

Permanente

5 Nouveautés fiction jeunesse

10 Test – Nouveautés - Fiction

Invisible Permanente

Exemple de liste d’étagères - Avec le numéro d’id et le nombre de notices par panier associé

Id Nom de l'étagère Id Nom du panier Nombre

3 Nouveautés

4 Nouveautés fiction adultes

12 Nouveautés en page d'accueil

13 Nouveautés fiction adultes

5 Nouveautés fiction jeunesse

6 Nouveautés documentaires

7 Nouveautés CD

8 Nouveautés DVD

9 Nouveautés périodiques

10 Test - Nouveautés - Fiction

14 Nouveautés fiction jeunesse

15 Nouveautés documentaires

16 Nouveautés CD

17 Nouveautés DVD

18 Nouveautés périodiques

13 Nouveautés fiction adultes

10 Test - Nouveautés - Fiction 14 Nouveautés fiction jeunesse 13

Exemple de résultat obtenu dans un PMB standard grâce à la requête : contenu de la table des paramètres

Paramètres - Liste complète : type, nom, valeur, commentaire et section Tri par type de paramètre, ensuite par nom du paramètre

N° id Type Nom Valeur Commentaire

741 Cms Active

758 Cms cache_ttl

797 Cms url_base_cms_build

106 Opac biblio_adr1

107 Opac biblio_town

0 Module 'Portail' activé. 0 : Non. 1 : Oui.

1800 durée de vie du cache des cadres du portail (en secondes) url de construction du CMS de l'OPAC

Section

ZI de Mont/Loir BP 10023 Adresse 1 de la bibliothèque ou du centre de ressources dans l'opac b_aff_general

CHATEAU DU LOIR Ville dans l'opac b_aff_general

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 188

Portail – Requêtes générales

Articles - Liste complète - Aucun champ personnalisé

Champs personnalisés du portail - Liste avec les numéros d'id

Pages - Liste de toutes les pages avec les numéros d'id

Pages - Liste des pages qui ont une variable globale - Aves les numéros d'id de la page et de la variable

Rubriques - Liste complète - Aucun champ personnalisé

Types de contenu éditorial - Liste des types avec les numéros d'id

Liste des pages du portail

Liste des variables d’environnement et des pages correspondantes

Les valeurs affichées (numéros d’id et noms des variables) correspondent à la démo du portail.

Tableau de bord : vue d’ensemble des articles, classés par rubrique – N.B. Liste abrégée, je ne montre que 9 articles sur 21 !

Rappel : l’actualité est éternelle dans une démo, les articles n’ont donc pas de dates de parution et tous ont le statut « publié ».

J’ai donc dû inventer des dates de publication, et changer certains statuts de publication, pour diversifier les exemples.

Au départ, les données sont triées sur base de l’arbre du contenu éditorial, donc regroupées par rubrique.

Transférez le résultat vers le tableur, et supprimez d’abord la 1 e

ligne (celle qui contient le nom de la procédure) avant de trier.

Dans un tableur, il est très facile de trier les données dans l’ordre qui vous convient, par exemple par statut de publication.

On peut aussi trier les données par type de contenu.

Le tri par type de contenu permet de vérifier si les dates de parution sont cohérentes. On voit ici des anomalies pour les Coups de cœur.

En théorie, ce type de contenu a une durée de vie limitée, or les dates de début et/ou de fin de publication manquent pour 2 articles.

La situation est normale pour les Evénements (dates mentionnées) et les Informations (il n’y a aucune date car la publication est permanente)

On peut aussi trier les données par numéro identifiant (du plus grand au plus petit), afin de voir d’abord les articles les plus récents.

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 189

Tableau de bord : vue d’ensemble des rubriques

Outils - Liste des champs personnalisés – enregistrés dans la table cms_editorial_custom – triés par numéro d’id

N.B. Ce sont les valeurs dans ma base de travail ; selon toute probabilité, certaines seront différentes dans votre base.

Toutefois, si vous avez restauré le jeu de sauvegarde cms_min, les 5 premiers champs sont identiques (ce sont les valeurs de la démo).

Pour les types de contenu, la signification de 2 libellés (« CP pour … ») pourrait intriguer de prime abord.

CP = champ personnalisé

CP pour Article = champ générique pour article

 commun à tous les articles

CP pour Rubrique = champ générique pour rubrique

 commun à toutes les rubriques

L’explication se trouve dans la table qui définit ces types de

contenu : cms_editorial_types

Sélection d’articles selon les types de contenu standards

Articles - Type de contenu : Coups de cœur - Titre abrégé de la notice (25 caractères) et numéro d'id

Articles - Type de contenu : Evénement à une date précise - Date de l'activité

Articles - Type de contenu : Evénement sur une période - Dates de début et de fin

Articles - Type de contenu : Information

Articles - Type de contenu : Sélection de notices - Nom de l'étagère associée et numéro d'id

Articles - Type de contenu : Vérification - Attention ! Le type de contenu n'est pas défini

Si vous avez restauré le jeu de sauvegarde cms_min (configuration du contenu éditorial), vous avez des types de contenu standards, et les 5 premiers éléments de la liste des champs personnalisés sont également standards.

Dans ce cas, ces requêtes sont immédiatement prêtes à l’emploi ! Sinon, il faudrait adapter les procédures.

Mêmes types de contenu 5 champs personnalisés identiques : numéro d’id, nom SQL, type de saisie et de type de données

Il s’agit seulement des 5 premiers champs de la liste.

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 190

Ces requêtes sélectionnent les articles selon les types de contenu standards, et permettent des vérifications bien utiles.

Pour un article de type « coup de cœur », on voit l’identifiant de la notice, et son titre abrégé (25 caractères).

Pour un article de type « sélection », on voit l’identifiant et le nom de l’étagère associée à cet article.

Pour un article de type « événement », on voit la date de l’activité, ou bien les dates de début et de fin.

Une autre requête permet de repérer la présence éventuelle d’un article dont le type de contenu n’aurait pas été défini.

Coups de cœur

Id de la notice ?

Annales ? Ou

La 8 e

couleur ?

Après vérification, on voit que le n° d’id de la notice est correct : « La 8e couleur » est un des titres de la série « Les Annales ».

Sélection

Etagère associée

à l’article

Evénement sur

une période

Dates ?

Evénement à une date précise

Date ?

Vérification

Article sans type de contenu !!!

Ces requêtes servent aussi à la fin du processus, quand on prépare la mise en ligne du portail, par exemple pour vérifier les n° d’id des notices ou des étagères (ces numéros ne sont probablement pas tous les mêmes dans la base de test et dans la base en production).

Sélection d’articles selon un champ personnalisé supplémentaire

Articles - Sélection : seulement les articles dont le rédacteur est connu - sur base d'une liste de choix préétablie

Articles - Sélection : seulement les articles dont le rédacteur est connu - sur base des logins de la table users

Articles - Sélection : seulement les articles qui ont un commentaire de gestion

Articles - Sélection : seulement les articles qui ont une date de mise à jour

Les procédures de cette série-ci sont « spécifiques », elles sont liées à des champs personnalisés supplémentaires dont les numéros

d’id peuvent différer d’une base à l’autre

(commentaire de gestion, date de la dernière mise à jour, nom du rédacteur).

Toutefois, si vous avez défini les champs personnalisés comme je l’ai fait (même type de saisie et même type de contenu), et si vous leur avez donné le même nom SQL (ex. nouvel_onglet), il n’y a aucun changement à faire ;-)

Sélection : liste partielle des articles – seulement s’il y a une date de mise à jour

Sélection : liste partielle des articles – seulement si le rédacteur est connu (liste préétablie de choix)

Sélection : liste partielle des articles – seulement si le rédacteur est connu (liste à partir d’une requête – contenu de la tables users)

Sélection : liste partielle des articles – seulement s’il y a des commentaires de gestion

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 191

Les requêtes qui figurent dans le groupe (Portail - Utilitaires de gestion) sont tout à fait standards, et fonctionnent dans toutes les bases. Aucune adaptation n’est nécessaire.

Portail - Utilitaires de gestion

Liste des versions du CMS – avec leur numéro identifiant

Supprimer une ou plusieurs versions du CMS antérieure(s) à la version sélectionnée –

A exécuter dans l’onglet Administration

Vider le cache du portail (source : PMB Services) –

A exécuter dans l’onglet Administration

Requête SQL –Liste des versions du CMS (avec leur numéro identifiant)

Ceci n’est pas une requête d’action ; elle affiche simplement la liste des versions enregistrées (avec leur numéro identifiant).

Cette requête permet de consulter cette liste à l’aise, avant de lancer la procédure qui supprime plusieurs versions du CMS.

Requête SQL - Supprimer une ou plusieurs versions du CMS antérieure(s) à la version sélectionnée

Au fil du temps, le nombre de versions du CMS augmente dans la table cms_version, et il devient utile de lancer un « grand nettoyage de printemps ». C’est particulièrement le cas pour la démo du portail, où le nombre de versions du CMS est fort élevé.

La requête de suppression fonctionne selon le principe suivant

 on sélectionne une version du CMS

 la requête supprime la (les) version(s) du CMS antérieure(s) à la version choisie

 elle conserve la version sélectionnée et les versions postérieures

Cette requête est surtout conçue pour lancer « un nettoyage par le vide » dans des versions anciennes du portail, mais

soyez prudent dès qu’il s’agit de supprimer des versions relativement récentes !!

Pour que le portail fonctionne, il vous faut « la bonne version » du CMS : celle qui est active pour le moment (celle dont on voit le numéro dans les informations de l’OPAC).

Or, c’est en général la version la plus récente qui est active (sauf si vous venez de restaurer une version antérieure).

Si on veut vérifier à l’aise, avant de lancer la suppression, et savoir à quelle version du CMS un numéro d’id correspond, il suffit d’employer une autre procédure qui donne la liste des versions du CMS, et leur numéro identifiant.

En effet, la liste des versions du CMS fournie par PMB mentionne la date et l’heure de sauvegarde, mais pas le numéro d’id de la version.

Attention donc, ne lancez pas cette procédure de manière inconsidérée ! Vérifiez d’abord !!

En rédigeant cette requête, j’ai veillé à ce qu’il soit techniquement impossible de supprimer la dernière version en date, puisque cette suppression déclencherait probablement de sérieux dysfonctionnements (selon toute vraisemblance, c’est celle qui est active).

Assurez-vous que la version du CMS qui est active pour le moment ne fasse pas partie de celles que la requête pourrait supprimer.

Ne soyez pas surpris par le nombre de lignes affectées par la requête, il est largement supérieur au nombre de versions supprimées.

En effet, à chaque ligne de la table cms_version correspondent plusieurs lignes dans la table cms_build (une ligne par cadre).

Or, la requête supprime les traces d’une version dans les deux tables concernées.

Exemple concret : s’il y a 20 cadres dans le portail, dès qu’on enregistre une version du portail, on aura

 une ligne supplémentaire dans cms_version : les « références » de cette version (numéro d’id, date et heure de sauvegarde)



20 lignes supplémentaires dans la table cms_build : une ligne par cadre qui fait partie de cette version-là

Donc si on supprime 3 versions du portail, on supprimera 63 lignes au total !

Dans cet exemple, j’ai demandé la suppression des 3 versions antérieures

à la version 177, donc la requête va supprimer 3 lignes dans la table cms_version, mais 138 lignes dans cms_build : 141 au total.

A.-M. Cubat PMB – Construction du portail – Concepts et exemples

Source : http://amcubat.be/docpmb/portail-construction-concepts-exemples

Page 192

Requête SQL – Vide le cache du portail (source : PMB services)

N.B. Je reprends seulement les infos essentielles, car j’ai déjà parlé du mode de mise en cache des cadres du portail .

C’est dans la table cms_cache_cadres que certains cadres sont mis en cache, afin de ne pas devoir être rechargés lors du prochain affichage.

Si vous avez effectué des changements relativement importants dans le portail, si vous avez ajouté ou modifié des articles, il est parfois utile que les lecteurs soient prévenus le plus tôt possible.

Mais si la durée de vie de votre cache est d’une heure ou deux, les lecteurs ne verront pas tout de suite l’impact de ces changements.

Dans ce genre de circonstances, il vaut mieux vider le cache « manuellement ». C’est le rôle de cette requête.

Les requêtes SQL spécifiques au portail sont disponibles sur mon site, il y a un zip à télécharger à cette adresse :

http://amcubat.be/docpmb/portail-construction-concepts-exemples

Lorsqu’on décompresse le zip, cela crée automatiquement des dossiers dans lesquels les requêtes sont réparties.

Pour savoir comment les télécharger et les importer dans PMB

http://amcubat.be/docpmb/telecharger-requetes-sql http://amcubat.be/docpmb/importer-requetes-sql

N.B. Il faut importer toutes ces requêtes liées au portail dans l’onglet Administration.

Presque toutes les procédures peuvent être exécutées dans les onglets Administration ou Editions, sauf les 2 dernières que j’ai citées.

Il y a aussi sur mon site un ensemble de requêtes « générales » que vous pouvez télécharger, et importer dans PMB.

Vous trouverez ici 3 zips : http://amcubat.be/docpmb/requetes-sql/telecharger-et-importer

Lorsqu’on décompresse le zip, cela crée automatiquement des dossiers dans lesquels les requêtes sont réparties.

Il y a 3 zips car les requêtes sont groupées en fonction de l'onglet de PMB dans lequel il faut les importer :

administration, catalogue et circulation.

Pour savoir comment les télécharger et les importer dans PMB

http://amcubat.be/docpmb/telecharger-requetes-sql http://amcubat.be/docpmb/importer-requetes-sql

Pour consulter la liste complète de cet ensemble de requêtes

http://amcubat.be/docpmb/wp-content/uploads//pmb-liste-requetes-sql.pdf

Pour savoir à quoi ces requêtes peuvent servir, suivre les liens suivants et parcourir les diverses rubriques

http://amcubat.be/docpmb/requetes-sql/sommaire-requetes-circulation http://amcubat.be/docpmb/requetes-sql/sommaire-requetes-catalogue http://amcubat.be/docpmb/requetes-sql/sommaire-requetes-administration

Caractéristiques clés

Transformation de l'OPAC en un portail documentaire
Gestion de l'interface graphique et du contenu (CMS)
Utilisation dynamique de modules (carrousel, agenda, étagères virtuelles)
Création de liens entre contenu éditorial et bibliographique
Rédaction d'articles et gestion de rubriques

Questions fréquemment posées

Un CMS (Content Management System) est un logiciel qui permet de construire des sites en gérant l’interface graphique et le contenu.

Un portail documentaire est une porte d'accès au contenu bibliographique, qui intègre à la fois le contenu éditorial et le contenu bibliographique.

Un article est un texte que vous rédigez pour fournir des infos sur un sujet précis (le fonds documentaire, les conditions de prêt, un livre, un auteur, une animation, les nouveautés du rayon DVD …)