> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pureclarity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce Settings Configuration

> Complete guide to configuring PureClarity WooCommerce plugin settings for optimal performance and customization

<Note>
  Access the PureClarity settings through WooCommerce > PureClarity > Settings tab. Ensure you have administrator privileges to modify these settings.
</Note>

## General Settings

### Account Configuration

**Access Credentials**

* **AccessKey** - Your unique PureClarity identifier
* **SecretKey** - Secure authentication token
* **Region** - Server location (USA/Europe/UK)

<Warning>
  Never share your SecretKey publicly. If compromised, regenerate immediately through your PureClarity admin console.
</Warning>

**Store Information**

* Store name and description
* Primary language settings
* Currency configuration
* Timezone settings

### Display Mode Settings

Control how PureClarity appears to visitors:

**Live Mode**

* All visitors see personalized recommendations
* Full production experience active
* Real-time AI personalization enabled

**Test Mode (Admin Only)**

* Only administrators see recommendations
* Perfect for testing configurations
* Safe environment for changes

**Disabled Mode**

* No recommendations displayed
* PureClarity hidden from frontend
* Data collection continues in background

<Tip>
  Use Test Mode when making configuration changes to avoid impacting customer experience during setup.
</Tip>

## Zone Settings

### Default Zone Configuration

**Homepage Zones**

* Enable/disable individual homepage zones
* Customize zone titles and descriptions
* Set product display limits (4-12 recommended)
* Configure responsive behavior

**Product Page Zones**

* Related products placement
* Cross-sell recommendation areas
* Recently viewed products
* Personalized suggestions

**Category Page Zones**

* Top products in category
* Alternative suggestions
* Trending items display
* Cross-category recommendations

**Cart & Checkout Zones**

* Upsell opportunities
* Frequently bought together
* Last chance offers
* Complementary products

### Zone Customization Options

**Visual Settings**

* Zone titles and headings
* Product display layout (grid/list)
* Image sizes and aspect ratios
* Color scheme customization

**Behavioral Settings**

* Number of products per zone
* Lazy loading configuration
* Mobile responsiveness
* Animation and transition effects

<Info>
  Limiting zones to 4-8 products typically provides the best balance of choice and decision-making efficiency for customers.
</Info>

## Data Feed Settings

### Feed Scheduling

**Automatic Feeds**

* Daily full feed timing (default: 1:00 AM)
* Delta feed frequency (default: every 2 hours)
* Weekend processing options
* Holiday schedule adjustments

**Manual Feed Controls**

* On-demand feed execution
* Selective feed types
* Priority processing queues
* Bulk feed operations

### Feed Content Configuration

**Product Feed Options**

* Include/exclude product statuses
* Category filtering rules
* Price range limitations
* Inventory requirements

**Advanced Feed Settings**

* Batch processing size
* Memory usage limits
* Processing timeouts
* Error handling thresholds

<Warning>
  Increasing batch sizes improves speed but requires more server resources. Monitor your server performance when adjusting these settings.
</Warning>

## Product Attribute Mapping

### Standard Attributes

Map WooCommerce attributes to PureClarity fields:

**Basic Mapping**

* Product name → title
* SKU → identifier
* Price → cost
* Description → summary

**Enhanced Mapping**

* Custom attributes → PureClarity fields
* Category hierarchy → classification
* Product tags → keywords
* Variations → attributes

### Custom Field Integration

**WooCommerce Meta Fields**

* Advanced Custom Fields (ACF) integration
* Custom product metadata
* Third-party plugin data
* External system synchronization

**Data Transformation**

* Field format conversion
* Unit standardization
* Currency normalization
* Language translation

## Performance Settings

### Caching Configuration

**Page Caching Compatibility**

* Cache exclusion rules
* Dynamic content handling
* CDN integration settings
* Browser caching optimization

**Database Optimization**

* Query performance settings
* Index optimization
* Cleanup schedules
* Archive management

### Resource Management

**Server Resource Limits**

* PHP memory allocation
* Execution time limits
* Concurrent process limits
* Queue management

**Frontend Performance**

* JavaScript loading optimization
* CSS minification settings
* Image lazy loading
* Content delivery network

<Tip>
  Enable lazy loading for below-the-fold zones to improve initial page load times while maintaining recommendation functionality.
</Tip>

## Security and Privacy Settings

### Data Protection

**GDPR Compliance**

* Cookie consent integration
* Data retention policies
* User data deletion
* Privacy preference management

**Data Anonymization**

* Customer data masking
* Session tracking options
* IP address handling
* Behavioral data limits

### Access Controls

**User Permissions**

* Role-based access control
* Feature-specific permissions
* API access management
* Audit trail logging

## Integration Settings

### Third-Party Compatibility

**Payment Gateway Integration**

* Order tracking configuration
* Revenue attribution
* Transaction data mapping
* Conversion tracking

**Marketing Tool Integration**

* Email marketing platforms
* Analytics tools
* CRM systems
* Social media platforms

### API Configuration

**Webhook Settings**

* Real-time data synchronization
* Event trigger configuration
* Endpoint security
* Retry logic settings

**Custom Integrations**

* Developer API access
* Custom endpoint creation
* Data export options
* Integration testing tools

## Troubleshooting Settings

### Debug Configuration

**Logging Levels**

* Error logging only
* Warning and error logging
* Full debug logging
* Custom log destinations

**Diagnostic Tools**

* Connection testing
* Feed validation
* Performance monitoring
* Error reporting

### Maintenance Mode

**Temporary Disabling**

* Emergency shutdown options
* Maintenance windows
* Gradual rollback procedures
* Service restoration

<Info>
  Enable detailed logging temporarily when troubleshooting issues, but disable it in production to avoid large log files impacting server performance.
</Info>

## Advanced Configuration

### Custom Templates

**Zone Template Customization**

* Custom HTML/CSS templates
* PHP template modifications
* Responsive design options
* A/B testing configurations

### Developer Options

**Code Integration**

* Custom hooks and filters
* API extension points
* Event listener registration
* Custom functionality development

## Settings Backup and Restore

### Configuration Export

Export your settings for backup or migration:

1. Navigate to Settings > Export
2. Select configuration sections
3. Download settings file
4. Store securely for restoration

### Settings Import

Restore or migrate configurations:

1. Access Settings > Import
2. Upload settings file
3. Select import options
4. Verify configuration integrity

<Warning>
  Always test imported settings in a staging environment before applying to production sites.
</Warning>

## Related Resources

* [WooCommerce Installation Guide](/integrations/woocommerce/installation)
* [Dashboard Overview](/integrations/woocommerce/dashboard-overview)
* [Data Feeds Management](/integrations/woocommerce/data-feeds)
* [Zone Configuration](/integrations/woocommerce/zones)
* [Troubleshooting Guide](/integrations/woocommerce/troubleshooting)