Hooks for developers
Updated
The Tidelist Pro add-on and other developers extend the free plugin only through these hooks. All names start with tidelist_.
Filters
| Filter | Arguments | Default | Purpose |
|---|---|---|---|
tidelist_is_pro_active |
bool $active |
false |
The Pro add-on returns true when it has an active licence. |
tidelist_max_accounts |
int $max |
1 |
How many marketplace accounts can be connected. |
tidelist_auto_update |
bool $on |
false |
Update adverts when a product changes. |
tidelist_auto_relist |
bool $on |
false |
Put a taken-down advert back online when the item is restocked. |
tidelist_price |
float $price, array $item, int $category_id |
converted price | Final say on the price in the marketplace currency. |
tidelist_listing |
Listing $listing, array $item |
built listing | Last chance to change the advert before it is sent. Return a Listing. |
tidelist_build_settings |
array $settings, array $item |
plugin settings | Settings the builder uses for one item, for example per-category templates. |
tidelist_measurements |
string $text, int $product_id, int $variation_id |
'' |
Text for the {measurements} placeholder. |
tidelist_register_admin_tabs |
array $tabs |
[] |
Add screens under WooCommerce. |
Actions
| Action | Arguments | When |
|---|---|---|
tidelist_after_product_change |
int[] $listing_ids, int $post_id |
A product that has adverts changed. |
tidelist_scheduler_tick |
none | Once an hour, at the end of the sweep. |
Rules for add-ons
- The free plugin contains no disabled Pro code. Pro behaviour comes only through these hooks.
- The safety rules cannot be bypassed: dry-run, pause, the request allow-list and the typed confirmation apply to everything that talks to the marketplace.
- An add-on must not publish adverts on its own. Publishing stays a decision of the shop owner.
Helpers
Tidelist\Plugin::is_pro() and Tidelist\Plugin::max_accounts() apply the filters above.
Related pages
- Tidelist Pro licence and updates
Activate a Tidelist Pro key, move it to another site, understand what happens when it expires, and get updates from the normal WordPress update screen.
- Safety, dry-run and pause
How Tidelist protects your OLX account: dry-run on by default, a pause switch, typed confirmation, a request allow-list and encrypted credentials.