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 ====
Dieses Plugin berechnet Mitgliedsbeiträge anhand von Rollenzugehörigkeiten eines Mitglieds. 

==== Downloads ====
[[https://www.admidio.org/intern/adm_program/modules/downloads/get_file.php?file_id=209|mitgliedsbeitrag_4.3.3.zip]] - **(Admidio 3.3)**

Ältere Versionen:\\ 
[[https://www.admidio.org/intern/adm_program/modules/downloads/get_file.php?file_id=185|mitgliedsbeitrag_4.2.4.zip]] - (Admidio 3.2)\\
[[https://www.admidio.org/intern/adm_program/modules/downloads/get_file.php?file_id=153|mitgliedsbeitrag_4.1.2.zip]] - (Admidio 3.1)\\
[[https://www.admidio.org/intern/adm_program/modules/downloads/get_file.php?file_id=101|mitgliedsbeitrag_4.0.0.zip]] - (Admidio 3.0)\\
[[https://www.admidio.org/intern/adm_program/modules/downloads/get_file.php?file_id=98|mitgliedsbeitrag_3.3.7.zip]] - (Admidio 2.4)\\ 
[[https://www.admidio.org/intern/adm_program/modules/downloads/get_file.php?file_id=89|mitgliedsbeitrag_3.1.1.zip]] - (Admidio 2.3)

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

Plugin-Version:     **4.3.3**\\ 

Notwendige Admidio-Version:  **3.3**\\ 

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

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

Lizenz: **GPL 2**

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

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

==== Installation ====
  * Im Ordner adm_plugins einen neuen Ordner mit dem Namen mitgliedsbeitrag erstellen
  * Danach alle Dateien (und Ordner) des Ordners mitgliedsbeitrag aus der entpackten Zip-Datei in diesen Ordner kopieren.
  * Anschließend über das Admidio-Modul Menü einen Menüeintrag für Mitgliedsbeitrag mit folgender URL erzeugen: /adm_plugins/mitgliedsbeitrag/mitgliedsbeitrag.php (Beim Erstellen dieses Menüeintrages wird dringend empfohlen, im Feld „Sichtbar für“ eine Rolle mit der Berechtigung "Profildaten aller Benutzer bearbeiten" anzugeben). 



 
==== Update ====
  * Zuerst alle Dateien im Pluginverzeichnis von Mitgliedsbeitrag löschen.
  * Danach alle Dateien (und Ordner) des Ordners mitgliedsbeitrag aus der entpackten Zip-Datei in das Pluginverzeichnis kopieren.
  * Vor einem Update wird **dringend** empfohlen, eine Sicherung anzulegen

==== Änderungshistorie ====
//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

----

==== Funktionsweise ====

  * [[#einleitung|Einleitung]]
  * [[#die_rollentypen|Die Rollentypen]]
    * [[#altersgestaffelte_rollen|Altersgestaffelte Rollen]]
    * [[#familienrollen|Familienrollen]]
    * [[#festbeitragsrollen|Festbeitragsrollen]]
  * [[#anteilige_beitragsberechnung|Anteilige Beitragsberechnung]]
    * [[#besonderheit_familienrollen|Besonderheit Familienrollen]]
  * [[#die_installationsroutine|Die Installationsroutine]]
  * [[#wie_faengt_man_an|Wie fängt man an]]
  * [[#menuestruktur|Menüstruktur]]
    * [[#menue_beitraege|Menü Beiträge]]
    * [[#menue_mandatsverwaltung|Menü Mandatsverwaltung]]
    * [[#menue_export|Menü Export]]
    * [[#menue_optionen|Menü Optionen]]
    * [[#menue_einstellungen|Menü Einstellungen]]
  * [[#sepa|SEPA]]
    * [[#mandatslaufzeiten/lastschrifttypen|Mandatslaufzeiten/Lastschrifttypen]]
    * [[#vorabinformation|Vorabinformation]]
    * [[#kontoinhaber|Kontoinhaber]]
    * [[#rahmenmandate|Rahmenmandate]]
    * [[#erzeugen_einer_sepa-xml-datei|Erzeugen einer SEPA-XML-Datei]]
  * [[#e-mails_versenden|E-Mails versenden]]
  * [[#die_speicherung_der_konfiguration|Die Speicherung der Konfiguration]]

----

=== Einleitung ===

Dieses Plugin errechnet Mitgliedsbeiträge anhand der Rollenmitgliedschaften der Mitglieder. (Einer Rolle kann in Admidio ein Beitrag und ein Beitragszeitraum zugeordnet werden. Diese Einträge wertet das Plugin aus.)

Dazu wurden drei verschiedene Rollentypen festgelegt:

  * **Altersgestaffelte Rollen** (Beitragsberechnung abhängig vom Alter eines Mitglieds)
  * **Familienrollen** (Beitragsberechnung für Familien oder Gruppen, wobei ein Mitglied der Beitragszahler ist)
  * **Festbeitragsrollen** (Beitragsberechnung für Sparten, Ehrenmitglieder, Jugendliche etc.)

Für eine Beitragsberechnung sind nur Rollen relevant, bei denen ein Beitrag **und** ein Beitragszeitraum definiert sind (auch ein Beitrag von 0 € ist möglich, z.B. für Ehrenmitglieder).
Ein Mitglied kann dabei Angehöriger einer oder mehrerer Rollen sein. Die bei diesen Rollen eingetragenen Beiträge werden aufsummiert. In welcher Kategorie sich diese Rollen befinden ist nicht von Bedeutung.

  - Der Beitrag einer Rolle ist **immer ein Jahresbeitrag**.
  - Der Beitragszeitraum einer Rolle wird für die Funktion **"anteilige Berechnung"** verwendet (siehe hierzu den Abschnitt "Anteilige Beitragsberechnung").

//Hinweis://
Verweise in dieser Beschreibung auf bestimmte Menüpunkte des Plugins sind folgendermaßen dargestellt: -><Reiter>-<Menüpunkt>-<ggf. Einzelpunkt> (z.B. ->Einstellungen-Familienrollen-Präfix)

----

=== Die Rollentypen ===

== Altersgestaffelte Rollen ==

Für eine altersgestaffelte Beitragsermittlung muss für jeden Altersbereich eine entsprechende Rolle angelegt werden. Dabei muss der gesamte Altersbereich (ohne Lücken) abgedeckt sein.
Der Rollenname ist von entscheidender Bedeutung, da darin der Altersbereich mit angegeben wird. Die relevanten Altersangaben müssen dazu von Trennzeichen (->Einstellungen-Altersgestaffelte Rollen-Trennzeichen) umschlossen sein. Mögliche Trennzeichen wären z.B. * oder # oder + oder - oder _ oder ! oder %.

Beispiele für Rollennamen:
  * Mitglieder zwischen *0* und *14* Jahren
  * Mitglieder von *15* bis *17* Jahren
  * Mitglieder *18* bis *99* Jahre
  * Mitglieder von -0- bis -18- Jahren
  * Mitglieder -19- bis -80- Jahre

Ein neues Mitglied wird bei seiner Erstaufnahme in eine oder mehrere dieser altersgestaffelten Rollen aufgenommen (in welche ist nicht von Bedeutung). Über ->Beiträge-Neuzuordnung altersgestaffelte Rollen wird eine Routine angestoßen, die **alle** Mitglieder von altersgestaffelten Rollen anhand ihres Alters, bezogen auf den Stichtag (->Einstellungen-Altersgestaffelte Rollen-Stichtag) neu auf die altersgestaffelten Rollen verteilt.

== Familienrollen ==

Beiträge, die bei einer Familienrolle definiert sind, gelten für die gesamte Familie, nicht für jedes Einzelmitglied. Alle Angehörigen einer Familienrolle zahlen einen gemeinsamen Beitrag.

Damit das Plugin Familienrollen von anderen Beitragsrollen unterscheiden kann, müssen alle Familienrollen mit einem fest definierten Präfix beginnen, z.B. "Fam." oder "Familie"(->Einstellungen-Familienrollen-Präfix).
Es können beliebig viele Familienrollen definiert werden (z.B. Fam100 mit Beitrag 100 EUR oder Fam200 mit Beitrag 200 EUR). Hierbei ist jedoch darauf zu achten, dass sich alle Präfixe voneinander unterscheiden (Nicht "Fam" gleichzeitig mit "Familie" verwenden.).

//Wichtiger Hinweis:// Auch wenn nicht mit Familienrollen gearbeitet wird, muss trotzdem mindestens ein Familienrollen-Präfix definiert sein, ansonsten interpretiert das Plugin alle Beitragsrollen als Familienrollen und berechnet die Beiträge falsch.

Beispiele für Rollennamen:
  * Familie Meier
  * Familie Huber
  * Fam100 Roller
  * Fam100 Müller

//Besonderheit Zahlungspflichtiger//

Bei Familienrollen wird das erste Mitglied, bei dem Kontodaten hinterlegt sind, vom Plugin als Zahlungspflichtiger markiert. Diesem Zahlungspflichtigen werden die errechneten Beiträge zugeordnet.

Sind bei keinem Familienmitglied Kontodaten hinterlegt, so wird ein Zahlungspflichtiger nach dem Zufallsprinzip bestimmt. Dies könnte unter Umständen auch ein kleines Kind sein.

Um diesem Sonderfall vorzubeugen, kann bei einer Familie ein Leiter bestimmt werden. Der Leiter ist in diesem Fall für das Programm der Zahlungspflichtige, unabhängig davon, ob bei Ihm Kontodaten hinterlegt sind oder nicht.

Ein Leiter einer Familie kann nicht gleichzeitig Leiter einer weiteren Familie sein.

== Festbeitragsrollen ==

Alle weiteren Rollen, bei denen ein Beitrag und ein Beitragszeitraum definiert sind, fallen unter "Festbeitragsrollen". Die Namen dieser Rollen und die Kategorien in denen sie sich befinden, sind nicht von Bedeutung. Sobald ein Mitglied Angehöriger einer oder auch mehrerer dieser Rollen ist, wird der Beitrag der Rolle in die Beitragsberechnung mit einbezogen.

Über Festbeitragsrollen können
  * beliebig viele Spartenbeiträge
  * Beiträge für Jugendliche
  * Beiträge für Schüler
  * Beiträge für Ehrenmitglieder (Beitrag 0 EUR)
  * Beitragsermäßigungen (negativer Beitrag; Mindestvorraussetzungen: Plugin-Version 4.3.2, Admidio-Version 3.3.8)
  * Beiträge für Senioren usw
berechnet werden.

----

=== Anteilige Beitragsberechnung ===

Beendet ein Mitglied während des Jahres seine Mitgliedschaft in einer Rolle oder tritt es während des Jahres neu einer Rolle bei, wird eine anteilige Beitragsberechnung durchgeführt.

  * Für die anteilige Berechnung bei Beendigung der Mitgliedschaft wird das Ende einer Rollenzugehörigkeit verwendet.
  * Für die anteilige Berechnung bei Beginn einer Mitgliedschaft wird, je nach Konfiguration, entweder das Beitrittsdatum oder der Beginn einer Rollenmitgliedschaft verwendet.

  * Beitragszeitraum Monatlich: Berechnet wird jeder angefangene Monat
    * Bsp: Beitritt im April -> Berechnet werden Apr bis Dez = 9 Monate = 9/12 vom Jahresbeitrag
    * Bsp: Austritt im Juni  -> Berechnet werden Jan bis Jun = 6 Monate = 6/12 vom Jahresbeitrag

  * Beitragszeitraum Vierteljährlich: Im Beitritts-/Austrittsjahr wird jedes angefangene Vierteljahr berechnet
    * Bsp: Beitritt im zweiten Vierteljahr (Apr, Mai, Jun) -> 9 Monate werden berechnet = 9/12 vom Jahresbeitrag
    * Bsp: Beitritt im vierten Vierteljahr (Okt, Nov, Dez) -> 3 Monate werden berechnet = 3/12 vom Jahresbeitrag

  * Beitragszeitraum Halbjährlich: Im Beitritts-/Austrittsjahr wird jedes angefangene Halbjahr berechnet
    * Bsp: Beitritt im ersten Halbjahr  -> 12 Monate werden berechnet = 12/12 vom Jahresbeitrag
    * Bsp: Beitritt im zweiten Halbjahr ->  6 Monate werden berechnet =  6/12 vom Jahresbeitrag
    * Bsp: Austritt im ersten Halbjahr  ->  6 Monate werden berechnet =  6/12 vom Jahresbeitrag
    * Bsp: Austritt im zweiten Halbjahr -> 12 Monate werden berechnet = 12/12 vom Jahresbeitrag

  * Beitragszeitraum Jährlich und Einmalig: Im Beitritts-/Austrittsjahr fällt der volle Beitrag einer Rolle an.

//Achtung:// Eine Beitragsberechnung (auch eine anteilige) wird nur für aktive Mitglieder durchgeführt. Das heißt, ein Mitglied muss am Tag an dem die Berechnung durchgeführt wird, ein aktives Mitglied der Rolle sein. Zukünftige sowie ehemalige Rollenmitgliedschaften werden nicht berücksichtigt.

== Besonderheit Familienrollen ==

Die anteilige Beitragsberechnung von Familienrollen funktioniert nach einem ähnlichen Prinzip.

  * Entweder existiert eine Familienrolle bereits zu Beginn des Abrechnungsjahres (und dauert bis zum Jahresende)
  * oder sie wird im Abrechnungsjahr neu angelegt (und dauert auch bis zum Jahresende).

Berechnet wird immer bis zum Jahresende, da es technisch nicht möglich ist einer Familienrolle ein Endedatum zuzuweisen (um Berechnungen von - bis durchzuführen).
Ausschlaggebend für eine anteilige Berechnung bei Familienrollen ist das Datum, an dem die Rolle angelegt wurde. Dieses Datum (rol_timestamp_create) wird in Admidio nicht angezeigt und ist innerhalb von Admidio auch nicht veränderbar.

----

=== Die Installationsroutine ===

Beim ersten Aufruf und bei jedem Start prüft das Plugin ob Versionsnummer und Stand in der version.php mit den Daten in der Datenbank übereinstimmen. Bei Unterschiedlichkeit wird eine Installationsroutine aufgerufen.

//Erster Durchgang: Anlegen fehlender Profilfelder und Kategorien//

{{:de:plugins:mitgliedsbeitrag:installation-neuinst.png?400|}}
{{:de:plugins:mitgliedsbeitrag:installation-fehlende-felder.png?400|}}\\
Im ersten Durchgang der Installationsroutine wird die Datenbank auf fehlende Profilfelder und Kategorien überprüft. Falls Profilfelder oder Kategorien fehlen, können sie über den Button "Weiter" angelegt werden.

{{:de:plugins:mitgliedsbeitrag:installation-alle-felder-vorhanden.png?400|}}\\
Nur wenn alle notwendigen Profilfelder vorhanden sind, kann zum zweiten Durchgang gewechselt werden.

//Zweiter Durchgang: Soll-Ist-Vergleich//

{{:de:plugins:mitgliedsbeitrag:installation-soll-ist-vergleich.png?400|}}\\
Der zweite Durchgang der Installationsroutine ist nur ein Soll-Ist-Vergleich um aufzuzeigen, wie die notwendigen Kategorien und Profilfelder definiert sein sollten. Unterschiede sind fett hervorgehoben.

Es wäre z.B. möglich, daß bereits ein Profilfeld mit dem Namen "Mitgliedsnummer" existiert, es jedoch nicht den richtigen Datentyp aufweist. Notwendige Änderungen werden **nicht** durch die Installationsroutine durchgeführt.

----

=== Wie fängt man an ===

  - Sicherung der Admidio-Datenbank anlegen
  - Mitgliedsbeitrag zum ersten Mal starten; dabei werden fehlende Profilfelder angelegt.
  - Festlegen, mit welchen Rollentypen man arbeiten will.
  - Die Rollen konfigurieren

== Wenn altersgestaffelte Rollen verwendet werden: ==

  * Die Rollen gemäß der Namenskonvention anlegen und dabei beachten, dass keine Lücken vorhanden sind (z.B.  "Alter -0- bis -17-" und "Alter -18- bis -99-") Sollte ein Mitglied dabei älter als 99 Jahre sein, wird bei ->Beiträge-Neuzuordnung altersgestaffelte Rollen eine Fehlermeldung ausgegeben.

  * Beitrag und Beitragszeitraum dieser Rollen festlegen (Beschreibung kann, muss aber nicht angegeben werden)

  * in ->Einstellungen-Altersgestaffelte Rollen einen Stichtag (i.d.R. der 31.12. des vergangenen Jahres) und das verwendete Trennzeichen definieren

  * über ->Optionen-Rollenübersicht prüfen, ob alle altersgestaffelten Rollen erkannt und angezeigt werden

  * alle Mitglieder, die in diese altersgestaffelten Rollen sollen, einer Rolle hinzufügen

  * über ->Beiträge-Neuzuordnung altersgestaffelte Rollen alle Mitglieder (ihrem Alter entsprechend) neu zuordnen.

  * ->Optionen-Prüfungen starten und Fehler korrigieren

  * //Info:// Mitglieder, die nach dem Stichtag geboren sind, dürfen nicht in eine altersgestaffelte Rolle, da sie für das Programm (bezogen auf den Stichtag) noch nicht existieren. Diese Mitglieder deshalb entweder in einer Familie oder in einer separaten Festbeitragsrolle unterbringen.

== Wenn Familienrollen verwendet werden: ==

  * Alle Familienrollen anlegen und dabei beachten, dass sie mit demselben Präfix beginnen. (z.B. Präfix „Familie“ für Familie Meier und Familie Huber oder Präfix „Fam.“ für Fam. Meier und Fam. Huber)

  * in ->Einstellungen-Familienrollen das verwendete Präfix, den Beitrag und den Beitragszeitraum definieren (Beschreibung kann, muss aber nicht angegeben werden) und speichern

  * über ->Optionen-Familienrollen aktualisieren die Einträge von Beitrag, Beitragszeitraum und Beschreibung von Familienrollen mit den Angaben in den Einstellungen abgleichen und aktualisieren

  * über ->Optionen-Rollenübersicht prüfen, ob alle Familienrollen erkannt und angezeigt werden

  * den Familienrollen Mitglieder zuordnen

  * ->Optionen-Prüfungen starten und Fehler korrigieren

== Wenn Festbeitragsrollen verwendet werden: ==

  * Alle Festbeitragsrollen anlegen und Mitglieder zuordnen

  * über ->Optionen-Rollenübersicht prüfen, ob alle Rollen erkannt und angezeigt werden

  * ->Optionen-Prüfungen starten und Fehler korrigieren

----

=== Menüstruktur ===

Alle Funktionen des Plugin sind über ein Menü zugänglich.

{{:de:plugins:mitgliedsbeitrag:das-menue.png?400|}}\\

  * Über die Menüpunkte des Reiters Beiträge gelangt man zu den Hauptfunktionen des Plugins, wie Neuzuordnung, Neuberechnung und Beitragszahlung.
  * Über die Mandatsverwaltung können Mandate bearbeitet und Mandatsreferenzen erzeugt werden.
  * Über Export sind alle Exportfunktionen zugänglich.
  * Optionen bietet die Möglichkeit Mitgliedsnummern zu erzeugen, Profildaten zu kopieren, sich eine Rollenübersicht oder diverse Prüfungen anzeigen zu lassen
  * Alle Grundeinstellungen sind über das separate Menü "Einstellungen" erreichbar //(Hinweis: Dieses Menü ist nur für Administratoren sichtbar)//.

{{:de:plugins:mitgliedsbeitrag:auf-einen-blick.png?400|}}\\
Zusätzlich zu den Menüfunktionen wird der aktuelle Stand der Beitragsberechnung dargestellt.

----

=== Menü Beiträge ===
{{:de:plugins:mitgliedsbeitrag:menue-beitraege.png?400|}}

----

== Menüpunkt Neuzuordnung altersgestaffelte Rollen ==
{{:de:plugins:mitgliedsbeitrag:beitraege-neuzuordnung-altersgestaffelte-rollen.png?400|}}\\
Über diesen Menüpunkt werden alle Mitglieder von altersgestaffelten Rollen neu zugeordnet.

----

== Menüpunkt Löschen ==
{{:de:plugins:mitgliedsbeitrag:beitraege-loeschen.png?400|}}\\
Über Löschen können Einträge wie z.B. Beitrag, Beitragstext, Bezahlt-Datum oder Fälligkeitsdatum in der Datenbank gelöscht werden.

----

== Menüpunkt Neuberechnung ==
{{:de:plugins:mitgliedsbeitrag:beitraege-neuberechnung.png?400|}}\\
Über Neuberechnung werden die Mitgliedsbeiträge neu berechnet.

----

== Menüpunkt Beitragszahlungen ==
{{:de:plugins:mitgliedsbeitrag:beitraege-beitragszahlungen.png?400|}}\\
Über Beitragszahlungen kann ein Bezahlt-Datum in die Datenbank geschrieben werden.

{{:de:plugins:mitgliedsbeitrag:beitragszahlungen-bearbeiten.png?400|}}\\
Wurde ein Mitgliedsbeitrag bezahlt, kann dies in der Datenbank vermerkt werden. Hierzu wird das Datum des Zahltages (Bezahlt-Datum) in die Datenbank geschrieben.

{{:de:plugins:mitgliedsbeitrag:eintragen-eines-bezahlt-datums.png?400|}}\\
Ändern des Bezahlt-Datums für mehrere Mitglieder gleichzeitig.

Ein globales Zurücksetzen (Löschen) des Bezahlt-Datums ist auch über ->Beiträge-Löschen möglich.

//Wichtiger Hinweis: //Das Setzen eines Bezahlt-Datums bewirkt außerdem:\\
  - die Löschung eines eventuell vorhanden Fälligkeitsdatums
  - den Wechsel des SEPA Sequenztyps FRST nach RCUR

----

== Menüpunkt Beitragsanalyse ==
{{:de:plugins:mitgliedsbeitrag:beitraege-beitragsanalyse.png?400|}}\\
Die Beitragsanalyse dient als schneller Überblick über die zu erwartenden Mitgliedsbeiträge.

----

== Menüpunkt Beitragshistorie ==
{{:de:plugins:mitgliedsbeitrag:beitraege-beitragshistory.png?400|}}\\
Hier kann eine Historie der Beitragszahlungen angezeigt werden.

----

=== Menü Mandatsverwaltung ===
{{:de:plugins:mitgliedsbeitrag:menue-mandatsverwaltung.png?400|}}\\
Über die Mandatsverwaltung können Mandatsrefenzen erzeugt und Mandate bearbeitet werden.

----

== Menüpunkt Mandatsreferenzen erzeugen ==
{{:de:plugins:mitgliedsbeitrag:mandatsverwaltung-mandatsreferenzen-erzeugen.png?400|}}\\
Hiermit können Mandatsreferenzen abhängig von den Vorgaben in ->Einstellungen-Mandatsverwaltung erzeugt werden.

----

== Menüpunkt Mandate bearbeiten ==
{{:de:plugins:mitgliedsbeitrag:mandatsverwaltung-mandate-bearbeiten.png?400|}}\\
Über diesen Menüpunkt kann ein Mandatsdatum gesetzt oder eine Mandatsänderung durchgeführt werden.

{{:de:plugins:mitgliedsbeitrag:mandate-bearbeiten.png?400|}}\\
Die Ansicht Mandate.

{{:de:plugins:mitgliedsbeitrag:eintragen-eines-mandatsdatums.png?400|}}\\
Ändern des Mandatsdatums für mehrere Mitglieder gleichzeitig.

{{:de:plugins:mitgliedsbeitrag:mandatsaenderung-dbtr-aufrufen.png?400|}}\\
Die Ansicht Mandatsänderung wird über den Button "Mandatsänderung" aufgerufen.

//Hinweis: //Mandatsänderungen sind erforderlich, sofern sich Mandatsdaten gegenüber dem letzten Einzug geändert haben.

{{:de:plugins:mitgliedsbeitrag:mandatsaenderung-dbtr.png?400|}}\\
Die Mandatsänderung für Zahlungspflichtige.

----

=== Menü Export ===
{{:de:plugins:mitgliedsbeitrag:menue-export.png?400|}}\\

----

== Menüpunkt SEPA ==

{{:de:plugins:mitgliedsbeitrag:export-sepa-ohne-daten.png?400|}}\\
Über den Menüpunkt SEPA können SEPA-spezifische Dateien exportiert werden.

//Hinweis: // Der Download von XML-Datei und Kontrolldatei wird erst ermöglicht, wenn mindestens ein Fälligkeitsdatum festgelegt wurde.

{{:de:plugins:mitgliedsbeitrag:faelligkeitsdatum-bearbeiten.png?400|}}\\
Über diese Ansicht kann ein Fälligkeitsdatum gesetzt werden.

{{:de:plugins:mitgliedsbeitrag:eintragen-eines-faelligkeitsdatums.png?400|}}\\
Ändern des Fälligkeitsdatums für mehrere Mitglieder gleichzeitig.

Ein globales Zurücksetzen (Löschen) des Fälligkeitsdatums  ist auch über ->Beiträge-Löschen möglich.

{{:de:plugins:mitgliedsbeitrag:export-sepa-mit-daten.png?400|}}\\
Nur wenn Fälligkeitsdaten existieren, besteht die Möglichkeit, Daten zu exportieren.

//Info: // In der Vergangenheit konnten sowohl bestimmte Sparkassen, als auch Jameica/Hibiscus, die vom Plugin nach Spezifikation 3.1 des DFÜ-Abkommens erstellten XML-Dateien nicht einlesen. Probleme bereitete die Position und das mehrfache Vorhandenseins des PmtTpInf-Blocks in der XML-Datei. Mit Version 4.3.2 des Plugins wird deshalb folgende Änderung beim Erzeugen der XML-Datei eingeführt: 

{{:de:plugins:mitgliedsbeitrag:export-sepa-pmttpinf-multi.png?400|}}\\
Wählt man unter Export-SEPA mehrere Kombinationen aus Fälligkeitsdatum und Sequenztyp aus, wird eine XML-Datei mit mehreren PmtTpInf-Blöcken erzeugt. Aufgrund der Einstellungen im obigen Beispiel wird eine Datei mit folgendem Dateinamen erstellt: sepa_2018-03-01-FRST_2018-03-01-RCUR_2018-12-06-RCUR.xml.

{{:de:plugins:mitgliedsbeitrag:export-sepa-pmttpinf-mono.png?400|}}\\
Wird unter Export-SEPA genau eine Kombination aus Fälligkeitsdatum und Sequenztyp ausgewählt (nur ein Kästchen markiert), wird eine XML-Datei mit genau einem PmtTpInf-Block, in einem bestimmten Abschnitt der Datei, erzeugt. Diese Datei sollte von allen Sparkassen, Homebankingprogrammen etc. eingelesen werden können. Im obigen Beispiel wird eine Datei mit folgendem Dateinamen erstellt: sepa_2018-03-01-RCUR.xml. 

----

== Menüpunkt Rechnung ==
{{:de:plugins:mitgliedsbeitrag:export-rechnung.png?400|}}\\
Über diesen Menüpunkt kann eine Rechnungsliste im CSV-Format erstellt werden.

----

=== Menü Optionen ===
{{:de:plugins:mitgliedsbeitrag:menue-optionen.png?400|}}\\

----

== Menüpunkt Mitgliedsnummer(n) erzeugen ==
{{:de:plugins:mitgliedsbeitrag:optionen-mitgliedsnummern-erzeugen.png?400|}}\\
Über diesen Menüpunkt können Mitgliedsnummern für aktive Mitglieder der aktuellen Organisation erstellt werden.

----

== Menüpunkt Familienrollen aktualisieren ==
{{:de:plugins:mitgliedsbeitrag:optionen-familienrollen-aktualisieren.png?400|}}\\
Hier können die Einträge von Beitrag, Beitragszeitraum und Beschreibung von Familienrollen mit den Angaben in den Einstellungen abgeglichen und aktualisiert werden.

{{:de:plugins:mitgliedsbeitrag:familienrollen-aktualisieren-identifizierung.png?400|}}\\
Unterschiede in den Eintragungen sind durch Fettschrift hervorgehoben. 

----

== Menüpunkt Kopieren ==
{{:de:plugins:mitgliedsbeitrag:optionen-kopieren.png?400|}}\\
Mittels "Kopieren" können die Inhalte von Profilfeldern von einem Mitglied zu einem anderen Mitglied kopiert werden.

{{:de:plugins:mitgliedsbeitrag:kopieren.png?400|}}\\
Die Ansicht der Option "Kopieren".

{{:de:plugins:mitgliedsbeitrag:kopieren-auswahl-quelle-auswahl-ziel.png?400|}}\\
Zuerst muß ein Mitglied als Quelle und ein Mitglied als Ziel des Kopiervorgangs ausgewählt werden.

{{:de:plugins:mitgliedsbeitrag:kopieren-auswahl-quelle.png?400|}}\\
  - Anschließend ist zuerst das Profilfeld, das als Quelle dienen soll, zu markieren
  - und anschließend das Profilfeld, das als Ziel dienen soll.

{{:de:plugins:mitgliedsbeitrag:kopieren-auswahl-ziel-und-ergebnis.png?400|}}\\
Das fertige Ergebnis eines Kopiervorgangs.

----

== Menüpunkt Prüfungen ==
{{:de:plugins:mitgliedsbeitrag:optionen-pruefungen-ok.png?400|}}\\
Alle Prüfbedingungen sind erfüllt.

//Hinweis:// Die Prüfungen haben keinen Einfluss auf die Beitragsberechnung. Sie dienen, wie der Name schon sagt, nur zur Prüfung bestimmter Daten.

Dieser Menüpunkt prüft u.a., ob in den altersgestaffelten Rollen eine Lücke in den Altersangaben besteht, ob Mitglieder Angehöriger mehrerer Rollen sind (Pflicht, Ausschluss) und ob sich in Familienrollen Mitglieder befinden, die aufgrund ihres Alters nicht in einer Familienrolle sein sollten.

{{:de:plugins:mitgliedsbeitrag:pruefbedingung-altersgestaffelte-rollen-nicht-erfuellt.png?400|}}\\
Beispiel für nicht erfüllte Prüfbedingungen in altersgestaffelten Rollen.

{{:de:plugins:mitgliedsbeitrag:pruefbedingung-familienrollen-nicht-erfuellt.png?400|}}\\
Beispiel für nicht erfüllte Prüfbedingungen in Familienrollen.

----

== Menüpunkt Rollenübersicht ==
{{:de:plugins:mitgliedsbeitrag:optionen-rollenuebersicht.png?400|}}\\
Die Rollenübersicht liefert ein Übersicht über alle Beitragsrollen und deren Anzahl an Mitgliedern.

----

=== Menü Einstellungen ===
{{:de:plugins:mitgliedsbeitrag:menue-einstellungen.png?400|}}\\
Das Einstellungen-Menü ist über den Link "Einstellungen" anwählbar. Es ist nur für Administratoren sichtbar.

----

== Menüpunkt Beitragseinstellungen ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-beitragseinstellungen1.png?400|}}\\
{{:de:plugins:mitgliedsbeitrag:einstellungen-beitragseinstellungen2.png?400|}}\\
Allgemeine Beitragseinstellungen.

----

== Menüpunkt Altersgestaffelte Rollen ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-altersgestaffelte-rollen.png?400|}}\\
Einstellungen für die altersgestaffelten Rollen.

----

== Menüpunkt Familienrollen ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-familienrollen.png?400|}}\\
Einstellungen für Familienrollen.

----

== Menüpunkt Kontodaten ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-kontodaten.png?400|}}\\
Die Kontodaten des Zahlungsempfängers.

{{:de:plugins:mitgliedsbeitrag:mandatsaenderung-cdtr-aufrufen.png?400|}}\\
Die Ansicht Mandatsänderung wird über den Link "Mandatsänderung" aufgerufen.

//Hinweis: //Mandatsänderungen sind erforderlich, sofern sich Mandatsdaten gegenüber dem letzten Einzug geändert haben.

{{:de:plugins:mitgliedsbeitrag:mandatsaenderung-cdtr.png?400|}}\\
Die Mandatsänderung des Zahlungsempfängers.

----

== Menüpunkt Export ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-export.png?400|}}\\
Einstellungen für den Datenexport.

----

== Menüpunkt Mandatsverwaltung ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-mandatsverwaltung.png?400|}}\\
Hier werden  die Parameter für die Zusammensetzung der Mandatsreferenz eingestellt.

Die Mandatsreferenz für ein beitragzahlendes Mitglied kann erst nach der erstmaligen Berechnung eines Mitgliedsbeitrages erzeugt werden und sollte grundsätzlich nicht mehr geändert werden.

//Hinweis:// Muss eine Mandatsreferenz trotzdem nachträglich geändet werden, ist eine Mandatsänderung durchzuführen.

Eine Mandatsreferenz ist in 3 Abschnitte gegliedert. Die Anzahl der Zeichen (=Mindestlänge) kann im Menü festgelegt werden.

|  Abschnitt 1  |  Stellen 1 bis x    |  Präfix            |
|  Abschnitt 2  |  Stellen x+1 bis y  |  Nullstellen       |
|  Abschnitt 3  |  Stellen y+1 bis z  |  Laufende Nummer   |

//Das Präfix//

Das Präfix kann individuell vergeben werden. Es gibt drei unterschiedliche Möglichkeiten für:
  * Familien (z.B. FAM oder FAMILIE)
  * Mitglieder, die als Selbstzahler auftreten (z.B. MIT)
  * Mitglieder, die einen Zahlungspflichtigen aufweisen (z.B. ZAL)
//Hinweis:// Ein Präfix kann, muss aber nicht eingetragen sein.

//Die Nullstellen//

Der Abschnitt 2 wird, falls die eingestellte Mindestlänge noch nicht erreicht ist, mit Nullen (0) aufgefüllt.

//Die laufende Nummer//

Der Abschnitt drei ist eine laufende Nummer. Dazu wird ein Datenbankfeld mit eindeutigem Inhalt (z.B. Mitgliedsnummer oder user_id) ausgewählt. Der Wert aus diesem Datenbankfeld wird als laufende Nummer verwendet.

Beispiel 1:
  * Festgelegte Mindestlänge: 10
  * Präfix: FAM
  * Laufende Nummer: 566
  * => ergibt folgende Mandatsreferenz: FAM0000566

Beispiel 2:
  * Festgelegte Mindestlänge: 5
  * Präfix: MITGLIED
  * Laufende Nummer: 723
  * => ergibt folgende Mandatsreferenz: MITGLIED723

Eine Mandatsreferenz wird nur für diejenigen Mitglieder erzeugt:
  * die noch keine Mandatsreferenz besitzen
  * für die ein Mitgliedsbeitrag berechnet wurde
  * die die Voraussetzungen für einen Kontoeinzug (IBAN usw vorhanden) besitzen

----

== Menüpunkt Prüfungen ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-pruefungen.png?400|}}\\
Einstellungen für die Rollenprüfung.

//Familienrollen//

Beispiel zur Rollenprüfung von Familienrollen:

Fünf unterschiedliche Familienrollenpräfixe sind definiert. Es soll geprüft werden, ob ein Angehöriger einer Familienrolle aufgrund seines Alters nicht in dieser Familienrolle sein dürfte.
Alle Prüfungen von Familienrollen beziehen sich auf den Stichtag, der bei den altersgestaffelten Rollen definiert wurde.

^  Präfix       ^  Altersbereiche / Prüfung / Bemerkung                                                                ^  Parameter  ^
|Fam.         |allgemeine Familienrollen ohne Püfung                                                               |                                 |
|FamERW2-     |0 Personen von 0 bis 17, 2 Personen von 18 bis 59, 0 Personen von 60 bis 99  | 0*17:0;18*59:2;60*99:0          |
|FamERW2+JUG1 |0 Personen von 0 bis 13, 1 Person von 14 bis 17, 2 Personen von 18 bis 59, 0 Personen von 60 bis 99 |0*13:0;14*17:1;18*59:2;60*99:0  |
|FamERW1+SEN1 |0 Personen von 0 bis 17, 1 Person von 18 bis 59, 1 Personen von 60 bis 99                           |0*17:0;18*59:1;60*99:1          |
|FamSEN2      |0 Personen von 0 bis 17, 0 Personen von 18 bis 59, 2 Personen von 60 bis 99  (**mit Syntaxfehler!!!**)  |0*17:0;**18*59::0**;60*99:2         |

//Rollenmitgliedschaft (Pflicht)//

Hier sind alle Beitragsrollen auszuwählen, denen ein Mitglied mindestens angehören soll. Alle möglichen Rollen sind dabei zu markieren.

Ein Mitglied soll beispielsweise entweder in
  * einer altersgestaffelten Rolle
ODER
  * in einer Familienrolle
ODER
  * in der Rolle Ehrenmitglieder sein
-> in diesem Fall sind Haken zu setzen bei:"Altersgestaffelte Rollen", "Familienrollen" und "Ehrenmitglieder"

//Rollenmitgliedschaft (Auschluss)//

Hier ist auszuwählen, welche Beitragsrollen sich gegenseitig ausschließen sollen.

Wenn ein Mitglied z.B. nicht gleichzeitig in einer Altersgestaffelten Rolle und einer Familienrolle sein darf
(-> doppelte Beitragsberechnung), dann ist "Altersgestaffelte Rollen ./. Familienrollen" zu markieren.

----

== Menüpunkt Ansichtsdefinitionen ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-ansichtsdefinitionen.png?400|}}\\
Über diesen Menüpunkt können die anzuzeigenden Spalten (Profilfelder) für die Ansichten 
  * Beitragszahlungen
  * Mandatsverwaltung und
  * Fälligkeitsdatum,
getrennt in Normal- und Vollbild, definiert werden. 

----

=== Menüpunkt Deinstallation ===
{{:de:plugins:mitgliedsbeitrag:einstellungen-deinstallation.png?400|}}\\
Über die Deinstallation können alle vom Plugin erstellten Konfigurationsdaten, als auch Benutzerdaten wieder gelöscht werden.

{{:de:plugins:mitgliedsbeitrag:deinstallation-organisationswahl.png?400|}}\\
Hier kann ausgewählt werden, ob nur Daten in der aktuellen Organisation oder in allen Organisationen gelöscht werden sollen.

{{:de:plugins:mitgliedsbeitrag:deinstallation-konfigurationsdaten.png?400|}}\\
Gelöschte Konfigurationsdaten werden nach einem Neustart des Plugins wieder mit Standardwerten befüllt.

{{:de:plugins:mitgliedsbeitrag:deinstallation-benutzerdaten1.png?400|}}\\
{{:de:plugins:mitgliedsbeitrag:deinstallation-benutzerdaten2.png?400|}}\\
Hier wird ausgewählt, welche Benutzerdaten gelöscht werden sollen.

ACHTUNG: Gelöschte Benutzerdaten (z.B. IBAN oder Mitgliedsnummer) können nicht wiederhergestellt werden!

//Hinweis: //Um das Plugin Mitgliedsbeitrag vollständig zu entfernen, sind alle möglichen Haken zu setzen.

{{:de:plugins:mitgliedsbeitrag:deinstallation-meldung.png?400|}}\\
Meldung nach durchgeführter Deinstallation.


----

== Menüpunkt Plugininformationen ==
{{:de:plugins:mitgliedsbeitrag:einstellungen-plugininformationen.png?400|}}\\
Hier werden Informationen zur Version und zum Stand des Plugins angezeigt.

----

=== SEPA ===

//Wichtiger Hinweis:// Alle SEPA-Funktionen setzen eine vorher durchgeführte und abgeschlossene Beitragsberechnung voraus.

Alle über die SEPA-Funktionen erzeugten Daten wie Mandatsreferenz, Mandatsdatum, Sequenztyp usw. können über das Bearbeiten des Profils eines Mitglieds nachträglich verändert werden. Eine hier von Hand durchgeführte Änderung sollte wohlüberlegt sein. Jede SEPA-Funktion baut auf eine andere auf und setzt dadurch das Vorhandensein bestimmter Daten voraus.

//Beispiel:// Ein Fälligkeitsdatum kann über das Modul „Fälligkeitsdatum bearbeiten“ nur gesetzt werden, wenn eine Mandatsreferenz und ein Mandatsdatum vorhanden sind. Wird aber ein Fälligkeitsdatum über das Profil eines Mitglieds eingetragen, ohne dass Mandatsreferenz und Mandatsdatum vorhanden sind, können beim weiteren Programmablauf Fehlfunktionen auftreten.

----

=== Mandatslaufzeiten/Lastschrifttypen ===

Das Plugin Mitgliedsbeitrag kann folgende Mandatslaufzeiten verarbeiten:

|  FRST  |  Erstlastschrift  |
|  RCUR  |  Folgelastschrift  |
|  FNAL  |  letzte Lastschrift  |
|  OOFF  |  Einmallastschrift  |

Beim erstmaligen Setzen eines Bezahlt-Datums wird der vorhandene Lastschrifttyp "FRST" geändert nach "RCUR". Dieser Lastschrifttyp "RCUR" bleibt ab diesem Zeitpunkt unverändert bestehen.

//Hinweis:// Geändert werden kann dieser Lastschrifttyp nur über eine Mandatsänderung oder über den Menüpunkt ->Export-SEPA-Fälligkeitsdatum.

----

=== Vorabinformation ===

Vor dem Lastschrifteinzug muss der Zahlungsempfänger den Zahlungspflichtigen über den geplanten Einzug schriftlich mittels einer Vorabinformation (engl. Pre-Notification, mindestens 14 Tage vor Belastung) informieren. Dies kann auch durch einen Vertrag oder eine Rechnung erfolgen, die auch mehrere Fälligkeitstermine und die entsprechenden Einzugsbeträge enthalten kann.

Eine Vorabinformation ist neu zu erstellen, wenn sich der Betrag einer Folgelastschrift ändert.

== Erforderliche Daten für die Vorabinformation ==

Vorabinformationen sind grundsätzlich an den Kontoinhaber zu senden. In Ausnahmefällen (Adresse des Kontoinhabers nicht bekannt) ist ersatzweise das Mitglied zu informieren, mit der Bitte, diese Information an den Kontoinhaber weiterzuleiten.

----

=== Kontoinhaber ===

Ist das Mitglied gleichzeitig auch der Kontoinhaber, so darf das Feld Kontoinhaber **KEINEN** Inhalt aufweisen, es muss leer sein. In diesem Fall sind nur folgende Daten anzugeben:
  * IBAN
  * BIC (kann, muss aber nicht)
  * Kreditinstitut (kann, muss aber nicht)

Falls Kontoinhaber/Zahlungspflichtiger und Mitglied nicht identisch sind, sind diese Daten zusätzlich anzugeben:
  * Vorname und Name des Kontoinhabers
  * Straße und Hausnummer
  * Postleitzahl
  * Ort

//Tipp:// Wenn möglich, sollte immer eine E-Mail-Adresse beim Kontoinhaber/Zahlungspflichtigen hinterlegt sein, damit eine Vorabinformation ohne viel Aufwand über das Plugin per E-Mail versendet werden kann.

----

=== Rahmenmandate ===

Jede Lastschrift erfordert ein eigenes Mandat mit einer eigenen Mandatsreferenz. Die Möglichkeit mit Rahmenmandaten ( = Zusammenfassung mehrerer Abbuchungen unter einer Mandatsreferenz) zu arbeiten wird durch das Plugin nur eingeschränkt unterstützt.

Damit mehrere Abbuchungen unter einer Mandatsreferenz zusammengefasst werden können, muss man über den Umweg Familienrollen gehen. Die Eigenschaft von Familienrollen, für alle Angehörigen dieselbe Mandatsreferenz zu verwenden, kann für Rahmenmandate genutzt werden. Dazu sind alle Mitglieder, für die dieselbe Mandatsreferenz verwendet werden soll, innerhalb einer Familienrolle zusammenzufassen. Der Beitrag der Familienrolle ist dabei die Summe der Einzelbeiträge der Mitglieder.

//Beispiel://

Die Beitragsgestaltung eines Vereins sieht folgendermaßen aus:
  * Kinder: 20€
  * Jugendlich: 30€
  * Erwachsene: 50 €
  * Senioren: 40€
Die Familie Mustermann besteht aus folgenden Personen:
  * Max Mustermann (Erwachsener)
  * Maria Mustermann (Erwachsene)
  * Manuel Mustermann (Kind)
  * Margit Mustermann (Jugendlich)
  * Magdalena Mustermann (Seniorin)
Alle Abbuchungen der Familie Mustermann sollen unter einem Rahmenmandat zusammengefasst werden.

//Lösung://
  * Es wird eine Familienrolle erzeugt.
  * Die Kontodaten werden bei einem einzigen Familienmitglied eingetragen (bei diesem Familienmitglied werden später auch die Mandatsreferenz und das Mandatsdatum hinterlegt)
  * Als Beitrag der Familienrolle wird die Summe der Einzelbeiträge eingetragen: 50 (Max) + 50 (Maria) + 20 (Manuel) + 30 (Margit) + 40 (Magdalena) = 190

//Beispiele für Rollennamen unter der Verwendung von Rahmenmandaten://
  * FamERW2+JUG1+SEN1+KND Mustermann
  * FamERW2+JUG1+SEN1+KND Müller
  * FamERW2+JUG2+KND Müller
  * FamERW1+JUG1+SEN1+KND Zanker

----

=== Erzeugen einer SEPA-XML-Datei ===

Zum Erstellen einer SEPA-XML-Datei sind folgende Schritte auszuführen:

== 1. Mandatsreferenzen erstellen ==

Über den Menüpunkt ->Mandatsverwaltung-Mandatsreferenzen erzeugen können Mandatsrefenzen erstellt werden.

== 2. Mandatsdatum eintragen ==

Über ->Mandatsverwaltung-Mandate bearbeiten wird zu jeder Mandatsreferenz ein Mandatsdatum eingetragen.

== 3. Beitragsberechnung durchführen ==

Über ->Beiträge-Neuberechnung werden die Beiträge berechnet.

== 4. Fälligkeitsdatum setzen ==

Über ->Export-SEPA-Fälligkeitsdatum bearbeiten wird das Modul Fälligkeitsdatum aufgerufen.

== 5. XML-Datei erzeugen ==

Die XML-Datei wird über ->Export-SEPA-XML-Datei erzeugt.

== 6. Vorabinformation erstellen ==

Der Menüpunkt ->Export-SEPA-Vorabinformation erstellt eine Liste im CSV-Format, die als Quelle für eine Serienbrieferstellung von Vorabinformationen genutzt werden kann und bietet zudem die Möglichkeit eine Vorabinformation per E-Mail zu versenden.

== 7. XML-Datei an Bank weitergeben ==

Nachdem die XML-Datei erstellt wurde, kann sie über ein Homebanking-Programm (z.B. StarMoney) an eine Bank übermittelt werden.

== 8. Bezahlt-Datum setzen ==

Um den gesamten Vorgang abzuschließen ist es wichtig, dass ein Bezahlt-Datum gesetzt wird. Durch das Setzen dieses Datums wird ein Sequenztyp FRST in den Sequenztyp RCUR geändert.

----

=== E-Mails versenden ===

Das Plugin bietet in zwei Modulen die Möglichkeit E-Mails zu versenden.

  * im Modul Beitragszahlungen
  * im Modul Vorabinformation

Der Aufruf des E-Mail-Moduls und der Versand ist in beiden Modulen fast identisch (Ausnahme: Im Modul Vorabinformation kann eine E-Mail an mehrere Mitglieder gleichzeitig versendet werden.).

Falls eine E-Mail-Adresse hinterlegt ist, erscheint in den jeweiligen Modulen ein Brief-Symbol.

//Wichtiger Hinweis:// Als Empfänger-E-Mail-Adresse wird immer die E-Mail-Adresse des Zahlungspflichtigen verwendet.

Durch Betätigen des Brief-Symbols wird das E-Mail-Modul aufgerufen. Im Modul Vorabinformation ist es zudem möglich über den Button "E-Mail" eine Mail an alle markierten Mitglieder gleichzeitig zu senden.

Abhängig vom aufrufenden Modul (Beitragszahlungen oder Vorabinformation) wird ein über
  * -> Einstellungen-Beitragseinstellungen-Beitragszahlungen E-Mail-Text
  * oder -> Einstellungen-Export-SEPA-Vorabinformation E-Mail-Text
 vordefinierter Text angezeigt. Dieser Text kann beliebig abgeändert werden.

----

=== 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
   * Kategoriereport
   * Geburtstagsliste
   * FormFiller

Die Tabelleneinträge des Plugins Mitgliedsbeitrag beginnen hierbei alle mit den Buchstaben "PMB".