AJLSM - Contributions [fr]

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-15T09:03:08Z

Pdechandol :

== Objectif ==
L'objectif est de créer, dans Pleade, un menu à onglets contenant des formulaires de recherche "fulltext" filtrés. 
Chaque onglet est soit non-filtré, soit filtré sur le même champ de recherche avec une valeur différente. 
Les onglets sont générés dynamiquement à partir des valeurs indexées pour le champ de recherche utilisé pour le filtre.

{{important|Cette implémentation est pour le moment mise en place dans le projet {{Pleade}} pour [[Doc/BM-Grenoble|BM-Grenoble]]. 
Sa généralisation et introduction dans Pleade Libre devra être étudiée ultérieurement. 
Elle sous-entend un gros travail d'adaptation et de généralisation, qui n'est pas fait pour l'instant.}}

== Configuration du menu dans Pleade ==
Dans Pleade, c'est le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} qui permet de configurer les menus affichés dans les pages. 
On introduit la configuration du nouveau menu à onglets dans ce fichier avec le fragment suivant :

=== Configuration dans menus.xconf ===

==== Fragment XML ====
Ci-dessous le fragment XML définissant le système d'onglets dans le menu
<syntaxhighlight lang="bash">
<menu type="htoptabs" id="htoptabs">

<item type="list">

<tab field="" value="">

<label>
<i18n:text key="menu-search-tabs.simple">toutes bibliothèques</i18n:text>
</label>

<item id="search-simple" type="form-embedded" ref="bmg-categorie" filtered-by-field="no" />
</tab>

<tab-repeat field="categorie" base="BMG">


<item id="search-categorie" type="form-embedded" ref="bmg-categorie" filtered-by-field="yes" />
</tab-repeat>
</item>
</menu>
</syntaxhighlight>

==== Explications et spécifications ====
Le menu est défini comme les autres menus par un noeud {{tag|menu}} caractérisé par les attributs {{attr|id}} et {{attr|type}}. 
Ces attributs sont utilisés par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/module-eadeac/xsl/search.xsl}} pour associer la configuration du menu au template dédié à son affichage dans les templates de pages Pleade.

Ce menu contient un unique noeud {{tag|item}} définissant le menu à onglets que nous souhaitons construire. 
Cet item est caractérisé par l'attribut {{attr|type}} avec la valeur spécifique {{cmd|"list"}} dédiée à la définition d'un menu à entrées multiples affichées sous forme d'onglets.

Les onglets du menu sont définis par des noeuds :
* {{tag|tab}} pour déclarer un unique onglet
* {{tag|tab-repeat}} pour déclarer des onglets répétés construits suivant le mécanisme suivant : les onglets sont construits dynamiquement à partir des valeurs indexées pour un champ de la base de documents.

Un noeud {{tag|tab}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|value}} : contient la valeur à appliquer au filtre

Un noeud {{tag|tab-repeat}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé à chaque onglet :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|base}} : le nom de la base de documents, utilisée pour récupérer les valeurs d'index du champ de filtrage
{{notice|La valeur à appliquer au filtre est obligatoirement la valeur d'index du champ correspondant à l'onglet.}}

Un noeud {{tag|tab}} ou {{tag|tab-repeat}} peut contenir les noeuds suivants :
* {{tag|label}} (optionnel) permettant de définir le libellé cliquable de l'onglet. Ce noeud doit généralement inclure l'appel à une clé i18n, sur le même modèle que tous les autres éléments de menus. Ce noeud n'est pas présent dans les noeuds {{tag|tab-repeat}}. En effet, dans ce cas, les libellés des onglets sont générés dynamiquement pour y faire figurer les valeurs indexées pour le champ de définition des onglets.
* {{tag|item}} permettant de définir le formulaire construit dynamiquement qui sera incorporé dans l'onglet

Le noeud {{tag|item}} définissant le formulaire de recherche embarqué dans l'onglet est défini par les attributs suivants :
* {{attr|id}} : un identifiant sur lequel seront construits les IDs nécessaires à la gestion JS des onglets
* {{attr|type}} : obligatoirement "form-embedded"
* {{attr|ref}} : le nom du formulaire incorporé dans l'onglet. Ce formulaire est défini par le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/search-forms/nom_formulaire.xconf}}
* {{attr|filtered-by-field}} : (yes | no) indique si le formulaire incorporé doit être filtré ou pas. Si un filtre doit être appliqué, les paramètres du filtre sont récupérés dans le noeud parent {{tag|tab}} ou {{tag|tab-repeat}}

=== Génération dynamique du menu à onglets ===

La génération des menus configurés dans le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} est prise en charge par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/pleade-menus.xsl}}. 
Cette feuille de style est appliquée sur le fichier de définition de template HTML {{path|{{var|$ROOT_PLEADE}}/theme/module-eadeac-template-search.html}}, qui définit les {{tag|div}} de haut niveau voués à recevoir les éléments de menu. 
Les templates de la feuille XSL, dédiés à la génération du menu à onglets incorporant des formulaires de recherche, sont caractérisés par l'attribut {{attr|mode}} avec la valeur {{cmd|"import-form"}}. 
Ces templates XSL sont en charge de créer les {{tag|div}} HTML, qui recevront le contenu des formulaires incorporés dans les différents onglets. 
Le contenu HTML des formulaires de recherche sera généré dynamiquement et introduit par AJAX dans les {{tag|div}} précédemment construits.

=== Génération dynamique des formulaires embarqués ===

==== Principe ====

Le contenu HTML des formulaires embarqués est généré en AJAX au chargement de la page {{Pleade}}. 
La feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/pleade-aggregate.xsl}} prend en charge l'écriture du code HTML déclarant les entêtes HTML d'une page {{Pleade}}. En particulier, elle appelle un template nommé {{cmd|"more-js"}} destiné à être surchargé pour y ajouter du code Javascript spécifique. 
Ce template est surchargé dans la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/local-pleade-aggregate.xsl}}. On y déclare le code AJAX permettant de générer le contenu des formulaires de recherche embarqués dans le menu à onglets, ainsi que le code de gestion du clic sur un onglet du menu.

==== Requête AJAX de construction du formulaire ====

La requête AJAX invoquée pour générer le contenu des formulaires imbriqués est de la forme : {{{search-form-fragment.xsp?name=bmg-categorie}}}. 
Le paramètre {{cmd|"name"}} doit contenir le nom du formulaire de recherche à générer. 
Si on appelle le formulaire {{tag|monFormulaire}}, on a forcément un fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/search-forms/monFormulaire.xconf}} décrivant le formulaire de recherche correspondant.

La requête invoquée est "matchée" dans le sitemap : {{path|{{var|$ROOT_PLEADE}}/module-eadeac/module-eadeac.xmap}}. 
Le traitement appelle la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/module-eadeac/xsl/local-search-fragment.xsl}} qui est en charge de générer le fragment HTML décrivant le formulaire de recherche '''sans aucun bouton ni label de champ'''. En effet, pour insérer les formulaires de recherche dans le menu à onglets, nous n'avons pas besoin qu'ils contiennent ni les labels de champs de recherche, ni les boutons de validation du formulaire.

{{notice|la génération standard d'un formulaire de recherche est prise en charge par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/module-eadeac/xsl/search.xsl}}. }}

[[category:BM-Grenoble]]
[[category:Pleade]]
[[category:Menu]]
[[category:Formulaire]]

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-15T08:49:51Z

Pdechandol :

== Objectif ==
L'objectif est de créer, dans Pleade, un menu à onglets contenant des formulaires de recherche "fulltext" filtrés. 
Chaque onglet est soit non-filtré, soit filtré sur le même champ de recherche avec une valeur différente. 
Les onglets sont générés dynamiquement à partir des valeurs indexées pour le champ de recherche utilisé pour le filtre.

{{important|Cette implémentation est pour le moment mise en place dans le projet {{Pleade}} pour [[Doc/BM-Grenoble|BM-Grenoble]]. 
Sa généralisation et introduction dans Pleade Libre devra être étudiée ultérieurement. 
Elle sous-entend un gros travail d'adaptation et de généralisation, qui n'est pas fait pour l'instant.}}

== Configuration du menu dans Pleade ==
Dans Pleade, c'est le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} qui permet de configurer les menus affichés dans les pages. 
On introduit la configuration du nouveau menu à onglets dans ce fichier avec le fragment suivant :

=== Configuration dans menus.xconf ===

==== Fragment XML ====
Ci-dessous le fragment XML définissant le système d'onglets dans le menu
<syntaxhighlight lang="bash">
<menu type="htoptabs" id="htoptabs">

<item type="list">

<tab field="" value="">

<label>
<i18n:text key="menu-search-tabs.simple">toutes bibliothèques</i18n:text>
</label>

<item id="search-simple" type="form-embedded" ref="bmg-categorie" filtered-by-field="no" />
</tab>

<tab-repeat field="categorie" base="BMG">


<item id="search-categorie" type="form-embedded" ref="bmg-categorie" filtered-by-field="yes" />
</tab-repeat>
</item>
</menu>
</syntaxhighlight>

==== Explications et spécifications ====
Le menu est défini comme les autres menus par un noeud {{tag|menu}} caractérisé par les attributs {{attr|id}} et {{attr|type}}. 
Ces attributs sont utilisés par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/module-eadeac/xsl/search.xsl}} pour associer la configuration du menu au template dédié à son affichage dans les templates de pages Pleade.

Ce menu contient un unique noeud {{tag|item}} définissant le menu à onglets que nous souhaitons construire. 
Cet item est caractérisé par l'attribut {{attr|type}} avec la valeur spécifique {{cmd|"list"}} dédiée à la définition d'un menu à entrées multiples affichées sous forme d'onglets.

Les onglets du menu sont définis par des noeuds :
* {{tag|tab}} pour déclarer un unique onglet
* {{tag|tab-repeat}} pour déclarer des onglets répétés construits suivant le mécanisme suivant : les onglets sont construits dynamiquement à partir des valeurs indexées pour un champ de la base de documents.

Un noeud {{tag|tab}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|value}} : contient la valeur à appliquer au filtre

Un noeud {{tag|tab-repeat}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé à chaque onglet :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|base}} : le nom de la base de documents, utilisée pour récupérer les valeurs d'index du champ de filtrage
{{remarque|La valeur à appliquer au filtre est obligatoirement la valeur d'index du champ correspondant à l'onglet.}}

Un noeud {{tag|tab}} ou {{tag|tab-repeat}} peut contenir les noeuds suivants :
* {{tag|label}} (optionnel) permettant de définir le libellé cliquable de l'onglet. Ce noeud doit généralement inclure l'appel à une clé i18n, sur le même modèle que tous les autres éléments de menus. Ce noeud n'est pas présent dans les noeuds {{tag|tab-repeat}}. En effet, dans ce cas, les libellés des onglets sont générés dynamiquement pour y faire figurer les valeurs indexées pour le champ de définition des onglets.
* {{tag|item}} permettant de définir le formulaire construit dynamiquement qui sera incorporé dans l'onglet

Le noeud {{tag|item}} définissant le formulaire de recherche embarqué dans l'onglet est défini par les attributs suivants :
* {{attr|id}} : un identifiant sur lequel seront construits les IDs nécessaires à la gestion JS des onglets
* {{attr|type}} : obligatoirement "form-embedded"
* {{attr|ref}} : le nom du formulaire incorporé dans l'onglet. Ce formulaire est défini par le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/search-forms/nom_formulaire.xconf}}
* {{attr|filtered-by-field}} : (yes | no) indique si le formulaire incorporé doit être filtré ou pas. Si un filtre doit être appliqué, les paramètres du filtre sont récupérés dans le noeud parent {{tag|tab}} ou {{tag|tab-repeat}}

=== Génération dynamique du menu à onglets ===

La génération des menus configurés dans le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} est prise en charge par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/pleade-menus.xsl}}. 
Cette feuille de style est appliquée sur le fichier de définition de template HTML {{path|{{var|$ROOT_PLEADE}}/theme/module-eadeac-template-search.html}}, qui définit les {{tag|div}} de haut niveau voués à recevoir les éléments de menu. 
Les templates de la feuille XSL, dédiés à la génération du menu à onglets incorporant des formulaires de recherche, sont caractérisés par l'attribut {{attr|mode}} avec la valeur {{cmd|"import-form"}}. 
Ces templates XSL sont en charge de créer les {{tag|div}} HTML, qui recevront le contenu des formulaires incorporés dans les différents onglets. 
Le contenu HTML des formulaires de recherche sera généré dynamiquement et introduit par AJAX dans les {{tag|div}} précédemment construits.

=== Génération dynamique des formulaires embarqués ===

==== Principe ====

Le contenu HTML des formulaires embarqués est généré en AJAX au chargement de la page {{Pleade}}. 
La feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/pleade-aggregate.xsl}} prend en charge l'écriture du code HTML déclarant les entêtes HTML d'une page {{Pleade}}. En particulier, elle appelle un template nommé {{cmd|"more-js"}} destiné à être surchargé pour y ajouter du code Javascript spécifique. 
Ce template est surchargé dans la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/local-pleade-aggregate.xsl}}. On y déclare le code AJAX permettant de générer le contenu des formulaires de recherche embarqués dans le menu à onglets, ainsi que le code de gestion du clic sur un onglet du menu.

==== Requête AJAX de construction du formulaire ====

La requête AJAX invoquée pour générer le contenu des formulaires imbriqués est de la forme : {{{search-form-fragment.xsp?name=bmg-categorie}}}. 
Le paramètre {{cmd|"name"}} doit contenir le nom du formulaire de recherche à générer. 
Si on appelle le formulaire {{tag|monFormulaire}}, on a forcément un fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/search-forms/monFormulaire.xconf}} décrivant le formulaire de recherche correspondant.

La requête invoquée est "matchée" dans le sitemap : {{path|{{var|$ROOT_PLEADE}}/module-eadeac/module-eadeac.xmap}}. 
Le traitement appelle la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/module-eadeac/xsl/local-search-fragment.xsl}} qui est en charge de générer le fragment HTML décrivant le formulaire de recherche '''sans aucun bouton ni label de champ'''.

[[category:BM-Grenoble]]
[[category:Pleade]]
[[category:Menu]]
[[category:Formulaire]]

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-14T13:42:52Z

Pdechandol :

== Objectif ==
L'objectif est de créer, dans Pleade, un menu à onglets contenant des formulaires de recherche "fulltext" filtrés. 
Chaque onglet est soit non-filtré, soit filtré sur le même champ de recherche avec une valeur différente. 
Les onglets sont générés dynamiquement à partir des valeurs indexées pour le champ de recherche utilisé pour le filtre.

{{important|Cette implémentation est pour le moment mise en place dans le projet {{Pleade}} pour [[Doc/BM-Grenoble|BM-Grenoble]]. 
Sa généralisation et introduction dans Pleade Libre devra être étudiée ultérieurement. 
Elle sous-entend un gros travail d'adaptation et de généralisation, qui n'est pas fait pour l'instant.}}

== Configuration du menu dans Pleade ==
Dans Pleade, c'est le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} qui permet de configurer les menus affichés dans les pages. 
On introduit la configuration du nouveau menu à onglets dans ce fichier avec le fragment suivant :

=== Configuration dans menus.xconf ===

==== Fragment XML ====
Ci-dessous le fragment XML définissant le système d'onglets dans le menu
<syntaxhighlight lang="bash">
<menu type="htoptabs" id="htoptabs">

<item type="list">

<tab field="" value="">

<label>
<i18n:text key="menu-search-tabs.simple">toutes bibliothèques</i18n:text>
</label>

<item id="search-simple" type="form-embedded" ref="bmg-categorie" filtered-by-field="no" />
</tab>

<tab-repeat field="categorie" base="BMG">


<item id="search-categorie" type="form-embedded" ref="bmg-categorie" filtered-by-field="yes" />
</tab-repeat>
</item>
</menu>
</syntaxhighlight>

==== Explications et spécifications ====
Le menu est défini comme les autres menus par un noeud {{tag|menu}} caractérisé par les attributs {{attr|id}} et {{attr|type}}. 
Ces attributs sont utilisés par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/module-eadeac/xsl/search.xsl}} pour associer la configuration du menu au template dédié à son affichage dans les templates de pages Pleade.

Ce menu contient un unique noeud {{tag|item}} définissant le menu à onglets que nous souhaitons construire. 
Cet item est caractérisé par l'attribut {{attr|type}} avec la valeur spécifique {{cmd|"list"}} dédiée à la définition d'un menu à entrées multiples affichées sous forme d'onglets.

Les onglets du menu sont définis par des noeuds :
* {{tag|tab}} pour déclarer un unique onglet
* {{tag|tab-repeat}} pour déclarer des onglets répétés construits suivant le mécanisme suivant : les onglets sont construits dynamiquement à partir des valeurs indexées pour un champ de la base de documents.

Un noeud {{tag|tab}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|value}} : contient la valeur à appliquer au filtre

Un noeud {{tag|tab-repeat}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé à chaque onglet :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|base}} : le nom de la base de documents, utilisée pour récupérer les valeurs d'index du champ de filtrage
{{remarque|La valeur à appliquer au filtre est obligatoirement la valeur d'index du champ correspondant à l'onglet.}}

Un noeud {{tag|tab}} ou {{tag|tab-repeat}} peut contenir les noeuds suivants :
* {{tag|label}} (optionnel) permettant de définir le libellé cliquable de l'onglet. Ce noeud doit généralement inclure l'appel à une clé i18n, sur le même modèle que tous les autres éléments de menus. Ce noeud n'est pas présent dans les noeuds {{tag|tab-repeat}}. En effet, dans ce cas, les libellés des onglets sont générés dynamiquement pour y faire figurer les valeurs indexées pour le champ de définition des onglets.
* {{tag|item}} permettant de définir le formulaire construit dynamiquement qui sera incorporé dans l'onglet

Le noeud {{tag|item}} définissant le formulaire de recherche embarqué dans l'onglet est défini par les attributs suivants :
* {{attr|id}} : un identifiant sur lequel seront construits les IDs nécessaires à la gestion JS des onglets
* {{attr|type}} : obligatoirement "form-embedded"
* {{attr|ref}} : le nom du formulaire incorporé dans l'onglet. Ce formulaire est défini par le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/search-forms/nom_formulaire.xconf}}
* {{attr|filtered-by-field}} : (yes | no) indique si le formulaire incorporé doit être filtré ou pas. Si un filtre doit être appliqué, les paramètres du filtre sont récupérés dans le noeud parent {{tag|tab}} ou {{tag|tab-repeat}}

=== Génération dynamique du menu à onglets ===

La génération des menus configurés dans le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} est prise en charge par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/pleade-menus.xsl}}. 
Cette feuille de style est appliquée sur le fichier de définition de template HTML {{path|{{var|$ROOT_PLEADE}}/theme/module-eadeac-template-search.html}}, qui définit les {{tag|div}} de haut niveau voués à recevoir les éléments de menu. 
Les templates de la feuille XSL, dédiés à la génération du menu à onglets incorporant des formulaires de recherche, sont caractérisés par l'attribut {{attr|mode}} avec la valeur {{cmd|"import-form"}}. 
Ces templates XSL sont en charge de créer les {{tag|div}} HTML, qui recevront le contenu des formulaires incorporés dans les différents onglets. 
Le contenu HTML des formulaires de recherche sera généré dynamiquement et introduit par AJAX dans les {{tag|div}} précédemment construits.

=== Génération dynamique des formulaires embarqués ===

Le contenu HTML des formulaires embarqués est généré en AJAX au chargement de la page {{Pleade}}. 
La feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/pleade-aggregate.xsl}} prend en charge l'écriture du code HTML déclarant les entêtes HTML d'une page {{Pleade}}. En particulier, elle appelle un template nommé {{cmd|"more-js"}} destiné à être surchargé pour y ajouter du code Javascript spécifique. 
Ce template est surchargé dans la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/local-pleade-aggregate.xsl}}. On y déclare le code AJAX permettant de générer le contenu des formulaires de recherche embarqués dans le menu à onglets, ainsi que le code de gestion du clic sur un onglet du menu.

[[category:BM-Grenoble]]
[[category:Pleade]]
[[category:Menu]]
[[category:Formulaire]]

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-14T12:34:46Z

Pdechandol :

== Objectif ==
L'objectif est de créer, dans Pleade, un menu à onglets contenant des formulaires de recherche "fulltext" filtrés. 
Chaque onglet est soit non-filtré, soit filtré sur le même champ de recherche avec une valeur différente. 
Les onglets sont générés dynamiquement à partir des valeurs indexées pour le champ de recherche utilisé pour le filtre.

{{important|Cette implémentation est pour le moment mise en place dans le projet {{Pleade}} pour [[Doc/BM-Grenoble|BM-Grenoble]]. 
Sa généralisation et introduction dans Pleade Libre devra être étudiée ultérieurement. 
Elle sous-entend un gros travail d'adaptation et de généralisation, qui n'est pas fait pour l'instant.}}

== Configuration du menu dans Pleade ==
Dans Pleade, c'est le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} qui permet de configurer les menus affichés dans les pages. 
On introduit la configuration du nouveau menu à onglets dans ce fichier avec le fragment suivant :

=== Configuration dans menus.xconf ===

==== Fragment XML ====
Ci-dessous le fragment XML définissant le système d'onglets dans le menu
<syntaxhighlight lang="bash">
<menu type="htoptabs" id="htoptabs">

<item type="list">

<tab field="" value="">

<label>
<i18n:text key="menu-search-tabs.simple">toutes bibliothèques</i18n:text>
</label>

<item id="search-simple" type="form-embedded" ref="bmg-categorie" filtered-by-field="no" />
</tab>

<tab-repeat field="categorie" base="BMG">


<item id="search-categorie" type="form-embedded" ref="bmg-categorie" filtered-by-field="yes" />
</tab-repeat>
</item>
</menu>
</syntaxhighlight>

==== Explications et spécifications ====
Le menu est défini comme les autres menus par un noeud {{tag|menu}} caractérisé par les attributs {{attr|id}} et {{attr|type}}. 
Ces attributs sont utilisés par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/module-eadeac/xsl/search.xsl}} pour associer la configuration du menu au template dédié à son affichage dans les templates de pages Pleade.

Ce menu contient un unique noeud {{tag|item}} définissant le menu à onglets que nous souhaitons construire. 
Cet item est caractérisé par l'attribut {{attr|type}} avec la valeur spécifique {{cmd|"list"}} dédiée à la définition d'un menu à entrées multiples affichées sous forme d'onglets.

Les onglets du menu sont définis par des noeuds :
* {{tag|tab}} pour déclarer un unique onglet
* {{tag|tab-repeat}} pour déclarer des onglets répétés construits suivant le mécanisme suivant : les onglets sont construits dynamiquement à partir des valeurs indexées pour un champ de la base de documents.

Un noeud {{tag|tab}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|value}} : contient la valeur à appliquer au filtre

Un noeud {{tag|tab-repeat}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé à chaque onglet :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|base}} : le nom de la base de documents, utilisée pour récupérer les valeurs d'index du champ de filtrage
{{remarque|La valeur à appliquer au filtre est obligatoirement la valeur d'index du champ correspondant à l'onglet.}}

Un noeud {{tag|tab}} ou {{tag|tab-repeat}} peut contenir les noeuds suivants :
* {{tag|label}} (optionnel) permettant de définir le libellé cliquable de l'onglet. Ce noeud doit généralement inclure l'appel à une clé i18n, sur le même modèle que tous les autres éléments de menus. Ce noeud n'est pas présent dans les noeuds {{tag|tab-repeat}}. En effet, dans ce cas, les libellés des onglets sont générés dynamiquement pour y faire figurer les valeurs indexées pour le champ de définition des onglets.
* {{tag|item}} permettant de définir le formulaire construit dynamiquement qui sera incorporé dans l'onglet

Le noeud {{tag|item}} définissant le formulaire de recherche embarqué dans l'onglet est défini par les attributs suivants :
* {{attr|id}} : un identifiant sur lequel seront construits les IDs nécessaires à la gestion JS des onglets
* {{attr|type}} : obligatoirement "form-embedded"
* {{attr|ref}} : le nom du formulaire incorporé dans l'onglet. Ce formulaire est défini par le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/search-forms/nom_formulaire.xconf}}
* {{attr|filtered-by-field}} : (yes | no) indique si le formulaire incorporé doit être filtré ou pas. Si un filtre doit être appliqué, les paramètres du filtre sont récupérés dans le noeud parent {{tag|tab}} ou {{tag|tab-repeat}}

=== Génération dynamique du menu à onglets ===

La génération des menus configurés dans le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} est prise en charge par la feuille de style XSL {{path|{{var|$ROOT_PLEADE}}/commons/xsl/pleade-menus.xsl}}. 
Les templates dédiés à la génération du menu à onglets incorporant des formulaires de recherche sont caractérisés par l'attribut {{attr|mode}} avec la valeur {{cmd|"import-form"}}. 
Ces templates sont en charge de créer les {{tag|div}} HTML, qui recevront le contenu des formulaires incorporés dans les différents onglets. 
Le contenu HTML des formulaires de recherche sera généré dynamiquement et introduit par AJAX dans les {{tag|div}} prévus.

=== Génération dynamique des formulaires embarqués ===

[[category:BM-Grenoble]]
[[category:Pleade]]
[[category:Menu]]
[[category:Formulaire]]

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-14T09:55:08Z

Pdechandol :

== Objectif ==
L'objectif est de créer, dans Pleade, un menu à onglets contenant des formulaires de recherche "fulltext" filtrés. 
Chaque onglet est soit non-filtré, soit filtré sur le même champ de recherche avec une valeur différente. 
Les onglets sont générés dynamiquement à partir des valeurs indexées pour le champ de recherche utilisé pour le filtre.

{{important|Cette implémentation est pour le moment mise en place dans le projet {{Pleade}} pour [[Doc/BM-Grenoble|BM-Grenoble]]. 
Sa généralisation et introduction dans Pleade Libre devra être étudiée ultérieurement. 
Elle sous-entend un gros travail d'adaptation et de généralisation, qui n'est pas fait pour l'instant.}}

== Configuration du menu dans Pleade ==
Dans Pleade, c'est le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} qui permet de configurer les menus affichés dans les pages. 
On introduit la configuration du nouveau menu à onglets dans ce fichier avec le fragment suivant :

=== Configuration dans menus.xconf ===

==== Fragment XML ====
Ci-dessous le fragment XML définissant le système d'onglets dans le menu
<syntaxhighlight lang="bash">
<menu type="htoptabs" id="htoptabs">

<item type="list">

<tab field="" value="">

<label>
<i18n:text key="menu-search-tabs.simple">toutes bibliothèques</i18n:text>
</label>

<item id="search-simple" type="form-embedded" ref="bmg-categorie" filtered-by-field="no" />
</tab>

<tab-repeat field="categorie" base="BMG">


<item id="search-categorie" type="form-embedded" ref="bmg-categorie" filtered-by-field="yes" />
</tab-repeat>
</item>
</menu>
</syntaxhighlight>

==== Explications et spécifications ====
Le menu est défini comme les autres menus par un noeud {{tag|menu}} caractérisé par les attributs {{attr|id}} et {{attr|type}}. 
Ces attributs sont utilisés par la feuille de style XSL {{path|/module-eadeac/xsl/search.xsl}} pour associer la configuration du menu au template dédié à son affichage dans les templates de pages Pleade.

Ce menu contient un unique noeud {{tag|item}} définissant le menu à onglets que nous souhaitons construire. 
Cet item est caractérisé par l'attribut {{attr|type}} avec la valeur spécifique {{cmd|"list"}} dédiée à la définition d'un menu à entrées multiples affichées sous forme d'onglets.

Les onglets du menu sont définis par des noeuds :
* {{tag|tab}} pour déclarer un unique onglet
* {{tag|tab-repeat}} pour déclarer des onglets répétés construits suivant le mécanisme suivant : les onglets sont construits dynamiquement à partir des valeurs indexées pour un champ de la base de documents.

Un noeud {{tag|tab}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|value}} : contient la valeur à appliquer au filtre

Un noeud {{tag|tab-repeat}} a les attributs optionnels suivants, qui permettent de caractériser le filtre à appliquer dans le formulaire incorporé à chaque onglet :
* {{attr|field}} : contient le nom du champ de filtrage
* {{attr|base}} : le nom de la base de documents, utilisée pour récupérer les valeurs d'index du champ de filtrage
{{remarque|La valeur à appliquer au filtre est obligatoirement la valeur d'index du champ correspondant à l'onglet.}}

Un noeud {{tag|tab}} ou {{tag|tab-repeat}} peut contenir les noeuds suivants :
* {{tag|label}} (optionnel) permettant de définir le libellé cliquable de l'onglet. Ce noeud doit généralement inclure l'appel à une clé i18n, sur le même modèle que tous les autres éléments de menus. Ce noeud n'est pas présent dans les noeuds {{tag|tab-repeat}}. En effet, dans ce cas, les libellés des onglets sont générés dynamiquement pour y faire figurer les valeurs indexées pour le champ de définition des onglets.
* {{tag|item}} permettant de définir le formulaire construit dynamiquement qui sera incorporé dans l'onglet

Le noeud {{tag|item}} définissant le formulaire de recherche embarqué dans l'onglet est défini par les attributs suivants :
* {{attr|id}} : un identifiant sur lequel seront construits les IDs nécessaires à la gestion JS des onglets
* {{attr|type}} : obligatoirement "form-embedded"
* {{attr|ref}} : le nom du formulaire incorporé dans l'onglet. Ce formulaire est défini par le fichier {{path|/module-eadeac/conf/search-forms/nom_formulaire.xconf}}
* {{attr|filtered-by-field}} : (yes | no) indique si le formulaire incorporé doit être filtré ou pas. Si un filtre doit être appliqué, les paramètres du filtre sont récupérés dans le noeud parent {{tag|tab}} ou {{tag|tab-repeat}}

=== Génération dynamique du menu à onglets ===

La génération des menus configurés dans le fichier {{path|{{var|$ROOT_PLEADE}}/module-eadeac/conf/menus.xconf}} est prise en charge par la feuille de style XSL {{path|/commons/xsl/pleade-menus.xsl}}. 
Les templates dédiés à la génération du menu à onglets incorporant des formulaires de recherche sont caractérisés par l'attribut {{attr|mode}} avec la valeur {{cmd|"import-form"}}

=== Génération dynamique des formulaires embarqués ===

[[category:BM-Grenoble]]
[[category:Pleade]]
[[category:Menu]]
[[category:Formulaire]]

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-14T09:49:45Z

Pdechandol : /* Génération dynamique du menu à onglets */

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-04T14:41:49Z

Pdechandol :

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-04T13:00:35Z

Pdechandol :

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-04T12:59:45Z

Pdechandol :

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-04T12:40:17Z

Pdechandol :

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-04T10:14:56Z

Pdechandol :

[[category:BM-Grenoble/Pleade]]

== Objectif ==
L'objectif est de créer, dans Pleade, un menu à onglets contenant des formulaires de recherche "fulltext" filtrés. 
Chaque onglet est soit non-filtré, soit filtré sur le même champ de recherche avec une valeur différente. 
Les onglets sont générés dynamiquement à partir des valeurs indexées pour le champ de recherche utilisé pour le filtre.

{{important|Cette implémentation est pour le moment mise en place dans le projet {{Pleade}} Pour [[Doc/BM-Grenoble|BM-Grenoble]]. 
Sa généralisation et introduction dans Pleade Libre devra être étudiée ultérieurement. 
Elle sous-entend un gros travail d'adaptation et de généralisation, qui n'est pas fait pour l'instant.}}

== Configuration du menu dans Pleade ==
Dans Pleade, c'est le fichier {{path|{{var|PLEADE}}/module-eadeac/menus.xconf}} qui permet de configurer les menus affichés dans les pages. 
On introduit la configuration du nouveau menu à onglets dans ce fichier avec le fragment suivant :

=== Configuration dans menus.xconf ===

==== Fragment XML ====
Ci-dessous le fragment XML définissant le système d'onglets dans le menu
<syntaxhighlight lang="bash">
<menu type="htoptabs" id="htoptabs">

<item type="list">

<tab field="" value="">

<label>
<i18n:text key="menu-search-tabs.simple">toutes bibliothèques</i18n:text>
</label>

<item id="search-simple" type="form-embedded" ref="bmg-categorie" filtered-by-field="no" />
</tab>

<tab-repeat field="categorie" base="BMG">


<item id="search-categorie" type="form-embedded" ref="bmg-categorie" filtered-by-field="yes" />
</tab-repeat>
</item>
</menu>
</syntaxhighlight>

==== Explications et spécifications ====

Implémentation de formulaires de recherche "fulltext" incorporés à des onglets de menus

2012-05-04T10:06:34Z

Pdechandol : Page créée avec « category:BM-Grenoble/Pleade == Objectif == L'objectif est de créer, dans Pleade, un menu à onglets contenant des formulaires de recherche "fulltext" filtrés. ... »

[[category:BM-Grenoble/Pleade]]

== Objectif ==
L'objectif est de créer, dans Pleade, un menu à onglets contenant des formulaires de recherche "fulltext" filtrés. 
Chaque onglet est soit non-filtré, soit filtré sur le même champ de recherche avec une valeur différente. 
Les onglets sont générés dynamiquement à partir des valeurs indexées pour le champ de recherche utilisé pour le filtre.

== Configuration du menu dans Pleade ==
Dans Pleade, c'est le fichier {{path|{{var|PLEADE}}/module-eadeac/menus.xconf}} qui permet de configurer les menus affichés dans les pages. 
On introduit la configuration du nouveau menu à onglets dans ce fichier avec le fragment suivant :

=== Configuration dans menus.xconf ===

==== Fragment XML ====
Ci-dessous le fragment XML définissant le système d'onglets dans le menu
<syntaxhighlight lang="bash">
<menu type="htoptabs" id="htoptabs">

<item type="list">

<tab field="" value="">

<label>
<i18n:text key="menu-search-tabs.simple">toutes bibliothèques</i18n:text>
</label>

<item id="search-simple" type="form-embedded" ref="bmg-categorie" filtered-by-field="no" />
</tab>

<tab-repeat field="categorie" base="BMG">


<item id="search-categorie" type="form-embedded" ref="bmg-categorie" filtered-by-field="yes" />
</tab-repeat>
</item>
</menu>
</syntaxhighlight>

==== Explications et spécifications ====