Menu

Welford Media Ltd

Support

​Below are helpful articles and documentation for our most popular OpenCart modules. If you can't find what you're looking for or you still need support, please don't hesitate to get in touch.

OpenStock

How to use OpenStock

Login to your admin area and go to Catalog > Products in your menu.

Click Insert/Edit (We recommend creating a test product first. Make sure the test product is working, particularly on the frontend, before changing all of your other products).

Click on the "Stock Control" tab.

Change the "Has Options" option to Yes - OpenStock, Another 2 tabs will appear called "Option" and "Option Stock".

Add your options and option choices, click save then go back into edit your product.

All of your available option stock choices will have been calculated for you and you can now add your stock, images, sku's etc.

How to install OpenStock

Installing OpenStock requires some knowledge of uploading files through FTP (using an FTP program like Filezilla or Cyberduck). If you would prefer us to install the module, we offer an install service for OpenStock. Please get in touch for more information.

  • Ensure that you have installed vQmod and it is working correctly.
  • Download and unzip the module files from where you have purchased the module.
  • There will be a folder named "upload" that contains folders like "admin", "catalog" "system" and "vqmod"
  • Upload all of these files to the root of your store (the folders you are uploading will also exist in the directory you are uploading to). If asked, choose "merge directories".
  • Login to your admin area and go to Extensions > Modules in your menu.
  • Click install next to the OpenStock module.
  • Navigate to Catalog > Options
  • Make sure ALL options have a unique sort order
  • The module is now installed - you do not need to configure anything.

To verify that the module has installed, go to a product and click edit (products are under Catalog > Products in your menu). You will see a new tab called Stock Control, if you do not see this tab then:

  • Clear your vQmod cache folder
  • Disable all of your other modules that affect the product edit page - you may have a conflict
  • Check your vQmod log for errors (errors are usually caused by conflicts of if you have modified the core code)
How to fix common problems

Custom Theme

If you are using a custom theme and are having issues with OpenStock, you'll need to have changes made to your theme to ensure that OpenStock works correctly with it. Our team can make the needed changes to your theme for you, simply visit our store to book in your patch.

Other Common Issues

The OpenStock module will almost certainly not work with ANY other module that alters product options.

If you receive the error "Warning: Cannot modify header information - headers already sent" when trying to save a product with a lot of option variants, you will need to ask your host to increase "max_input_vars".

Some users also have problems when they have lots of options such as when they save some of the data goes missing or variants duplicating every time you save the product. This is again related to the php setting "max_input_vars" - ask your host to significantly increase the value. Use a PHP info file to get your current value.

How to update OpenStock

WARNING: Always back up your website files and database before applying updates to modules. If any changes have been made to openstock_customise.xml (to make OpenStock work with a custom theme) you have to back this up as updating the module will overwrite this file.

WARNING: Don't uninstall your current version of OpenStock. Doing this will remove all product variants from the database.

  • Download and unzip the module files from where you have purchased the module.
  • There will be a folder named "upload" that contains folders like "admin", "catalog" "system" and "vqmod"
  • Upload all of these files to the root of your store (the folders you are uploading will also exist in the directory you are uploading to). If asked, choose "merge directories".
  • Login to your admin area and go to Extensions > Modules in your menu.
  • Click the "Repair" tab and click the Repair button.

The module is now updated - you do not need to configure anything.

Custom Theme Patch

If you are using a custom theme, it's likely that you will need to alter the vqmod/xml/openstock_customise.xml file for OpenStock to correctly work. If you are unable to do this yourself, we offer a custom theme patching service available on our store.

Journal Theme

On the Journal Theme, our regular patching service is only valid when "Button Select List" is turned off.

Disclaimer

This patching service is only valid for stores that haven't installed 3rd party option modules or changed any code that affects the options system in OpenCart. If you are unsure, please contact us and we'll provide a quote.

Import / Export Feature

We have built an import/export feature into OpenStock that allows you to modify existing variants. You cannot add new variants or delete existing ones using this feature.

The fields you CAN edit are:

  • SKU
  • Stock Level
  • Weight
  • Price
  • Status

The fields you CANNOT edit are:

  • Variant ID (VID #)
  • Product Name
  • Variant Name
How to re-enable the specials tab & discounts tab

Before you begin to enable the special or discount tabs for OpenStock products, you should understand why they are hidden by default.

If you are just looking to display a product special price, or discount for quantity-based ordering you can do so on a per-variant basis which allows for much better control over your stock and pricing.

By re-enabling the special tab it will allow the product to appear as a "special price" elsewhere in your store (i.e. the category or search pages) but this pricing WILL NOT affect the actual price the user pays. OpenStock is very complex in the way it works, it effectively splits up products when they have options and it allows you to have as much control over the pricing & stock for each option.

How to re-enable the tab

  • In the menu system go to 'Extensions -> Modules'
  • Click the Edit link for the OpenStock module
  • Enable "Show Special tab on product edit page"
Bulk create variants

OpenStock 2 allows you to turn all of your option products in to OpenStock variants in one click.

Log in to your admin area and go to Extensions > Modules > OpenStock 2 > Edit. Click on the settings tab. Both "Defaults" and "Bulk Create Defaults" are used when bulk creating variants. Choose these and click save. Now, go to Extensions > Modules > OpenStock 2 > Edit again and click the Bulk Create Variants tab. This page should have your defaults you have previously selected (You need to save the settings before clicking this tab).

"Preview" will tell you have many variants will be created but won't actually create any.

For all products that have Has Options - Regular, "Create" will turn these in to OpenStock variants using the defaults you have saved.

How to display the default product price

By default OpenStock will hide a product price until the user makes the selection of options.

You can change this behaviour to display the standard product price when the page loads - this will then change when the options are chosen.

  • Go to Extensions > Modules > OpenStock - variant stock control and click Edit
  • Change "Show default price" to Yes.

The "default price" is the main product price, not a variant price.

Amazon S3 / CloudFront Integration

How to install Amazon S3

You must download and install vQmod before you install the module. This module will not work without vQmod.

Backup EVERYTHING for your website. This module is a stable release and has undergone testing but we are not responsible for any data loss or file corruption! Please ensure your database and files are backed up before you proceed.

Unzip the module files.

Drag in all of the contents of the upload folder in the module to your root directory of your website. Your root directory contains folders like “admin”, “catalog”, “system” etc.

Log in to your store admin area.

Now navigate to the installed extensions folder “Extensions > Modules”, here you will see a new extension called “Amazon S3” – click install.

The Amazon module is now installed, you can now enter your details and configure your details.

How to set up the CloudFront integration

CloudFront integration will use the bucket provided in the Settings tab as the origin.

In order to set up CloudFront you will have to do the following tasks:

  • Upload your private key onto your shop's server. Make sure it is not publicly accessible.
  • Set up two different behaviours. For all requests going to /image/, the requests must not use Signed URLs. For all requests going to /download/ the requests must have Signed URLs.

Optional: if you want use your own domain instead of the default CloudFront's one you will have to do the following tasks:

  • Point your domain to the CloudFront domain (e.g. point www.example.com to xxxxxxxx.cloudfront.net)
  • In Distribution's settings area provide the alternative domain
  • Enter your custom domain in OpenCart
  • Warning: CloudFront does not support custom domains with HTTPS, so if you are using HTTPS on your shop you cannot use custom domains.
Do i need to upload anything to S3?

No. This module will take care of that for you. You don't need to upload any images to S3. Product Downloads are uploaded to S3 each time you save your Product Download in the back office or use the bulk upload tool.

Where do i upload the Private Key?

You need to upload your Private Key somewhere safe on the server where no one could access it. For starters, you could upload it out side your server's web root.

Why are my original images not on Amazon S3?

Normal product images are NOT uploaded or stored on Amazon S3, only the image cache files. Images have to be uploaded normally using OpenCart, and these original image files remain on the web server. Cached versions of these files are then saved and served from Amazon S3.

Autocomplete Address Lookup

How to install Autocomplete Address Lookup

Installing our Autocomplete Address Lookup module is really easy!

First, you'll need to purchase the module and download the module files - make sure you download the correct files for your OpenCart version. Once you've downloaded the files, you'll need to add the contents of the upload folder to the web root of your OpenCart store.

Next, log into your store's admin area and navigate to Extensions > Modules > Autocomplete Address Lookup and click install. Click the edit button next to Autocomplete Address Lookup and then change "Enable Autocomplete Address Lookup" to "Yes".

If you need a hand installing your module our team can install it for you. For more information, please see our module installation service on our online store.

How to use Autocomplete Address Lookup

Autocomplete Address Lookup is extremely easy to use. Once you've installed the module, you'll be able to access it from the modules list in your store's admin area.

When editing the module, you'll see the general settings tab where you can choose to enable or disable the module, and multiple other tabs along the top. Each of these tabs relates to a different area of your store where the Autocomplete Address Lookup module can be used.

For each placement on the store, you can choose whether to enable the module and whether to enable Google Maps for that placement.

In order for the module to work it's best, we advise users to type in the first line of the address into the Auto Fill box. Entering a postcode will not work.

Will Autocomplete Address Lookup work with a custom checkout?

As with all of our modules, our Autocomplete Address Lookup module is built to work with the default OpenCart installation.

Autocomplete Address Lookup will not work correctly if you're using any other module or custom feature to modify the checkout, for example One Page Checkout or Quick Checkout.

Our team can modify your store to make Autocomplete Address Lookup and other checkout features work together - please get in touch for a quote.

Will Autocomplete Address Lookup work with a custom theme?

Our Autocomplete Address Lookup module has only been tested on the default OpenCart theme. If you're using a custom theme, it's likely that the theme will cause issues with our module.

Our team can build a custom fix to make Autocomplete Address Lookup work correctly with your store's custom theme, please get in touch for a quote.

Checkout Success Details

How to install Checkout Success Details

To install Checkout Success Details, you'll first need to make sure that you have vQmod installed on your OpenCart store.

Once you've purchased the Checkout Success Details module, download the corresponding files for your OpenCart store version. Next, upload the contents of the 'Upload' folder to the root directory of your store.

Log into your store's admin area and navigate to Extensions > Modules. Click install next to Checkout Success Details.

You can now edit the module to configure the options to fit your needs.

How to use Checkout Success Details

Our Checkout Success Details module is very easy to use, with no development knowledge needed. There are three tabs within the Checkout Success Details module: Message, Details and Misc.

  • In the Message tab, you can change the heading and the main text of the checkout success page.
  • In the Details tab, you can select which sections and features of the checkout success page you'd like to show, including comments, shipping details, product details, IP address and more.
  • In the Misc tab, you'll see miscellaneous settings for the module, such as the product image dimensions.
Why does the normal success page still show with Checkout Success Details installed?

If you have correctly installed and enabled our Checkout Success Details module but the standard success page is still showing, it's likely that you either haven't got vQmod installed or the module is conflicting with another module or feature on your website.

Our team offer an investigation service where we can look into and fix the issue for you. Please contact our team for a quote.

How do I show Checkout Success Details in multiple languages?

If you'd like to use our Checkout Success Details modules with multiple languages, you'll need to copy the following file to your other language folders:

/catalog/language/english/checkout/checkout_success_details.php

Is Checkout Success Details compatible with other checkout modules?
  • Our modules are only tested against a default installation of OpenCart, with no other modules installed. Because of this, we can not say for definite if Checkout Success Details will work with any 3rd party modules or custom features.
  • If you do experience a conflict between Checkout Success Details and another module or custom feature, our team will be able to investigate and fix the issue for you. Please contact us for a quote.

Interactive Banner

How do I install Interactive Banner?

To install our Interactive Banner module, you'll first need to purchase the module and download the correct files for your OpenCart version.

Upload the contents of the Upload folder to the web root of your OpenCart store, navigate to Extensions > Modules and click the install button next to Interactive Banner.

How to use Interactive Banner

To use the Interactive Banner module, you'll need to add your chosen banners and then add the interactive buttons to the banners.

First, navigate to System > Design > Banners in your OpenCart admin area and choose a banner to edit. If you're adding a new image to the banner, add the banner and then click the "Save & Continue for Interactive" button. The Interactive button will then appear for the new images.

Next, click the Interactive button, drag the tooltip to the desired area on the image and add a product to the text field using the autocomplete functionality.

Alter the tooltip or background colour using the tools provided in the left hand corner then save them banner when you're finished.

Finally, add the banner to the site as you would with a normal banner.

PDF on Information Pages

How to use PDF on Information Pages

Once you've installed our PDF on Information Pages module, navigate to Catalog > Information > Edit in your website admin area.

Choose a PDF to upload to the information page and set the size that you would like it to display at. The default size will match the full width of OpenCart.

Once saved, go to the desired information page to view the PDF.

Restrict Catalog by Customer Group

How to install Restrict Catalog by Customer (OpenCart 1.5.x)

To install Restrict Catalog by Customer Group, firstly add the contents of the upload folder to the web root of your OpenCart store. Make sure to use the correct files for your OpenCart version.

Navigate to System > Users > User Groups. Choose the desired user group and enable the required permissions. For OpenCart 1.5.x, look for catalog/custom_catalog in the permissions list.

How to use Restrict Catalog by Customer Group (OpenCart 1.5.x)
  • Navigate to Catalog > Restrict Catalog in the OpenCart admin area.
  • Choose what type of Catalog item you would like to restrict
  • Select the tab for the desired customer group you would like to restrict an item from and then choose the Catalog items you would like to restrict. Any item the you choose will then be hidden from any customer logged in with the associated customer group
How to install Restrict Catalog by Customer Group 2 (OpenCart 2.x)

To install Restrict Catalog by Customer Group 2, first purchase the module and download the correct files for your OpenCart version.

  • Unzip Restrict Catalog by Customer Group 2.zip
  • Navigate to Extensions > Extension Installer > Upload restrict_catalog.ocmod.zip
  • Navigate to Extensions > Modifications. Check that Restrict Catalog By Customer Group 2 has been installed and then Refresh
  • Navigate to System >Users > User Groups. Choose the desired user group and enable the required permissions for module/restrict_catalog
  • Navigate to Extensions > Modules > Restrict Catalog By Customer Group > Install
How to use Restrict Catalog by Customer Group 2 (OpenCart 2.x)

Navigate to Catalog > Restrict Catalog in the OpenCart admin area.

Set the global options

Allow search bots to access all content – the extension restricts content based on customer group and when a search engine spider/bot crawls your site it will do so as a default customer. This means that any page that is restricted from a default user will also be hidden from a search engine and will not be indexed. This may be desired or it may not be, this settings allows you to decide which is best for your site. Note that this setting only applies to content restricted by this extension. Also note that it is possible for someone to fake that they are a search engine, therefore it is not recommend to enable this setting if you have any sensitive material on restricted pages

Globally restrict all products of a restricted category - if you enable this setting then by restricting a category you are also restricting any product that is linked to that category

Globally restrict all products of a restricted manufacturer - if you enable this setting then by restricting a manufacturer you are also restricting any product that is linked to that manufacturer

Catalog Type

  • Click edit for the category type that you would like to restrict
  • You will then see tabs for each customer group for your store, and each tab will contain a list of the catalog types you have chosen.
  • The pagination of catalog types is based on the system setting “Default Items Per Page (Admin):”
  • Select the catalog types that you would like to restrict for each customer group and then save the selection
  • If you wish to save and continue editing the options then click Save and Continue

Products

There is a filter system for increased usability.

It uses auto complete system for the product name and model

You can also chose to display the results using either the product name or the model, product name is default

Checkout and Price

Set a value for the minimum order total that you require for each customer group.

Leave the value at zero if you do not wish to restrict the checkout.

Choose a minus value if you wish to completely restrict the checkout from that customer group.

If you restrict the price then the checkout will automatically be restricted as well, a customer cannot checkout without prices. This is based on the functionality of the system setting “Login Display Prices”.

Export /Import CSV

If you have a large number of entries for a catalog type then you can use the CSV to make things easier.

  • Click edit for the category type that you would like to restrict
  • Click Export CSV
  • Only modify the status column of the CSV, changing the values to either restricted or unrestricted
  • Click Import CSV and chose the previously modified CSV

Share Your Purchase

How to install Share Your Purchase

Installing Share Your Purchase on your OpenCart store consists of two stages: installing the module and setting up Facebook with the module.

  • Install VQMod on your OpenCart store
  • Download the correct version of Share Your Purchase for your OpenCart store version
  • Copy the contents of the 'Upload' folder to the root directory of your website

If you do not want to use the Facebook share feature, please skip to step 10.

  • Visit developers.facebook.com
  • Click My Apps - Add a New App
  • Choose Website and type in your app name. Customers will see this to make sure it relates to your website.
  • Click Create a New App ID and follow the instructions
  • Under "Tell us about your website" add in your Site URL and Mobile Site URL
  • Next click "Skip to Developer Dashboard"
  • Click Settings and type in your domain under App Domains (You must enter a Site URL and Mobile Site URL before you can do this) and fill in the contact email.
  • Then, Click Status & Review and toggle the button to make the app live.
  • Finally, go to Dashboard, copy your App ID and paste this in your OpenCart settings under Admin > Settings > Share Your Purchase > Facebook App ID
  • Set up complete!
How to set up Facebook with Share Your Purchase
  • Visit developers.facebook.com
  • Click My Apps - Add a New App
  • Choose Website and type in your app name. Customers will see this to make sure it relates to your website.
  • Click Create a New App ID and follow the instructions
  • Under "Tell us about your website" add in your Site URL and Mobile Site URL
  • Next click "Skip to Developer Dashboard"
  • Click Settings and type in your domain under App Domains (You must enter a Site URL and Mobile Site URL before you can do this) and fill in the contact email.
  • Then, Click Status & Review and toggle the button to make the app live.
  • Finally, go to Dashboard, copy your App ID and paste this in your OpenCart settings under Admin > Settings > Share Your Purchase > Facebook App ID