Setup Wizard

On first activation, SheetLink Forms automatically redirects to a guided setup wizard under SheetLink -> Setup. The wizard handles the six steps that used to live across separate admin pages, walking you from a fresh install to a working Google Sheet connection in three minutes.

• Welcome screen with a quick overview of what gets configured.
• Optional license-key activation step (skippable - the free core works without activation).
• Form-plugin picker that auto-detects which of the 12 supported form plugins are already installed.
• Rule naming so you can recognise the sync later.
• Apps Script generator with copy-to-clipboard and step-by-step Google-side instructions.
• Paste-the-URL step that sends a test payload to verify end-to-end delivery before saving.

The wizard marks itself complete the first time you finish or skip it, so it does not re-appear on every admin load. To run it manually at any time visit /wp-admin/admin.php?page=sheetlink-setup directly. This is handy when onboarding a second site, or when walking a client through the flow.

On completion the wizard creates one sync rule in SheetLink -> Sync Rules with your chosen form plugin and the Apps Script URL you pasted. Field mapping is left for you to configure on the rule page - the wizard intentionally scopes itself to the delivery pipeline so nothing is over-prescribed. The Smart Mapping feature auto-suggests column names when you open the rule for editing.

The test payload fires once you paste the Apps Script URL and click Send Test. If it fails:

• HTTP 403 or 302: the Apps Script is deployed with restricted access. Re-deploy with Execute as: Me and Who has access: Anyone.
• Network error: the URL is not a valid script.google.com or script.googleusercontent.com web-app URL. Only those prefixes are accepted.
• HTTP 500: the Apps Script threw an error. Open the script in your Google Sheet and check the execution log under Extensions -> Apps Script -> Executions.

You can always skip the test and save the rule manually, then verify from a real form submission on your site.