ekmTags
The EKM system has a tag system that allows you to output data and editable content onto your website without any development experienced. These tags can be used to output data from your shop such as products and categories but also editable areas and logic statements which are useful throughout your shop's design.
The most complicated but most important tag on the EKM system is the ekm:showdata tag which allows you to output products, categories, special offers and related products. Because of its complexity we have created a unique tag builder. You can try this out on the ekm:showdata page.
-
- Term Description
- Attribute Tag
Attribute tags are EKM tags that are part of and go within other EKM tags. These tags are self-closing and typically look like
[this]
- Nested Tags
Nested Tags are EKM tags that can be placed within other EKM tags. For example you can nest a showdata tag within another showdata tag.
- Hexidecimal Colour Code
HEX colour codes are 6 digit long HTML codes that define a colour. They are preceded by a hash, for example
#000000
for Black. Sometimes these codes can be 3 digits long in their short-hand version. - Integer
A number that is not followed by a decimal place. Example
1
,123
but NOT3.2
for example. - Boolean
A true or false answer either shown as
true
|false
oryes
|no
or1
|0
. EKM typically uses yes or no.
-
Colour Tags
- Tag Name Description
- [ekm:alinkcol]
Outputs a hexidecimal colour code for the link hover colour set in the design section of your account.
- [ekm:backcol]
Background colour tag, this outputs a hexidecimal colour code. This is also used in the checkout process to style the "Safe Shopping Guarantee" box.
- [ekm:backcol2]
Background colour 2 tag, this outputs a hexidecimal colour code. This is also used in the checkout process to style the "Safe Shopping Guarantee" box.
- [ekm:backcol3]
Background colour 3 tag, this outputs a hexidecimal colour code. This is also used in the checkout process to style the "Safe Shopping Guarantee" box.
- [ekm:background]
Outputs the background image uploaded to the design section of a shop.
- [ekm:colour]
Used to define hexidecimal colours in your design which can be set and edited from the "design" section of your account.
- [ekm:linkcol]
Outputs a hexidecimal colour code for the link default colour. This can be changed within the design section of your account.
- [ekm:textcol]
Outputs a hexidecimal colour code for the default text colour. This can be changed within the design section of your account.
- [ekm:vlinkcol]
Outputs a hexidecimal colour code for the visited link colour. This can be changed within the design section of your account.
-
Navigation Tags
-
Data Output Tags
- Tag Name Description
- [ekm:categoryid]
Outputs the category page ID for a category at a defined depth. Useful for dynamic category menus.
- [ekm:category_menu]
New Outputs a list of categories up to three levels deep which is ideal for displaying menus.
- [ekm:categorypagename]
Outputs the category page title for the category you are currently viewing or for a specific ID.
- [ekm:content]
Outputs the content for a page. This marker is where your main page, category page, product page, checkout pages etc will display.
- [ekm:currency_symbol]
Outputs the symbol for the currently selected currency.
- [ekm:minicart]
Outputs the current contents of a visitors shopping cart.
- [ekm:pageid]
Outputs the page ID for the page you are currently viewing.
- [ekm:pagetitle]
Outputs the title of the page you are currently viewing. If meta titles are enabled these will output instead.
- [ekm:page_type]
Outputs the page type for the page you are currently viewing.
- [ekm:shop_contact_details]
Outputs shop contact details.
- [ekm:show_webpages]
Outputs all webpages for the matched criteria.
- [ekm:showdata]
Outputs products, categories, related products or special offers for a given criteria.
- [ekm:sitename]
Outputs the name of your shop.
- [ekm:siteusername]
Outputs the username of your EKM shop. Useful for image paths.
- [ekm:add_to_wishlist_link]
Outputs a link that will add a product to the wishlist.
-
Editable Content Tags
- Tag Name Description
- [ekm:cart_custom_css]
CSS that will be injected into the cart page
- [ekm:element]
Outputs the element content of an editable area.
- [ekm:elementname]
Outputs the element title of an editable area.
- [ekm:favicon]
Outputs the favicon tag with an image you define within the backend of your EKM shop.
- [ekm:incategorydescription]
Outputs the incategory description for the category you are viewing.
-
Logic Tags
-
SEO Tags
-
Product Page Only Tags
- Tag Name Description
- [ekm:addtocart]
Outputs the add to cart button for the current product page.
- [ekm:add_to_wishlist]
New Outputs the add to wishlist button for the current product page.
- [ekm:emailtofriend]
Outputs a button or link to email the current product to a friend.
- [ekm:outofstockmessage]
Outputs a message when an item is out of stock.
- [ekm:productattributes]
Outputs the current product's list of product attributes If the 'Product Attributes' feature is enabled.
- [ekm:productbrand]
Outputs the current product's 'brand'. If the 'Product Attributes' feature is enabled.
- [ekm:productcategories]
Outputs the category names and links of any category the product is currently category managed into.
- [ekm:productcode]
Outputs the current product's 'product code'. If the 'Product Attributes' feature is enabled.
- [ekm:productcondition]
Outputs the current product's 'condition'. If the 'Product Attributes' feature is enabled.
- [ekm:productdescription]
Outputs the current product's full description
- [ekm:productend]
Outputs the form-end needed for the add to cart button, quantity and product options to work.
- [ekm:productimage]
Outputs the product images for the currently displayed product.
- [ekm:productname]
Outputs the name and edit buttons for the current product.
- [ekm:productoptions]
Outputs the product options and variants for the current product.
- [ekm:productprice]
Outputs the product's price.
- [ekm:productqty]
Outputs a quantity for the product.
- [ekm:productrrp]
Outputs the current product's 'RRP'. If the 'RRP' feature is enabled.
- [ekm:productsaving]
Outputs the current product's savings in percentage or currency values.
- [ekm:productshortdescription]
Outputs the current product's short description
- [ekm:productstart]
Outputs the form opening needed for the add to cart button, quantity and product options to work.
- [ekm:productstock]
Outputs an "In Stock", "Out Of Stock" or numeric value of the current stock level of the displaying product.
- [ekm:productweight]
Outputs the product's weight if set.
-
Feature Tags
- Tag Name Description
- [ekm:announcement_bar]
New Outputs a site wide bar containing a message to the customer as part of the Quick Announcement feature. It can also be used to add site-wide messaging to the Holiday Mode feature
- [ekm:captcha]
Outputs a form captcha on a page to detect whether the submitter is human or an automated script.
- [ekm:card_logos]
Outputs the credit card logos for any cards you set in the "Card Logos" feature.
- [ekm:changepassword]
Outputs a form to change the currently logged-in customer's password.
- [ekm:customerreviews]
Outputs the customer reviews for the current product. If the feature is enabled
- [ekm:customer_user_loyaltypoints]
New Outputs the number of loyalty points the logged in customer has.
- [ekm:backinstock]
Outputs a form for users to enter an email address to be notified when a product is back in stock.
- [ekm:loyaltypoints]
Outputs the number of loyalty points awarded for a product. If the 'Loyalty Points' feature is enabled.
- [ekm:newsletter]
Outputs the ekmResponse signup form when a response account is linked with an EKM account.
- [ekm:mobile_showitems]
Outputs what values are selected in the backend to be output on the mcommerce homepage.
- [ekm:product_urgency_countdown_timer]
New Outputs a digital clock style countdown. When the countdown has completed a message set within the feature may then display in its place.
- [ekm:product_urgency_free_delivery]
New Outputs a message about free delivery along with an amount. Once the shopper has more than the amount added to the cart the existing message will either disappear or change accordingly.
- [ekm:product_urgency_get_it_by_timer]
New Outputs a countdown and an expected date of delivery.
- [ekm:product_urgency_low_stock_bar]
New When the product stock is below a set threshold this tag will output a bar that will be more filled the closer the stock gets to zero.
- [ekm:securearea_login]
Outputs a customer login sections allowing users to login and see previous orders.
-
Backend Tags
- Tag Group Description
- Order Complete Tags
Output order and customer information on your order complete page.
- Outgoing Email Tags
Output order and customer information in emails to your customers.
- Abandon Cart Email Tags
Output details of the abandoned cart in emails to your customer.
- Back In-Stock Email Tags
Output product details for back in-stock emails.
- 26th April 2019
- [ekm:add_to_wishlist] New tag to output a button on product pages to allow the product to be added to the customers wishlist.
- 1st March 2019
- [ekm:dialog] New tag to output a stylable dialog.
- [ekm:dialog] New tag to output the trigger to display a dialog.
- 6th June 2018
- [ekm:element] Added the new carousel element type.
-
[ekm:customerreviews]
Added
newline_replace
attribute to change how new lines are output in reviews. - [ekm:customer_user_loyaltypoints] New tag to output the number of loyalty points when a customer is logged in.
-
[ekm:date]
Added new
format
attribute to change the format of the current date and time.
- 14th December 2017
- [ekm:minicart] You can now use any order total attribute tag within the cart total message attributes. You can also now run javascript when a product is successfully (or unsuccessfully) added to the cart.
-
[ekm:showdata]
You can now use
[active_item]
inoutput_item
to change how items (categories and products) are displayed when currently being viewed. You can also now display a load more button instead of pagination and show an extra image on hover of a product image. - [ekm:background] Outputs the background image uploaded in the theme's colour customisation page.
-
[ekm:if]
You can now use
IS_MOBILE_BROWSER
to check whether the requesting browser is a mobile device or not. -
[ekm:element]
You can now use the
allowed_types
attribute to set what content can be used in an element. The shop owner can select from a dropdown of all allowed types. - [ekm:customerreviews] You can now output the average star rating for a product.
- 13th June 2017
-
[ekm:addtocart]
Added new
input_class
attribute to the button to make targeting with CSS easier. - [ekm:outofstockmessage] Added new tag to replace the default out of stock message shown on add to cart buttons.
-
[ekm:elementname]
Added new
output_start
andoutput_end
attributes. -
[ekm:incategorydescription]
Added new
output_start
andoutput_end
attributes. -
[ekm:productshortdescription]
Added new
output_start
andoutput_end
attributes. -
[ekm:productdescription]
Added new
output_start
andoutput_end
attributes. -
[ekm:showdata]
Added new
[pagination]
attribute tag to allow you to select where pagination appears. -
[ekm:element]
Added new
allowed_types
andshow
attributes for new element input types. Also added new image size and image size recommendation attributes for image elements.
-
[ekm:addtocart]
Added new
- 7th June 2017
-
[ekm:productqty]
Added new
input_class
attribute to this tag to make it targetable using CSS. -
[ekm:minicart]
Added new
cart_totals_message_empty
,cart_totals_message_single_item
,cart_totals_message_multiple_items
anditem_count_type
to make cart messaging more powerful andon_update_callback
to trigger events when items are added to the cart. -
[ekm:productattributes]
Added new
output_all_attributes
attribute to output other default product attributes in this tag.
-
[ekm:productqty]
Added new
- 5th May 2017
-
[ekm:productqty]
Added new
value
attribute to this tag to set the default quantity value. -
[ekm:showdata]
Added new, more consistent, attribute values for
orderby
anddata
for the recently viewed product feature.
-
[ekm:productqty]
Added new
- 23rd January 2017
-
[ekm:poweredby]
Added new
output_start
andoutput_end
attribites to this tag. - [ekm:captcha] Removed style attribute from documentation as this is no longer supported by Google.
- [ekm:if] Added new statement to check whether a product has reviews or not.
- [ekm:if] Added new statement to check whether a specific feature is installed or not.
- [ekm:customerreviews] Added a new attribute to the customer reviews tag to prevent rich snippets from being output.
- [ekm:page_type] A new tag to output the page type for the page you are currently viewing.
-
[ekm:poweredby]
Added new
- 16th November 2016
-
[ekm:showdata]
Added new
recentproducts
andrandomproducts
data attributes for displaying products recently viewed by the customer and products at random respectively.
-
[ekm:showdata]
Added new
- 20th July 2016
- [ekm:location] Added new tag attributes.
- [ekm:addtocart] Added new tag attributes.
- [ekm:productoptions] Added new tag attribute.
- [ekm:searchbox] Added new tag attributes.
- [ekm:productqty] New product quantity box tag.
- 29th April 2016
- [ekm:shop_contact_details] Added new tag for contact details
- 25th April 2016
- [ekm:productattributes] Added in value_only attribute to tag.
- [ekm:productcode] Added in value_only attribute to tag.
- [ekm:productstock] Added in warning message about value_only.
- [ekm:productstock] Fixed some typos.
- [ekm:cart_custom_css] A tag that is used to inject styles into the cart page.