Datenbankvorlagen

Vorlagen für Datenbanken erlauben Ihnen die volle Kontrolle über das Aussehen der Datenbankeinträge, wenn Sie diese in einer Liste oder einzeln betrachten, aber auch bei der Eingabe der Einträge. Diese Funktionalität ist ähnlich wie in den Serienbrieffunktionen gängiger Textverarbeitungsprogramme. Sie verwenden Platzhalter, die später durch die eigentlichen Einträge ersetzt werden.

Verwendung von Tags

Der Inhalt jedes Datenbankfeldes, das Sie in Ihrer Datenbank anlegen, und einige spezielle Tags können in die Datenbankvorlage eingearbeitet werden.

Felder werden im Format [[fieldname]] angegeben. Alle anderen Tags sehen so aus: ##sometag##.

Um die einzelnen Tags, die in der Box links auf der Seite zur Verfügung stehen, Ihrer Vorlage hinzuzufügen, nutzen Sie den Editor (HTML-Modus ausgeschaltet). Positionieren Sie den Cursor an der Stelle, an der Sie eines der Felder oder Elemente einfügen möchten. Klicken Sie nun links auf den gewünschten Eintrag, und das Feld / Tag wird an der korrekten Stelle übernommen. Alternativ können Sie die Platzhalter auch manuell einfügen, in dem Sie die entsprechenden Werte und die benötigten Symbole eintippen: ##this## oder [[this]].

Tags, die sich auf die Felder der Datenbank beziehen, müssen in doppelten eckigen Klammern den Namen des Datenbankfelds enthalten: [[fieldname#TAGNAME]]. Folgende Tags stehen zur Verfügung:

[[fieldname]] wird ersetzt durch den Wert von fieldname.
[[fieldname#name]] wird ersetzt durch den Namen des Feldes.
[[fieldname#description]] wird ersetzt durch die Beschreibung des Feldes.

Außerdem können Sie die folgenden Tags in den Vorlagen verwenden:

##actionsmenu## erzeugt ein Auswahlmenü mit Aktionen, die Nutzer/innen mit dem aktuellen Datenbankeintrag ausführen können. Das ist die empfohlene Vorgehensweise, um Aktionen mit einem Datenbankeintrag auszuführen. Aus älteren Moodle-Versionen sind jedoch weiterhin folgende Tags für einzelne Aktionen verfügbar: ##edit##, ##delete##, ##approve## oder ##disapprove##.
##more## erzeugt einen Link zur Einzelansicht eines Eintrages, so können alle Informationen des Eintrages aufgerufen werden.
##moreurl## erzeugt nur die URL für den oben erwähnten Link. Dies ist hilfreich, wenn Sie Ihre eigenen Links nutzen möchten. Sie können auf das Link-Symbol klicken und schreiben ##moreurl## in das URL-Feld, oder Sie schreiben im HTML-Modus
```
<a href="##moreurl##">[[fieldname]]</a>
```
##timeadded## zeigt an, wann der Eintrag hinzugefügt wurde.
##timemodified## zeigt an, wann der Eintrag zum letzten Mal bearbeitet wurde.
##userpicture## zeigt das Nutzerbild in der Listenansicht an.
##approvalstatus## sorgt dafür, das noch nicht freigegebene Einträge hervorgehoben angezeigt werden.
##tags## zeigen Schlagwörter an.

Vorlage für Listenansicht

Mit dieser Vorlage können Sie die Ansicht der Felder und das Layout der Seite festlegen, die mehrere Einträge auf einmal anzeigt (z.B. Suchergebnisse). Mit dieser Ansicht ist es z.B. möglich, eine einfache Übersicht über alle Einträge zur Verfügung zu stellen. Weiterführende Informationen zu den einzelnen Einträgen erhält man, wenn man auf den jeweiligen Eintrag klickt.

Siehe Anleitung, wie man eine Vorlage für eine Listenansicht in Form einer Tabelle erstellt.

Die Vorlage für die Listenansicht kann auch genutzt werden, um die Datenbank in eine CSV-Datei zu exportieren.

Vorlage für Einzelansicht

Mit dieser Vorlage legen Sie feste, wie ein einzelner Datenbankeintrag angezeigt wird. Bei dieser Einzelansicht steht Ihnen mehr Platz zur Anzeige des Eintrages zur Verfügung, und Sie können neben allen Feldern, die dieser Eintrag umfasst, auch größere Bilder als in der Listenansicht zur Verfügung stellen.

Vorlage zur erweiterten Suche

Die Vorlage für die erweiterte Suche erlaubt eine Anpassung der Ansicht der Suchergebnisse.

Vorlage für Einträge hinzufügen

Mit dieser Vorlage bestimmen Sie, wie die Seite aussieht, auf der Sie einen Datenbankeintrag neu hinzufügen oder bearbeiten.

Vorlage für RSS-Feed

Mittels der Vorlage für RSS-Feeds können Sie den Inhalt Ihres RSS-Feeds zur Datenbank bestimmen.

Nutzerdefiniertes CSS

Wenn Sie in Ihrer Datenbank HTML-Tags verwenden, die spezielle Formatierungen via CSS benötigen, so können Sie hier die datenbankspezifische CSS-Datei bearbeiten.

Nutzerdefiniertes JavaScript

Sie können JavaScript zur Manipulation der Elemente nutzen, die in der Listen- oder Einzelansicht sowie beim Hinzufügen von Datensätzen angezeigt werden. Prinzipiell müssen Sie den Teil, den Sie bearbeiten möchten, in ein benanntes HTML-Element einschließen. Die Benennung ist wichtig, da sie es erlaubt, das Element bei der Bearbeitung eindeutig zu identifizieren.

Beispiel: Sie haben ein Feld in Ihrer Datenbank, welches den Namen ein Person speichert, und wenn Sie die Namen in der Listenansicht ansehen, möchten Sie bestimmte Vorkommen von Namen zählen und das Ergebnis anzeigen lassen.

Ihre Datenbank beinhaltet nun ein Feld Name. In Ihrer Listenansicht können Sie dieses Feld durch [[name]] an der Stelle anzeigen lassen, wo Sie es benötigen. Zum Beispiel haben Sie dann im Eingabebereich Wiederholter Bereich stehen:

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

Nun müssen Sie diesen Code bearbeiten um sicherzustellen, dass der Teil, den Sie mittels JavaScript verarbeiten möchten, ein benanntes HTML-Element ist.

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

Im Fußzeilenbereich Ihrer Listenansicht können Sie ein weiteres benanntes Feld einfügen, um zum Beispiel das Ergebnis anzuzeigen.

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

Ihre JavaScript-Vorlage kann nun zum Beispiel so aussehen:

 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;

Dieser Code zeigt eine Tabelle aller Namen in der Listenansicht an, ohne sie zu verändern. In der Fußzeile hingegen wird noch die Anzahl der Namen angezeigt, die mit foo oder Foo übereinstimmen.

Vorlagen zurücksetzen

Wenn Sie zum ersten Mal eine Datenbank erstellen, sind die Vorlagen mit einem entsprechenden HTML-Code gefüllt. Wenn Sie später Felder hinzufügen, dann können Sie die Schaltfläche Vorlage zurücksetzen nutzen, um eine ähnliche Standard-HTML-Formatierung zu erzeugen. Haben Sie jedoch bereits Änderungen an der Vorlage durchgeführt, dann gehen diese bei nun verloren. Daher wird empfohlen, zuerst alle Datenbankfelder anzulegen und erst zum Schluss die Vorlagen zu bearbeiten.

Siehe auch

Vorlagensätze verwenden
Video, das die Verwendung von Elementen (Tags) demonstriert

Diskussionsbeiträge im Kurs Using Moodle:

Documentation