forked from advancedforms/advanced-forms
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
162 lines (110 loc) · 7.84 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
=== Advanced Forms ===
Contributors: fabianlindfors
Tags: af, advanced, forms, form, acf, advanced, custom, fields, flexible, developer, developer-friendly
Requires at least: 3.6.0
Tested up to: 4.8.2
Stable tag: 1.3.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Flexible and developer-friendly forms using the power of Advanced Custom Fields
== Description ==
*Requires ACF v5*
Documentation: [advancedforms.github.io](https://advancedforms.github.io)
Advanced Forms lets you build flexible forms using the power of Advanced Custom Fields. The plugin has been built with developers in mind and offers a large variety of helper functions and customization hooks.
* Use all the fields provided by ACF, including repeaters and flexible content fields
* Define forms and fields fully programmatically for easy integration with your theme/plugin, or use the intuitive UI
* Either use the provided hooks to process form submissions as you wish or let the plugin automatically save them as entries
* Optionally set up emails to be sent automatically with form submissions
* Set a maximum number of entries created, limit a form to only logged in users, or schedule a form to only display during certain times. Custom restrictions can be applied by hooking in to a simple filter.
= Developers =
Advanced Forms is first and foremost built for developers and allows for simple integration with themes/plugins. Check out the [documentation](https://advancedforms.github.io) for guides and details about functions/hooks.
== Installation ==
1. Upload the plugin files to the `/wp-content/plugins/advanced-forms` directory, or install the plugin through the WordPress plugins screen directly.
2. Make sure ACF v5 is installed and activated.
3. Activate the plugin through the 'Plugins' screen in WordPress.
4. Read the [documentation](https://advancedforms.github.io) for instructions on how to create, configure, and display forms.
== Frequently Asked Questions ==
= Q: Does this plugin only work with ACF v5? =
Yes. Versions 4 or lower of ACF are not supported.
== Screenshots ==
1. Form edit page with form settings and a list of form fields
2. Example of entry automatically generated after form submission including all form fields
3. Example of location rules on an ACF field group
== Changelog ==
= 1.3.3 =
* Added Polish language translations (thanks @Triloworld).
* Fixed undefined index "post_type" warnings.
= 1.3.2 =
* Fixed bug where form data would be lost on forms without file uploaders.
= 1.3.1 =
* Added automatic upload of files for the basic uploader. A simple `af_save_field` will now suffice for file fields with the basic uploader.
* Added global field setting "Hide from admin?". Perfect for shared field groups used both for a form and admin, where some fields might only be relevant in the form.
* Fixed issue where the plugin didn't work with ACF included through a theme.
= 1.3.0 =
* Added new filter mode. When active a form will not show a success message after submission but instead display all fields again with their submitted values, effectively working as a filter. Set argument `filter_mode` as true to activate.
* Improved field inclusion with better dropdowns and contextual options.
* Improved admin interface with icons and better settings naming.
* Improved field include support for fields with posts, users, and terms.
* Added new helper function `af_save_all_fields` for saving all fields from a form to a post.
* Changed name of `af_save_field_to_post` to `af_save_field`. `af_save_field_to_post` still works but will be removed in a future version.
* Added support for default field values.
* Added filters for pre-filling field values.
* Added asterix for required fields.
* Fixed bug where select2 in fields wouldn't work.
* + many minor improvements and bug fixes.
= 1.2.0 =
* Revised field parsing behind the scenes to more closely match ACF and ensure compatibility. This also improves support for clone fields which should now work as expected in combination with entries and `af_get_field`. _Note: clone fields will no longer be expanded in the global fields array. `af_get_field` will return values of cloned fields if referenced by name._
* Added option to include all fields in emails/success messages. Fields will be rendered in a simple and consistent table structure with minimal styling (easily overriden!).
* Added support for displaying repeaters in emails/success messages.
* Fixed bug where entry info wasn't displayed.
* Fixed bug where filtering entries by form didn't work.
= 1.1.1 =
* Added helper function `af_save_field_to_post( $field_key_or_name, $post_id )` for saving submitted fields directly to posts. No need to mess with `update_field`!
* Optimized scripts and styles to only be enqueued when a form is displayed.
* Added ability to display field values in success messages similar to how they can be used in emails.
= 1.1 =
First major update to Advanced Forms!
* Added global plugin object containing info about the latest submission, accessible from anywhere.
* Revised submission handling. Submission data is now saved to the global object which simplifies the API (`af_get_field` no longer requires the field parameter and can be used anywhere). As a side effect the `af_success` URL parameter is no longer necessary!
* Added `target` attribute and helper function `af_has_submission`. The new target attribute lets you specify a custom URL to point the form to. Combined with the `af_has_submission` function you can now use your submitted form data anywhere and display it however you like.
Check out the updated documentation for more info: [Displaying a form](https://advancedforms.github.io/guides/basic/displaying-a-form/) and [Processing form submissions](https://advancedforms.github.io/guides/basic/processing-form-submissions/).
= 1.0.4 =
* Added argument to specify uploader type (media library or basic file field). Similar to `acf_form`.
* Added argument for excluding certain fields from form by field key or name (thanks [David](https://github.com/daviddarke)!)
* Fixed issue which generated 'undefined index' warnings (again, thanks [David](https://github.com/daviddarke))
= 1.0.3.3 =
* Added class for required fields and added field instructions to form output (big thanks to [David](https://github.com/daviddarke)!)
* Fixed issue where form wasn't returned when echo = false
* Fixed issue where arguments after submission where loaded as object instead of array
= 1.0.3.2 =
* Set the default content type of emails to HTML
* Updated styling to keep submit button on its own row
* Fixed issue with shortcode output being echoed instead of returned
* Fixed undefined index notice on some admin pages
= 1.0.3.1 =
* Quick-fix of an issue with field value includes in "From" headers
= 1.0.3 =
* Added option to only display form for logged in users
* Added option to only display form during certain times
* Added filters for creating own form restrictions. Check out the documentation for more info.
= 1.0.2 =
* Added option to restrict number of entries
* Added filters to modify form before rendering
* Simplified form admin interface
= 1.0.1 =
* Added ability to include form fields in email recipient, subject, and content
* Added the option to set "From" header in emails
* Added filters for email headers and attachments
* Fixed a bug where rows couldn't be added to repeaters/flexible content fields
* Fixed a bug where emails wouldn't be sent after form submission
= 1.0.0 =
First version of Advanced Forms!
* The ability to create forms using an intuitive UI or programmatically
* Full support for all ACF fields
* Automatically save form data to entries
* Define emails to be sent after form submissions
* Plenty of actions and filters to customize your forms and their functionality
== Upgrade Notice ==
None
== Documentation ==
The documentation has been moved to a new site, check it out: [advancedforms.github.io](https://advancedforms.github.io)