MetaModels Backend: Attribute: Unterschied zwischen den Versionen

Aus Contao Community Documentation

(Übersetzte Auswahl)
(Langtext (Longtext))
 
(141 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{stub}}
+
[[Category:MetaModels|M1]]
[[Category:MetaModels]]
+
 
+
 
=Allgemeines zu den Attributen=
 
=Allgemeines zu den Attributen=
 
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
 
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
 
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
 
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
# [[MetaModels_Backend:_Paletteneinstellungen| MetaModels Paletteneinstellungen]]
+
# [[MetaModels_Backend:_Eingabemaske| MetaModels Eingabemaske]]
 
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
 
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
 
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]
 
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]
  
 
==Was sind eigentlich Attribute?==
 
==Was sind eigentlich Attribute?==
[[File:mm_attribut_settings_eingabemaske.png|thumb|365px]]
+
[[File:icons_attribute.png|left|32px]]
 +
Grob gesagt: die Datenbank-Objekte (aka Datensatz), die in den MetaModels erfasst werden, setzen sich aus den verschiedensten Attributen (aka Eigenschaften oder Feldern) zusammen.
 +
<div style="clear: both"></div>
  
Grob gesagt: die Datenbank-Objekte, die in den MetaModels erfasst werden, setzen sich aus den verschiedensten Attributen zusammen. Name und Beschreibung eines Objektes, die Fotos, die das Objekt illustrieren, eine Checkbox, mit der ein Eintrag veröffentlicht werden kann - all das wird in Attributen abgelegt. Jedes Attribut entspricht also einer Spalte in der Datenbank-Tabelle.
+
=Einstieg=
Aus den verschiedenen Attributen stellt man die Eingabemaske für die einzelnen Datensätze zusammen. Für jeden Attributtyp gibt es verschiedenste Einstellungen, die im Folgenden beim jeweiligen Attribut erläutert werden.
+
[[File:mm_backend_attribute_liste.png|thumb|365px]]
 +
Über '''Neues Attribut''' erfasst man die gewünschten Attribute. Name und Beschreibung eines Objektes, die Fotos, die das Objekt illustrieren, eine Checkbox, mit der ein Eintrag veröffentlicht werden kann - all das wird in Attributen abgelegt. Jedes Attribut entspricht also einer Spalte in der Datenbank-Tabelle.
 +
Aus den verschiedenen Attributen stellt man die Eingabemaske für die einzelnen Datensätze zusammen. Für jeden Attributtyp gibt es diverse Einstellungen, die im Folgenden beim jeweiligen Attribut erläutert werden.
 +
<div style="clear: both"></div>
  
Mit einem Klick auf "Neues Attribut" erstellt man - no na - ein neues Attribut. Zuerst wird der Attributtyp ausgewählt. Für '''jedes''' Attribut müssen dann '''Basis-Attributkonfigurationen''' festgelegt werden:
+
==Attribut definieren==
 +
[[File:mm_attribut_settings_eingabemaske.png|thumb|365px]]
 +
Mit einem Klick auf das Icon Bearbeiten fängt man an. Zuerst wird der Attributtyp ausgewählt. Für '''jedes''' Attribut müssen dann '''Basis-Attributkonfigurationen''' festgelegt werden:
  
* '''Attribute Type'''
+
* '''Attribut-Typ''': Typ (gesamte Liste siehe weiter unten)
* '''Column Name''' (Name der Tabellenspalte in der Datenbank)
+
* '''Spaltenname''' (Name der Tabellenspalte in der Datenbank)
 
* '''Name''' (Name der Feldüberschrift bei der Erfassung des Datensatzes)
 
* '''Name''' (Name der Feldüberschrift bei der Erfassung des Datensatzes)
* '''Description''' (Beschreibung unterhalb des Feldes bei der Erfassung des Datensatzes)
+
* '''Beschreibung''' (Beschreibung unterhalb des Feldes bei der Erfassung des Datensatzes)
  
  
Bei allen Attributen findet man unter den '''erweiterten Einstellungen''' (Advanced settings) noch die Checkbox "'''Unique values'''" - wird diese angehakt, kann für das betreffende Attribut jeder Wert nur einmal verwendet werden.
+
Bei allen Attributen findet man unter den '''Erweiterten Einstellungen''' (Advanced settings) noch die Checkbox '''Eindeutige Werte''' (Unique values) - wird diese angehakt, kann für das betreffende Attribut jeder Wert nur einmal verwendet werden.
  
 
Den Einträgen, die man unter '''Name''' und '''Beschreibung''' eingibt, begegnet man später in der Eingabemaske wieder (siehe rote Markierung im Screenshot).
 
Den Einträgen, die man unter '''Name''' und '''Beschreibung''' eingibt, begegnet man später in der Eingabemaske wieder (siehe rote Markierung im Screenshot).
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Alias=
+
=Attribute=
 
+
==Alias==
 
[[File:mm_attribut_alias.png|thumb|365px]]
 
[[File:mm_attribut_alias.png|thumb|365px]]
  
Zeile 35: Zeile 40:
  
 
'''Advanced Settings'''
 
'''Advanced Settings'''
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
*'''Eindeutige Werte'''
*'''Force alias regenerating''': Anhaken, sich das Alias automatisch anpassen soll, wenn immer der Wert des zugewiesenen Feldes geändert wird (ist etwas buggy, Stand:März 2013)
+
*'''Neuerstellung des Alias erzwingen.''': Anhaken, wenn sich das Alias automatisch anpassen soll, wenn immer der Wert des zugewiesenen Feldes geändert wird (ist etwas buggy, Stand:März 2013)
*'''Alias fields''': Attribut, aus dem das Alias generiert wird
+
*'''Alias-Felder''': Attribut, aus dem das Alias generiert wird. Es können auch mehrere Attribute definiert werden. In diesem Fall werden die einzelnen Attribute über einen Bindestrich zu einem Alias zusammengefügt.
 
  <div style="clear: both"></div>
 
  <div style="clear: both"></div>
  
=Auswahl=
+
==Auswahl (Select)==
  
 
[[File:mm_attribut_select.png|thumb|365px]]
 
[[File:mm_attribut_select.png|thumb|365px]]
 
Das Attribut '''Auswahl''' erzeugt ein HTML-Select.
 
Das Attribut '''Auswahl''' erzeugt ein HTML-Select.
  
'''Advanced Settings'''
+
'''Anzeigeeinstellungen'''
* '''select_table''': Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen
+
* '''select_table''': Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen, auch die mit MetaModels erstellten (siehe Hinweis weiter unten)
 
* '''select_id''': Vorzugsweise '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
 
* '''select_id''': Vorzugsweise '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
 
* '''select_column''': Namen der Spalte auswählen, der die Werte des Selects zur Verfügung stellt
 
* '''select_column''': Namen der Spalte auswählen, der die Werte des Selects zur Verfügung stellt
 
* '''select_alias''': Vorzugsweise das '''alias''' auswählen
 
* '''select_alias''': Vorzugsweise das '''alias''' auswählen
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
*'''Auswahl-Sortierung''': Hier lässt sich einstellen, in welcher Reihenfolge die Begriffe im Select erscheinen sollen
 +
*'''SQL''': Die Auswahlmöglichkeiten lassen sich per SQL einschränken
  
 +
Hinweis: Um das Attribut '''Auswahl''' anlegen zu können, muss man zuerst eine neue Tabelle (sprich ein neues MetaModel) erstellen, in der die Select-Werte angelegt werden.
 +
Die genaue Vorgehensweise ist [[MetaModels_Beispiel_4|hier]] beschrieben. Erst dann kann man unter '''select_table''' die betreffende Tabelle auswählen.
  
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Checkbox=
+
==Bewertung (Rating)==
 +
[[File:mm_attribut_rating.png|thumb|365px]]
 +
Das Attribut '''Bewertung''' erzeugt eine Aufzählung von Icons. Standardmässig werden Sterne angezeigt. Man kann aber auch eigene definieren.
  
[[File:mm_attribut_checkbox.png|thumb|365px]]
+
'''Beispiel'''<br>
 +
[[File:mm_attribut_rating_beispiel.png|link=]]
  
Das Attribut '''Checkbox''' erzeugt eine einfache HTML Checkbox.
+
'''Bitte beachten'''<br>
 
+
Das Attribut benötigt die beiden PHP-Dateien '''SimpleAjax.php''' und '''SimpleAjaxFrontend.php''', welche mit dem aktuellen Nightly Build ausgeliefert werden.<br>
'''Advanced settings'''
+
Die beiden PHP-Dateien müssen im Root-Verzeichnis der Contao-Installation abgelegt werden.
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
<div style="clear: both"></div>
*'''Check Published''': Erzeugt im Backend die Option, einen Datensatz freizugeben (Icon 'Auge')
+
  
 +
==Color picker (Farbe)==
 +
[[File:mm_attribut_color.png|thumb|365px]]
 +
Das Attribut '''Color picker''' erzeugt zwei Eingabefelder (Hex Farbangabe) und einen Farbwähler
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Datei=
+
==Datei (File)==
 
+
 
[[File:mm_attribut_datei.png|thumb|365px]]
 
[[File:mm_attribut_datei.png|thumb|365px]]
 +
Das Attribut '''Datei''' erzeugt ein Wurzelverzeichnis, aus dem sich einzelne Dateien oder Order anwählen lassen.
 +
<div style="clear: both"></div>
  
Funktionen und Konfigurationseinstellungen
+
==Dezimal (Decimal)==
 
+
[[File:mm_attribut_dezimal.png|thumb|365px]]
 +
Das Attribut '''Dezimal''' erzeugt ein einzeiliges Eingabefeld und nimmt eine Feldprüfung vor
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Datum=
+
==GeoProtection==
 +
[[File:mm_attribut_geoprotection.png|thumb|365px]]
 +
Das Attribut '''GeoProtection''' erzeugt ein HTML-Select. Als Optionen stehen die angewählten Länder zur Verfügung.<br />
 +
Es bietet die Möglichkeit Datensätze so zu konfigurieren, das sie für ausgewählte Länder sichtbar sind oder versteckt werden.
  
Funktionen und Konfigurationseinstellungen<br>
+
'''Bitte beachten'''<br>
Dieses Attribut gibt es aktuell noch nicht, auf GitHub wurde aber ein [https://github.com/MetaModels/core/issues/24 Feature-Request]
+
Dieses Attribut benötigt die Extension [https://contao.org/de/extension-list/view/geoprotection.de.html geoprotection], ansonsten wird eine [https://community.contao.org/de/showthread.php?38172-Erste-Gehversuche&amp;p=248078&amp;viewfull=1#post248078 Fehlermeldung] rausgeworfen.
eingetragen.
+
Und wird nicht mit den Nightly Builds geladen, kann aber bei [https://github.com/MetaModels/attribute_geoprotection GitHub] separat runtergeladen werden
 +
<div style="clear: both"></div>
  
=Dezimal=
+
==Kombinierte Einträge (Combined Values)==
 +
[[File:mm_attribut_combinedvalues.png|thumb|365px]]
  
[[File:mm_attribut_dezimal.png|thumb|365px]]
+
Das Attribut '''Kombinierte Einträge''' erzeugt ein...
Das Attribut '''Dezimal''' erzeugt ein einzeiliges Eingabefeld und nimmt eine Feldprüfung vor
+
  
'''Advanced settings'''
 
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
 
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=GeoProtection=
+
==Kontrollkästchen (Checkbox)==
 +
[[File:mm_attribut_checkbox.png|thumb|365px]]
 +
Das Attribut '''Kontrollkästchen''' erzeugt eine einfache HTML-Checkbox.
  
Funktionen und Konfigurationseinstellungen<br>
+
'''Erweiterte Einstellungen'''
Benötigt die Extension [https://contao.org/de/extension-list/view/geoprotection.de.html geoprotection], ansonsten wird eine [https://community.contao.org/de/showthread.php?38172-Erste-Gehversuche&amp;p=248078&amp;viewfull=1#post248078 Fehlermeldung] rausgeworfen.
+
*'''Eindeutige Werte'''
 +
*'''Veröffentlichen''': Erzeugt im Backend (in der Listenansicht mit Icon 'Auge') die Option, einen Datensatz für das Frontend freizugeben. Hierzu muss aber auch ein Filter definiert werden. Die genaue Vorgehensweise ist  [[MetaModels_Beispiel_3#Published_Filter_im_Frontend_einbauen|hier]] beschrieben.
 +
<div style="clear: both"></div>
  
=Longtext=
+
==Land (Country)==
 +
[[File:mm_attribut_land.png|thumb|365px]]
 +
Das Attribut '''Land''' erzeugt ein HTML-Select, welches alle Länder enthält.
 +
<div style="clear: both"></div>
 +
[[File:mm_attribut_land_filter.png|thumb|365px]]
 +
'''Verfügbare Länder filtern'''<br>
 +
Wenn dieses Feld leer ist, werden automatisch alle Länder im Select angezeigt. Die Auflistung lässt sich verkürzen, indem man nur die gewünschten Länder hier auflistet.
 +
<div style="clear: both"></div>
  
 +
==Langtext (Longtext)==
 
[[File:mm_attribut_longtext.png|thumb|365px]]
 
[[File:mm_attribut_longtext.png|thumb|365px]]
 
 
Das Attribut '''Langtext''' erzeugt eine Textarea.
 
Das Attribut '''Langtext''' erzeugt eine Textarea.
  
'''Advanced settings'''
+
<span style="color:red">Es stehen 3 Richtext-Editoren zur Verfügung: tinyFlash, tinyMCE und tinyNews.</span><br>
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
Eigens angepasste RTEs können hier ausgewählt werden, sofern sie auch angelegt wurden, bspw. in einer ''tinyCustom.php''.
 +
<div style="clear: both"></div>
  
Es stehen 3 Richtext-Editoren zur Verfügung: tinyFlash, tinyMCE und tinyNews.
+
[[File:mm_paletteneinstellungen_longtext.png|thumb|365px]]
Diese können über die Paletteneinstellungen aktiviert werden.
+
Die <span style="color:red">Richtext-Editoren</span> können über die [[MetaModels_Backend:_Eingabemaske#Longtext|Eingabemaske]] (fka Paletteneinstellungen) aktiviert werden.
 +
* Paletteneinstellungen
 +
* Paletteneinstellungen bearbeiten (also auf das Palettenicon ganz rechts klicken)
 +
* Formular auswählen
 +
* Bleistiftsymbol beim Attribut "Longtext" anklicken
 +
* unter '''presentation_legend''' gibt es einen Punkt '''Enable richtext editor on this'''
 +
* hier kann der Richtext-Editor ausgewählt werden
 +
<div style="clear: both"></div>
  
<div style="clear: both"></div>
+
==Mehrfachauswahl (Tags)==
 +
[[File:mm_attribut_tags.png|thumb|365px]]
 +
Das Attribut '''Mehrfachauswahl (Tags)''' erzeugt Checkboxen mit Mehrfachauswahl.
  
=Numerisch=
+
'''Anzeigeeinstellungen'''
 +
* '''Datenbanktabelle''': Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen (siehe Hinweis weiter unten)
 +
* '''Tabellenspalte''': Namen der Spalte auswählen, die die Werte der Tags zur Verfügung stellt
 +
* '''ID der Mehrfachauswahl''': Vorzugsweise '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
 +
* '''Alias der Mehrfachauswahl''': Vorzugsweise das '''alias''' auswählen
 +
* '''Sortierung der Mehrfachauswahl''': Namen der Spalte auswählen, die die Werte der Tags zur Verfügung stellt
 +
*'''SQL''': Die Auswahlmöglichkeiten können per SQL eingeschränkt werden
  
 +
Hinweis: Um das Attribut '''Tags''' anlegen zu können, muss man zuerst eine neue Tabelle (sprich ein neues MetaModel) erstellen, in der die verschiedenen Tags angelegt werden. Die genaue Vorgehensweise ist - am Beispiel des Attributes '''Auswahl''' - [[MetaModels_Beispiel_4|hier]] beschrieben. Erst dann kann man unter '''Datenbanktabelle''' die betreffende Tabelle auswählen.
 +
<div style="clear: both"></div>
 +
 +
==Numerisch (Numeric)==
 
[[File:mm_attribut_numerisch.png|thumb|365px]]
 
[[File:mm_attribut_numerisch.png|thumb|365px]]
 
Das Attribut '''Numerisch''' erzeugt ein einzeiliges Eingabefeld und nimmt eine Feldprüfung vor
 
Das Attribut '''Numerisch''' erzeugt ein einzeiliges Eingabefeld und nimmt eine Feldprüfung vor
  
'''Advanced settings'''
+
<div style="clear: both"></div>
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
  
 +
==Sprachschlüssel (Langcode)==
 +
[[File:mm_attribut_sprachcode.png|thumb|365px]]
 +
Das Attribut '''Sparchcode''' erzeugt ein HTML-Select. Als Optionen stehen die angewählten Sprachen (langcodes) zur Verfügung.
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Sprachcode=
+
==Text==
 
+
[[File:mm_attribut_text.png|thumb|365px]]
Funktionen und Konfigurationseinstellungen
+
Das Attribut '''Text''' erzeugt ein einzeiliges Eingabefeld.
 
+
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Tags=
+
==Timestamp (Datum)==
 +
[[File:mm_attribut_timestamp.png|thumb|365px]]
 +
Das Attribut '''Timestamp''' erzeugt ein einzeiliges Eingabefeld mit Datumsprüfung.
  
[[File:mm_attribut_tags.png|thumb|365px]]
+
'''Datum und Zeit > Schema'''
 
+
*'''Datum''' erzeugt z.B. 2013-03-06
 
+
*'''Datum und Zeit''' erzeugt z.B. 2013-03-06 08:15
'''Advanced settings'''
+
Das Datum wird so konfiguriert, wie es in den Backend-Einstellungen von Contao definiert ist. Im Frontend richtet es sich nach den allgemeinen Einstellungen oder je nach Konfiguration nach den Einstellungen in der Seitenstruktur.
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
  
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Text=
+
==URL==
 +
[[File:mm_attribut_url.png|thumb|365px]]
 +
Das Attribut '''URL''' erzeugt zwei einzeilige Eingabefelder. Eines für den Linktext und eines für die URL.
 +
Mit dabei ist auch noch ein Icon, über das sich eine Seite aus der Seitenstruktur auswählen lässt.
  
[[File:mm_attribut_text.png|thumb|365px]]
+
'''Bitte beachten'''<br>
Das Attribut '''Text''' erzeugt ein einzeiliges Eingabefeld.
+
Externe Links müssen mit einem http:// (oder https://) versehen sein, anderfalls interpretiert MetaModels die URL als relativen Link.
 
+
'''Advanced settings'''
+
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
  
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Übersetztes Alias=
+
==Übersetztes Alias==
 
[[File:mm_attribut_translated_alias.png|thumb|365px]]
 
[[File:mm_attribut_translated_alias.png|thumb|365px]]
Das Attribut '''Text''' erzeugt ein einzeiliges Eingabefeld.
+
Das Attribut '''translatedalias''' erzeugt ein einzeiliges Eingabefeld.
 
+
'''Advanced settings'''
+
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Übersetzte Datei=
+
==Übersetzte Datei==
 
[[File:mm_attribut_translated_datei.png|thumb|365px]]
 
[[File:mm_attribut_translated_datei.png|thumb|365px]]
Das Attribut '''Text''' erzeugt ein einzeiliges Eingabefeld.
+
Das Attribut '''Übersetzte Datei''' erzeugt ein einzeiliges Eingabefeld.
 
+
'''Advanced settings'''
+
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Übersetzter Longtext=
+
==Übersetzter Longtext==
 
[[File:mm_attribut_translated_longtext.png|thumb|365px]]
 
[[File:mm_attribut_translated_longtext.png|thumb|365px]]
Das Attribut '''Text''' erzeugt ein einzeiliges Eingabefeld.
+
Das Attribut '''Übersetzter Longtext''' erzeugt eine mehrzeilige Textarea.
 
+
'''Advanced settings'''
+
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Übersetzte Auswahl=
+
==Übersetzte Auswahl==
 
[[File:mm_attribut_translated_auswahl.png|thumb|365px]]
 
[[File:mm_attribut_translated_auswahl.png|thumb|365px]]
Das Attribut '''Übersetzte Auswahl''' erzeugt ein einzeiliges Eingabefeld.
+
Das Attribut '''Übersetzte Auswahl''' erzeugt ein HTML Select.
  
'''Advanced settings'''
+
Ein Beispiel zur Verwendung ist hier zu finden:
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
[[MetaModels_Beispiel:_Übersetzter_select|Weiteres Beispiel: Übersetzter select]] - Mehrsprachiges Select-Attribut einrichten
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Übersetzte Tags=
+
==Übersetzte Tags==
 
[[File:mm_attribut_translated_tags.png|thumb|365px]]
 
[[File:mm_attribut_translated_tags.png|thumb|365px]]
Das Attribut '''Übersetzte Tags''' erzeugt ein einzeiliges Eingabefeld.
+
Das Attribut '''Übersetzte Tags''' erzeugt ein....
 
+
'''Advanced settings'''
+
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
+
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>
  
=Übersetzter Text=
+
==Übersetzter Text==
 
[[File:mm_attribut_translated_text.png|thumb|365px]]
 
[[File:mm_attribut_translated_text.png|thumb|365px]]
 
Das Attribut '''Übersetzter Text''' erzeugt ein einzeiliges Eingabefeld.
 
Das Attribut '''Übersetzter Text''' erzeugt ein einzeiliges Eingabefeld.
 
'''Advanced settings'''
 
*'''Unique values''': Anhaken, wenn dieser Wert nur einmal vorkommen soll
 
 
<div style="clear: both"></div>
 
<div style="clear: both"></div>

Aktuelle Version vom 5. September 2013, 15:08 Uhr

Allgemeines zu den Attributen

  1. MetaModels Attribute
  2. MetaModels Ausgabevorgaben
  3. MetaModels Eingabemaske
  4. MetaModels Filter
  5. MetaModels Ansichtseinstellungen

Was sind eigentlich Attribute?

Icons attribute.png

Grob gesagt: die Datenbank-Objekte (aka Datensatz), die in den MetaModels erfasst werden, setzen sich aus den verschiedensten Attributen (aka Eigenschaften oder Feldern) zusammen.

Einstieg

Mm backend attribute liste.png

Über Neues Attribut erfasst man die gewünschten Attribute. Name und Beschreibung eines Objektes, die Fotos, die das Objekt illustrieren, eine Checkbox, mit der ein Eintrag veröffentlicht werden kann - all das wird in Attributen abgelegt. Jedes Attribut entspricht also einer Spalte in der Datenbank-Tabelle. Aus den verschiedenen Attributen stellt man die Eingabemaske für die einzelnen Datensätze zusammen. Für jeden Attributtyp gibt es diverse Einstellungen, die im Folgenden beim jeweiligen Attribut erläutert werden.

Attribut definieren

Mm attribut settings eingabemaske.png

Mit einem Klick auf das Icon Bearbeiten fängt man an. Zuerst wird der Attributtyp ausgewählt. Für jedes Attribut müssen dann Basis-Attributkonfigurationen festgelegt werden:

  • Attribut-Typ: Typ (gesamte Liste siehe weiter unten)
  • Spaltenname (Name der Tabellenspalte in der Datenbank)
  • Name (Name der Feldüberschrift bei der Erfassung des Datensatzes)
  • Beschreibung (Beschreibung unterhalb des Feldes bei der Erfassung des Datensatzes)


Bei allen Attributen findet man unter den Erweiterten Einstellungen (Advanced settings) noch die Checkbox Eindeutige Werte (Unique values) - wird diese angehakt, kann für das betreffende Attribut jeder Wert nur einmal verwendet werden.

Den Einträgen, die man unter Name und Beschreibung eingibt, begegnet man später in der Eingabemaske wieder (siehe rote Markierung im Screenshot).

Attribute

Alias

Mm attribut alias.png

Das Attribut Alias erzeugt ein einzeiliges Eingabefeld. Dieses Attribut sollte erst dann erzeugt werden, wenn mindestens ein Textfeld (vorzugsweise ein Titel-Feld) vorhanden ist, aus dem sich das Alias automatisch bilden kann.

Advanced Settings

  • Eindeutige Werte
  • Neuerstellung des Alias erzwingen.: Anhaken, wenn sich das Alias automatisch anpassen soll, wenn immer der Wert des zugewiesenen Feldes geändert wird (ist etwas buggy, Stand:März 2013)
  • Alias-Felder: Attribut, aus dem das Alias generiert wird. Es können auch mehrere Attribute definiert werden. In diesem Fall werden die einzelnen Attribute über einen Bindestrich zu einem Alias zusammengefügt.

Auswahl (Select)

Mm attribut select.png

Das Attribut Auswahl erzeugt ein HTML-Select.

Anzeigeeinstellungen

  • select_table: Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen, auch die mit MetaModels erstellten (siehe Hinweis weiter unten)
  • select_id: Vorzugsweise id auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
  • select_column: Namen der Spalte auswählen, der die Werte des Selects zur Verfügung stellt
  • select_alias: Vorzugsweise das alias auswählen
  • Auswahl-Sortierung: Hier lässt sich einstellen, in welcher Reihenfolge die Begriffe im Select erscheinen sollen
  • SQL: Die Auswahlmöglichkeiten lassen sich per SQL einschränken

Hinweis: Um das Attribut Auswahl anlegen zu können, muss man zuerst eine neue Tabelle (sprich ein neues MetaModel) erstellen, in der die Select-Werte angelegt werden. Die genaue Vorgehensweise ist hier beschrieben. Erst dann kann man unter select_table die betreffende Tabelle auswählen.

Bewertung (Rating)

Mm attribut rating.png

Das Attribut Bewertung erzeugt eine Aufzählung von Icons. Standardmässig werden Sterne angezeigt. Man kann aber auch eigene definieren.

Beispiel
Mm attribut rating beispiel.png

Bitte beachten
Das Attribut benötigt die beiden PHP-Dateien SimpleAjax.php und SimpleAjaxFrontend.php, welche mit dem aktuellen Nightly Build ausgeliefert werden.
Die beiden PHP-Dateien müssen im Root-Verzeichnis der Contao-Installation abgelegt werden.

Color picker (Farbe)

Mm attribut color.png

Das Attribut Color picker erzeugt zwei Eingabefelder (Hex Farbangabe) und einen Farbwähler

Datei (File)

Mm attribut datei.png

Das Attribut Datei erzeugt ein Wurzelverzeichnis, aus dem sich einzelne Dateien oder Order anwählen lassen.

Dezimal (Decimal)

Mm attribut dezimal.png

Das Attribut Dezimal erzeugt ein einzeiliges Eingabefeld und nimmt eine Feldprüfung vor

GeoProtection

Mm attribut geoprotection.png

Das Attribut GeoProtection erzeugt ein HTML-Select. Als Optionen stehen die angewählten Länder zur Verfügung.
Es bietet die Möglichkeit Datensätze so zu konfigurieren, das sie für ausgewählte Länder sichtbar sind oder versteckt werden.

Bitte beachten
Dieses Attribut benötigt die Extension geoprotection, ansonsten wird eine Fehlermeldung rausgeworfen. Und wird nicht mit den Nightly Builds geladen, kann aber bei GitHub separat runtergeladen werden

Kombinierte Einträge (Combined Values)

Mm attribut combinedvalues.png

Das Attribut Kombinierte Einträge erzeugt ein...

Kontrollkästchen (Checkbox)

Mm attribut checkbox.png

Das Attribut Kontrollkästchen erzeugt eine einfache HTML-Checkbox.

Erweiterte Einstellungen

  • Eindeutige Werte
  • Veröffentlichen: Erzeugt im Backend (in der Listenansicht mit Icon 'Auge') die Option, einen Datensatz für das Frontend freizugeben. Hierzu muss aber auch ein Filter definiert werden. Die genaue Vorgehensweise ist hier beschrieben.

Land (Country)

Mm attribut land.png

Das Attribut Land erzeugt ein HTML-Select, welches alle Länder enthält.

Mm attribut land filter.png

Verfügbare Länder filtern
Wenn dieses Feld leer ist, werden automatisch alle Länder im Select angezeigt. Die Auflistung lässt sich verkürzen, indem man nur die gewünschten Länder hier auflistet.

Langtext (Longtext)

Mm attribut longtext.png

Das Attribut Langtext erzeugt eine Textarea.

Es stehen 3 Richtext-Editoren zur Verfügung: tinyFlash, tinyMCE und tinyNews.
Eigens angepasste RTEs können hier ausgewählt werden, sofern sie auch angelegt wurden, bspw. in einer tinyCustom.php.

Mm paletteneinstellungen longtext.png

Die Richtext-Editoren können über die Eingabemaske (fka Paletteneinstellungen) aktiviert werden.

  • Paletteneinstellungen
  • Paletteneinstellungen bearbeiten (also auf das Palettenicon ganz rechts klicken)
  • Formular auswählen
  • Bleistiftsymbol beim Attribut "Longtext" anklicken
  • unter presentation_legend gibt es einen Punkt Enable richtext editor on this
  • hier kann der Richtext-Editor ausgewählt werden

Mehrfachauswahl (Tags)

Mm attribut tags.png

Das Attribut Mehrfachauswahl (Tags) erzeugt Checkboxen mit Mehrfachauswahl.

Anzeigeeinstellungen

  • Datenbanktabelle: Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen (siehe Hinweis weiter unten)
  • Tabellenspalte: Namen der Spalte auswählen, die die Werte der Tags zur Verfügung stellt
  • ID der Mehrfachauswahl: Vorzugsweise id auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
  • Alias der Mehrfachauswahl: Vorzugsweise das alias auswählen
  • Sortierung der Mehrfachauswahl: Namen der Spalte auswählen, die die Werte der Tags zur Verfügung stellt
  • SQL: Die Auswahlmöglichkeiten können per SQL eingeschränkt werden

Hinweis: Um das Attribut Tags anlegen zu können, muss man zuerst eine neue Tabelle (sprich ein neues MetaModel) erstellen, in der die verschiedenen Tags angelegt werden. Die genaue Vorgehensweise ist - am Beispiel des Attributes Auswahl - hier beschrieben. Erst dann kann man unter Datenbanktabelle die betreffende Tabelle auswählen.

Numerisch (Numeric)

Mm attribut numerisch.png

Das Attribut Numerisch erzeugt ein einzeiliges Eingabefeld und nimmt eine Feldprüfung vor

Sprachschlüssel (Langcode)

Mm attribut sprachcode.png

Das Attribut Sparchcode erzeugt ein HTML-Select. Als Optionen stehen die angewählten Sprachen (langcodes) zur Verfügung.

Text

Mm attribut text.png

Das Attribut Text erzeugt ein einzeiliges Eingabefeld.

Timestamp (Datum)

Mm attribut timestamp.png

Das Attribut Timestamp erzeugt ein einzeiliges Eingabefeld mit Datumsprüfung.

Datum und Zeit > Schema

  • Datum erzeugt z.B. 2013-03-06
  • Datum und Zeit erzeugt z.B. 2013-03-06 08:15

Das Datum wird so konfiguriert, wie es in den Backend-Einstellungen von Contao definiert ist. Im Frontend richtet es sich nach den allgemeinen Einstellungen oder je nach Konfiguration nach den Einstellungen in der Seitenstruktur.

URL

Mm attribut url.png

Das Attribut URL erzeugt zwei einzeilige Eingabefelder. Eines für den Linktext und eines für die URL. Mit dabei ist auch noch ein Icon, über das sich eine Seite aus der Seitenstruktur auswählen lässt.

Bitte beachten
Externe Links müssen mit einem http:// (oder https://) versehen sein, anderfalls interpretiert MetaModels die URL als relativen Link.

Übersetztes Alias

Mm attribut translated alias.png

Das Attribut translatedalias erzeugt ein einzeiliges Eingabefeld.

Übersetzte Datei

Mm attribut translated datei.png

Das Attribut Übersetzte Datei erzeugt ein einzeiliges Eingabefeld.

Übersetzter Longtext

Mm attribut translated longtext.png

Das Attribut Übersetzter Longtext erzeugt eine mehrzeilige Textarea.

Übersetzte Auswahl

Mm attribut translated auswahl.png

Das Attribut Übersetzte Auswahl erzeugt ein HTML Select.

Ein Beispiel zur Verwendung ist hier zu finden: Weiteres Beispiel: Übersetzter select - Mehrsprachiges Select-Attribut einrichten

Übersetzte Tags

Mm attribut translated tags.png

Das Attribut Übersetzte Tags erzeugt ein....

Übersetzter Text

Mm attribut translated text.png

Das Attribut Übersetzter Text erzeugt ein einzeiliges Eingabefeld.

Ansichten
Meine Werkzeuge

Contao Community Documentation

Nur weil es bei Nachbarseite XYZ was gibt, wird automatisch oft davon ausgegangen, dass das fertige Bauteil einsatzbereit auf der Straße liegt.

Marie Dietz
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge