Skip to content

Upgrade

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

Big Royal Mail

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

How to upgrade to the latest Version of Big Royal Mail

IMPORTANT: Version 3.7.0 onwards has been designed to work with Zen Cart V1.5.8 upwards. If you are using a version of Zen Cart before this, it will not function correctly. However, you can still use the mmmYYYYUpdate.sql files to update your rates.

Choose your current version

NB. If you are using Zen Cart Version 1.3.8 and you are required to run Install3.2.sql, you will need to use the script in 1.3.8_scripts and not the one in the top level.

From Version 3.7 to 3.8 any

  1. If you are using Zen Cart 1.5.7 or below, BigRoyalMail may still work if you do not remove the current language files.

  2. If you are using Zen Cart 1.5.8 or above and have not deleted the old language files, see From Version 3.5.0 to 3.6 any below.

    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/

  3. To apply the latest rates either:

    1. Run apr2024Update.sql:

      1. Backup your database before running the update.
      2. Login to your Zen Cart admin.
      3. Use Tools -> Install SQL Patches.
      4. Copy the contents of apr2024Update.sql and paste it into the text window or use the Browse button to load apr2024Update.sql into Zen Cart.
      5. Press the send button to execute the script.

    2. OR Uninstall and reinstall all the Royal Mail shipping modules you are using.
      Note: This will remove all handling fees and override changes to country codes you may have made. So please note any changes you have made before you begin.

      1. Login to your Zen Cart admin.
      2. Use Admin -> Modules -> Shipping.
      3. For each of the modules installed:
        • Green dot in sort order: installed and in use.
        • Yellow dot in sort order: Installed not in use.
      4. Highlight by clicking the module line.
      5. Click Remove Module.
      6. Click Remove Module on the confirmation message.
      7. Click Install Module.
        NB. If the dot after status was Yellow, you do not need to reinstall as you were not using it so skip remaining steps for that module.
      8. Modify Enable this shipping option to True to turn the module on.
      9. If you do not want to display invalid shipping options, modify Hide Invalid Shipping to True.
      10. Check the handling fee/s and modify if necessary.
      11. Click Update.

  4. If you use printed paper rates, after you have installed all the modules you need, run PrintedPapers.sql:

    1. Backup your database before running the update.
    2. Login to your Zen Cart admin.
    3. Use Tools -> Install SQL Patches.
    4. Copy the contents of PrintedPapers.sql and paste it into the text window or use the Browse button to load PrintedPapers.sql into Zen Cart.
    5. Press the send button to execute the script.

From Version 3.5.0 to 3.6 any

  1. If you are using Zen Cart 1.5.7 or below, BigRoyalMail may still work if you do not remove the current language files.

  2. If you are using Zen Cart 1.5.8 or above, delete all the BigRoyalMail language files from YOUR_SHOPPING_CART_DIRECTORY/includes/languages/english/modules/shipping:

    • rm1stlargeletter.php
    • rm1stlargelettersf.php
    • rm1stletter.php
    • rm1stlettersf.php
    • rm1stmedparcel.php
    • rm1stmedparcelsf.php
    • rm1stsmlparcel.php
    • rm1stsmlparcelsf.php
    • rm2ndlargeletter.php
    • rm2ndlargelettersf.php
    • rm2ndletter.php
    • rm2ndlettersf.php
    • rm2ndmedparcel.php
    • rm2ndmedparcelsf.php
    • rm2ndsmlparcel.php
    • rm2ndsmlparcelsf.php
    • rmamlargeletter.php
    • rmamlargelettersf.php
    • rmamletter.php
    • rmamlettersf.php
    • rmamparcel.php
    • rmamparcelsf.php
    • rmamtlargeletter.php
    • rmamtletter.php
    • rmamtparcel.php
    • rmamtslargeletter.php
    • rmamtsletter.php
    • rmamtsparcel.php
    • rmpfexpress10.php
    • rmpfexpress24.php
    • rmpfexpress48.php
    • rmpfexpress9.php
    • rmpfexpressam.php
    • rmpfgeconomy.php
    • rmpfgexpress.php
    • rmpfgpriority.php
    • rmpfgvalue.php
    • rmpfiexpress.php
    • rmsmparcel.php
    • rmspecialdelivery.php
    • rmspecialdelivery9am.php
    • rmspecialdeliverysat.php
    • rmspecialdeliverysat9am.php

  3. If you have modified any of the language files and saved them to your template, these will need changing to 'lang.' files and modifying to the Zen Cart 1.5.8 standard. See Zen Cart documentation.

  4. 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/

  5. Uninstall and reinstall all the Royal Mail shipping modules you are using.
    Note: This will remove all handling fees and override changes to country codes you may have made. So please note any changes you have made before you begin.

    1. Login to your Zen Cart admin.
    2. Use Admin -> Modules -> Shipping.
    3. For each of the modules installed:
      • Green dot in sort order: installed and in use.
      • Yellow dot in sort order: Installed not in use.
    4. Highlight by clicking the module line.
    5. Click Remove Module.
    6. Click Remove Module on the confirmation message.
    7. Click Install Module.
      NB. If the dot after status was Yellow, you do not need to reinstall as you were not using it so skip remaining steps for that module.
    8. Modify Enable this shipping option to True to turn the module on.
    9. If you do not want to display invalid shipping options, modify Hide Invalid Shipping to True.
    10. Check the handling fee/s and modify if necessary.
    11. Click Update.

  6. If you use printed paper rates, after you have installed all the modules you need, run PrintedPapers.sql:

    1. Backup your database before running the update.
    2. Login to your Zen Cart admin.
    3. Use Tools -> Install SQL Patches.
    4. Copy the contents of PrintedPapers.sql and paste it into the text window or use the Browse button to load PrintedPapers.sql into Zen Cart.
    5. Press the send button to execute the script.

From Version 3.2.1 to 3.4 any

  1. If you are using Zen Cart 1.5.7 or below, BigRoyalMail may still work if you do not remove the current language files.

  2. If you are using Zen Cart 1.5.8 or above, delete all the BigRoyalMail language files from YOUR_SHOPPING_CART_DIRECTORY/includes/languages/english/modules/shipping:

    • rm1stlargeletter.php
    • rm1stlargelettersf.php
    • rm1stletter.php
    • rm1stlettersf.php
    • rm1stmedparcel.php
    • rm1stmedparcelsf.php
    • rm1stsmlparcel.php
    • rm1stsmlparcelsf.php
    • rm2ndlargeletter.php
    • rm2ndlargelettersf.php
    • rm2ndletter.php
    • rm2ndlettersf.php
    • rm2ndmedparcel.php
    • rm2ndmedparcelsf.php
    • rm2ndsmlparcel.php
    • rm2ndsmlparcelsf.php
    • rmamlargeletter.php
    • rmamlargelettersf.php
    • rmamletter.php
    • rmamlettersf.php
    • rmamparcel.php
    • rmamparcelsf.php
    • rmamtlargeletter.php
    • rmamtletter.php
    • rmamtparcel.php
    • rmamtslargeletter.php
    • rmamtsletter.php
    • rmamtsparcel.php
    • rmpfexpress10.php
    • rmpfexpress24.php
    • rmpfexpress48.php
    • rmpfexpress9.php
    • rmpfexpressam.php
    • rmpfgeconomy.php
    • rmpfgexpress.php
    • rmpfgpriority.php
    • rmpfgvalue.php
    • rmpfiexpress.php
    • rmsmparcel.php
    • rmspecialdelivery.php
    • rmspecialdelivery9am.php
    • rmspecialdeliverysat.php
    • rmspecialdeliverysat9am.php

  3. If you have modified any of the language files and saved them to your template, these will need changing to 'lang.' files and modifying to the Zen Cart 1.5.8 standard. See Zen Cart documentation.

  4. Remove EU modules:

    1. Delete the following files:

      • rmamteuletter.php
      • rmamteulargeletter.php
      • rmamteuparcel.php

      From:

      • YOUR_SHOPPING_CART_DIRECTORY/includes/modules/shipping
      • YOUR_SHOPPING_CART_DIRECTORY/includes/languages/english/modules/shipping

  5. Remove all the configuration values.
    Note: This will remove the configuration values from all the Big Royal Mail methods and set them to uninstalled.

    1. Make a note of all the Royal Mail shipping modules you are using:

      1. Login to your Zen Cart admin.
      2. Use Admin -> Modules -> Shipping.
      3. For each of the modules installed:
        • Green dot in sort order: installed and in use.
        • Yellow dot in sort order: Installed not in use.

    2. Run RemoveAll.sql to remove the values from the configuration tables.
      Note: This will remove the configuration values from all the Big Royal Mail methods and set them to uninstalled.

      1. Backup your database before running the update.
      2. Login to your Zen Cart admin.
      3. Use Tools -> Install SQL Patches.
      4. Copy the contents of RemoveAll.sql and paste it into the text window or use the Browse button to load RemoveAll.sql into Zen Cart.
      5. Press the send button to execute the script.

  6. 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/

  7. Reinstall all the Royal Mail shipping modules you require:

    1. Login to your Zen Cart admin.
    2. Use Admin -> Modules -> Shipping.
    3. Highlight by clicking the module line.
    4. Click Install Module.
    5. Modify Enable this shipping option to True to turn the module on.
    6. If you do not want to display invalid shipping options, modify Hide Invalid Shipping to True.
    7. Check the country codes and handling fee(s) and modify if necessary.
    8. Click Update.

  8. If you use printed paper rates, after you have installed all the modules you need, run PrintedPapers.sql:

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

The content continues in a similar pattern for the remaining versions. You can find the original HTML file here.

Clone this wiki locally