The dictionary is used for saving text snippets used on many different occasions. All MyCashflow internal texts, such as email notification contents, are saved in the dictionary. Here you'll learn how to use the dictionary in your online store.

To access the dictionary, in your online store's admin panel, go to Contents > Dictionary.

In a single dictionary entry, you can save multiple text snippets, in which you can also use HTML markup.

All texts saved in the dictionary can also be translated into all languages for which there is a separate language version in the store.

The dictionary is used for translating the online store contents. In multilingual stores, all texts that appear in the store theme must be printed from the dictionary, so that their translations will be visible too.

Adding new entries to the dictionary

  1. To add a new dictionary entry, on the page Contents > Dictionary, click Add word to dictionary.
  2. Enter a unique code for the dictionary entry based on which the entry will be retrieved from the dictionary, and click Add code.
  3. Type the entry's contents. In the newly added row, position the pointer in the Click to edit field.
  4. When the content is ready, click Save.

Printing dictionary entries

Entries can be retrieved from the dictionary based on their codes. Dictionary entries can be used in multiple text fields in the admin panel.

To print a dictionary entry on the desired page:

  1. Open the desired page for editing.
  2. At the desired location, type the dictionary entry's code in the format {%Code}.
  3. Save the page, and make sure that the text is displayed correctly in the customer area.

If no entry is found with the indicated code, the code will be printed as such.

The dictionary entry search is case-sensitive.

Editing dictionary entries

To edit a dictionary entry, click its contents. The text opens for editing.

When you're done making changes, click Save.

Using HTML markup in the dictionary

In the dictionary, you can use HTML markup that enables you to format text as well as to add images and videos to it.

To bold and italicize text:

This is <strong>text in bold</strong> and this is <i>text in italics</i>.

To add an image to the text, first save it in the file directory, and then refer to it by using the <img> tag:

<img src="/files/images/image.jpg"/>

You can also add Youtube videos to dictionary entries by using the embed code. See also the instructions on where to find the embed code and how to use it.

<iframe width="560" height="315" src="https://www.youtube.com/embed/1nZSYNnF5AQ" frameborder="0" allowfullscreen></iframe>

Translating dictionary entries to other languages

Most of MyCashflow's user interface texts have already been translated to numerous languages. However, you can edit the already existing translations and add translations to your own entries as well.

  1. To start translating, add a new language column to the dictionary by clicking the icon in the upper right corner of the list.
  2. Select the desired language for the column. You can select any of the languages for which your online store has a language version.

    The language column has been added to the dictionary.

    If any of the dictionary entries have already been translated into the language you've just added, you'll see the translations in the new language column.

  3. Locate the entry to translate on the list, and click the content field in the new language column. Type the translation in the content field.
  4. Finally, click Save.

Deleting dictionary entries

To delete a dictionary entry, click the icon visible next to it.

The entry is deleted instantly. After deletion, the entry cannot be recovered.

Dictionary variables

In the MyCashflow dictionary entries, you can use variables that print changeable contents of your online store. By using variables, you can print e.g. the details of your online store or products.

Variables must be spelled in the dictionary entries by using only capital letters and separated by the underscore. E.g. PRODUCT_NAME

No spelling mistakes can occur in dictionary variables. Otherwise they will be printed in the customer area as such. Below you can see an example how variables can be used in a dictionary entry:

CART_QUANTITY pieces of the product PRODUCT_NAME have been added to the shopping cart even though only STOCK_QUANTITY pieces are available.

Not all variables can be used in any entry; the use of some variables is limited to certain codes. See the table below for the list of available variables and their usage environment.
Taulukko 1.
Variable namePrinted contentAllowed codes
Online store details
SHOP_URLOnline store URL addressMultiSafePayDescription, CampaignCodeActivated, ErrorLoginAttemptAsAdmin
SHOP_LINKThe URL address of the version selected by the customerForgotPasswordEmailMessage
SHOP_NAMEThe online store's nameCampaignCodeActivated
LOGIN_LINKLogin page linkForgotPasswordEmailMessage
Payment methods
PAYMENT_PROVIDER_LIMITThe payment service's minimum and maximum order totalCheckoutNotificationPaymentPriceMaximum, CheckoutNotificationPaymentPriceMinimum
Order and shopping cart details
CART_CONTENTSShopping cart contentCampaignCodeActivated
CART_TOTALThe order total of the shopping cartCampaignCodeActivated
CART_LINKThe shopping cart linkCampaignCodeActivated
CART_QUANTITYThe quantity of the shopping cart productCartProductDeliveryExtended, CartProductDeliveryTime, CartProductOutOfStock
MESSAGEThe message sent when a shopping cart has been sharedCartEmailMessage
CURRENCYOrder currencyCheckoutCurrencyNotification
TOTALOrder totalCheckoutCurrencyNotification
Customer information
CUSTOMER_FIRSTNAMECustomer's first nameForgotPasswordEmailMessage
RESET_LINKPassword reset linkForgotPasswordEmailMessage
Discount coupons and campaigns
CAMPAIGN_NAMECampaign nameCartDiscountLabelCampaign, CartDiscountLabelCampaignWithCode
CAMPAIGN_LINKCampaign page linkCampaignCodeActivated
CAMPAIGN_CODECampaign codeCartDiscountLabelCampaignWithCode, CampaignCodeActivated
ORDERLIMITMinimum order total for the discount couponMinimumCouponLimitNotification, MinimumOrderLimitNotification
COUPON_CODEThe discount code of the discount couponCartDiscountLabelCoupon, CouponCodeActivated
Product details
PRODUCT_NAMEProduct nameCartProductDeliveryExtended, CartProductDeliveryTime, CartProductDiscontinued, CartProductOutOfStock, ShoppingCartAddSuccess, ShoppingCarrowemoved
PRODUCT_STOCK_BALANCEProduct stock balanceShoppingCartAddFailedQuantity
STOCK_QUANTITYProduct stock balanceCartProductDeliveryExtended, CartProductDeliveryTime, CartProductOutOfStock
PRODUCT_DELIVERY_TIMEProduct delivery timeAvailabilityEstimatedDelivery, CartProductDeliveryTime
Search
SEARCH_TERMThe search term entered by the customerNostoSearchRecommendations