SoftSquare Shipping Gateway for WooCommerce - TCS Courier Pakistan
| 开发者 | izhan47 |
|---|---|
| 更新时间 | 2026年11月12日 22:36 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
安装:
- Install and activate WooCommerce. This plugin does nothing without it.
- Upload the plugin through Plugins → Add New → Upload Plugin, or install SoftSquare Shipping Gateway for WooCommerce directly from the WordPress plugin directory.
- Activate it, and open SoftSquare Shipping → Settings. A setup guide at the top takes you through each step and ticks them off as you go.
- Press Connect this site. The site registers itself with the SoftSquare service and proves it owns the domain. No key to paste.
- Enter the API details TCS gave you, your account number and cost centre, and save. If you do not have them yet, see "Where do I get my TCS API details?" below.
- Add your collection address, press Test connection, and publish the "Track your order" page.
- Open any order and press Book with TCS.
屏幕截图:
常见问题:
Is this an official TCS plugin?
No. SoftSquare Shipping Gateway for WooCommerce is an independent third-party integration developed and maintained by SoftSquare. TCS is a trademark of its respective owner, and this plugin is not affiliated with, endorsed by, sponsored by, or officially supported by TCS.
Does this plugin integrate WooCommerce with TCS Pakistan?
Yes. It connects your WooCommerce store to TCS Pakistan through the SoftSquare service, so orders can be booked, tracked and managed as TCS shipments without leaving WordPress.
Can I book TCS shipments from WooCommerce?
Yes. Book a TCS shipment from the order screen, in bulk from the orders list, or automatically when an order reaches a status you choose.
Can I track TCS shipments?
Yes. Track a TCS consignment from the WooCommerce order screen, from a public tracking page via the [tcs_tracking] shortcode, or let the plugin check hourly on its own for shipments still in transit.
Does it support TCS COD shipments?
Yes. Cash-on-delivery orders are booked with the amount to collect taken from the order total, or you can set a different amount per order.
Can I generate TCS shipping labels?
Yes. A TCS shipping label (consignment note) can be printed as a PDF as soon as a shipment is booked, individually or in bulk, and is stored locally so reprints are instant.
Can TCS shipment booking be automated?
Yes. Choose the WooCommerce order statuses that should trigger a TCS booking automatically — for example, as soon as an order becomes Processing — and the plugin books it without anyone opening the order.
Do I need a TCS account?
Yes. You need your own TCS COD API credentials — an API username, password and bearer token, plus an account number and cost centre. TCS issues these. Neither this plugin nor SoftSquare can create them for you.
Where do I get my TCS API details?
From TCS. In short:
- You need a TCS business account. If you do not have one, use "Open an Account" on TCS's e-commerce page (https://www.tcsexpress.com/ecom-solution) and TCS will contact you.
- Ask TCS for access to their COD API, sometimes called the E-COM API. Your TCS account manager can arrange it, or contact TCS through their website (https://www.tcsexpress.com/customer-services).
- TCS usually gives you sandbox details first. Choose Sandbox under TCS account, save, and test a booking. Then ask TCS to approve your account for production, which can take a few working days.
- TCS can also tell you your account number, customer number and cost centre codes if you do not have them.
Do I need a SoftSquare account?
You do not create one by hand. Press "Connect this site" under SoftSquare Shipping → Settings and the plugin registers your site with the SoftSquare service and proves it owns the domain. There is no sign-up form, no key to paste, and no account to pay for before the plugin will work — and nothing is sent to SoftSquare until you press that button.
What are the SoftSquare Pro services?
Optional paid services for returns, analytics and TCS cost reports. They run on the SoftSquare service, and SoftSquare turns them on per site. Booking, labels, tracking, COD, status emails and everything else listed under Features work without them. See SoftSquare Pro services above.
Why does the Returns screen show a Pro panel?
Because that service is not on for your site. Contact SoftSquare if you want it. If it was turned on recently, press Refresh Pro services on the Dashboard.
Does the plugin send customer information to an external service?
Yes. Booking a parcel sends the recipient's name, address, phone number and email to the SoftSquare service, which passes what TCS needs to TCS. This is what makes a delivery possible. The External Services section above lists everything that is sent and when.
Can I use it without the SoftSquare service?
No. The service is what talks to TCS. Without it the plugin can store settings but cannot book, print or track. If you run your own copy of the service, point the plugin at it with the SSGW_SERVICE_URL constant in wp-config.php.
Does it work with High-Performance Order Storage?
Yes. The plugin reads and writes order data through the WooCommerce CRUD API and declares compatibility with both HPOS and the block-based cart and checkout.
What happens to my data if I uninstall?
Settings, the activity log and stored label PDFs are deleted. Consignment numbers and courier statuses on your orders are kept, so you can still answer a customer asking where their parcel went. Nothing is deleted from the SoftSquare service.
更新日志:
- The plugin is now listed as "SoftSquare Shipping Gateway for WooCommerce - TCS Courier Pakistan", so stores looking for TCS can find it. Nothing else changes.
- Fix: on the Shipments screen, the booked date sat under the latest status and the Booked column was empty.
- Fix: tracking times on a shipment's details screen are now shown as readable dates instead of raw timestamps.
- New screenshots showing every part of the plugin.
- New: a setup guide at the top of the settings screen takes a new store from installing to its first booking, ticking off each step as it is done. It can be hidden, and goes away once every step is done.
- New: "Where do I get these from TCS?" explains which details TCS issues and how to ask for them.
- New: one welcome notice after a first activation, on the Plugins and Dashboard screens only, pointing at the guide. It can be dismissed.
- New: link a consignment booked on the TCS portal to an order, replace it, or remove it if it was mistyped.
- New: print a sheet of consignee copies, three to an A4 page, from the orders list. It is a real PDF where the host has Imagick with Ghostscript, and an on-screen preview elsewhere.
- New: print a label at 6 x 4 in, 4 x 6 in or A4, cropped to one copy, and send extra print parameters.
- New: status rules that move the order and send your own email when TCS reports a chosen status. There are none until you add one.
- New, off by default: a branded HTML status email. Plain text stays the default. An Email tester previews either without touching the order.
- New, off by default: area and block lists at checkout. A destination editor on the order screen corrects the city, area and block on any order.
- New: a live tracking card on the customer's order page, which can be turned off. A number on an order that TCS has not scanned yet now says the parcel is with the courier rather than "not found".
- Fixed: a Delivered line in the tracking history could fill the progress bar for a parcel that was on its way back.
- Fixed: changing the print settings had no effect on labels already stored.
- Fixed: a COD amount, weight or service code typed on the order screen was lost on a re-book. They are now kept on the order, and can be changed after booking.
- Fixed: a product with no weight counted as weighing nothing in a mixed cart. The default weight is now added once for the parcel. Orders already booked are not flagged as changed because of this.
- New Dashboard and Returns screens. The Dashboard shows the connection, shipment counts and the status sync, with a button to run it now.
- Added support for the optional SoftSquare Pro services: returns management, shipment analytics, shipping profit or loss, return rate, delivery time by city, cost sync, consignment charges and the COD payment report. These run on the SoftSquare service and are off until SoftSquare turns them on for a site.
- New: book a parcel again and keep the old consignment number, for a parcel TCS has already returned.
- New: the consignment number and tracking link in WooCommerce order emails. Can be turned off in the settings.
- New: refresh tracking in bulk from the orders list, and a service code override on the order screen.
- New, off by default: ask the rider to call before delivery, and require a valid Pakistani mobile number at checkout.
- Fixed: on stores using classic order storage, a status update could be applied to the newest order instead of the order it belonged to, and the status sync could pick the wrong orders. Stores on High-Performance Order Storage were not affected.
- Fixed: "Undelivered" statuses were read as delivered, which could complete the order, stop tracking the parcel and email the customer the wrong news.
- Fixed: the status sync could stop reaching newer parcels once its batch filled with finished ones.
- Fixed: a late update about an old consignment or a reverse pickup could overwrite the status of the live parcel.
- Fixed: "TCS city" was in the shipping section of the checkout, which is hidden until "Ship to a different address" is ticked, so a customer could be refused over a field they could not see.
- Fixed: automatic booking now runs in the background, so a customer's checkout no longer waits on the courier.
- Fixed: order items are no longer sent when "Send the order items to TCS" is off.
- Fixed: the filter forms on the Shipments and Activity log screens, and the links from the Shipments list, pointed at the wrong page.
- Readme: the External Services section now lists everything sent when connecting, including the site name, administrator email and versions.
- Connecting to the SoftSquare service is now a deliberate action: press "Connect this site" under SoftSquare Shipping → Settings. Nothing is sent to SoftSquare automatically on activation or on an admin page load anymore.
- The plugin's text domain now matches the plugin slug (
softsquare-shipping-gateway-for-woocommerce), as WordPress.org requires. - Removed the duplicate "Tested up to" declaration from the plugin header — it is now declared in this readme only.
- Fixed the Settings link on the Plugins screen, which pointed at the wrong page slug.
- No functional changes beyond how the initial connection is triggered — existing settings, bookings and consignment numbers are kept, and already-connected sites are unaffected.
- Corrective release for the WordPress.org review: menu-icon CSS is now added through
wp_add_inline_style()instead of an inline<style>tag, internal PHP class/function/constant names now use theSSGW_/ssgw_prefix instead of the collision-proneSSG_/ssg_, and the plugin now declares compatibility up to WordPress 7.1. No functional changes, and no stored setting, order metadata, database table, hook, AJAX action or REST route was renamed — existing installations are unaffected.
- Renamed to SoftSquare Shipping Gateway for WooCommerce for clarity on the WordPress.org plugin directory. No functional changes — existing settings, bookings and consignment numbers are kept.
- Renamed to SoftSquare Shipping Gateway and prepared for the WordPress plugin directory.
- Labels are stored locally, so reprinting one no longer needs a round trip to the service.
- A bundled, searchable list of TCS destinations at checkout, so the field cannot disappear when the network does.
- Tracking results are no longer stored by page caches.
- Saved credentials are masked more strictly in the admin.
- Removed a byte-order mark from the main plugin file.
- First release.