Field Management

Der Überblick spiegelt das wider, was in dem einzelnen Feld eingestellt ist. Deshalb lege ich der Einfachheit halber ein neues Feld an.

Zunächst der Bereich, der für alle Felder gleich ist:

• Tab
  Hier muss ausgewählt werden, in welchem Tab das Feld angezeigt werden soll. Das beeinflusst sowohl die Profilverwaltung, als auch die Ausgabe (siehe Kapitel: Tab Management)

• Name
  Diese Bezeichnung wird in die Datenbank geschrieben und die Inhalte entsprechend dort abgelegt. Der Community Builder schreibt automatisch "cb_" davor, wenn es nicht gemacht wurde). Sonderzeichen und Unterstriche sind nicht erlaubt und werden mit einem kleinen Hinweis geahndet und verbessert vom CB.

• In Title ist quasi die Überschrift, die Bezeichnung des Feldes angegeben, die auch ausgegeben werden kann.

• Description
  Das ist der gesamte Bereich, den der WYSIWYG-Editor einnimmt (natürlich nur wenn in der User-Verwaltung ein Editor zugeordnet ist). Der Beschreibungstext, der hier eingegeben wird, wird in der Profilverwaltung hinter dem Eingabefeld mit einem blauen Ausrufezeichen angezeigt. Wenn man über das Icon mit der Maus fährt und eine Sekunde wartet, wird der Text als Tooltip ausgegeben.

• Required
  bedeutet, dass dieses Feld ein Pflichtfeld ist und etwas eingetragen oder ausgewählt werden muss

• Show on Profile
  Bei Ja wird angegeben,  ob es im Profil in einer Zeile oder zwei Zeilen ausgegeben werden soll. Eine Zeile schreibt den Titel und gleich daneben die Antwort. Zwei Zeilen schreibt oben den Titel und darunter die Antwort.
  Bei Nein wird dieses Feld nicht im Profil ausgegeben. Zum Beispiel könnte das bei eMail-Feldern Sinn machen.

1 Zeilig                                                                                            2 Zeilig

• Display field title in Profile
  Soll der Titel angezeigt werden oder nicht und somit nur der Eintrag ausgeben werden.

• Searchable in users-lists
  Damit kann eingestellt werden, ob dieses Feld im Suchenformular angezeigt und oder ausgewählt werden kann, bzw. gezielt danach gesucht werden kann.
  Wie das genau funktioniert mit der Suche kommt weiter unten in diesem Tutorial

• User Read Only
  Manchmal gibt es Felder, in der der User nichts eintragen, die er aber lesen soll. Hier kann das eingestellt werden

• Show at Registration
  Soll dieses Feld bereits bei der Registration sichtbar sein oder erst hinterher, wenn der User registriert ist und sein Profil anpasst?
  Gerade bei umfangreichen Profilen sollte man überlegen, ob man den User bei der Registrierung schon eine Fülle von Feldern vorgibt oder es einem zunächst wichtiger ist, einen neuen User zu bekommen und ihn danach in aller Ruhe sein Profil ausfüllen lässt.

• Size
  Damit wird die Länge eines Feldes bestimmt. Bei den Checkboxen kann das vernachlässigt werden, aber bei den Textfeldern nicht mehr

Unter Type wird ausgewählt, um was für ein Feld es sich handeln soll – jeder Typ hat einige Besonderheiten und teilweise erweiterte Einstellmöglichkeiten:

• Check Box (Single)
  In der Profilverwaltung des Users wird nun eine einfache Checkbox angezeigt. Im Profil wird ein Ja oder Nein ausgegeben (je nachdem, ob ein Haken gesetzt wurde oder nicht)
  
  
• Check Box (Multiple)
  Wie oben, aber mit mehreren Auswahlfeldern, wo man keins oder mehrere anklicken kann.
  In der Verwaltung sieht das so aus:
  
  
  
  Unter Cols und Rows wird eingestellt auf wie vielen Spalten (Cols) und Zeilen (Rows) die Auswahl in der Profilverwaltung angezeigt werden soll. In meinem Beispiel habe ich zwei Spalten und drei Zeilen ausgewählt (Cols: 2 | Rows: 3)
  Unter den Field-specific Parameters auf der rechten Seite lässt sich die Ausgabe beeinflussen:
  
  
  
  
  
  Man kann sogar eine CSS-Klasse eigens für die Liste definieren und hier angeben. Die einfach in die "template.css" des benutzen Templates schreiben.
  
  Die einzelnen Auswahlpunkte werden ganz unten eingefügt. Wenn ein zweiter dazu gefügt werden soll, einfach auf "Add a Value" klicken und entsprechend eintragen. Mit den blauen Pfeilen kann die Reihenfolge der Auswahlpunkte angepasst werden.
  
  Unter Pre-filled default value at registration only (direkt unter dem WYSIWYG-Editor) kann bei der Registrierung ein Auswahlfeld mit einem Haken versehen werden. Dazu einfach einen der "Value-Namen" eintragen. Beispielsweise: Spanisch
  Bei der Registrierung eines neuen Users ist dann dieses Feld mit einem Häkchen vorbelegt.
• Date
  Datumsfelder können hiermit erzeugt werden. Zum Beispiel um den Geburtstag zu erfassen.
  
  Unter Field-specific Parameters können einige Einstellungen vorgenommen werden:
  
  • Minimum Year shown und Maximum Year shown
    Das ist zunächst etwas verwirrend und kann auch schnell zu merkwürdigen Fehlern führen, wenn man hier etwas verändert.
    
    Es wird davon ausgegangen, dass das aktuelle Jahr den Wert 0 hat.
    -110 bedeutet also, das von dem Jahr 2009 110 Jahre abgezogen wird. Das führt dann zu dem frühsten Jahr 1899.
    Bei Maximum ist es genau ugekehrt: Es werden zum aktuellen Jahr 25 Jahre dazu addiert. Die Auswahl bietet also bei diesem Beispiel die Jahre von 1899 bis 2035 an.
    Bei Geburtsdaten sollte das natürlich etwas angeglichen werden. Da sich niemand registrieren kann, der noch gar nicht geboren ist, kann  beim "Maximum" also auch eine negative Zahl eingetragen werden.
  • Display on profiles at
    legt fest, wie das Datum ausgegeben werden soll:
    
    • Das volle Datum (Full date)
    • Alter in Jahre (Age in years)
      Dabei wird ein neues Feld erzeugt: Display N years text
      Damit kann festgelegt werden, ob hinter der Zahl ein "Jahre" (mit deutscher Sprachdatei) oder nichts stehen soll.
    • Time ago
      Es wird zurückgerechnet, wie lange es her ist von heute zum eingegeben Datum. Dabei wird aber nicht auf Monat und Tag geachtet, sondern die vollen Jahre berechnet.
      Auch hier erscheint ein neues Feld: Display T ago text
      Bei Auswahl "T ago" wird hinter der Zahl ein "Jahre zuvor" ausgegeben, sonst nur ein "Jahre"
    • birthday only without year
      gibt nur Monat und Tag, aber ohne Jahreszahl aus
  • If searchable, then search by
  Wenn es der Suchenfunktion zugefügt wurde (links unter " Searchable in users-lists?" auf "Ja" gestellt), dann muss hier eingestellt werden, ob nach vollem Datum oder nach tatsächlichem Alter.
  • Alternate field title for age/time ago/birthday only display
  Hier kann ein anderer Titel eingeben werden, als er links unter "Title" definiert wurde. Also ein alternativer Text.
  • Display Date and time
  Dieses Feld hat bei mir leider keinerlei Funktion …

• DropDown Single
  Damit wird ein DropDown-Auswahlfeld zur Verfügung gestellt. Die einzelenen Auswahlmöglichkeiten werden unten eingetragen und per "Add a Vlue" können neue Auswahlmöglichkeiten dazu gefügt werden. Mit den blauen Pfeiltasten kann diese Liste sortiert werden.
  
  Unter Pre-filled default value at registration only (direkt unter dem WYSIWYG-Editor) kann bei der Registrierung ein Auswahlfeld defaultmäßig vorgegeben werden. Dazu einfach einen der "Value-Namen" eintragen. Beispielsweise: " Was anderes".
  Bei der Registrierung eines neuen Users ist dann dieses Feld mit deisem Text defaultmäßig vorbelegt, kann aber natürlich verändert werden vom User.
• DropDown Multi-selected
  Mit gedrückter Steuerungstaste können einzelne, aber mehrere Auswahlmöglichkeiten angeklickt werden und mit gedrückter Shift-Taste  (Großschreibetaste) kann ein ganzer Bereich markiert werden (das erste anklicken und das letzte, welches man auwählen möchte – und der ganze Bereich ist markiert). Übrigens ein Hinweis, der gut in die Description passt.
  
  
  
  Unter den Field-specific Parameters auf der rechten Seite lässt sich die Ausgabe wie bei der Multi-Checkbox beeinflussen.
• Email Adresse
  Wie vermutet kann hier eine eMail-Adresse eingegeben werden. In den
  Field-specific Parameters kann dazu einiges interessantes eingestellt werden:
  
  
  • Ganz oben kann eingestellt werden, ob bei Eingabe einer eMail-Adresse gleichzeitig ein Check stattfindet, ob es sich um eine eMail-Adresse handelt. Dazu wird abgeprüft, ob es den Server gibt (der Teil, der rechts vom "@-Zeichen" steht) und ob die Eingabe-Form einer gültigen eMail-Adresse entspricht.
  • Authorized input
    Voreingestellt ist hier, dass ein beliebiger Zeichensatz (String) eingegeben werden kann. Alternativ dazu kann man aber auch PERL Ausdrücke eingeben. Wählt man das aus, erhält man zwei weitere Einstellfelder.
    PERL ist eine Programmiersprache, dessen Stärke unter andrem in der Stringverarbeitung liegt.  Wer sich das näher anschauen möchte, kann hier mal schauen:
    
    PERL-Reguläre Ausdrücke
    
    In Perl Regular Expression kommt der reguläre Ausdruck und in Error in case of invalid input wird der Text eingetragen, der erscheint, wenn man etwas falsch gemacht hat.
  • Forbidden words at registration
    Eine sogenannte "Badwortliste". Also Worte, die bei Eingabe der eMail-Adresse bei der Registration nicht geschrieben werden dürfen.
  • Forbidden words in user profile edits
    Und das gleiche, wenn man später sein Profil editiert und die eMail-Adresse noch mal ändern möchte.
  • Unten links kann man noch eine Maximale Länge für die eMail-Adresse vorgeben. Man sollte aber eine nicht zu kleine Zahl wählen. eMail-Adressen können manchmal ganz schön lang sein.
• Editor Text Area
  Quasi ein Freitextfeld. Im Profilverwaltungsbereich wird ein WYSIWYG-Editor angezeigt, mit dem der User Text eingeben und gestalten kann. Der Editor entspricht dem, der installiert ist und generell benutzt wird.
  
  Man kann zwar unten in Cols und Rows Angaben zur Größe des Eitorfeldes machen, aber die Zahlen werden letztlich nicht genommen. Also kann man das Feld auch ebenso gut leer lassen.
  
  Rechts unter den Field-specific Parameters kann man eine Minimumzahl für die Textlänge eingeben. Wird gar nichts in das Textfeld eingegeben, dann passiert nichts, gibt man aber mindestens ein Zeichen und weniger als die voreingestellte Zahl ein, erhält man einen Hinweis, dass mindestens n Zeichen eingegeben werden müssen.
• Text Area
  In der Profilverwaltung wird ein einfaches Textfeld in der Größe der angegebenen Cols und Rows angezeigt.
  
  Außerdem kann rechts unter den Field-specific Parameters noch die Minimumlänge des Textes eingegeben werden (siehe auch Editor Text Area).
  Desweiteren kann ich auch hier wieder eine Liste von nicht erwünschten Wörtern anlegen – einmal während der Registrierung und einmal wenn das Profil normal editiert wird.
  
  Leider musste ich feststellen, dass der "Bad words filter" nicht funktioniert.
• Text Field
  Anders als beim Text Area kann hier nur ein einzeiliges Textfeld erzeugt werden. Die Länge des Textfeldes wird unten on "Max Length" angegeben. Allerdings bietet dieses Textfeld einiges an Möglichkeiten, die eingebende Zeichenkette zu überprüfen:
  
  Unter den Field-specific Parameters gibt es zunächst wieder die Minimumlänge des Textes und auch wieder die "Böse Wörter Liste". Unter Authorized input gibt es aber gleich mehrere Einstellungen, welche Zeichenkette erlaubt ist.
  
  • Any string
    erlaubt eine beliebige Zeichenkette aller Buchstaben, Zahlen, Zeichen und Sonderzeichen die es gibt
  • Single word
    Erlaubt beliebige Buchstaben, aber keine Zahlen und auch keine Satzzeichen oder Sonderzeichen (wie beispielsweise das "@" oder "ß"). Es kann aber nur ein Wort eingegeben werden.
  • Multiple words with spaces
    Wie "single word" – aber es können mehrere Wörter eingegeben werden
  • Single a-z,A-Z,0-9._word
    Ein Wort das aus beliebigen Zeichen, Zahlen und Satzzeichen bestehen kann, aber nicht aus Sonderzeichen (wie beispielsweise das "@" oder "ß")
  • At least 6 chars, 1 a-z, 1 A-Z, 1 0-9. 1 special
    Es muss mindestens ein kleiner und ein großer Buchstabe vorkommen, eine Zahl und ein Sonderzeichen und das Wort muss mindestens sechs Zeichen haben.
  • Custom PERL regular expression
    Damit kann ein beliebiger regulärer Ausdruck in PERL Syntax eingegeben werden, um eine Zeichnekette auf Richtigkeit zu überprüfen (zum Beispiel: eMail-Adressen, PLZ, Bankverbindungen oder Telefonnummern).
    Mehr zu PERL-Ausdrücken hier:
    
    PERL Reguläre Ausdrücke
  
  In das Feld Error in case of invalid input kann ein Text eingetragen werden, der angezeigt wird, wenn die Eingabe nicht der Vorgabe entspricht.
• Integer Number
  Eine ganzzahlige Nummer (also ohne Kommastellen) die zwischen den eingestellten Werten auf der rechten Seite unter den Field-specific Parameters liegt.
  Wobei das Any string hier vermutlich etwas verwirrend wirkt. Aber mittels der PERL-Ausdrücke kann man die Nummernfolge einschränken, bzw. in eine bestimmte Syntax zwingen. Link zu den PERL-Ausdrücken siehe oben.
  Benutzt man das Any string ist die Zahlenfolge egal.
• Radio Buttons
  Radio Buttons sind die kleinen Kreise vor einer Auswahl, die stets nur eine Auswahlmöglichkeit zulassen. Also im Gegensatz zu den Checkboxen, wo mehrere Auswahlen angekreuzt werden können. Ansonsten ist die Einstellung identisch mit der Check Box (Multi).
• Web Adress
  Ein Feld für eine Webadresse. Wobei unten eingestellt werden kann ob nur die URL (www.Domain.de) oder mit Hypertext (http://www.Domain.de)
• Image
  Damit kann ein Bild hochgeladen und in das Profil eingebunden werden.
  Rechts kann eingestellt werden, wie groß das Originalbild sein darf und wie groß das Vorschaubild daraus gemacht wird.
• Password
  In der Profilverwaltung werden jetzt gleich zwei Felder zur Passworteingabe angelegt. Nämlich ein Bestätigunsfeld gleich mit, um sicherzustellen, dass der User sich nicht verschreibt. Die Zeichen werden verschlüsselt dargestellt bei der Eingabe und mit Sternchen im Profil angezeigt.
• Fields delimter
  ... zeigt nur dann Wirkung, wenn ein Text in das Beschreibungsfeld (Description) eingegeben wird. Dieser wird dann ausgegeben und ansonsten nichts. Statt eines Textes kann in den WYSIWYG-Editor auch HTML ausgewählt werden und somit beispielsweise eine horizontale Linie eingefügt werden.

CB Field Manager

Hier hat man eine Übersicht über alle seine eingestellten Felder. Hat auf einen Blick, wo sie angezeigt werden, ob es Pflichtfelder sind oder nicht und ob sie für die Suche relevant sind. Man sieht auf einen Blick, welche Felder veröffentlicht sind und auch in welcher Reihenfolge sie in den einzelnen Tabs angezeigt werden.
Will man die Reihenfolge verändern, dann entweder mit den grünen Pfeiltasten die Felder nach oben oder unten bewegen oder – insbesondere bei umfangreichen Änderungen – einfach die Reihenfolge direkt eingeben und zum Abschluss auf das kleine Icon ganz oben in der Spalte für die Reihenfolge klicken, das ein kleines Diskettensymbol zeigt.