Mitgliedsbeitrag 4.0.0

Dieses Plugin berechnet Mitgliedsbeitrge anhand von Rollenzugehrigkeiten.

1. Installation
2. Update
3. Versionshistorie
4. Systemanforderungen

******************************************************************************

1.1 Im Ordner adm_plugins einen neuen Ordner mit dem Namen mitgliedsbeitrag erstellen

1.2 Alle Dateien (und Ordner) des Ordners mitgliedsbeitrag aus der entpackten Datei mitgliedsbeitrag....zip in diesen Ordner kopieren.

1.3 In der Datei my_body_bottom.php (Ordner adm_themes/modern) folgende Zeilen einfgen:

  1.3.1  Erste Mglichkeit
      Darstellung des Links zum Plugin im vorhandenen Module-Men

      - dazu VOR der vorhandenen Anweisung "$moduleMenu->show();" diese Zeile einfgen:
         include(SERVER_PATH.'/adm_plugins/mitgliedsbeitrag/mitgliedsbeitrag.php');

   1.3.2  Zweite Mglichkeit
      Darstellung des Links zum Plugin in einem eigenen Plugin-Men

       - dazu diese Zeilen einfgen (falls noch nicht vorhanden):
         $pluginMenu = new Menu('plugins', 'Plugins');
         $pluginMenu->show(); 

      - und innerhalb dieser Anweisungen den bereits bekannten include-Befehl einfgen
         $pluginMenu = new Menu('plugins', 'Plugins');
         include(SERVER_PATH. '/adm_plugins/mitgliedsbeitrag/mitgliedsbeitrag.php');
         $pluginMenu->show(); 
            
   Hinweis: Die include-Anweisung sollte nicht innerhalb einer if-Abfrage stehen. 
            Die Berechtigung, wer das Plugin aufrufen darf, wird ber das Einstellungen-Modul festgelegt.
            Standardeinstellung ist: Rolle Webmaster und Rolle Mitglied

1.4 Admidio starten und das Plugin Mitgliedsbeitrag ausfhren


******************************************************************************

2. Update
=========

2.1 Alle Dateien im Pluginverzeichnis von Mitgliedsbeitrag lschen.

2.2 wie unter Punkt 1.2 beschrieben

2.3 wie unter Punkt 1.3 beschrieben

2.4 Admidio starten und das Plugin Mitgliedsbeitrag ausfhren


******************************************************************************

3. Versionshistorie

 * Version	: 4.0.0
 * Datum	: 09.11.2015
 * nderung     : - Anpassung an Admidio 3.0
 *                - Deinstallationsroutine erstellt
 *                - Modul copy erstellt
 *                - Verfahren zum Einbinden des Plugins (include) gendert 
 *                - Menbezeichnungen angepasst (gleichlautend mit anderen Plugins)
 *                - Erweiterte berprfung auf unzulssige Zeichen in den SEPA-XML-Dateien   
 *                - Nur Intern: Verwaltung der Konfigurationsdaten gendert 
 * 
 * Version	: 3.3.7
 * Datum        : 08.09.2014
 * nderung     : - wenn ein KtoInh angegeben war und bei diesem die E-Mail-Adresse leer war,
 * 		    wurde eine E-Mail an den vorherigen User gesendet --> Fehler behoben
 * 		  - %creditor_id% wurde beim E-Mail-Versand nicht immer aufgelst 
 * 		  - die Einschrnkung auf die Rolle Mitglied beim Erzeugen von Mitgliedsnummern wurde entfernt
 *
 * Version	: 3.3.6
 * Datum        : 25.07.2014
 * nderung     : - IBAN only 
 * 		  - beim Setzen eines Bezahlt-Datums wird der Sequenztyp nach RCUR nur beim Vorliegen eines Flligkeitsdatums gendert
 * 		  - im Modul "Flligkeitsdatum bearbeiten" werden Mitglieder 
 * 		     1. nur noch bei vorhandenem Beitrag angezeigt,
 * 		     2. bei fehlender IBAN nicht mehr angezeigt,
 * 		     3. bei vorhandenem Bezahlt-Datum nicht mehr angezeigt
 * 		  - im Modul "SEPA Export" werden bei den Auswahlmglichkeiten der Kombination Flligkeitsdatum/Sequenztyp
 * 		     Mitglieder ohne vorhandenem Beitrag nicht mehr angezeigt
 * 		  - Eil-Lastschrift (COR1)
 * 		  - Menpunkt DTA-Export gestrichen
 * 		  - Beitragszahlungen kann auf einzelne Beitragsrollen eingeschrnkt werden
 *		  - IBAN-Prfung
 *		  - E-Mail-Versand im Modul Vorabinformation an mehrere Mitglieder gleichzeitig mglich
 *		  - Prfbedingung zum bersetzen von Rollen und Kategorien durch Sprachdatei gendert
 *		  - Anzeigeposition des Kalenders in Einstellungen-Altersgestaffelte Rollen angepasst
 *		  - anteilige Beitragsberechnung bis zum Ende einer Rollenmitgliedschaft
 * 		  - unter dem Menpunkt "Einstellungen-Reset" wurden diverse Lschmglichkeiten entfernt,
 * 		     da diese seit der Version 3.3.5 unter "Allgemein-Beitragsberechnung" zu finden sind
 * 		  - interne nderungen (ohne Funktionsnderungen):
 * 		     1. Module zahlungen_change und zahlungen_save zusammengefasst zu zahlungen_save
 * 		     2. Module faelligkeitsdatum_change und faelligkeitsdatum_save zusammengefasst zu faelligkeitsdatum_save
 * 		     3. Module mandatsdatum_change und mandatsdatum_save zusammengefasst zu mandatsdatum_save
 * 		     4. Menpunkt "Rollenprfungen" wurde aufgrund erweiterter Funktionalitt umbenannt in "Prfungen"
 * 		     5. Menpunkt "Einstellungen-Reset" wurde umbenannt in "Einstellungen-Lschen"
 * 				    
 * Version 	: 3.3.5 
 * Datum        : 12.02.2014
 *                (Dank an fiwad fr die Untersttzung beim Testen dieser Version)
 * nderung     : - Fehler ...indefined index:...language.php line 272... behoben
 *                - Fehler im Modul Beitragsanalyse behoben (fehlende IBAN-Verknpfung)
 *                - Fehler im Modul Neuzuordnung behoben
 *                - Diakritische Zeichen werden in der SEPA-XML-Datei ersetzt
 *                - Errechnete Beitrge knnen aufsummiert werden
 *                - Beitragsneuberechnung kann auf einzelne Beitragsrollen eingeschrnkt werden
 *                - Initialisierungsroutine berarbeitet
 *                - SOLL/IST-Anzeige der Setuproutine berarbeitet
 *                - Link auf Familien im Modul Rollenprfung gendert
 *                - Beitragstext gestrafft (Leerzeichen und + entfernt)
 *                - Flligkeitsdatum bearbeiten kann auf einzelne Beitragsrollen eingeschrnkt werden
 *                - Rollenprfung fr Familienrollen umfassend neu gestaltet 
 *                - Men Beitragsberechnung neu gestaltet
 *
 * Version	: 3.3.4
 * Datum        : 30.10.2013
 * nderung     : - Fehler (()) behoben
 *                - Erweiterung fr "mehrere Familienrollen"
 *                - Erweiterung fr "mehrere altersgestaffelte Rollen"
 *                - E-Mail-Versand in Modul Beitragszahlungen eingearbeitet
 *                - Ergebnismeldung in Modul Neuzuordnung eingearbeitet 
 *
 * Version 	: 3.3.3 
 * Datum        : 13.09.2013
 * nderung     : - E-Mail-Versand in Modul Vorabinformation eingearbeitet
 * 	          - Die Prfung der Rollenmitgliedschaften kann auf Mitglieder
 * 		    bestimmter Kategorien eingegrenzt werden (Wunsch von joesch)
 *
 * Version	: 3.3.2 
 * Datum        : 01.08.2013
 * nderung     : - error_reporting berarbeitet
 *
 * Version 	: 3.3.1 
 * Datum        : 11.07.2013
 * nderung     : - Fehler beim Anlegen der Kategorie Kontodaten behoben
 *                
 * Version	: 3.3.0
 * Datum        : 02.07.2013
 * nderung     : - Plugin um SEPA erweitert
 *                - Einfache Mitgliedsnummern knnen erzeugt werden 
 *                - Fehler bei der Anzeige des Beitrag-Suffix bei anteiligen Beitrgen behoben
 *
 * Version 	: 3.2.0
 * Datum        : 26.03.2013
 * nderung     : - Anpassung an Admidio 2.4
 * 		  - Konfigurationsdaten werden nicht mehr in einer config.ini gespeichert,
 * 		    sondern in der Admidio Datenbank abgelegt
 * 		  - Rechnungs-Export von guenter47 eingearbeitet
 * 		  - Menuestruktur berarbeitet
 * 		  - Fehler in der Rollenprfung "Rollenmitgliedschaft (Ausschluss)" behoben 
 *
 * Version	: 3.1.1 
 * Datum        : 18.01.2013
 * nderung     : - Im Modul Beitragszahlungen wird jetzt auch der Beitrag angezeigt
 * 		  - Ein Fehler beim Speichern des Bezahlt-Datums wurde behoben (function date_format2mysql von eiseli) 
 *		  - Anfhrungszeichen fehlten in mitgliedsbeitrag_show Zeile 986 (eiseli)
 *			alt: (array(cat => $row['cat_name'],rol => $row['rol_name'])
 *			neu: (array('cat' => $row['cat_name'],'rol' => $row['rol_name']) 
 *		  - Undefinierte Variablen sind jetzt definiert
 *		  - Eine Sprachdatei deutsch (Sie) wurde erstellt
 *		  - Im Modul Beitragszahlungen wird die Option "Alle ndern" inaktiv gesetzt, 
 *		    wenn im Suchfeld eine Eingabe erfolgt 
 *
 * Version	: 3.1.0 
 * Datum        : 06.12.2012
 * nderung     : - Ein Fehler beim Speichern der config.ini wurde behoben
 *                - Das Plugin wurde fr "mehrere Organisationen" erweitert
 *                - Eine upgrade.php wurde erstellt (3.0.0 --> 3.1.x)                  
 *                - Die Anzeige der Mitgliedsnamen im Beitragstext ist jetzt mglich (Anregung durch hausi)
 *                  (eine Anzeige erfolgt jedoch nur, wenn: Kontoinhaber und Mitgliedsname unterschiedlich sind
 *                  oder Kontoinhaber leer ist)
 *                - In der Rollenprfung werden die angezeigten Benutzernamen und Rollen 
 *                  jetzt mit einem Link hinterlegt (Anregung durch joesch)
 *                - Das Modul Zahlungen (jetzt Beitragszahlungen) wurde komplett berarbeitet (Anregung durch hausi und walegger)
 *                - Eine deutsche Sprachdatei wurde erstellt
 *
 * Version 	: 3.0.0 
 * Datum        : 25.06.2012
 * nderung     :  Beitrge aus dem Forum eingearbeitet
 *                - Rundung der berechneten Mitgliedsbeitrge auf zwei Nachkommastellen
 *                - Profilfeld Beitritt ist kein Pflichtfeld mehr
 *                - zustzlicher Schalter fr die anteilige Beitragsberechnung  
 *                  (Berechnung anhand des Beitrittsdatums oder des Beginns einer Rollenzugehrigkeit) 
 *                - das Prfix fr Familienrollen ist beim ersten Aufruf vordefiniert ('Familie')
 *                - bei Familienrollen kann ein Leiter definiert werden; dieser wird fr die 
 *                  Beitragsberechnung herangezogen 
 *                - ein Fehler in der Beitragsberechnung wurde behoben (bestehende Alt-Beitrge
 *                  wurden nicht gelscht )
 *                - ein Fehler bei der Berechnung des Alters eines Mitglieds,
 *                  bezogen auf den Stichtag, wurde behoben  
 *
 * Version	: 3.0.0 beta 1
 * Datum        : 30.05.2012
 * nderung     : Das Plugin wurde komplett berarbeitet. Es ist jetzt als
 *                Accordion-Men (hnl. Administration-Organisationseinstellungen) in admidio
 *                integriert. Alle Einstellungen des Plugins sind ber das Men anwhlbar. 
 *
 * Version	: 2.3.1
 * Datum        : 03.03.2012
 * nderung     : - Ein Fehler bei der Berechnung von Cent-Betrgen wurde behoben  
 * 
 * Version	: 2.3.0: (mit Ergnzungen von hausi)
 * Datum        : 21.02.2012
 * nderung     : - das Plugin ist jetzt Admidio 2.3 kompatibel
 *                - ber Rollenzugehrigkeiten knnen fixe Jahresbeitrge berechnet werden.
 *                  (Alle Mitglieder einer Kategorie zahlen einen festen Jahresbeitrag.
 *                  Die effektiven Beitrge werden von den jeweiligen Rollen der Kategorie
 *                  aus der DB ermittelt.) (hausi)
 *                - der Fehler bei einem Mitgliedsbeitrag von 0 wurde behoben 
 * 
 * Version	: 2.2.1
 * Datum        : 08.12.2011
 * nderung     : - das Standard-Datenbankprfix (adm_) ist nicht mehr fest kodiert
 * 
 * Version	: 2.2.0
 * Datum        : 21.11.2011
 * nderung     : - Das externe Programm dtaus wird nicht mehr bentigt. Durch die
 *                  Integration der Klasse DTA ist es jetzt mglich, direkt die
 *                  dtaus-Datei und den dazugehrigen Begleitzettel zu erstellen. 
 *                - Die Exportdateien und die Bildschirmanzeige wurden 
 *                  in ihrer Struktur vereinheitlicht. Sie weisen jetzt alle
 *                  dieselben Spalten an derselben Position auf.  
 *                - bisher wurden bei einer Familie die Kontodaten eines zufllig
 *                  ausgewhlten Mitglieds verwendet. Falls genau bei diesem Mitglied 
 *                  keine Kontodaten hinterlegt waren, wurde auf Rechnung umgestellt.
 *                  Dies wurde gendert. Es werden alle Mitglieder einer Familie
 *                  abgefragt. Nur wenn bei keinem Mitglied Kontodaten hinterlegt sind,
 *                  wird auf Rechnung umgestellt. 
 *                - Die Berechtigung das Plugin aufzurufen, wurde um 
 *                  Rollenmitgliedschaften erweitert.
 * 
 * Version	: 2.1.0
 * Datum        : 26.10.2011
 * nderung     : - Dem Plugin wurde eine Weboberflche verpasst.
 *                - Die erzeugte CSV-Datei wird nicht mehr auf dem Server 
 *                  zwischengespeichert, sie wird in der Listenansicht zum
 *                  Download angeboten. 
 *                - Das zustzliche Plugin downloadfile.php wird nicht mehr bentigt.       
 * 
 * Version	: 2.0.0
 * Datum        : 12.07.2011    
 * nderung     : - Neues Feld "Beitritt" fr ein Mitglied
 *                - Berechnung eines Spartenbeitrages
 *                - Berechnung eines Schler- und Studentenbeitrages
 *                - Beitrge knnen abgerundet werden
 *                - der Kategoriename fr Familien ist frei whlbar    
 *  
 * Version	: 1.0.1 Gerald Lutter
 * Datum        : 10.01.2011
    

******************************************************************************

4. Systemanforderungen

Das Plugin Mitgliedsbeitrag in der Version 4.0 erfordert Admidio 3

Es erstellt XML-Dateien gem dem DF-Abkommen Version 2.7 (IBAN only und COR1 Untersttzung).
Stellen Sie sicher, dass Ihre Bank diese XML-Dateien verarbeiten kann.

