Descriere
Formgong is a form backend. This plugin posts a contact form to your Formgong endpoint. Leads arrive in the Formgong inbox. Telegram is instant on every plan, including Free. On the Free plan, every submission is emailed to one address. Pro emails each submission to up to 3 addresses, and Business to up to 5. The host’s own mail setup is not used.
The plugin is tested on WordPress 7.1 with WooCommerce and the Storefront theme. Plugin Check passes.
On a WooCommerce store the same plugin can add:
- a question on the product page, including the product name, SKU, and URL
- a question on the customer’s order page (not the confirmation page after checkout), including the order number, only for a customer who can view that order
Checkout, payments, and WooCommerce order emails stay in WooCommerce.
The access key is public. It can submit the form. It cannot read the inbox. Paste it under Settings Formgong, then click Send a test submission. That test uses plugin-test@example.com and does not finish the Formgong connect wizard. Submit the public page to finish it.
Place the form with the Formgong block or the shortcode [formgong]. The block has a template picker. On a product template, [formgong product="1"] adds the current product’s name and SKU.
Pick a Formgong template with [formgong template="aula"], the block’s template setting, or Settings Formgong. An empty product or order template inherits the main template. The slug plain forces the built-in contact form. A shortcode or block template wins over the settings. The heading stays „Question about this product” or „Question about this order” unless you set a custom heading. Other forms say „Contact us” in the form language; an industry template uses its own name, such as „Doctor appointment form”; a survey has no heading. Website and starter template names never show to visitors.
The catalog matches the site templates, the starter layouts, and the industry forms such as clinic-appointment. The full slug list is below and on https://formgong.com/docs/wordpress . Styles are scoped so Storefront, Astra, and Twenty Twenty-Five do not restyle the fields. The labels, the button, and the headings follow the form language: the Form language setting, or the language of the site. Formgong has twelve (uk, en, pl, tr, ar, he, es, fr, pt, hi, ja, de); any other site language shows English.
Every form sends a hidden _page_url with the current page address: scheme, host, and path. The query string is never sent, because it can hold a secret such as a WooCommerce order key. Formgong stores the address as the submission page when the host matches the referrer. A cross-origin post often sends only the site home in the referrer, so this field is what records the real page. If the browser sends no referrer at all, the address cannot be checked and the submission page stays empty.
Template slugs
Website: craftline, orrery, lattice, lattice-estate, shoal, lattice-atelier, soglia, halftone, ocra, arcwell, aula, goldleaf, quell, kavelle, burrow, selune, brightmoss, averin, sorrel, odera, tamsa, fernlow.
Starter layouts: html-contact, ajax-contact, tailwind-contact, modal-contact, dark-contact, minimal-contact, ai-builder.
NPS: nps.
Industry: clinic-appointment, patient-intake, insurance-quote, insurance-claim, order-inquiry, returns, wholesale, real-estate, course-enrollment, salon-booking, auto-service, legal-inquiry, renovation-estimate, job-application, event-registration, catering, tour-booking, fitness-trial, saas-demo, newsletter-signup, customer-feedback, customer-survey, rsvp, support-request, waitlist.
Support: support@formgong.com
Guide: https://formgong.com/for/woocommerce
WordPress docs: https://formgong.com/docs/wordpress
WooCommerce docs: https://formgong.com/docs/woocommerce
Written by the Formgong team.
External services
This plugin sends data to one external service, Formgong (https://formgong.com), the form backend it is made for. It connects to the endpoint you save under Settings Formgong. The default is https://formgong.com, and both requests below go to the /submit address of that endpoint: https://formgong.com/submit unless you changed it.
When a visitor submits a form. The form is a standard HTML form, so the visitor’s browser posts to https://formgong.com/submit. It sends the answers the visitor typed (and any file they attach), the public access key, the page language, an empty honeypot field, the success and error redirect addresses if you set them, and the address of the page the form is on in a hidden _page_url field. That address is the scheme, host, and path only: the query string and the fragment are never sent. A product question also sends the product ID, name, SKU, and product URL. An order question also sends the order number. As with any web request, the browser sends its IP address, user agent, and Referer header to Formgong. Formgong stores the answers and the page address, the user agent, a hash of the IP address (not the address itself), the country, and the type of device and browser, for the retention period set for the form. The visitor then lands on a Formgong confirmation page, or on a redirect address when one is set (see the FAQ).
When an administrator clicks „Send a test submission”. WordPress sends one JSON request to the same https://formgong.com/submit address from your server. It contains the access key, the language, a fixed name and message, and the address plugin-test@example.com. Its Origin and Referer headers are the address of your site, as a visitor’s browser would send them. The user agent is FormgongInstallationTest/1.0. No visitor data is involved. The test does not finish the connect wizard.
Formgong’s terms and privacy policy: https://formgong.com/en/terms/ and https://formgong.com/en/privacy/
The plugin adds suggested wording for your own privacy policy under Settings Privacy Policy Guide.
What is sent, and how it is stored, is described at https://formgong.com/for/woocommerce
The plugin does not phone home for updates, ads, or tracking.
Capturi ecran
Blocuri
Acest modul oferă 1 bloc.
- Formgong form A Formgong form. Pick a website, starter, or industry template.
Instalare
Install from your WordPress admin: open Plugins Add New, search for „Formgong”, click Install Now, then Activate.
To install by hand instead, download https://formgong.com/downloads/formgong-wordpress.zip, open Plugins Add New Upload Plugin, choose the zip, and activate Formgong.
Then set it up:
- Open Settings Formgong.
- Paste the access key from the Formgong dashboard. Leave the endpoint at
https://formgong.comunless you use another Formgong host. - Click Send a test submission. It does not finish the connect wizard.
- Add the Formgong block and pick a template, or add
[formgong]. Optional:[formgong template="aula"], then publish. - On a store, turn on the product question, the order question, or both. Leave a template empty to inherit the main one, or choose plain for the built-in contact form, then save.
- Send a test from the live page and open the Formgong inbox.
Întrebări frecvente
-
Does this replace WooCommerce checkout?
-
No. The plugin does not change checkout, payments, or order emails. It only adds question forms.
-
Do I need an SMTP plugin?
-
Not for this form. Formgong sends the notification. Telegram is instant on every plan. On the Free plan, every submission is emailed to one address.
-
Where do visitors land after they send the form?
-
On a Formgong thank-you page, unless a redirect is set. A redirect address set on the form in the Formgong dashboard is used as it is. The plugin’s „Success redirect” setting sends its own address with the form, and Formgong uses it only when it is on the same site as the form, or on one of the form’s allowed domains when the form has a list. An address on another domain is ignored: the visitor sees the dashboard’s redirect if there is one, and the Formgong thank-you page if there is not. The error redirect follows the same rules.
-
Where is the access key stored?
-
In the
formgong_settingsoption in your WordPress database. Deleting the plugin removes that option, on every site of a multisite network. Submissions themselves are stored by Formgong, not in WordPress. -
Can I use Cloudflare Turnstile or file uploads?
-
No. The plugin’s forms do not show the Turnstile check and have no file fields. A Formgong form with Turnstile turned on rejects every submission (the error code is
turnstile_missing), and a file part is refused (uploads_disabled). Turn Turnstile off for the form under Settings Protection in the Formgong dashboard. The honeypot field, the rate limits, and Formgong’s own spam checks still apply. Industry templates that the site offers with an attachment field appear here without it. -
Can the endpoint be a Formgong host on a private network?
-
The endpoint must be an https address, and a private-network address is not supported. The „Send a test submission” button makes its request from your server through WordPress’s safe HTTP API, which refuses private-network addresses and ports other than 80, 443, and 8080, so the test cannot reach such a host. Use a public https address.
-
Can I use it without WooCommerce?
-
Yes. Without WooCommerce you still get the contact form block and the shortcode. The product and order questions stay off.
-
Does the product question work in block themes?
-
Yes. In a block theme it follows the Add to Cart block on the Single Product template, or the product details if that block is gone. To choose the spot yourself, leave the product question off under Settings Formgong and add a Shortcode block with
[formgong product="1"]to the Single Product template. -
Can I use a Formgong template?
-
Yes. Under Settings Formgong choose a website template (aula, lattice), a starter layout, or an industry form (clinic-appointment). A block or shortcode can override it:
[formgong template="lattice"]. On a store, an empty product or order template inherits the main one. The slug plain forces the built-in contact form. The styles are written so Twenty Twenty-Five, Storefront, and Astra do not restyle the inputs. -
Why does the inbox show the site home?
-
WordPress often sends only the site origin as the referrer on a cross-origin post. The plugin adds a hidden
_page_urlfor the current page. Formgong keeps it when the host matches, ignoring a leading www. A site that tells browsers to send no referrer (Referrer-Policy: no-referrer) gives Formgong nothing to check the address against, so the page stays empty. -
The block does not appear, or the page is blank.
-
Activate the plugin and reload the editor. The block name is Formgong form. The form renders on the published page, not only inside the editor. If Plugin Check or the editor reports that the site does not support formgong/form, the block script did not load: confirm the plugin folder contains block/editor.asset.php and block/editor.js.
-
The product or order question is missing.
-
Confirm WooCommerce is active and the checkbox under Settings Formgong is saved. The order question is shown only to a customer who can view that order, and not on the confirmation page right after checkout. In a block theme the product question follows the Add to Cart block.
Recenzii
Nu există nicio verificare pentru acest modul.
Contributori și dezvoltatori
„Formgong” este un software open-source. La acest modul au contribuit următoarele persoane.
Contributori
Te interesează dezvoltarea?
Răsfoiește codul, vezi depozitarul SVN, sau abonează-te la jurnalul de dezvoltare prin RSS.
Istoric modificări
1.0.1
- Terms and privacy links point to https://formgong.com/en/terms/ and https://formgong.com/en/privacy/.
1.0.0
- First release. Contact form block and shortcode, Formgong templates (site, starter, and industry), optional phone field, and WooCommerce product and order questions.
- The block loads in the editor and renders on the page. Submissions record the current page URL in a hidden
_page_urlfield. Starter and industry template names follow the site language. - Product and order templates inherit the main template when left empty. The slug plain forces the built-in contact form. A shortcode or block template wins.
- Tested on WordPress 7.1 with WooCommerce and Storefront. Plugin Check passes.