productbasecurrencymanual-1.0.0.1
TRANSCRIPT
-
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
1/11
Title Product Base Currency
Version 1.0.0.0
Author InnoExts (http://innoexts.com)
Follow Us
Product Base CurrencyProduct Base Currency
1. Overview
2. Installation
3. Configuration
4. Manage Products
5. Catalog Price Rules
6. Data Export
7. Data Import
8. Uninstallation
1. Overview1. Overview
Product Base Currencyextension enables to set a base currency on a product level instead of setting it on a website level in
configuration. Prices, special prices, tier prices, customer group prices and catalog price rule discount amounts can be set in
a desired base currency for each product.
FeaturesFeatures
Automated prices (prices, special prices, customer group prices, tier prices) and base currency scope
Set a base currency for prices, special prices, customer group prices and tier prices
Set a base currency for catalog price rule discount amounts
Export base currencies
Export prices
Export special prices
Export customer group prices
Export tier prices
Import base currencies
http://innoexts.com/http://twitter.com/innoextshttp://innoexts.com/promotion/product-base-currency/http://innoexts.com/promotion/product-base-currency/http://innoexts.com/promotion/product-base-currency/http://innoexts.com/feed/http://innoexts.com/feed/http://ua.linkedin.com/pub/innovative-extensions/31/386/961http://ua.linkedin.com/pub/innovative-extensions/31/386/961http://www.facebook.com/profile.php?id=100002278119625http://www.facebook.com/profile.php?id=100002278119625http://twitter.com/innoextshttp://twitter.com/innoextshttp://innoexts.com/ -
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
2/11
Import prices
Import special prices
Import customer group prices
Import tier prices
Automatic re-indexing after currency rates save
2. Installation2. Installation
First of all we would like to suggest you to keep a development copy of a live installation for a new or updated extensions
testing. Follow the steps listed below.
1. Make sure that your system corresponds to Magento requirements.
2. Make sure that PHP compilation function is disabled. In admin panel navigate to System > Tools > Compilation. If
Compiler Statusfield equals to Enabledthen press Disablebutton or:
Open file includes/config.php(the file path is related to the document root).
Replace
define('COMPILER_INCLUDE_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'src');
with
#define('COMPILER_INCLUDE_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR.'src');
3. Make sure that files and database additional caching tools are disabled (e.g. APC cache).
4. Back up Magento files and database to be able to revert changes in a couple of minutes in case of possible problems.
5. Enable Magento error logs: System > Configuration > Advanced > Developer > Log Settings, Set EnabledtoYes.
You can find errors information in files: var/log/system.logand var/log/exception.log(the file paths are related to
the document root).
6. Extract extension and upload files into the document root. Double check that all files were uploaded successfully into the
correct directory.
7. Navigate to System > Cache Management. Press Flush Cache Storagebutton.
8. If installer fails during the cache flushing then let us knowerror messages from the logs.
9. Check if extension is recognized by Magento: System > Configuration > Advanced > Advanced. The module should
be listed there.
10. Check if the module conflictswith 3rd party modules previously installed on your system.
Note, conflicts resolving service isn't included into the support package. Please, check the module for conflicts before
open code purchasing with an encoded trial requested(php files are encoded only).
11. Navigate to System > Manage Currency Ratesor System > Manage Currency > Rates(if your Magento version is
equal or above the 1.7.0.0). Make sure that rates are populated. If not then press Importbutton or populate rates manually,
save them by pressing Save Currency Ratesbutton.
12. Navigate to System > Index Management. Click Select Allto select all indexes types and press Submitbutton. If
indexing fails then you have 3rd party module conflicts most probably (see 10th step), let us knowthe full error messages
from the logs for further information.
http://magento.com/resources/system-requirementshttp://innoexts.com/contact-us/http://www.aschroder.com/2013/04/understanding-and-detecting-magento-extension-clashes-or-conflicts/http://innoexts.com/support-services/#customer-services-bugs-fixinghttp://innoexts.com/request-a-trial/http://innoexts.com/contact-us/http://innoexts.com/contact-us/http://innoexts.com/request-a-trial/http://innoexts.com/support-services/#customer-services-bugs-fixinghttp://www.aschroder.com/2013/04/understanding-and-detecting-magento-extension-clashes-or-conflicts/http://innoexts.com/contact-us/http://magento.com/resources/system-requirements -
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
3/11
You made it!
Please don't hesitate to contact usif you met troubles during the installation process.
3. Configuration3. Configuration
The module ties product price scope that can be set in Magento configuration to the next attributes: Price, Special Price,Special Price From Date, Special Price To Date, Group Price, Tier Priceand Base Currency.
In admin panel navigate to: System > Configuration > Catalog > Catalog > Price . Once Catalog Price Scopeis
changed and saved the tied attributes scope comes updated according to the value chosen.
4. Manage Products4. Manage Products
In administrator panel: Catalog > Manage Products. Click edit product or create a new one.
Product Base Currency appends the Base Currencyattribute at the end of Pricestab for Simple, Configurable, Virtual,
Bundleand Downloadableproduct types.
http://innoexts.com/contact-us/http://innoexts.com/contact-us/ -
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
4/11
Once Base Currencyis changed the system sets input currency for the next attributes: Price, Special Price, Group Price
and Tier Price.
5. Catalog Price Rules5. Catalog Price Rules
In administrator panel: Promotions -> Catalog Price Rules. Click edit rule or create a new one. Select Actionstab.
The system respects base currencies for products matching rule criterias in case of fixed Discount Amountvalues.
6. Data Export6. Data Export
Data exporting can be handled with the number of CLI (command line interface) scripts built-in.
6.1. Base Currency6.1. Base Currency
Run the script with your arguments:
-
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
5/11
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/BaseCurrency/Export.php\ --file-path/var/export/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-base-currency.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Run the next command to get arguments description
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/BaseCurrency/Export.php--help
The output data feed var/export/Innoexts/ProductBaseCurrency/product-base-currency.csvshould have the
next format:
sku,store,currency"HTC Touch Diamond",,EUR"HTC Touch Diamond",default,USD
6.2. Price6.2. Price
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Price/Export.php\ --file-path/var/export/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-price.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Run the next command to get arguments description
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Price/Export.php--help
The output data feed var/export/Innoexts/ProductBaseCurrency/product-price.csvshould have the next
format:
sku,store,price"HTC Touch Diamond",,750"HTC Touch Diamond",default,755
6.3. Special Price6.3. Special Price
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Special/Export.php\ --file-path/var/export/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-special-price.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Run the next command to get arguments description
-
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
6/11
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Special/Export.php--help
The output data feed var/export/Innoexts/ProductBaseCurrency/product-special-price.csvshould have the
next format:
sku,store,price"HTC Touch Diamond",,740"HTC Touch Diamond",default,745
6.4. Customer Group Price6.4. Customer Group Price
Note, Group Pricefunction is available for Magento CE 1.7.0.0+ only.
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Group/Export.php\ --file-path/var/export/Innoexts/ProductBaseCurrency/\
--file-filenameproduct-group-price.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Run the next command to get arguments description
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Group/Export.php--help
The output data feed var/export/Innoexts/ProductBaseCurrency/product-group-price.csvshould have the
next format:
sku,all_groups,customer_group,website,price"HTC Touch Diamond",,"General",,730
6.5. Tier Price6.5. Tier Price
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Tier/Export.php\ --file-path/var/export/Innoexts/ProductBaseCurrency/\
--file-filenameproduct-tier-price.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Run the next command to get arguments description
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Tier/Export.php--help
The output data feed var/export/Innoexts/ProductBaseCurrency/product-tier-price.csvshould have the
next format:
sku,all_groups,customer_group,website,qty,price"HTC Touch Diamond",,"General",,2,725"HTC Touch Diamond",,"General",,3,720
-
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
7/11
7. Data Import7. Data Import
Data importing can be handled with the number of CLI (command line interface) scripts built-in.
7.1. Base Currency7.1. Base Currency
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/BaseCurrency/Import.php\ --ftp\ --ftp-hostftp.hostname.com\ --ftp-userusername\ --ftp-passwordpassword\ --ftp-filenameremote-product-base-currency.csv\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-base-currency.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Omit ftp arguments to run import from local data feed:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/BaseCurrency/Import.php\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-base-currency.csv
Run the next command to get arguments description
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/BaseCurrency/Import.php--help
The input data feed var/import/Innoexts/ProductBaseCurrency/product-base-currency.csvshould have the
next format:
sku,store,currency"HTC Touch Diamond",,EUR"HTC Touch Diamond",default,USD
Data Feed Format
sku Product SKU
store Store ID or code
currency Currency code
7.2. Price7.2. Price
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Price/Import.php\ --ftp\ --ftp-hostftp.hostname.com\ --ftp-userusername\ --ftp-passwordpassword\ --ftp-filenameremote-product-price.csv\
-
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
8/11
--file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-price.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Omit ftp arguments to run import from local data feed:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Price/Import.php\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-price.csv
Run the next command to get arguments description
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Price/Import.php--help
The input data feed var/import/Innoexts/ProductBaseCurrency/product-price.csvshould have the next format:
sku,store,price"HTC Touch Diamond",,750"HTC Touch Diamond",default,755
Data Feed Format
sku Product SKU
store Store ID or code
price Price value
7.3. Special Price7.3. Special Price
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Special/Import.php\ --ftp\ --ftp-hostftp.hostname.com\ --ftp-userusername\ --ftp-passwordpassword\ --ftp-filenameremote-product-special-price.csv\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-special-price.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Omit ftp arguments to run import from local data feed:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Special/Import.php\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-special-price.csv
Run the next command to get arguments description
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Special/Import.php--help
-
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
9/11
The input data feed var/import/Innoexts/ProductBaseCurrency/product-special-price.csvshould have the
next format:
sku,store,price"HTC Touch Diamond",,740"HTC Touch Diamond",default,745
Data Feed Format
sku Product SKU
store Store ID or code
price Price value
7.4. Customer Group Price7.4. Customer Group Price
Note, Group Pricefunction is available for Magento CE 1.7.0.0+ only.
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Group/Import.php\ --ftp\ --ftp-hostftp.hostname.com\ --ftp-userusername\ --ftp-passwordpassword\ --ftp-filenameremote-product-group-price.csv\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-group-price.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to run
via cron service for example), file-pathdirectory is always related to the document root.
Omit ftp arguments to run import from local data feed:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Group/Import.php\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-group-price.csv
Run the next command to get arguments description
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Group/Import.php--help
The input data feed var/import/Innoexts/ProductBaseCurrency/product-group-price.csvshould have the
next format:
sku,all_groups,customer_group,website,price"HTC Touch Diamond",,"General",,730
Data Feed Format
sku Product SKU
all_groups Either price should be applied for all groups or not (1 or 0). For Group Price it equals to 0 (or empty)
customer_group Customer group ID or name
-
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
10/11
website website ID or code
price Price value
7.5. Tier Price7.5. Tier Price
Run the script with your arguments:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Tier/Import.php\ --ftp\ --ftp-hostftp.hostname.com\ --ftp-userusername\ --ftp-passwordpassword\ --ftp-filenameremote-product-tier-price.csv\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-tier-price.csv
Note, The script path is related to the document root in the sample but can be replaced with the absolute path (to runvia cron service for example), file-pathdirectory is always related to the document root.
Omit ftp arguments to run import from local data feed:
phpshell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Tier/Import.php\ --file-path/var/import/Innoexts/ProductBaseCurrency/\ --file-filenameproduct-tier-price.csv
Run the next command to get arguments description
php
shell/Innoexts/ProductBaseCurrency/Catalog/Product/Price/Tier/Import.php
--help
The input data feed var/import/Innoexts/ProductBaseCurrency/product-tier-price.csvshould have the next
format:
sku,all_groups,customer_group,website,qty,price"HTC Touch Diamond",,"General",,2,725"HTC Touch Diamond",,"General",,3,720
Data Feed Format
sku Product SKU
all_groups Either price should be applied for all groups or not (1 or 0)
customer_group Customer group ID or name
website Website ID or code
qty Quantity value
price Price value
8. Uninstallation8. Uninstallation
1. Make sure that PHP compilation function is disabled. This procedure was described in the installation topic(see 2nd step).
2. Make sure that files and database additional caching tools are disabled (e.g. APC cache).
-
8/12/2019 ProductBaseCurrencyManual-1.0.0.1
11/11
3. Back up Magento files and database to be able to revert changes in a couple of minutes in case of possible problems.
4. Enable Magento error logs: System > Configuration > Advanced > Developer > Log Settings, Set EnabledtoYes.
You can find errors information in files: var/log/system.logand var/log/exception.log(the file paths are related to
the document root).
5. Open file app/etc/modules/Innoexts_ProductBaseCurrency.xml(the file path is related to the document root)
6. Replace
true
with
false
7. If you don't have other extensions installed that depend on the same sub-module then repeat the steps above for
app/etc/modules/Innoexts_Core.xml.
Note, you can find the list of modules that the current module depends on under the next XML node: config >modules > depends
8. Run MySQL queries from the file: sql/Innoexts/ProductBaseCurrency/uninstall.sql(the file path is related to the
document root). If some query fails due to the database inconsistency for some reason then continue from the next query
after the failed one and so on.
Note, if database tables are prefixed then the file should be run instead:
sql/Innoexts/ProductBaseCurrency/prefixed_uninstall.sql. Replace [prefix]with your tables prefix.
9. Navigate to System > Cache Management. Press Flush Cache Storagebutton.
10. If the cache flushing fails then let us knowerror messages from the logs.
11. Check if extension isn't listed in Magento anymore: System > Configuration > Advanced > Advanced. The module
should be listed there.
12. Navigate to System > Index Management. Click Select Allto select all indexes types and press Submitbutton.
http://innoexts.com/contact-us/http://innoexts.com/contact-us/