Attention : vous consultez actuellement la documentation dédiée aux versions 2.x de Moodle. La documentation pour les versions 3.x de Moodle est consultable ici : Modèles et celle pour Moodle 4.x est consultable là : Modèles.

« Modèles » : différence entre les versions

De MoodleDocs
Aller à :navigation, rechercher
 
(15 versions intermédiaires par 2 utilisateurs non affichées)
Ligne 6 : Ligne 6 :


Le contenu de chaque [[Champ]] que vous créez pour votre base de données et quelques balises spéciales (énumérées ci-dessous) peuvent être insérés dans des modèles.
Le contenu de chaque [[Champ]] que vous créez pour votre base de données et quelques balises spéciales (énumérées ci-dessous) peuvent être insérés dans des modèles.
Les champs on des formats <code><nowiki>[[nomduchamp]]</nowiki></code>. Toutes les autres balises ont le format <code>##balise##</code>.
Les champs ont des formats <code><nowiki>[[nomduchamp]]</nowiki></code>. Toutes les autres balises ont le format <code>##balise##</code>.


Pour utiliser les balises dans la boîte du côté gauche, utilisez l'éditeur HTML, placez votre curseur sur la zone de texte de votre cible et cliquez sur la balise de votre choix. Autrement, vous pouvez simplement taper le nom de la balise désirée comme ceci <code>##this##</code> ou comme <code><nowiki>[[this]]</nowiki></code>.
Pour utiliser les balises dans la boîte du côté gauche, utilisez l'éditeur HTML, placez votre curseur sur la zone de texte de votre cible et cliquez sur la balise de votre choix. Autrement, vous pouvez simplement taper le nom de la balise désirée comme <code>##ceci##</code> ou comme <code><nowiki>[[ceci]]</nowiki></code>.


* <code>##edit##</code> crée un lien avec icône permettant d'éditer votre donnée (disponible seulement si vous avez les permissions requises)  
* <code>##edit##</code> crée un lien avec icône permettant d'éditer votre donnée (disponible seulement si vous avez les permissions requises)  
* <code>##delete##</code> crée un lien permettant de supprimer votre donnée (disponible seulement si vous avez les permissions requises)
* <code>##delete##</code> crée un lien permettant de supprimer votre donnée (disponible seulement si vous avez les permissions requises)
* <code>##approve##</code> crée un lien permettant d'approuver la donnée (disponible seulement si vous avez les permissions requises)
* <code>##approve##</code> crée un lien permettant d'approuver la donnée (disponible seulement si vous avez les permissions requises)
* <code>##more##</code> crée un lien pour l'affichage fiche, pouvant contenir plus d'info
* <code>##more##</code> crée un lien pour l'affichage fiche, pouvant contenir plus d'informations
* <code>##moreurl##</code> crée le URL du lien ci-dessus. Utile pour créer vos propres liens. Vous pouvez cliquer sur l'icône du lien et taper <code>##moreurl##</code> dans un champ URL ou dans le type vue code source <pre><a href="##moreurl##">[[nomduchamp]]</a></pre>
* <code>##moreurl##</code> crée l'URL du lien ci-dessus. Utile pour créer vos propres liens. Vous pouvez cliquer sur l'icône du lien et taper <code>##moreurl##</code> dans un champ URL ou dans le type vue code source <pre><a href="##moreurl##">[[nomduchamp]]</a></pre>
* <code>##comments##</code> creates a link to the view/edit comments page, the link text is the current number of comments (only appears if comments are turned on)
* <code>##comments##</code> crée un lien pour visualiser/éditer des commentaires, le lien texte est le nombre de commentaires (disponible seulement si les commentaires sont activés)
* <code>##user##</code> creates a link to the user page of the user who submitted the entry, link text is their name
* <code>##user##</code> crée un lien pour la page de l'utilisateur qui entre la donnée
* <code>##timeadded##</code>
* <code>##timeadded##</code>
* <code>##timemodified##</code>
* <code>##timemodified##</code>


== List template ==
== Modèle liste ==


This template allows you to control the fields used and their layout when viewing multiple entries at once (e.g. search results). It is possible that this view may simply provide an overview with more detailed information available by clicking on an entry to access the single view of the entry.
Ce modèle permet le contrôle des champs utilisés et leur positionnement lorsqu'on visionne plusieurs entrées à la fois (ex: résultats de recherche). Il est possible que cette vue fournisse simplement un aperçu avec plus d'informations détaillés. En cliquant sur la fiche, on accède à la vue Affichage fiche.


See [http://tracker.moodle.org/secure/attachment/23333/moodle_databse_activity_list_formatting.pdf Designing a list view in Moodle database activity] for instructions on how to create a list template table.
Le modèle liste peut servir comme moyen d'exporter votre base de donnée sous un fichier CSV.


The list template can also be used as a way to [[Database export|export your database]] as a CSV file.
== Modèle fiche ==
Cette vue est utilisé pour montrer une fiche à la fois donnant plus d'espace pour l'affichage d'information tel que les grandes images ou simplement plus de détails concernant une fiche lorsque l'espace est requise.


== Single template ==
== Modèle recherche avancée ==
This is used to display a single entry at a time and so has more space for display and can use, for example, larger versions of images or optionally provide more information than shown in the list view.


[[Image:Databasesingletemplate.png]]
Le modèle de recherche avancée est pour créer une interface qui sera utilisée par le moteur de recherche avancée.


== Advanced search template ==
== Modèle nouvelle fiche ==


An advanced search template is for creating the interface form used in the advanced search.  
Ce modèle crée une interface qui sera utilisé pour ajouter ou modifier des fiches.


== Add template ==
== Modèle RSS ==


This template creates the interface form used when adding or editing database entries.  
Vous laisse contrôler le contenu du flux RSS pour la base de données.


== RSS template ==
== Modèle CSS ==


Lets you control the content of the [[RSS]] feed for database entries.
Si un de vos modèles HTML requiert [[CSS]] afin d'afficher des styles particuliers, vous pouvez les spécifier ici.


== CSS template ==
== Modèle Javascript ==


If any of the [[HTML in Moodle|HTML]] in your other templates requires [[CSS]] to provide visual style you can specify it here.
Vous pouvez utiliser javascript pour manipuler la manière dont les éléments seront affichés dans le mode liste, fiche ou nouvelle fiche. Vous devez joindre les parties que vous voulez manipuler dans un élément HTML. La nomenclature est essentielle étant donné qu'elle vous permet d'identifier les éléments à manipuler.


== Javascript template ==
Par exemple, vous désirez qu'un champ prenant le nom d'un utilisateur compte le nombre de fois qu'un nom corresponde à certains critères puis les affichent.


You can use javascript to manipulate the way elements are displayed in either the List, Single or Add templates. Basically you need to enclose the part you want to manipulate in some named html element. The naming is essential as it allows you to identify the element for manipulation.
Votre base de données contiendra un champ nommé "nom". Dans votre modèle Liste, vous pourrez afficher le contenu de ce champ en utilisant le format <nowiki>[[nom]]</nowiki> à l'endroit où vous désirez afficher cet information. Par exemple, dans le ''Repeated entry'' sur le modèle Liste vous aurez:
 
Let's say, for example, you have a field in your database that stores a person's name and when you display the names in the List View you want to count the times a name matches some criteria and display the result.
 
Your database will contain a field which we will call "name". In your List template you will be able to display the contents of that field by using the <nowiki>[[name]]</nowiki> construct at the place where you want that information displayed. For example in the ''Repeated entry'' on the list template you will have


<pre>
<pre>
Ligne 65 : Ligne 61 :
</pre>
</pre>


You now need to modify that entry to ensure that the part you want to manipulate is a named element.
Vous avez maintenant besoin de modifier cette entrée pour assurer que votre élément soit identifié afin de le manipuler.


<pre>
<pre>
Ligne 75 : Ligne 71 :
</pre>
</pre>


The footer of your list view can then contain another named element to display the result.
Le pied de page de votre affichage liste peut maintenant contenir un autre élément pour afficher le résultat.


<pre>
<pre>
Ligne 81 : Ligne 77 :
</pre>
</pre>


Your javascript template can now look as follows
Votre modèle JavaScript peut ressembler comme suit


<pre>
<pre>
Ligne 99 : Ligne 95 :
</pre>
</pre>


This will display a table of names as is usual in the list view. Now at the bottom there will also be the count of the names that matched foo or Foo.
Ceci affichera un tableau de noms comme dans l'affichage liste. Or, le décompte de noms associés à foo ou Foo sera également dans le bas.


== Reset templates button ==
== Réinitialiser le modèle ==


When you first create a database the templates will be pre-filled with appropriate HTML. If you later add fields then you can press the ''reset templates'' button and it will add HTML for the new fields in a similar fashion. If you have edited any of the templates in the meantime then your changes will be lost. It is recommended that you finalize the database fields before changing the template code.
Lorsqu'une base de données est crée, les modèles seront pré-remplis avec un code HTML de base. Si plus tard vous décidez d'ajouter des champs, vous devrez cliquer sur le bouton ''Réinitialiser le modèle'' pour que ceux-ci soient ajoutés au code HTML. Si vous modifiez n'importe quel champ entre temps, vos changements seront perdus. Il est recommandé de finaliser les champs avant de modifier le code du modèle.


==See also==
== Voir aussi ==
*[[Database presets]]
*[http://video.google.com/videoplay?docid=7026851446099005477 Video demonstrating tag usage]
*[http://video.google.com/videoplay?docid=7026851446099005477 Video demonstrating tag usage]


Using Moodle forum discussions:  
Discussions sur les forums de "Using Moodle" (en anglais) :
*[http://moodle.org/mod/forum/discuss.php?d=55338 Look of the database module]
*[http://moodle.org/mod/forum/discuss.php?d=55338 Look of the database module]
*[http://moodle.org/mod/forum/discuss.php?d=74243 How can I list database information horizontally instead of vertically?]
*[http://moodle.org/mod/forum/discuss.php?d=74243 How can I list database information horizontally instead of vertically?]
Ligne 116 : Ligne 111 :
*[http://moodle.org/mod/forum/discuss.php?d=86927 Time stamp for database entries?]
*[http://moodle.org/mod/forum/discuss.php?d=86927 Time stamp for database entries?]


[[en:Database templates]]
[[de:Datenbank-Vorlagen]]
[[de:Datenbank-Vorlagen]]
[[fr:Modèles]]
[[ru:Шаблоны]]
[[ja:データベーステンプレート]]
[[ja:データベーステンプレート]]

Dernière version du 5 août 2013 à 19:41

Les modèles pour le module Base de données permettent de contrôler le format visuel de l'information lors de la visualisation des listes ou lors de l'édition des données. C'est la même technique du publipostage dans les logiciels tels que Open Office Writer et Microsoft Word.


Usage des balises

Le contenu de chaque Champ que vous créez pour votre base de données et quelques balises spéciales (énumérées ci-dessous) peuvent être insérés dans des modèles. Les champs ont des formats [[nomduchamp]]. Toutes les autres balises ont le format ##balise##.

Pour utiliser les balises dans la boîte du côté gauche, utilisez l'éditeur HTML, placez votre curseur sur la zone de texte de votre cible et cliquez sur la balise de votre choix. Autrement, vous pouvez simplement taper le nom de la balise désirée comme ##ceci## ou comme [[ceci]].

  • ##edit## crée un lien avec icône permettant d'éditer votre donnée (disponible seulement si vous avez les permissions requises)
  • ##delete## crée un lien permettant de supprimer votre donnée (disponible seulement si vous avez les permissions requises)
  • ##approve## crée un lien permettant d'approuver la donnée (disponible seulement si vous avez les permissions requises)
  • ##more## crée un lien pour l'affichage fiche, pouvant contenir plus d'informations
  • ##moreurl## crée l'URL du lien ci-dessus. Utile pour créer vos propres liens. Vous pouvez cliquer sur l'icône du lien et taper ##moreurl## dans un champ URL ou dans le type vue code source
    <a href="##moreurl##">[[nomduchamp]]</a>
  • ##comments## crée un lien pour visualiser/éditer des commentaires, le lien texte est le nombre de commentaires (disponible seulement si les commentaires sont activés)
  • ##user## crée un lien pour la page de l'utilisateur qui entre la donnée
  • ##timeadded##
  • ##timemodified##

Modèle liste

Ce modèle permet le contrôle des champs utilisés et leur positionnement lorsqu'on visionne plusieurs entrées à la fois (ex: résultats de recherche). Il est possible que cette vue fournisse simplement un aperçu avec plus d'informations détaillés. En cliquant sur la fiche, on accède à la vue Affichage fiche.

Le modèle liste peut servir comme moyen d'exporter votre base de donnée sous un fichier CSV.

Modèle fiche

Cette vue est utilisé pour montrer une fiche à la fois donnant plus d'espace pour l'affichage d'information tel que les grandes images ou simplement plus de détails concernant une fiche lorsque l'espace est requise.

Modèle recherche avancée

Le modèle de recherche avancée est pour créer une interface qui sera utilisée par le moteur de recherche avancée.

Modèle nouvelle fiche

Ce modèle crée une interface qui sera utilisé pour ajouter ou modifier des fiches.

Modèle RSS

Vous laisse contrôler le contenu du flux RSS pour la base de données.

Modèle CSS

Si un de vos modèles HTML requiert CSS afin d'afficher des styles particuliers, vous pouvez les spécifier ici.

Modèle Javascript

Vous pouvez utiliser javascript pour manipuler la manière dont les éléments seront affichés dans le mode liste, fiche ou nouvelle fiche. Vous devez joindre les parties que vous voulez manipuler dans un élément HTML. La nomenclature est essentielle étant donné qu'elle vous permet d'identifier les éléments à manipuler.

Par exemple, vous désirez qu'un champ prenant le nom d'un utilisateur compte le nombre de fois qu'un nom corresponde à certains critères puis les affichent.

Votre base de données contiendra un champ nommé "nom". Dans votre modèle Liste, vous pourrez afficher le contenu de ce champ en utilisant le format [[nom]] à l'endroit où vous désirez afficher cet information. Par exemple, dans le Repeated entry sur le modèle Liste vous aurez:

 <table>
   <tr>
     <td>Name: [[name]]</td>
   </tr>
 <table>  

Vous avez maintenant besoin de modifier cette entrée pour assurer que votre élément soit identifié afin de le manipuler.

 <table>
   <tr>
     <td name="named">Name: [[name]]</td>
   </tr>
 <table>  

Le pied de page de votre affichage liste peut maintenant contenir un autre élément pour afficher le résultat.

  <div name="result"></div>

Votre modèle JavaScript peut ressembler comme suit

 var cnt = 0;
 var re = /foo|Foo/;
 
 function init(){
   var namedElements = document.getElementsByName("named");
   for (i=0; i < namedElements.length; i++) {
       if(re.test(namedElements[i].innerHTML)) cnt++;
     }
   var namedResult = document.getElementsByName("result");
   namedResult[0].innerHTML = cnt;
   }
 
 window.onload = init;

Ceci affichera un tableau de noms comme dans l'affichage liste. Or, le décompte de noms associés à foo ou Foo sera également dans le bas.

Réinitialiser le modèle

Lorsqu'une base de données est crée, les modèles seront pré-remplis avec un code HTML de base. Si plus tard vous décidez d'ajouter des champs, vous devrez cliquer sur le bouton Réinitialiser le modèle pour que ceux-ci soient ajoutés au code HTML. Si vous modifiez n'importe quel champ entre temps, vos changements seront perdus. Il est recommandé de finaliser les champs avant de modifier le code du modèle.

Voir aussi

Discussions sur les forums de "Using Moodle" (en anglais) :