Documentation
Installation instructions
If downloaded package has .ocmod.zip extension, you can install it using Extension Installer. If you see "The directory is not allowed to be written to" error message, download Extension Installer Fix from this page and install it. Then install the main extension.
In any other case or if you want to install it manually, unpack and upload all folders to the root of your store. If there's install.xml file in the package, rename it to extension_name.ocmod.xml, replacing "extension_name" with extension's name, and upload it to "system" folder.
When upgrading from previous version rewrite all existing files. Refresh modifications cache from Extensions -> Modifications page.
Note for OpenCart 2.0.X users
Sometimes OCMod inserts modification in multiple files, which are separated by "|" character in XML-file. On earlier OpenCart 2 versions a comma was used instead. To quickly fix this, open XML file and replace all occurrences of "|" character with "," for "path" attribute in every applicable <file> element. Search for "<file path=" to quickly find and highlight all elements.
Note for OpenCart 2.3 users
On OpenCart 2.3 compatibility code is broken, which may lead to Permission Denied issue, when you access extension settings. To fix this you need to install OpenCart 2.3 Compatibility Fixes extension.
The right sequence of actions is the following:
- Download our purchased (or free) extension, but do not install it yet (uninstall, if already installed).
- Install OpenCart 2.3 Compatibility Fixes extension.
- Refresh modifications cache from Extensions -> Modifications page.
- Go to System -> User Groups and select all access/modify permissions for your group.
- Install our purchased (or free) extension.
If you did everything right, everything will start working properly.
Note for OpenCart 3 users
NOTE: Instructions below are required only if "admin" or "catalog" folders are present in the package!
To install and use extension on OpenCart 3 you need to install OpenCart 3 Compatibility Fixes. It adds backward compatibility with old extension structure plus adds back support for .tpl files and enables automatic template engine detection.
The right sequence of actions is the following:
- Download our purchased (or free) extension, but do not install it yet (uninstall, if already installed).
- Install OpenCart 3 Compatibility Fixes extension.
- Go to Extensions -> Modules section, install and enable Template Switcher.
- Refresh modifications cache from Extensions -> Modifications page.
- Go to System -> User Groups and select all access/modify permissions for your group.
- Install our purchased (or free) extension.
If you did everything right, everything will start working properly.
Permissions
In some cases it is required to manually set permissions for installed extension. To do this go to System -> User Groups, find your group and select access/modify permissions for desired extension. You can find extension in permissions list by folder/filename pair (for example, marketing/acoupon).
Extension Setup
Installation and settings
Copy contents of the archive to your OpenCart folder, go to Extensions -> Shipping, find Lithuanian Post, click Install and then setup accordingly. Most things explained right in the tips to each option in settings, so, please, read them carefully. We tried to be as much specific as possible.
NOTE: OpenCart countries will be automatically linked with Lithuanian Post countries, but not all of them. Some countries you'll have to link manually in settings.
IMPORTANT: There's a large array of data being saved. If you see an error, when saving settings, add these lines to your php.ini file:
max_input_vars = 5000
suhosin.post.max_vars = 5000
suhosin.request.max_vars = 5000
If variables mentioned above exist, change their values to 5000 or higher.
Extension's options
In general, all options are pretty easy to understand, but tome of them require explanation:
- From region — A mandatory option; shipping costs will be calculated according to it.
- From city — Doesn't influence shipping costs and only informs customers, if marker set.
- Order minimum total — If order total is less, than value set, this shipping method won't be displayed.
- Order maximum total — If order total is more, than value set, this shipping method won't be displayed.
- Contractual Customer — When set to Yes, 21% VAT rates will be added to all shipping costs.
- Add Priority — All shipping costs will be calculated according to rates for priority items (where applicable).
- Add Registration — Registration value will be added to all shipping costs (where applicable).
- Add Insurance —Insurance value will be added to all shipping costs (where applicable).
- Cheapest Only — Only the cheapest available shipping type will be displayed.
- Follow Weight —Shipping types will be selected according to package weight: up to 2 kg — packet, over 2 kg —parcel.
- Free Shipping — When order total is equal or more, than value set, shipping will be free.
- Package weight — Additional value in grams or percent from total weight of the products, which will be added before calculating shipping costs.
- Packaging fee — Additional value in euro or percent from order subtotal, which will be added to shipping costs.
- Round value — Shipping costs will be rounded to given value (e.g: if set to 10 amount of 271.52 EUR will be rounded to 280).
- Hide Errors — In case of any error shipping method will not be displayed, error messages hidden.
Using tags
You can add special tags in package type titles, which will activate some functions and show customers additional info. Usage example:
Large packet with registration (+ {register}) and insurance (+ {insurance})
{register} and {insurance} tags will be replaced with actual amounts in euro: for package registration and insurance.
Available tags:
- {fixed XXX} — Fixed delivery price, where XXX — amount in EUR (e.g.: {fixed 200} means, that for this package type shipping will always equal 200 EUR).
- {from_country} — Country you ship from (always Lithuania).
- {from_region} — Region you ship from (taken from settings).
- {from_city} — City you ship from (taken from settings).
- {to_country} — Customer's country (from the selected address).
- {to_region} — Customer's zone (from the selected address).
- {to_city} — Customer's city (from the selected address).
- {register} - Registration fee (constant value).
- {insurance} — Insurance fee (constant value).
- {fee} — Packaging fee (taken from settings and counted from cart subtotal).
- {free} — Order amount for free delivery (taken from settings).
Updating rates
To update rates, put or edit CSV files in admin/model/localisation/lpost folder. Then go to extension's settings and click Update Rates button.
- local.csv — rates for domestic parcels;
- packet.csv — rates for domestic and international packets;
- parcel.csv — rates for international parcels with countries list;