=== Evangelische Termine ===

Contributors: regibaer  
Tags: evangelische, termine, elkb, vernetzte, kirche  
Requires at least: 3.0  
Tested up to: 6.3
Stable tag: 3.3
License: GPLv2 or later  
License URI: http://www.gnu.org/licenses/gpl-2.0.html 

Mit dem Plugin "Evangelische Termine" wird die Datenbank der "Evangelischen Termine" abgefragt und in Wordpress eingebunden. 

== Description ==

ACHTUNG: Dieses Plugin wird ab 8/2023 nicht mehr weiterentwickelt. In den Evangelischen Terminen wurde ein Widget integriert,
das in allen CMS-Systemen eingesetzt werden kann. Das Widget stellt die Einträge in der Datenbank mit Titelbild und Ort dar.
Über eine Proxy-Datei, werden die Inhalte geladen und in die Webseite integriert. Damit werden auch Datenschutzprobleme
umgangen, da die IP-Adressen der User nicht mehr an weitere Dienstleister übermittelt werden.
Informationen zum Widget finden sich nach Anmeldung in den Evangelischen Terminen unter Information -> Widgets.

Mit dem Plugin "Evangelische Termine" wird die Datenbank der "Evangelischen Termine" abgefragt und in Wordpress eingebunden. 
Über Shortcodes/Makros und über ein Widget wird die Anzeige für einzelne/mehrere Veranstalter oder für eine Region gesteuert.

= Features =

* Shortcode [et_veranstalter @parameter] zur Einbindung der Evangelischen Termine in einem Beitrag oder auf einer Seite
* Shortcode [et_teaser @parameter] zur Einbindung der Evangelischen Termine in einem Beitrag oder auf einer Seite
* Shortcode [et_panels @parameter] zur Einbindung der Evangelischen Termine als Panels
* Shortcode [et_minical @parameter] zur Einbindung des Mini-Kalenders der Evangelischen Termine
* Widget "Evangelische Termine" zur Einbindung der Evangelischen Termine in einem Widget-Bereich
* Option-Page für die Grundeinstellungen des Plugins
* Überschreiben der Grundeinstellungen über die @parameter bei den Shortcodes und im Widget
* Einbinden von eigenen CSS-Dateien

= Shortcodes =

Über den Shortcode `et_veranstalter` wird das Veranstalter-Modul der
Evangelischen Termine aufgerufen. Es wird ein Filterfeld angezeigt und
darunter die Terminliste.  
`[et_veranstalter @parameter]`

Der Shortcode `et_teaser` ruft das Teaser-Modul auf. Es wird eine Terminliste
ohne Suchfunktion ausgegeben.  
`[et_teaser @parameter]`

Der Shortcode `et_panels` ruft das Teaser-Modul auf. Es wird eine Panelansicht
mit den hinterlegten Bildern ausgegeben.    
`[et_panels @parameter]`  
Wenn das Panel mit dem "Mehr"-Link nicht angezeigt werden soll, muss man im CSS folgendes hinterlegen:

`CSS
#load1 {
	display: none;
}
`

Mit dem Shortcode `et_minical` wird der Mini-Kalender aus den Evangelischen Terminen eingebunden.  
`[et_minical @parameter]`

Beschreibung der [@parameter](http://wordpress.org/plugins/evangtermine/other_notes/#Parameter)

== Installation ==

* `evangtermine.zip` in das `/wp-content/plugins/` Verzeichnis hochladen und dort entpacken.
* Plugin über das 'Plugins'-Menü in Wordpress aktivieren.
* Grundeinstellungen im Menü 'Einstellungen' 'Evangelische Termine' anpassen.

== Other Notes ==

= Grundeinstellungen =

Die Grundeinstellungen finden sich im Menü 'Einstellungen' 'Evangelische
Termine'. Die einzelnen Optionen sind:

**Veranstalter-ID**: Die Veranstalter-ID wird in den Evangelischen Terminen
nach der Anmeldung unter http://www.evangelische-termine.de/ rechts oben
angezeigt. Möchte man mehrere Veranstalter auf der Website anzeigen lassen,
können die IDs in einer kommagetrennten Liste angegeben werden. Es dürfen
keine Leerzeichnen verwendet werden.  
Beispiel: id1,id2,..,idn

**Dekanats-ID**: Hier kann die Dekanats-ID der Evangelischen Termine
eingetragen werden. Sie wird an die Evangelischen Termine im Feld region
übergeben und zeigt die Veranstaltungen aller Veranstalter innerhalb des
Dekanats an.

**Until**: Mit diesem Schalter kann ausgewählt werden, ob Veranstaltungen bis
zum Enddatum angezeigt werden (yes|no). Default: yes.

**CSS-Datei**: über dieses Feld kann man dem Plugin eine CSS-Datei mitteilen,
die dann statt der CSS-Datei verwendet wird, die mit den von den Evangelischen Terminen
übermittelten Daten ausgeliefert wird. Möchte man das CSS in Wordpress direkt hinterlegen,
gibt man in dieses Feld 'nocss' ein.

**Encoding**: über diesen Schalter kann die Zeichenkodierung der Website
ausgewählt werden. Die Daten der Evangelischen Termine werden dann
entsprechend angepasst (utf8 oder latin1). Default: utf8.

**Protokoll**: Auswahl des Protokolls (http:// | https://). Wenn das Protokoll nicht ausgewählt wird,
verwendet das Plugin das Protokoll über das die Website betrieben wird ($_SERVER['REQUEST_SCHEME']).

**Host**: Der Server, auf dem die Kalenderdaten gehostet werden.
Beispiel: www.evangelische-termine.de

= Parameter =

Eine genaue Beschreibung der möglichen Parameter findet sich im
[Handbuch der Evangelischen Termine](http://handbuch.evangelische-termine.de/Ausgabe-Parameter/). In der aufgeführten Liste 
sind die implementierten Parameter aufgeführt:

**vid**: Veranstalter-ID(s); mehrere IDs können durch Komma getrennt werden - Beispiel: `[et_teaser vid="952,988"]`

**region**: dreistellige Dekanatsnummer oder mehrere durch Kommata getrennte Dekanatsnummern. Im Filterfeld des 
Shortcodes `[et_veranstalter]` wird dann ein weiteres Feld angezeigt, über das ein Website-Benutzer den gewünschten Veranstalter 
auswählen kann. Die vid sollte dann auf vid="all" oder auf einen vorselektierten Veranstalter gesetzt werden.

**eventtype**: ID der Veranstaltungskategorie - ein vorangestelltes "-" negiert die Auswahl; mehrere IDs können durch Komma getrennt werden.

**highlight**: zeigt entweder alle Veranstaltungen an (all) oder nur die Veranstaltungen, die als Highlight markiert sind (high).

**people**: durch Komma getrennte Liste der IDs der der Zielgruppen

**person**: durch Komma getrennte Liste der IDs der Ansprechpartner

**place**: durch Komma getrennte Liste der IDs der Veranstaltungsorte

**ipm**: durch Komma getrennte Liste der IDs der Veranstaltungstypen (Eingabemasken)

**cha**: durch Komma getrennte Liste der IDs der Kanäle

**itemsperpage**: Anzahl der anzuzeigenden Veranstaltungen. Für den Shortcode `[et_veranstalter]` sollten nur die
Werte 5, 10, 20, 30, 40, 50 oder 100 verwendet werden. Default: 20.

**dest**: Gibt an, welche Veranstaltungen angezeigt werden sollen (extern = nur die öffentlichen, intern = nur die internen, 
all = alle Veranstaltungen). Default: extern.

**until**: Gibt an, ob eine Veranstaltung bis zum Enddatum angezeigt werden soll oder nicht (yes|no). Default: yes.

**q**: über diesen Parameter können Suchbegriffe übergeben werden. Die Begriffe werden durch ein Leerzeichen getrennt.

**auswahl**: Über diesen Parameter können in Bayern Erwachsenenbildungsveranstaltungen abgerufen werden, die entweder über die 
Eingabemaske `Erwachsenenbildung` oder mit den Kanal `Erwachsenenbildung` angelegt wurden.

= Widget =

Die Beschreibung der Parameter findet sich im [Handbuch der Evangelischen Termine](http://handbuch.evangelische-termine.de/Ausgabe-Parameter/).

== Screenshots ==

1. Grundeinstellungen des Plugins
2. Ausgabe des Shortcodes `[et_veranstalter]`
3. Ausgabe des Shortcodes `[et_teaser]`
4. Widget-Einstellungen
5. Ausgabe des Widgets

== Changelog ==

= 3.3 =
* FIXED: Darstellungsproblem im Modul et_panels

= 3.2 =
* FIXED: jquery wird lokal geladen und nicht von einem CDN abgerufen

= 3.1 =
* FIXED: et_veranstalter - Suchbegriff wurde nicht mehr übertragen

= 3.0 =
* Curl ist nicht mehr erforderlich, stattdessen werden die Evangelischen Termine mithilfe der http-Api von Wordpress abgefragt.
* FIXED: Sessionhandling im Shortcode et_veranstalter

= 2.3.1 =
* ADDED: Feld für weitere Parameter im Widget ergänzt

= 2.3 =
* ADDED: Shortcode et_minical

= 2.2.15 =
* FIXED: deprecated: Non-static method should be called statically. Plugin sollte jetzt auch mit PHP 8.x laufen.

= 2.2.10 =
* FIXED: cha wurde ausgeblendet, wenn gleichzeitig auswahl=eb gesetzt war.

= 2.2.8 =
* FIXED: Neuer Link im Stream der Evangelischen Termine wird vom Plugin mit der Option nocss wieder eliminiert.

= 2.2.7 =
* FIXED: deprecated function create_function erstetzt.

= 2.2.6 =

* Added shortcode et_panels - Zu Panels siehe https://evangelische-termine.de/Admin/ausgabe#panels
* FIXED: IPv6-Auflösung

= 2.2.5 =

* Rename class Autoloader in AutoloaderET - Damit kommt es nicht mehr zu Konflikten mit anderen Plugins

= 2.2.3 =

* Icons für die Barrierefreiheit in der Detailansicht werden jetzt über SSL geladen, wenn verfügbar

= 2.2 =

* Es ist nun in Bayern möglich, den Parameter auswahl=eb zu verwenden, mit dem Erwachsenenbildungsveranstaltungen abgefragt werden können. 

= 2.0 =

* Code an vielen Stellen neu geschrieben und optimiert
* JavaScripts der Evangelischen Termine werden nicht mehr entfernt
* Ab dieser Version gibt es kein Sessionhandling mehr
* FIXED: Google Maps wird nun über https abgerufen.
* FIXED: Bilder werden von den Evangelischen Terminen geladen

= 1.9 =

* NEW: Volltextsuche durch den Parameter 'q' ist möglich.

= 1.8 =

* Host des Kalenderbetreibers wurde auf der Optionsseite hinzugefügt. Das Plugin ist nun leicht auf jede Landeskirche anpassbar.
* FIXED: Fehler bei der Speicherung der Daten aus den Selectboxen auf der Optionsseite
* NEW: Link auf die Einstellungen auf der Seite Plugins hinzugefügt

= 1.7 =

* Problem mit nocss gelöst.

= 1.6 =

* CHANGED: __construct() in der Widget-Class

= 1.5 =

* FIXED: JavaScripts der Daten, die von den Evangelischen Terminen geliefert werden teilweise entfernt

= 1.2 =

* NEW: Dokumentation

= 1.1 =

* FIXED: Sessionhandling wurde angepasst. Werte werden jetzt direkt an den Pager übergeben (Ersetzung `__HOST__`)

== Upgrade Notice ==

= 3.3 =
* FIXED: Darstellungsproblem im Modul et_panels

= 3.2 =
* FIXED: jquery wird lokal geladen und nicht von einem CDN abgerufen

= 3.1 =
* FIXED: et_veranstalter - Suchbegriff wurde nicht mehr übertragen

= 3.0 =
* Curl ist nicht mehr erforderlich, stattdessen werden die Evangelischen Termine mithilfe der http-Api von Wordpress abgefragt.
* FIXED: Sessionhandling im Shortcode et_veranstalter

= 2.3.1 =
* ADDED: Feld für weitere Parameter im Widget ergänzt

= 2.3 =
* ADDED: Shortcode et_minical

= 2.2.15 =
* FIXED: deprecated: Non-static method should be called statically. Plugin sollte jetzt auch mit PHP 8.x laufen.

= 2.2.8 =
* FIXED: Neuer Link im Stream der Evangelischen Termine wird vom Plugin mit der Option nocss wieder eliminiert.

= 2.2.7 =

* FIXED: deprecated function create_function erstetzt.

= 2.2.6 =

* FIXED: IPv6-Auflösung

= 2.2.3 =

* Icons für die Barrierefreiheit in der Detailansicht werden jetzt über SSL geladen, wenn verfügbar

= 2.2 =

Parameter auswahl=eb ist in Bayern nun möglich (Abfrage der Eingabemaske Erwachsenenbildung oder des Kanals Erwachsenenbildung)

= 2.0 =

Code an vielen Stellen neu geschrieben und optimiert

= 1.9 =

* NEW: Volltextsuche durch den Parameter 'q' ist möglich.

= 1.8 =

Host des Kalenderbetreibes wurde auf der Optionsseite hinzugefügt. Das Plugin ist nun leicht auf jede Landeskirche anpassbar.
FIXED: Fehler bei der Speicherung der Daten aus den Selectboxen auf der Optionsseite
NEW: Link auf die Einstellungen auf der Seite Plugins hinzugefügt

= 1.7 =

Link-Tag für nocss wird entfernt.

= 1.5 =

Bestimmte JavaScripts der Evangelischen Termine haben in manchen Themes zu Problemen geführt. Die störenden JavaScripts werden jetzt entfernt.

= 1.2 =

Die Dokumentation wurde in das Plugin aufgenommen.

= 1.1 =

Das Sessionhandling wurde angepasst. Die Werte werden jetzt direkt im Link im Pager angegeben.