Clip_Erfahrungsseite

Guite edited this page Nov 12, 2014 · 2 revisions

Hier sammeln wir erst einmal unsere erfahrungen mit Clip. Wir hoffen, dass es auch einmal eine umfassende Dokumentation geben wird.

Allgemeines

Clip ist ein Modul für die Erstellung von sog. Publikationen, mit denen Daten unterschiedlichster Art in Listform und als Einzelansicht des Datensatzes angezeigt werden können. In der Publikation werden, neben den vorhandenen Standardfeldern wie z.B. Erstellungsdatum, Autor, Sprache, können nach Bedarf eigene Felder unterschiedlichster Art angelegt werden, welche dann in der Datenbank angelegt werden und in den "Darstellungstemplates" als Variablen zur Anzeige zur Verfügung stehen.

Diese Variablen lassen sich im Template mit dem bewährten {zdebug} anzeigen.

Clip liefert folgende Templates mit:

  • Main
  • List

mit diesem Template wird die Listdarstellung der Daten erzeugt. Für jeden Datensatz eine Zeile der Liste. Welche Daten angezeigt werden, kann durch den Einbau der entsprechenden Variablen (s.o.) gesteuert werden.

Standardmäßig wird die Listanzeige als Tabelle ohne Überschrift generiert, so dass durch die Ergänzung mit

Feldname

in der Tabelle diese deutlich an Aussehen gewinnt.

  • List Filter

möchte ich oberhalb meiner Liste eine Filtermöglichkeit haben, dann kann Clip für jedes angelegte Feld einen Filter generieren. Der generelle Code für ein in der Feldkonfiguration als Titelfeld gekennzeichnete Feld sieht z.B. so aus:

`       {clip_filter_plugin p='Label' field='core_title' id='core_title_label' for='core_title_op' __text='Titel'}` `       {clip_filter_plugin p='OpString' field='core_title' id='core_title_op' enabled='search,likefirst,eq'}` `       {clip_filter_plugin p='String' id='core_title'}` `  `
  • Display

Dieses Template ist zuständig für die Einzelansicht des jeweiligen Datensatzes

  • Form

Dies ist das Eingabeformular für die Tabelle der Publikation.

Sortieren

Threads zum Thema: http://support.zikula.de/module-CMS_Support_Forum-viewtopic-topic-31176.htm http://support.zikula.de/module-CMS_Support_Forum-viewtopic-topic-31161.htm

Beispiel für eine Sortierung, die nach jedem "Klick" nach dem Titel auf-/ bzw. absteigend sortiert:

Titel

Filtern

Threads zum Thema: http://support.zikula.de/module-CMS_Support_Forum-viewtopic-topic-31184.htm http://support.zikula.de/module-CMS_Support_Forum-viewtopic-topic-30799.htm http://community.zikula.org/module-Forum-viewtopic-topic-59162.htm http://community.zikula.org/module-Forum-viewtopic-topic-59127.htm http://community.zikula.org/module-Forum-viewtopic-topic-58240.htm (zur Vorgängerversion Pagemaster)

Möchte ich z.B. nach dem vorhandenen Feld "Nachname" filtern, dann ändere ich "core_title" zu "Nachname" :

`       {clip_filter_plugin p='Label' field='Nachname' id='Nachname_label' for='Nachname_op' __text='Nachname'}` `       {clip_filter_plugin p='OpString' field='Nachname' id='Nachname_op' enabled='search,likefirst,eq'}` `       {clip_filter_plugin p='String' id='Nachname'}` `  `

Will ich nach einem Feld aus einer verknüpften Publikation filtern, muss ich den korrekten Feldnamen angeben, z.B.: Ich habe eine Verknüpfung (Relation) mit Namen "buch", welche mir in {zdebug} bei $publist als buch => Array(xx) und den dort vorhandenen Feldern, z.B. "name" angezeigt wird, so filtere ich nach:

`       {clip_filter_plugin p='Label' field='buch.name' id='buch.name_label' for='buch.name_op' __text='Name des Buches'}` `       {clip_filter_plugin p='OpString' field='buch.name' id='buch.name_op' enabled='search,likefirst,eq'}` `       {clip_filter_plugin p='String' id='buch.name'}` `  `

Welche Filtermöglichkeiten zu Auswahl angeboten werden, kann ich mit der Einstellung "enabled" steuern; so würde "enabled='eq,ne,likefirst' " ein Dropdownfeld mit "ist gleich", "ist nicht gleich" , "beginnt mit" anzeigen. Mehr Lesestoff dazu findet sich in der Datei: /modules/Clip/lib/Clip/Filter/Plugin/OpString.php

Nach Ja/Nein - Feldern, die z.B. mit Checkboxen (Beispiel:"kennzeichen") gefüllt werden kann ebenfalls gefiltert werden:

`       {clip_filter_plugin p='Label' field='kennzeichen' id='kennzeichen_label' for='kennzeichen_op' __text='Kennzeichen'}` `       {clip_filter_plugin p='YesNo' field='kennzeichen' id='kennzeichen_op' enabled='Yes,No'}` `  `

Tipps

Bilder

In Clip lassen sich hochgeladene Bilder gut mit den Funktionalitäten des ImageViewer (oder ähnliche Clone) anzeigen. Damit dies generell funktioniert muss in den templates, die Bilder aufrufen sollen "{ajaxheader ui=true imageviewer="true"}" ergänzt werden.

Threads zum Thema: http://support.zikula.de/module-CMS_Support_Forum-viewtopic-topic-31021.htm http://support.zikula.de/module-CMS_Support_Forum-viewtopic-topic-31195-start-0.htm

Hinweis

Mit dem Update des Apache auf Version 2.4 hat sich die Handhabung von "deny,allow" geändert, welches u.a. Auswirkungen auf den Imageviewer im IE hat.

Damit der Zugriff auf die *.js - Dateien wieder möglich wird, sollte die .htaccess im javascript-Ordner wie folgt geändert werden:

  • alt:

deny from all

<FilesMatch ".(css|js|jpg|gif|png)$">

order allow,deny

allow from all

  • neu:

Require all denied

<FilesMatch ".(css|js|jpg|gif|png)$">

Require all granted

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.