Changeset 3485316

Timestamp:

03/18/2026 06:31:17 AM (11 days ago)

Author:

byteoniclabs

Message:

Updating readme description for SEO and accuracy

File:

• byteonic-intake/trunk/readme.txt (modified) (2 diffs)

byteonic-intake/trunk/readme.txt

@@ -14 +14 @@
 == Description ==
 
-**Byteonic Intake** allows you to effortlessly send form submissions from your WordPress site to the [Byteonic Intake](https://intake.byteoniclabs.com) platform. It supports all major form plugins:
+Byteonic Intake is a WordPress form processing plugin designed specifically for web developers and digital agencies. Instead of relying on unreliable SMTP setups, complicated Zapier webhooks, or expensive form builder add-ons, this plugin securely captures form data at the browser level and sends it directly to your centralized Byteonic dashboard.
 
-* **Gravity Forms** - Full integration with field mapping
-* **Contact Form 7** - Mail tag to field mapping
-* **WPForms** - Native settings panel integration
-* **Fluent Forms** - Seamless settings tab integration
-
-= Key Features =
-
-* 🔐 **Secure API Key Authentication** - Your data is transmitted securely
-* 🗺️ **Visual Field Mapping** - Map form fields to Byteonic fields with an intuitive UI
-* 📋 **Multi-Form Support** - Connect multiple WordPress forms to different Byteonic forms
-* ⚡ **Real-time Forwarding** - Submissions are sent instantly to your Byteonic dashboard
-* 📊 **Centralized Dashboard** - View all submissions from multiple sites in one place
-* 🔄 **Auto-Detection** - Plugin automatically detects which form plugins are active
+It works universally with almost any WordPress form plugin by intercepting the standard browser form submission event. This ensures high compatibility and prevents lost submissions due to complex caching or server configuration rules.
 
 = How It Works =
 
-1. Install and activate the plugin
-2. Enter your Byteonic Intake API Key
-3. Go to any supported form plugin's settings
-4. Enable Byteonic Intake integration
-5. Map your form fields to Byteonic fields
-6. Submissions are now forwarded automatically!
+Unlike traditional plugins that require deep API integrations with specific form builders, Byteonic Intake uses a universal CSS selector method.
 
-= Requirements =
+1. Create a form in Byteonic Intake and get your API Key.
+2. Enter your API Key in the plugin settings to connect your WordPress site.
+3. Build your form on WordPress using your preferred tool (Elementor, Divi, Contact Form 7, etc.).
+4. In the Byteonic plugin dashboard, map your form by simply entering its HTML class or ID (e.g., .contact-form).
+5. Add the HTML "name" attributes for the fields you want to collect.
 
-* WordPress 5.8 or higher
-* PHP 7.4 or higher
-* A Byteonic Intake account ([Sign up free](https://intake.byteoniclabs.com))
-* At least one supported form plugin installed
+When a user submits the form on your website, our JavaScript captures the data and sends it securely to your local WordPress server. Your server then attaches your private API key and forwards the data to your Byteonic account in the background. The user experiences no delay, and your form functions exactly as it normally would.
 
-= Documentation =
+= Exact Compatibility =
 
-For detailed documentation, visit [Byteonic Intake Documentation](https://intake.byteoniclabs.com/docs).
+Because the plugin targets the HTML layer using CSS selectors, it works seamlessly with:
 
-= Support =
+* Elementor Pro Forms
+* Contact Form 7
+* Gravity Forms
+* WPForms
+* Fluent Forms
+* Ninja Forms
+* Divi Builder Forms
+* Custom HTML Forms
 
-Need help? Contact us at [[email protected]](mailto:[email protected]) or visit our [support page](https://byteoniclabs.com/support).
+= Core Features =
+
+* Universal CSS Interception: Connect any form just by specifying its class or ID.
+* Secure Local Proxy: API keys are stored securely in your WordPress database, never exposed in public JavaScript logic.
+* Zero Interference: The plugin uses background requests. It does not stop your primary form builder from sending its regular email notifications or saving to the local database.
+* Field Level Mapping: You control exactly which input fields are sent to the external dashboard.
+* Cross-Site Management: Connect dozens of client WordPress websites to a single Byteonic organization account.
+
+= Built For Agencies =
+
+Managing multiple client websites often means dealing with lost form submissions, broken SMTP plugins, and missing client emails. Byteonic Intake solves this by providing one unified dashboard where you can see every submission from every client site in real-time.
+
+Please note: You must have an active Byteonic Intake account to use this plugin. You can create a free account at intake.byteoniclabs.com.
+
+= Documentation & Support =
+
+For technical setup guides, including how to find CSS selectors and HTML name attributes on different form builders, visit the official Byteonic documentation. If you need direct assistance, contact our technical support team.
 
 == Installation ==
@@ -58 +65 @@
 = Automatic Installation =
 
-1. Go to **Plugins > Add New** in your WordPress admin
-2. Search for "Byteonic Intake"
-3. Click **Install Now** and then **Activate**
+1. Navigate to Plugins > Add New in your WordPress admin dashboard.
+2. Search for "Byteonic Intake".
+3. Click Install Now, followed by Activate.
 
 = Manual Installation =
 
-1. Download the plugin ZIP file
-2. Go to **Plugins > Add New > Upload Plugin**
-3. Choose the ZIP file and click **Install Now**
-4. Activate the plugin
+1. Download the Byteonic Intake ZIP file.
+2. Navigate to Plugins > Add New > Upload Plugin in your WordPress admin dashboard.
+3. Select the ZIP file and click Install Now.
+4. Click Activate.
 
-= Configuration =
+= Connecting Your Account =
 
-1. Navigate to **Byteonic Intake** in your WordPress admin menu
-2. Enter your API Key (get one from your [Byteonic Dashboard](https://intake.byteoniclabs.com/dashboard/settings/api-keys))
-3. Save your settings
-4. Go to your form plugin settings to configure individual forms
+1. Go to the new Byteonic Intake menu item in your WordPress dashboard.
+2. Enter your Byteonic API Key.
+3. Click Connect.
+4. Use the "Add New Integration" button to map your first form using its CSS selector.
 
 == Frequently Asked Questions ==
 
-= Where do I get an API Key? =
+= Where do I find my API Key? =
 
-Log in to your [Byteonic Intake Dashboard](https://intake.byteoniclabs.com) and navigate to **Settings > API Keys**. Click "Generate New Key" to create one.
+Log in to your Byteonic Intake account at intake.byteoniclabs.com, navigate to Settings, and open the API Keys section. Generate a new key and copy it into the WordPress plugin.
 
-= Which form plugins are supported? =
+= What is a CSS Selector? =
 
-Currently, we support:
-* Gravity Forms (requires license)
-* Contact Form 7 (free)
-* WPForms (Lite and Pro)
-* Fluent Forms (free and Pro)
+A CSS selector is how the plugin identifies your form on the webpage. It is usually a class (starting with a period, like .my-form) or an ID (starting with a hash, like #contact-form-1). Most form builders allow you to assign custom classes to your forms in their advanced settings.
 
-= Does this work with the free versions of form plugins? =
+= Does this disable my normal form notifications? =
 
-Yes! The integration works with both free and premium versions of all supported form plugins.
+No. Byteonic Intake runs in the background. Your existing form plugin will still send its regular email notifications and save entries to your local WordPress database as usual.
 
-= What happens if the API is unreachable? =
+= Does this work with free form plugins like Contact Form 7? =
 
-Your form submission will still be saved by your form plugin locally. The Byteonic forwarding will fail gracefully, and an error will be logged for debugging.
+Yes. The interception method works on the HTML level, meaning it is compatible with both free and premium versions of almost all form builders.
 
-= What data is sent to Byteonic? =
+= Is my API Key secure? =
 
-Only the form fields you explicitly map are sent, plus optional metadata like the submission URL and timestamp. No sensitive WordPress data is transmitted.
+Yes. The plugin uses a secure local PHP proxy. The background JavaScript sends the form data to your own WordPress server first. The server then attaches the hidden API key and makes the final HTTPS request to Byteonic. The key is never visible in the browser console.
 
-= Is my data secure? =
+= What happens if the API fails or the internet drops? =
 
-Yes. All data is transmitted over HTTPS using your unique API key for authentication. We follow industry-standard security practices.
-
-= Can I use this on multiple sites? =
-
-Yes! You can install the plugin on multiple WordPress sites and connect them all to the same Byteonic account.
-
-= What happens if I reach my plan's submission limit? =
-
-The plugin will receive an error from the API. The submission is still saved by your form plugin, but won't be forwarded to Byteonic. You'll see an error in your debug log.
+Because Byteonic Intake acts as a secondary background process, your primary form submission continues normally. If the external API request fails, the submission is not sent to Byteonic, but your local form plugin will still successfully process it.
 
 == Screenshots ==