Add WC_Product::get_formatted_name()

For #2788
Add WC_Product_Variation::get_formatted_name()

For #2788
Deprecate woocommerce_get_formatted_product_name()

For #2788
Update woocommerce_get_formatted_product_name use

To use new WC_Product::get_formatted_name() function. For #2788
Update phpdoc
Added New Zealand states.
Merge branch 'master' of github.com:woothemes/woocommerce
Fix saving of download permissions in order admin.
PHP function fell outside PHP tags.

The function do_action() on line 983 fell outside the PHP tags en thus displayed as pure text in the admin panel.
Merge pull request #2857 from jorijnsmit/patch-2

PHP function fell outside PHP tags
Readme bump for #2857
Remove hard coded max from random products widget.
Issue #2865 Localize email settings

Change the behaviour of the get_option function so that it attempts to
localize the value for setting that is returned by the parent's
get_option by using gettext.
#2867 - Added a check to parent theme for comments_template before loading plugin template

#2867
Dutch spelling mistakes and .po file update
Merge pull request #2868 from ascottmccauley/2867-fix

#2867 - Added a check to parent theme for comments_template before loadi...
Merge pull request #2864 from pmgarman/master

Remove hard coded max from random products widget.
Merge pull request #2855 from splashingpixels/master

Add filter hook to the place order button for easy 3rd party manipulation
Readme
Fix IE Download via SSL bug and fix http file over SSL x-sendfile bug