Skip to content

Commit

Permalink
Update dimensional shipping
Browse files Browse the repository at this point in the history
  • Loading branch information
scottcwilson committed Feb 19, 2024
1 parent e87449f commit 33ff1ca
Show file tree
Hide file tree
Showing 5 changed files with 22 additions and 5 deletions.
Binary file added content/images/dimensions.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 5 additions & 3 deletions content/user/products/product_edit.md
Expand Up @@ -12,10 +12,10 @@ that product type. It is used for both product creation and product editing.

![product editing screen](/images/product_edit.png)

Some fields in the `Product - General` product type that can be set
when adding the product are:

The fields in the `Product - General` product type that can be set
when adding or editing a product are:

- Master Category - the category for the product. The product may also be in other categories using the [linked categories](/user/products/linked_product/) feature.
- [Products Status](/user/products/products_status/) - set to Disabled to not display in the storefront; Enabled otherwise
- [Date Available](/user/products/upcoming_products/) - use if the product will not be available until the future
- Products Manufacturer - select a [manufacturer](/user/admin_pages/catalog/manufacturers/) if you organize products by manufacturer
Expand All @@ -40,6 +40,8 @@ when adding the product are:
- Products Image - main photo for product
- Products URL - if there is another web page that provides more information, add the URL here
- Products Shipping Weight - weight before adding packing materials
- Length, Width and Height: Since Zen Cart 2.0.0 it has been possible to add [product dimensions](/user/shipping/shipping_dimensions/) to a product.
- Ships in Own Box: Since Zen Cart 2.0.0 it has been possible to specify products that ship in their own box. See [product dimensions](/user/shipping/shipping_dimensions/). Note that these products do not incur additional tare weight.See [How Weight and Tare Are Determined](/user/shipping/shipping_calculations/) for more details.
- Sort Order - the order the product will be displayed in on a [listing page](/user/products/product_listing/).

For more information, see the [product FAQs](/user/products/).
Expand Down
3 changes: 3 additions & 0 deletions content/user/shipping/shipping_calculations.md
Expand Up @@ -131,3 +131,6 @@ _(*) See note in examples above_

Calculation of total weight: 30 pounds of product, grossed up by 10% = 33 pounds, plus 5 pounds = 38 pounds.

### Products which Ship in their Own Boxes

Since Zen Cart 2.0.0, it has been possible to identify products which ship in their own boxes using the new [shipping dimensions](/user/shipping/shipping_dimensions/) settings. Such products will not incur additional tare weight; the weight entered in their `Products Shipping Weight` field will cover the entire weight.
14 changes: 13 additions & 1 deletion content/user/shipping/shipping_dimensions.md
Expand Up @@ -16,9 +16,21 @@ Starting in Zen Cart 2.0, the following fields are added to assist shipping modu
|Configuration > Shipping|configuration|Shipping Weight Units|Is products_weight expressed in pounds or kg? | Configuration key is `SHIPPING_WEIGHT_UNITS`|
|Configuration > Shipping|configuration|Shipping Dimension Units|Are products length, width and height expressed in inches or centimeters? | Configuration key is `SHIPPING_DIMENSION_UNITS`|

The screens referenced above are:
- [Product Edit](/user/products/product_edit/)
- [Configuration > Shipping](/user/admin_pages/configuration/configuration_shippingpackaging/)


Metric users please note:
- When you change `SHIPPING_WEIGHT_UNITS` to `kg`
you will also want to change these language defines in `includes/languages/YYOURTEMPLATE/lang.english.php`:
you will also want to change these language defines in `includes/languages/YOURTEMPLATE/lang.english.php`:
- `TEXT_PRODUCT_WEIGHT_UNIT`
- `TEXT_SHIPPING_WEIGHT`
This way your storefront will show the correct units.

Your admin will show the units which are indicated by the setting of the two constants above, `SHIPPING_WEIGHT_UNITS` and `SHIPPING_DIMENSION_UNITS`.

The screenshot below shows the new fields in the Product Edit and Configuration > Shipping screens:

![Shipping Dimension Fields](/images/dimensions.png)

2 changes: 1 addition & 1 deletion layouts/partials/footer.html
Expand Up @@ -23,7 +23,7 @@
{{ if not .Site.Params.ui.footer_about_disable }}
{{ with .Site.GetPage "about" }}<p class="mt-2"><a href="{{ .RelPermalink }}">{{ .Title }}</a></p>{{ end }}
{{ end }}
<a href="https://ada4zencart.com/index.php?main_page=index&amp;referrer=C4ADA_11659651175">ADA/WCAG Accessibilty Modules for Zen Cart</a>
<a href="https://ada4zencart.com/index.php?main_page=index&amp;referrer=C4ADA_11659651175">ADA/WCAG Accessibility Modules for Zen Cart</a>
</div>
</div>
</div>
Expand Down

0 comments on commit 33ff1ca

Please sign in to comment.