Kategoriereport [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.
====== Kategoriereport ======

==== Beschreibung ====
Dieses Plugin erzeugt eine Auflistung von Rollen- und Kategoriezugehörigkeiten eines Mitglieds. 

==== Downloads ====
<WRAP download 60%>
Das Plugin ist ab Version 4.1 fester Bestandteil von Admidio!

[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=74acae81-1324-44b8-a92a-0856e70dc56b|kategoriereport_3.1.1.zip]] - **(Admidio 4)**\\
</WRAP>


Ältere Versionen:\\ 
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=564550eb-ab81-454c-8ddb-2d3df08d1470|kategoriereport_2.3.2.zip]] - (Admidio 3.3)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid= 	08a2333a-1e9d-46eb-9437-2ab3b1a83978|kategoriereport_2.2.2.zip]] - (Admidio 3.2)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=b440a461-13ae-4232-84a3-368b6f0dcb8d|kategoriereport_2.1.1.zip]] - (Admidio 3.1)\\
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=1af0f105-7a35-4bd6-8bbf-69344ff7910c|kategoriereport_2.0.1.zip]] - (Admidio 3.0)\\ 
[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=6d138634-4b56-468c-82ec-576a28bbe749|kategoriereport_1.3.2.zip]] - (Admidio 2.4)

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

Plugin-Version:     **3.1.1**\\ 

Notwendige Admidio-Version:  **4**\\ 

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

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

Lizenz: **GPL 2**

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

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

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



 
==== Update ====
  * Zuerst alle Dateien im Pluginverzeichnis von Kategoriereport  löschen.
  * Danach weiterfahren, wie unter Installation beschrieben.

==== Änderungshistorie ====
//3.1.1 (15.02.2021)//
  * [[https://github.com/rmbinder/Kategoriereport/issues?q=milestone%3Av3.1.1|Alle Änderungen dieser Version auf GitHub]]

//3.1.0 (12.12.2020)//
  * [[https://github.com/rmbinder/Kategoriereport/issues?q=milestone%3Av3.1.0|Alle Änderungen dieser Version auf GitHub]]

//3.0.0 (28.10.2020)//
  * kompatibel nur mit Admidio 4 Beta 1
  * [[https://github.com/rmbinder/Kategoriereport/issues?q=milestone%3Av3.0.0|Alle Änderungen dieser Version auf GitHub]]

//2.3.2 (09.10.2018)//
  * [[https://github.com/rmbinder/Kategoriereport/issues?q=milestone%3Av2.3.2|Alle Änderungen dieser Version auf GitHub]]

//2.3.1 (23.04.2018)//
  * [[https://github.com/rmbinder/Kategoriereport/issues?q=milestone%3Av2.3.1|Alle Änderungen dieser Version auf GitHub]]

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

//2.2.2 (02.12.2017)//
  * [[https://github.com/rmbinder/Kategoriereport/issues?q=milestone%3Av2.2.2|Alle Änderungen dieser Version auf GitHub]]

//2.2.1 (04.05.2017)//
  * [[https://github.com/rmbinder/Kategoriereport/issues?q=milestone%3Av2.2.1|Alle Änderungen dieser Version auf GitHub]]

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

//2.1.1 (08.06.2016)//
  * [[https://github.com/rmbinder/Kategoriereport/issues?q=milestone%3Av2.1.1|Alle Änderungen dieser Version auf GitHub]]

//2.1.0 (09.02.2016)//
  * Kompatibilität mit Admidio 3.1
  * Link zur Dokumentation geändert

//2.0.1 (02.11.2015)//
  * Fehler (verursacht durch die Methode addHeadline) behoben
  * Fehler in Datei de_sie.xml behoben (</text> fehlte in einer Zeile)

//2.0.0 (26.05.2015)//
  * Anpassung an Admidio 3.0
  * Deinstallationsroutine erstellt
  * Verfahren zum Einbinden des Plugins (include) geändert
  * Erzeugen mehrerer Konfigurationen möglich
  * Kennzeichnung inaktiver und unsichtbarer Rollen
  * Menübezeichnungen angepasst (gleichlautend mit anderen Plugins)
  * Nur Intern: Verwaltung der Konfigurationsdaten geändert

//1.3.2 (17.10.2014)//
  * Für den Export sind diverse Parameter jetzt im Setup einstellbar

//1.3.1 (23.09.2014)//
  * bei Namensgleichheit von Profilfeldern wird die Kategorie in Klammern angehängt

//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
  * Die Leiter von Rollen können ausgegeben werden
  * 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.1 (14.12.2012)//
  * Setuproutine erstellt (Vorschlag im Forum durch guenter47: "Kategoriereport mit weniger Userspalten")
  * Die angezeigten Spalten sind frei wählbar (Vorschlag im Forum durch guenter47: "Kategoriereport mit weniger Userspalten")
  * Kleinere Änderungen eingepflegt
  * Funktion checkStringLenth von guenter47 eingearbeitet
  * In der Anzeige einen Link zum Userprofil eingearbeitet 

//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)//
  * Die Einschränkung in einer Abfrage (kategoriereport_show.php, Zeile 412) auf nur Mitglieder der Rolle "Mitglied" wurde aufgehoben.
  * Die Berechtigung das Plugin aufzurufen, wurde um Rollenmitgliedschaften erweitert. 

//1.1.0 (26.10.2011)//
  * Der gesamte Plugin wurde überarbeitet und an die in Admidio geführten Listen angepasst.
  * 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 eine Auflistung von Rollen- und Kategoriezugehörigkeiten eines Mitglieds. Über den Menüpunkt //Einstellungen-Konfigurationen// können dazu beliebig viele Konfigurationen angelegt werden.

Muster einer Konfiguration und der dazugehörigen Bildschirmanzeige:\\
|  {{:de:plugins:kategoriereport:alle-fussballer-konfiguration.png?300}}  |  {{:de:plugins:kategoriereport:alle-fussballer-anzeige.png?300}}  |
|  Konfiguration  |  Anzeige  |

Mit "Konfiguration wählen..." wird eine Konfiguration als Basis für die Anzeige ausgewählt.\\
{{:de:plugins:kategoriereport:konfiguration-waehlen.png?300}}

=== Menü Einstellungen ===

Das Menü **Einstellungen** ist über den, nur für Administratoren sichtbaren Link “Einstellungen”, rechts oben im Report anwählbar. Es ist in drei Menüpunkte unterteilt. 

  * Konfigurationen
  * Optionen
  * Plugininformationen

{{:de:plugins:kategoriereport:standardansicht-einstellungen.png?300}}
{{:de:plugins:kategoriereport:menue-einstellungen.png?300}}

//Hinweis:// Das Menü **Einstellungen** ist nur für Administratoren sichtbar. 

=== Menüpunkt Konfigurationen ===
Hier können beliebig viele Konfigurationen für den Kategoriereport erstellt werden. In der Bildschirmanzeige wird jeweils eine dieser Konfigurationen über "Konfiguration wählen..." als Grundlage für die Anzeige verwendet. 

Nach einer Neuinstallation ist eine Beispielkonfigurationen voreingestellt und mit Standardwerten befüllt.\\
|  {{:de:plugins:kategoriereport:beispielkonfiguration-konfiguration.png?300}}  |  {{:de:plugins:kategoriereport:beispielkonfiguration-anzeige.png?300}}  |
|  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 Spalten ausgewählt, die in dieser Konfiguration angezeigt werden sollen.
  * Profilfelder
  * Kategorien (⇒ "Kategorie: <Kategoriename>")
  * Rollen (⇒  "Rolle: <Rollenname>")
  * Leiter von Rollen (⇒ "Leiter: <Rollenname>")
  * Rollenmitgliedschaften 
  * Anzahl von Mitgliedschaften (⇒ "Anzahl(Zeile)")

//Hinweis://
  * Inaktive Rollen sind mit (*) gekennzeichnet.

//Besonderheit "Zusätzliche Spalten":// \\
Die Spalte "Rollenmitgliedschaften" listet alle Rollenmitgliedschaften in Textform auf, unabhängig von der Einstellung "Anzeigetext bei Mitgliedschaft/Anzeigetext bei keiner Mitgliedschaft".\\
{{:de:plugins:kategoriereport:rollenmitgliedschaften.png?300}}
{{:de:plugins:kategoriereport:rollenmitgliedschaften-anzeige.png?300}}

Über die Spalte "Anzahl (Zeile)" kann die Anzahl der Mitgliedschaften angezeigt werden (Wievielen Rollen oder Kategorien ein Mitglied angehört, bezogen auf die angezeigten Rollen/Kategorien).   

== Anzeigetext bei Mitgliedschaft/Anzeigetext bei keiner Mitgliedschaft ==
Hier wird der Text angegeben, der bei Mitgliedschaft/keiner Mitgliedschaft in einer Rolle oder Kategorie angezeigt werden soll, z.B. 
  * Ja oder True oder X bei Mitgliedschaft in einer Rolle/Kategorie
  * Nein oder False bei keiner Mitgliedschaft in einer Rolle/Kategorie.

== 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.

== Anzahl (Spalte) ==
Anzahl (Spalte) ist die Summe von Mitgliedschaften einer Rolle oder Kategorie (Wieviele Mitglieder besitzt eine Rolle oder Kategorie, bezogen auf die angezeigten Rollen/Kategorien). 

=== Menüpunkt Optionen ===
Über Optionen können die Standardkonfiguration und die Deinstallation durchgeführt werden.\\ 
{{:de:plugins:kategoriereport:optionen.png?300}}

== Konfiguration ==
Hier wird festgelegt, welche Konfiguration beim Start des Plugins angezeigt wird.\\
{{:de:plugins:kategoriereport:standardkonfiguration-waehlen.png?300}}

== Deinstallation ==
Über die Deinstallation können alle vom Plugin erstellten Konfigurationsdaten wieder gelöscht werden. \\
{{:de:plugins:kategoriereport:deinstallation.png?300}}
{{:de:plugins:kategoriereport:deinstallation-hinweis.png?300}}

=== Menüpunkt Plugininformationen ===

{{:de:plugins:kategoriereport:plugininformationen.png?300}}

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

Die Tabelleneinträge des Plugins Kategoriereport beginnen hierbei alle mit den Buchstaben "PKR".