# Quick Start Guide

Get the plugin running in under 10 minutes!

## For Developers/Distributors

### 1. Install Google API Client Library

Choose the easiest method for you:

**Option A: One-command setup (Recommended)**
```bash
cd /path/to/informatiq-smart-google-pricing
./setup-vendor.sh
```

**Option B: Manual Composer**
```bash
cd /path/to/informatiq-smart-google-pricing
composer install --no-dev --optimize-autoloader
```

**Option C: Already have vendor?**
If you already ran Composer or have the vendor directory, skip this step!

### 2. Distribute

Now you can:
- ZIP the entire plugin directory (including `vendor/`)
- Upload to WordPress
- Share with clients
- No Composer required for end users!

The complete package will be ~2-3 MB (compressed) or ~10-15 MB (uncompressed).

---

## For End Users (Installing the Plugin)

### 1. Upload Plugin

- Upload the complete plugin folder to `/wp-content/plugins/`
- Or use WordPress admin: Plugins > Add New > Upload Plugin

### 2. Activate

- Go to Plugins in WordPress admin
- Find "informatiq-smart-google-pricing"
- Click "Activate"

### 3. Configure Google Merchant Center

You need:
- Google Merchant Center account with products
- Google Service Account JSON key

**Don't have these yet?** See `INSTALLATION.md` for detailed setup instructions.

### 4. Enter Settings

Navigate to **WooCommerce > Smart Pricing**

**Required Settings:**
- **Google Merchant ID**: Your Merchant Center ID
- **Service Account JSON**: Paste the entire JSON key
- **Minimum Margin**: Set your desired profit margin (e.g., 10%)

**Optional Settings:**
- **Enable Automatic Updates**: Check to enable daily automation
- **Update Frequency**: How often to update prices

### 5. Test Connection

- Click "Test Google API Connection" button
- Wait for success message
- If it fails, double-check your credentials

### 6. Run First Sync

- Click "Run Manual Sync Now" button
- Watch the progress
- Review updated prices in the logs below

### 7. Done!

The plugin will now:
- Run automatically based on your schedule
- Only update in-stock products
- Never sell below your minimum margin
- Log all price changes for review

---

## Troubleshooting

### "Google API Client library is missing"

The vendor directory wasn't included. Either:
1. Download the complete package with vendor included
2. Run `composer install` in plugin directory
3. See `VENDOR-SETUP.md` for manual download instructions

### "Connection failed"

Check:
- Merchant ID is correct (numbers only)
- Service Account JSON is valid (should start with `{`)
- Service account has access to your Merchant Center
- Content API for Shopping is enabled in Google Cloud

### "No competitor price found"

This means:
- Product doesn't exist in Google Merchant Center, OR
- Product SKU doesn't match, OR
- No competitive pricing data available for that product

Ensure products have matching SKUs between WooCommerce and Google Merchant Center.

### Prices not updating automatically

Check:
- "Enable Automatic Updates" is checked in settings
- WordPress cron is running (install WP Crontrol plugin to verify)
- Look for `informatiq_sp_daily_price_update` cron event

---

## Next Steps

### Optimize Your Pricing Strategy

1. **Set Product Costs**: Use WooCommerce Cost of Goods plugin
   - This allows accurate margin calculations
   - Prevents selling below cost

2. **Monitor Logs**: Check daily updates
   - WooCommerce > Smart Pricing > Today's Price Updates
   - Review which products are being updated

3. **Adjust Settings**: Fine-tune based on results
   - Increase minimum margin if needed
   - Change update frequency for competitive markets

4. **Review WooCommerce Logs**: For debugging
   - WooCommerce > Status > Logs
   - Look for `informatiq-smart-pricing` logs

### Advanced Features

See `INSTALLATION.md` for:
- Custom cron schedules
- Hooks and filters for customization
- Security best practices
- Detailed troubleshooting

---

## Support

Need help?
- Email: contact@malin.ro
- Website: https://informatiq.services

---

**That's it! Your automated competitive pricing is now live.** 🎉
