Help Centre Forum

TOTECS Forums

TOTECS Platform Release 11.00
Author
Thread

Author moderator
25th August 2016

New Features


TOT-2964 - Product deal offer to apply a order freight surcharge discount against selected products

Within the Product Deals and Vouchers feature a new deal offer has been added that allows users to get a discount off the freight surcharge when they checkout.
Using this deal offer can provide incentives for users to buy specific products that the offer applies to, knowing that the freight cost on their order will be reduced by doing so.
This deal offer does not reduce the price of the products that the offer applies to, however it can be used to highlight to the user when a freight discount is applied against an product in their basket/order.
To utilise this deal it is recommended that administrators set up rules within the Order Surcharge that detect when the discount freight deal offer has been applied to the order, and correspondingly set up rules that discount the freight surcharge. It is up administrators to determine the best way to achieve based on the current surcharge rules configured in their project.

Within the Administration Centre, under the Marketing menu, in the Product Deals and Vouchers interface a new Deal Offer has been added labelled "Buy Over X Product Quantity For Y Percent Off Freight Surcharge". This offer allows products assigned to the deal to be marked to receive a percentage discount off the freight order surcharge when more than a given quantity of the product has been added to an order.
Within the Order Surcharges administration interface a new ACTION rule node has been created labelled "Product deal offer to apply a order freight surcharge discount against selected products". This action rule will get the products within an basket/order that the freight surchareg discount deal offer has been applied to, sum up the discounts and calculate the discount average across all product lines in the order, then apply the averaged discount percentage off the the current freight surcharge price set at the time that the order surcharge rule is executed.
Additionally within the Order Surcharges administration interface a FOR rule has been created labelled "Each Product Assigned to Deal_id %VALUE% In Basket" that will loop based on the amount of products within the basket/order that have a deal assigned based on a given deal ID. This allows for customised handling of surcharges to be set based on a given deal being to a number of products.

Functionality Affected: Product Deals and Vouchers administration interface, Product Add To Basket process, Order Surcharges calculation process
Impact: Normal

TOT-3398 - Project Traffic Statistics Administration Centre interface to show statistics for each day of the month

Additional project traffic statistics are now available for administrator users to get access to from within the Project Traffic Statistics administration centre interface.
These additional statistics help admins gain greater insight into the kinds of traffic that are hitting their websites, how often, and from which devices. These statistics provide greater monitoring of websites, and ultimately guide business decisions on how to maintain websites and capture targeted users.

Within the Administration Centre, under the Statistics menu, within the Project Traffic Statistics interface there are now graphs that show statistics broken down by each day of the month, as well as show monthly statistics broken down by search engine/crawler type, device type and browser type.
Additionally for monthly statistics there is the ability to filter statistics based on user, customer account, content managed web page, search engine or crawler, device type, and platform type. When such searching occurs all monthly graphs will update with the search results.
There is now the ability to paginate through the yearly traffic statistics.

Functionality Affected: Project Traffic Statistics administration centre interface
Impact: Normal

TOT-3406 - Activation of product deals against a user's basket products with promotion/voucher codes

On a content managed web page containing a Redeemable Deals and Vouchers Form area, hooks have been added to its "Redeemable Deal Form" format that allow users to activate or deactivate deals via setting either the promotion code or voucher code. The code given will be stored against the user's session, and any applicable deals will be applied against the products already in the user's basket, as well as any future products added to basket.
Additionally the area can show the voucher or promotional code activated, as well as the user to remove the code and deactivate the deals from the products in the user's basket.
Here's the new "Redeemable Deal Form" format hooks:
  • activate_deal_voucher_code_onclick: javascript function that activates the voucher code given in the voucher code input, and assigns the code to the user session as well as applies matching deals against the products in the basket.
  • activate_deal_promotion_code_onclick: javascript function that activates the promotion code given in the promotion code input, and assigns the code to the user session as well as applies matching deals against the products in the basket.
  • deactivate_deal_activation_code_onclick: javascript function that deactivates the current deal voucher or promotion code in the user session, and removes any matching deals from the products in the basket.
  • deal_activation_code: The product deal voucher or promotion code currently activated in the user session
  • deal_activation_code_element_id: ID of the element which shows the deal activation code. This hook should be placed within the ID attribute of an element to allow its contents to be updated when a code becomes activated or deactivated.
  • deal_activation_code_is_active: Either set to Y or N. Y denotes that a deal voucher or promotion code is activated within the user session. This hook should be placed within the ID attribute of an element that contains the success message.
  • deal_activation_success_element_id: ID of the element which shows a message when a deal voucher or promotion code has successfully been activated. This hook should be placed within the ID attribute of an element that displays the success message.
  • deal_activation_error_element_id: ID of the element which shows a message when a deal voucher or promotion code could not become activated. This hook should be placed within the ID attribute of an element that displays the error message.
  • deal_deactivation_error_element_id: ID of the element which shows a message when a deal voucher or promotion code could not become deactivated. This hook should be placed within the ID attribute of an element that displays the error message.
  • deal_activation_element_id: ID of the element which should be shown once a deal voucher or promotion code has become activated. This hook should be placed within the ID attribute of an element.
  • deal_activation_element_class_name: Styling class that denotes if a deal voucher or promotion code is activated in the user session and can be used to show or hide the activated code. This hook should be placed within the class attribute of an element that also contains the deal_activation_element_id hook.
Within the Product Deals Listing and Deals Listing areas a new setting has been added labelled "Activated By User With Voucher/Promotion Code" which controls if deals should display in the areas that are associated to the activated promotion or voucher code currently in the user's session.

Functionality Affected: Redeemable Deals and Vouchers Form content managed web page area, Product Add to Basket process
Impact: Normal

TOT-3380 - Popup to show flagged products within the Home and My Basket pages on the trade interface

Within the Trade interface on the Home page and on the My Basket page there is now the ability to display popup dialogs that show products assigned to a given flag. Each popup dialog on each page can be individually turned on or off and show a unique image advertisement within the popup dialog.
Within the Administration Centre, under the Inventory menu, in the Product Settings interface the following sections and settings have been added:
  • Section: Trade Home Page
    • Show Product Flag Popup Dialog: If set to YES then displays the flagged products popup on the home page of the trade interface
    • Product Flag Popup Dialog Flag: Set a flag to determine the products displayed within the flagged products popup on the home page.
  • Section: My Basket Page
    • Show Product Flag Popup Dialog: If set to YES then displays the flagged products popup on the My Basket page of the trade interface
    • Product Flag Popup Dialog Flag: Set a flag to determine the products displayed within the flagged products popup on the My Basket page.
  • Within the Administration Centre, under the Marketing menu, in the Trade Advertising interface the following adverts have been added:
    • Home Page Product Flags Popup Advertisement: Controls the advertisement image that is shown within the flagged products popup on the Home page of the trade interface.
    • Basket Page Product Flags Popup Advertisement: Controls the advertisement image that is shown within the flagged products popup on the My Basket page of the trade interface.
Functionality Affected: Trade interface Home page, Trade interface My Basket page, Trade Advertising administration centre interface, Product Settings administration centre interface
Impact: Normal

TOT-3417 - Basket Surcharge Calculator content managed web page area

A new content managed web page area labelled "Basket Surcharge Calculator" has been created that allows a user to find out how much cost they can expect to pay in surcharges, based on the products currently in their basket if they were to checkout at the time.
Previously only the Basket Products Listing area could display a Surcharge Calculator from a popup, but now this area allows the calculator to be separately embedded on a content managed web page.
The area has the one format "Basket Surcharge Calculator" which is the same format assigned to the "Basket Products Listing", and contains the same hooks to allow users to input location details, and have a price displayed.
The area has no configurable settings.

Functionality Affected: Basket Surcharge Calculator content managed web page area
Impact: Normal

Improvements


TOT-2619 - "Display categories As" setting in Category Listing content managed web page area to exclude list tags from being embedded in area

On a Category Listing content managed web page area there is now the ability to not have list HTML elements wrap each of the category and product formats. This will give website implementors more flexibility on how categories can be listed on a web page.
Within the Administration Center, under the Websites menu, from the Websites interface, when modifying a Category Listing content managed web page area in the Web Page Editor, for the area's "Display categories as" setting a new option has been added labelled "Records". When the setting is set to Records and the area is shown on a webpage, the list elements will not be embedded around the Category Listing format within the area.

Functionality Affected: Category Listing content managed web page area
Impact: Normal

TOT-3378 - Category code field to store up to 255 characters

For categories stored within a TOTECS project the category code field now allows up to 255 characters to be stored. This will allow more text to be stored in the code, which could be used for setting longer search engine optimised words within the category codes.

Functionality Affected: Categories Connector data import, Category Trees Administration Centre interface
Impact: Minor

TOT-3400 - Hook to show that product price is from a contract within a Product Search Result Listing content managed web page area

On a content managed web page containing any areas that use the Product Search Record format, there is now the ability to style or highlight a product record when the price displayed is associated with a contract.
In the format a new hook has been added labelled "product_price_is_on_contract" that shows either Y or N. If Y then the price for the product is based off a price set within a contract.
This hook could be placed within the class name of an element that contains CSS styling rules used to highlight products on contract.

Functionality Affected: Product Search Results Listing content managed web page area, Category Listing content managed web page area
Impact: Normal

TOT-3402 - Administrator users to view and decline pending orders within the Orders interface

Within the Administration Centre, under the Orders interface, a checkbox has been added that allows admin users to find orders that contain the order status as pending.
When a pending order is displayed a Decline button will also show allowing the administrator user to decline the order upon confirmation.
If an administrator does decline an order an Email notification will be sent to the original user who created the order to advise them of the declined order, and optionally show a message to explain why.

Functionality Affected: Orders Administration Centre interface
Impact: Normal

TOT-3404 - Only allow users to login based on a designated public IP address

There is now the ability to limit users being able to login based on the public IP address assigned to their internet connection. This can be used to ensure that users and systems can only login from one or more physical locations, based on a static IP address being assigned to the given location.
Within the Administration, under the User's menu, within the Search Users interface, after locating a user and clicking on its ID, within the User Details interface a field labelled "Allowed Public IP Addresses" has been added that allows multiple public IP addresses to be assigned to the user. Both IP4 and IP6 addressses can be set, with each IP address placed per line in the field's text area.
Additionally within the User's menu, within the General Settings interface a setting labelled "Validate User's Public IP Address At Login" has been added. When this setting is set to Yes, then the user login process will perform a check to make sure that the public IP address assigned to the user logging in matches one of the IP addresses assigned to the user. If no match is found and at least one IP address has been assigned to the user then the login attempt will fail.

Functionality Affected: User Details administration centre interface, User Login process
Impact: Normal

TOT-3405 - Setting to force users to enter values within specified product attribute search form fields

For product attribute search forms displayed within the Trade interface and on content managed web pages using the Product Search Form area, there is now the ability to force users to enter or select values for certain attribute fields before allowing them to perform a search. If a mandatory attribute field has not been field out then there is the ability to set an error message specific to that field that the user will see.
Within the Administration Centre, under the Inventory menu, within the Search Profile interface, when modifying a Product Attribute search profile, in the Assign Search Attribute dialog the following settings have been added:
  • Is Mandatory: If set to Yes then the user will need to have set a value for the attribute field in order to be able to search.
  • Mandatory Error Message: Set text that the user will see in a browser alert box when the field is mandatory and has not been set a value.
For the product attribute search forms that can display Trade interface's Home page, and Product Search pages, as well as on the content managed web page "Product Search Form" areas have been modified to support validating mandatory fields in attribute searches.

Functionality Affected: Product attribute search process, Product Search Form areas, Search Profiles administration centre interface
Impact: Normal

TOT-3408 - Ability to configure order surcharges based on an activated product deal voucher or promotion code

Within the Administration Centre, under the Orders menu, in the Order Surcharges interface when creating or modifying an IF surcharge rule in the "Modify If Rule Node" dialog, a new option has been added labelled "Product Deal Activation Code" that allows an IF condition to be set that checks if the deal promotion or voucher code activated by user matches a given value.
Additionally on content managed web pages containing "Order Checkout/Submission", "Order Print Form" or "User Details/Favourites/Orders" areas, a hook labelled "_PO_deal_activation_code" has been added to the "Order Print Detail" and "Order Review" formats that can show the deal promotion or voucher code activated against the order. This can be used to show in the areas any discount text related to the code.

Functionality Affected: Order Surcharges administration centre interface, Order Checkout/Submission, Order Print Form and User Details/Favourites/Orders content managed web page area
Impact: Normal

TOT-3410 - Websites setting to control if Free Draw content managed web page areas are wrapped in paragraph tags or not

Within the Administration Centre, under the Websites menu, within the Websites Settings interface a setting has been added labelled "Wrap Free Draw Webpage Areas In Paragraph Tags". When set to No and a Freedraw area is saved within the Webpage Editor, no paragraph tags will be be wrapped around or used to break lines. If the setting is changed to No and an existing Free Draw area contains paragraph tags is saved, the existing paragraph tags will remain and need to be manually removed. For new areas the paragraph tags will not be embedded.
For any new projects created this setting will be set to No by default, for existing projects it is set to Yes to ensure that the setting does not break any existing web page styling.

Functionality Affected: Free Draw content managed web page area
Impact: Normal

TOT-3418 - hook in User Registration content managed webarea for displaying only the terms and conditions checkbox

On a content managed web page containing a User Registration area, in its User Registration Form format a hook has been created labelled "termsagree_checkbox" that contains only the terms-and-conditions checkbox element.
This hook removes the need to embed the "termsagree" hook in the area that would display text and links in the area that could not be reworded.

Functionality Affected: User Registration content managed web page area
Impact: Minor

TOT-3420 - Content managed web page javascript event listeners for before and after a product has been added to basket

On a content managed web page there is now the ability to add javascript event listeners for before or after a product has been added to basket. This allows highly customised functionality, such as popups to display before or after a user has added a product to basket from any area.
Two new area event types have been created in the content managed webpage javascript API:
  • BEFORE_PRODUCT_ADD_TO_BASKET - gets fired before a product is being added to basket from within an area
  • AFTER_PRODUCT_ADD_TO_BASKET - gets fired after a product has successfully been added to basket from within an area
An example below shows how to use these new web page area event types to have a custom javascript function be called for an area after a product has been added to basket from within it:

<script type="text/javascript">
  TOTECS.retail.loader.loadFunction(function(){
    var myFunction = function(type, args, me){
        alert('product has been added');
        TOTECS.retail.fs.removeAreaEventListener(1);
  };
  TOTECS.retail.fs.addAreaEventListener(44, TOTECS.retail.fs.WEBPAGE_AREA_EVENT_TYPES.AFTER_PRODUCT_ADD_TO_BASKET, myFunction, 1, '');
});
</script>

Functionality Affected: Content managed web pages
Impact: Normal

TOT-3421 - Content managed web page javascript event listeners for before a paginator is used to reload an area

On a content managed web page there is now the ability to add javascript event listeners when can be called after a user has clicked on a paginator element, before the area is reloaded. This event can be fired from paginator elements in Product Search Result Listing, Category Listing, Product Deals Listing, Redeemable Deal Products Listing, Account Enquiry listing areas and most other areas that display paginators allowing a user to page through records.
A new area event types have been created:
  • BEFORE_PAGINATOR_RELOAD- gets fired after a user has clicked on a paginator element, but before the area is reloaded with a new page of data.
An example below shows how to use this new web page area event type to have a custom javascript function be called for an area after a user has clicked on a paginator element:

<script type="text/javascript">
  TOTECS.retail.loader.loadFunction(function(){
    var myFunction = function(type, args, me){
        alert('product has been added');
        TOTECS.retail.fs.removeAreaEventListener(1);
  };
  TOTECS.retail.fs.addAreaEventListener(44, TOTECS.retail.fs.WEBPAGE_AREA_EVENT_TYPES.BEFORE_PAGINATOR_RELOAD, myFunction, 1, '');
});
</script>

Functionality Affected: Content managed web pages
Impact: Normal

Bug Fixes


TOT-3220 - Unable to load products for a category within the Trade interface when a category code contains an apostrophe

Within the Trade interface users would not be able to navigate through a category if the category's code contained an apostrophe.
Category links have been modified in the category dialogs, and category crumbs so that they correctly handle when an apostrophe is set within a category's code.

Functionality Affected: Trade interface home page, Product Detail page, Product Search page
Impact: Normal

TOT-3376 - Customer Account connector data import not assigning newly created users to the interface based on Default Interface user registration setting

When a Customer Account connector data import was run, if a new customer account was created, then when the associated user was created it was always being assigned to the Trade interface, instead of the interface controlled by the Default Interface setting within the Administration Centre's User Registration Settings interface.The data import has been modified to correctly assign the user to the interface based on the setting configured in the project.

Functionality Affected: Customer Account connector data import
Impact: Normal

TOT-3377 - Incorrect discount being applied when sales rep user adds product to basket from Product Search Results Listing content managed web page area

On a content managed web page area containing a Product Search Results Listing area, if the user logged in was a sales rep user and had the Facility Role permission that allows them to alter pricing, then if the discount hooks had been embedded in the area and the user added the product to basket, the price of the added product was always set to the price of the first product in the basket.
This bug was caused from development in TOT-3357 and the hooks were modified to fix this issue and ensure that the correct price is added to basket by the sales rep. This fixed was directly patched into the 10.04.1 release.

Functionality Affected: Product Search Results Listing content managed web page area.
Impact: Normal

TOT-3391 - Product Search From content managed web page area failing to reload when displaying multiple attributes as Page Links With Product Count

On a content managed web page displaying a Product Search Form (Using Search Profiles) area with a Product Attribute search profile, if the profile was displaying multiple attributes as Page Links With Product Count, after the user had clicked on a link to update the area, this could cause to area to show a loading message for several minutes before timing out, and no Search Results Listing areas would be reloaded.
The area and the underlying product attribute search process has been modified to ensure that it can more efficiently find products when the search form is displaying multiple attributes with counts.
This issue was caused by an in-efficient search database query being generated when multiple attributes contained many values displayed as a list with counts in the area.

Functionality Affected: Product Search Form (Using Search Profiles content managed web page area.
Impact: Normal

TOT-3392 - Category Crumbs content managed web page area not reloading Category Listing areas correctly in page

On a content managed web page displaying a Category Crumbs area, if the user clicked on a category link within the area that caused it to dynamically reload category areas on the page, none of the category areas were finding any category.
This bug was caused by the changes made in TOT-2658 from the 10.04 release. The area has been modified to correctly reload other Category Listing areas in page when a user clicks on a crumb link that contains the "viewCat_onclick" hook.

Functionality Affected: Category Crumbs content managed web page area.
Impact: Normal

TOT-3393 - Product Search Results Listing content managed web page area not correctly showing a product that has been removed from favourites

On a content managed web page containing a Product Search Results Listing area, after a user had clicked on a link to remove a product from their favourites, the incorrect product in the list was being shown as removed from favourites.
Within the area the favourites_product_add_onclick and favourites_product_remove_onclick hooks have been modified to correctly find the element with the favourites_product_wrapper_element_id ID that controls whether to hide or show favourites buttons for the given product.

Functionality Affected: Product Search Results Listing content managed web page area
Impact: Normal

TOT-3407 - Orders Administration Centre interface not loading when admin user has permission to view orders

Within the Administration Centre, under the Orders menu, within the Orders interface a blank page would display if the administrator user logged in was assigned to an Administration permission role that did not allow them to view the Store settings.
The Orders interface was modified to correctly look at if the user had the Online Store admin role permission set to Allow in order to show the interface.

Functionality Affected: Orders administration centre interface
Impact: Normal

TOT-3409 - In a News/Blog Group Forum Record content managed webpage area, ordering not applying and inactive news/blog groups displaying

On a content managed webpage containing a News/Blog Group Forum Record area, the ordering set against the News Groups in the area was not matching the ordering set within the News/Blogs administration centre interface, additionally inactive news/blog groups were still displaying in the area.
The area has been modified to order news/blog groups based on the ordering field, as well as only show activate news/blog groups within the area.

Functionality Affected: News/Blog Group Forum Record content managed web page area
Impact: Normal