WooAdsIntelligence Documentation

  • How to Install: Download the .zip file from your purchase email or LemonSqueezy dashboard. Go to WordPress Admin > Plugins > Add New > Upload Plugin.
  • License Activation: After installation, go to Ads Intelligence > License. Paste your license key and click “Activate”. Your license must be active to access the dashboard and updates.
  • System Requirements: Ensure you have WooCommerce installed and active. Recommended PHP version: 7.4 or higher.
  • Understanding Metrics: A breakdown of Net Profit, ROI (Return on Investment), and ROAS (Return on Ad Spend).
  • Date Range Filtering: How to use the calendar to compare different periods (e.g., This Month vs Last Month).
  • Top Products & Categories: How to identify your most profitable items based on real data.
  • Manual Entry: Go to Ads Intelligence > Ad Spend. Select the date and enter your total spend for Facebook, Google, etc.
  • Bulk CSV Upload: (If we have implemented this) Instructions on how to format your CSV to upload ad costs for a whole month at once.
  • Individual Product Cost: How to set the “Cost of Goods Sold” inside the WooCommerce product edit page.
  • Bulk COGS Editor: Go to Ads Intelligence > Cost Settings. Use the bulk editor to update costs for hundreds of products simultaneously to save time.
  • Exporting PDF Reports: Click the “Export PDF” button on the dashboard to generate a professional performance summary.
  • Branding (White Label): Go to Ads Intelligence > Report Settings to upload your own logo and company name that will appear on all exported PDFs.
  • Email Reports: How to trigger a test email or set up scheduled performance summaries.
  • “License Not Active” Error: Ensure your subscription hasn’t expired and that you aren’t using the key on more sites than your plan allows.
  • Data Not Showing Up: Check if you have entered Ad Spend and Product Costs. The dashboard needs these values to calculate profit.
  • Missing Orders: Ensure your orders are marked as “Completed” or “Processing” in WooCommerce to be counted in the stats.

Advanced Dynamic Discount Engine Documentation

  • How to Install (OCMOD): Go to Admin > Extensions > Installer and upload the .ocmod.zip file. After a successful upload, navigate to Admin > Extensions > Modifications and click the “Refresh” button. Finally, install “Advanced Dynamic Discount” under both Extensions > Modules and Extensions > Order Totals.
  • License Activation: Open Extensions > Discounts > Discount Rules to access the module settings. Enter your LemonSqueezy license key and save to activate the extension.
  • System Requirements: Ensure you are running OpenCart 3.0.x. The recommended PHP version is 7.2 or higher, along with PDO, JSON, and MBString extensions.
  • Rule Configuration: Click “Add New Rule” to set up your discounts across four dedicated tabs: General, Conditions, Discount, and Advanced.
  • Time & Group Rules: Schedule discounts precisely by setting specific dates, times, and days of the week, or restrict your offers to specific customer groups.
  • Visual Priority: Manage the execution order of your rules effortlessly using the built-in drag & drop sorting feature.
  • Multiple Discount Types: Choose from a variety of setups including flat amounts, percentages, or tiered discounts based on product price, line total, quantity, or stock levels.
  • Stacking Logic: Set a rule to “Exclusive” to stop the engine from processing other rules when matched, or choose “Cumulative” to combine offers. Cumulative rules can calculate the discount from the original base price or the already discounted base.
  • Bulk CSV Management: Use the CSV import/export feature to manage large amounts of rules in bulk using a human-readable format.
  • Combined Include Matching: Include fields are evaluated as an intersection. For example, if you select an Include Category (“Summer”) and an Include Manufacturer (“Vichy”), the rule applies only to products that match both criteria.
  • Empty Fields: Any include fields left empty during rule creation are simply ignored by the engine.
  • Exclude Rules: Exclude selections (Category, Product, or Manufacturer) are absolute and always win after the initial include check passes.
  • Safe Upgrades: Do not uninstall the module first for a normal upgrade, as version 1.0.19 safely preserves your rule tables. Back up your database, upload and overwrite the existing files, install the .ocmod.zip package, refresh modifications, and clear all OpenCart and Journal caches.
  • Full Removal: To completely remove all module data from your store, you must manually drop the advanced_discount_rule and advanced_discount_log tables after taking a full database backup.
  • Verifying Upgrades: To confirm your live shop is running the correct files after an update, test the storefront AJAX endpoint by visiting index.php?route=extension/module/advanced_discount/prices&ad_version=1.0.19&product_ids=PRODUCT_ID. If the JSON response shows an older version, manually overwrite the module files again.
  • License Security: To prevent keys from being used across different LemonSqueezy products, you can optionally fill in the Store ID, Product ID, Variant ID, and Customer Email in the module settings for strict validation.
  • Theme Conflicts: The engine is built for full compatibility with standard OpenCart themes and is specifically optimized for Journal 3 with automatic badges.