# Form Referral Source Plugin - Installation Instructions

## Requirements
- WordPress 6.8.3 or higher
- PHP 8.0 or higher
- At least one supported form plugin:
  - Formidable Forms
  - Fluent Forms

## Installation Steps

### Method 1: WordPress Admin (Recommended)
1. Download the plugin zip file
2. Go to WordPress Admin > Plugins > Add New
3. Click "Upload Plugin" 
4. Choose the zip file and click "Install Now"
5. Activate the plugin
6. Go to Settings > Form Referral Source to configure

### Method 2: Manual Installation
1. Extract the plugin files
2. Upload the entire 'form-attribution-tracking' folder to '/wp-content/plugins/'
3. Activate the plugin through the WordPress admin panel
4. Go to Settings > Form Referral Source to configure

### Method 3: Development Installation
1. Clone or download the repository
2. Place in '/wp-content/plugins/form-attribution-tracking/'
3. If you have Composer installed, run: `composer install --no-dev`
4. Activate the plugin through the WordPress admin panel

## First Time Setup

### Basic Configuration
1. Go to Settings > Form Referral Source
2. Configure your preferences:
   - Enable "Auto-add to new forms" for automatic integration
   - Set your preferred field name (default: "referral_source")
   - Set cookie duration (default: 30 days)
   - Enable debug mode if needed for troubleshooting

### Add to Existing Forms
1. Go to Settings > Form Referral Source > Integrations tab
2. Click "Add to All Forms" for each form plugin you want to enable
3. Or use the Forms tab to see individual form status

## Verification

### Check if Working
1. Visit your website in a new browser/incognito window
2. Navigate to a page with a form
3. Check browser developer tools console (if debug mode is enabled)
4. Fill out and submit a form
5. Check the form submission data for the referral source field

### Test Different Sources
- Direct visit: Should show "direct"
- From Google: Should show "google" 
- From Facebook: Should show "facebook"
- With UTM parameters: Should show the utm_source value

## Troubleshooting

### Plugin Not Working
- Check WordPress error logs
- Enable debug mode in plugin settings
- Verify form plugins are active and compatible
- Ensure JavaScript is enabled in browser

### Fields Not Populating
- Check that field name matches plugin settings
- Verify timing of form rendering
- Enable debug mode and check browser console
- Test with different form types

### Integration Issues
- Verify the form plugin is supported and active
- Check for plugin conflicts
- Review WordPress and PHP error logs
- Test with default WordPress theme

## Support
For issues, questions, or feature requests, please check the plugin documentation or contact the plugin author.
