Buyers / Clients English WordPress Plugin

Working Hours Sync for Listeo: Client Guide

Client guide for synchronizing Listeo business hours from Outscraper or Google Places with manual, bulk, and scheduled workflows.

Working Hours Sync for Listeo Version 1.0 13 min read Updated Jun 30, 2026
Purpose. Working Hours Sync for Listeo synchronizes listing business hours from external sources such as Outscraper and Google Maps Places into Listeo opening-hour fields.

What it does

The plugin helps keep opening hours current without manually editing every listing. It can sync a single listing, process listings in bulk, or run scheduled jobs depending on your settings. It stores the external Place ID and last sync time so administrators can track sync status.

SourcesOutscraper or Google Places depending on your configuration.
Single syncUpdate one listing from its Place ID or address.
Bulk syncProcess multiple listings with controlled concurrency and pagination.
Scheduled syncRun recurring updates for listings with auto-sync enabled.

Requirements

  • WordPress with Listeo installed.
  • Administrator access.
  • Outscraper API key or Google Places API key depending on your selected source.
  • Listings with accurate addresses or Place IDs.
  • A valid plugin license when required by your package.

Initial setup

  1. Install and activate the plugin.
  2. Open the Working Hours Sync settings screen.
  3. Add your Outscraper API key or Google Places API key.
  4. Select the sync source.
  5. Choose interval, concurrency, listings per page, date/time format, and link behavior.
  6. Use the API test button before running a real sync.
  7. Test one listing, then run a small bulk batch.

Listing-level controls

Each listing can store a Place ID and an auto-sync flag. Use the Place ID whenever possible because it is more reliable than matching by address. The plugin also records the last sync timestamp so your team can see whether a listing has been updated recently.

FieldWhat it means
Place IDExternal location identity used by Google/Outscraper lookups.
Auto syncControls whether the listing participates in scheduled sync jobs.
Last syncShows the latest successful sync time.

Recommended workflow

  1. Choose one test listing with known correct hours.
  2. Add or confirm its Place ID.
  3. Run a single sync.
  4. Compare the public Listeo schedule with the source data.
  5. Enable auto-sync only after the single sync is correct.
  6. Run a small bulk sync and review results.

Bulk sync guidance

Bulk sync can touch many listings, so start with conservative settings. Low concurrency is slower but safer for shared hosting and external API limits. Increase only after you understand response times, provider limits, and server capacity.

Backup first. Business hours affect customer trust. Back up the database before large syncs, especially after imports or before seasonal updates.

Quality checklist

  • The selected source API key tests successfully.
  • Test listing has the correct Place ID.
  • Timezone is correct on the public listing page.
  • Closed days, 24-hour days, and split schedules are reviewed.
  • Bulk concurrency is appropriate for hosting and API limits.
  • Listings with manual exceptions are not blindly overwritten.

Troubleshooting

ProblemWhat to check
API test failsCheck API key, billing, provider permissions, and selected source.
Listing cannot syncCheck Place ID and address accuracy.
Hours are wrongCheck source data, timezone, and whether the business has special holiday hours.
Bulk sync stopsReduce concurrency and listings per page, then retry.
Auto sync does not runCheck WP-Cron or configure a real server cron job.