Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

122 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

๐Ÿ‡ฆ๐Ÿ‡บ 3S Soft Price & Stock Sync for Dropshipzone

WordPress Plugin Directory GitHub Release WordPress WooCommerce PHP License PRs Welcome

A WooCommerce integration for Australian dropshippers using Dropshipzone.

This plugin is an independent integration. It is not affiliated with, endorsed by, or sponsored by Dropshipzone Pty Ltd. "Dropshipzone" is a trademark of its respective owner and is used here only to describe the service the plugin connects to.

Sync prices, stock and shipping rates from the Dropshipzone supplier API, import catalogue products, and submit orders for fulfilment.

๐ŸŒ Official WordPress Plugin ยท ๐Ÿ“ฆ Download Latest Release ยท ๐Ÿ› Report Bug ยท โœจ Request Feature


๐Ÿš€ What's New

See CHANGELOG.md for full release notes.

Version 3.3.x โ€” WordPress.org compliance

  • ๐Ÿท๏ธ Renamed to 3S Soft Price & Stock Sync for Dropshipzone (slug 3s-soft-price-stock-sync-for-dropshipzone)
  • ๐Ÿ”ค Code prefix widened from dsz_ to dszsync_, with a one-time migration โ€” see Upgrading from 3.0.x or earlier
  • ๐Ÿ”’ Security โ€” client-supplied product data is now fully sanitized before import; output escaping corrected throughout
  • ๐Ÿ—„๏ธ SQL โ€” table identifiers use the %i placeholder, so every query is genuinely prepared
  • ๐Ÿ“„ External Services disclosure documenting every API call and the data it carries

Version 3.0.0 โ€” Orders

  • ๐Ÿ“ฎ Tracking Number Sync โ€” pulls tracking and status from Dropshipzone into WooCommerce orders
  • ๐Ÿ“ฆ Bulk & Auto Order Submission โ€” orders-list bulk action, chunked bulk tool, optional submit-on-payment
  • ๐Ÿ’ต Profit Calculator โ€” per-order profit and a margin column on the products list

Version 2.9.0 โ€” Pricing

  • ๐ŸŽฏ Advanced Price Rules โ€” per-category, per-supplier or per-SKU-prefix markup overrides

โœจ Features

Core Synchronization

Feature Description
๐Ÿ”„ Price Sync Update regular and sale prices from supplier cost
๐Ÿ“ฆ Stock Sync Keep stock quantities accurate, with buffer and out-of-stock rules
โฐ Scheduled Sync Hourly, twice daily, or daily
โ–ถ๏ธ Manual Sync Run any time from the Sync Center
๐Ÿ“Š Batch Processing Chunked with continuation, handles large catalogues

Product Management

Feature Description
๐Ÿ›๏ธ Product Import Search and import from the Dropshipzone catalogue
๐Ÿค– Auto Import Scheduled imports with filters and a supplier blacklist
๐Ÿ’พ Import Templates Save and reuse filter presets
๐Ÿ“ˆ Import Metrics 7-day and 30-day stats plus run history
๐Ÿ—บ๏ธ Product Mapping Link WooCommerce products to Dropshipzone SKUs
๐Ÿ” Scan Unmapped Detect and link existing products automatically
๐Ÿ”ƒ Granular Resync Refresh images, categories, or everything
๐Ÿ“ค CSV Export Export all product mappings

Order & Shipping

Feature Description
๐Ÿ“ฎ Order Submission Manual, bulk, or automatic on payment
๐Ÿšš Shipping Rates Live rates from Dropshipzone zone mapping and per-SKU rates
๐Ÿ‡ณ๐Ÿ‡ฟ New Zealand Flat-rate NZ shipping via the standard scheme
๐Ÿ“ Tracking Sync Tracking numbers and status pulled back into orders
๐Ÿ’ต Profit Reporting Order profit and products-list margin column

Pricing & Rules

Feature Description
๐Ÿ’ฐ Flexible Markup Percentage or fixed amount
๐ŸŽฏ Advanced Rules Override markup by category, supplier or SKU prefix
๐Ÿงฎ GST Support Include or add 10% Australian GST
๐Ÿ”ข Price Rounding .99, .95, or nearest dollar
๐Ÿ›ก๏ธ Stock Buffer Subtract units to prevent overselling

Technical

Feature Description
๐Ÿท๏ธ SKU Matching Products matched by SKU, variations included
โšก Rate Limiter Adaptive throttling that never blocks a request thread for long
๐Ÿงน Daily Maintenance Log retention, orphaned mapping cleanup, cache purging
๐Ÿ“ Detailed Logging Filterable log with CSV export
๐ŸŽจ Modern Admin UI Token-based design system with an optional dark theme

๐Ÿ“‹ Requirements

Requirement Version
WordPress 6.2 or higher
WooCommerce 8.0 or higher
PHP 7.4 or higher
Dropshipzone API account required

WordPress 6.2 is the minimum because the plugin uses the %i identifier placeholder in prepared statements, which that release introduced.


๐Ÿš€ Installation

From WordPress Admin (recommended)

  1. Download the latest 3s-soft-price-stock-sync-for-dropshipzone-*.zip from Releases
  2. Go to Plugins โ†’ Add New โ†’ Upload Plugin
  3. Upload the zip and click Install Now
  4. Activate

Manual

Extract the zip into /wp-content/plugins/ so the folder is named 3s-soft-price-stock-sync-for-dropshipzone, then activate through the WordPress admin.


โฌ†๏ธ Upgrading from 3.0.x or earlier

Version 3.3.0 widened the internal prefix from dsz_ to dszsync_ to meet the WordPress.org four-character minimum. A one-time migration runs automatically on the first load after upgrading and moves:

  • All plugin options (API credentials, price and stock rules, auto-import settings)
  • Post meta (_dsz_cost โ†’ _dszsync_cost, tracking numbers, and the rest)
  • Order meta, including HPOS storage
  • Scheduled cron events
  • The shipping method id, re-pointing any configured WooCommerce shipping zones

Custom database table and column names deliberately keep the dsz_ form. They are scoped inside plugin-owned tables, cannot collide with anything, and renaming them would mean an ALTER TABLE on live data for no benefit.

If you use the developer hooks, note that they were renamed too โ€” see below.


โš™๏ธ Quick Start

1๏ธโƒฃ Configure API Settings

DSZ Sync โ†’ API Settings โ€” enter your Dropshipzone email and password, then click Test Connection.

2๏ธโƒฃ Set Price Rules

Markup type and value, GST handling, and rounding. Optionally add advanced rules that override the global markup for specific categories, suppliers or SKU prefixes.

3๏ธโƒฃ Configure Stock Rules

Stock buffer, out-of-stock handling, and whether to draft products that disappear from the supplier catalogue.

4๏ธโƒฃ Import or Map Products

  • Import โ€” search the catalogue and import
  • Auto-Map โ€” match existing products by SKU
  • Scan Unmapped โ€” check existing products against the API in bulk

5๏ธโƒฃ Run Sync

DSZ Sync โ†’ Sync Center โ€” run once, or set a schedule.

6๏ธโƒฃ Shipping (optional)

The plugin registers a Dropshipzone Shipping method and attaches it to Australia and New Zealand zones on activation. Add a fallback cost so checkout still quotes when the API is unreachable.


๐Ÿ“Š Rate Limiting

The plugin respects Dropshipzone's documented throttle limits:

Limit Value
Requests per minute 60
Requests per hour 600

The rate limiter tracks usage, applies adaptive delays as limits approach, and never blocks a request thread for more than 15 seconds. Longer waits return a retryable error so admin screens and checkout stay responsive.


๐Ÿ”ง Developer Hooks

Renamed in 3.3.0. These were previously prefixed dsz_. If you registered callbacks against the old names, update them โ€” the old hooks no longer fire.

Filters

// Modify the calculated price before it is saved
add_filter( 'dszsync_calculated_price', function ( $price, $product_id, $supplier_cost ) {
    return $price;
}, 10, 3 );

// Modify the calculated stock quantity before it is saved
add_filter( 'dszsync_calculated_stock', function ( $stock, $product_id, $supplier_stock ) {
    return $stock;
}, 10, 3 );

// Change how long logs are retained (days)
add_filter( 'dszsync_log_retention_days', function ( $days ) {
    return 90;
} );

// Cap how many /stock pages one fast-stock-update run reads.
// 160 change rows per page; the full sync picks up anything left over.
add_filter( 'dszsync_incremental_max_pages', function ( $pages ) {
    return 20;
} );

// How far back tracking sync looks for orders still awaiting tracking (days)
add_filter( 'dszsync_tracking_lookback_days', function ( $days ) {
    return 90;
} );

Actions

// After a full sync run completes
add_action( 'dszsync_sync_completed', function ( $stats ) {
    // $stats: [ 'updated' => int, 'skipped' => int, 'errors' => int ]
} );

// After a product price is updated
add_action( 'dszsync_price_updated', function ( $product_id, $old_price, $new_price ) {
    // ...
}, 10, 3 );

๐Ÿ“– Documentation


๐Ÿค Contributing

Contributions are welcome. Please read the Contributing Guidelines first.

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes
  4. Push and open a Pull Request

Before submitting, run Plugin Check against your build โ€” the plugin currently passes with no errors or warnings, and it is worth keeping it that way.


๐Ÿ“„ License

GPL v2 or later โ€” see LICENSE.


๐Ÿ†˜ Support

Channel Link
๐Ÿ’ฌ Discussions GitHub Discussions
๐Ÿ› Issues GitHub Issues
๐Ÿข Developer 3s-soft.com

For questions about the Dropshipzone service โ€” accounts, pricing, stock accuracy, or fulfilment โ€” contact Dropshipzone directly. This plugin is an independent integration and its maintainers cannot help with supplier account matters.


๐Ÿ’– Support the Project

  • โญ Star this repository
  • ๐Ÿ› Report bugs so they can be fixed
  • ๐Ÿ’ก Suggest features in discussions
  • โ˜• Buy us a coffee: buymeacoffee.com/shauncuier

๐Ÿ™ Credits

Developed by 3s-Soft for WooCommerce stores that source from Dropshipzone.

Built on WooCommerce.


Made with โค๏ธ for Australian Dropshippers

GitHub stars GitHub forks

About

๐Ÿ›’ WooCommerce plugin for Dropshipzone dropshippers - Sync prices, stock & import products directly from the Dropshipzone API with automated scheduling

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages