Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
de:plugins:formfiller [2023/02/18 17:29] – [Funktionsweise] rmbde:plugins:formfiller [2025/11/19 17:31] (current) – [Update] rmb
Line 1: Line 1:
 ====== FormFiller ====== ====== FormFiller ======
 **(Formular-Füller)** **(Formular-Füller)**
-==== Beschreibung ==== +===== Beschreibung ===== 
-Dieses Plugin ermöglicht es, PDF-Formulare mit Profildaten und Profilbildern von Mitgliedern, sowie beliebigen Texten und Bildern zu befüllen.+Dieses Plugin ermöglicht es, PDF-Dateien mit Profildaten und Profilbildern von Mitgliedern, sowie beliebigen Texten und Bildern zu befüllen.
  
 Die Erzeugung von Etiketten ist ebenfalls möglich. Für jedes verwendete PDF-Formular bzw. jede Etikettenvorlage wird eine eigene Konfiguration erzeugt. Die Erzeugung von Etiketten ist ebenfalls möglich. Für jedes verwendete PDF-Formular bzw. jede Etikettenvorlage wird eine eigene Konfiguration erzeugt.
Line 8: Line 8:
 Bei den PDF-Formularen kann es sich um unterschiedliche Arten von PDF-Dateien handeln, z.B. Beitrittserklärungen, SEPA-Lastschriftmandate, Einladungen, Serienbriefe oder Mitgliedsausweise.  Bei den PDF-Formularen kann es sich um unterschiedliche Arten von PDF-Dateien handeln, z.B. Beitrittserklärungen, SEPA-Lastschriftmandate, Einladungen, Serienbriefe oder Mitgliedsausweise. 
  
-==== Downloads ====+===== Downloads =====
 <WRAP download 60%> <WRAP download 60%>
-[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=8650da2f-42a9-45a2-9ecf-82bacadb0e6a|formfiller_3.2.0.zip]] - **(Admidio 4.2)** +[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=42e588a2-790c-457c-bfc9-562927a95f29|formfiller_4.0.1.zip]] - **(Admidio 5.0)** 
 </WRAP> </WRAP>
  
 Ältere Version:\\  Ältere Version:\\ 
 +[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=51811163-7ba1-472a-a94d-290c6ac17ca3|formfiller_3.3.2.zip]] - (Admidio 4.3)\\ 
 +[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=8650da2f-42a9-45a2-9ecf-82bacadb0e6a|formfiller_3.2.0.zip]] - (Admidio 4.2)\\ 
 +[[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=5b235b20-ff62-4d8d-8531-1d81d6bfec24|formfiller_3.1.0.zip]] - (Admidio 4.1)\\
 [[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=8dabd088-4d2f-465c-9530-19fc1dc4da4a|formfiller_3.0.3.zip]] - (Admidio 4.0)\\ [[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=8dabd088-4d2f-465c-9530-19fc1dc4da4a|formfiller_3.0.3.zip]] - (Admidio 4.0)\\
 [[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=a462b32f-24d1-47ef-b1c9-3b540cce517a|formfiller_2.3.7.zip]] - (Admidio 3.3)\\ [[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=a462b32f-24d1-47ef-b1c9-3b540cce517a|formfiller_2.3.7.zip]] - (Admidio 3.3)\\
Line 21: Line 24:
 [[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=164d9f64-55f5-424b-9bfa-3c9d1fbef3eb|formfiller_1.0.3.zip]] - (ab Admidio 2.4.4) [[https://www.admidio.org/intern/adm_program/modules/documents-files/get_file.php?file_uuid=164d9f64-55f5-424b-9bfa-3c9d1fbef3eb|formfiller_1.0.3.zip]] - (ab Admidio 2.4.4)
  
-==== Informationen ====+===== Informationen =====
 Betreut von: **[[https://www.admidio.org/forum/memberlist.php?mode=viewprofile&u=1506|rmb]] **\\  Betreut von: **[[https://www.admidio.org/forum/memberlist.php?mode=viewprofile&u=1506|rmb]] **\\ 
  
-Plugin-Version:     **3.2.0**\\ +Plugin-Version:     **4.0.0**\\ 
  
-Notwendige Admidio-Version:  **4.2**\\ +Notwendige Admidio-Version:  **5.0**\\ 
  
-Unterstützte Datenbanken:  **MySQL**\\ +Unterstützte Datenbanken:  **MySQL, PostgreSQL** (ab Admidio 4.3.14)\\ 
  
 Unterstützte Sprachen: **Deutsch (du), Deutsch (Sie), Englisch, Französisch** Unterstützte Sprachen: **Deutsch (du), Deutsch (Sie), Englisch, Französisch**
Line 36: Line 39:
 Sourcecode: [[https://github.com/rmbinder/FormFiller.git|GitHub]] Sourcecode: [[https://github.com/rmbinder/FormFiller.git|GitHub]]
  
-==== Screenshots ====+===== Screenshots =====
 {{:de:plugins:formfiller:formfiller_01.png?300|}}   {{:de:plugins:formfiller:formfiller_01.png?300|}}  
 {{:de:plugins:formfiller:formfiller_02.png?300|}} {{:de:plugins:formfiller:formfiller_02.png?300|}}
  
-==== Installation ==== +===== Installation ===== 
-  * Im Ordner adm_plugins einen neuen Ordner mit dem Namen formfiller erstellen +  * Entpacken der Datei FormFiller_x.x.x in den Ordner adm_plugins 
-  * Danach alle Dateien (und Ordner) des Ordners formfiller aus der entpackten Zip-Datei in diesen Ordner kopieren+  * Installation einer Pluginversion < 4.0.0 
-  Anschließend über das Admidio-Modul Menü einen Menüeintrag für FormFiller mit folgender URL erzeugen: /adm_plugins/formfiller/formfiller.php (Beim Erstellen dieses Menüeintrages wird dringend empfohlen, im Feld „Sichtbar für“ eine Rolle anzugeben). +     Über das Admidio-Modul Menü einen Menüpunkt für FormFiller mit folgender URL erzeugen:\\ /adm_plugins/formfiller/formfiller.php 
 +     * Die Installationsroutine wird beim ersten Start des Plugins ausgeführt 
 +  * Installation einer Pluginversion >= 4.0.0 
 +     * Zur Installation folgende PHP-Datei ausführen:\\ <deine-admidio-seite>/adm_plugins/FormFiller/system/install.php 
 +  
 + 
 +===== Update ===== 
 +  * Update von Pluginversion 3.x auf Pluginversion 3.y 
 +    * Alle Dateien des vorhandenen Pluginordners durch die Dateien der neuen Version ersetzen. 
 +  * Update von einer Pluginversion 3.x auf Pluginversion >= 4.0.0 
 +    * Den vorhandenen Pluginordner löschen 
 +    * Entpacken der Datei FormFiller_4.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/FormFiller/system/install.php 
 + 
 + 
 +===== Änderungshistorie ===== 
 +//4.0.1 (19.11.2025)// 
 +  * [[https://github.com/rmbinder/FormFiller/issues?q=milestone%3Av4.0.1|Alle Änderungen dieser Version auf GitHub]] 
 + 
 +//4.0.0 (16.11.2025)// 
 +  * [[https://github.com/rmbinder/FormFiller/issues?q=milestone%3Av4.0.0|Alle Änderungen dieser Version auf GitHub]] 
 + 
 +//3.3.2 (13.02.2025)// 
 +  * [[https://github.com/rmbinder/FormFiller/issues?q=milestone%3Av3.3.2|Alle Änderungen dieser Version auf GitHub]] 
 + 
 +//3.3.1 (01.06.2024)// 
 +  * [[https://github.com/rmbinder/FormFiller/issues?q=milestone%3Av3.3.1|Alle Änderungen dieser Version auf GitHub]]
  
-==== Update ==== +//3.3.0 (16.01.2024)// 
-  * Zuerst alle Dateien im Pluginverzeichnis von FormFiller löschen. +  * [[https://github.com/rmbinder/FormFiller/issues?q=milestone%3Av3.3.0|Alle Änderungen dieser Version auf GitHub]]
-  * Danach alle Dateien (und Ordner) des Ordners formfiller aus der entpackten Zip-Datei in das Pluginverzeichnis kopieren.+
  
-==== Änderungshistorie ==== 
 //3.2.0 (18.02.2023)// //3.2.0 (18.02.2023)//
   * [[https://github.com/rmbinder/FormFiller/issues?q=milestone%3Av3.2.0|Alle Änderungen dieser Version auf GitHub]]   * [[https://github.com/rmbinder/FormFiller/issues?q=milestone%3Av3.2.0|Alle Änderungen dieser Version auf GitHub]]
Line 139: Line 167:
  
  
-==== Funktionsweise ====+===== Funktionsweise =====
 FormFiller erstellt PDF-Dokumente mit den Profildaten von Mitgliedern sowie mit beliebigen Texten oder auch Bildern. Die Mitglieder können entweder namentlich ausgewählt oder anhand einer vorher definierten „Eigenen Liste“ bestimmt werden. Beim Drucken unterscheidet FormFiller zwischen Formulardruck (feste X-Y-Koordinaten) und Etikettendruck (relative X-Y-Koordinaten). FormFiller erstellt PDF-Dokumente mit den Profildaten von Mitgliedern sowie mit beliebigen Texten oder auch Bildern. Die Mitglieder können entweder namentlich ausgewählt oder anhand einer vorher definierten „Eigenen Liste“ bestimmt werden. Beim Drucken unterscheidet FormFiller zwischen Formulardruck (feste X-Y-Koordinaten) und Etikettendruck (relative X-Y-Koordinaten).
  
Line 197: Line 225:
 === Menü Einstellungen === === Menü Einstellungen ===
  
-Das Menü **Einstellungen** ist über den, nur für Administratoren sichtbaren Link "Einstellungen"rechts oben im Hauptmenü anwählbar. Es ist in drei Menüpunkte unterteilt. +Das Menü **Einstellungen** ist über den, nur für Administratoren sichtbaren, gleichnamigen Button anwählbar.\\
- +
-  * Konfigurationen +
-  * Optionen +
-  * Plugininformationen+
  
 {{:de:plugins:formfiller:standardansicht-einstellungen.png?300}} {{:de:plugins:formfiller:standardansicht-einstellungen.png?300}}
 {{:de:plugins:formfiller:menue-einstellungen.png?300}} {{:de:plugins:formfiller:menue-einstellungen.png?300}}
  
-=== Menüpunkt Konfigurationen === +=== Menüpunkt Konfigurationen-Editieren === 
-Über Konfigurationen können beliebig viele Formularkonfigurationen erstellt werden. Nach einer Neuinstallation sind drei Musterkonfigurationen voreingestellt und mit Standardwerten befüllt:+Über Editieren können beliebig viele Formularkonfigurationen erstellt werden. Nach einer Neuinstallation sind drei Musterkonfigurationen voreingestellt und mit Standardwerten befüllt:
  
   * Musterformular   * Musterformular
Line 297: Line 321:
 ^           |Schriftgröße                   (S)ize            |S=16    |Schriftgröße in Punkt| ^           |Schriftgröße                   (S)ize            |S=16    |Schriftgröße in Punkt|
 ^           |Schriftfarbe                   (C)olor            |C=0,0,255    |Schriftfarbe als RGB-Wert (Rot-Grün-Blau)| ^           |Schriftfarbe                   (C)olor            |C=0,0,255    |Schriftfarbe als RGB-Wert (Rot-Grün-Blau)|
 +^           |Ausrichtung   |ohne Funktion bei Verwendung von Parametern für einen Zeilenumbruch                 (O)rientation       |O=C    |Mögliche Werte: C (=zentriert) oder R (=rechtsbündig)|
 ^           |Text   |nur bei Options-/Dropdownfeldern (z.B. Geschlecht) |   (T)ext            |T=Herrn,Frau    |   | ^           |Text   |nur bei Options-/Dropdownfeldern (z.B. Geschlecht) |   (T)ext            |T=Herrn,Frau    |   |
 ^           |Vortext        |                             |{=Hallo    | | ^           |Vortext        |                             |{=Hallo    | |
Line 311: Line 336:
 ^   OI         |Index für den Druck              |   (O)rder(I)ndex            |OI=4    |   | ^   OI         |Index für den Druck              |   (O)rder(I)ndex            |OI=4    |   |
 ^   OW         |Zeilenabstand im mm              |   (O)rder(W)idth            |OW=10    |   | ^   OW         |Zeilenabstand im mm              |   (O)rder(W)idth            |OW=10    |   |
 +^   WL         |Wortlänge             |bei allen Texten      |   (W)ordwrap(L)ength     |WL=35    |Verwendung beim Zeilenumbruch   |
 +^   CL         |Zeichenlänge          |bei allen Texten      |   (C)haracterwrap(L)ength     |CL=25    |Verwendung beim Zeilenumbruch   |
 +^   WW         |Zeilenabstand         |nur in Verbindung mit WL oder CL      |   (W)ordwrap(W)idth     |WW=10    |Standardeinstellung: 5   |
 +^   WM         |max. Anzahl der Zeilen     |nur in Verbindung mit WL oder CL         (W)ordwrap(M)ax     |WM=3    |Standardeinstellung: 1   |
  
 Verwendung und Auswirkung des Druckparameters "P" bei ein- und mehrseitigen PDF-Dateien: \\ Verwendung und Auswirkung des Druckparameters "P" bei ein- und mehrseitigen PDF-Dateien: \\
Line 404: Line 433:
 Der Parameter OI=x kann nur bei Feldern mit absoluten Koordinatenangaben verwendet werden (z.B. Text an Pos X/Y oder Line von Pos X/Y nach Pos X2/Y2). OI=x funktioniert nicht bei Rechtecken oder Bildern, da bei ihnen X2 und Y2 relative Werte sind. Der Parameter OI=x kann nur bei Feldern mit absoluten Koordinatenangaben verwendet werden (z.B. Text an Pos X/Y oder Line von Pos X/Y nach Pos X2/Y2). OI=x funktioniert nicht bei Rechtecken oder Bildern, da bei ihnen X2 und Y2 relative Werte sind.
  
-=== Menüpunkt Optionen === +**Zeilenumbruch**
-Über Optionen können Einstellungen für die Anzeige der erstellten PDF-Dokumente festgelegt und die Deinstallation durchgeführt werden.+
  
 +Speziell für lange Texte gibt es den Zeilenumbruch. Mit den Parametern WL, CL, WW und WM ist es möglich, einen Text in einzelne Segmente aufzusplitten und untereinander auszugeben.
 +  * WL = Wortlänge
 +  * CL = Zeichenlänge
 +  * WW = Zeilenabstand (Standard: 5)
 +  * WM = max. Anzahl der Zeilen (Standard: 1).
 +
 +Beispiel 1:
 +
 +⇒ ...;WL=15;WW=5;WM=3\\
 +⇒ Nach max. 15 Zeichen erfolgt ein Zeilenumbruch, wobei einzelne Wörter nicht getrennt werden. Der Zeilenabstand beträgt 5 mm und es werden maximal 3 Zeilen ausgegeben.\\
 +
 +Neuhofen a.d. Krems\\
 +wird zu\\
 +Neuhofen a.d.\\
 +Krems\\
 +
 +Beispiel 2:
 +
 +⇒ ...;CL=15;WW=5;WM=3\\
 +⇒ Nach 15 Zeichen erfolgt ein Zeilenumbruch. Der Zeilenabstand beträgt 5 mm und es werden maximal 3 Zeilen ausgegeben.\\
 +
 +Das ist ein Mustertext\\
 +wird zu\\
 +Das ist ein Mus\\
 +tertext\\
 +
 +=== Menüpunkt Konfigurationen-Sortieren ===
 +Hier können Konfigurationen alphabetisch und nach XY-Koordinaten sortiert werden.
 +
 +=== Menüpunkt Konfigurationen-Export/Import ===
 +Über Export/Import können Konfigurationen sowohl exportiert als auch importiert werden
 +(Beispielkonfigurationen gibt es auf [[https://github.com/rmbinder/FormFiller/releases]]).\\
 +{{:de:plugins:formfiller:export_import.png?300}}
 +
 +=== Menüpunkt System-Informationen ===
 +Hier werden Informationen zur Version und zum Stand des Plugins angezeigt.\\
 +{{:de:plugins:formfiller:plugininformationen.png?300}}
 +
 +=== Menüpunkt System-Optionen ===
 +Über Optionen können Einstellungen für die Anzeige der erstellten PDF-Dokumente festgelegt und die Deinstallation durchgeführt werden.\\
 {{:de:plugins:formfiller:optionen.png?300}} {{:de:plugins:formfiller:optionen.png?300}}
  
Line 415: Line 483:
 Hier können neben den Standardgrößen A3, A4 usw. zusätzliche Größen für das zu erzeugende PDF-Dokument angegeben werden. Mehrere Größen sind durch Semikolon zu trennen (z.B. 160x100;120x60). Hier können neben den Standardgrößen A3, A4 usw. zusätzliche Größen für das zu erzeugende PDF-Dokument angegeben werden. Mehrere Größen sind durch Semikolon zu trennen (z.B. 160x100;120x60).
  
-== Export/Import == +=== Menüpunkt System-Deinstallation == 
-Über Export/Import können Konfigurationen sowohl exportiert als auch importiert werden +Über die Deinstallation können alle vom Plugin erstellten Konfigurationsdaten wieder gelöscht werden.\\ 
-(Beispielkonfigurationen gibt es auf [[https://github.com/rmbinder/FormFiller/releases]]). +
- +
-{{:de:plugins:formfiller:export_import.png?300}} +
- +
-== Deinstallation == +
-Über die Deinstallation können alle vom Plugin erstellten Konfigurationsdaten wieder gelöscht werden.  +
 {{:de:plugins:formfiller:deinstallation.png?300}} {{:de:plugins:formfiller:deinstallation.png?300}}
 {{:de:plugins:formfiller:deinstallation-hinweis.png?300}} {{:de:plugins:formfiller:deinstallation-hinweis.png?300}}
  
-=== Menüpunkt Plugininformationen === +=== Menüpunkt Sicherheit-Zugriffsberechtigung für Einstellungen === 
- +Hier können, zusätzlich zur Rolle "Administrator", weitere Rollen für den Zugriff auf das Modul "Einstellungen" berechtigt werden.
-{{:de:plugins:formfiller:plugininformationen.png?300}} +
- +
-Hier werden Informationen zur Version und zum Stand des Plugins angezeigt.+
  
 === Die Speicherung der Konfiguration === === 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. 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 
-   * Geburtstagsliste 
-   * FormFiller 
-   * KeyManager 
-   * DeclarationOfMembership (Online-Beitrittserklärung) 
  
 Die Tabelleneinträge des Plugins FormFiller beginnen hierbei alle mit den Buchstaben "PFF". Die Tabelleneinträge des Plugins FormFiller beginnen hierbei alle mit den Buchstaben "PFF".
  • de/plugins/formfiller.1676737768.txt.gz
  • Last modified: 2023/02/18 17:29
  • by rmb