About this plugin
This plugin creates form tags for Contact Form 7 and form fields for WPForms.
Contact Form 7
4 form-tags (and corresponding mail-tags) are available in this version:
* [comune]: creates a series of select for the selection of an Italian municipality
* [cf]: creates a field for entering the Italian tax code of a natural person
* [stato]: creates the ability to select a country
* [formsign]: creates the possibility to digitally sign the e-mails sent with a private key attributed to each individual form
WPForms
2 fields types are available:
* Cascade selection of an Italian municipality (returning Istat’s municipality code as value)
* A field to select a state (returning Istat’s country code as value)
Data used
it). This data can be updated from the administration console, which also shows when ISTAT has published changes.
Downloading and entering data into the database takes a few minutes: be patient during the activation phase.
org/plugins/regione-provincia-comune/
This plugin uses data made available by ISTAT through the SITUAS portal.
In particular, data from these SITUAS reports are acquired and stored:
- List of codes and names of the territorial units (current municipalities)
- Suppressed or ceded municipalities
- Administrative and territorial changes since 1991
- List of codes and names of the foreign territorial units (countries)
The list of foreign countries ceased since 1990 is distributed with the plugin; an automated test checks it against the SITUAS report of historical foreign countries.
it/it/note-legali
The cadastral codes of the municipalities, used to check the place of birth in the tax code, are published by ISTAT as an elaboration on data of the Agenzia delle entrate (Italian revenue agency).
By Italian law (art. lgs. 82/2005) all data, that are not personal data, published by an Italian administration without an explicit license are open data (CC0).
This plugin uses the cadastral codes exclusively for the purpose of carrying out a formal regularity check of the personal tax code.
This plugin does not include any links to the ISTAT’s website on the external pages of the website on which it is used; in particular, no kind of direct link is made, nor of deep linking.
How to use form tags in Contact Form 7
[comune]
[comune] has a manager in the CF7 form creation area that allows you to set various options.
In particular, it is possible to set the “kind” attribute to “tutti” (all); “attuali” (current), “evidenza_cessati” (evidence ceased). In the first and third cases, in different ways, both the currently existing municipalities and those previously closed are proposed (useful, for example, to allow the selection of the municipality of birth).
In the “attuali” mode, however, only the selection of the currently existing municipalities is allowed (useful to allow the selection of the Municipality of residence / domicile).
It is also possible to set the “comu_details” option, to show an icon after the select cascade that allows the display of a modal table with the statistical details of the territorial unit.
The value returned by the group is always the ISTAT code of the selected municipality. The corresponding mail-tag converts this value into the name of the municipality followed by the indication of the automotive code of the province.
1 hidden fields are also populated with the strings corresponding to the denomination of the region, province and municipality selected, useful for being used in plugins that directly capture the data transmitted by the form (such as “Send PDF for Contact Form 7” )
The cascade of select can also be used outside of CF7, using the [comune] shortcode (options similar to those of the form tag for Contact Form 7).
0 there is a new filters’ builder for the field [comune] useful for creating fields that allow the selection of a customizable list of municipalities.
Filters can be used both for CF7 tag, and for WPForms field, and for the shortcode ‘comune’.
A short youtube video illustrates how to use filters and the filters’ builder.
[cf]
[cf] has a manager in the CF7 form creation area that allows you to set the various options.
In particular, it is possible to set various validation options allowing you to find the correspondence of the tax code with other fields of the form.
Specifically, it is possible to verify that the tax code corresponds with the foreign state of birth (selected by means of a select [stato]), the Italian municipality of birth (selected by means of a cascade of select [comune]), gender (indicating the name of a form field that returns “M” or “F”), the date of birth. If multiple fields are used to select the date of birth, one for the day, one for the month and one for the year, it is possible to find the correspondence of the tax code with these values.
[stato]
[stato] has a manager in the CF7 form creation area that allows you to set various options.
In particular, it is possible to set the selection of only the currently existing states (“only_current” option) and it is possible to set the “use_continent” option to have the select values divided by continent. The field always returns the ISTAT code of the foreign state (code 100 for Italy). The ISTAT code is the type of data expected by [cf], for the verification of the tax code.
[formsign]
[formsign] NOW (v. 1) has a manager in the CF7 form creation area.
To use it, simply insert the tag followed by the field name in your own form: for example [formsign firmadigitale]. This tag will create a hidden field in the form with attribute name = “firmadigitale” and no value.
To use the code, it is also necessary to insert the [firmadigitale] mail-tag in the email or emails that the form sends (it is recommended at the end of the email).
In this way, in the email body it will be written a two-lines sequence containing:
an md5 hash of the data transmitted with the module (not of the content of any attached files)
a digital signature of the hash.
If you use html email, you can style the output using a wp option named: “gcmi-forsign-css” with a css as value.
The signature is affixed by generating a pair of RSA keys, attributed to each form.
By checking the hash and the signature, it will be possible to verify that the emails have actually been sent by the form and that the data transmitted by the user correspond to what has been registered.
To facilitate data feedback, it is preferable to use “Flamingo” for archiving sent messages. In fact, in the Flamingo admin screen, a specific box is created that allows feedback of the hash and the digital signature entered in the email.
The system is useful in the event that through the form it is expected to receive applications for registration or applications etc… and avoids disputes regarding the data that the candidates claim to have sent and what is recorded by the system in Flamingo.
Code
Want to check the code? com/MocioF/campi-moduli-italiani