IQ-Dynamic-Google-Pricing/QUICKSTART.md

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)

cd /path/to/informatiq-smart-google-pricing
./setup-vendor.sh

Option B: Manual Composer

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. 🎉