no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
Next revision | |||
— | en:plugins:formfiller [2015/12/22 13:56] – created thomas-rcv | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== FormFiller ====== | ||
+ | ==== Beschreibung ==== | ||
+ | This plugin makes it possible to fill PDF forms with the profile data and the profile image of members. | ||
+ | |||
+ | Form Filler can either create a single PDF document (on the profile data of a member based) as well as multiple documents (based on a created in Admidio list). The production of labels is also possible. For each used PDF form or each label template its own configuration is applied. | ||
+ | |||
+ | In the PDF form, there may be different types of PDF files, for example, accessions, SEPA direct debit mandates, invitations or membership cards. | ||
+ | |||
+ | ==== Downloads ==== | ||
+ | [[http:// | ||
+ | |||
+ | ==== Information ==== | ||
+ | Supported by: **[[http:// | ||
+ | |||
+ | Plugin-Version: | ||
+ | |||
+ | Required Admidio-Version: | ||
+ | |||
+ | Supported databases: | ||
+ | |||
+ | Supported languages: **Deutsch (du), Deutsch (Sie), Englisch** | ||
+ | |||
+ | License: **GPL 2** | ||
+ | |||
+ | Older Version: | ||
+ | |||
+ | ==== Screenshots ==== | ||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | ==== Installation ==== | ||
+ | * The folder adm_plugins create a new folder named formfiller | ||
+ | * Then copy all files (and folders) in the folder formfiller from the unzipped Zip file. | ||
+ | * Recently even insert the link to the plugin in the file my_body_bottom.php. | ||
+ | |||
+ | ^There are two different ways:^^ | ||
+ | |If you want to display the link to Form Filler in existing modules:|If you want the link to Form Filler appear in a separate Plugins menu:| | ||
+ | |{{: | ||
+ | |Add before command " | ||
+ | |include(SERVER_PATH."/ | ||
+ | |::: | ||
+ | |::: | ||
+ | |||
+ | ==== Update ==== | ||
+ | * First, delete all files in the plugin directory of Form Filler. | ||
+ | * Then continue as described in Installation. | ||
+ | |||
+ | ==== History ==== | ||
+ | //2.0.1 (02.11.2015)// | ||
+ | * Error (caused by the method add headline) resolved | ||
+ | |||
+ | //2.0.0 (27.05.2015)// | ||
+ | * Compatible with Admidio 3.0 | ||
+ | * Created uninstall routine | ||
+ | * Modified method for integrating the plugin (include) | ||
+ | * Menu names adapted (identical with other plugins) | ||
+ | * Internal only: management of configuration data changed | ||
+ | |||
+ | //1.0.3 (04.12.2014)// | ||
+ | * Print possibility of profile photo and current date | ||
+ | |||
+ | //1.0.2 (07.05.2014)// | ||
+ | * Implemented production of multiple documents about new module list choice | ||
+ | |||
+ | //1.0.1 (30.04.2014)// | ||
+ | * Call the plugin via the Menu class implemented (System requirements now Admidio version 2.4.4 or higher) | ||
+ | |||
+ | //1.0.0 (14.04.2014)// | ||
+ | |||
+ | ==== Operation ==== | ||
+ | Form Filler can either create single documents (with the profile data of an individual member) and also multiple document (with the profile data of several members). A distinction is made between form printing (solid XY coordinates) and label printing (relative XY coordinates). | ||
+ | |||
+ | === Definition " | ||
+ | |||
+ | If via the user administration the profile of a member is called, all created configurations are displayed in list form below the menu item Form Filler. When clicking on a configuration formfiller reads the browser address line, extracts the user_id of the member and produces the data by this member a single PDF document. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | In the above example, three configurations are displayed (standard form, envelope DL and address labels). These are also the sample configurations created in a new installation. | ||
+ | |||
+ | === Definition " | ||
+ | |||
+ | Even the creation of multiple documents is possible with formfiller. Multiple Document means that the data of several members | ||
+ | |||
+ | The menu item form filler module for multiple documents is called. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Click on the button " | ||
+ | |||
+ | If " | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | === Definition "Print form" === | ||
+ | |||
+ | Form pressure within the meaning of Form Filler means that the filling in a PDF form is performed using fixed XY coordinate. The details for X and Y define here the horizontal and vertical position in millimeters relative to the upper left corner of the PDF form. | ||
+ | Example:\\ | ||
+ | {{: | ||
+ | |||
+ | In the above example, the first name of the member is 60 millimeters and 80 millimeters to the right down, counted from the upper left corner of the form is written. The last name is 100 millimeters to the right and 80 mm downwards, also counted from the upper left corner of the form is written. | ||
+ | |||
+ | ⇒ Surname and first name are in the same row (80 mm)\\ | ||
+ | ⇒ First name (at 60mm) stands in front of Surname (bei 100mm) | ||
+ | |||
+ | Further information on this topic can be found in " | ||
+ | |||
+ | === Definition "label printing" | ||
+ | |||
+ | Label printing within the meaning of Form Filler means the smallest X coordinate of a line defines the start of printing. All other X-coordinate of a line used exclusively for sorting. | ||
+ | |||
+ | Example:\\ | ||
+ | {{: | ||
+ | |||
+ | With form printing, the printed image would appear as follows: (always relative to the upper left corner of the form) | ||
+ | * Gender (Informal) to position 20,30 (20 millimeters to the right and 30 mm downwards) | ||
+ | * First name at item 25,30 (25 millimeters to the right and 30 mm downwards) | ||
+ | * Surname at position 26,30 (26 millimeters to the right and 30 mm downwards) | ||
+ | |||
+ | ⇒ The last name here would begin a millimeter to the right of first name and this would almost completely overwrite it. | ||
+ | |||
+ | However, if label printing is set, the printed image is as follows: | ||
+ | * Gender first name last name // (each separated by a space)// | ||
+ | |||
+ | ⇒ Smallest X coordinate in the example is 20, that is, gender (= Heading) determines the start of printing at position 20,30 (20 millimeters to the right and 30 mm downward, relative to the upper left corner of the form). First name and surname are, separately, added by a space. | ||
+ | |||
+ | Further information on this topic can be found in " | ||
+ | |||
+ | === Menu settings === | ||
+ | |||
+ | The menu **settings** is selected via the Settings link, top right of the default view. It is divided into four menu items. | ||
+ | |||
+ | * Configuration | ||
+ | * Options | ||
+ | * Plugin enable | ||
+ | * Plugin information | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | === Menu configurations === | ||
+ | Concerning configurations any number of PDF forms or label templates can be created. After a new installation three sample configurations are preset and filled with default values: | ||
+ | |||
+ | * Sample Form | ||
+ | * Envelope DL | ||
+ | * mailing labels | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | == Designation == | ||
+ | The designation field is a mandatory field and to be filled ever. When displaying or editing the profile of a member this designation appears as a link. You can delete a configuration by deleting the contents of the field name, and then press the Save button. | ||
+ | |||
+ | == Font, font style, font size and color == | ||
+ | The font attributes set here (type, style, size and color) apply to all profile fields the same configuration. | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | == PDF-File == | ||
+ | Concerning PDF file, a PDF form is selected and assigned to this configuration. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | To enable Form Filler can access PDF forms, they must be uploaded beforehand in the Downloads section Admidio //(Hinweis: Die Auswahl für eine PDF-Datei wird erst am Bildschirm angezeigt, wenn mindestens eine Datei in den Downloads-Bereich hochgeladen wurde)//. Wird für eine Konfiguration kein PDF-Formular ausgewählt, | ||
+ | |||
+ | == Labels == | ||
+ | To print labels the following information in the labels box are required: the number of columns, column spacing, number of lines, line spacing. | ||
+ | |||
+ | Example:\\ | ||
+ | {{: | ||
+ | Here the label printing would look like this: | ||
+ | * 3 Labels across (3 colums), at a distance of 70 mm (column spacing) | ||
+ | * 7 Labels across (7 lines), at a distance of 25 mm (line spacing) | ||
+ | |||
+ | If the labels field is filled, the XY position information of formfiller will be interpreted in another way: First formfiller sorts all profile fields using the position data after line (Y-coordinate) and column (X-coordinate). Then the smallest X coordinate of a line is determined. This smallest X coordinate defines the start of printing. All other X-coordinate on the same line used exclusively for sorting. | ||
+ | |||
+ | Example: | ||
+ | {{: | ||
+ | |||
+ | Smallest X-coordinate for the row 30 in the above example is 20, that is print start of the line 30 is at position 20,30. | ||
+ | |||
+ | The profile fields are printed as follows: | ||
+ | Informal first name last name | ||
+ | |||
+ | Note: To write a single address label in a PDF document (for example, mail merge with invitations, | ||
+ | |||
+ | == Field selection == | ||
+ | Concerning Field selection any number of profile fields can be added to a configuration.\\ | ||
+ | {{: | ||
+ | |||
+ | To write the data of a profile image in a PDF document at least one X and one Y coordinate have to be specified. The details for X and Y define here the horizontal and vertical position in millimeters, | ||
+ | |||
+ | {{: | ||
+ | |||
+ | To highlight individual profile fields, further instructions can also be specified in addition to the X and Y coordinate. Several additional instructions here are separated by semicolons. | ||
+ | |||
+ | Syntax:\\ | ||
+ | |Font: | ||
+ | |Font style: | ||
+ | |Font size: |S=<Size in Pixel> | ||
+ | |Font color: | ||
+ | |Gender: | ||
+ | |||
+ | | ||
+ | | **Profile Filed** | ||
+ | |Surname | ||
+ | |Firstname | ||
+ | |Address | ||
+ | |Gender | ||
+ | |||
+ | |||
+ | //Special profile box Gender// | ||
+ | |||
+ | To identify the gender of a member in forms or to change the text " | ||
+ | |||
+ | Syntax: | ||
+ | X1, | ||
+ | |||
+ | or | ||
+ | |||
+ | X,Y; T=<Text for male>,< | ||
+ | |||
+ | Example: | ||
+ | |||
+ | 1. Case: | ||
+ | In one form the following fields are available: {{: | ||
+ | |||
+ | * the rectangle of Male is located at coordinates 60,50 | ||
+ | * the rectangle of female located on coordinate 80,50 | ||
+ | |||
+ | Depending on the gender to be male or female marked with an X. | ||
+ | |||
+ | Syntax: | ||
+ | 60, | ||
+ | |||
+ | Result: | ||
+ | If the member is male, so an X is written at position 60,50, the member is female, an X is written at position 80.50 | ||
+ | |||
+ | 2. Case: | ||
+ | For labels should, regardless of gender, the text " | ||
+ | |||
+ | Syntax: | ||
+ | 70, | ||
+ | |||
+ | Result: | ||
+ | If the member is male, so the text Lord at position 70,40 is written, the member is female, so women will be written at the same position of the text. | ||
+ | |||
+ | |||
+ | //The additional fields Date, profile photo and text// | ||
+ | |||
+ | In addition to the profile fields the current date, the profile picture of the member can be displayed (if any) as well as any text can be inserted into the PDF document. | ||
+ | |||
+ | Syntax: | ||
+ | | **Field** | ||
+ | |Date |10, | ||
+ | |Date |10,40;D=d. F Y |Current date in format < | ||
+ | |Date |17, | ||
+ | |Profile photo |40, | ||
+ | |Profile photo |40, | ||
+ | |Profile photo |40, | ||
+ | |Profile photo |40, | ||
+ | |Text |10, | ||
+ | |||
+ | Supported image formats: | ||
+ | * JPEG (Joint Photographic Experts Group) | ||
+ | * PNG (Portable Network Graphics) | ||
+ | * GIF (Graphics Interchange Format) | ||
+ | |||
+ | === Menu Options === | ||
+ | Concerning Options preferences for displaying the created PDF documents can be set and uninstallation can be performed. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | == max. PDF-Display == | ||
+ | PDF display is the maximum number of pages that must have a PDF document (creation of multiple documents) so that it appears on the screen yet. Is the number of pages is greater, the download of the file is available immediately. | ||
+ | |||
+ | == Uninstall == | ||
+ | Concerning uninstall all created configuration files can be deleted. | ||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | === Menu Enable Plugin === | ||
+ | Selection of roles, their families may call the plugin. The plugin and the settings menu can be unlocked separately for specific roles. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Note: A selected role also requires at least one of the following permissions in the Admidio Rle Management : | ||
+ | |||
+ | * " | ||
+ | * "Edit profile data of all users" | ||
+ | * " | ||
+ | |||
+ | === Menu Plugin information === | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Here information about the version and the state of the plugin will be displayed. | ||
+ | |||
+ | === Storing the Configurations === | ||
+ | All configuration data is stored in a table named adm_plugin_preferences in Admidio database. Should not exist this table, it is created. | ||
+ | |||
+ | Currently, in this table, the following configurations plugins are stored: | ||
+ | * Membership fee | ||
+ | * Category report | ||
+ | * Birthday list | ||
+ | * Form Filler | ||
+ | |||
+ | The table entries of plugins Form Filler all begin here with the letters " | ||
+ | |||
+ | === File readme.txt === | ||
+ | Current information regarding update or reinstall the plugin are located in the file readme.txt. | ||
+ | |||
+ | === Examples === | ||
+ | Below are some examples of filled formfiller PDF forms: | ||
+ | |||
+ | | Pattern of an instrument of accession: | ||
+ | |{{: | ||
+ | |||
+ | | Pattern of a membership card: | The data filled membership card: | | ||
+ | |{{: | ||
+ | |||
+ | | Pattern of a SEPA Direct Debit Mandate: | ||
+ | |{{: |