Skip to main content

🌐 Sites Processing

📖 Overview

The Sites module handles thumbnail generation and business information synchronization for client websites.

Environment Flags:

  • QM_SITES_BUILD_THUMBNAILS=true - Thumbnail generation
  • QM_SITE_UPDATE_BUSINESS=true - Business info updates

Source Location: queue-manager/crons/sites/

Processing Pattern: On-demand + Periodic updates

🗄️ Collections Used

site

  • Operations: Read/Update
  • Model: shared/models/site.js
  • Usage: Website records and metadata

site-thumbnail

  • Operations: Create/Update
  • Model: shared/models/site-thumbnail.js
  • Usage: Store generated thumbnails

🔧 Jobs in This Module

Build Thumbnails

Overview: Generates website thumbnails using Puppeteer.

Key Features:

  • Screenshot Capture: Full-page and above-the-fold captures
  • Multiple Sizes: Desktop, tablet, mobile views
  • S3 Storage: Uploads to cloud storage
  • Lazy Generation: On-demand or scheduled
  • Cache Management: Updates on site changes

Processing:

  1. Query sites needing thumbnails
  2. Load site URL in headless browser
  3. Capture screenshots at different viewports
  4. Optimize images (compression, resize)
  5. Upload to S3
  6. Update site record with URLs

Update Business

Overview: Synchronizes business information across site platforms.

Key Features:

  • NAP Consistency: Name, Address, Phone updates
  • Hours of Operation: Business hours sync
  • Service Updates: Services/products synchronization
  • Multi-Platform: Updates Duda, WordPress, custom sites

Module Status: Active
Execution Pattern: On-demand + Scheduled
Last Updated: 2025-10-10

💬

Documentation Assistant

Ask me anything about the docs

Hi! I'm your documentation assistant. Ask me anything about the docs!

I can help you with:
- Code examples
- Configuration details
- Troubleshooting
- Best practices

Try asking: How do I configure the API?
09:31 AM