Shop-Software CP::Shop - Eröffnen Sie Ihren eigenen Online-Shop!Shop-Software CP::Shop - Eröffnen Sie Ihren eigenen Online-Shop!
Informationen zur Shop-Software CP::Shop Pressemeldung zur Veröffentlichung von CP::Shop 2016.1

Container: Auflistungen auf der Webseite anzeigen

Eine Auflistung von einzelnen Einträgen eines mit CP::Forms erstellten Modules wird wie gewohnt über einen Container sowie die {cp:tags} erstellt. Dabei kann über die Parameter des Containers frei angegeben werden, wie die angezeigten Einträge formatiert (Parameter "template") und geordnet sein sollen (Parameter "order" und "dir" ["asc"/"desc"] für die Richtung), wieviele Einträge max. ausgegeben werden sollen (Parameter "limit") und welche Seite angezeigt wird (Parameter "page").

Dieser Container gibt z.B. die ersten 5 Einträge des Modules "jobs" aus:

{cp:container module="jobs" type="list" page="1" limit="5" order="date_added" dir="asc" template="modules/jobs/templates/job_vorlage.html"}

Die Einträge sind im Beispiel nach dem Datum der Eintragung geordnet (aufsteigend). Zur Anzeige der Einträge wird die Vorlage "job_vorlage.html" im Unterordner "templates" des Modules verwendet.

In der über den Parameter "template" angegebenen Vorlage können jeweils die in der "{cp:tags}-Erklärung" des Modules genannten {cp:tags} verwendet werden (diese "{cp:tags}-Erklärung" kann direkt aus der Übersichtsseite des Modules heraus aufgerufen werden). Wenn keine Vorlage angegeben wird, so wird die Vorlage "list_public.html" im Unterordner "templates" des Modules standardmäßig genutzt.

Über die Parameter "select_field" und "select_value" ist optional eine Filterung der Einträge möglich. Für den Parameter "select_field" wird der Feldname angegeben, für "search_value" der gewünschte Wert. Wenn in mehreren Feldern gesucht werden soll, dann sind die Feldnamen / Werte per Komma zu trennen. Beziehen sich alle Werte auf dasselbe Feld, dann genügt es, wenn dieses Feld einmalig angegeben wird.

Standardmäßig erfolgt eine nachgeschaltete Filterung der Einträge, d.h. nur Einträge die alle Kriterien erfüllen, werden ausgegeben. Möchten Sie dagegen mehrere Abfragen miteinander kombinieren, dann verwenden Sie zusätzlich den Parameter "select_type" mit dem Wert "combine". Eine Ähnlichkeitssuche ist über "%" bei einem Wert oder mehreren Werten möglich:

{cp:container module="events" type="list" select_field="section" select_value="2"}
// Einschränkung der Auflistung auf die Kategorie mit der ID "2"

{cp:container module="events" type="list" select_field="location_city" select_value="Berl%"}
// Einschränkung auf Veranstaltungsorte mit dem Stamm "Berl" (also z.B. "Berlin", "Berlingen"...)

Folgende Angaben sind zulässig / erforderlich (unterstrichen):

Parameter für diesen Container
date_from Einträge ab ... anzeigen (Zeitangabe im Timestamp-Format erforderlich)
date_to Einträge bis ... anzeigen (Zeitangabe im Timestamp-Format erforderlich)
dir Aufsteigend ("asc") oder absteigend ("desc") ordnen
limit Anzahl der insgesamt angezeigten Einträge
max_age Max. Alter der anzuzeigenden Einträge in Sekunden
order Einträge ordnen (siehe unten)
page Angezeigte Seite
select_field Feldname für die Filterung der Einträge
select_type Einträge aus den Abfragen kombinieren ("combine") oder mehrmals filtern ("filter" bzw. ohne)
select_value Wert für die Filterung der Einträge
template Pfad zu einer Vorlage (andernfalls wird Standardvorlage genutzt)
type Typ des Containers (hier immer "list")

Werte für den Parameter "order" (Ordnung)
number Nach Eintragungsreihenfolge ordnen
hits Nach Anzahl der Aufrufe ordnen
version Nach Versionsnummer ordnen
date_added Nach Datum der Eintragung ordnen
date_lastmodified Nach Datum der letzten Änderung ordnen
random Zufällig ordnen
start_time Laufzeit Start
stop_time Laufzeit Stop
status Status
... Zusätzlich kann für "order" jeder Feldname des Modules angegeben werden.

Weitere Einträge zu "CP::Forms"

<< zurück zur Kategorie "CP::Forms"