
UK Postcode Lookup for nopCommerce 

Created by		: CraftyClicks (support@craftyclicks.co.uk)
				  23 June 2014
				  
Version			: 0.2
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Intro:

	This modification adds UK postcode lookup functionality to nopCommerce. 
	
	Customers simply enter their postcode, click a button and select their address from a list. This saves them time and effort of
	having to type out their full address. This should create happy customers and help push the conversion ratios up. 
	
	Added bonus is that all addresses going into the database are pre-filtered. The chances of an incorrect address creeping in are
	hugely reduced. This should reduce chances of deliveries going to the wrong place and potentially save a lot of trouble for 
	the merchant.
	
	You need at an account from Crafty Clicks to make this code work on a live site. To sign up for a free trial account, go to
	www.craftyclicks.co.uk. Once signed up you will be emailed an access token. The demo account is limited to 30 lookups on the real 
	data.
	
	To go live on a production server you will have to buy some credit packs. Lookups are charged on a simple per click basis. Monthly
	direct debit plans and annual licences are available.

	There are some free postcodes: AA11AA, AA11AB, AA11AD and AA11AE. These can be used for testing at any time free of charge - with 
	or without registering for an account.
	
#########################################################################################################################################
Installation :

+++++++++++++++++++++++++++++++++++++++++++++< STEP 1 >+++++++++++++++++++++++++++++++++++++++++++++
Sign up for a trial account with CraftyClicks: http://www.craftyclicks.co.uk/myaccount/home/register

You will get an access token by email. There is no obligation to buy anything and you automatically
get 30 trial credits. If you need more credits to test the integration, please get in touch and we
will try to accommodate you (support@craftyclicks.co.uk).

+++++++++++++++++++++++++++++++++++++++++++++< STEP 2 >+++++++++++++++++++++++++++++++++++++++++++++
Copy & paste the token you got in step 1 to line 19 of nopcommerce_crafty_clicks.js (in place of xxxxx-xxxxx-xxxxx-xxxxx).

Upload nopcommerce_crafty_clicks.js and crafty_postcode_busy.gif to your server

+++++++++++++++++++++++++++++++++++++++++++++< STEP 3 >+++++++++++++++++++++++++++++++++++++++++++++
Reference the .js file in any of your .cshtml files that render a postal address form. 

That's it!

+++++++++++++++++++++++++++++++++++++++++++++< STEP 4 >+++++++++++++++++++++++++++++++++++++++++++++
(optional) Modify the configuration

Near the top of nopcommerce_crafty_clicks.js you will find some configuration settings. You will need to 
upload any changes again as per step 2.

+++++++++++++++++++++++++++++++++++++++++++++< STEP 5 >+++++++++++++++++++++++++++++++++++++++++++++
Test it. If it isn't working, drop us an email on support@craftyclicks.co.uk - we will help!

+++++++++++++++++++++++++++++++++++++++++++++< GO LIVE >++++++++++++++++++++++++++++++++++++++++++++
Once your trial credits run out, you will need to decide on the best purchasing option based on the 
volume of usage you expect on your site. Contact us for advice, or have a look at :
http://www.craftyclicks.co.uk/paf-database-pricing

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
