Demonstration des Special Tags csv2table

Hinweis: bei allen Beispielen wird auf die Verwendung der []-Klammern für die Markierung der Spezial-Tags verzichtet.

Das Special Tag csv2table dient dazu, den Inhalt einer zuvor hochgeladene CSV-Datei in einer MySQLiteCMS-Seite in einer Tabelle auszugeben. Es gibt dabei 2 Möglichkeiten:

• csv2table:dateiname - wenn also nur der Dateiname angegeben wird, dann werden für alle anderen Parameter die Standardannahmen gesetzt. dateiname muss ein gültiger Dateiname einer bereits hoch geladenen CSV-Datei sein.
• csv2table:dateiname|delimiter|id|filter|firstRowHeader|sortable|responsiv|tableclass - bei dieser Variante ist zu beachten, dass alle Parameter gesetzt sein müssen. Das kann auch durch eine leere Vorgabe erfolgen. Bei leeren Vorgaben werden wiederum die Standardannahmen verwendet.

• delimiter - der in der CSV-Datei verwendete Feldbegrenzer; Standardannahme ist ,
• id - eine eindeutige Kennung für den gesamten Tabellenbereich, hilfreich für mehrere Tabellen in einer Seite. Standardannahme ist csv
• filter - Verwendung des Zeilenfilters, nur 0 oder 1. Standardannahme ist 1, Filter wird verwendet.
• firstRowHeader - 1.Zeile wird als Spaltenüberschrift verwendet, nur 0 oder 1. Standardannahme ist 1, 1.Zeile wird verwendet.
• sortable - Zeilen sind mit Click auf eine Spaltenüberschrift sortierbar, nur 0 oder 1. Standardannahme ist 1, also sortierbar.
• responsiv - der gesamten Tabellenbereich wird so dargestellt, dass man bei kleinen Bildschirmen horizontal scrollen kann, nur 0 oder 1. Standardannahme ist 1, also scrollbar.
• tableclass - es können weitere CSS-Klassen übergeben werden, beliebige Zeichenfolgen, mehrere Klassen sind durch ein Leerzeichen zu trennen. Standardannahme ist table table-striped, also scrollbar.

Beispiel 1 mit gefüllten Parametern, vollständig

Der Code für dieses Beispiel ist:

csv2table:example-01.csv|,|csv|1|1|1|1|table

Beispiel 2 mit leeren Parametern, vollständig

Der Code für dieses Beispiel ist:

csv2table:example-01.csv|||||||

Im Unterschied zum vorherigen Beispiel wird hier auf Grund des leeren Parameters die Standardannahme table table-striped verwendet. Das führt dazu, dass jede 2.Zeile farblich abgehoben wird.

Beispiel 3 mit leeren Parametern, unvollständig

Der Code für dieses Beispiel ist:

csv2table:example-01.csv||||||

Da der Code nicht regelkonform ist wird eine Meldung mit Hinweisen ausgegeben.

Falsche Paramenterzahl!
[csv2table] verlangt entweder 1 oder 8 Parameter
Also [csv2table:dateiname]. Dann werden für alle anderen Parameter Standardwerte gesetzt. Oder:
[csv2table:dateiname|delimiter|id|filter|firstRowHeader|sortable|responsiv|tableclass] oder
[csv2table:dateiname|delimiter|id|||sortable||tableclass]. Für die leeren Parameter werden dann Standardwerte gesetzt.

Beispiel 4 ohne Parameter, nur falscher Dateiname

Der Code für dieses Beispiel ist:

csv2table:dummy

Die Datei existiert nicht, es wird eine entsprechende Meldung ausgegeben.

File '/home/webpages/lima-city/mein-wunschname/mein-wunschname.lima-city.at/static/files/dummy' does not exist!

Beispiel 5 ohne Parameter, nur richtiger Dateiname

Der Code für dieses Beispiel ist:

csv2table:example-01.csv

Faktisch ist dies identisch mit Beispiel 2, dementsprechend wirken sich Filterungen auf beide Beispiele aus.