Skip to content

Installation

Jump to bottom
brittainmark edited this page Mar 21, 2025 · 11 revisions

Big Royal Mail

If you have found this useful and would like to reward the maintainer you can make a donation through PayPal sending your donation to messages@inner-light.co.uk or follow this link to Donate

Installation overview

This module installs in much the same way as other modules. Simply copy the "includes" and "image" folders to your online store directory.
Then go to modules > shipping in the store admin.
For each of the methods you want to install, select that line and click [Install].
Next, click [Edit] and switch it on (enable this shipping option "true").

You may want to also switch on "Hide invalid shipping" so customers aren't shown methods they can't use.

The rates are the current RM charges, so are best left unchanged.
If you want to add an amount for packaging cost, put that into the "Handling Fee" box. Then any changes in postage costs are easy to update.

If the order total is more than a set amount, this shipping method won't be offered. To change this limit, alter the amount in the "Maximum order value" box. To disable the limit, enter -1 in the box.

Some items are too big for certain postage methods. If you want to restrict the shipping options for a product, you assign a read-only attribute to the item, which sets the "minimum" delivery method. Run the SQL file "install3.2.sql" which will set up the attribute values.
Then it is easy to use the Attribute Controller to assign the relevant postage methods to an item.

If you read HowToUseAttributePricing it lists how it works.
In the first table on that page, across the top, there are the different attribute values you might have assigned to the item. Down the side are listed the modules that can be offered if that attribute is set.
To read the table, look down the column under the attribute you have set for an item, and the rows marked with Y show the delivery modules available for that product.
As you can see, if no attribute is set, all options are shown to the customer. If you set an option, that and any "larger" options are shown. Further down the page there is another table. This is for when you have enabled "Attribute match" to "true" for specific delivery options. Only exact matches will be available, not giving the customer the option of a "bigger" alternative. For example, with "Attribute match" off, an item set to "large letter" would also show the option of "small parcel" and "medium parcel". With "attribute match" on, only "large letter" would be offered. Where items in the basket have different options, only the biggest one will be offered. Once you have assigned the relevant attribute value to an item, Zen Cart has a feature to copy that item's attributes to other items or to all items in specified categories. So if you start with an item with no other attributes, you can easily copy it around your store.

Thanks to Hairydog for the text above, hope you find it useful.

How to Install Big Royal Mail

See CREDITS for licence and contributors.

INSTALLATION

  1. Copy the files from BigRoyalMail_V3.9.0/includes/* and BigRoyalMail_V3.9.0/images/* onto your server into:

    • YOUR_SHOPPING_CART_DIRECTORY/includes/
    • YOUR_SHOPPING_CART_DIRECTORY/images/

  2. Set up the modules you want

    • Note: If you intend to use the UK tracked 24 or 48 modules, please check that your post office is accepting these.
    1. Login to your Zen Cart admin.
    2. Go to Admin > Modules > Shipping
    3. Select the modules you want to install by clicking on it then clicking install.
    4. Modify any of the settings, then click Update.
    5. Repeat steps 3) and 4) for all the modules you wish to install.

  3. Run Install3.2.sql to add the entries to the configuration file.

    1. Login to your Zen Cart admin
    2. Use Tools > Install SQL Patches
    3. Copy the contents of Install3.2.sql and paste into the text window
      or
      Use the Browse button to load Install3.2.sql into Zen Cart.
    4. Press send button to execute script

    NB. Version 3.7.0 onwards is designed to work with Zen Cart 1.5.8 upwards. Use version 3.6.0 for any lower versions of Zen Cart. You can still use the yyyyUpdate.sql file from this release for the latest rates.
    UK tracked 24 and 48 are not available in that release.

  4. If you want to force a minimum delivery method, then set the appropriate attributes for each product. This can be done by visiting the product

    1. Login to your Zen Cart admin
    2. Use Catalog > Categories/Products, then navigate to your products
    3. Setting attributes for the product (click on the A in a circle).
    4. Select Minimum Delivery Method: [Read only]...
    5. Select the appropriate option value.
      The order is:
      i. Large Letter
      ii. Small Parcel
      iii. Medium Parcel
      iv. Special Delivery or Parcel Force
      Therefore, if you select Large letter, only standard letter will be excluded.
      If you select Medium Parcel then standard letter, Large Letter and Small Parcel will be excluded. For more information, see HowToUseAttributePricing.htm

  5. Check the default shipping and packing configuration.

    1. Login to your Zen Cart admin
    2. Use Configuration > Shipping/Packaging
    3. Check the value of Package Tare Small to Medium - added percentage:weight.
      The default is 0:3 which will add 3kg to the shipping weight.
      I use 0:0.05 which adds 50g.
    4. Check the value of Larger packages - added packaging percentage:weight
      The default is 10:0 which will add 10% to the shipping weight.

NB.

  1. I have now changed the modules to allow you to use attributes to determine the minimum delivery method for items (take some size into account). This does not take into account multiple items that when packed together would make the parcel larger than the size set. Therefore, you may still need to consider which modules you install.
  2. All pricing information is based on Kg, not Lbs. If you are using Lbs as your weight measure, you will either have to adjust your product weights to Kg or recalculate the weights to Lbs.
  3. If you are using Kg and have not already done so, see ZenCart Docs Product Weight - changing from pounds (lbs) to kg

If you wish to modify any of the text in the language files please use the template overrides system. Prior to Zen Cart V1.5.8 copy the file to your template folder in the includes/language/english/modules/shipping/YOURTEMPLATE this way you will not lose any changes if you install updates. As of Zen Cart 1.5.8 you only need to define the values you are changing. See Zen Cart documentation.

Zen Cart 2.0 has a new method. See Zen Cart documentation Storeowner Docs\Shipping\Shipping Dimensions

If you are upgrading, please read the file UPGRADES.

If you are using printer papers, you can ship up to 5kg overseas. The upgrade SQL PrintedPapers.sql will apply the rates.

NOTE: It will not differentiate between printed papers and other types of post, so do not use this unless you know you are shipping printed papers.
Additionally, you must have installed the full package before applying this update, as it only changes the rates. See PrintedPapers.sql for how to apply.

NOTE 2: Canada and Cambodia have a max weight limit of 2Kg regardless.

Clone this wiki locally