ProductBaseCurrencyManual-1.0.0.1

download ProductBaseCurrencyManual-1.0.0.1

of 11

Transcript of ProductBaseCurrencyManual-1.0.0.1

  • 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/