Title Zones ManagerVersion 1.0.0.0Author InnoExts (http://innoexts.com)Follow UsZones ManagerZones Manager1. Overview2. In...
Allowed productsqMinimum order amountqCompound priceqCompound special priceqTier priceqCatalog price rulesqBuild-in bulk c...
The next sections are available in the configuration: Options, Catalog, Currency, Store, Payment, Shipping.3.1. Options3.1...
This section is dedicated for catalog specific options.3.2.1. Category FilterThe product category filter can be enabled / ...
3.3.2. Default CurrencyAllow default currency here.3.4. Store3.4. Store3.4.1. Store FilterEnable / disable stores filter h...
3.5.1. Payment Method FilterEnable / disable payment methods filter.3.5.2. Default Payment MethodAllow default payment met...
4.1. General4.1. General
The only tab that is available for the create new zone process is General. Here you fill in zone general details4.1.1. Cod...
Each zone can include a number of subzones in it for the flexibility. Each subzone can be defined as country, region, exac...
Allowed stores list for the zone.4.5. Payment Methods4.5. Payment MethodsAllowed payment methods list for the zone. The pa...
Allowed shipping methods list for the zone. The shipping carrier must be previously enabled in the Shipping Methodsconfigu...
Note, product category availability doesnt affect products availability itself.4.8. Products4.8. ProductsThe list of produ...
Compound Price attribute is placed under Price. It allows to overwrite the product price for each zone. So, once acustomer...
5.3. Tier Price5.3. Tier PriceUnlike the default Magento tier price feature it allows to set tier price depending on zone....
6.1. Zones6.1. ZonesZones attribute is placed under Customer Groups on the Rule Information tab. It allows to enable / dis...
Compound Discount Amount attribute is placed under the Discount Amount on the Actions tab. It allows to overwritethe disco...
browser provides coordinates if it is allowed by the customer. Coordinates geolocation takes effect if default shippingadd...
7.3. IP Geolocation7.3. IP GeolocationIn administrator panel: System -> Configuration -> Customers -> IP GeolocationIP Geo...
Omit ftp arguments to run import from local data feed:php shell/Innoexts/Zone/Catalog/Product/Price/Importer.php --file-pa...
Omit ftp arguments to run import from local data feed:php shell/Innoexts/Zone/Catalog/Product/Tierprice/Importer.php --fil...
Upcoming SlideShare
Loading in …5
×

Zones Manager Magento Module Manual 1.0.0.0

813 views

Published on

Zones Manager allows to set up and control different geo zones with their own prices, minimum order amounts, catalog price rules, allowed and default stores, currencies, payment methods, shipping methods, catalog categories and products. Also, it detects customer’s geo location by IP address or by browser provided coordinates and assigns him to the proper zone.

Published in: Education, Technology, Business
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
813
On SlideShare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
3
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Zones Manager Magento Module Manual 1.0.0.0

  1. 1. Title Zones ManagerVersion 1.0.0.0Author InnoExts (http://innoexts.com)Follow UsZones ManagerZones Manager1. Overview2. Installation3. Configuration4. Manage Zones5. Manage Products6. Catalog Price Rules7. Customer Locator8. Data Import9. Uninstallation1. Overview1. OverviewZones Manager extension enables to create and manage geo zones with their own settings. It assigns the customer to acertain zone depending on his / her place of residence. For each zone the next options can be defined: minimum orderamount, product prices, product special prices, product tier prices, catalog price rules, allowed / default stores, currencies,payment methods, shipping methods, catalog categories and products.FeaturesFeaturesAllowed storesqDefault storeqAllowed currenciesqDefault currencyqAllowed payment methodsqDefault payment methodqAllowed shipping methodsqDefault shipping methodqAllowed product categoriesq
  2. 2. Allowed productsqMinimum order amountqCompound priceqCompound special priceqTier priceqCatalog price rulesqBuild-in bulk compound prices, compound special prices and tier prices importersqCustomer LocatorAllow a customer to modify his / her location manually or select from address bookqApply default shipping addressqDetect customer location by browser provided coordinatesqDetect customer location by IP addressqApply default location defined in settingsqAdjust customer location on checkoutq2. Installation2. InstallationFirst of all we would like to suggest you to keep a development copy of a live installation for a new or updated extensionstesting. The Magento shopping cart provides the flexible and comfortable extensions system. This fact is a basis of apowerful community. Therefore, the numerous extensions you may need presence is guaranteed. The negative side ofMagento extensibility are 3rd party extensions conflicts possible. That happens because some extensions may use commonresources concurrently. Nowadays it is the stumbling block and the task to be solved by Magento team and community infuture. Fortunately, we have a services to resolve such issues for our modules. Please read Support Services page for moredetails.Follow the steps below:1. Back up your files and database (preferably).2. Extract the extension archive to the Magento document root directory.Upload the extension to the document root and run the next command:cd /var/www/public_html/tar -xzf Innoexts_Zone-1.0.0.0.tgzrm Innoexts_Zone-1.0.0.0.tgzReplace version number (1.0.0.0) and document root path (/var/www/public_html/) according to your parameters.3. Go to the administration panel, under the System -> Cache Management refresh (if enabled) and flush the cache.Dont forget to select all cache types.Congratulations, installation has been completed.Please dont hesitate to contact us if you met troubles during the installation process.3. Configuration3. ConfigurationIn admin panel navigate to: System -> Configuration -> Zones -> Zones
  3. 3. The next sections are available in the configuration: Options, Catalog, Currency, Store, Payment, Shipping.3.1. Options3.1. Options3.1.1. EnabledHere you can enable / disable module functions globally. This option has a higher priority in the module.3.1.2. Minimum Order AmountThe minimum order amount for all zones.Note: Minimum order amount should be enabled in the system in order to get this function into effect: System ->Configuration -> Sales -> Sales -> Minimum Order Amount3.2. Catalog3.2. Catalog
  4. 4. This section is dedicated for catalog specific options.3.2.1. Category FilterThe product category filter can be enabled / disabled here.3.2.2. Product FilterTurn product filter on / off.3.2.3. Zone PriceThis option is responsible for zone specific prices activation: compound prices, compound special prices, tier prices, catalogprice rules compound discount amounts.3.3. Currency3.3. Currency3.3.1. Currency FilterEnable / disable currencies filter here.
  5. 5. 3.3.2. Default CurrencyAllow default currency here.3.4. Store3.4. Store3.4.1. Store FilterEnable / disable stores filter here.3.4.2. Default StoreAllow default store here.3.4.3. Default Redirect URLThe default redirect URL in case if a store is forbidden for a visitor.3.5. Payment3.5. Payment
  6. 6. 3.5.1. Payment Method FilterEnable / disable payment methods filter.3.5.2. Default Payment MethodAllow default payment method.3.6. Shipping3.6. Shipping3.6.1. Shipping Method FilterEnable / disable shipping methods filter.3.6.2. Default Shipping MethodAllow default shipping method.4. Manage Zones4. Manage ZonesIn administrator panel: Zones -> Manage ZonesHere you can create new customer zones by pressing the Add New Zone button or edit existing ones by clicking the Editlink. The Default zone is being created during the installation. This zone is coming applied in case if there are no otherzones matching a visitor and it cant be removed from the system.
  7. 7. 4.1. General4.1. General
  8. 8. The only tab that is available for the create new zone process is General. Here you fill in zone general details4.1.1. CodeZone code is the unique human readable alternative to the identifier attribute.4.1.2. NameZone display name.4.1.3. DescriptionZone description. This attribute is for the internal use for the administrator. Basically it was reserved for the future.4.1.4. PriorityZone priority in case if there are more than 1 zone matching a customer location (zones are intersecting). Zone with thelowest priority value comes assigned to the customer.4.1.5. Default CurrencyThe currency that is coming selected automatically for a customer assigned to the zone. Default Currency must beselected in Currencies.4.1.6. Default StoreThe store which a customer is being redirected to initially. The value must be selected in Stores.4.1.7. Default Payment MethodThe payment method that is selected by default for the checkout process. The value must be selected in PaymentMethods.4.1.8. Default Shipping MethodThe shipping method that is selected by default for the checkout and estimate shipping functions. The value must beselected in Shipping Methods.4.1.9. Minimum Order Amount4.1.9. Minimum Order AmountThe minimum order amount for the zone. Tick Use Config Minimum Order Amount checkbox if the value should besimilar to that is set in the configuration globally or enter the custom one.4.1.10. Default Redirect URLThe default redirection URL in case if a store isnt allowed for a customer. Check Use Config Default Redirect URL toinherit the value that is set in the configuration globally.4.2. Subzones4.2. Subzones
  9. 9. Each zone can include a number of subzones in it for the flexibility. Each subzone can be defined as country, region, exactzip code or zip codes range.Note, region select is available for the specific countries only with regions data installed initially.4.3. Currencies4.3. CurrenciesAllowed currencies list for the zone. The store base currency is available independently of this attribute. The currency mustbe enabled in the configuration initially: System -> General -> Currency Setup -> Currency Options -> AllowedCurrencies.4.4. Stores4.4. Stores
  10. 10. Allowed stores list for the zone.4.5. Payment Methods4.5. Payment MethodsAllowed payment methods list for the zone. The payment method must be previously enabled in the Payment Methodsconfiguration settings section: System -> Configuration -> Sales -> Payment Methods.4.6. Shipping Methods4.6. Shipping Methods
  11. 11. Allowed shipping methods list for the zone. The shipping carrier must be previously enabled in the Shipping Methodsconfiguration settings section: System -> Configuration -> Sales -> Shipping Methods.4.7. Product Categories4.7. Product CategoriesAdministrator is able to overwrite available product categories list depending on zone here.
  12. 12. Note, product category availability doesnt affect products availability itself.4.8. Products4.8. ProductsThe list of products enabled for the zone. The zone can be enabled for the specific product in products manager.5. Manage Products5. Manage ProductsIn administrator panel: Catalog -> Manage ProductsZones Manager extends default products manager with its own features: available zones, compound price, compoundspecial price, tier price (per zone). Click edit product.5.1. Compound Price5.1. Compound Price
  13. 13. Compound Price attribute is placed under Price. It allows to overwrite the product price for each zone. So, once acustomer comes to the store and assigned to a zone the price is getting replaced with the appropriate compound price value.It doesnt affect further final price calculations.5.2. Compound Special Price5.2. Compound Special PriceCompound Special Price attribute is similar to Compound Price with the difference that it is tied to the product specialprice instead of the product price. In other words, the corresponding compound special price value replaces the special pricedepending on visitors place of residence.
  14. 14. 5.3. Tier Price5.3. Tier PriceUnlike the default Magento tier price feature it allows to set tier price depending on zone. It is possible to select any singlezone or apply the price for all zones by choosing All Zones.5.4. Zones5.4. ZonesThe function allows to enable / disable product for the specific zones.6. Catalog Price Rules6. Catalog Price RulesIn administrator panel: Promotions -> Catalog Price RulesZones Manager adds more flexibility for the catalog price rules function. It allows to enable / disable rule for the specificzones and to set discount amount for each zone independently. Click edit rule.
  15. 15. 6.1. Zones6.1. ZonesZones attribute is placed under Customer Groups on the Rule Information tab. It allows to enable / disable the rule forthe specific zones.6.2. Compound Discount Amount6.2. Compound Discount Amount
  16. 16. Compound Discount Amount attribute is placed under the Discount Amount on the Actions tab. It allows to overwritethe discount amount for each zone.7. Customer Locator7. Customer LocatorThis supplementary tool allows to detect visitors location as soon as he / she comes to the website. The location can beeither default shipping address or geolocated coordinates or geolocated IP address or the default location or manualyentered by the visitor depending on needs.7.1. Configuration7.1. ConfigurationIn administrator panel: System -> Configuration -> Customers -> Customer LocatorYou can see Options and Default Location sections there.7.1.1. Options7.1.1.1. Allow to ModifyIf the option is enabled then customer will be able to enter / correct his / her location manually on the frontend side.7.1.1.2. Use Default Shipping AddressIf the option is enabled then customer default shipping address will be used as the current location. This option has a highestpriority in the address determination process.7.1.1.3. Use Coordinates GeolocationIf the option is enabled then customer comes geolocated by coordinates through the Google Geocoder service. The client
  17. 17. browser provides coordinates if it is allowed by the customer. Coordinates geolocation takes effect if default shippingaddress isnt set or disabled.7.1.1.4. Use IP GeolocationIf the option is enabled then customer comes geolocated by IP through the MaxMind GeoCity database. IP geolocation takeseffect if default shipping address isnt set or disabled and coordinates geolocation is disbaled or failed.7.1.1.5. Adjust Address on CheckoutThis option allows customer location to be updated if the actual checkout address is different.7.1.1.6. Allowed AttributesAddress attributes list which customer is able to change manually.7.1.1.7. Required AttributesRequired address attributes to be entered by a customer.7.1.2. Default AddressThe default visitors location can be defined here. Country, Region / State, Zip / Postal Code, City can be entered. The systemsets visitors location to default if none of other methods are allowed to determine the customer location.7.2. Manual Selection7.2. Manual SelectionThis function allows customer to change his / her location manually.
  18. 18. 7.3. IP Geolocation7.3. IP GeolocationIn administrator panel: System -> Configuration -> Customers -> IP GeolocationIP Geolocator options are placed here: Use PHP Extension, Database File. This function is based on MaxMind GeoCitydatabase. Use PHP Extension option directs system to use built-in geoip PHP extension in the first turn. If no geoip PHPextensions is installed correctly with GeoCity database or Use PHP Extension option is set to No then function relies on theown database. The correct GeoCity database path must be entered in Database File option if no geoip PHP extension isinstalled properly with GeoCity database.8. Data Import8. Data ImportZones Manager includes built-in scripts to import compound prices, compound special prices and tier prices in a fast way.8.1. Compound Price8.1. Compound PriceRun the php command with your arguments:php shell/Innoexts/Zone/Catalog/Product/Price/Importer.php --ftp --ftp-host ftp.yourhost.com --ftp-user username --ftp-password password --ftp-filename remotefilename.csv --file-path /var/import/ --file-filename localfilename.csv
  19. 19. Omit ftp arguments to run import from local data feed:php shell/Innoexts/Zone/Catalog/Product/Price/Importer.php --file-path /var/import/ --file-filename localfilename.csvRun the next command to get arguments descriptionphp shell/Innoexts/Zone/Catalog/Product/Price/Importer.php --helpThe data feed should have the next format:sku,website,zone,price"HTC Touch Diamond","","default","755.00""HTC Touch Diamond","base","europe","760.00"8.2. Compound Special Price8.2. Compound Special PriceRun the php command with your arguments:php shell/Innoexts/Zone/Catalog/Product/Specialprice/Importer.php --ftp --ftp-host ftp.yourhost.com --ftp-user username --ftp-password password --ftp-filename remotefilename.csv --file-path /var/import/ --file-filename localfilename.csvOmit ftp arguments to run import from local data feed:php shell/Innoexts/Zone/Catalog/Product/Specialprice/Importer.php --file-path /var/import/ --file-filename localfilename.csvRun the next command to get arguments descriptionphp shell/Innoexts/Zone/Catalog/Product/Specialprice/Importer.php --helpThe data feed should have the next format:sku,website,zone,price"HTC Touch Diamond","","default","745.00""HTC Touch Diamond","base","europe","740.00"8.3. Tier Price8.3. Tier PriceRun the php command with your arguments:php shell/Innoexts/Zone/Catalog/Product/Tierprice/Importer.php --ftp --ftp-host ftp.yourhost.com --ftp-user username --ftp-password password --ftp-filename remotefilename.csv --file-path /var/import/ --file-filename localfilename.csv
  20. 20. Omit ftp arguments to run import from local data feed:php shell/Innoexts/Zone/Catalog/Product/Tierprice/Importer.php --file-path /var/import/ --file-filename localfilename.csvRun the next command to get arguments descriptionphp shell/Innoexts/Zone/Catalog/Product/Tierprice/Importer.php --helpThe data feed should have the next format:sku,all_customer_groups,customer_group,website,zone,qty,price"HTC Touch Diamond","1","0","","","2","740""HTC Touch Diamond","0","1","base","europe","3","730"9. Uninstallation9. Uninstallation1. Open file app/etc/modules/Innoexts_Zone.xml2. Replace<active>true</active>with<active>false</active>3. If you dont have other InnoExts extensions unstalled that reuse the same sub-modules then repeat the steps above forapp/etc/modules/Innoexts_CustomerLocator.xml, app/etc/modules/Innoexts_GeoCoder.xml,app/etc/modules/Innoexts_GeoIp.xml and Innoexts_Core.xml.4. Run MySQL queries from the next file: sql/Innoexts/Zone/uninstall.sql. If some query fails due to the databaseinconsistency for some reason then continue from the next query and so on.Please note, if database tables are prefixed then the next file should be run instead:sql/Innoexts/Zone/prefixed_uninstall.sql. Replace [prefix] with your tables prefix.5. Flush & Refresh the cache6. Regenerate Product Prices index

×