hwtoubizkalender

Readme zu der Extension: hwtoubizkalender

1. VORAUSSETZUNGEN

1.1 TYPO3

• TYPO3 6.2: keine Unterstützung
• TYPO3 7.6: ok

1.2 hwlib

• vom 11.01.2017 oder neuer (kann mit dem Kommando git log geprüft werden)

1.3 Veranstaltungskalender (hwveranstaltung)

• Version 4.1.0 oder neuer

2. INSTALLATION

Die Extension kann mit folgendem Code in der Konsole installiert werden:
in das Verzeichnis "projekt.t3/typo3conf/ext" wechseln

git clone git@bitbucket.org:hirschwoelfl/typo3.ext.hwtoubizkalender.git hwtoubizkalender

3. KONFIGURATION

3.1 Ordner / Datensatz für Veranstaltungen angeben

Im Konstanten-Editor den Ordner / Datensatz mit den Veranstaltungen des Moduls Hirsch & Wölfl Veranstaltungskalender (hwveranstaltung) eintragen.

3.2 Zugangsdaten bei Land in Sicht anfordern

Mit Dirk von Land in Sicht in Kontakt treten und mit ihm den Datenaustausch der Veranstaltungskalender abklären.
Die Zugangsdaten über den TYPO3-Konstanten-Editor in das Projekt eintragen.

3.3 TOUBIZ-Kategorien anlegen

3.3.1 Konfiguration downloaden

In das Verzeichnis "projekt.t3/typo3temp/" wechseln

wget -O "toubiz-config.json" "http://api.toubiz.de/json/event/json_profile.php?mandant={MANDAT-EINFÜGEN}&key={KEY-EINFÜGEN}"

3.3.2 Konfiguration parsen

Anschließend im Browser folgende URL aufrufen und dabei den Order für die Veranstaltungen als Parameter PID anhängen:

http://server-hirsch-woelfl.de/projekt.t3/typo3conf/ext/hwtoubizkalender/Documentation/jsonParser.php?pid={PID-EINFÜGEN}

3.3.3 per phpMyAmin TOUBIZ-Kategorien und Orte anlegen

Das SQL-Statement aus 3.3.2 kopieren und mittels phpMyAdmin in das Projekt eintragen.

3.3.4 TOUBIZ-Kategorien den Hirsch & Wölfl Kategorien zuordnen

Im TYPO3-Listenmodul die Spalte Zuordnung Kategorie des Veranstaltungskalenders anzeigen lassen und über die Massenbearbeitung alle TOUBIZ-Kategorien den Projektkategorien zuordnen.

Fortsetzung:

3.3.5 Standardtwert im Veranstaltungsdatensatz festlegen

Den Ordner / Datensatz mit den Veranstaltungen bearbeiten und im Seiten-TSconfig die (TYPO3-) UID des Hauptorts als Standardwert eintragen.

TCAdefaults {
    tx_hwveranstaltung_domain_model_veranstaltung {
        toubiz_locations = 44
        # 44: im Listenmodul die ID des Hauptorts in den TOUBIZ-Features nachsehen
    }
}

Damit ist in allen neuen Einträgen der Veranstaltungsort für TOUBIZ bereits vorbelegt.

3.4 Cronjobs anlegen

Jeweils einen Cronjob zum IMPORTIEREN und LÖSCHEN der TOUBIZ-Veranstaltungen anlegen.
WICHTIG: DIE CRONJOBS DÜRFEN NICHT GLEICHZEITIG LAUFEN!

3.5 TOUBIZ-Export anlegen

3.5.1 Export LISTE

Eine neue TYPO3-Seite anlegen mit folgenden Einstellungen:

• In Menüs: verbergen
• Als Anfang der Website benutzen: AKTIVERT
• In Indexsuche einbeziehen: DEAKTIVIERT
• Cache: DEAKTIVIERT
• Plugin einbinden: Hirsch & Wölfl TOUBIZ-Veranstaltungskalender - Export: Liste

Der Seite einen Domain-Record und Subdomain zuweisen. Zum Beispiel: toubiz-list.domain.de oder projekt-xyz-toubiz-list.hirsch-woelfl.de

3.5.2 Export DETAILS

Eine neue TYPO3-Seite anlegen mit folgenden Einstellungen:

• In Menüs: verbergen
• Als Anfang der Website benutzen: AKTIVERT
• In Indexsuche einbeziehen: DEAKTIVIERT
• Cache: DEAKTIVIERT
• Plugin einbinden: Hirsch & Wölfl TOUBIZ-Veranstaltungskalender - Export: Details

Der Seite einen Domain-Record und Subdomain zuweisen. Zum Beispiel: toubiz-detail.domain.de oder projekt-xyz-toubiz-detail.hirsch-woelfl.de

3.5.3 URLs des Export an Land in Sicht senden

Die beiden URLs des TOUBIZ-Exports an Dirk von Land in Sicht senden.

4. DOKUMENTATION EXPORT-SCHNITTSTELLE

4.1 Export: Liste

Parameter: begin
Typ: Integer, UNIX-Timestamp

Bsp:
http://gengenbach-toubiz-list.hirsch-woelfl.de/index.php?begin=1484694000

Bestimmt den Zeitpunkt, ab dem die Änderungen ausgegeben werden. 0 für alle Veranstaltungen ausgeben.

Optionaler Parameter: debug
Typ: Integer, erlaubte Werte 0, 1

Bsp:
http://gengenbach-toubiz-list.hirsch-woelfl.de/index.php?begin=0&debug=1

Es erfolgt eine lesbare Ausgabe.

4.2 Export: Detail

Parameter: id_hw
Typ: Integer

Bsp:
http://gengenbach-toubiz-detail.hirsch-woelfl.de/index.php?id_hw=4

Hirsch & Wölfl ID der Veranstaltung.

Optionaler Parameter: debug
Typ: Integer, erlaubte Werte 0, 1

Bsp:
http://gengenbach-toubiz-detail.hirsch-woelfl.de/index.php?id_hw=4&debug=1

Es erfolgt eine lesbare Ausgabe.

Optionaler Parameter: maxWidth
Typ: Integer
Default: 800

Bsp:
http://gengenbach-toubiz-detail.hirsch-woelfl.de/index.php?id_hw=4&maxWidth=400

Legt die max. Breite der Bilder fest.

Optionaler Parameter: maxHeight
Typ: Integer
Default: 600

Bsp:
http://gengenbach-toubiz-detail.hirsch-woelfl.de/index.php?id_hw=4&maxHeight=250

Legt die max. Höhe der Bilder fest.

5. HISTORY

• 4.0.1 (06.04.2017): kompatibel zu Veranstaltungskalender V4.1.2 und höher;
  Änderungen bei der Terminen in Absprache mit Land in Sicht
• 4.0.0 (08.02.2017): finale Version

KONTAKTDATEN LAND IN SICHT

land in sicht AG - Agentur für touristische Neulanderoberung
Dokumentation TOUBIZ-Schnittstelle (Stand Dezember 2016)