Modules / Catalog Tools

ExpertPress Catalog Tools

Move many services at once.

FreeIn testing

Status: In testing · Plan: Free

Catalog Tools adds CSV import and export for the ExpertPress catalog. Site staff can download practice areas, languages, custom field definitions and services as a spreadsheet, edit them, and upload them back. Imported services never go live on their own: they are saved as drafts or sent to the usual moderation queue.

Key capabilities

  • Export of four catalog lists to CSV: directions (practice areas), languages, attributes (custom field definitions) and services.
  • CSV templates with the current import headers, so you can fill in a file from scratch.
  • Import with column mapping: after upload you match each file column to an ExpertPress field, see a preview of the first rows, and save the mapping as a preset for next time.
  • Dry-run (on by default): the whole file is checked and a report is produced without writing anything.
  • Stable external keys: every row carries an external_key. Importing the same key again updates the same record instead of creating a duplicate.
  • Optional cover downloads for services from a cover_url column, limited to hosts you approve.
  • Background processing for large files (more than 200 rows) through Action Scheduler, one import at a time, with a downloadable report for each job.
  • Spreadsheet-friendly output: semicolon, comma or tab delimiter, optional UTF-8 BOM for Excel, UTF-8 or Windows-1251 encoding.
  • Formula protection: cells that start like a spreadsheet formula are neutralised on export and on import.

What it does not do

  • It does not import or create user accounts, specialist profiles, bookings, orders, payments or reviews. A file whose headers look like money, order or user data is rejected.
  • It never publishes a service. Services go to Draft or to Check before publishing (see Moderation).
  • It cannot move a service to another specialist: a row that changes the owner is rejected.

Requirements

  • Requires Plugins: expertpress (ExpertPress Core). The Core version must include the catalog CSV interface for this module. With an older or incompatible Core, administrators see the notice “Catalog Tools requires an ExpertPress Core with Catalog CSV ABI 1 owned by catalog-tools. CSV handlers are inactive.” and nothing else is registered.
  • WordPress 6.0+, PHP 7.4+.
  • Action Scheduler is needed for files with more than 200 rows and for any import that downloads covers. Core does not bundle it; it is available, for example, through WooCommerce or the standalone Action Scheduler plugin. Without it, files up to 200 rows still import in one request.
  • For Windows-1251 files the server needs the PHP mbstring or iconv extension.
  • External services: none by default. When cover downloads are turned on, the site fetches images over HTTPS only from the hosts you list in the settings, and only for jobs where you tick the per-job option.

Who sees what

  • Clients: nothing directly. Imported services appear in the public catalog only after a moderator approves them.
  • Specialists: services imported for them appear in their account as drafts or as services waiting for moderation, exactly as if they had saved them themselves.
  • Site team: accounts with the expertpress_operate permission (Administrator, ExpertPress Manager) get a Catalog CSV (Каталог CSV) tab under ExpertPress → Settings and an Import / export (Імпорт / експорт) item in the Catalogue group of the ExpertPress menu. Both open the same screen. See Roles and access.

Data and removal

  • Uploaded files, job records and reports are kept in a private storage folder (not in the Media Library). Reports can be downloaded for 14 days; after that, daily cleanup removes finished jobs. Jobs waiting for staff action are never cleaned up.
  • Deactivating the plugin stops the daily cleanup but keeps all jobs, files and settings.
  • Deleting the plugin keeps CSV jobs, files and settings unless the site-wide ExpertPress data deletion on uninstall is switched on. With it on, the plugin deletes its own jobs, files and settings. Catalog data, external keys and covers that were already imported always stay.

Next