=== Gravity Forms Timed Entries ===

Contributors: Plugin Owl
Tags: gravity, forms, timer, timed, counter, time, limit, count, clock 
Requires at least: 4.4
Tested up to: 6.4
Stable tag: 2.7.7
License: copyright 2020 Plugin Owl

This plugin extends Gravity Forms with Extends Gravity Forms with timed entry options.






== Description ==

Gravity Forms Timed Entries adds entry timer fields with optional time limits that auto submit the form or block editing. The entry timer fields record the total amount of time that the form submission took from initial form page load to submission. These timers can be visible or hidden to the user. 





= Requirements =

-WordPress 4.6+
-PHP 5.6+ (5.5 and 5.4 should also function but are NOT SUPPORTED)
-Gravity Forms Version 2.0.7+

-It is important to test the plugin for reliable functionality before running in any live production environment as other plugins could cause potential conflict. 






== Installation ==

First Install:
Always backup your WordPress database and files before installing any plugins or updates!

You can install Gravity Forms Timed Entries through the "Add Plugins" page of the "Plugins" menu in WordPress (Plugins => Add New => Upload Plugin). Upload the plugin file without unzipping it. Or follow directions below for FTP install.

1. Unzip the plugin file.
2. Upload with your FTP software the "gravity-forms-auto-formatter" folder, and only this folder, to your plugins directory (it should be "wp-content/plugins").
3. Activate the plugin through the "Plugins" menu in WordPress.
4. Configure the plugin through the "Settings->GF Timed Entries" options page in WordPress, in the form settings, and in individual form entry timer fields "general" options.





== UPGRADE ==
**Please use the [Envato Market](https://envato.com/market-plugin/) plugin to automatically upgrade the plugin. If you must upgrade manually follow the instructon below.**

1. Backup your database and WordPress installation. If you want to keep your settings on uninstall please turn on the "Save Plugin Options on Uninstall" option in this plugins Settings->GF Timed Entries options page.

2. Save an offline backup copy of the current version gravity-forms-auto-formatter folder in your wp-content/plugins directory. 

3. Put your site into offline/maintenace mode and deactivate the "Gravity Forms Timed Entries" plugin. Unzip the installation file and use FTP to replace your sites gravity-forms-auto-formatter folder contents in your wp-content/plugins directory with the new versions folder contents. The folder contents are normally located in wp-content->plugins->gravity-forms-auto-formatter. If you cannot use FTP you can uninstall the plugin through the 

4. Re-activate the "Gravity Forms Timed Entries" plugin. Go to the "Settings->GF Timed Entries" options page and check settings to adjust or set if needed.

5. If you encounter errors, please switch this folder back to the earlier version you saved a backup copy of using the same steps above.

7. Check the Changelog below and be sure to read the current versions additions/changes and make any neccessary configuration adjustments then take the site out of maintenance mode.






== Instructions ==

Please refer to the plugins settings page: Settings-> GF Timed Entries.






== Upgrade Notice ==
New in Version 2.7.7
* Tested on WP 6.4
* Tested on GF 2.7.16





== Changelog ==

== 2.7.7 ==
* Tested on WP 6.4
* Tested on GF 2.7.16

== 2.7.6 ==
* Added clearer instruction for saving timer display time to text fields when chosen element is clicked.
* Tested on WP 6.1.1

== 2.7.5 ==
* Added Feature to copy selected timer field's current text to any text field on click of chosen element.
* Tested on WP 6.0.3

== 2.7.4 ==
* Tested on WP 6.0.2

== 2.7.3 ==
* Tested on WP 5.7.3

== 2.7.2 ==
* Fixed plugin version reporting on settings page.
* Tested on WP 5.7.2

== 2.7.1 ==
* Fixed issue with page timers not recording time when hidden

== 2.7 ==
* Fixed issue with drop down fields not staying editable when option is selelected to keep editable on blocked editing.
* Tested on WP 5.7.1

== 2.6 ==
* Set Gravity Forms dependency for plugin activation.
* Set Gravity Forms full dependency for plugin operation.

== 2.5 ==
* Fixed form editor field settings loading properly with new version of WP that include new Jquery version.
* Tested on WP 5.6.1

== 2.4 ==
* Fixed issue with Form Time Limit inputs being restricted to values of 60.
* Updated instructions.
* Tested on WP 5.6.

== 2.3 ==
* Updated display for Gravity Forms 2.5.
* Updated JS code for GF 2.5+ front end markup of page timers with legacy support.
* tested on WP 5.4.2

== 2.2.1 ==
* Fixed an issue where Timer values could turn blank after editing an entry.

== 2.2 ==
* Changed standard timer text to reflect singular and plural context for hours minutes and seconds in saved values.
* tested on WP 5.4.1

== 2.1 ==
* Changed page redirect load method on timer to disallow back button navigation.
* Minor code changes.
* tested on WP 5.4

== 2.0 ==
* Added Page Timers for timing of individual form pages (currently AJAX enabled forms only).
* Minor code changes.
* Updated instructions.

== 1.9.93 ==
* Added protection for possible redundant WP loading errors: "cannot redeclare (function)".
* WordPress 5.3.2 tested.

== 1.9.92 ==
* Tested on WP 5.3.

== 1.9.91 ==
* Added "Main Timer Text" Option for custom text under main form timer.
* Added developers filters for the Time Limit and Additional Timed Events form options to let developers filter the values before they are sent to the form page. (gftetimeLimitFilter + gfteTimedEventsFilter: instructions are at bottom of plugin settings page).
* Fixed a potential error with 'GFFormDisplay' class.
* Tested on WordPress 5.2.1.
* Additional testing of future individual page timers.

== 1.9.9 ==
* Fixed Auto Submit not working properly for some installations.
* Fixed plugin settings page not saving "Save Plugin Options on Uninstall" properly.
* Fixed various PHP notices.
* Tested on WP 5.1.1

== 1.9.8 ==
* Update: Changed the saved time values to use the "Custom Time Text" from the "Form Timed Entries" options.
* New: Added ability to Save individual timers value using completed Hours, Minutes, or seconds only.
* New: Added ability to remove the text from saved times when using Hours, Minutes, or seconds only.
* Tested on WP 5.0.3

== 1.9.7 ==
* New: "Additional Timed Events" form option allows for blocking editing, hiding, or showing form fields or page elements with specified CSS classes, or alerting custom messages at any number of seconds.
* New: Added the CSS class "gfte-hidden" to hide form fields until displayed using "Additional Timed Events".
* Fix: select and date fields are no longer able to be keyboard manipulated when blocked from editing.
* Update: All fields are no longer tabbable when blocked from editing.
* Update: Settings page instructions.
* Tested on WP 5.0.1

== 1.9.6 ==
* Fixed issue with plugin load order if loaded before Gravity Forms core (GF_Field_Text error).

== 1.9.5 ==
* Added options to customize text for 'Hours', 'Minutes', and 'Seconds' for all entry timers (timer displays now support any language).
* Added option to hide individual form timers when time limit is reached.
* Updated timer displays to more quickly update on page load instead of showing 0 time.
* Updated Timer Start Page to hide entire timer field (including labels) until start page is visited.
* Updated form timer fields and main form timer to be hidden when ajax form is submitted and confirmation page is loaded.
* Updated instructions (including a display CSS class listing and example for custom styling).

== 1.9.4 ==
* Added "Timing Start Page" which hides form timers and delays timing until the input form page number is visited.
* Added ability to auto redirect the page on time limit reached without submitting the form.
* Fixed an issue with the server time synch triggering the time limit unexpectedly.
* Removed blank time (Hours, Minutes) from all form timer displays when they are 0.
* Tested on WordPress 4.9.8

== 1.9.3 ==
* Fixed an issue with the times up message displaying "undefined" when no message was set.
* Updated instructions.

== 1.9.2 ==
* Added CSS classes to allow for page elements or fields to toggle visibility on or off when form time limit expires.
* Updated Precision Timer output to read as "X.XXXX seconds".
* Fixed reporting of time stored in partial entries to correct for timezone offset.
* Updated instructions.

== 1.9.1 ==
* Added "Precision Timer" option to allow timers to record fractional seconds with customizable precision.
* Automatic Upgrades through the free "Envato Market" plugin.
* Tested on WordPress 4.9.7

== 1.9 ==
* Fixed issue with timer visibility when timer should be hidden.
* Tested on WordPress 4.9.6

== 1.8 ==
* Changed Auto submit action to still show form/quiz pages as steppedthroug submission and also show same page confirmations.
* Removed main form timer visibility once form is submitted for ajax forms.
* Removed the "Time is Up Message" if the form has already been submitted via ajax and the user is on the same form page.
* Improved usage instructions.
* Read 1.7 changes.

== 1.7 ==
* Changed blocked editing setting. You must turn on blocked editing again for any forms using it. 

== 1.6 ==
* Added ability to exclude individual fields from 'Blocked Editing' on time limit. -Supported field types for blocked editing exclusion: single line text, website, phone, number, date, time, paragraph text, drop down, multi select, checkboxes, radio buttons, name, address, file upload, email, post_title, post_content, post_excerpt, post_tags, post_category, post_image, post_custom_field
* Fixed an undefined variable notice.
* Added better handling for non-numerical values in form options.
* Improved user instructions.

== 1.5 ==
* Changed "Time Limit" setting to be set in hours, minutes, and seconds instead of total seconds.
* Changed "Synch Interval" and "Time Limit" inputs to disallow non-numeric characters.
* Added visual calculation for time between when the Time limit is reached and the next synch interval server time check.

== 1.4 ==
* Added Custom "Time is Up Message" alert message to "Form Timed Entries" in the form setings.
* Changed "block Edit" and "Auto Submit" form options settings to be removed when no time limit is set.	

== 1.3 ==
* Added "Countdown Timer" option to make counters count down instead of up.

== 1.2 ==
* Added "Auto Submit" option to auto submit after form time limit is reached.

== 1.1 ==
* Added "Block Editing" option to block further editing after form time limit is reached.

== 1.0 ==
* Initial version