ALS Forms – Professional WordPress Form Builder Plugin
=====================================================

1. Introduc**🔗 Advanced Integrations**
- Webhook: Send form data to any external URL
- Slack: Receive notifications in your Slack channel
- Discord: Get instant notifications on Discord
- Mailchimp: Automatically add users to mailing lists
- Google reCAPTCHA: Anti-spam protection

**⚖️ Exclusive Field Types**
- GDPR Consent: Checkbox with customizable privacy policy text and link
- Radio with Image: Visual radio options with images

**🏆 Priority Support**
- Direct developer access and dedicated support-----------
ALS Forms is a powerful, user-friendly WordPress plugin for creating, managing, and displaying custom forms. Designed for both beginners and advanced users, it offers a drag-and-drop builder, modern layouts, GDPR compliance, file uploads, and robust admin features. The plugin is fully localized in English and ready for translation.

2. Features
-----------
- **Drag & Drop Form Builder**: Intuitive interface for creating forms with various field types (text, email, dropdown, radio, checkbox, file upload, GDPR consent, etc.).
- **Multiple Layouts**: Choose between standard and elegant image layouts, with customizable design options.
- **Shortcode Integration**: Easily embed forms anywhere using the [als_form id="..."] shortcode.
- **Submission Management**: View, search, and export form submissions from the admin dashboard.
- **GDPR Compliance**: Built-in GDPR consent field with customizable text and policy link.
- **File Upload Support**: Secure file uploads with validation and styling.
- **Email Notifications**: Configurable admin notifications for new submissions.
- **Modal Overlay**: Success messages and overlays are visually appealing and accessible.
- **Admin Settings**: Centralized settings page for all plugin options.
- **Statistics Dashboard**: Overview of forms, submissions, and top-performing forms.
- **Localization Ready**: All user/admin messages in English, with text domain for translation.

3. Technical Architecture
-------------------------
- **Directory Structure**:
  - `als-forms.php`: Main plugin file, hooks, AJAX, and asset loading.
  - `includes/admin/`: Admin dashboard, menu, builder, list, settings, submissions.
  - `includes/frontend/`: Shortcode rendering and submission handling.
  - `assets/`: CSS, JS, fonts, and images for frontend and admin UI.
  - `languages/`: For translation files.
  - `src/`: Vue components and JS for builder UI.
- **Database Tables**:
  - `als_forms`: Stores form definitions, layouts, design, and settings.
  - `als_form_submissions`: Stores user submissions per form.
- **Frontend**:
  - Modern CSS for layouts and overlays.
  - Vue.js-powered admin builder (bundled as JS).
  - WordPress shortcodes for embedding forms.
- **Backend**:
  - PHP for all admin and frontend logic.
  - AJAX handlers for saving/loading forms.
  - WordPress hooks for asset loading and security.

4. Installation & Setup
-----------------------
- **Requirements**:
  - WordPress 5.6+
  - PHP 7.4+
- **Installation**:
  1. Upload the plugin folder to `/wp-content/plugins/`.
  2. Activate via WordPress admin > Plugins.
- **First Steps**:
  1. Go to "ALS Forms" in the admin menu.
  2. Click "Add New Form" to launch the builder.
  3. Customize fields, layout, and design.
  4. Save and copy the shortcode to any page/post.

5. Security
-----------
- **Input Sanitization**: All user/admin input is sanitized and validated before saving.
- **Output Escaping**: All dynamic output is escaped for HTML, attributes, and URLs.
- **CSRF Protection**: All AJAX and form submissions use WordPress nonces.
- **File Uploads**: Only allowed file types and sizes are accepted; files are sanitized and stored securely.
- **User Permissions**: Only admins can manage forms and view submissions.

6. Administration
-----------------
- **Dashboard**: Overview of total forms, submissions, and top forms.
- **Form Management**: Create, edit, duplicate, and delete forms.
- **Submission Management**: View, search, and export submissions (CSV/JSON).
- **Settings**: Configure email notifications, GDPR text, and other options.

7. Localization
---------------
- All user and admin messages are in English.
- Text domain: `als-forms` (ready for translation via .po/.mo files).

8. External Services
--------------------
This plugin may connect to external services under certain conditions:

**Freemius SDK**
- Purpose: Plugin analytics, licensing, and premium features management
- Service URL: https://api.freemius.com/
- When used: During plugin activation, deactivation, and periodic analytics (if opted in)
- Data transmitted:
  - Basic WordPress site information (version, plugins, theme)
  - Plugin usage statistics (if opted in)
  - User preferences and opt-in choices
- Privacy Policy: https://freemius.com/privacy/
- Terms of Service: https://freemius.com/terms/
- User Control: Users can opt-out of data collection during plugin activation
- WordPress.org Compliance: Plugin is configured for WordPress.org compliance mode

**Important Notes:**
- The external service is optional and requires explicit configuration or user consent
- Users have full control over data collection preferences
- No data is sent to external services without user knowledge or consent

9. FAQ
------
- **How do I add a form to my site?**
  - Use the shortcode `[als_form id="1"]` (replace 1 with your form ID).
- **How do I enable/disable admin email notifications?**
  - Go to ALS Forms > Settings and toggle the notification option.
- **How do I export submissions?**
  - Go to Submissions, select a form, and use the export button.
- **Is the plugin GDPR compliant?**
  - Yes, with a customizable consent field.

10. Support & Contact
---------------------
- For support, contact the developer via the plugin page or provided email.

11. License
-----------
- Recommended: GPL v2 or later (compatible with WordPress marketplace requirements).

**ALS Forms PRO - Premium Version Available**

For users who need advanced features, ALS Forms PRO offers:

**� Advanced Integrations**
- Webhook: Send form data to any external URL
- Slack: Receive notifications in your Slack channel
- Discord: Get instant notifications on Discord
- Mailchimp: Automatically add users to mailing lists
- Google reCAPTCHA: Anti-spam protection

**� Priority Support**
- Direct developer access and dedicated support

ALS Forms PRO is fully separated from the free version with its own database tables, options, shortcodes (`[als_form_pro id="..."]`), and admin menu, ensuring no conflicts.

---

**End of Documentation**
