Skip to content
Farin Theme Guide
GuidesPayment, SMS and Shipping

Shipping

In this section you turn on the methods the buyer sees at checkout, enter each method's rate for in-province and out-of-province, and decide where shipping is free. Buyers can also choose the delivery day and time slot. All of this is read from this panel, and you do not need to create a zone or method in “WooCommerce → Shipping”.

Where is it? Farin → Payment, SMS and Shipping → Shipping

WooCommerce zonesFarin automatically adds the “Farin shipping” method once to WooCommerce's “Locations not covered by your other zones” zone. If you have created a zone that does not include the Farin method, Farin's methods are still shown to buyers. Provinces and prices are set by this panel, not by WooCommerce zones.

Shipping methods

You have seven ready methods: Pishtaz Post, Express Post, Tipax, Chapar, motorbike courier, pay-on-delivery, and in-store pickup. After installation only “Pishtaz Post” is on. Each method has a box; click its header to open it. The header of each box shows the method name, its delivery time (such as “2 to 4 business days”) and an “On” or “Off” label.

The buyer sees the methods that are on, in the same order as in the panel, at checkout. Use the two arrow buttons beside each box to move a method up or down.

The open Pishtaz Post box with the toggle on, name, payment type, prices, delivery time, provinces and cities
A method's full box with rates. From top to bottom: on and off, name and description, payment type, prices, special province or city price, delivery time and purchase limit, and finally the provinces and cities this method reaches.
Enter the prices yourselfThe numbers you see in each method's price fields after installation are theme defaults, not today's rates from the post office or shipping companies. Before turning on any method, enter your own contract price or tariff.

Name and payment type

OptionWhat it does
Turn this shipping method onIf turned off, this method does not appear at checkout.
NameThe name the buyer sees next to the method's select button. Up to 60 characters.
Short descriptionShown next to the delivery time, for example “Even days only”. Up to 160 characters.
Shipping cost payment“Paid”: the cost is calculated from the prices below. “Free”: the shipping cost is zero. “Pay on delivery”: no fee is charged on the site and the buyer pays the courier on delivery. Pay-on-delivery is never shown as “Free”.
The pay-on-delivery method box with the pay-on-delivery option selected and no price fields
The “Pay on delivery” method. When the payment type is “Pay on delivery” or “Free”, the price fields are hidden and only delivery time, purchase limit and coverage remain.
The in-store pickup box with the Free payment type
“In-store pickup” is “Free” by default. If you deliver only in your own city, select your province and city at the bottom of this same box.

Prices

These fields appear only when “Shipping cost payment” is set to “Paid”.

OptionWhat it doesDefault
In-provinceThe base price when the buyer's province is the same as the store's province. You set the store province in the “General” tab.
Out-of-provinceThe base price for all other provinces.
Per itemThis amount is added for each unit of an item in the cart. Three units of one item are charged three times.0
Free from purchaseIf the item total (after the discount code) reaches this amount, this method becomes free. “0 means none.”0
Weight in base priceHow many kilograms the base price covers.0
Each extra kiloThis amount is added for each kilo above the “Weight in base price”. A fraction of a kilo counts as a kilo; for example, with a base weight of 2 kg, a 3.2 kg parcel has 2 extra kilos. “0 means weight does not matter.”0
Special province or city priceUse “Add province or city price” to create a row: province, city (or “Whole province”) and price. This price is charged instead of the in-province or out-of-province price. If you set a price for both a province and one of its cities, the city price takes precedence. The per-item and weight costs are still added.Empty
The Tipax box with fields for in-province, out-of-province, per item, free from purchase, weight in base price and each extra kilo
The “Tipax” box. The six price fields sit side by side; any field left at zero has no effect on the cost.

Delivery time and purchase limit

OptionWhat it does
Delivery from / toBusiness days until delivery. The buyer sees it under the method name, such as “1 to 3 business days”. “0 and 0 means the same day”, and “0 to 1” is written as “delivery today or tomorrow”. This number is only text and does not lock the delivery day; to choose day and time, go to the Delivery time tab.
Minimum purchaseIf the item total is below this amount, this method is not shown at all.
Maximum purchaseIf the item total is above this amount, this method is not shown. “0 means no limit.”
The motorbike courier box with delivery from 0 to 1 days and the subtitle delivery today or tomorrow
“Motorbike courier” with delivery from 0 to 1 days. “Delivery today or tomorrow” is written under the method name, exactly what the buyer sees.

Provinces and cities

These two options decide where the method reaches. A buyer whose address is outside this area does not see the method.

  • Provinces: “Select none to include all provinces.” If you select several provinces, the method appears only for those.
  • Cities: The cities of each province you selected open below it. In a province where you select no city, all its cities are included; if you select some cities, only those. This is useful for courier and in-store pickup.
The Express Post box with Khuzestan province selected and the list of Khuzestan cities below it
In “Express Post”, Khuzestan province is selected and its cities are open under “Cities”. Until a city is selected, “All cities” is written next to the province name.

If another shipping plugin supplies its own city list, you will see a text field named “Only these cities” instead of the city buttons. Separate city names with commas, such as “Tehran, Karaj”. Empty means all cities of the provinces above. In this case “Special province or city price” is not shown either.

The Chapar box turned off, with prices and the list of provinces
The “Chapar” box, which is still off. Until the toggle at the top of the box is turned on, its settings stay saved but the buyer does not see this method.

Class and weight

This tab adds a cost separate from each method's price, applied on top of all “Paid” methods. “Free” and “Pay on delivery” methods are not affected.

The shipping classes box with the several-classes-in-one-cart option and the items with no class row
The “Shipping classes” box. No class has been created yet, so only the “Items with no class” row appears.

Shipping classes

A shipping class is for large, heavy or fragile items. You create classes in WooCommerce (the “Create or edit classes in WooCommerce” button) and choose each item's class in “Edit product → Shipping”. Then in this table you enter two amounts for each class.

OptionWhat it doesDefault
Several classes in one cart“Sum of all classes”: the cost of every class in the cart is added together. “Highest class only”: only the highest class cost is charged.Sum of all classes
Fixed costAdded once if at least one item from this class is in the cart.0
Per itemAdded for each unit of an item from this class.0

The “Items with no class” row is for items that have no class. Example: a “Fragile” class with a fixed cost of 20,000 and 5,000 Toman per item; a cart with three fragile items adds 20,000 + 3 × 5,000 = 35,000 Toman to the shipping cost.

Weight tiers

The weight tiers box with the add tier button and the each extra kilo beyond the last tier field
The “Weight tiers” box. Each tier is created with “Add tier”; until you create a tier, weight has no effect in this section.

Each tier has a weight (“up to … kg”) and a cost. The total weight of the parcel is compared with the tiers, and the cost of the first tier the parcel fits in is added. You can create up to 20 tiers, and they are sorted from light to heavy when saved.

OptionWhat it doesDefault
Each extra kilo beyond the last tierIf the parcel is heavier than the last tier, the last tier's cost plus this amount for each extra kilo is charged. A fraction of a kilo counts as a kilo.0

The panel's own example: up to 1 kg 10,000, up to 5 kg 30,000, and 8,000 for each extra kilo. A 7 kg parcel adds 30,000 + 2 × 8,000 = 46,000.

Enter product weightEach item's weight is read from the “Weight” field in “Edit product → Shipping”. An item with no weight counts as zero. Weight tiers are separate from each method's “Each extra kilo”; if you fill in both, both are added.

Free by city

This tab lets you offer free shipping to a city, or a whole province, provided the buyer purchases enough from the specified categories.

The free shipping by city box with the add city rule button and a sample calculation
The “Free shipping by city” box. You create each rule with “Add city rule”; the example at the bottom of the box shows how category shares add up.
  1. Click “Add city rule”. A new row opens.
  2. Select the province and city. If you set the city to “Whole province”, the rule applies to all cities in that province.
  3. Enter the category and minimum amount. For each product category, enter the minimum purchase from that category. One rule can have several categories.
  4. Save.

If a rule has several categories, the purchase share from each category is added up, and when it reaches 100% shipping is free. Panel example: Isfahan, Clothing at least 1,000,000 and Bags at least 2,000,000. A purchase of 600 thousand from Clothing is 60% and 800 thousand from Bags is 40%; together 100%, so shipping is free.

  • Each item's amount is calculated after the discount code.
  • Subcategories belong to their own category; a purchase from “Clothing › Coats” counts for “Clothing” too.
  • This rule makes all “Paid” methods free. “Pay on delivery” stays pay-on-delivery.
  • If you have not created any product category yet, this tab shows a warning; first create categories in “Products → Categories”.

Delivery time

When you turn this tab on, the buyer chooses the delivery day at checkout, under the shipping method, and the time slot if you want. At the top of this tab you see a preview of that same picker, with the saved settings. If no day is open with your settings, the preview says so.

The delivery time box with two toggles, the shipping method buttons and the note-under-the-picker field
The “Delivery time” box. The first toggle turns the whole feature on; the buttons below decide which methods it applies to.
OptionWhat it doesDefault
Delivery time selectionIf on, day and time selection appears at checkout.Off
Time selection is requiredIf on, an order cannot be placed without choosing a day and the buyer sees the message “Choose a delivery day.” If off, the buyer may choose no time.On
For which methodsTime selection appears only when the buyer has chosen one of these methods. Select none to apply to all methods. Usually for courier and in-city delivery.All methods
Note under the pickerA line under the picker, such as “The courier delivers only in Tehran”. Up to 200 characters.Empty

Delivery days

The delivery days box with preparation time, order cutoff time, days offered, working days and holidays
The “Delivery days” box. In this picture all days except Friday are working days, and orders placed after 14:00 are delivered one day later.

The first day the buyer can choose: today plus the preparation time; and one day later if the order arrives after the cutoff time. Closed days and holidays are skipped.

OptionWhat it doesDefault
Preparation timeHow many days after the order the parcel is ready for delivery. Each item can have a longer time (the “Preparation days” field in Edit product → Farin); the largest among the cart's items is used. Maximum 60 days.0
Daily order cutoff timeOrders that arrive from this time onward start one day later. “No cutoff time” means the order time does not matter.14:00
Days offeredHow many consecutive open days are shown to the buyer. From 1 to 30.7
Working daysThe days you deliver. Days that are not selected do not appear in the list.Saturday to Thursday
HolidaysOne day per line, in the Jalali date format, such as 1405/01/01. There is no delivery on these days.Empty

Time slots

The time slots box with two rows, morning from 9 to 13 and evening from 16 to 20
Two default slots, “Morning” (9 to 13) and “Evening” (16 to 20), both with unlimited capacity and no fee. Use the trash icon to delete a row.

Each row is one slot: name, start and end time, capacity and fee. You can create up to 12 slots. If there is no slot, the buyer chooses only the day.

  • Capacity: How many orders per day for this slot. Empty or zero means unlimited. Cancelled, failed and refunded orders do not count against capacity. When capacity is full, that slot cannot be chosen for that day.
  • Fee: This amount is added to the order total as a separate line titled “Delivery in slot …”. A free slot shows “No fee” next to its name.
  • For today, a slot whose start time has passed can no longer be chosen.

The selected day and slot are saved with the order and appear in the order total, emails, the order page in the dashboard, and the thank-you page. At “Place order”, it is checked once more that the day and slot are still open.

General

The store province box with the province list set to Tehran
The “Store province” box. The “In-province” price of all methods applies to this province.
The free shipping box with the free-shipping-from-an-amount toggle turned off
The “Free shipping” box. Turning on the toggle opens the “From purchase” field for entering the amount.
OptionWhat it doesDefault
ProvinceParcels are sent from this province. Buyers in this province pay the “In-province” price and everyone else pays the “Out-of-province” price.Tehran
Free shipping from an amountIf on, when the item total reaches the “From purchase” amount, all paid methods become free. This amount is calculated after the discount code and excluding shipping cost.Off
From purchaseThe amount from which shipping is free.1,000,000

A discount code that has the “Free shipping” option in WooCommerce also makes all paid methods free, whether this toggle is on or not.

The product weights box with a warning that WooCommerce's weight unit is pounds
The “Product weights” box when WooCommerce's weight unit is not kilograms. If the unit is kilograms, it only says “Product weights are entered in kilograms.”

Farin calculates weight cost in kilograms and converts product weight from WooCommerce's unit to kilograms. If you entered product weights in kilograms but WooCommerce's unit is something else, the weight cost will be wrong; switch the unit back to kilograms in WooCommerce settings → Products.

The cost the buyer pays

For each “Paid” method, the shipping cost is built like this:

  1. Base price: The special price for the buyer's city; if none, the special price for their province; if none, “In-province” or “Out-of-province”.
  2. + per item multiplied by the number of items.
  3. + shipping classes and Weight tiers from the “Class and weight” tab.
  4. + each extra kilo for weight above that method's “Weight in base price”.

This whole amount becomes zero if any of these holds: a free-shipping discount code is in the cart; the item total reaches the General tab's “Free shipping from an amount”; the item total reaches that method's “Free from purchase”; or a “Free by city” rule applies to the buyer's city.

  • All threshold amounts (free from purchase, minimum and maximum purchase, free by city) are compared against the item total after the discount code.
  • Virtual and downloadable items that do not ship are not counted in quantity, weight or amount.
  • The “Free” method is always zero. “Pay on delivery” is zero on the site and the buyer pays the cost at the door.
  • The delivery slot fee is separate from the shipping cost and does not become zero with free shipping.
  • New prices apply the moment you save; a buyer who has the checkout page open sees the new price when the page refreshes.

Frequently Asked Questions

The buyer sees no shipping method at checkout.

Check these: at least one method is on; the buyer's province or city is within that method's “Provinces” and “Cities”; the cart total is between “Minimum purchase” and “Maximum purchase”. If the cart contains only virtual or downloadable items, no shipping is needed and no method is shown.

I want the courier for Tehran only.

In the “Motorbike courier” box, select only Tehran under “Provinces” and the city of Tehran under “Cities”. Buyers in other cities do not see this method. If you want delivery time selection for the courier only, in the “Delivery time” tab, under “For which methods”, select only Motorbike courier.

Do I need to create a zone in “WooCommerce → Shipping”?

No. Farin automatically adds its own method to the “Locations not covered by your other zones” zone and reads provinces, cities and prices from this panel. If you already have a zone, Farin's methods are shown alongside that zone's methods.

I filled in both the method's “Free from purchase” and the general free shipping. Which one counts?

Whichever is reached first. If the item total reaches either amount, that method becomes free. The general amount makes all paid methods free, and a method's amount makes only that method free.

Farin Theme · 1405