YS FluentCart Order Statuses

FluentCart × Custom order flow: Custom statuses such as sub-production and scheduled shipment are not overwritten after payment. Status changes are automatically sent by email; you can directly change the order status from More Action, including a process report and anti-blocking feature.

v0.8.1 Fluent Cart FluentCart Free Download

FluentCart’s built-in order statuses only include “Processing”, “Reserved”, “Completed”, and “Cancelled”; however, stores that offer drop shipping, custom production, or pre-order services need their own process, such as “Paid → In Production → Scheduled for Shipping → Shipped”. This add-on allows you to add your own custom order statuses and shipping statuses in the backend—names, colors, descriptions, and payment conditions can be set—the FluentCart order list (each custom status has a saved view), the “Change Shipping Status” dialog box (English interface is Change Shipping Status), and the customer’s order page all display directly. Advanced filtering in FluentCart Pro also includes custom order status filtering. It is completely independent of the FluentCart core and is achieved through public filters and REST.

Will not be overwritten by FluentCart after payment

FluentCart will change the order status to "Processing" when payment is received. This is the core feature, without any filters. The add-on will rewrite your custom status within the same payment flow and leave a note in the order activity log; each status can be selected in "Advanced" to "Keep this status" or "Pass to FluentCart for processing" (only "Unpaid orders" status is always passed to FluentCart). There is also a global toggle. Revenue reports are based on payment status, so custom order statuses have no impact on revenue figures.

Automatically send an email to the customer upon status change

Each custom status can trigger email notifications—one for the customer, one for the administrator—with separate switches. The notifications are directly registered in FluentCart’s “Email Notifications” settings page: using FluentCart’s switches, the subject field, preview function, and sender settings, the email box and header and footer are consistent with those in FluentCart itself; the title and body paragraphs can be filled directly in the same editor page, supported by {{order.invoice_no}},{{order.customer.full_name}} and other FluentCart shortcodes. All are disabled by default; they are only sent when enabled.

Change the order status from More Action

FluentCart’s backend does not have any controls for freely selecting order statuses—whether the order is paid or not; in More Action, there are only fixed buttons like “Marked as Completed,” “Processing Return,” and “Cancel Order” (tested with 1.6.0 and 1.6.3). Adding “Change Order Status” to the top of the same More Action menu opens the “Update Order Status” dialog box, which operates in the same way as FluentCart’s “Change Shipping Status” dialog box; only the order’s available status is displayed in order, however; shipping status remains the same in FluentCart’s “Change Shipping Status”; custom shipping statuses are listed directly within it. Writing to the FluentCart’s own order API, activity history, status change events, and item fulfillment are exactly the same as manually changing the status;

The Order workflow card: see where an order stands, move it on in one click

The Order workflow card on the order page simultaneously displays the order status and shipment status: the current status, the next step of the process, the reason for the change not being able to be made, and the Next step button for quick progress. Below, you are prompted with other status options to change to More Action. In case this page is unable to use the More Action to change the order status (for example, in a future FluentCart update), the card will automatically change to directly list the available order statuses; canceled orders have no “Change shipment status” option in FluentCart, and the card will also list the available shipment statuses directly.

Two process templates, create with one click

The 'Create Standard Process' page on the 'Order Status' page, and the 'Create Shipping Process (Shipping Status Axis)' page on the 'Tools' page, both allow you to create a 'Next Production → Scheduled Shipping → Shipped' workflow in one click. We recommend placing the workflow under the 'Shipping Status' section, because FluentCart will never automatically rewrite the shipping status, and the custom shipping status will appear directly in the 'Change Shipping Status' dialog box in FluentCart. The template will not change the name of the built-in status in FluentCart, nor overwrite the content you have already configured; applying it twice will not duplicate it. If needed, you can open 'Strict Process' on the 'Tools' page to make the order status advance or back only one step at a time (the 'Shipping Status' flow only applies to the order status; once you change it to 'Completed', 'Cancelled', or 'Reserved', it can be applied at any time).

Guard rails and records: no harm from a slip when changing settings or statuses

The status of orders in use cannot be removed during storage; the screen directly indicates which status it is in and how many orders there are; the stored status cannot be changed again; the status of orders in use will also be reminded if you try to change the code again. “Move Orders” will first check the number and destination, and will not send the order directly to the “Completed” or “Cancelled” end states; each move will leave a record. If an order is in an inactive state, a reminder will be displayed at the top of the settings page, and you can move it directly to the “Completed” or “Cancelled” end states. Before importing, the contents that will be changed will be listed, and you can still move them directly to the “Tools” tab after importing. Before importing, the previous imported data will be displayed in chronological order; the data that has been updated will be saved first, and you can “recover the last import”; if two people are editing the settings simultaneously, the data of the one who has already updated will be blocked and prompted to reload; the changes made by the other person will not be overwritten.

Workflow report and stalled-order list

The "Order Status Report" page breaks down the entire process: the number and amount of orders for each status (including paid/unpaid), the flow chart, the average and longest stay time for each step, and a list of orders that have exceeded N days in the same step. Each table can be downloaded as a CSV (Excel opens in Chinese without losing formatting). Daily summaries can be selected. The order list now includes a view of each custom status, the "Order History" on the order page combines the two axes on the same time axis, and the latest changes are displayed at the top.

Compatibility and Updates

FluentCart 1.6.0 is available (1.6.0 and 1.6.3 have both been tested and passed). PHP 7.4 or higher. It does not generate deprecation warnings on PHP 8.4 and 8.5. Exporting/importing JSON in one go is possible. Deleting plug-ins does not change any order data. The built-in YS Plugin Hub update mechanism allows you to receive new notifications directly from the WordPress plug-in page and update them with a single click after installation. The interface is available in both English and Traditional Chinese.

Features

Customized status and one-click workflow templates

Name, color, description, sorting, and payment terms can all be configured; one-click creation of "Next Production → Scheduled Shipment → Shipped" can be placed on the order status or shipment status.

Keep custom status after payment

When FluentCart processes a payment, it changes the status to "Processing," and the plugin automatically writes it back and leaves a note in the activity log.

Status change email notification

Each status can enable customer notifications and administrator copies, allowing you to directly edit the subject, title, and body text in the "Email Notifications" settings page of FluentCart.

More Action changes the order status

Order page More Action adds the option to change the order status; only this status is displayed; the "Order Process" tab in the side panel shows the current steps, with a one-click "Next" button.

Guard rails, records and undo

The usage status is not accidentally deleted; the move order is confirmed first and recorded; the import process checks for differences and is recoverable; two people can edit the order at the same time without overlapping each other.

Workflow report and stalled-order list

Order numbers and amounts for each state, funnel, dwell time, and stuck orders; each table can be downloaded as a CSV file; daily summary emails can be selected.

Screenshots

Changelog (Latest)

Follow-ups from an independent review of 0.8.0. A cancellation made after a refund

returns stock only when it should, and the order page no longer asks about a

Refund the payment gateway refused. On a site whose Stock Management module is

off, only that question changes.

For shop staff

  • The refund's own restock option stands. When the refund itself decided what

went back to stock — *Restock* ticked in FluentCart's Refund dialog, or a

Payment plugins such as YS Helcim returning items with the refund — the

automatic cancel that follows returns nothing more, and with *ask* the restock

The option starts unchecked. Before, refunding an order of 3 items with 1

restocked and letting it cancel returned the other 2 as well.

  • FluentCart does not hold any stock for returns, and nothing is refunded when canceled. An

order placed while the Stock Management module was off never took its items

out of stock, but FluentCart's cancel adds them to stock all the same. A

cancel made by this plugin — after a refund, from the order page's question,

or from *Change Order Status* — now leaves the stock alone for such an order, and

The activity log says why. With *ask*, such an order is asked about without a

Choose from a selection of restocks.

  • A refund the gateway refused is not asked about. With a full refund set to

*ask*, a refund FluentCart recorded although the payment gateway refused it no

longer brings up *Cancel the refunded order?*; the activity log says the

Gateway did not confirm it, as before.

  • The setting is named for what it does: *Return the items to stock when a

Refund cancels the order*. It never governed a cancel made by hand.

  • The question's dialog no longer reloads the page, or closes a dialog that has been opened.

Since, when the operator moves to another order before *Cancel order* or *Keep

The current status* has been answered.

Changed (technical)

  • `Payment\RefundStatusHandler::onRefunded()` on `fluent_cart/order_refunded`

(priority 5) marks `_ys_fct_refund_restock_decided` on the order when the

Refund decided what went back to stock: inside FluentCart's Refund route when

`manage_stock` is true, elsewhere when a row has a `restore_quantity` above 0.

The automatic cancel then uses restock=false (`CancelRestock::WHY_DECIDED`),

and `prompt()['restock']` is false.

  • `Support\CancelRestock::before()` returns the items only while `holdsStock()`

— The ‘stock_movement’ order meta in FluentCart has a positive ‘on_hold’ or

`committed` — and otherwise detaches the listener (`WHY_NOT_HELD`); it looks

only while the listener is on its hook. `prompt()['stock']` needs the same.

The activity line names which of the three reasons applied.

  • Full refund was recorded for the FluentCart Refund route although the gateway refused it.

It sets `_ys_fct_refund_prompt` to `gateway_failed`; `prompt()` asks only

while that meta is empty.

  • `order-changer.js`: an answer that comes back after the page moved to another

order closes only its own dialog and does not reload the page.

  • Opting to uninstall with data removal also deletes

`_ys_fct_refund_restock_decided`.

Tests

  • Unit 619; refund scenarios 130 in FluentCart 1.6.0 and 1.6.3 — orders are now held

stock the way FluentCart records it; R14, R15 and R17 expect the refund's own

decision to stand; new R20 (no stock held), R21 (*ask* after a refused)

refund), R22 (the setting and a cancel made by hand), R23 (a status change)

that fails halfway still puts the listener back) and R24 (partial, then full),

then *keep*). Browser 92 — a page that moved to another order before the

The answer came back; that case fails against the 0.8.0 script. Ten mutations of

The new checks each fail the refund scenarios; PHP 8.2 and 8.5.

FAQ

Will the FluentCart core be modified?

No. All the filters (order_statuses, editable_order_statuses, shipping_statuses, email_notifications, etc.) published by FluentCart are completed via REST; the “Change Order Status” option in More Action is also added by the add-on only when the menu is opened; updating FluentCart does not overwrite anything.

Why does the order status change to "Processing" after payment?

This is the core behavior of FluentCart (write-off, no filter). The add-on will write back the custom status in the same process; each status can be set to "Keep this status" or "Hand over to FluentCart for processing," while the "Only unpaid orders" status is always passed to FluentCart.

Where are the notification emails set up? Can the free version of FluentCart change the body text?

In FluentCart → Settings → Email Configuration → Notifications, you will find a new set of "Custom Order Status". The switch, subject, and preview are all native to FluentCart; the title and body are plugins added to the same editor page; the free version can also fill them in. The full block editor is still required with FluentCart Pro.

Why doesn't the native FluentCart backend allow me to directly select my custom order status?

FluentCart does not have any controls for freely selecting the order status by default (tests with 1.6.0 and 1.6.3); whether or not payment has been made, there are only fixed buttons like “Mark as completed”, “Processing return”, and “Cancel order” in More Action. Therefore, adding “Change order status” to the same menu item only lists the status that the order can be moved to. The shipping status is different: the custom shipping status is directly displayed in the FluentCart’s own “Change shipping status” dialog box.

Should the process be placed in the order status or the shipping status?

If the process starts only after the customer has paid (production, packaging, order placement, and shipment), it is recommended to set the shipment status to: FluentCart will never automatically modify it, and the built-in "change shipment status" can be used on every physical order that hasn't been canceled and needs to be shipped. The status truly belongs to the order itself, or you can set the shipment status when the customer wants to see it on the order status page.

Will disabling or removing the plugin affect orders?

Deactivating does not modify any order data, and settings and history will still be available after reactivating. Removing also preserves the settings and history tables unless YS_FCT_STATUS_REMOVE_DATA is defined in wp-config.php.

Also, if an order is in use, can it be removed directly?

No. It will be blocked during storage, and it will indicate which status it is in and how many orders are involved. Please first move the order using the "Moving Order" column on the status list and then remove it. The stored status cannot be changed; to change the code, add a new status and move the order again. If the status has already been removed and the order is still left, the top of the settings page will remind you that the "Tools" page can be moved directly.

After importing the settings, I found that they are incorrect. Is it possible to restore them?

Yes. The import only accepts files that have been exported using this add-on. Before writing, it lists what content will be added, removed, or changed; after importing, the Tools page will display "Restore Last Import," and the status, settings, and message text will return to what they were before the import.

0