Table of Contents
Geburtstagsliste
Beschreibung
Dieses Plugin erzeugt für einen bestimmten Zeitraum eine Geburtstags- und Jubiläumsliste der Mitglieder.
Downloads
geburtstagsliste_3.4.0.zip - (Admidio 4.3)
Ältere Versionen:
geburtstagsliste_3.3.0.zip - (Admidio 4.2)
geburtstagsliste_3.1.0.zip - (Admidio 4.0)
geburtstagsliste_2.3.3.zip - (Admidio 3.3)
geburtstagsliste_2.2.2.zip - (Admidio 3.2)
geburtstagsliste_2.1.1.zip - (Admidio 3.1)
geburtstagsliste_2.0.2.zip - (Admidio 3.0)
geburtstagsliste_1.3.5.zip - (Admidio 2.4)
Informationen
Betreut von: rmb
Plugin-Version: 3.4.0
Notwendige Admidio-Version: 4.3
Unterstützte Datenbanken: MySQL
Unterstützte Sprachen: Deutsch (du), Deutsch (Sie), Englisch, Französisch
Lizenz: GPL 2
Sourcecode: GitHub
Screenshots
Installation
- Im Ordner adm_plugins einen neuen Ordner mit dem Namen geburtstagsliste erstellen
- Danach alle Dateien (und Ordner) des Ordners geburtstagsliste aus der entpackten Zip-Datei in diesen Ordner kopieren.
- Anschließend über das Admidio-Modul Menü einen Menüeintrag für Geburtstagsliste mit folgender URL erzeugen: /adm_plugins/geburtstagsliste/geburtstagsliste.php (Beim Erstellen dieses Menüeintrages wird dringend empfohlen, im Feld „Sichtbar für“ eine Rolle anzugeben).
Update
- Zuerst alle Dateien im Pluginverzeichnis von Geburtstagsliste löschen.
- Danach alle Dateien (und Ordner) des Ordners geburtstagsliste aus der entpackten Zip-Datei in das Pluginverzeichnis kopieren.
Änderungshistorie
3.4.0 (14.01.2024)
3.3.0 (18.01.2023)
- Wichtiger Hinweis: Mit diesem Update wurde das Hauptscript „geburtstagsliste.php“ umbenannt in „birthday_list.php“. Der Menüeintrag in Admidio muss entsprechend angepasst werden.
3.2.0 (05.01.2022)
3.1.0 (12.12.2020)
3.0.0 (28.10.2020)
- kompatibel nur mit Admidio 4 Beta 1
2.3.3 (10.05.2020)
2.3.2 (11.10.2018)
2.3.1 (23.04.2018)
2.3.0 (16.04.2018)
- Kompatibilität mit Admidio 3.3
2.2.2 (04.12.2017)
2.2.1 (05.05.2017)
2.2.0 (19.12.2016)
- Kompatibilität mit Admidio 3.2
2.1.1 (08.06.2016)
2.1.0 (15.02.2016)
- Kompatibilität mit Admidio 3.1
- Link zur Dokumentation geändert
2.0.2 (09.12.2015)
- Jahresversatz integriert (Wunsch von red)
- Fehler in der Datumsberechnung behoben (Kalenderjahr in Verbindung mit negativen Vorschautagen)
2.0.1 (02.11.2015)
- Fehler (verursacht durch die Methode addHeadline) behoben
2.0.0 (26.05.2015)
- Anpassung an Admidio 3.0
- Deinstallationsroutine erstellt
- Verfahren zum Einbinden des Plugins (include) geändert
- Berechnungsalgorithmus umgestellt (dadurch unbegrenzte Vorschau von Tagen möglich)
- Menübezeichnungen angepasst (gleichlautend mit anderen Plugins)
- Nur Intern: Verwaltung der Konfigurationsdaten geändert
1.3.5 (05.11.2014)
- Für den Export sind diverse Parameter jetzt im Setup einstellbar
- Bei Namensgleichheit von Profilfeldern wird die Kategorie in Klammern angehängt
- Die Option Kalenderjahr kann für jede Konfiguration separat eingestellt werden
1.3.4 (15.05.2014)
- Fehler …indefined index:…beim ersten Aufruf des Plugins behoben
- Default-Einstellungen um zusätzliche Einträge ergänzt
- Aufruf des Plugins über die Klasse Menu realisiert (Systemanforderung jetzt Admidio Version 2.4.4 oder höher)
- Anpassung von Menübezeichnungen
- E-Mail-Texte für jede Konfiguration (Fokus) separat definierbar
1.3.3 (09.01.2014)
- Fehler …indefined index:…language.php line 272… behoben
- Vorschautage kleiner 10 benötigen keine führende Null mehr
- negative Werte für die Vorschau möglich
1.3.2 (21.11.2013)
- Kompatibilität zu PHP 5.4
1.3.1 (12.11.2013)
- Default-Einstellung für Fokus
- Diverse Überprüfungen eingearbeitet
- Anzeigemodus überarbeitet
- E-Mail-Modul eingearbeitet
- Die Konfigurationen können auf bestimmte Rollen und/oder Kategorien einschränkt werden
1.3.0 (01.04.2013)
- Anpassung an Admidio 2.4
- Konfigurationsdaten werden nicht mehr in einer config.ini gespeichert, sondern in der Admidio Datenbank abgelegt
- Das Menü Einstellungen kann separat über Berechtigungen angezeigt werden
- Aufgrund eines Wunsches im Forum kann der Beginn der Anzeige auf den 1. Januar gesetzt werden (Kalenderjahr)
- E-Mail-Adressen werden mit einem Link versehen (DieterB)
- Englische Sprachdatei erstellt
- Die Default-Einstellung der Pluginfreigabe wurde erweitert um die Rolle Mitglied
1.2.3 (26.12.2012)
- Alle Einstellungen sind menuegesteuert veraenderbar
- Eine deutsche Sprachdatei wurde erstellt
- Das Plugin ist für mehrere Organisationen geeeignet
- Ein Fehler in der Berechnung des Zeitraumes wurde behoben (Für den Zeitraum…)
1.2.2 (01.03.2012)
- Jubiläen können angezeigt werden
- Die Jahre für die Jubliläen und runden Geburtstage können in der config.php definiert werden
- Die Spaltenüberschriften für Jubiläen und runde Geburtstage sind frei definierbar
- Das Suffix in der Anzeige von Jubiläen und runden Geburtstagen ist frei definierbar
1.2.1 (23.02.2012)
- Über ein Pulldownmenü kann direkt ein bestimmter Monat gewählt werden
- Das Jahr des Geburtsdatums kann angezeigt werden
- Runde Geburtstage können angezeigt werden
1.2.0 (21.02.2012)
- Das Plugin ist jetzt Admidio 2.3 kompatibel
1.1.2 (08.12.2011)
- Das Standard-Datenbankpräfix (adm_) ist nicht mehr fest kodiert
1.1.1 (21.11.2011)
- Bei Mitgliedern ohne Geburtsdatum wurde der 01.01. eingetragen, dies wurde korrigiert. Mitglieder ohne Geburtsdatum werden nicht mehr in der Liste aufgeführt.
- Die Einschränkung in einer Abfrage in geburtstagsliste_show.php, auf nur Mitglieder der Rolle “Mitglied” wurde aufgehoben.
- Die Default-Einstellung für die Vorschautage kann jetzt in der config.php definiert werden.
- Beim Export wurden die Vorschautage nicht aktualisiert.
- Die Einträge im Pulldownmenü “Anzahl der Vorschautage…” können jetzt in der config.php definiert werden
- Die Berechtigung das Plugin aufzurufen, wurde um Rollenmitgliedschaften erweitert.
1.1.0 (26.10.2011)
- Für das Plugin wurde eine Weboberfläche erstellt.
- Die erzeugte CSV-Datei wird nicht mehr auf dem Server zwischengespeichert, sie wird in der Listenansicht zum Download angeboten. Das zusätzliche Plugin downloadfile.php wird nicht mehr benötigt.
1.0.0 (11.07.2011)
Funktionsweise
Dieses Plugin erzeugt Geburtstags- und Jubiläumslisten von Mitgliedern. Über den Menüpunkt Einstellungen-Konfigurationen können beliebig viele, unterschiedliche Konfigurationen angelegt werden.
In einer Konfiguration werden
- die anzuzeigenden Spalten (=Profilfelder),
- zu welchem Bezugstag diese Konfiguration angezeigt wird (der aktuelle Tag oder der 01.01.),
- Filterungen zum Datum (runde Geburtstage oder Jubiläen)
- oder auch Filterungen aufgrund von Rollenzugehörigkeiten
festgelegt.
Muster einer Geburtstagsliste:
Mit “Konfiguration wählen…” wird eine vorher definierte Konfiguration als Basis der Anzeige bestimmt.
Nach der Wahl der Konfiguration wird ausgewählt, wieviele Tage (Vorschautage) angezeigt werden sollen.
Hinweis: Vorschautage werden immer in Relation zu einem Bezugstag gesehen. Als Bezugstag kann entweder das aktuelle Datum oder der 1. Januar eines Jahres gewählt werden.
Damit zukünftige und auch vergangene Geburtstage und Jubiläen angezeigt werden können, wurde folgende Festlegung getroffen:
- Sollen Geburtstage und Jubiläen nur am Bezugstag (aktueller Tag oder der 01.01.) angezeigt werden, so ist als Vorschautage “0” zu wählen.
- Sollen zukünftige Geburtstage und Jubiläen angezeigt werden, so ist als Vorschautage die Anzahl der zusätzlichen Tage zu wählen (z.B. “1” für den aktuellen Tag plus einen Tag zusätzlich, ⇒ heute und morgen).
- Sollen vergangene Geburtstage und Jubiläen angezeigt werden, so ist als Vorschautage eine negative Anzahl von Tagen zu wählen (z.B. “-1” für den aktuellen Tag minus einen Tag in die Vergangenheit, ⇒ gestern und heute).
Zusätzlich zu Vorschautagen kann ein bestimmter Monat gewählt werden.
Dies ist eine nochmalige Filterung der bereits bestehenden Liste.
Menü Einstellungen
Das Menü Einstellungen ist über den, nur für Administratoren sichtbaren Link “Einstellungen”, rechts oben im Hauptmenü anwählbar. Es ist in drei Menüpunkte unterteilt.
- Konfigurationen
- Optionen
- Plugininformationen
Menüpunkt Konfigurationen
Hier können beliebig viele Konfigurationen für die Geburtstagsliste erstellt werden. In der Listenansicht wird jeweils eine dieser Konfigurationen über “Konfiguration wählen…” als Grundlage der Anzeige verwendet.
Nach einer Neuinstallation ist eine Beispielkonfigurationen voreingestellt und mit Standardwerten befüllt.
  |  |
| Konfiguration | Anzeige |
Bezeichnung
Die hier eingetragende Bezeichnung erscheint in der Bildschirmanzeige im Auswahlmenü “Konfiguration wählen…”. Gelöscht werden kann eine Konfiguration, indem man den Inhalt des Feldes Bezeichnung löscht und anschließend den Speichern-Button betätigt.
Spaltenauswahl
Hier werden die Profilfelder ausgewählt, die in dieser Konfiguration als Spalten in der Listenansicht angezeigt werden sollen.
Prüfdatum
Prüfdatum ist das für die Berechnungen verwendete Datumsfeld (Entweder ein Profilfeld vom Typ “Datum” oder bei Wahl einer Rolle, der Beginn der Rollenmitgliedschaft)
Werte
Über Werte kann die Anzeige auf bestimmte Werte gefiltert werden. 30,40,50 bedeutet z.B., dass nur 30., 40. oder 50. Geburtstage oder Jubiläen angezeigt werden. Soll nicht gefiltert werden, so ist das Feld leer zu lassen.
Ergänzungstext
Der angegebene Text wird an das Lebensjahr oder Jubiläum angehängt.
Der Ergänzungstext “ster Geburtstag am #Day#.#Month#” könnte z.B. angezeigt werden als “30ster Geburtstag am 10.02.”.
Platzhalter:
- #Day# = Tag
- #Month# = Monat
- #Year# = Jahr
Hinweis:
- Um den Ergänzungstext mit einem Leerzeichen beginnen zu lassen muss dieses als geschütztes Leerzeichen mit dem Code (z.B. ster Geburtstag am #Day#.#Month#) angegeben werden.
Rollenwahl/Kategoriewahl
Über Rollen- und Kategoriewahl kann eine Konfiguration auf die Angehörigen der gewählten Rollen bzw. auf die Angehörigen von Rollen der gewählten Kategorien eingeschränkt werden.
Soll keine Einschränkung erfolgen, so sind beide Felder (Rollenwahl und Kategoriewahl) leer zu lassen.
E-Mail-Vorlage
Hier kann der Text für eine E-Mail angepasst und ergänzt werden. Der Text ist in zwei Bereiche (Betreff & Inhalt) unterteilt und wird durch die Zeichenfolge #subject# und #content# identifiziert. Danach folgt dann der Inhalt für den Bereich. In jeder Mail können Platzhalter benutzt werden, welche dann zur Laufzeit durch die entsprechenden Inhalte ersetzt werden.
WICHTIG: Zum Versenden von Mails muss das Profilfeld E-Mail in einer Spalte angezeigt werden.
Platzhalter:
- #user_first_name# = Vorname des Mitglieds
- #user_last_name# = Nachname des Mitglieds
- #organization_long_name# = Name der Organisation
- #config# = Text der letzten Spalte (Konfigurationsspalte)
Kalenderjahr
Diese Einstellung bestimmt den Bezugstag der Anzeige. Standardmäßig wird ab dem aktuellen Datum angezeigt. Soll die Anzeige ab dem 1. Januar des aktuellen Jahres beginnen, so ist der Haken zu setzen.
Jahresversatz
Hiermit kann die Anzeige um x Jahre vor- oder zurückversetzt werden (0 entspricht keinem Versatz).
Menüpunkt Optionen
Über Optionen können allgemeingültige Einstellungen für das Plugin definiert werden.
Vorschautage
Hier wird die Standardeinstellung der Vorschautage festgelegt.
Vorschauliste
Hier werden die Tage eingetragen, die später in der Geburtstagsliste zur Auswahl angeboten werden. Mehrere Einträge sind durch Kommata zu trennen (Bsp: -14,2,5,10,20,30,60,365,1000).
Konfiguration
Hier wird festgelegt, welche Konfiguration beim Start des Plugins angezeigt wird.
Deinstallation
Über die Deinstallation können alle vom Plugin erstellten Konfigurationsdaten wieder gelöscht werden.
Menüpunkt Plugininformationen
Hier werden Informationen zur Version und zum Stand des Plugins angezeigt.
Die Speicherung der Konfiguration
Alle Konfigurationsdaten werden in einer Tabelle mit dem Namen adm_plugin_preferences in der Admidio-Datenbank gespeichert. Sollte diese Tabelle nicht existieren, wird sie angelegt.
Derzeit werden in dieser Tabelle die Konfigurationen folgender Plugins abgelegt:
- Mitgliedsbeitrag
- Geburtstagsliste
- FormFiller
Die Tabelleneinträge des Plugins Geburtstagsliste beginnen hierbei alle mit den Buchstaben “PGL”.