====== Category Report ======

This [[http://sourceforge.net/projects/admidio/files/Plugins/Kategoriereport/kategoriereport_1.3.2.zip/download|Plugin]] creates a list with all roles and affiliations category of a member, and displays it on the screen.

In addition to the display, there is the possibility to print or export the generated.

===== Installation of the Plugin =====

As usual for plugins file only needs to be unzipped into the directory of Admidio adm_plugins installation. 

How the plugin, as shown in the figure below, can be integrated into the homepage, shows the following instructions.

{{:de:2.0:documentation:plugins:kategoriereport:plugin_show.png?200|}}
 
Add follwing line in the file //\admidio\adm_themes\modern\my_body_bottom.php//: 
<code php>
include(SERVER_PATH.'/adm_plugins/kategoriereport/kategoriereport.php');
</code>

  

===== Web interface of the plugin =====

The plugin has since version 1.1.0 a web interface that has been adapted to the lists known in Admidio. 

{{:de:2.0:documentation:plugins:kategoriereport:plugin_web.png?600|}}


===== Output of the plugin =====

After the report is created, it can be
  * printed via the **Print Preview** or
  * be exported **Export**

//Note:// 
The parameters for export can be set in the menu item **Options**.


{{:de:2.0:documentation:plugins:kategoriereport:plugin_tab.png?600|}}


===== Configuration of the Plugin =====

Across menu item **Settings**, the plugin can be configured.

== The Settings menu ==

{{:de:2.0:documentation:plugins:kategoriereport:kategoriereport_einstellungen.png?300|}}

== Columns ==

{{:de:2.0:documentation:plugins:kategoriereport:kategoriereport_spalten.png?300|}}

== Options ==

{{:de:2.0:documentation:plugins:kategoriereport:kategoriereport_optionen.png?300|}}

== Access for the Plugin ==

{{:de:2.0:documentation:plugins:kategoriereport:kategoriereport_pluginfreigabe.png?300|}}

== Plugin Information ==

{{:de:2.0:documentation:plugins:kategoriereport:kategoriereport_plugininformationen.png?300 |}}



==== Known error messages ====

Under certain circumstances, the plugin stops with the error message "Maximum execution time exceeded". **This is not a programming error**. 

The interpreter shuts itself down because the script needs more time than is allocated to it. This can occur when there are many members, categories and roles have to be processed.

** Remedy: **

1. Option in php.ini

Using parameter max_execution_time in php.ini, you can choose the maximum duration of a PHP script in seconds.

<code php>
max_execution_time = 300;
</code>

2. Option in the script itself (kategoriereport_show.php)

If no safe_mode is enabled, a script can put itself a runtime limit using the set_time_limit () function.

<code php>
set_time_limit(300);
</code>