The customer fills in what you would otherwise have to ask for
The form lists the order line by line. Per row the customer picks the quantity, a reason, optionally a procedure, and writes down what is wrong.
What this is about
This is the core. Everything before it leads here, everything after it follows from it. What is entered here later sits in the admin as a record - not as running text in an email.
One row per line item
Image, name and product number on the left, the selection on the right. "Quantity" runs from one to the quantity ordered, "Please select reason..." opens the list of reasons, "Please select procedure..." the list of procedures. Below that a field "Your comment on the product...". At the end one field for the whole return: "Your comment on the return shipment...".
Excluded lines do not disappear
Whatever may not go back stays in the list, greyed out, with the selection locked. That saves you the question of what happened to it. The same goes for lines that are not products: vouchers and discounts cannot be selected in the first place.
The checklist is a window, not a section
When it is switched on, clicking "Create return shipment" first opens a modal window: "Please confirm the following checklist to create a return." Every question is mandatory. Three ship with the plugin, you may change the texts and add markup - a link to the withdrawal policy is possible.
Which settings drive the form
| Setting | Technical name | What it does |
|---|---|---|
| Activate procedures | procedureStatus | Shows the second select per row. Off means the customer only names the reason, not what they want to happen. |
| Activate checklist | checklistStatus | Switches on the window before filing. Every question of the checklist is mandatory and has to be ticked. |
| Enable custom conditions for products | productRestrictionStatus | Switches on the Twig check per line. Without it only the quantity, the line type and the custom field on the product apply. |
| Twig Syntax | productRestrictionTwig | The Twig runs for every product of the order. lineItem gets you the order line, lineItem.product the product and lineItem.order the order. |
| Von Rücksendungen ausschließen | dvsn_return_shipment_product_ban_status | Not a configuration field but a custom field on the product itself. Once set, the line drops out of the selection - without a line of code. |