jqueryalmeida / contact-form-7-modules Goto Github PK

=== Contact Form 7 Modules ===
Tags: Contact Form 7, cf7, Contact Forms 7, hidden fields, all fields
Requires at least: 2.8
Tested up to: 4.7.2
Stable tag: trunk
Contributors: katzwebdesign, katzwebservices
Donate link: https://katz.co/contact-form-7-hidden-fields/
License: GPLv2 or later

Contact Form 7 - Add useful modules such as hidden fields and "send all fields" to the Contact Form 7 plugin

== Description ==

### Add Hidden Fields to Contact Form 7

The Contact Form 7 plugin has over <em>1 million</em> active installations, yet the great plugin still lacks a simple feature: <strong>hidden fields</strong>. This plugin adds hidden fields to Contact Form 7 once and for all.

#### Inserting dynamic values

You can also choose to have the value of the hidden field dynamically populated in your form when you are contacted. To do so, choose the "Default value" to be:

* `post_title` - Inserts the title of the post/page
* `post_category` - The categories of the post or page
* `post_url` - The URL of the post or page
* `post_author` - The author of the post or page
* `custom_field-[Name]` - The value of a post or page's custom field. If you had a custom field "Foo", you would use the following as the hidden field value: `custom_field-Foo`

The following values will be replaced if an user is logged in:

* `user_name`: User Login
* `user_id`: User ID
* `user_email`: User Email Address
* `user_display_name`: Display Name (Generally the first and last name of the user)
* `user_url`: User Website

And you can also use it for user custom meta data using the format of `user-{field}`:

* `user-aim`: AIM
* `user-jabber`: Jabber / Google Talk
* `user-description`: User Bio

<strong>You can also use a filter:</strong> hook into the `wpcf7_hidden_field_value` filter to modify the value of the hidden field  using <a href="http://codex.wordpress.org/Function_Reference/add_filter" rel="nofollow"><code>add_filter()</code></a>. If you know the ID of the input, you can also use the `wpcf7_hidden_field_value_[#ID]` filter.

Now, when someone contacts you using your Contact Form 7 contact form, you can have lots more information about their visit - and you'll see it when you receive the email that tells you you've been contacted.

### Easily Send All Submitted Fields At Once

####Save time setting up your form emails...and never miss a field!

One of the limitations of Contact Form 7 is that you need to manually add each field to generated emails. This means that if you update the form with a new field and forget to add it to your email message, you won't receive it in your email. <strong>No longer.</strong>.

Using the <strong>Send All Fields</strong> module, you simply need to add `[all-fields]` to your message, and you will receive every field submitted. If you use HTML formatting, the formatting even looks nice.

<h4>Visit the official <a href="https://katz.co/contact-form-7-hidden-fields/">Contact Form 7 Modules plugin page</a> for more support & additional information</h4>

== Installation ==

1. Upload plugin files to your plugins folder, or install using WordPress' built-in Add New Plugin installer
1. Activate the plugin
1. Edit a form in Contact Form 7
1. Choose "Hidden field" from the Generate Tag dropdown
1. Follow the instructions on the page

== Screenshots ==

1. The Hidden fields tag generator
2. The `[all-fields]` Mail tag

== Frequently Asked Questions ==

= How do I turn off formatting the key in the `[all-fields]` output? =
Add the following to your theme's `functions.php` file:

`
add_filter('wpcf7_send_all_fields_format_key', '__return_false');
`

= How do I set non-standard user data as hidden field values? =

Starting with Version 1.4, you can access user data, including meta data.

You need to set the default value as: `user-{meta_key}` where `{meta_key}` is the key of the meta field you want the value of.

To get the values of WordPress default profile fields, for example, you would use:

* `user-aim` - AOL
* `user-jabber` - Jabber / Google Talk
* `user-description` - Biographical description

= What is the plugin license? =

* This plugin is released under a GPL license.

= How do I send empty values with the `[all-fields]` shortcode? =

Add this to your `functions.php` file: `add_filter('wpcf7_send_all_fields_send_empty_fields', '__return_true');`

= How do I modify the output of the `[all-fields]` shortcode? =

* `wpcf7_send_all_fields_format_before` - Before the loop of fields (`<dl>` for HTML output)
	* `$value` _string_ Previous output
	* `$format` _string_ Either "html" or "text"
* `wpcf7_send_all_fields_format_item` - Change each item output. Passes four arguments:
	* `$value` _string_ Previous output
	* `$k` _string_ Field label
	* `$v` _string_ Value of the field
	* `$format` _string_ Either "html" or "text"
* `wpcf7_send_all_fields_format_after` - After the loop of fields (`</dl>` for HTML output). Passes two arguments:
	* `$value` _string_ Previous output
	* `$format` _string_ Either "html" or "text"

== Changelog ==

= 2.0.1 & 2.0.2 on February 1, 2017 =

* Confirmed compatibility with WordPress 4.7.2
* Updated to work with Contact Form 7 4.6
    * Fixed: `[hidden]` shortcodes not being replaced in emails
    * Fixed: PHP warning related to deprecated function
* Fixed: Removed use of deprecated `get_currentuserinfo()` function
* Updated translations

= 2.0 on June 28, 2015 =
* **Requires Contact Form 7 4.2 or higher**
* Updated to work with latest Contact Form 7
* Removed Contact Form 7 Newsletter plugin promotion

= 1.4.2 on March 25, 2014 =
* Added: `[all-fields]` shortcode now skips sending data for empty fields
	* Added `wpcf7_send_all_fields_send_empty_fields` filter to override the setting. See the FAQ.
* Added: `[all-fields]` shortcode output filters (see the FAQ item "How do I modify the output...")
	* `wpcf7_send_all_fields_format_before`
	* `wpcf7_send_all_fields_format_item`
	* `wpcf7_send_all_fields_format_after`

= 1.4 & 1.4.1 on March 15, 2014 =
* Added: Internationalization support. [Help translate the plugin!](https://www.transifex.com/projects/p/contact-form-7-modules/)

__The below updates apply only to the Hidden Fields module.__

* Added: Support for retrieving other user data by using the field name `user_{data you want}`. See the FAQ "How do I set non-standard user data as hidden field values?"
* Added: `wpcf7_hidden_field_implode_glue` filter. If you want to modify how arrays of data get combined into a string (default is CSV), use this filter.
* Fixed: `$post` global no longer needs to be defined for user data to be successfully passed.
* Fixed: Now supports multiple post `custom_field` data values, instead of only fetching one
* Modified: Added callback function to format the hidden field instead of relying on depricated PHP
* Modified: Improved include path for `functions.php` file
* Modified: Added text to support additional localization

= 1.3.3 =
* Hidden Fields: Fixed issue that broke the plugin with WordPress 3.8.

= 1.3.2 =
* Hidden Fields: Fixed PHP notice caused by improper adding of script in administration
* Hidden Fields: Fixed double inputs that were the exact same (<a href="http://wordpress.org/support/topic/render-the-fields-twice">as reported here</a>)

= 1.3.1 =
* Fixed: issue in Hidden Fields where the `[hidden-###]` shortcode no longer worked and only `[post_title]` format worked.
    * Added: Hidden fields now support both formats: `[hidden-123]` and `[post_title]` as long as they're in the form itself.
* Fixed: issue in Send All Fields where the <a href="http://wordpress.org/support/topic/post_title-hidden-field-no-longer-working#post-3708463">HTML was showing as text</a>.
* Added `wpcf7_send_all_fields_format_key` filter to Send All Fields plugin to turn on or off formatting of the key (replacing `example-key` with `Example Key` in output). See "How do I turn off formatting the key in the `[all-fields]` output?" in the FAQ.

= 1.3 =
* Fixed: Hidden field now supports new Contact Form 7 format; post fields will work again.
* Fixed: Send All Fields no longer causes spinning form submission in WordPress 3.5
* Added: access any of the <a href="http://www.rlmseo.com/blog/wordpress-post-variable-quick-reference/" rel='nofollow'>data in `$post` object</a> by using the variable name. Example: You want `post_modified`? Use `[hidden hidden-123 "post_modified"]`
* Added: If an user is logged in, you can now use `user_name`, `user_id`, `user_email`, `user_display_name` replacement values
* Added/Improved: `post_author` will now return the author's Display Name. Use `post_author_id` for the post author's ID.
* Added: Inline instructions on the Hidden field module
* Improved: In Send All Fields, the name of the field now has dashes replaced with spaces. This will show "your name", rather than "your-name". Thanks, <a href="http://wordpress.org/support/topic/sending-all-fields-with-content-code-provided">@hitolonen</a>

= 1.2.2 =
* Removed `_wpnonce` field from `[all-fields]` output
* Fixed a conflict when using "Send All Fields" module alongside "Hidden Fields" module (<a href="http://wordpress.org/support/topic/plugin-contact-form-7-modules-all-fields-doesn´t-work-wit-wordpress-33">as reported here</a>)

= 1.2.1 =
* Added support for checkboxes with Send All Fields (`[all-fields]`)

= 1.2 =
* Hidden fields are now displayed inside a hidden `<div>` instead of Contact Form 7's default `<p>`. This makes hidden fields more hidden :-)
* Added brand-new module: Send All Fields. Allows you to add a `[all-fields]` tag to your email message that includes every submitted field in one tag.

= 1.1.1 =
* Fixed `Parameter 1 to wpcf7_add_tag_generator_hidden() expected to be a reference, value given` error, <a href="http://www.seodenver.com/contact-form-7-hidden-fields/#comment-116384456"> as reported by BDN Online</a>

= 1.1 =
* Added support for using post titles as hidden fields
* Added support for using custom field values as hidden fields
* Added `wpcf7_hidden_field_value` filter to hook into using <a href="http://codex.wordpress.org/Function_Reference/add_filter" rel="nofollow"><code>add_filter()</code></a>

= 1.0 =
* Initial plugin release.

== Upgrade Notice ==

= 1.4.2 on March 25, 2014 =
* Added: `[all-fields]` shortcode now skips sending data for empty fields
	* Added `wpcf7_send_all_fields_send_empty_fields` filter to override the setting. See the FAQ.
* Added: `[all-fields]` shortcode output filters (see the FAQ item "How do I modify the output...")
	* `wpcf7_send_all_fields_format_before`
	* `wpcf7_send_all_fields_format_item`
	* `wpcf7_send_all_fields_format_after`

= 1.4 & 1.4.1 on March 15, 2014 =
* Added: Internationalization support. [Help translate the plugin!](https://www.transifex.com/projects/p/contact-form-7-modules/)

__The below updates apply only to the Hidden Fields module.__

* Added: Support for retrieving other user data by using the field name `user_{data you want}`. See the FAQ "How do I set non-standard user data as hidden field values?"
* Added: `wpcf7_hidden_field_implode_glue` filter. If you want to modify how arrays of data get combined into a string (default is CSV), use this filter.
* Fixed: `$post` global no longer needs to be defined for user data to be successfully passed.
* Fixed: Now supports multiple post `custom_field` data values, instead of only fetching one
* Modified: Added callback function to format the hidden field instead of relying on depricated PHP
* Modified: Improved include path for `functions.php` file
* Modified: Added text to support additional localization

= 1.3.3 =
* Hidden Fields: Fixed issue that broke the plugin with the WordPress 3.8

= 1.3.2 =
* Hidden Fields: Fixed PHP notice caused by improper adding of script in administration
* Hidden Fields: Fixed double inputs that were the exact same (<a href="http://wordpress.org/support/topic/render-the-fields-twice">as reported here</a>)

= 1.3.1 =
* Fixed: issue in Hidden Fields where the `[hidden-###]` shortcode no longer worked and only `[post_title]` format worked.
* Fixed: issue in Send All Fields where the <a href="http://wordpress.org/support/topic/post_title-hidden-field-no-longer-working#post-3708463">HTML was showing as text</a>.

= 1.3 =
* Fixed: Hidden field now supports new Contact Form 7 format; post fields will work again.
* Fixed: Send All Fields no longer causes spinning form submission in WordPress 3.5
* Added: access any of the <a href="http://www.rlmseo.com/blog/wordpress-post-variable-quick-reference/" rel='nofollow'>data in `$post` object</a> by using the variable name. Example: You want `post_modified`? Use `[hidden hidden-123 "post_modified"]`
* Added: If an user is logged in, you can now use `user_name`, `user_id`, `user_email`, `user_display_name` replacement values
* Added/Improved: `post_author` will now return the author's Display Name. Use `post_author_id` for the post author's ID.
* Added: Inline instructions on the Hidden field module
* Improved: In Send All Fields, the name of the field now has dashes replaced with spaces. This will show "your name", rather than "your-name". Thanks, <a href="http://wordpress.org/support/topic/sending-all-fields-with-content-code-provided">@hitolonen</a>

= 1.2.2 =
* Removed `_wpnonce` field from `[all-fields]` output
* Fixed a conflict when using "Send All Fields" module alongside "Hidden Fields" module (<a href="http://wordpress.org/support/topic/plugin-contact-form-7-modules-all-fields-doesn´t-work-wit-wordpress-33">as reported here</a>)

= 1.2.1 =
* Added support for checkboxes with Send All Fields (`[all-fields]`)

= 1.2 =
* Hidden fields are now displayed inside a hidden `<div>` instead of Contact Form 7's default `<p>`. This makes hidden fields more hidden :-)
* Added brand-new module: Send All Fields. Allows you to add a `[all-fields]` tag to your email message that includes every submitted field in one tag.

= 1.1.1 =
* Fixed `Parameter 1 to wpcf7_add_tag_generator_hidden() expected to be a reference, value given` error, <a href="http://www.seodenver.com/contact-form-7-hidden-fields/#comment-116384456"> as reported by BDN Online</a>

= 1.1 =
* Added support for using post titles as hidden fields
* Added support for using custom field values as hidden fields
* Added `wpcf7_hidden_field_value` filter to hook into using <a href="http://codex.wordpress.org/Function_Reference/add_filter" rel="nofollow"><code>add_filter()</code></a>

= 1.0 =
* Woot!