TYPO3 Plugin:

hwfirmenliste

Readme zu der Extension: tx-hwfirmenliste

  1. Abhängigkeiten
  2. Typo3 html-tag erstellen
  3. Container(Ordner) für Listeneinträge einrichten
  4. Listenplugin auf anderer Seite wie Ordner einbinden
  5. Felder in die Live Suche mitaufnehmen
  6. Sortierungs Felder bearbeiten/hinzufügen
  7. Standard Bildgröße der Detailbilder festlegen
  8. Cache deaktivieren
  9. Anzahl der Einträge pro Seite für das BE Modul bestimmen

1. Abhängigkeiten

  • Aktuelle J-Query Bibliothek (Version 1.7+) einbinden.
  • Html4 html-tag mit "no-js" Klasse. Siehe "2. Typo3 html-tag erstellen".
  • Modernizr Schnipsel im head einfügen (modernizr.com). Alternativ kann der Mini-Modernizer aktiviert werden (Siehe Code bei 2.), indem settings.debug auf 1 gesetzt wird.
  • Css Datei ?default-list.css? einbinden. Entweder die allgemeine Datei aus dem H&W Repository verwenden, oder im Extensionmanager unter Einstellungen (Zahnradsymbol) den Haken bei ?CSS Datei einbinden? setzen.

2. Typo3 html-tag erstellen

Folgender Schnipsel sollte in jedem Projekt im Root Template eingebunden werden. Am besten fügt man Diesen in einen bereits bestehenden ?page.config{?}? Knoten ein.

Code:

# Für DebugActions und für Mini-Modernizr folgenden Parameter aktivieren
# plugin.tx_hwfirmenliste.settings.debug = 1

# Html5 Header in Typo3 rendern
page {
    config {
        #disableAllHeaderCode = 1   #Wenn aktiv, wird der komplette Typo3 header abgeschaltet

        doctype = html5
        htmlTag_setParams = none
        htmlTag_langKey = de
        language = de
        locale_all = de_DE

        #http://forge.typo3.org/issues/30404
        #http://de.slideshare.net/sritterkh1/neuerungen-in-typoscript-in-typo3-version-47
        htmlTag_stdWrap {
          setContentToCurrent = 1
          cObject = COA
          cObject {
            10 = LOAD_REGISTER
            10 {
              newLine.char = 10
              tagEnd {
                current = 1
                split.max = 2
                split.token = <html
                split.returnKey = 1
                }
            }

            #Internet Explorer Kennzeichnung
            20 = TEXT
            20.value = <!--[if lt IE 7]><html class="no-js ie lt-ie10 lt-ie9 lt-ie8 lt-ie7 ie6" lang="de" {register:tagEnd}<![endif]-->
            20.wrap = |{register:newLine}
            20.insertData = 1
            30 < .20
            30.value = <!--[if IE 7]><html class="no-js ie lt-ie10 lt-ie9 lt-ie8 ie7" lang="de" {register:tagEnd}<![endif]-->
            40 < .20
            40.value = <!--[if IE 8]><html class="no-js ie lt-ie10 lt-ie9 ie8" lang="de" {register:tagEnd}<![endif]-->
            50 < .20
            50.value = <!--[if IE 9]><html class="no-js ie lt-ie10 ie9" lang="de" {register:tagEnd}<![endif]-->
            60 < .20
            60.value = <!--[if gt IE 9]><!--><html class="no-js" lang="de" {register:tagEnd}<!--<![endif]-->

            90 = RESTORE_REGISTER
          }
        }
    }
}

3. Container(Ordner) für Listeneinträge einrichten

Um eine Seite als gültigen Container für das Backend Werkzeug "Firmenliste" einzurichten, muss man zunächst auf Seite bearbeiten klicken (Stift). Danach kann man unter dem Reiter "Verhalten" im Menüpunkt "Benutze als Container" den gewünschten Container auswählen. In diesem Fall: "Firmenliste".
Nach dem Abspeichern sollte man diese Seite nun mit dem Modul "Firmenliste" bearbeiten können.

4. Listenplugin auf anderer Seite wie Ordner einbinden

Wenn das Plugin nicht auf der Typo3 Seite, die als Firmen Container dient, eingebunden ist, muss noch der Ort an dem die Datensätze zu finden sind konfiguriert werden. Am einfachsten konfiguriert man Diesen über das Plugin selber. Dazu klickt man zunächst auf den Bearbeitungsbutton (Stift) des Plugins. Als nächstes kann man unter dem Reiter "Verhalten" dem Plugin Datensatzsammlungen zuweisen. Dazu einfach die Seiten mit den Containern die die gewünschten Datensätze enthalten hinzuklicken.

Alternativ kann man den Ort an dem die Datensätze zu finden sind über das Template konfigurieren.

Beispiel:
Der "Ordner" mit den pflegbaren Listeneinträgen befindet sich auf der Typo3 Seite mit der ID 7. Das Fronted Auflistungsplugin befindet sich hingegen auf der Seite mit ID 12. Dann muss folgender Schnipsel ins Setup Template der Seite mit dem FE Plugin (also die mit ID 12) übertragen werden.

Code:

# Storage Pid festlegen 
plugin.tx_hwfirmenliste.persistence.storagePid = 7

5. Standard Bildgröße der Detailbilder festlegen

Mit folgendem Code kann die Standardgröße für die zwischengespeicherten Bilder eingestellt werden.

Code:

# Bilderkonfiguration
hwfirmenlisteImg = IMG_RESOURCE
hwfirmenlisteImg {
    file.import = /uploads/tx_hwfirmenliste/ #Bilderpfad
    file.maxW = 233c #Bilderbreite c(crop) nach der Zahl nicht vergessen
    file.maxH = 175c #Bilderhoehe c(crop) nach der Zahl nicht vergessen
}

6. Cache deaktivieren

Die Firmeneinträge werden standardmäßig in 'typo3temp/hwfirmenliste/cache.html' zwischengespeichert. Sobald ein Firmeneintrag im Typo3 geändert, gelöscht oder hinzugefügt wird, wird der Cache automatisch entfernt. Der Cache wird beim nächsten Aufruf der Seite neu erzeugt.

Mit folgendem TS Code kann der Cache bei Bedarf deaktiviert werden.

Code:

# Cache deaktivieren
plugin.tx_hwfirmenliste.settings.cacheing = 0

7. Anzahl der Einträge pro Seite für das BE Modul bestimmen

Die Anzahl der aufgelisteten Firmen pro Seite im Backend-Modul kann mit folgendem TS Code geändert werden. Der Wert ist standarmäßig bei 12.

Code:

# Anzahl der Einträge im BE bestimmen
module.tx_hwfirmenliste.settings.itemsPerPage = 12

8. Gruppenrechte

tx_hwfirmenliste {
    verein {
        showOnlyEntriesByUser = 0
        sortingBy = name
        sortingOrder = asc
        showSearchFormHiddenByRole = 1
    }
}

9. Excelexport

Der Export lässt sich im Konstanteneditor unter MODUL ( nicht PLUGIN! ) aktivieren. Um Felder und deren Überschriften zu überschreiben wird folgender TS Code benötigt

 module.tx_hwfirmenliste.settings.excelExportUeberschriften >
        module.tx_hwfirmenliste {

            settings {
                excelExportUeberschriften {
                    name = Titel
                    beschreibung = Beschreibung
                    telefon = Telefon
                    extra3 = BIC
                }
            }
        )

Benötigen Sie schnelle Hilfe mit dieser Extension? Unser Team von erfahrenen TYPO3-Entwicklern löst Probleme unkompliziert und zum Stundensatz.


Stichprobe n=36680 von Gosign gecrawlte TYPO3-Seiten mit den Top-Level-Domains <.de/.ch/.at>