WordPress.org
Get WordPress

Plugin Directory

Changeset 3440378


Ignore:
Timestamp:
01/15/2026 01:35:35 PM (3 months ago)
Author:
westerndeal
Message:

updated readmefile

File:
1 edited

Legend:

Unmodified
Added
Removed

  • gsheetconnector-wpforms/tags/4.0.2/readme.txt

    r3431060 r3440378  
    1 === GSheetConnector For WPForms ===
     1=== GSheetConnector For WPForms – WPForms Google Sheets Integration (Real-Time Sync) ===
    22Contributors: westerndeal, abdullah17, gsheetconnector
    33Author URL: https://www.gsheetconnector.com/
    4 Tags: WPFORMS, WPForms Google Sheet, Google Sheet Integration, WPForms Google Sheet Integration, Contact Form Google Sheet Integration
    5 Docs: https://www.gsheetconnector.com/docs/gsheetconnnector-for-wpforms
     4Tags: WPForms, WPForms Google Sheets, WPForms Google Sheets Integration, Google Sheets, Google Sheets Integration, WPForms Integration, WPForms Addon, WPForms Entries, Export WPForms Entries, Form to Google Sheets, Google Sheets Connector, Contact Form Google Sheets
    65Tested up to: 6.9
    76Requires at least: 5.6
    … …  
    1110License URI: http://www.gnu.org/licenses/gpl-2.0.html
    1211
     12Connect WPForms to Google Sheets and automatically send form entries to a google sheet in real-time. No manual exports, no coding required.
     13
    1314== Description ==
    1415
    15 This is an Addon Plugin of WPForms, A bridge between your [WordPress](https://wordpress.org/) based **[WPForms](https://wordpress.org/plugins/wpforms-lite/) and [Google Sheets](https://www.google.com/sheets/about/).** It helps to record the entries in real-time.
    16 
    17 When a visitor submits the form on your website from the frontend using WPForms, upon the form submission, such responses/filled entries are also sent to Google Sheets.
    18 **Compatible with [WPForms Lite](https://wordpress.org/plugins/wpforms-lite/) and [PRO Versions](https://wpforms.com/pricing/)**
    19 
    20 [Homepage](https://www.gsheetconnector.com/) | [Documentation](https://www.gsheetconnector.com/docs) | [Support](https://www.gsheetconnector.com/support) | [Demo](https://wpformsdemo.gsheetconnector.com/) | [Premium Version](https://www.gsheetconnector.com/wpforms-google-sheet-connector-pro?wp-repo)
    21 
    22 = 🤝 PRO FEATURES 🙌 =
    23 
    24 Get a rid of making mistakes while adding the sheet settings or adding the headers manually to the sheet column. We have Launched the [WPForms Google Sheet Connector Pro](https://www.gsheetconnector.com/wpforms-google-sheet-connector-pro?wp-repo) version with more automated features.
    25 ➜ Custom Google API Integration Settings
    26 ➜ Allowing to Create a New Sheet from Plugin Settings
    27 ➜ Custom Ordering Feature / Manage Fields to Display in Sheet using Enable-Disable / Edit the Fields/ Headers Name to display in Google Sheet.
    28 ➜ Using all the [Smart Tags](https://wpforms.com/docs/how-to-use-smart-tags-in-wpforms/) Fields in Headers
    29 ➜ Syncronize Existing Entries for WPForms PRO users
    30 ➜ Freeze Header Settings
    31 ➜ Header Color and Row Odd/Even Colors.
    32 Refer to the features and benefits page for more detailed information on the features of the [WPForms Google Sheet PRO Addon Plugin](https://www.gsheetconnector.com/wpforms-google-sheet-connector-pro?wp-repo)
    33 
     16Automatically send WPForms entries to Google Sheets in real-time.
     17
     18**GSheetConnector for WPForms** is a powerful and user-friendly add-on that connects your [WordPress](https://wordpress.org/) website running **[WPForms](https://wordpress.org/plugins/wpforms-lite/)** with **[Google Sheets](https://www.google.com/sheets/about/)** and automatically saves every form submission into a connected spreadsheet.
     19
     20When a visitor submits a form on your website, the data is instantly synced to Google Sheets — no manual export, no copy-paste, and no coding required. This makes it easy to manage, share, and analyze WPForms entries directly inside Google Sheets.
     21
     22This plugin works with both **[WPForms Lite](https://wordpress.org/plugins/wpforms-lite/)** and **[WPForms Pro](https://wpforms.com/pricing/)** and allows you to build a complete **WPForms to Google Sheets automation system** without writing any code.
     23
     24= 🚀 Key Features =
     25
     26🔄 Real-time sync of WPForms entries to Google Sheets 
     27📄 Works with WPForms Lite and WPForms Pro (tested with the latest versions) 
     28🧩 Feed-based form-to-sheet connections 
     29📊 Supports multiple forms and multiple Google Sheets per form 
     30🔑 Secure Google authentication (one-click OAuth) 
     31🏷 Supports WPForms Smart Tags 
     32📅 Sync submission date and time 
     33🛠 Debug log and system status for troubleshooting 
     34
     35= 💡 Why Use GSheetConnector for WPForms? =
     36
     37Most businesses waste time exporting WPForms entries, downloading CSV files, and manually copying data into spreadsheets. GSheetConnector eliminates this by creating a **real-time connection between WPForms and Google Sheets**.
     38
     39Every form submission is automatically synced, allowing you to:
     40• Follow up on leads instantly 
     41• Share data with your team 
     42• Build reports and dashboards 
     43• Avoid data loss and human errors 
     44• Manage everything inside Google Sheets 
     45• Enable real-time collaboration 
     46
     47[Documentation](https://www.gsheetconnector.com/docs/gsheetconnnector-for-wpforms/) | [Support](https://www.gsheetconnector.com/support) | [Demo](https://demo.gsheetconnector.com/wpforms-google-sheet-connector-pro/) | [WPForms Google Sheet Connector Pro](https://www.gsheetconnector.com/wpforms-google-sheet-connector-pro?wp-repo) | [Our Plugins](https://www.gsheetconnector.com/plugins/)
     48
     49= 🤝 Powerful PRO Automation Features =
     50
     51Upgrade to **[WPForms Google Sheet Connector Pro](https://www.gsheetconnector.com/wpforms-google-sheet-connector-pro?wp-repo)** to unlock full automation and advanced control:
     52
     53➜ Custom Google API integration (OAuth & Service Account) 
     54➜ Create new Google Sheets directly from WordPress 
     55➜ Field-to-column mapping 
     56➜ Re-order or rename Google Sheet headers 
     57➜ Use any [WPForms Smart Tags](https://wpforms.com/docs/how-to-use-smart-tags-in-wpforms/) as column headers 
     58➜ Sync existing WPForms entries to Google Sheets 
     59➜ Freeze header row 
     60➜ Row colors (odd/even + header styling) 
     61➜ Multiple feeds per form 
     62➜ Date-based and filtered syncing 
     63
     64👉 Upgrade to Pro: https://www.gsheetconnector.com/wpforms-google-sheet-connector-pro/
     65
     66**Trusted by 20,000+ active installations across FREE and PRO versions. Try WPForms Google Sheet Connector now and simplify your WPForms to Google Sheets workflow.**
    3467
    3568= ⚡️ Check Live Demo =
    36 [Demo URL: WPForms Demo](https://wpformsdemo.gsheetconnector.com/)
    37 
    38 [Google Sheet URL to Check submitted Data](https://docs.google.com/spreadsheets/d/1ooBdX0cgtk155ww9MmdMTw8kDavIy5J1m76VwSrcTSs/edit#gid=1289172471)
     69🔗 [WPForms Live Demo – Click Here](https://demo.gsheetconnector.com/wpforms-google-sheet-connector-pro/)
     70
     71
     72[Google Sheet URL to Check submitted Data](https://docs.google.com/spreadsheets/d/1IzQqqCziV2eOxH2vb1EFmcvkGt4WIIjHfxUIE4MdpZk/edit?gid=1144149960#gid=1144149960)
    3973
    4074= ✨ How to Use this Plugin =
    … …  
    6296🚀WPForms Forms Google Sheet Connector Introduction Video
    6397
    64 [youtube https://youtu.be/tgF9GfDjQOw?si=4Ej3vPfpxfDcU7hq]
     98[https://youtu.be/tgF9GfDjQOw?si=4Ej3vPfpxfDcU7hq]
     99
     100### 🔐 Secure & Compliant
     101
     102GSheetConnector connects directly to **your Google account**. Your form data stays inside:
     103• Your WordPress site 
     104• Your Google Drive 
     105
     106No third-party servers, no external storage.
     107
     108
     109If you need advanced automation, bulk sync, or multiple feeds, the Pro version gives you full control over how your WPForms data flows into Google Sheets.
    65110
    66111= Important Notes =
    67112
    68 ➜ You must pay very careful attention to your naming. This plugin will have unpredictable results if names and spellings do not match between your Google Sheets and WPForms settings.
     113➜ Make sure the column headers in your Google Sheet match the field labels used in WPForms. Keeping names consistent ensures that form entries are mapped and synced correctly.
    69114
    70115👉 [Get WPForms PRO today]((https://www.gsheetconnector.com/wpforms-google-sheet-connector-pro?wp-repo))
    … …  
    851305. Extensions.
    86131
    87 = How do I get the Google Access Code required in step 3 of Installation? =
    88 
    89 * On the `Admin Panel > WPForms > Google Sheet > Integration` page, click the "Get Code" button.
    90 * In a popup Google will ask you to authorize the plugin to connect to your Google Sheets. Authorize it - you may have to log in to your Google account if you aren't already logged in.
    91 * On the next screen, you should receive the Access Code. Copy the code.
    92 * Now you can paste this code back on the `Admin Panel > WPForms > Google Sheet > Integration` page.
    93 
    94132== Frequently Asked Questions ==
    95133
    96 = How to get smart tag like query_vars, user_meta key values to the Sheet?  =
    97 
    98 * First, use hook "wpforms_smart_tags" to add the smart tags with the key for which you want the value to the Google Sheet as below example.
    99 
    100    add_filter( "wpforms_smart_tags", "edit_smart_tags" );
    101 
    102    public function edit_smart_tags( $tags ) {
    103       $tags['query_var key="wpformstest"'] = esc_html__( 'Query String Variable', 'wpforms-lite' );
    104       return $tags;
    105    }
    106 * Add same key ( query_var key="wpformstest" ) to the Google Sheet header to get the values.
    107 
    108 = entry_id and entry_date smart tag not getting saved to the Google Sheet.
    109 
    110 * WPForms lite version don't save form submitted entries to the database. For a reason entry_id is zero(0) and entry_date is null. Hence not being saved to the Google Sheet.
     134= How do I get the Google Access Code? =
     135
     136To connect WPForms with Google Sheets, you need to authorize your Google account.
     137
     138Follow these steps:
     139
     1401. Go to **WPForms → Google Sheet → Integration** in your WordPress admin.
     1412. Click the **“Google Signin”** button.
     1423. You will be redirected to Google to log in and authorize access to **Google Drive** and **Google Sheets**. 
     143   Please allow both permissions.
     1444. After authorization, Google will generate an **Access Code** and redirect you back to the plugin.
     1455. Click **Save & Authenticate**. 
     146   Your connected Google email will be displayed, confirming that the connection is successful.
     147
     148
     149= How can I send custom Smart Tag values (query_vars, user_meta, etc.) to Google Sheets? =
     150
     151You can add custom Smart Tags to WPForms and use them as column headers in Google Sheets.
     152
     153Add this code to your site:
     154
     155add_filter( "wpforms_smart_tags", "edit_smart_tags" );
     156function edit_smart_tags( $tags ) {
     157    $tags['query_var key="wpformstest"'] = 'Query String Variable';
     158    return $tags;
     159}
     160
     161Then add the same Smart Tag key 
     162query_var key="wpformstest" 
     163as a column header in your Google Sheet to receive the value.
     164
     165
     166= Why are entry_id and entry_date not appearing in my Google Sheet? =
     167
     168In the free version of the plugin, only the submission date is supported using the **"date"** column. Other Smart Tags, require the Pro version.
     169
     170To use all Smart Tags and advanced syncing options, please upgrade to the 
     171**[WPForms Google Sheet Connector Pro](https://www.gsheetconnector.com/wpforms-google-sheet-connector-pro?wp-repo)**.
     172
     173
     174= Can I connect multiple WPForms to different Google Sheets? =
     175
     176Yes. You can connect each WPForm to a different Google Sheet or even to different tabs within the same spreadsheet using feed-based connections.
     177
     178---
     179
     180= Does the plugin sync data in real-time? =
     181
     182Yes. As soon as a form is submitted, the data is automatically sent to Google Sheets.
     183
     184---
     185
     186= Is my data stored on external servers? =
     187
     188No. All data is transferred directly between your WordPress site and your Google account. 
     189GSheetConnector does not store your form entries on any third-party servers.
     190
     191= Why is my WPForms data not being sent to Google Sheets? =
     192
     193This usually happens if Google authentication has expired or permissions were not granted correctly.
     194
     195Please check:
     196• Your Google account is still connected in **WPForms → Google Sheet → Integration**
     197• Google Drive and Google Sheets permissions are enabled
     198• You have clicked **Save & Authenticate** after signing in
     199
     200If needed, simply re-authenticate your Google account from the Integration tab.
     201
     202---
     203
     204= Will the submission date and time be saved in Google Sheets? =
     205
     206Yes. The plugin can send the submission date and time to Google Sheets. 
     207In the free version, you can use the **"date"** column. 
     208The Pro version supports full date, time, and Smart Tag based values.
     209
     210---
     211
     212= Can I connect multiple WPForms to different Google Sheets? =
     213
     214Yes. You can connect each WPForm to its own Google Sheet or to different tabs within the same spreadsheet using feed-based connections.
     215
     216---
     217
     218= Can I map form fields to specific Google Sheet columns? =
     219
     220Yes. Field-to-column mapping is available in the **Pro version**, allowing you to control the column order, names, and structure of your Google Sheet.
     221
     222---
     223
     224= Is my form data stored securely? =
     225
     226Yes. All form data is transferred directly between your WordPress site and your Google account. 
     227GSheetConnector does not store your form submissions on any external servers.
     228
     229---
     230
     231= Can I sync existing WPForms entries to Google Sheets? =
     232
     233Yes. The **Pro version** allows you to sync previously submitted WPForms entries to Google Sheets.
     234
     235---
     236
     237= Can I use Smart Tags in Google Sheet headers? =
     238
     239Yes. The **Pro version** allows you to use any WPForms Smart Tag as a column header, including user data, query strings, and custom values.
     240
     241---
     242
     243= What should I do if Google shows a “This app isn’t verified” warning? =
     244
     245This may appear when using a custom Google API project. 
     246Click **Advanced** and then **Go to project** to continue. It is safe when you are connecting your own Google account.
     247
     248---
     249
     250= What does the Service Account option do? =
     251
     252Service Account authentication allows you to connect Google Sheets without repeated login prompts. It is ideal for websites that need uninterrupted syncing and higher reliability.
     253
     254---
     255
     256= Why am I getting errors or missing entries? =
     257
     258Enable **Debug Log** and **System Status** in the plugin settings to see detailed error messages. These tools help identify permission, API, or configuration issues quickly.
    111259
    112260
Note: See TracChangeset for help on using the changeset viewer.