1.5. Dynamic Locale Directive Changes

If a Locale key is set to correspond to an Interchange catalog.cfg directive, that value will be set when the locale is set.

PageDir

To use a different page directory for different locales, set the PageDir key. For example, to have two separate language page sets, French and English, set:

            # Establish the default at startup
            PageDir   english
            Locale fr_FR  PageDir  francais
            Locale en_US  PageDir  english

ImageDir

To use a different image directory for different locales, set the ImageDir key. To have two separate language button sets, French and English, set:

            # Establish the default at startup
            ImageDir   /images/english/
            Locale fr_FR  ImageDir   /images/francais/
            Locale en_US  ImageDir   /images/english/

ImageDirSecure

See ImageDir.

PriceField

To use a different field in the products database for pricing based on locale, set the PriceField locale setting. For example:

            # Establish the default at startup
            PriceField    price
            Locale fr_FR  PriceField  prix

The default will always be price, but if the locale fr_FR is set, the PriceField directive will change to prix to give prices in francs instead of dollars.
If PriceBreaks is enabled, the prix field from the pricing database will be used to develop the quantity pricing.

---

Note: If no Locale settings are present, the display will always be price, regardless of what was set in PriceField. Otherwise, it will match PriceField.

---

PriceDivide

Normally used to enable penny pricing with a setting of 100, PriceField can be used to do an automatic conversion calculation factor based on locale.

            # Default at startup is 1 if not set
            # Franc is strong these days!
            Locale fr_FR  PriceDivide  .20

The price will now be divided by .20, making the franc price five times higher than the dollar.

PriceCommas

This controls whether the mon_thousands_sep will be used for standard currency formatting. This setting will be ignored if you are using price_picture. Set the value to 1 or 0, to enable or disable it. Do not use yes or no.

            # Default at startup is Yes if not set
            PriceCommas  Yes
            Locale fr_FR  PriceCommas  0
            Locale en_US  PriceCommas  1

UseModifier

Changes the fields from the set shopping cart options.

            # Default at startup is 1 if not set
            # Franc is strong these days!
            UseModifier format
            Locale fr_FR  UseModifier formats

If a previous setting was made for an item based on another locale, it will be maintained.

PriceAdjustment

Changes the fields set by UseModifier that will be used to adjust pricing for an automatic conversion factor based on locale. For example:

            # Default at startup
            PriceAdjustment  format
            Locale fr_FR  PriceAdjustment  formats

TaxShipping,SalesTax

Same as the standard directives.

DescriptionField

This changes the field accessed by default with the [item-description] and [description code] tags. For example

            # Establish the default at startup
            DescriptionField    description
            Locale fr_FR  DescriptionField desc_fr

The [locale] tag

Standard error messages can be set based on Locale settings. Make sure not to use any of the predefined keys. It is safest to begin a key with msg_ . The default message is set between the [locale key] and [/locale] tags. See the example above.