Zip Code Lookup plugin for nopCommerce

Quick installation guide

1. Is this your first purchase at actOpus? If yes then first copy the License Manager plugin folder to the plugins directory

2. Copy the purchased plugin folder to the plugins directory

3. reload your plugins in nopCommerce

4. Is this your first purchase at actOpus? If yes then first install the License Manager plugin. No config needed

5. Install the purchased plugin

6. Register your plugin in the License Manager configuration screen.

7. Configure the purchased plugin

To install this plugin, follow this procedure:

1. First check if you have installed the actOpus License Manager. You should see that plugin in group 'misc' of your plugins. If you don't see the actOpus License Manager then follow the procedure 'How to install the actOpus License Manager'  to install the license plugin.
2. Locate the root folder of your webshop. This folder should contain other folders like 'Administration, bin, Content, Plugins, Themes' and more.
3. Next open the folder 'Plugins'
4. Unzip the contents of the downloaded file into this 'Plugins' folder. The zip file already contains a folder for the plugin 'Actopus.Zipcode' so when you unzip make sure you select the 'use folder names' option. 

Now your 'Plugins' folder should contain a folder named 'Actopus.Zipcode'. Latter should contain a dozen files. 

To configure this plugin, follow this procedure:

1. Go to your nopCommerce administration environment.
2. From the top menu 'Configuration', select the sub menu 'Plugins'.
3. Click the button 'Reload list of plugins', usually located just below the right top of the screen.
4. After a minute or so, the list is renewed and you will be able to find the plugin 'Actopus Postcode Services'. Its system name is: Actopus.Misc.ZipCode
5. Click on the button 'Install' at the end of the row and wait for the plugin to be installed
6. Now add your license using the actOpus License Manager by following the procedure 'How to add your licenses to the actOpus License Manager' at the end of this page. 
7. Now locate the plugin again in your 'Configuration' page.
8. Click on the button 'Edit', it's just below the plugin. Check 'is enabled' and save.
9. Back in the list: Click on the button 'Configure', it's just below the plugin.
10. In the dropdown box 'Select Netherlands in this list' you should lookup the country 'Nederland' and select that option.
11. In the dropdown box 'Webservice' you'll find two or more options.
    1. The option 'postcode.nl' requires a free subscription which can be obtained by registering on www.postcode.nl.
       
       1. If your use postcode.nl then you must enter your key and secret in the next to input boxes.
    2. The option 'insidertrader.biz' requires no registration at all. It's a free service but is less frequently updated. You can use this option as long as you don't have a postcode.nl subscription. 
12. Click 'Save'

As the plugin is installed, the 'Address2' and 'Address2 required' settings are automatically enabled. They are also renamed to 'Huisnummer' and 'Huisnummer is verplicht'.

As the Address2 field appears below the Address1 field on your invoices, you may want to change your invoice and packaging slip designs.

Using the plugin in your webshop:

The Actopus.Zipcode plugin contain a folder path named 'Views\Shared'. In this folder you will find a file named '_CreateOrUpdateAddress.cshtml'. This file is registered in nopCommerce to be used as the number one file for creation of an address. You may leave the file there, or move it to your own themes\<theme> folder. In case of a move, move it to 'Views\Shared' inside your theme folder .

When the user enters an address he or she should first select a country, next enter a zip code followed by a house number (+addition). When the lookup succeeds, the next two input boxes are skipped and the user can enter a phonenumber. When the lookup fails, the zipcode and house number fields are marked red. 

This plugin will automatically be picked whenever a user wants to create or update an address.

Learn more about postcode.nl here.

We love to extend this plugin with other countries so if you know a good, free zip code lookup service, feel free to contact us. We will always consider adding other zip services.

How to install the actOpus License Manager

1. Locate the root folder of your webshop. This folder should contain other folders like 'Administration, bin, Content, Plugins, Themes' and more.
2. Next open the folder 'Plugins'
3. Unzip the contents of the downloaded file into this 'Plugins' folder. The zip file already contains a folder for the plugin 'Actopus.LicenseManager' so when you unzip make sure you select the 'use folder names' option. 

How to add your licenses to the actOpus License Manager

1. Go to your nopCommerce administration environment.
2. From the top menu 'Configuration', select the sub menu 'Plugins'.
3. Click the button 'Reload list of plugins', usually located just below the right top of the screen.
4. After a minute or so, the list is renewed and you will see the plugin 'actOpus License Manager'. Its system name is:  Actopus.Misc.LicenseManager
5. Click the button 'Configure' (or 'Instellingen'), it's just below the plugin.
6. Click the button 'Add another license', it's just below the wrench icon.
7. In 'the license key' field, paste your license key that has been sent to you by email. Next click the 'Update' button at the end of the row. The license manager will now contact the actOpus server and retrieve the information about your license. 
8. Make sure the Domain/Url column matches your webshop's domain. Contact us if it doesn't match. Remember that your license is linked to the said domain/url and will only work for that domain.
9. Repeat steps 6, 7 and 8 for subsequent licenses.

Continue with the installation of you other plugin.