168 lines
4.0 KiB
Markdown
168 lines
4.0 KiB
Markdown
# 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.** 🎉
|