Mitgliedsbeitrag [Admidio-Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Mitgliedsbeitrag ======

==== Beschreibung ====
Das Plugin Mitgliedsbeitrag dient dazu, Mitgliedsbeiträge zu berechnen und diese entweder als SEPA-XML-Datei oder in Form einer Liste (XLSX, CSV) zu exportieren. Mitgliedsbeitrag bietet keine Möglichkeit, eine SEPA-XML-Datei direkt an eine Bank zu senden. Dazu muss eine externe Homebanking-Anwendung verwendet werden. 

Die Beiträge werden anhand von Rollenmitgliedschaften ermittelt. Zu diesem Zweck wurden folgende Rollentypen festgelegt:

  * **Altersgestaffelte Rollen** (Beitragsberechnung abhängig vom Alter eines Mitglieds)

  * **Familienrollen** (Beitragsberechnung für Familien oder Gruppen, wobei ein Mitglied der Beitragszahler ist. Als Sonderform von Familienrollen gibt es Multiplikatorrollen, bei denen der Beitragswert der Rolle nicht addiert wird, sondern als Multiplikator dient)

  * **Festbeitragsrollen** (Beitragsberechnung für Sparten, Ehrenmitglieder, Jugendliche etc.)

==== Downloads ====
<WRAP download 60%>
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=af5177e7-5d23-4e8a-9cd5-01546cff3cf0|mitgliedsbeitrag_6.0.1.zip]] - **(Admidio 5.0)**
</WRAP>

Ältere Versionen:\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=f1a4211b-b307-46cc-9c26-6a675a7869fc|mitgliedsbeitrag_5.3.1.zip]] - (Admidio 4.3)\\ 
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=f24c3954-7983-441f-b50a-cccd542f05d1|mitgliedsbeitrag_5.2.1.zip]] - (Admidio 4.2)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=3b84cd3a-8a8e-44e9-8a9e-a6f6ea45509a|mitgliedsbeitrag_5.1.6.zip]] - (Admidio 4.1.1)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=289c6cb7-a41f-43d5-8398-2a73800bf825|mitgliedsbeitrag_5.0.2.zip]] - (Admidio 4)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=df95d309-975f-4ef4-a0ce-40f4e95e746d|mitgliedsbeitrag_4.3.4.zip]] - (Admidio 3.3)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=0ae29e54-e310-4347-88af-ce4a1356654b|mitgliedsbeitrag_4.2.4.zip]] - (Admidio 3.2)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=9bcc51a7-f998-4fc9-a896-b28e87ff8283|mitgliedsbeitrag_4.1.2.zip]] - (Admidio 3.1)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=3de7082a-a1c3-4dac-b8ea-f40989fe5fc1|mitgliedsbeitrag_4.0.0.zip]] - (Admidio 3.0)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=aa292dac-9f44-4473-81df-ed413493e701|mitgliedsbeitrag_3.3.7.zip]] - (Admidio 2.4)

==== Informationen ====
Betreut von: **[[https://www.admidio.org/forum/memberlist.php?mode=viewprofile&u=1506|rmb]] **\\ 

Plugin-Version:     **6.0.1**\\ 

Notwendige Admidio-Version:  **5.0**\\ 

Unterstützte Datenbanken:  **MySQL, PostgreSQL**\\ 

Unterstützte Sprachen: **Deutsch (du), Deutsch (Sie), Englisch, Französisch, Niederländisch, Norwegisch**

Lizenz: **GPL 2**

Sourcecode: [[https://github.com/rmbinder/Mitgliedsbeitrag.git|GitHub]]

==== Screenshots ====
{{:de:plugins:mitgliedsbeitrag:screenshot_01.png?300|}}  

==== Installation ====
   *Entpacken der Datei mitgliedsbeitrag_x.x.x in den Ordner //adm_plugins//
   *Einloggen in Admidio
   *Installation einer Pluginversion < 5.3.1
     *Über das Admidio-Modul Menü einen Menüpunkt für Mitgliedsbeitrag mit folgender URL erzeugen: /adm_plugins/membership_fee/membership_fee.php (Hinweis: Die Installationsroutine wird beim ersten Start des Plugins ausgeführt)
   *Installation von Pluginversion 5.3.1
     *Zur Installation folgende PHP-Datei ausführen:\\ <deine-admidio-seite>/adm_plugins/membership_fee/installation.php
     *Über das  Admidio-Modul Menü den neu hinzugefügten Menüpunkt **Mitgliedsbeitrag** mit entsprechenden Zugriffsrechten versehen (siehe Dokumentation **Bearbeiten des Menüpunktes**)
   *Installation einer Pluginversion >= 6.0.0
     *Zur Installation folgende PHP-Datei ausführen:\\ <deine-admidio-seite>/adm_plugins/MembershipFee/system/install.php



 
==== Update ====
   * Update von Pluginversion 5.x auf Pluginversion 5.y
     *Alle Dateien aus dem vorhandenen Pluginordner durch die Dateien der neuen Version ersetzen.
   *Update von einer Pluginversion < 5.x auf Pluginversion >= 6.0.0
     ***Wichtiger Hinweis:** Ein Update für Pluginversionen kleiner als v5 wird nicht unterstützt.
   *Update von einer Pluginversion 5.x auf Pluginversion >= 6.0.0
    *Den vorhandenen Pluginordner löschen
    *Entpacken der Datei mitgliedsbeitrag_6.x.x in den Ordner adm_plugins
    *Über das Admidio-Modul Menü den vorhandenen Menüpunkt löschen
    *Zur Installation folgende PHP-Datei ausführen:\\ <deine-admidio-seite>/adm_plugins/MembershipFee/system/install.php
   * Update von Pluginversion 6.0.0 auf Pluginversion 6.0.x
     *Alle Dateien aus dem vorhandenen Pluginordner durch die Dateien der neuen Version ersetzen.
==== Benutzerhandbuch ====
Das Benutzerhandbuch liegt als PDF-Dokument vor. Es ist in der Download-Datei enthalten und kann über das Menü des Plugins aufgerufen werden.
==== Änderungshistorie ====
//6.0.1 (08.01.2026)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av6.0.1|Alle Änderungen dieser Version auf GitHub]]

//6.0.0 (24.11.2025)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av6.0.0|Alle Änderungen dieser Version auf GitHub]]

//5.3.1 (24.10.2024)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.3.1|Alle Änderungen dieser Version auf GitHub]]

//5.3.0 (17.01.2024)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.3.0|Alle Änderungen dieser Version auf GitHub]]

//5.2.1 (06.08.2023)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.2.1|Alle Änderungen dieser Version auf GitHub]]

//5.2.0 (06.03.2023)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.2.0|Alle Änderungen dieser Version auf GitHub]]

//5.1.6 (18.12.2022)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.1.6|Alle Änderungen dieser Version auf GitHub]]
  * **Wichtiger Hinweis:** Mit diesem Update wurde das Hauptscript "mitgliedsbeitrag.php" umbenannt in "membership_fee.php". Der Menüeintrag in Admidio muss entsprechend angepasst werden.

//5.1.5 (08.09.2022)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.1.5|Alle Änderungen dieser Version auf GitHub]]

//5.1.4 (08.06.2022)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.1.4|Alle Änderungen dieser Version auf GitHub]]

//5.1.3 (19.04.2022)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.1.3|Alle Änderungen dieser Version auf GitHub]]

//5.1.2 (08.03.2022)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.1.2|Alle Änderungen dieser Version auf GitHub]]

//5.1.1 (22.02.2022)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.1.1|Alle Änderungen dieser Version auf GitHub]]

//5.1.0 (08.01.2022)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.1.0|Alle Änderungen dieser Version auf GitHub]]

//5.0.2 (08.04.2021)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.0.2|Alle Änderungen dieser Version auf GitHub]]

//5.0.1 (11.01.2021)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.0.1|Alle Änderungen dieser Version auf GitHub]]

//5.0.0 (12.12.2020)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av5.0.0|Alle Änderungen dieser Version auf GitHub]]

//4.3.4 (26.07.2020)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.3.4|Alle Änderungen dieser Version auf GitHub]]

//4.3.3 (04.04.2019)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.3.3|Alle Änderungen dieser Version auf GitHub]]

//4.3.2 (25.11.2018)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.3.2|Alle Änderungen dieser Version auf GitHub]]

//4.3.1 (25.04.2018)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.3.1|Alle Änderungen dieser Version auf GitHub]]

//4.3.0 (16.04.2018)//
  * Kompatibilität mit Admidio 3.3
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.3.0|Alle Änderungen dieser Version auf GitHub]]

//4.2.4 (25.03.2018)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.2.4|Alle Änderungen dieser Version auf GitHub]]

//4.2.3 (27.01.2018)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.2.3|Alle Änderungen dieser Version auf GitHub]]

//4.2.2 (30.12.2017)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.2.2|Alle Änderungen dieser Version auf GitHub]]

//4.2.1 (25.05.2017)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.2.1|Alle Änderungen dieser Version auf GitHub]]

//4.2.0 (22.12.2016)//
  * Kompatibilität mit Admidio 3.2
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.2.0|Alle Änderungen dieser Version auf GitHub]]

//4.1.2 (02.06.2016)//
  * [[https://github.com/rmbinder/Mitgliedsbeitrag/issues?q=milestone%3Av4.1.2|Alle Änderungen dieser Version auf GitHub]]

//4.1.1 (17.02.2016)//
  * Fehler beim Erzeugen von Mitgliedsnummern behoben (Version 4.1.0 erzeugte für alle Mitglieder neue Mitgliedsnummern)

//4.1.0 (17.02.2016)//
  * Kompatibilität mit Admidio 3.1
  * im Modul Fälligkeitsdatum wurde der Sequenztyp bei -alle ändern- nicht mitgeändert
  * in mehreren Modulen das Aussehen der Hilfe-Popups geändert (Anzeigefehler im Scroll-Bereich unter Admidio 3.1)
  * im Modul Rechnung-Export wird jetzt bei leerer Ausgabe eine Fehlermeldung angezeigt
  * in der Auswahl Squenztyp/Fälligkeitsdatum wurden auch Daten inaktiver Mitglieder angezeigt
  * beim Versenden von Vorabinformationen an mehrere Mitglieder gleichzeitig wurde #creditor_id# nicht aufgelöst 
  * Link zur Dokumentation geändert

//4.0.0 (09.11.2015)//
  * Anpassung an Admidio 3.0
  * Deinstallationsroutine erstellt
  * Modul copy erstellt
  * Verfahren zum Einbinden des Plugins (include) geändert 
  * Menübezeichnungen angepasst (gleichlautend mit anderen Plugins)
  * Erweiterte Überprüfung auf unzulässige Zeichen in den SEPA-XML-Dateien   
  * Nur Intern: Verwaltung der Konfigurationsdaten geändert 

//3.3.7 (08.09.2014)//
  * 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 aufgelöst 
  * die Einschränkung auf die Rolle Mitglied beim Erzeugen von Mitgliedsnummern wurde entfernt

//3.3.6 (25.07.2014)//
  * IBAN only 
  * beim Setzen eines Bezahlt-Datums wird der Sequenztyp nach RCUR nur beim Vorliegen eines Fälligkeitsdatums geändert
  * im Modul "Fälligkeitsdatum 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 Auswahlmöglichkeiten der Kombination Fälligkeitsdatum/Sequenztyp Mitglieder ohne vorhandenem Beitrag nicht mehr angezeigt
  * Eil-Lastschrift (COR1)
  * Menüpunkt DTA-Export gestrichen
  * Beitragszahlungen kann auf einzelne Beitragsrollen eingeschränkt werden
  * IBAN-Prüfung
  * E-Mail-Versand im Modul Vorabinformation an mehrere Mitglieder gleichzeitig möglich
  * Prüfbedingung zum Übersetzen von Rollen und Kategorien durch Sprachdatei geändert
  * Anzeigeposition des Kalenders in Einstellungen-Altersgestaffelte Rollen angepasst
  * anteilige Beitragsberechnung bis zum Ende einer Rollenmitgliedschaft
  * unter dem Menüpunkt "Einstellungen-Reset" wurden diverse Löschmöglichkeiten entfernt, da diese seit der Version 3.3.5 unter "Allgemein-Beitragsberechnung" zu finden sind
  * interne Änderungen (ohne Funktionsänderungen):
    * 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. Menüpunkt "Rollenprüfungen" wurde aufgrund erweiterter Funktionalität umbenannt in "Prüfungen"
    * 5. Menüpunkt "Einstellungen-Reset" wurde umbenannt in "Einstellungen-Löschen"
			    
//3.3.5 (12.02.2014)//\\
(Dank an fiwad für die Unterstützung beim Testen dieser Version)
  * Fehler ...indefined index:...language.php line 272... behoben
  * Fehler im Modul Beitragsanalyse behoben (fehlende IBAN-Verknüpfung)
  * Fehler im Modul Neuzuordnung behoben
  * Diakritische Zeichen werden in der SEPA-XML-Datei ersetzt
  * Errechnete Beiträge können aufsummiert werden
  * Beitragsneuberechnung kann auf einzelne Beitragsrollen eingeschränkt werden
  * Initialisierungsroutine überarbeitet
  * SOLL/IST-Anzeige der Setuproutine überarbeitet
  * Link auf Familien im Modul Rollenprüfung geändert
  * Beitragstext gestrafft (Leerzeichen und + entfernt)
  * Fälligkeitsdatum bearbeiten kann auf einzelne Beitragsrollen eingeschränkt werden
  * Rollenprüfung für Familienrollen umfassend neu gestaltet 
  * Menü Beitragsberechnung neu gestaltet

//3.3.4 (30.10.2013)//
  * Fehler %%(())%% behoben
  * Erweiterung für "mehrere Familienrollen"
  * Erweiterung für "mehrere altersgestaffelte Rollen"
  * E-Mail-Versand in Modul Beitragszahlungen eingearbeitet
  * Ergebnismeldung in Modul Neuzuordnung eingearbeitet 

//3.3.3 (13.09.2013)//
  * E-Mail-Versand in Modul Vorabinformation eingearbeitet
  * Die Prüfung der Rollenmitgliedschaften kann auf Mitglieder bestimmter Kategorien eingegrenzt werden (Wunsch von joesch)

//3.3.2 (01.08.2013)//
  * error_reporting überarbeitet

//3.3.1 (11.07.2013)//
  * Fehler beim Anlegen der Kategorie Kontodaten behoben
             
//3.3.0 (02.07.2013)//
  * Plugin um SEPA erweitert
  * Einfache Mitgliedsnummern können erzeugt werden 
  * Fehler bei der Anzeige des Beitrag-Suffix bei anteiligen Beiträgen behoben

//3.2.0 (26.03.2013)//
  * 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 Rollenprüfung "Rollenmitgliedschaft (Ausschluss)" behoben 

//3.1.1 (18.01.2013)//
  * Im Modul Beitragszahlungen wird jetzt auch der Beitrag angezeigt
  * Ein Fehler beim Speichern des Bezahlt-Datums wurde behoben (function date_format2mysql von eiseli) 
  * Anführungszeichen 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 

//3.1.0 (06.12.2012)//
  * Ein Fehler beim Speichern der config.ini wurde behoben
  * Das Plugin wurde für "mehrere Organisationen" erweitert
  * Eine upgrade.php wurde erstellt (3.0.0 --> 3.1.x)                  
  * Die Anzeige der Mitgliedsnamen im Beitragstext ist jetzt möglich (Anregung durch hausi) (eine Anzeige erfolgt jedoch nur, wenn: Kontoinhaber und Mitgliedsname unterschiedlich sind oder Kontoinhaber leer ist)
  * In der Rollenprüfung 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

//3.0.0 (25.06.2012)//
  * Beiträge aus dem Forum eingearbeitet
  * Rundung der berechneten Mitgliedsbeiträge auf zwei Nachkommastellen
  * Profilfeld Beitritt ist kein Pflichtfeld mehr
  * zusätzlicher Schalter für die anteilige Beitragsberechnung (Berechnung anhand des Beitrittsdatums oder des Beginns einer Rollenzugehörigkeit) 
  * das Präfix für Familienrollen ist beim ersten Aufruf vordefiniert ('Familie')
  * bei Familienrollen kann ein Leiter definiert werden; dieser wird für die Beitragsberechnung herangezogen 
  * ein Fehler in der Beitragsberechnung wurde behoben (bestehende Alt-Beiträge wurden nicht gelöscht )
  * ein Fehler bei der Berechnung des Alters eines Mitglieds, bezogen auf den Stichtag, wurde behoben  

//3.0.0 beta 1 (30.05.2012)//
  * 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ü anwählbar. 

//2.3.1 (03.03.2012)//
  * Ein Fehler bei der Berechnung von Cent-Beträgen wurde behoben  

//2.3.0: (21.02.2012)//
  * das Plugin ist jetzt Admidio 2.3 kompatibel
  * Über Rollenzugehörigkeiten können fixe Jahresbeiträge berechnet werden. (Alle Mitglieder einer Kategorie zahlen einen festen Jahresbeitrag. Die effektiven Beiträge werden von den jeweiligen Rollen der Kategorie aus der DB ermittelt.) (hausi)
  * der Fehler bei einem Mitgliedsbeitrag von 0 wurde behoben 

//2.2.1 (08.12.2011)//
  * das Standard-Datenbankpräfix (adm_) ist nicht mehr fest kodiert

//2.2.0 (21.11.2011)//
  * Das externe Programm dtaus wird nicht mehr benötigt. Durch die Integration der Klasse DTA ist es jetzt möglich, direkt die dtaus-Datei und den dazugehörigen 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 zufällig ausgewählten Mitglieds verwendet. Falls genau bei diesem Mitglied keine Kontodaten hinterlegt waren, wurde auf Rechnung umgestellt. Dies wurde geändert. 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.

//2.1.0 (26.10.2011)//
  * Dem Plugin wurde eine Weboberfläche verpasst.
  * 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.       

//2.0.0 (12.07.2011)//
  * Neues Feld "Beitritt" für ein Mitglied
  * Berechnung eines Spartenbeitrages
  * Berechnung eines Schüler- und Studentenbeitrages
  * Beiträge können abgerundet werden
  * der Kategoriename für Familien ist frei wählbar    

//1.0.1 (10.01.2011)//
  * Gerald Lutter