cell/TABLELINK

Der cell/TABLELINK wird innerhalb einer driver/search-Maske um ein Pulldown auszugeben, welches eine Suche nach 1-n-Verlinkungen erlaubt. Das Gegenstück im Editor ist cell/DIREKTLINK.

Verfügbarkeit

Dieser Content-Driver ist in den folgenden Drivers verfügbar:

Parameter

Field Die Spalte in der aktuellen Tabelle in der die ID des Link-Objektes gespeichert wird. Es sind hier auch Spalten aus einer n-m-Beziehung sichtbar (bei gespeicherter Linktable), die zum Suchen verwendet werden können.
Linktable Die Tabelle mit den Link-Objekten.
Type Typ der Ausgabe:
  • select gibt ein Pulldown aus
  • checkboxes gibt alle Optionen als einzelne Checkboxen aus (Mehrfach-Selektion möglich)
  • radio buttons gibt alle Optionen als einzelne Radio-Buttons aus (keine Mehrfach-Selektion).
Rows Anzahl der Zeilen für das SELECT. Wenn > 1 dann wird das SELECT zu einem Mehrfach-Pulldown mit mehrfach anklickbaren Optionen. Nur bei Typ select.
Div Based Pulldown Wenn gesetzt wird nicht der reguläre HTML-SELECT benutzt, sondern ein easydb eigenes Pulldown-System, welches aus DIVs besteht. Unterstützt nicht den Parameter Rows. Nur bei Typ select.
Break Wird auf eine Zahl n gesetzt. Wenn > > 0, wird alle n Optionen ein Break in Form einer neuen DIV eingefügt. Wenn > < 0 werden die verfügbaren Optionen auf n Spalten aufgeteilt.
Don’t select all, if none is selected Mit dieser Option wird ausgeschaltet, dass automatisch alle Checkboxen selektiert werden, wen keine selektiert ist. Nur für Type checkboxes.
Value Select Das SQL für den Text der Option. Hier können per SQL auch mehrere Felder benutzt werden. Der Platzhalter %lang% wird durch _<language code> ersetzt, wenn der language_code NICHT de ist. Für den Fall de wird %lang% durch einen Leerstring ersetzt.
WHERE ... SQL zum Filter der aus der Link-Tabelle angezeigten Objekte.
Es werden folgende Platzhalter ersetzt:
  • %user_id% Für Benutzer die über easydb authentifiziert wurde (sonst null), die ID des Benutzers aus der User-Tabelle.
  • %user_login% Das Benutzer-Login.
  • %group_ids% Kommasepariert alle IDs der Usergruppen des aktuellen Benutzers.
Where Condition PHP PHP Code, um ein WHERE zu erzeugen. Dieses WHERE wird per AND mit einem ggfs. gesetzten WHERE ... verknüpft.
Order Select SQL-ORDER-BY zum Sortieren der angezeigten Link-Objekte. %lang%-Ersetzung wie bei Value Select.
Right Link-Rechte-Level den der Benutzer für die angezeigten Objekte besitzten muss.
Thesaurus Support Wenn gesetzt, werden die gefilterten und gefunden Objekte der Link-Tabelle mit all ihren (gefilterten) Kindern angezeigt. Das ausgewählte Objekt wird ebenfalls mit allen Kindern gesucht.
Thesaurus Root Where SQL Wenn nicht gesetzt, wird dem Root-Select ein fk_father_id IS NULL angefügt. Abweichend kann hier ein SQL-WHERE clause definiert werden, welcher die Root-Objekte aus der aktuellen Link-Tabelle sucht und sie als WHERE-clause an den Root-Select mit fk_father_id IN (<IDs der Link-Objekte>) anfügt.
Depend on these Gcell IDs Kommaseparierte Liste von GCELL-IDs anderer cell/TABLELINK oder cell/SINGLELINK in dieser Maske, von denen dieses Pulldown abhängig ist. Wenn mindestens eine GCELL verwiesen ist, werden die Optionen per Ajax geladen nachdem die Maske vollständig geladen wurde. Während dieser Zeit steht in diesem DIREKTLINK die Option loading…. Die Optionen werden aktualisiert, wenn eine verwiesene GCELL verändert wird. In WHERE ... und Thesaurus Root Where SQL werden je verwiesener GCELL-ID, Platzhalter im Format %<GCELL-ID>% durch den Wert der verwiesenen aktuellen GCELL-Auswahl ersetzt.
Omit No-Entry Wenn gesetzt, wird der -1-Wert nicht in die Liste der Optionen geschrieben. Der -1-Wert sucht nach allen Objekten, die nicht mit der Link-Tabelle verlinkt sind. Im Stringtool heisst dieser Key TABLELINK/NO ENTRY/ + <Linktable> bzw. + Name Appendix.
Omit Null-Entry Wenn gesetzt, wird der null-Wert nicht in die Liste der Optionen geschrieben. Der null-Wert führt dazu, dass dieser cell/TABLELINK in der Suche übersprungen also nicht berücksichtigt wird. Im Stringtool heisst dieser Key TABLELINK/NONE/ + <Linktable> bzw. + Name Appendix.
Select Objects For Null-Entry SQL-WHERE clause für das Filtern von Objekt-IDs aus der Link-Tabelle. Diese Objekt-IDs werden für die Suche benutzt, wenn der Benutzer den Null-Entry auswählt.
Omit Read-Only Text Wenn gesetzt, wird hinter den Optionen, die Nur-Lesen-Link-Objekte repräsentieren, kein (nur lesend) geschrieben. Der Text kann über Stringtool l10n.tablelink.ReadOnly angepasst werden.
Name Appendix Alternative Ergänzung für die Stringtool-Variablen TABLELINK/NO ENTRY/ und TABLELINK/NONE/.
Ids From Values PHP PHP-Funktion, um die selektierten Werte zu verändern, filtern oder anzupassen. Erwartet die Rückgabe eines Arrays mit den Link-Objekt-IDs. $value kann ein einzelner Wert, ein Array oder ein String sein, je nachdem in welchem Modus der TABLELINK benutzt wird. Wenn ein String zurückgegeben wird, wird dieser direkt in die SQL-Query eingefügt. Seit Version 4.0.326: String-Rückgabe.
Class DOM class für das SELECT- bzw. DIV-Element.
Style DOM style für das SELECT- bzw. DIV-Element.
Title DOM title für das SELECT- bzw. DIV-Element (unterstützt Übersetzungen durch %l10n.<keyname>% )
Tags Beliebiger String, der in die Deklaration des SELECT bzw. DIV kopiert wird.