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.
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
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:
- Open the desired page for editing.
- At the desired location, type the dictionary entry's code in the format
{%Code}
. - 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
.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.
Deleting dictionary entries
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.
Variable name | Printed content | Allowed codes |
---|---|---|
Online store details | ||
SHOP_URL | Online store URL address | MultiSafePayDescription, CampaignCodeActivated, ErrorLoginAttemptAsAdmin |
SHOP_LINK | The URL address of the version selected by the customer | ForgotPasswordEmailMessage |
SHOP_NAME | The online store's name | CampaignCodeActivated |
LOGIN_LINK | Login page link | ForgotPasswordEmailMessage |
Payment methods | ||
PAYMENT_PROVIDER_LIMIT | The payment service's minimum and maximum order total | CheckoutNotificationPaymentPriceMaximum, CheckoutNotificationPaymentPriceMinimum |
Order and shopping cart details | ||
CART_CONTENTS | Shopping cart content | CampaignCodeActivated |
CART_TOTAL | The order total of the shopping cart | CampaignCodeActivated |
CART_LINK | The shopping cart link | CampaignCodeActivated |
CART_QUANTITY | The quantity of the shopping cart product | CartProductDeliveryExtended, CartProductDeliveryTime, CartProductOutOfStock |
MESSAGE | The message sent when a shopping cart has been shared | CartEmailMessage |
CURRENCY | Order currency | CheckoutCurrencyNotification |
TOTAL | Order total | CheckoutCurrencyNotification |
Customer information | ||
CUSTOMER_FIRSTNAME | Customer's first name | ForgotPasswordEmailMessage |
RESET_LINK | Password reset link | ForgotPasswordEmailMessage |
Discount coupons and campaigns | ||
CAMPAIGN_NAME | Campaign name | CartDiscountLabelCampaign, CartDiscountLabelCampaignWithCode |
CAMPAIGN_LINK | Campaign page link | CampaignCodeActivated |
CAMPAIGN_CODE | Campaign code | CartDiscountLabelCampaignWithCode, CampaignCodeActivated |
ORDERLIMIT | Minimum order total for the discount coupon | MinimumCouponLimitNotification, MinimumOrderLimitNotification |
COUPON_CODE | The discount code of the discount coupon | CartDiscountLabelCoupon, CouponCodeActivated |
Product details | ||
PRODUCT_NAME | Product name | CartProductDeliveryExtended, CartProductDeliveryTime, CartProductDiscontinued, CartProductOutOfStock, ShoppingCartAddSuccess, ShoppingCarrowemoved |
PRODUCT_STOCK_BALANCE | Product stock balance | ShoppingCartAddFailedQuantity |
STOCK_QUANTITY | Product stock balance | CartProductDeliveryExtended, CartProductDeliveryTime, CartProductOutOfStock |
PRODUCT_DELIVERY_TIME | Product delivery time | AvailabilityEstimatedDelivery, CartProductDeliveryTime |
Search | ||
SEARCH_TERM | The search term entered by the customer | NostoSearchRecommendations |