Releases

New Features

TOT-4304 - Product Deals and Vouchers deal offer types to apply X percent discount/fixed price amount across all deal products when the undiscounted total basket price of deal products in basket is over Y amount

Within the Administration Centre, under the Marketing section, within the Product Deals and Vouchers interface 2 new product deal offer types have been added that allows a user to get a given percentage amount off products added to the deal, or deal products for a set price when the un-discounted aggregate total of any these deal products in the basket is over a specified amount set excluding tax.

For example this allows the for the deal offers:"Buy over $200 ex. tax of any products in the deal, and get 5% price off all of these deal products."
"Buy over $200 ex. tax of any products in the deal, and get deal products for $10 each."

Note that these deal offers will only look at the undiscounted total aggregated amount of the deal products in the basket excluding tax. This means after the discount is applied, it could cause the final basket total to be less than the basket total set in the deal. For example if the basket's un-discounted total is $200.01, then if all products in the basket apply to the same deal to discount by 5%, then the basket's final total will display as: $190.00. In effect this kind of deal offer type provides a volume discount based on a price break, instead of a specific quantity break.

Within the Administration Centre, under the Marketing menu, in the Product Deals and Vouchers interface, within the Offer drop down, in the "Buy Over Collective Quantity Discount Deals" options group, 2 new offer types have been added.

Buy Over X Total Price Of Products In Deal (Before Discounts), Get Product For Y Percent Off Price
When a user adds over a total price amount across any products assigned to the deal, then any products on the deal in the basket are discounted by a percentage amount, for the given number of times the deal allows. Set the offer's "Total Price X" to the total price threshold that unlocks the deal. Set the offer's "Percentage Y" setting to the percentage amount to discount products on the deal by.

Buy Over X Total Price Of Products In Deal (Before Discounts), Get Product For Price Y
When a user adds over a total price amount across any products assigned to the deal, then any products on the deal in the basket will have the price set on the deal, for the given number of times the deal allows. Set the offer's "Total Price X" to the total price threshold that unlocks the deal. Set the offer's "Price Y" setting to the price amount to discount products on the deal by.

Functionality Affected: Product Deals and Vouchers Administration Centre interface, Product Add To Basket server logic
Impact: Normal

TOT-4324 - Data Exports interface and spreadsheet CSV data exports within the Administration Centre

After an administrator user logs into the Administration Centre, then within the Data menu, a new menu item labelled Data Exports has been added. Clicking on it opens the Data Exports interface that allows the following data types to be exported in entirety to CSV spreadsheet files:

• Customer Accounts
• User Marketing Categories
• Related Products
• Product Attributes
• Product Combinations
• Product Images Records
• Product Attachment Records
• Product Categories
• Categories
• Category Images Records
• Content Managed Web Pages
• Content Managed Web Pages Areas

TOT-4299 - Modify Order Checkout/Submission process to support updating existing orders and order submission from previous Order Punchout

Within the TOTECS Ecommerce Platform's API a new API endpoint called "setup_esd_punchout" has been created. When this API endpoint is called from a 3rd party purchasing system, the system needs to provide the Login ID and Password credentials within the Authorization header, as well as a URL in the request body that users should be redirected back to once they have successfully completed the order checkout process. If the user's credentials are valid, then a return URL will be provided to the purchasing system, that can then be used by a purchasing user's web browser to be redirected to the specified content managed website and landing web page. This API endpoint uses the Ecommerce Standards Document to structure the JSON expected to be received and returned.

On a content managed web page containing an Order/Checkout Submission area, the Order Checkout/Submission process has been modified so that after an order is created from a Punchout workflow, the purchase order data can be returned on a Purchase Order Ecommerce Standards Document if the users customer account is assigned to the new "ESD "submission profile. If this occurs then when the user is redirected back to the purchasing system via its provided URL, in the POST request data will contain the order structured in the Purchase Order Ecommerce Standards Document JSON format, that has been URL encoded in a form within the request body.

A second new API endpoint has been created called "setup_esd_order_checkout". The purchasing system can optionally can this API endpoint if they wish to have purchasing user be sent back to a content managed website with order that is ready to be approved. The API endpoint will also require the user's credentials to be provided within a Authorization header, as well as a Purchase Order Ecommerce Standards Document within the request body. If the credentials are correct, then the contents of the order will be validated, and if correct then be turned into an unconfirmed order. The API will return a URL back to the purchasing system, that can then be used to redirect the purchasing user's browser to the content managed website, and land on web page containing an Order Checkout/Submission area. From where the user can confirm order details, review the order, then submit it. Once done the order then can be marked as confirmed and submitted onwards for processing. Note that for the content of the order given, the API endpoint will remove products that can no longer be purchased, and reapply order surcharges. From there the user can proceed through Freight Carrier Selection (if applicable), Order Review, Payment, and Order Submission steps again.

Within the TOTECS Ecommerce Platform Doc Centre the following document was created to provide an overview of the punchout and order checkout work flows, as well as links to other technical documents in the API.
https://docs.totecs.com/TOTECS/Purchaser-Punchout-and-Ordering.html

Functionality Affected: Platform API, Order Checkout Submission Profiles administration centre interface
Impact: Normal

Improvements

TOT-4310 - User Search Rules and filters to show users and baskets containing products unchanged for a time period within the Basket Statistics interface

Within the Administration Centre, from the Statistics menu, within the Basket Statistics interface, under the Basket Summary section additional filters have been added to be able to filter baskets on. Within the Summary Statistics section there is now a drop down to filter the summary statistics numbers by Last Modified Date of a basket. This can limit down the statistics over s shorter date range that may be more relevant.

Under the Shopping Baskets section it now allows baskets to be filtered by User Type, including Registered, Guest, and Sales Rep users. There's the ability to filter baskets based on the number of products in the basket. A filter now exists to match baskets on user or customer account data fields. There's now the ability to filter baskets by the date when baskets were last modified. After a basket search has been performed an Export button now displays, that allows the found baskets to be exported to a CSV spreadsheet file. Up to 10.000 baskets can be exported to a spreadsheet file. The section now will list individual baskets for users, instead of grouping baskets based on user. This then allows the products assigned to individual baskets to be seen, as well as see the number of baskets assigned to individual users.

Within the Administration Centre's Search Users interface, within the Advance Search section, under for the Search Category drop down, for the Shopping Basket category, 2 additional search rule option have been added to find users who have products in their shopping basket that has not changed for a given time period. These search rules can be used to users who still have products in their basket that has been unchanged/abandoned after a specified period of time. This user search rule could also be used in Product Deals and Vouchers feature, and/or Emarketing features to then target users to complete ordering. The search rule can also be used to find users and export those users to a spreadsheet for offline needs.

Functionality Affected: Basket Statistics administration centre interface, User Search administration centre interface, Orders administration centre interface, Product Add To Basket server logic
Impact: Normal

TOT-4312 - Additional browser security of user sessions

For user sessions created for content managed websites, and within the Administration Centre, security improvements have been added when a user's session is created, either automatically, or when a user logs in and a user's session is saved to the web browser. These changes use multiple web page features to reduce the chances for a user's session becoming compromised.

Functionality Affected: User Session Creation login process
Impact: Normal

TOT-4314 - Add format hook to display freight unit name and return estimated delivery hours for Smart Freight within Freight Carrier Service Record format within Order Checkout/Submission content managed web page areas

On a content managed web page that displays either a Guest Order/Checkout Submission area, or an Order Checkout/Submission area, if the areas are configured to display the freight carrier selection, and the Integrated Freight project setting is turned on, and the Get Carrier Selection From Freight Provider setting is set to Smartfreight or OneFlo, then when the order/checkout submission areas retrieve the freight carrier details from the freight provider systems, there is now a new format hook labelled "freight_service_unit_name".

This format hook will display the name of the freight unit returned by SmartFreight's system, or for OneFlo's system it will return the name of the freight unit that is used to obtain the carrier service options.

Additionally If SmartFreight's system is used to obtain the list of freight carriers to select from, the existing freight_service_delivery_time format hook will display the number of hours that estimated to use the freight carrier service, if SmartFreight's system provides the estimated delivery date time. Otherwise the format hook will be empty.

Functionality Affected: Guest Order/Checkout Submission area, Order Checkout/Submission content managed web page areas
Impact: Normal

TOT-4316 - Export additional product data fields within the Products Spreadsheet CSV data export within the Administration Centre

After an administrator user logs into the Administration Centre, then within the Inventory menu, in the Product Search interface, after performing a product search and clicking on the Export button, within the Export Products dialog the following additional data fields can now optionally be selected from:

• Is Combination Parent: Either Y or N, Y if a product is a parent combination product
• In Combinations Count: Number of parent combination products that a product is assigned to
• Has Taxcode: Either Y or N, Y if a product is assigned to a taxcode
• Has Primary Image: Either Y or N, Y if a product has an image assigned to it that is a primary image
• Has Primary Search Image: Either Y or N, Y if a product has an image assigned to it that is a primary image for searches
• Price Level Unit Prices (column per price level)
• Images Active Count: Number of active product images that the product has
• Categories Active Count: Number of active categories that the product is assigned to
• Attribute Value Count: Number of attribute values assigned to the product
• Flags Count: Number of flags assigned to the product
• Price Level Prices: Displays a column for each price level, with the unit price of the price for each price level
• Is Visible For User: Either Y or N, Y if the product is active, not hidden, and the product is assigned to an inventory role that a nominated user is assigned to, and has the Allowed permission to view the product. If this data field is selected, then the Find User To Check For Visibility search auto-complete will show, and the Login ID of a user needs to be typed and selected. This user, their assigned inventory role and customer account will be used to check product visibility with.
• After any of these new data fields are selected, as well as existing data fields, then the CSV spreadsheet generated will need to contain data for each product. Note that some of these new data fields may cause the data export to take longer to load, since more checks need to be performed across additional data structures.

TOT-4317 - onclick format hooks to paginate products to next and previous pages within the Redeemable Deal Products Listing

On a content managed web page that displays a list of products within the Redeemable Deal Products Listing area, within its Redeemable Deal Products Header and Redeemable Deal Products Footer formats, there following format hooks have been added to allow the next and previous pages of records to be pagination using a javascript function. This allows the elements that trigger the pagination to be more customisable.

• deal_products_next_page_onclick: Contains a javascript function that allows the next page of product records to be updated within the area.
• deal_products_prev_page_onclick: Contains a javascript function that allows the previous page of product records to be updated within the area.

TOT-4318 - Set formatted message to display within Order Confirmation Notification Email when an order is delivered to an international country

On a content managed website, when a guest or logged in user adds a product to basket, and proceeds to the web page containing a Order Checkout/Submission area, within the Order Details form if they select or set a delivery address that has the country set that is international, then once the order has been submitted, within the area's Order Submission Success Message format, as well as the Order Confirmation Notification Email that is sent out, there is now the ability to display a configurable message that may contain any details that a customer may need to know about for an international order.

Within the Administration Centre, under the Stores menu within the Order Settings interface, a setting labelled "International Order Delivery Message Format" now exists that allows a customised message to be set when an order is being delivered internationally.

Within the "Order Confirmation Email Message Format" and "Order Confirmation Email Order Surcharge Format" settings, additional format hooks have added that will display the content of the international order message if the order is assigned to an international country. These format hooks are:

• order_delivery_international_message: Message to display for international orders, based on the delivery country not being the same as the project's default country.
• order_delivery_international_message_display: CSS display rule to control if the international order message should display or not.

• order_delivered_international_message: Message to display for international orders, based on the delivery country not being the same as the project's default country.
• order_is_delivered_international: Either 'Y' or 'N'. If 'Y' then the order is being delivered internationally.

TOT-4319 - ESD version 1.5 conforming JSON responses in REST API endpoints

Within the REST API, for the Create User Session, Destroy User Session, Validate User Session, Import Data endpoints, the response JSON data has been modified to conform to the Ecommerce Standards Documents JSON response. For all API endpoints they now containing additional attributes in the returned JSON data, including ESD version number, message, and configs storing result information. This makes it easier for 3rd parties to integrate with the API without having build more customised code.

Functionality Affected: REST API
Impact: Normal

TOT-4320 - Limit order options to a specific country matching an order's delivery address within Order Checkout/Submission content managed web page areas

On a content managed web page that contains either a Order Checkout/Submission area, or a Guest Order Checkout/Submission area, after a user has added products to basket and is viewing the Order Details Form within the areas, the Order Options available to the user can now be limited based on the country that is set against the chosen delivery address. This allows order delivery options to be made available or hidden from the user based on the country that an order's products are being delivered to.

Within the Administration Centre, under the Stores menu, within the Order Options interface, for each Order Option type, an additional data field has been added labelled "Conditions" with the following options:

• Allowed For All Countries: Allows the order option to be selected regardless of what the country an order's delivery address is set to.
• Not Allowed For Delivery Country: Only allows the order option to be selected if the country in an order's delivery address doesn't match a specified country.
• Allowed For Delivery Country: Only allows the order option to be selected if the country in an order's delivery address matches a specified country.

TOT-4322 - Setting to require Customer Account Code to be set with making a credit card payment within the Payments Administration Centre interface

Within the Administration Centre, under the Stores menu, within the Payments interface, upon clicking on the Make Payment tab, within the payment form there is now the ability to control if the Customer Account data field is mandatory, and that a customer account code must match an existing customer account before allowing an administrator user to make a credit card payment.

Within the Administration Centre, under the Stores menu, within the Payment Settings interface, under the Credit Card section, a new setting labelled "Validate Customer Account Code For Admin Payments" has been added. If set to Yes, then within the Payments admin centre interface's Make Payments tab, the Customer Account data field will be labelled as Customer Account Code and be marked as a mandatory data field. If a credit card payment attempt is made then validation will occur to ensure the Customer Account Code matches an existing customer account. If no account is found then a "No customer account can be found with the given customer account code." message will be returned. By default this setting is set to No.

Functionality Affected: Payments administration centre interface
Impact: Normal

TOT-4326 - Drop downs to control sorting of products within a Customer Account Contract Detail content managed web page area

On a content managed web page that contains a Customer Account Contract Detail area, within the area that's showing a list of products assigned to a customer account contract that the user has permission to view, there is now the ability to embed drop down elements that can control the sorting of products listed within the area. This includes the ability to choose a product field to sort products by, as well as the direction that products are sorted on (either ascending or descending). The sorting product drop down can be set to sort products by the following:

• default
• Ordering
• Price
• Product Code
• Name
• Barcode
• Inner Barcode
• Unit
• Units Per Pack
• Weight
• Stock Quantity
• Most Ordered Products in 3 months
• Most Ordered Products in 6 months

• Sort Contract Products By: Set the data field that contract products are sorted by when the area initially displays
• Sort Contract Products Direction: Set the direction that contracts products sorted by, either ascending or descending

TOT-4328 - Settings to control if address data fields can be empty or not

Within a content managed web page that contains either Order Checkout/Submission, Guest Order Checkout/Submission or User Details/Favourites/Orders areas, if the area allows the user to create or update an existing address, there is now ability to control which of the 4 address fields is mandatory to be filled out, and which data fields are not mandatory.

Within the Administration Centre, under the Stores menu, within the General Store Settings interface, under the Locality section, 4 settings have been added labelled "Address 1 Is Mandatory", "Address 2 Is Mandatory", "Address 3 Is Mandatory", "Address 4 Is Mandatory", that control if each of the 4 address data fields is mandatory to have a value set. By default these settings are set to Yes, as was the bahaviour before these settings were created.

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission, User Details/Favourites/Orders content managed web page area
Impact: Normal

TOT-4329 - Improved styling, accessibility, responsive layouts within the Administration Centre

Within the Administration Centre, the layouts and styling of interfaces have been improved. This includes increasing the font size to allow text to be more easily read and buttons increased to make it easier to click on in small sized screens.

The navigation menu bar has had improved styling and is responsive to large and small sized screens. Each menu item has additional details on what the menu item does. Several interfaces are able to resize better in smaller sized screens. The theming has been improved to provide a more modern looking interface.

Functionality Affected: Administration Centre
Impact: Normal

TOT-4334 - Show freight carrier cost excluding or including tax based on user Tax Format setting within Order Checkout/Submission content managed web page areas

On a content managed web page that contains either a Order Checkout/Submission area or a Guest Order Checkout/Submission area, when the project is configured to integrate with freight providers and show the freight carrier selection, within the Freight Carrier Service Record format there is now a new format hook labelled "freight_service_cost_price" that shows the price of a freight carrier, based on the tax format set for the user. This allows either the carrier price to be shown excluding or including tax, depending on the user's "Price Tax Format" setting.

If a user's Price Tax Format is set to Exclusive then the freight_service_cost_price format hook will display a freight carrier's cost without tax, if the Price Tax Format is set to Inclusive then the the format hook will display the freight carrier's cost with the tax amount included.

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission content managed web page areas
Impact: Normal

TOT-4335 - Show abandoned orders within the Orders Administration Centre interface

Within the Administration Centre, from the Stores menu, within the Orders interface, an additional filter has been added labelled "Abandoned", that can filter unconfirmed orders that have not changed within 8 hours and are considered abandoned. This allows administrator users to see and be aware of orders that have been considered abandoned, where users have proceeded to Order Checkout and reached the review stage but did not complete payment or submit the order. This filter also allows administrator users to determine next actions, such as re-engaging with the users, or understanding the users who may have abandoned the order and the details that they provided.

For unconfirmed orders that are considered abandoned the administrator user won't be able to resubmit the order, unless the order had a payment successfully made against it, but failed to have its order status updated.

Functionality Affected: Orders administration centre interface
Impact: Normal

TOT-4104 - Combine advanced product search with attribute search when displaying results within the Product Search Result Listing content managed web page area

On a content managed web page displaying a Product Search Results Listing area, the area now has the ability to display products based on combining a product attribute search to an advanced product search, and returning products that intersect between the two. Additionally within the Product Search Form (Using Search Profile) area is able to perform this intersecting search by displaying an attribute search form with an advanced profile search form, that in effect allows the results from a advanced product search profile to be further filtered.

Within the Administration Centre, under the Inventory menu, within the Search Profiles interface, when a Product Search Profile is being edited, within the Search Profile Options section, an additional drop down setting has been added labelled "Link To Attribute Search Profile", that allows a Product Search Profile to be linked to an attribute search profile.

On a content managed web page displaying a Product Search Results Listing area, if the area is performing a search using a Product search profile, and the search profile has a linked attribute search profile, then the search is able to look for attribute values passed to it through URL parameters, and further refine the search by factoring the given attribute values. When any of the paginator or sorting elements are used within the area it will also pass the attribute values as parameters when updating the area.

On a content managed web page displaying a Product Search Form (Using Search Profile area), a new area setting labelled "Show Linked Search Profile" has been added. If this setting is saved to Yes, then if the area allows a Product search profile to be loaded in the area, and profile is linked to an attribute profile, then the area will also display attribute search form elements as well as text box search form elements. All of the search form values of the product search profile and the product attribute search profile will be passed across to any Product Search Results Listing areas on the page, or within the web page URL if a full page refresh is occurring.

This allows a combined product advanced search to be performed with an attribute search, allowing users to use search words to match on products, as well as use attributes to further filter products.

Functionality Affected: Product Search Results Listing content managed web page area, Search Profiles Administration Centre interface
Impact: Normal

TOT-4248 - Improve product pricing logic to avoid price rounding issues

When any calls are made to calculate product pricing in non-product search listings, the product pricing calculations have been changed to avoid price rounding issues that may be occurring within the database procedure that was previously used. This change provides the same results of pricing products, factoring price-level unit pricing, quantity break pricing, customer account pricing, currency rate, and contract data.

Functionality Affected: Product Pricing server logic
Impact: Critical

Bug Fixes

TOT-4309 - Web page routes unable to be loaded within the Websites Administration Centre interface

After an administrator user logged into the Administration Centre, clicked on the Websites menu item, within the Websites interface, upon clicking on the Webpage URL Routing tree node, within the Webpage URL Routing dialog the routes would always to fail to load within the table, and the server response always returned a failure result.
Now within the Webpage URL Routing dialog the routes now correctly load within the table. This issue was caused by a programming error.

Functionality Affected: Content Managed Websites administration Centre interface
Impact: Normal

TOT-4321 - Users incorrectly able to see products within the Redeemable Deal Products Listing content managed area that they don't have permission to add to basket with their assigned inventory role

On a content managed web page that contained a Redeemable Deal Products Listing Area, the area was displaying all products across deals that the user is assigned to, incorrectly including products that the user didn't have permission to view or add to basket.
Now within the Redeemable Deal Products Listing Area, the area will now only displaying product across deals that the user is assigned to, where the user has permission to view or add to basket, based on the permissions of the user's assigned inventory role.

Functionality Affected: Redeemable Deal Products Listing content managed web page area
Impact: Normal

TOT-4325 - Guest website region user session failing to be created for the correct content managed website if a web page URL doesn't contain the Web Page Name or Web Page ID

On a content managed website that had the Website Regions feature turned on, if a new guest user first requested a web page that did not have the web page name or web page ID within the URL, then the a guest user session was created with the first website that existed within the project.
Now if a new guest user first requests a web page that does not have the web page name or web page ID within the URL, then when the a guest user session is created it will use the website domain to match on the content managed website, and use the default region assigned to the matched website to create the user's session for. This avoids the issue where a guest user session was being created for the first content managed website found, which may have been the incorrect website, if a project has multiple content managed websites.

Functionality Affected: Content managed web pages
Impact: Normal

TOT-4330 - Delivery status settings incorrectly being saved across all projects

After a user logged into the Administration Centre and clicked on the Stores menu, then clicked on the Order settings menu item, after making changes to any settings within the Order Delivery Status section after any settings had been set, then once the Save button is clicked on the settings were incorrectly being updated across all other projects in the platform, affecting the projects when the Order settings are next reloaded for a project.
Now when an administrator user makes changes to any settings within the Order Delivery Status section, then once the Save button is clicked on the settings are correctly only updated for only the project that the administrator user is logged into.

Functionality Affected: Store Settings Administration Centre interface
Impact: Major

New Features

TOT-4297 - Product Add To Basket Spreadsheet Importer content managed web page area

On a content managed web page a new web page area type has been created called "Product Add To Basket Spreadsheet Importer" that provides the ability to add products to basket that are listed in a spreadsheet CSV file. Within the area it allows one or more CSV spreadsheet files in a computer to be selected, or have pasted the contents of a CSV spreadsheet file into the area's text area input. From the CSV spreadsheet data a list of product records is read and added to an "Add To Basket" queue. The queue can then be processed to automatically add products to basket in batches of 20 products at a time, until the queue is fully processed or aborted at any time.

In the spreadsheet CSV data provided it needs to contain columns for Product Code, and Quantity for each product row. After a user clicks a button to process the queue, it will attempt to add each product and its quantity to the user's active basket. If a product fails to be added to the basket then an error message can display, indicating the products that failed to be added to basket and why it had failed.

The area contain settings that allow the user to optionally control how the CSV data provided can be read, based on common CSV data formats that applications like Excel, Google Sheets, or Libre Office support.

Within the Administration Centre, under the Websites menu, within the Websites interface, within the Web Page Editor, when a "Product Add To Basket Spreadsheet Importer" area is added to a web page, it contains the following settings:

• Initial Spreadsheet Data Format: Sets the spreadsheet data format that is initially selected with the area's drop down displays. Controls how CSV data should be read
  • Comma Delimited (CSV) - Reads a comma delimited CSV file, where data rows are separated by the new line character.
  • Comma Delimited (CSV MS DOS) - Reads a comma delimited CSV file, where data rows are separated by the carriage return and new line characters
  • Comma Delimited (CSV Macintosh) - Reads a comma delimited CSV file, where data rows are separated by the carriage return character
  • Tab Delimited (CSV) - Reads a tab delimited CSV file, where data rows are separated by the new line character
  • Space Delimited (CSV) - Reads a space delimited CSV file, where data rows are separated by the new line character
  • Colon Delimited (CSV) - Reads a colon delimited CSV file, where data rows are separated by the new line character
  • Semi Colon Delimited (CSV) - Reads a semi-colon delimited CSV file, where data rows are separated by the new line character
• Add Queued Products Immediately To Basket: If set to Yes then when one or more spreadsheet files is selected, or CSV text area records added, then the products added to the queue will immediately called to add products to basket.

TOT-4307 - Customer Account Contacts Connector Data Import

A new data import named "Customer Account Contacts" has been created that can import a list of contacts that are assigned to each customer account from the Connector software. The data import can create and update a list of contacts assigned to each customer account, as well as deactivate contact records that are no longer being imported. Additionally the data import can optionally create new users for each customer account contact record, and link the contact record the each new user.This allows multiple people associated to each customer account in connected business systems to have a user automatically created for them. If the contact is removed the connected system, then the data import can optionally deactivate the user who's linked to the contact record.

After logging into the Administration Centre, under the Data menu, within the Data Imports interface, under the Connector Imports tab, a new data import type labelled "Customer Account Contacts" displays. If selected and the Start Import(s) button is clicked on, the data import will call the Connector software to run its Customer Accounts Contacts data export to retrieve the contact data, then import it into the project.

Clicking the settings button on the data import type allows 2 settings to be configured:

• Create users for new contacts: If selected then when a new customer account contact record is created then a new user will also be created if a unique Login ID of the user can be defined.
• Deactivate users assigned to deactivated contacts: If selected, then when an existing customer account contact is no longer imported and deactivated, if their is a user linked to the contact, then the user will also become deactivated.

Improvements

TOT-4201 - Remember user's preference for sorting products within product listing content managed web page areas

On a content managed web page that contains a Product Search Results Listing, Category Listing, Related Products Listing, Product Combination or Customer Account Contract Detail area, there is the ability sort the products listed in the area, based on a user's preference previously remembered in their browser using a cookie. This allows users to load lists of these products using their preferred product sorting field and direction if allowed to, providing improved usability by not having re-sort products on each web page load.

Within the Administration Centre, within the Websites interface, upon modifying a content managed web page within the Web Page Editor, for each area, in the area settings a new drop down setting has been added labelled "Allow User Sort Products Preference". If set to Yes, then the products listed in the area are allowed to be sorted based on the user's previously saved preference. If set to No, then area will sort the products based on the sorting setting of the area if available, else based on the default product sorting setting for the project or area.

Within the Product Search Results Listing, Category Listing areas, if the user has the ability to change the sorting field or direction and the areas have the "Allow User Sort Products Preference".area setting set to Yes, then the user's sorting preference will be saved to a browser cookie, that can then be used by the other product listing areas to sort the products if allowed to.

Note that the user's product sorting preference is stored in a user's browser cookie. If they are using a private/incognito web browser, or clear their browser cookies, then the saved sorting preference will be cleared.

Functionality Affected: Product Search Results Listing, Category Listing, Related Products Listing, Product Combination or Customer Account Contract Detail content managed web page areas
Impact: Normal

TOT-4241 - Ability to remove and exclude deals from product in the basket within a Basket Product Listing content managed web page area

On a content managed web page that contains a Basket Product Listing area, for each product record listed in the area, there is now the capability to allow users to remove a product deal from a product in their active basket. This may be needed if a user doesn't wish to receive the deal. It can also be relevant for sales representative users who don't want a deal to override pricing they have set for product.

Within the Basket Product Listing content managed webpage area, within the Basket Product Record format, the format now contains a new hook called "remove_product_deal_onclick" that can be embedded within a button's onclick attribute, to allow a deal to be removed from a product if the deal was previously applied.

Once the deal has been removed from the product in the basket the product will be repriced, reverting back to standard pricing of the product. Additionally all remaining products in the basket will have deals re-calculated, since deals on other products may be conditional on the deal previously applied to the product that's now removed. If the product had no pricing set, then if the deal is removed, it will cause the product to also be removed from the deal.

For the product in the basket that had the deal removed, it will remain not allowing deals to be applied against it automatically until the product has been removed from the basket, either by being directly deleted or removed on order submission. This ensures that if the user changes the quantity or price of the product in the basket, then no deal will cause the pricing changes to be overwritten.

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

TOT-4283 - Facility Role Permission to ignore changing sales representative set basket product prices if Re-price Basket Products On Login, Basket Switching And Order Checkout feature is turned on

if the "Re-price Basket Products On Login, Basket Switching And Order Checkout" setting is turned on within the Administration Centre's Basket Store Settings interface that re-prices all products within the user's basket when they next login, switch baskets, or proceed to order checkout, if a sales representative user had changed the price of any products in their basket, then there is now a Facility Role Permission that allows the sales representative users to have their set prices to be ignored from being re-priced. This permission ensures that targeted sales representative users don't lose the customised pricing that they have set within their active basket if the re-pricing feature is turned on.

Within the Administration Centre, under the Users menu, within the User Permissions interface, after selecting a Facility Role and clicking on the Edit button, within the Role Permissions section a new permission has been added labelled "Re-Price Sales Rep Set Product Pricing". If set to Allow then any users assigned to the Facility Role will have all product pricing in their active basket re-priced if within the Stores menu, Basket Settings interface the "Re-price Basket Products On Login, Basket Switching And Order Checkout" setting is set to Yes. If the "Re-Price Sales Rep Set Product Pricing" permission is set to Deny then any prices for products in the user's active basket that were set by a sales representative user will not be re-priced if the repricing setting is set to Yes.

Functionality Affected: Basket Clean server action
Impact: Normal

TOT-4284 - Display customer account assigned price-level price within Product Detail and product listing types of content managed web page areas

On a content managed web page containing a Product Detail area, or areas that display a list of products (Product Search Results Listing, Category Listing, User Details/Favourites/Orders, Customer Account Contract Detail, Related Products, Model Products), there is now the ability to display the price-level price of the product, based on the price-level that the user's active customer account current is assigned to. This price-level pricing is only display if the customer account's assigned price-level price is less than the final price calculated for the user, and if the user's assigned Facility Permission Role has a new permission named "View Product Price-Level Price" set to Allow .Additionally within each area there is also the ability to display the discount percentage between the account's price-level price, and its final price. This allows users to be aware when a product's price has been discounted from the price-level price, and by how much. This price-level pricing data could be labelled as "Was/Now" pricing, or "Discounted From" or "Reduced From", amount other discounting terms.

Within the Administration Centre, under the Users menu, within the User Permissions interface, when editing a Facility Role, the permission named "View Product Price-Level Price" now exists. If set to Allow then any users assigned to the facility role are allowed to view a product's price-level price for the price-level their active customer account being used is assigned to, when the price-level price is higher than the final product price. If the permission is set to Deny then the assigned users are never allowed to see the current price-level price of a product.

Within the Websites Administration Centre, under the Websites menu, within the Websites interface, within the Web Area Formats Libraries, navigating to the Product Detail area, or Product Search Results Listing, Category Listing, User Details/Favourites/Orders, Customer Account Contract Detail, Related Products, Model Products areas, for the formats named "Product Detail", "Product Search Record", "Product Search Record2", "Product Search Record3", the following format hooks now exist that allow price-level pricing data to be embedded into the areas if the user has permission to view product price-level price data.

• product_price_level_price_inc: Displays the price-level unit price (including tax) of the product initially shown in the area, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_ex: Displays the price-level unit price (excluding tax) of the product initially shown in the area, based on the price-level that is associated the active customer account of the user.
• product_price_level_price: Displays the price-level unit price (either excluding or including tax based on user setting) of the product initially shown in the area, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_inc_currency: Displays the price-level unit price (including tax) of the product initially shown in the area in the project''s default currency, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_ex_currency: Displays the price-level unit price (excluding tax) of the product initially shown in the area in the project''s default currency, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_currency: Displays the price-level unit price (either excluding or including tax based on user setting) of the product initially shown in the area in the project''s default currency, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_discount_rate: Displays the percentage difference between the price-level unit price of the product and the final account price found for the product, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_discount_ex: Displays the price difference (excluding tax) between the price-level unit price of the product and the final account price found for the product, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_discount_inc: Displays the price difference (including tax) between the price-level unit price of the product and the final account price found for the product, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_discount: Displays the price difference (either excluding or including tax based on user setting) between the price-level unit price of the product and the final account price found for the product, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_discount_ex_currency: Displays the price difference (excluding tax) between the price-level unit price of the product and the final account price found for the product in the project''s default currency, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_discount_inc_currency: Displays the price difference (including tax) between the price-level unit price of the product and the final account price found for the product in the project''s default currency, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_discount_currency: Displays the price difference (either excluding or including tax based on user setting) between the price-level unit price of the product and the final account price found for the product in the project''s default currency, based on the price-level that is associated the active customer account of the user.
• product_price_level_price_inc_element_id: ID of the element that displays the price-level unit price (including tax) of the product, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_ex_element_id: ID of the element that displays the price-level unit price (excluding tax) of the product, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_element_id: ID of the element that displays the price-level unit price (either excluding or including tax based on user setting) of the product, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_inc_currency_element_id: ID of the element that displays the price-level unit price (including tax) of the product in the project''s default currency, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_ex_currency_element_id: ID of the element that displays the price-level unit price (excluding tax) of the product in the project''s default currency, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_currency_element_id: ID of the element that displays the price-level unit price (either excluding or including tax based on user setting) of the product in the project''s default currency, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_discount_rate_element_id: ID of the element that displays the percentage difference between the price-level unit price of the product and the final account price found for the product, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the percentage to update when required.
• product_price_level_price_discount_amount_ex_element_id: ID of the element that displays the price difference (excluding tax) between the price-level unit price of the product and the final account price found for the product, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_discount_amount_inc_element_id: ID of the element that displays the price difference (including tax) between the price-level unit price of the product and the final account price found for the product, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_discount_amount_element_id: ID of the element that displays the price difference (either excluding or including tax based on user setting) between the price-level unit price of the product and the final account price found for the product, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_discount_amount_ex_currency_element_id: ID of the element that displays the price difference (excluding tax) between the price-level unit price of the product and the final account price found for the product in the project''s default currency, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_discount_amount_inc_currency_element_id: ID of the element that displays the price difference (including tax) between the price-level unit price of the product and the final account price found for the product in the project''s default currency, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_discount_amount_currency_element_id: ID of the element that displays the price difference (either excluding or including tax based on user setting) between the price-level unit price of the product and the final account price found for the product in the project''s default currency, based on the price-level that is associated the active customer account of the user. Set hook within the ID element, to allow the price to update when required.
• product_price_level_price_display_id: ID of the element that displays if the user has permission to view the price-level price of a product, based on the price-level assigned to the active customer account the user. Set hook within the ID element, to allow the element to hide or show when required.
• product_price_level_price_display_class: Name of the styling class that initially displays if the user has permission to view the price-level price of a product, based on the price-level assigned to the active customer account the user. Set hook within the class attribute of an element. Displays either product_price_level_price_show or product_price_level_price_hide

TOT-4292 - Customise styling of area overlay masks within content managed web page areas

On a content managed web page that contains any areas, when an area's content is being reloaded or updated and a mask overlays the area's content, there is now the ability to customise how an area's mask looks, and the font it uses globally across all areas.

Within the Administration Centre, under the Websites menu, within the Websites interface, after clicking on the domain of a website, within the Web Site Details interface the following settings have been added:

• Web Page Area Loading Mask Custom Styling Class: Set the name of a CSS styling class, that will be embedded within the area mask. This CSS class can then have styling applied to it within a CSS file to control the look of the mask.
• Web Page Area Loading Mask Text Font Style: Set a CSS styling rule that controls the font used for the text that displays in the mask.
• Web Page Area Loading Mask Text Font Colour Style: Set a colour that controls the background colour of mask. The colour can be a hexidecimal, RGB, or color name value.

TOT-4293 - Format hook to show ID of a Basket Product Field Value within the Order Confirmation Email

Within the Administration Centre, under the Stores menu, within the Checkout settings interface, for the Order Confirmation Email Order Detail Product Field Format setting, it now contains a format hook named "order_product_field_id" that allows the ID to be set against each Basket Product Field Value.

Functionality Affected: Order Confirmation Notification Email
Impact: Major

TOT-4294 - Block scrapers that identify as GeedoProductSearch, Semrush, Nutch, Barkrowler, ClaudeBot, Orbbot, Anthropic-ai, ChatGPT-User, FriendlyCrawler, GPTBot, Image2dataset, ImagesiftBot, Omgilibot,CensysInspect, Expanse, internet-measurement, Telegra

Website traffic for content managed websites that utilise the TOTECS Ecommerce Platform's crawler block list will now block allowing requests from scrapers who identify with the following user-agents GeedoProductSearch, Semrush, Nutch, Barkrowler, ClaudeBot, Orbbot, Anthropic-ai, ChatGPT-User, FriendlyCrawler, GPTBot, Image2dataset, ImagesiftBot, Omgilibot,CensysInspect, Expanse, internet-measurement, Dataprovider, Dalvik, Go-http-client, IonCrawl, ISSCyberRiskCrawler,wp_is_mobile, babbar.tech

This reduces unwanted website traffic, leading to less traffic cost, and less public website data being harnessed by 3rd party companies for their own purposes.

Functionality Affected: Content managed websites
Impact: Normal

TOT-4296 - Remember selected invoices after pagination occurs within the Customer Account Invoice Listing content managed web page area

After a user has logged into a content managed website, on a content managed web page containing a Customer Account Invoice Listing content managed web page area. if the area displays more than one page of invoice records, and the user has the ability to select invoices to pay for using the checkbox form elements, then if the user pages to another page of invoice records and back again, then the invoice records that were previously selected will now show selected check boxes and selected invoice amount. This allow users to pay for selected invoices found across multiple pages of records.

Additionally If the invoices records are filtered on any search filters (including date ranges) then any invoice records previously selected will remain selected when the invoice listing is reloaded. This ensures users can find, and build up a list of selected invoices across multiple searches, avoiding having to make multiple payments.

There is also the ability to display a button in the area, allowing all selected invoice records to be deselected. This can be helpful for users if they wish to deselect all records, by doing so with one click instead of having to find every selected record.

Within the Customer Account Invoice Listing content managed web page area, its Customer Account Invoice Listing format has had one new format hook added:

• invoices_unselect_all_onclick: Javascript function that unselects all invoices in the area, unselecting each selection checkbox for each invoice record.

TOT-4300 - Embed ReCaptcha within the User Registration content managed web page area

On a content managed web page that contains a User Registration area, within the area's User Registration Form format, there is now the ability to embed a Recaptcha form element, that is used to help prevent non-humans from being able register a new user. This can help protect against malicious automated software being able to register new users, by forcing the guest user to correctly identify themselves as a human, based on selecting Recaptcha's checkbox, then answer the Recaptcha question if required (such as selecting images that contain certain objects).

The area uses the existing Recaptcha account and settings set up within Administration Centre's Website Settings interface to allow the Recaptcha to load. Within the Users menu, in the User Registration Profiles interface, under the Mandatory Registration Fields section, a new setting labelled "Enforce ReCaptcha" has been added. If selected, then it requires a Recaptcha element to be embedded within the User Registration area, and will be checked that the user correctly answers the Recaptcha. If not then in the Validation Error Message setting a customised message can be set that the user will see if they don't correctly answer the Recaptcha.

Within the Administration Centre's Websites interface, for a website, under the Web Area Format Libraries, within the User Registration area's User Registration Form format, a new format hook labelled "user_registration_recaptcha". This will display a reCAPTCHA form element that the user must fill out to prove that they are a human when registering a new user. The format hook will only display a Recaptcha form field in the User Registration Profile area if the user registration profile controlling the area has the "Enforce ReCaptcha" field set to Mandatory, and the setting within within the Website Settings intefrace named "ReCAPTCHA Site Key" has been previously set up.

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

TOT-4302 - Filter Monthly Project Traffic statistics to a single day within the Project Traffic Statistics Administration Centre interface

After an administrator user logs into the Administration Centre, after clicking on the Statistics menu, within the Project Traffic Statistics interface, under the Monthly Project Traffic section, there is the ability to filter and show statistics for a single day. This additional level of daily dynamic server requests allows administrators to see more fine grain detail of traffic that occurring within the project. This may help see patterns of peak website traffic usage over each day day, or help investigate increased traffic from a user, or geographic location in a single day.

A new drop down now appears next to the Refresh button with the initial option "For Whole Month". If that drop down is changed to a selected day of the month, then the Monthly Requests graph will change to show the number of server requests made for the single selected day, broken down to an hourly basis. The pie charts for "Requests By Search Engines, Crawlers and Software ", "Requests By Device Type", and "Requests By Platform Type" will update to show totals only for the selected day. If the "Export", "View Most Requests By IP Address" or "View Most Requests By Users" buttons are pressed on, the corresponding statistics shown will also cover only the selected day.

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

Bug Fixes

TOT-4295 - Removal of vulnerabilities within News/Blog Listing content managed web page areas

Within content managed webpage containing News/Blog Listing, News/Blog Items, and News/Blog Item Crumbs areas vulnerabilities have been removed so that nefarious 3rd parties cannot indirectly access that underlying database and try obtain data they do not have permission to access.

Functionality Affected: News/Blog Listing, News/Blog Items, and News/Blog Item Crumbs content managed web page areas
Impact: Normal

TOT-4298 - Removal of vulnerability within the Order Detail Administration Centre interface

Within Administration Centre cross-site scripting vulnerability was found and has been removed within the Order Detail Admnistration Centre interface that previously allowed well crafted javsacript code to execute if embedded within the Order Instructions field. This vulnerability has been removed to prevent nefarious 3rd parties exploit and gaining access to Administration Centre content without knowledge or consent.

Functionality Affected: Order Detail Administration Centre interface
Impact: Normal

TOT-4306 - Unable to create new news/blog item from within the News Item Form content managed web page area

On a content managed web page containing a News Item Form area, for a logged in user if they had typed in the heading and body of the new news item/blog, then clicked the Create button, then news/blog item would not able to be created as expected.
This issue was caused by a issue with the new version of the web server software that has now been fixed to allow new news/blog items to be created.

Functionality Affected: News Item Form content managed web page area
Impact: Normal

New Features

TOT-4290 - Send out email notification when daily overall project server traffic amount exceeds a specified threshold

There is now the ability to send out a notification email when the overall daily amount of server traffic across a project's websites exceeds a specified number of dynamic server requests. This allows administrators of a project to be aware when a larger amount of traffic is accessing their websites. This then allows administrators to then check that the traffic they are receiving is expected, or if not raise awareness of the unwanted traffic.

Within the Administration Centre, under the Stores menu, within the General store settings interface a new setting has been added labelled "Send Email Notification Server Traffic Exceeds Daily Request Count". For the setting if it is set to a positive number, then each night a check will be made to see if the total number of dynamic server requests made across the project's websites for the previous day exceeds the number specified. If number of requests exceeds the threshold then an notification email advising of the larger amount of traffic will be sent to the email address set within the Organisation settings tab, in the Admin Email setting.

Functionality Affected:  General Stores Settings administration centre interface
Impact: Normal

Improvements

TOT-4199 - Format hooks to allow users to update the name and description of baskets within a Basket Selection content managed webpage area

On a content managed web page containing a Basket Selection content managed web page area, for each basket record displayed within the area, there is now the ability to update the name or description of each basket listed. The capability is only available if the user is set as a sales representative, and they are assigned to a facility permission role that has the "View All Customer Accounts" or "View Sales Representative Briefcase section" permissions set to allow, and the user created the basket.

Within the Basket Selection content managed web page area, the Basket Selection Record area format the following format hooks have been added to allow a user to update the name, and/or description of a basket:

• update_basket_detail_onclick: javascript function that calls for the details of the basket to be updated.
• basket_record_name_input_id: ID of the HTML element that is a textbox input containing the name of the basket,displays allowing it be updated. Place inside the ID attribute of a text form input.
• basket_record_description_input_id: ID of the HTML element that is a textbox input containing the name of the basket,displays allowing it be updated. Place inside the ID attribute of a textarea or textbox form input.
• basket_record_allow_update_basket: Indicates if the user is allowed to change the details of the basket. Displays either Y or N

TOT-4272 - Show list of most project server requests by IP address or user Login ID within the Project Traffic Statistics Admin Centre interface

Within the Administration Centre, from the Statistics menu, within the Project Traffic Statistics interface, under the Monthly Project Traffic section, after the traffic has loaded in the section, a buttons labelled "View Most Requests By IP Address" now appears. When clicked on it will show a dialog and load statistics showing the top 500 most requests made by public IP address for the specified month. This can then be used to determine if the traffic is coming from legitimate users or not, or see where traffic is originating the most from. For each statistics record it will display the public IP address where the traffic originated, the total number of requests coming from the IP address, and a button labelled "Find Geographic Location". If the button is clicked on then it will open a browser tab to an external website that can look up the IP address and attempt to report the geographic location that is tied to the IP address. This may provide more information of the originator of the requester. Note IP addresses can be re-used and geographic location reported may not be true location of the requester.

Additionally within the Monthly Project Traffic section, after the traffic has loaded in the section, a buttons labelled "View Most Requests By User" now appears. When clicked on it will show a dialog and load statistics showing the most requests made by user Login ID for the specified month. This can then be used to determine the guest and logged in users who are generating the most server requests. For each statistics record it will display the user's Login ID, the total number of requests made by the user.

In both dialogs the statistics will be filtered based on the previous monthly search made. For example if requests have been filtered by a specific search engine, then the IP addresses reported will only show that match the search engine specified.

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

TOT-4285 - User Password, Login ID and Security Answer form field validation messages after key press within User Registration and User Details/Favourites/Orders content managed webpage areas

On a content managed web page that contains either User Registration area, when a user types values in the User Password, Login ID and Security Answer form fields, or within User Details/Favourites/Orders area enters a value in the New User Password and Security Answer form fields, there is now the ability to show to the user messaging or tailored content if the form fields do/do not pass the required form validation.

For passwords it can show if the password strength being entered is strong or not enough and contains the required length, numeric, special, upper and lower case characters, as controlled within the Administration Centre's User Settings. For Login ID and Security Answer form fields validation messages/content can be shown that the minimum number of characters has been entered. This additional form validation shown to the user can make it is easier for the user to understand the values required to be entered before submitting the form.

Within the User Registration content managed web page area's User Registration Form format the following hooks have been added:

• password_new_validation_strength_element_id: ID of the HTML element that displays the current strength of the new password being entered. Set hook within the ID attribute of an element that has its class updated to show the current strength.
• password_new_validation_strength_class_name: Initial class name to indicate the password strength of the new password field value being set.
• password_new_char_count_valid_element_id: ID of the HTML element that indicates if the new password being set has minimum number of characters. Set hook within the ID attribute of an element that has its class updated to show if the password has the required length.
• password_new_char_count_min_length: Number that indicates the minimum number of characters required to be set for the new password.
• password_new_char_count_valid_class_name: Initial class name to indicate if the new password has the minimum number of characters in the new password.
• password_new_number_char_count_valid_element_id: ID of the HTML element that indicates if the new password being set has minimum number of numeric characters within it. Set hook within the ID attribute of an element that has its class updated to show if the password has the required numeric characters.
• password_new_number_char_count_min_length: Number that indicates the minimum number of numeric characters required to be set for the new password.
• password_new_number_char_count_valid_class_name: Initial class name to indicate if the new password has the minimum number of numeric characters in the new password.
• password_new_special_char_count_valid_element_id: ID of the HTML element that indicates if the new password being set has minimum number of special characters within it. Set hook within the ID attribute of an element that has its class updated to show if the password has the required special characters.
• password_new_special_char_count_min_length: Number that indicates the minimum number of special characters required to be set for the new password.
• password_new_special_char_count_valid_class_name: Initial class name to indicate if the new password has the minimum number of special characters in the new password.
• password_new_upper_case_char_count_valid_element_id: ID of the HTML element that indicates if the new password being set has minimum number of upper case characters within it. Set hook within the ID attribute of an element that has its class updated to show if the password has the required upper case characters.
• password_new_upper_case_char_count_min_length: Number that indicates the minimum number of upper case characters required to be set for the new password.
• password_new_upper_case_char_count_valid_class_name: Initial class name to indicate if the new password has the minimum number of upper case characters in the new password.
• password_new_lower_case_char_count_valid_element_id: ID of the HTML element that indicates if the new password being set has minimum number of lower case characters within it. Set hook within the ID attribute of an element that has its class updated to show if the password has the required lower case characters.
• password_new_lower_case_char_count_min_length: Number that indicates the minimum number of lower case characters required to be set for the new password.
• password_new_lower_case_char_count_valid_class_name: Initial class name to indicate if the new password has the minimum number of lower case characters in the new password.
• security_answer_char_count_valid_element_id: ID of the HTML element that indicates if the new security answer being set has minimum number of characters set. Set hook within the ID attribute of an element that has its class updated to show if the new security answer has the required number of characters.
• security_answer_char_count_min_length: Number that indicates the minimum number of characters required to be set for the new security answer.
• security_answer_char_count_valid_class_name: Initial class name to indicate if the new security answer has the minimum number of characters required.

TOT-4287 - Product pack pricing format hooks always display pack pricing within the Product Detail content managed web page area

On a content managed web page area containing a Product Detail area, if the area is displaying a product that contains a pack quantity greater than 1, then currently if the project's "Show Total Pack Price For Products" setting is set to OFF, then within the area's pack pricing format hooks will now always display the product's individual pack pricing.
This ensures that the setting has no bearing of pack pricing behaviour displayed in Product Search Results Listing, Category Listing, and other product listing areas for pack pricing displayed in Product Detail areas.

Functionality Affected:  Product Detail content managed webpage area
Impact: Normal

TOT-4288 - Upgrade Jquery library to version 3.7.1 for Image Viewer and Bulk File Uploader within the Administration Centre interface

On a content managed web page containing a Product Detail area that uses the Image Viewer, or within the Administration Centre, within the Product Images Import, Category Images Import, and Website Library Detail interfaces, for the image viewer and file uploader components, they both depend on using the Jquery library. The version of this library has been updated to version 3.7.1, that provides additional security and latest browser support, whilst dropping outdated browser support, as documented by Jquery in its version history.

Functionality Affected:  Product Detail content managed webpage area, Image viewer, Product Images Import, Category Images Import, and Website Library Detail administration centre interfaces
Impact: Normal

TOT-4289 - 2 Factor Authentication for users updating details, password or security question within the User Details/Favourites/Orders content managed web page area

After a user has logged into a content managed website, within a webpage containing a User Details/Favourites/Orders area, if a user wants to update their details, password, or security question and answer, there is the ability to force the user to verify that they are legitimate by sending a verification code to the email address associated to their user account. Once the verification code has been obtained from the email, then there is the ability to type the verification code back into the area, that allows the details, password or security question and answer to be updated if the correct verification code has been given. This protects against a security vulnerability, where if the user's session has been taken by a bad actor, the bad actor does not have the ability to change the user's password or security questions to lock out the legitimate user from logging in, unless the bad actor also has access to the email account as well. Note this 2 factor authentication is only be applicable if the user has email address set against their user account.

Within the Administration Centre, under the Users menu within the User Permissions interface, when viewing a Facility Permission Role, a new permission named "Use 2 Factor Authentication For User Details/Password Change" has been added. If set to Allow then any users assigned to the facility role will be required to send a verification code to their email address, if they try to update their user details, password, or security question and answer. By default this setting is set to Deny.

Within the User Details/Favourites/Orders content managed web page area, the User Detail format has had additional format hooks added to it to allow a Verification Code section to be added in 3 places for the Change User Details, Change Password, and Change Security Question and Answers features. Included in these verification hooks is the ability to hide or show the verification code sections based on if the user has permission to use 2 factor authentication. It also includes hooks that can be used to embed a button to trigger a User Verification Code to be emailed, then a textbox input hook where the verification code can be entered. A new format has been added to the area labelled "User 2 Factor Verification Code Email" that allows the User Verification Code email to have its message contents customised.

It is important to have the User Detail and User 2 Factor Verification Code Email formats correctly configured within the User Details/Favourites/Orders content managed web page area before turning on the "Use 2 Factor Authentication For User Details/Password Change" facility role permission, otherwise users won't have the ability to send out a verification code, or enter the code to allow their details to be updated.

Within the User Details content managed web page area format has had the following format hooks added:

• user_detail_verification_code_input: HTML element that displays a textbox input used to provide a verification code needed to update user details
• user_detail_send_verification_code_onclick: javascript function to trigger sending a verification code that confirms the user and is used to update the user details.
• user_detail_save_element_id: ID of the HTML element to set within the ID attribute of an element used to hide or show elements to trigger updating the user details.
• user_detail_save_class_name: Name of the css class that controls if elements that show or not to update user details can be saved or not. Displays either user_detail_save_Y or user_detail_save_Y
• user_detail_show_verification_code_show: Displays either Y or N, based on if the user is required to send and input a verification code before being able to update user details.
• password_new_verification_code_input: HTML element that displays a textbox input used to provide a verification code needed to change the user password.
• password_new_send_verification_code_onclick: javascript function to trigger sending a verification code that confirms the user and is used to change the user password.
• password_new_save_element_id: ID of the HTML element to set within the ID attribute of an element used to hide or show elements to trigger changing the user password.
• password_new_save_class_name: Name of the css class that controls if elements that show or not to change the user password. Displays either user_detail_save_Y or user_detail_save_Y'
• password_new_verification_code_show: Displays either Y or N, based on if the user is required to send and input a verification code before being able to change the user password.
• security_answer_verification_code_input: HTML element that displays a textbox input used to provide a verification code needed to change the user security question and answer.
• security_answer_send_verification_code_onclick: javascript function to trigger sending a verification code that confirms the user and is used to change the security question and answer.
• security_answer_save_element_id: ID of the HTML element to set within the ID attribute of an element used to hide or show elements to trigger changing the security question and answer.
• security_answer_save_class_name: Name of the css class that controls if elements that show or not to change the security question and answer. Displays either user_detail_save_Y or user_detail_save_Y.
• security_answer_show_verification_code_show: Displays either Y or N, based on if the user is required to send and input a verification code before being able to change the security question and answer.

• user_verification_code: Verification Code that allows the user authorise changes to their user account.
• website_domain', 'Protocol and domain of the website where the user verification code was triggered to be sent from.

Bug Fixes

TOT-4281 - Website domain of content managed website incorrectly being replaced with [INVALID_FORM_VAR] within News/Blog Item Body field when Update button in Website Details administration centre interface is clicked on

After a user logged into the Administration Centre, then clicked on the Websites menu button, then the Websites menu item, within the Websites interface if they clicked on the domain of a content managed website, then within the Website Details interface if they clicked the Update Site button, it would incorrectly replace the domain of the website with [INVALID FORM VAR], instead of correctly replacing with the currency domain saved for the website.
Now within the Website Details interface if they click the Update Site button, it will now correctly replace the domain of the website with the latest domain saved for the website. This issue was caused by a programming error back in TOT-3594.

Functionality Affected: Website Detail administration centre interface
Impact: Normal

TOT-4286 - Settings fail to reload after being changed within the Area Settings dialog of the Enquiry Form content managed web page area within the Web Page Editor administration centre interface

After a user logged into the Administration Centre, clicked on the Websites menu button, then clicked the Websites menu item, from within the Websites interface, if they right clicked on a web page that contained an Enquiry Form area, then within the Web Page Editor, if the area's name is clicked to view its Settings dialog. If a enquiry form element is added, or its ordering is changed, the area settings failed to update. Additionally, when attempting to edit an enquiry form element and press update, the popup showed a processing message and did not close. Additionally javascript console errors appeared when changes were made. Note that all the changes can be seen when the popup is reopened.
Now within the Web Page Editor, if the area's name is clicked to view its Settings dialog. If a enquiry form element is added, edited, removed, ordering changed, or the enquiry form is renamed, the area settings window will correctly reload to show the updated settings. This issue was introduced when the Web Page Editor's All Areas administration centre interface was changed to load over the secure Administration Centre domain.

Functionality Affected: Enquriy Form content managed web page editor
Impact: Minor

Improvements

TOT-4175 - Display total discount deal price amounts on Basket Product Listing, Basket Summary, Order Checkout/Submission, and Guest Order Checkout Submission content managed web page areas

On a content managed web page that displays Basket Product Listing, Basket Summary, Order Checkout/Submission, Guest Order Checkout/Submission, Pending Order Review and Order Print Form areas, there is now the ability to show the total amount of the deal discount pricing that is being saved on the user's basket/order. This can also be set up within the Order Confirmation Notification Email. This price saving/discount amount calculated by totaling the sum of product deal discounts against the original price for each product in the basket/order.
In each of these areas format hooks has been added that allow the discount price to show excluding tax, including tax. Additionally a format hooks have been added to indicate if the total discount price should hide or show based on if the total discount amount is greater than 0. The following hooks have been added to the area formats:

Basket Summary Webpage Area Format Hooks:

• cart_TotalEx_saved: Total price amount of the basket excluding taxes that has been saved, through deals applied to the products in the basket.
• cart_TotalTax_saved: Total tax price amount of the basket that has been saved, through deals applied to the products in the basket.
• cart_TotalInc_saved: Total price amount of the basket including taxes that has been saved, through deals applied to the products in the basket.
• cart_TotalPrice_saved: Total price amount (excluding or including taxes based on user''s price format setting) of the basket that has been saved, through deals applied to the products in the basket.
• cart_total_has_savings_applied_class_name: displays either the styling class name basket_has_price_savings or basket_has_no_price_savings, based on if the basket contains deal applied causing total basket price savings.
• cart_total_has_savings_applied_element_id: Set within the ID attribute of an element to allow its class name to be updated when the basket contains deal applied causing total basket price savings. Use with the cart_view_has_savings_applied_class_name hook.
• cart_TotalEx_saved_ProjectCurrency: Total price amount of the basket excluding taxes that has been saved, through deals applied to the products in the basket. Price is in the currency set for the project.
• cart_TotalTax_saved_ProjectCurrency: Total tax price amount of the basket that has been saved, through deals applied to the products in the basket. Price is in the currency set for the project.
• cart_TotalInc_saved_ProjectCurrency: Total price amount of the basket including taxes that has been saved, through deals applied to the products in the basket. Price is in the currency set for the project.
• cart_TotalPrice_saved_ProjectCurrency: Total price amount (excluding or including taxes based on user''s price format setting) of the basket that has been saved, through deals applied to the products in the basket. Price is in the currency set for the project.

Basket Header and Basket Products Footer Webpage Area Format Hooks:

• cart_view_TotalExSaved: Total price amount of the basket excluding taxes that has been saved, through deals applied to the products in the basket.
• cart_view_TotalTaxSaved', 'Total tax price amount of the basket that has been saved, through deals applied to the products in the basket.
• cart_view_TotalIncSaved: Total price amount of the basket including taxes that has been saved, through deals applied to the products in the basket.
• cart_view_TotalPriceSaved: Total price amount (excluding or including taxes based on user''s price format setting) of the basket that has been saved, through deals applied to the products in the basket.
• cart_view_has_savings_applied_class_name: displays either the styling class name basket_has_price_savings or basket_has_no_price_savings, based on if the basket contains deal applied causing total basket price savings.
• cart_view_has_savings_applied_element_id: Set within the ID attribute of an element to allow its class name to be updated when the basket contains deal applied causing total basket price savings. Use with the cart_view_has_savings_applied_class_name hook.
• cart_view_TotalEx_saved_ProjectCurrency: Total price amount of the basket excluding taxes that has been saved, through deals applied to the products in the basket. Price is in the currency set for the project.
• cart_view_TotalTax_saved_ProjectCurrency: Total tax price amount of the basket that has been saved, through deals applied to the products in the basket. Price is in the currency set for the project.
• cart_view_TotalInc_saved_ProjectCurrency: Total price amount of the basket including taxes that has been saved, through deals applied to the products in the basket. Price is in the currency set for the project.
• cart_view_TotalPrice_saved_ProjectCurrency: Total price amount (excluding or including taxes based on user''s price format setting) of the basket that has been saved, through deals applied to the products in the basket. Price is in the currency set for the project.

Order Review, Pending Order Detail and Order Print Detail Webpage Area Format Hooks:

• _PO_TotalExSaved: Total price amount of the order excluding taxes that has been saved, through deals applied to the products in the order.
• _PO_TotalTaxSaved: Total tax price amount of the order that has been saved, through deals applied to the products in the order.
• _PO_TotalIncSaved: Total price amount of the order including taxes that has been saved, through deals applied to the products in the order.
• _PO_TotalSaved_is_greater_zero: Displays either Y or N. If Y then the amount of deal discounts applied to the order is greater than 0
• _PO_TotalExSaved_decimal: Total price amount of the order excluding taxes that has been saved, through deals applied to the products in the basket. Price always displays as a decimal number.
• _PO_TotalTaxSaved_decimal: Total tax price amount of the order that has been saved, through deals applied to the products in the basket. Price always displays as a decimal number.
• _PO_TotalIncSaved_decimal: Total price amount of the order including taxes that has been saved, through deals applied to the products in the basket. Price always displays as a decimal number.
• _PO_currency_local_TotalEx_saved: Total price amount of the order excluding taxes that has been saved, through deals applied to the products in the order. Price is calculated in the currency set for the user.
• _PO_currency_local_TotalTax_saved: Total tax price amount of the order that has been saved, through deals applied to the products in the order. Price is calculated in the currency set for the user.
• _PO_currency_local_TotalInc_saved: Total price amount of the order including taxes that has been saved, through deals applied to the products in the order. Price is calculated in the currency set for the user.

Order Submission Success, Order Submission Failure and Order Submission Pending Webpage Area Format Hooks:

• order_total_ex_saved: Total price amount of the order excluding taxes that has been saved, through deals applied to the products in the order.
• order_total_tax_saved: Total tax price amount of the order that has been saved, through deals applied to the products in the order.
• order_total_inc_saved: Total price amount of the order including taxes that has been saved, through deals applied to the products in the order.
• order_total_saved_is_greater_zero: Displays either Y or N. If Y then the amount of deal discounts applied to the order is greater than 0

Within the Administration Centre, under the Stores menu, within the Order Settings interface, for the Order Confirmation Email Order Detail Format setting, the following format hooks have been added:

• order_price_total_inc_tax_saved: Total price amount saved/discounted by due to deals applied across all products in the order, inclusive of all taxes.
• order_price_total_ex_tax_saved: Total price amount saved/discounted by due to deals applied across all products in the order, exclusive of all taxes.
• order_price_total_tax_saved: Total tax price amount saved/discounted by due to deals applied across all products in the order.
• order_price_total_saved_is_greater_zero: Either Y or N, if Y then indicates that a price amount has been saved/discounted due to deals applied across all products in the order.

Functionality Affected: Basket Product Listing, Basket Summary, Order Checkout/Submission, Guest Order Checkout/Submission, Pending Order Review and Order Print Form content managed web page areas
Impact: Normal

TOT-4193 - Drop downs to control sorting of products within the Basket Products Listing content managed web page area

On a content managed webpage containing a Basket Products Listing area, within its header and footer formats 2 additional hooks have been added that can display drop downs, allowing the user to select the product field that they can sort the products by in their basket, as well as the direction that the products sorted by. Within the area's Basket Header and Basket Products Footer formats the 2 format hooks have been added:

• basket_products_sort_dropdown: Drop down element that changes the field that products are sorted by
• basket_products_sort_direction_dropdown: Drop down element that changes the direction that products are sorted by.

The default values of the these drop downs is controlled within the Administration Centre, under the Stores menu, within the Basket Settings interface, the Column To Order Basket Products setting controls the product Sorting Field drop down, and the Direction To Order Basket Products setting controls the direction that products are sorted by. Note that these same settings apply to all Basket Product Listing areas.
Functionality Affected: Basket Products Listing content managed web page area
Impact: Normal

TOT-4198 - Format hooks to filter order list by account based orders and date range within the User Details/Favourites/Orders content managed web page area

On a content managed web page containing a User Details/Favourites/Orders content managed web page area, if the area is displaying a list of historic orders previously submitted, there is now the ability to embedded form inputs to filter the orders that display, based on date range, or for orders submitted against the user's assigned account instead of orders submitted by the user (only allowed for sales representative users). Additionally it also now supports pagination to allow the historic order listing to load faster. By default the area will display a maximum of 50 records, but can be changed to display 10, 25, 50 or 100 records per page. Note that existing areas will need to have the area formats modified to allow users to see the pagination options.

Within the User Details/Favourites/Orders content managed web page area, for the Historic Order Products Header and Historic Order Products Footer formats the following hooks can now be embedded to allow for pagination, date filtering, and filtering for orders based on a sales representative users active account:

• order_listing_records_count: The total number of historic orders that were found.
• order_listing_filter_year_drop_down: Anchor tag to click through to the first page of the historic order list.
• order_listing_filter_month_drop_down: Anchor tag to click through to the last page of the historic order list.
• order_listing_show_assigned_orders_by_drop_down: Anchor tag to click through to the first page of the historic order list.
• order_listing_page_number: Number of the page currently showing historic order list.
• order_listing_page_list: List of page numbers allowing the user to paginate between pages of historic order records.
• order_listing_next_page_class: Suffix CSS class text that specifies if the user can paginate forward any further
• order_listing_prev_page_class: Suffix CSS class text that specifies if the user can paginate backwards any further
• order_listing_next_page_anchor: Anchor element that allows the user to paginate to the next page of historic orders
• order_listing_prev_page_anchor: Anchor element that allows the user to paginate to the previous page of historic orders
• order_listing_records_per_page_dropdown: Drop down that allows the user to change the amount of historic orders displayed per page.

Functionality Affected: User Details/Favourites/Orders content managed web page area
Impact: Normal

TOT-4233 - Display product Brand and Supplier and fields within a Basket Product Listing content managed web page area

On a content managed web page containing a Basket Product Listing area 2 new format hooks have been added to the Basket Product Record format to be able to display the Brand and Supplier fields stored for each product listed in the area. The new format hooks for the Basket Product Record area format are:

• _B_Brand: Name of the brand set against the product that is in the basket.
• _B_Supplier: Name of the supplier who is the primary supplier of the product that is in the basket.

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

TOT-4234 - Copy products from user's guest basket to their initial active basket when a user logs in

On a content managed website, if a guest user adds products to their basket then decides to login, After they have successfully logged in there now the ability to copy the products from their guest basket, into their current active basket. The products being copied across from the guest basket will only be added to the user's current basket if they are not a Sales Representative user, and the user has permission to add the guest basket products to their active basket. and the products can be re-priced.

A project setting has been created that controls if products should be added from the guest basket across to a user's basket at login. Note that this may cause logins to take longer to load, especially if the user has many products in their basket that need to be copied across to their active basket. Also note that any deals applied to products in the guest basket, will be not be applied when the products are copied to the user's active basket.

Within the Administration Centre, under the Stores menu, within the Basket Settings interface, a setting labelled "Copy Products From Guest Basket On Login". If set to Yes then allows a non-sales representative user to have any products in their guest basket copied into their active basket during login. Else if this setting is set to No then copying process will be ignored.

Functionality Affected: User Login
Impact: Normal

TOT-4243 - Support for Google Analytics 4 reporting within Order Checkout/Submission and Guest Order Checkout/Submission content managed web page areas

On a content managed web page that displays either an Order Checkout/Submission, or Guest Order Checkout/Submission area, if the the area has reporting turned on to send confirmed orders to Google's Analytics service through its Google Tag Manager service, the order data now provided conforms to the Google Analytics 4 service's Ecommerce "purchase" transaction type.

This change drops support for ordering data conforming to the Universal Analytics service since Google is no longer provides support for its Universal Analytics service. For the order data to correctly be handled within Google Tag Manager, the tag that is handling the transferring the data needs to have its Tag Type set to "Google Analytics: GA4 Event" and the tag will need to have its Configuration Tag setting linked to another tag that has its Tag Type set to "Google Analytics: GA4 Configuration". The "Google Analytics: GA4 Configuration" tag will need to have its Measurment ID property set to the Google Analytics 4 account's Data Stream for where the order statistics are to be logged against.

Functionality Affected: Order Checkout/Submission, or Guest Order Checkout/Submission content managed web page areas
Impact: Normal

TOT-4246 - Customise labels of credit card types displayed within credit card payment forms within Order Checkout/Submission and Customer Account Invoice Payment Form content managed web page areas

On a content managed web page that contains either Order Checkout/Submission, Guest Order Checkout/Submission or Customer Account Invoice Payment Form areas, when a credit card payment form is displayed within the areas, within the Credit Card Types drop down, for each of the card type option the option labels are now able to be able to be customised. Additionally within the Administration Centre, under the Stores menu, within the Payments interface, in the Make A Payment tab, for the Credit Card Type drop down, the labels of the card options can also customised with the same label settings.

Within the Administration Centre, under the Stores menu, within the Payment Settings interface, under the Credit Card section, the following 3 settings have been added to control labels of the support card types:

• Credit Card Type Label - American Express
• Credit Card Type Label - Mastercard
• Credit Card Type Label - Visa

These 3 settings are used across all credit card payment forms for a single project within the TOTECS Ecommerce platform to customise the labelling of each card type.

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission, Customer Account Invoice Payment Form content managed web page areas
Impact: Minor

TOT-4254 - Add User Search Rule to find users with products now back in stock in a given number of hours, are assigned to a specified marketing category, and have products with a stock quantity over a given amount

Within the Administration Centre, a new user search rule has been added that can find active users assigned to specified subscription category, that have products in their favourites list that are back in stock within a given number of hours, and have products with a stock quantity over/below/equal to/not equal to a given amount.

After a user logs into the Administration Centre, after clicking on the Users menu button, then the Search Users menu item, within the Search Users interface, under the Advanced Search section, in the Search Category drop down selecting the Marketing option, then within the Search Rule drop down a new rule has been added labelled "Select active users assigned to subscription category name equal to %value1% with favourite products back in stock in last %value2% hours with stock quantity %equaling% %value3%". The search needs to have the following inputs set:

1. Value1 textbox needs to have the exact name of the User Subscription Category that is to be match on, that targets the users assigned to the specified category
2. Value2 textbox needs to have number defining the maximum number of hours back to find products that have had a "Stock Available Since Date" store a date within that matches within the hours set.
3. Value3 textbox needs to have a number indicate the product Stock quantity to compare against and match onEqualing drop down needs to be set to a value that is used to control how the value of product Stock value should be compared against the value 3 given.

Once all these values have been set then the rule can be used to find users assigned to the specified User Subscription Category that have products in their favourites that have the Stock amount required, and the Stock Available Since Date set to a date that fits with the number of hours aloud. This can be used within both the Search Users interface, as well as using the rule for Marketing User Groups. This in turn can target users to receiving back-in-stock email notifications using the existing Emedia Emails marketing feature.

Functionality Affected:  Seach Users administration centre interface
Impact: Minor

TOT-4256 - Create hooks in Order Confirmation Email Order Detail Format setting that display Location ID, Code and Name in Order Confirmation Notification Emails

When an order is submitted from within a content managed website or Trade interface and a Order Confirmation Notification email is sent out, or if the email sent out by an administrator users from within the Orders Administration Centre interface, there is now the ability to include the order's assigned location's name and code within the notification email's attached content.

Within the Administration Centre, from the Stores menu, within the Order Store Settings interface, for the Order Confirmation Email Order Detail Format, it now defines the following hooks that can embed different information about the location assigned to the order:

• order_location_id: Unique ID of the location assigned to the order. If no location is assigned to the order then the ID will be empty.
• order_location_code: Code of the location assigned to the order, that allows it to be identified by humans. If no location is assigned to the order then the code will display null.
• order_location_name: Name of the location assigned to the order. If no location is assigned to the order then the name will display null.
• order_location_display: CSS styling rule that indicates if location data should display, based on if a location is assigned to an order or not. If no warehouse is assigned then this will output display: none

Functionality Affected:  Order Confirmation Notification email
Impact: Normal

TOT-4261 - Copy across customer account pricing to parent combination products when Automatically Calculate Combination Product Prices is turned on and runs

Within the Administration Centre, under the Inventory menu, within the Product Settings interface, if the "Automatically Calculate Combination Product Prices" setting is set to Yes, then when a Product Pricing Connector or Text File data import is run, there is now the ability to additionally copy across customer account pricing of default products in a combination to active and visible parent combination products for unit pricing. Additionally before copying it will delete all existing customer account pricing previously assigned to a combination product, to ensure that account pricing no longer relevant is not be stored, such as for contracts or promotions.

This ensures that if the default child product receives account pricing, that the parent also does, avoid mismatches in pricing, such as when viewed in product detail or listing areas.

Note that this change means that if the "Automatically Calculate Combination Product Prices" setting is set to Yes and parent combination products had customer account pricing set against the products already, then this pricing would get deleted and the child product's account pricing would overwrite it.

Functionality Affected:  Product Pricing Connector Text File data imports
Impact: Normal

TOT-4263 - Upgrade Websites and Web Page Editor Administration Centre interfaces to https

Within the Administration Centre, under the Websites menu, within the Websites interface, it now is able to load over a https connection, as well as from within the Websites interface. Upon clicking on a webpage, the Web Page Editor now also loads over a https connection. This ensures that all traffic to and from the servers is sent over secure connections, and avoids issues with web browsers incorrectly not handling loading insecure web pages.

Functionality Affected:  Administration Centre
Impact: Normal

TOT-4266 - Block scrapers that identify as thesis-research-bot. fidget-spinner-bot, Bytespider, my-tiny-bot, DataForSeoBot and AwarioSmartBot

Website traffic has been blocked from allowing requests from scrapers who identify with the following user-agents: "thesis-research-bot". "fidget-spinner-bot", "Bytespider", "my-tiny-bot" or "DataForSeoBot"

Functionality Affected:  Content Managed Website Block List
Impact: Normal

TOT-4269 - Product Deals and Vouchers deal offers to buy over product quantity X and get price at Y percent off price level Z price, and buy quantity X and get price at Y percent off price level Z price

Within the Product Deals and Vouchers feature 2 new deal offer types have been added that allow a product's price to be discounted based on ordering a certain quantity, and applying a percentage discount from a specific price-level price.

Within the Administration Centre, under the Marketing section, within the Product Deals and Vouchers interface, in the Offer drop down the 2 new offer types have been added:

Buy Product Quantity X For Y Percent Off Price Price Level Z
The offer type applies when a specific product quantity has been ordered, and its price will be set based on discounting a specific price-level price by a given percentage. Ie. "buy 5 of a product, and get 25% off the wholesale price"

Buy Over Product Quantity X For Y Percent Off Price Level Z
The offer type applies when more than a specific product quantity has been ordered, and its price will be set based on discounting a specific price-level price by a given percentage. Ie. "buy over 5 of a product, and get 25% off the wholesale price"

Once product deals have been set up with these offer types, then it may allow users to redeem these deals for the applicable products assigned to the deal. Note that if after the percentage discount of the specified price-level price is higher than the product price a user normally receives, then the deal with be ignored from being applied, since no valid discount is applicable.

Functionality Affected:  Product Deals and Vouchers administration centre interface
Impact: Normal

TOT-4271 - Content managed webpage javascript API function to reload Related Products Listing, Category Crumbs, and Product Detail web page areas

Within any content managed webpage the javascript API has been modified to allow external javascript files to trigger web page area events to fire, allowing areas to update at chosen times, initially supporting area types Product Details, Related Product Listing, and Category Crumbs to be reloaded with updated product data. Within the content managed webpage javascript API a new function has been added called: TOTECS.retail.fs.triggerWebPageAreaEvent(triggerAreaEventType, webpageAreaID, argument1);

The function takes 3 arguments, these are:

• triggerAreaEventType: ID of the web page area event to trigger. The TOTECS.retail.fs.WEBPAGE_AREA_TRIGGER_EVENT_TYPES stores the following: RELOAD_RELATED_PRODUCT_LISTING - 1 to reload a Related Products Listing area, RELOAD_CATEGORY_CRUMB - 2 to reload a Category Crumbs area, RELOAD_PRODUCT_DETAIL - 3 to reload a Product Detail area.
• webpageAreaID: ID of the web page area to specifically trigger an event against. If set to null then any area's listening to the event type will be triggered. By default this argument is not looked, and may be used in the future.
• argument1: The first argument to pass when triggering the web page area event. This value's purpose will change based on event triggered. For the first 3 trigger event types this argument needs to contain the product code of the product that is to have it's data updated in the areas being reloaded.

Functionality Affected:  content managed webpage javascript API
Impact: Normal

TOT-4276 - Rate limit the amount of time users can attempt to login or use Forgot Password within an allowed time frame

From within the Administration Centre Login page, or from a content managed webpage that contains a User Login area, if a user attempts to login, within the Login server more restrictive limits have been put in place to limit the number of failed login attempts that a user is allowed to make within the a specified time frame. By default a user is limited to only being able to attempt to login 20 times within the last 15 minutes. If the user then attempts to login after 20 attempts have been made then they will automatically receive a failed response. This automatic failed response will occur until less than 20 attempts have been made in the last 15 minutes.

Within the User Login area, if the user tries to use the Forgot Password feature, additional limits have been put place to only allow a user's security question to be attempted to be obtained 20 times within a 24 hour period. If more attempts are made within a 24 hour period the error message "The maximum number of attempts to obtain security questions has been made. Please contact us if you have forgotten your login details." will automatically be returned. Additionally limits have been put in place to only allow up to 20 attempts to answer a user's security question within the last 15 minutes. If this limit is exceeded then the error message "The maximum number of attempts to answer the security question has been made. Please contact us to help with your login details." will automatically be returned.

These increased limits provide additional security measures that help make it more difficult for malicious actors to try and guess a user's login credentials, and take over the user's accounts.

Functionality Affected:  User Login, Forgot Password
Impact: Normal

TOT-4277 - Set global http response headers for all web pages within a content managed website

For each content managed website there now the ability to set HTTP response headers that are included in every response for each web page served against the website. This allow responses to be further customised, such as putting in headers for setting website security policies of its content, such as .Content-Security-Policy or Strict-Transport-Security headers to provide stricter security rules to help web browsers add additional security protections to users.

Within the Administration Centre, under the Websites menu, within the Websites interface, clicking on the website domain, within the Website Details interface, a setting labelled "Global Web Page HTTP Response Headers". In its text area each HTTP response header needs to be added on each row, with the header's name and value separated by a colon character. For example: "Strict-Transport-Security: "max-age=22236000; includeSubDomains" always"

Once the Update Site button is saved on, then when any web pages belonging to the website are requested, in the response headers will be included in the web page response.

Note that if any of the following response headers are provided they will ignored, since they may affect underlying platform responses:

• Content-Type
• Set-Cookie
• Content-Encoding
• Transfer-Encoding

Functionality Affected:  Website Details administration centre interface
Impact: Normal

TOT-4278 - Settings to control user password validation, and minimum character lengths for user Login IDs and Security Answers

When a user's password is being set or updated from either within a User Registration or User Details/Favourites/Orders area on a content managed webpage, or within the Administration Centre's Search Users and Create User interface, there are now settings that control how a user's Password, Login ID and Security Answer are validated. This includes controlling the allowed minimum character length for Login ID, Password, and Security Answer. Additionally there are settings to control how many special characters, upper case letters, and numbers are required to be in the password. Additionally for each User Registration Profile there are settings to control if the password validation should be enforced, as well the abiltiy to set a customisable message when the password validation fails, allowing a new user registering to be informed if they have not provided a strong enough password.

Within the Administration Centre, under the Users menu, within the General Settings interface the following settings have been added:

• User Login ID Minimum Length: Set the minimum character length of a user's Login ID allowed when created via User Registration or saved within the Administration Centre.
• User Password Minimum Length: Set the minimum character length of a user's password allowed when created via User Registration or saved within the Administration Centre.
• User Password Minimum Numeric Characters Required: Set the minimum number of numeric characters required to be set in a user's password, when the password is being set via User Registration, or from within the Administration Centre.
• User Password Minimum Special Characters Required: Set the minimum number of special characters required to be set in a user's password, when the password is being set via User Registration, or from within the Administration Centre. Special characters include: !@#$%^&*()
• User Password Minimum Lower Case Characters Required: Set the minimum number of lower case letter characters required to be set in a user's password, when the password is being set via User Registration, or from within the Administration Centre.
• User Password Minimum Upper Case Characters Required: Set the minimum number of upper case letter characters required to be set in a user's password, when the password is being set via User Registration, or from within the Administration Centre.
• User Security Answer Minimum Length: Set the minimum character length of a user's answer to their security question allowed when created via User Registration or saved within the Administration Centre.

Within the Administration Centre, under the Users menu, within the User Registration Profiles interface, open clicking on the name of a profile, within the Profile Details interface, under the Mandatory Registration Fields section, the following settings have been added:

1. Enforce Password Validation: If checked then when a user uses the profile to register, the password they set will be validated with the above password settings, otherwise the additional password validation will not be enforced. It's recommended to turn this on, unless an administrator user will change their password after immediately registering and the user is not initially active.
2. Enforce Password Validation Error Message: Set the error message that the user sees if their password doesn't pass validation checks

Note that if user's are created via Customer Account Connector data imports and automatically have a password set, the password will not have validation checks performed.

Functionality Affected:  Search Users, Create User administration centre interface, User Registration, User Details/Favourites/Orders content managed web page area
Impact: Major

Bug Fixes

TOT-4210 - Default quantity input value not being increased by 1 for deal offer types over a given quantity for Product Deals Listing content managed web page areas

On content managed webpage containing a Product deal listing area "$product_basket_quantity_input$" hook outputted an incorrect quantity in quantity field for all the products where the deal offer was to buy over a given quantity. Now the "$product_basket_quantity_input$" hook will now correctly increment the quantity set for the deal by 1 when the deal is assigned to any of the below deal types:

• Buy Over Product Quantity X For Price Y
• Buy Over Product Quantity X For Y Percent Off Price
• Buy Over Product Quantity X At Price Level Y
• Buy Over X Product Quantity For Y Percent Off Freight Surcharge
• Buy Over X Price Of Basket Total (Ex. Product Redeemed), Get Product For Price Y
• Buy Over X Quantity Of Total Basket Products (Ex. Product Redeemed), Get Product For Price Y
• Buy Over X Quantity Of Total Basket Products, Get Product For Price Y
• Buy Over X Price Of Basket Total (Ex. Product Redeemed), Get Product For Y Percent Off Price
• Buy Over X Price Of Basket Total (Ex. Product Redeemed), Get Product At Price Level Y
• Buy Over X Quantity Of Total Basket Products (Ex. Product Redeemed), Get Product For Y Percent Off Price
• Buy Over X Quantity Of Total Basket Products, Get Product For Y Percent Off Price
• Buy Over X Price Of Total Basket Products (Before Discounts), Get Product For Y Percent Off Price
• Buy Over X Price Of Total Basket Products (Before Discounts), Get Product For Price Y
• Buy Over X Total Quantity Of Products In Deal, Get Product For Y Percent Off Price
• Buy Over X Total Quantity Of Products In Deal, Get Product For Price Y
• Buy Over X Quantity Of Products Belonging To The Same Parent Combination Product, Get Product For Y Percent Off Price
• Buy Over X Quantity Of Products Belonging To The Same Parent Combination Product, Get Product For Price Y

Functionality Affected: Product Deal Listing cotnent managed web page area
Impact: Normal

TOT-4237 - Not all available products importing from an historic order into a user's basket within the User Details/Favourites/Orders content managed web page area

For a user logged into a content managed web page containing a User Details/Favourites/Orders area, if the area was displaying a list of historic orders, then if the Import Products button was clicked, not all active and available products may be imported into the order, even if the user has the ability to add these products to basket.
Now if the Import Products button is clicked, all active and available products will now be imported into the order. Previously some products were not being added to basket if non essential attribute data for each product in the order was missing.

Functionality Affected: User Details/Favourites/Orders content managed web page area
Impact: Normal

TOT-4240 - Products assigned to multiple categories of the same model not passing the correct quantity input value when adding to basket within the Model Product content managed web page area

On a content managed web page that contains a Model Product area, if the area was displaying a model that has the same product assigned to it across multiple different categories, then if the area's Product Search Record format was being displayed for each product record and contains the addProductQuantityField format hook to display the quantity input, the input incorrectly had the same element ID set for product records displayed multiple times.
Now the quantity input correctly has a different element ID set for product records displayed multiple times. This ensures that the correct quantity is passed to the server if multiple product records for the same product appear under different categories.

Functionality Affected: Model Product content managed web page area
Impact: Normal

TOT-4242 - Shopping list displaying incorrect number of available and visible products and sorting not working correctly within a Shopping List Products content managed web page area

After a user logs into a content managed website and navigates to a web page containing a Shopping List Products area. If the shopping list shown in area contained products in the shopping list that are not active or visible, then the counts within the ordering drop down incorrectly showed total number of products in the shopping list without factoring in the products that are allowed to be seen. Additionally if user selected to reorder a product within the list using the re-ordering drop down it was incorrectly positioning the product.
Now for each shopping list displayed the count of products will correctly not count products in the shopping list that are not active or visible. Additionally within the Shopping List Products area the shoppinglist_product_count format hook will also not include products in the shopping list that are not active or visible. The shoppinglist_product_ordering_options format hook will also now include the correct count of products to display as re-orderable options for each product.
Note that if an existing product is in a shopping list and becomes inactive or hidden, then a user changes the ordering of any existing products visible in the same shopping list, then if the existing product that is inactive or hidden becomes active or hidden, then its position will have changed to be at the bottom of the shopping list.

Functionality Affected: Shopping List Products content managed web page area
Impact: Minor

TOT-4245 - Area settings not being saved for Category Listing content managed web page area within Webpage Editor of Administration Centre

After a user logged into the administration Centre, clicked on the Websites menu button, then clicked on the Websites menu item, within the Websites interface. Upon right clicking on a content managed web page, and clicking on View All Areas context menu item, within the Web Page Editor, clicking on the name of a Category Listing area, within the Area Settings dialog, upon setting the following area settings and clicking on the Assign button to save the changes, upon closing and reopening the dialog the following area area settings were loading the previous saved values. When the area settings were being saved to the database, the previous settings values were not being cleared before saving the new settings
A fix has been made to correctly clear out the old settings values before saving the new settings values for the area's settings.

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

TOT-4247 - Users unable to to subscribe to emarketing after submitting email address within the Emedia Subscription Form content managed web page area

On a content managed webpage that contained a Emedia Subscription Form area, after the user typed their email address into the area's textbox and clicks on the submit button, a browser error alert box displayed within the message "Request has failed whilst trying to connect to the server, please try again later", and the user failed to have their email subscribed to receiving emarketing. This only occurred if the project is running on the TOTECS Ecommerce platform's Web Server Cluster 2.
Now after the user types their email address into the area's textbox and clicks on the submit button, the user correctly against becomes subscribed to receiving emarketing. This issue was caused by the the list of marketing categories not being correctly passed to the server. Note it was only occurring on TOTECS projects running on the platform's newer web servers that implement tighter URL character standards.

Functionality Affected: Emedia Subscription Form content managed web page area
Impact: Normal

TOT-4249 - Incorrect discount price amount being added to basket by sales representative users for child products that's not the first listed in the Product Combination content managed web page area

On a content managed web page that contained a Product Combination content managed web page area, if the area was displaying a list of child products for a parent combination product, and the area was configured to display the child products as a radio list, and the area is being viewed by a sales representative user, and the area was configured to use the Combination Product Option List Record format that had the $add_product_price_field$ or $add_product_price_discount_field$ hooks embedded within it to allow the sales rep user to optionally set a price for the product, then when a child product was added to basket that was not the first product listed in the area, using either the Quantity textbox or a button using the $add_product_basket_onclick$ hook in its onclick event attribute, then the incorrect price/discount amount was being set for the product in the basket using the price/discount amount set for first product in the list.
Now when using either the Quantity textbox or a button using the $add_product_basket_onclick$ hook in its onclick event attribute, then the correct price/discount amount is being set for the product in the basket using the price/discount amount set within the inputs of the child combination product record.

Functionality Affected: Product Combination content managed web page area
Impact: Normal

TOT-4250 - Webpage URL Routes linked to web page not being deleted when the page is deleted within the Within Websites Administration Centre interface

Within the Administration Centre, under the Websites menu, within the Websites interface, under a content managed website, within the Webpages tree node, if a content managed web page was deleted, it did not also delete the Webpage URL Routes that were linked to that webpage. Because of this these routes were still being checked for and used when a content managed web page was loaded, that may cause a blank content managed web page to display.
Now if a content managed web page is deleted, it now also deletes the Webpage URL Routes that are linked to that webpage. Additionally in the Web Page Routes dialog it will also now display all General routes, previously this was being ignored.

Functionality Affected: Websites Administration Centre interface
Impact: Normal

TOT-4251 - Order Notification Email failing to attach Order Details PDF file when a product contains an ampersand within its product code

Within the Administration Centre, under the Stores menu, within the Orders interface, for an order that has a product assigned to it containing an ampersand character within its code, when the user clicked on the Email button, then within the Send Order Email Notification dialog clicked on the Send Email button, then an error dialog displayed with the "The order email notification failed to send returned" and the notification still got sent out but without the email attachment's order details PDF file. This issue only occurred if within the Orders Store Settings interface the "Order Confirmation Email Order Detail Product Format" setting was using the order_product_set_field to embed the product code or barcode within an order line.
Now when the user clicks on the Email button, then within the Send Order Email Notification dialog clicks on the Send Email button, an error dialog no longer displays with the "The order email notification failed to send returned" and the order email notification correctly gets sent out but with the email attachment's order details PDF file. This issue was caused due to the "Order Confirmation Email Order Detail Product Format" setting using the order_product_set_field to embed the product code or barcode within an order line, and the product code or barcode not having the ampersand character correctly HTML encoded, that causes the HTML to PDF converter to fail due to not meeting strict HTML standards.

Functionality Affected: Order Notification Email
Impact: Normal

TOT-4255 - Removal of vulnerabilities within content managed websites and Trade interface

Within content managed websites and the Trade interface there were cross-site scripting vulnerabilities that could be exploited when combined with social engineering and phishing attacks.
Now within content managed websites and the Trade interface a number of vulnerabilities that could allow intruders to exploit a website were found and have been removed, so that nefarious 3rd parties cannot exploit users into providing information without their knowledge or consent.

Functionality Affected: Trade interface/content managed wesites
Impact: Major

TOT-4257 - Unable to filter payments by Customer Account Code within Payments Administration Centre interface

When an administrator user logged into the Administration Centre, clicked on the Store menu, then clicked on the Payments menu item, within the Payments interface, within the View Payments tab if the Search drop down was changed to the "Customer Account Code" option, then if a value a placed into the search textbox and the Search button was pressed on, no payments would display, even if a payment existed that is assigned to a customer account that matches the code given.
Now if the Search drop down is changed to the "Customer Account Code" option, then if a value a placed into the search textbox and the Search button is pressed on, payments are now correctly searched that match the code of the customer account given.

Functionality Affected: Payments administration centre interface
Impact: Normal

TOT-4260 - Removal of vulnerabilities within Administration Centre interfaces

Within the Administration Centre a number of vulnerabilities that could allow intruders to exploit its interfaces were found and have been removed, so that nefarious 3rd parties cannot exploit users into providing information without their knowledge or consent.

Functionality Affected: Administration Centre interface
Impact: Major

TOT-4264 - Basket Products Administration Centre interface failing to load the list of products

After an administrator user logged into the Administration Centre, after clicking on the Statistics menu, then clicking on Basket Statistics menu item, within the Basket Statistics interface, under the Basket Summary section, within it's table, if the number in the Total Items was clicked on, then in the browser window that opened the Basket Products interface, the interface was failing to load its contents of the Basket Products table for the user to see.
Now if the number in the Total Items is clicked on, then in the browser window that open the Basket Products interface, the interface will correctly load its contents for the user to see again. This issue was caused by a programming error introduced in TOT-4260

Functionality Affected: Basket Statistics administration centre interface
Impact: Normal

TOT-4267 - Updated Template interface not displaying Update Template Area Container interface after changing a web page's template within the Web Page Editor Administration Centre

After an administrator user logged into the the Administration Centre, under the Websites menu, within the Websites interface, under a content managed website, when clicking on a web page, from within the Web Page Editor, upon clicking on the Templates menu item, within the Update Template interface, within the Change Template drop down, after selecting a different template option and clicking the Update Template button, the interface failed to reload, and showed the Update template Area Containers interface. Instead the web page was assigned to the web page template, but all local areas were not assigned to existing template hooks, making the areas disappear on the web page and within the All Areas interface.
Now after selecting a different template option and clicking the Update Template button, the interface correctly reloads, and shows the Update template Area Containers interface. allowing the web page area's to be assigned to the new web page template's containers.
This issue was caused by new stricter server request parameter value standards that the newer web server version required. The logic has been updated to meet these new standards. Note that if a web page was assigned to a new template, it could be assigned back to the old web page template to allow the existing areas to appear again.

Functionality Affected: Web Page Editor administration centre interface
Impact: Major

TOT-4268 - Unable to save settings within the Model Search Listing content managed web page area within the Webpage Editor of the Administration Centre due to incorrectly making server request over insecure connection

After a user logged into the Administration Centre, clicked on the Websites menu, and then clicked on the Websites menu item, within the Websites interface for any content managed webpage that contained a Maker Listing area, open the web page within the Web Page Editor. From within the Web Page Editor, after clicking on a Maker Listing area, within the Area Settings dialog after changing any setting and clicking the Assign button, it failed to save the setting due to the Assign button incorrectly calling the server with a URL containing the insecure URL request, instead of calling the server with the secure URL request.
Now after clicking on a Maker Listing area, within the Area Settings dialog after changing any setting and clicking the Assign button, it now correctly saves the settings for the area.

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

TOT-4270 - Previous Instructions drop down not sorting unique instructions by last order date within the Order Checkout/Submission content managed webpage area

After a user logged into a content managed website, and had added products to their basket. From a web page that contains a Basket Listing area they clicked on a Checkout button and navigated to a web page containing a Order Checkout/Submission area. Within the area that was displaying the Order Details Form format, within the Previous Instructions drop down, it was incorrectly not sorting the unique previous instructions based on the last time an order contained the instruction.
Now within the Previous Instructions drop down, it will correctly sort the unique previous instructions listed, based on the last time an order contained the instruction. Previously it was finding and grouping the unique instructions, but may not always order by the latest order date.

Functionality Affected: Order Checkout/Submission content managed web page area
Impact: Minor

New Features

TOT-4132 - Address auto-complete using Google Places within Order Checkout/Submission, User Registration, User Details/Favourites/Orders content managed web page areas

On a content managed web page that contains either a Order Checkout/Submission area or a Guest Order Checkout/Submission area, there is now the ability to embed auto-complete search form inputs into the areas that allows the user to start typing the address that they are looking for when creating a new delivery or billing address, where the address search auto-complete will perform a look up using Google Places to return an auto-complete list of addresses for the user to choose from. Once an address is selected it will automatically populate each of the new address fields. This makes it quicker and easier for users to set new billing and delivery addresses against orders instead of having to fill out each address form field.
Additionally on a content managed web page that contains a User Registration area or a User Details/Favourites/Orders area, there is also the ability to embed address auto-complete search form inputs, that also allows an address to be found and automatically populate the address form fields for when a new address is being created.
For all of the address search auto-complete form inputs there are settings that control the fields that address data returned from Google's Places service is placed into. Additionally there is a setting that controls if the auto-complete should limit only finding addresses in selected number of countries (up to 5), or addresses across the whole world.
For each area there are also area settings that can disable or enable the address fields, allowing or not allowing the user to modify the address fields once loaded with the auto-complete. Disabling these fields may be desired to avoid users from being able to key invalid address data, that may lead to less delivery issues during dispatch processes.
In order to use this functionality it requires a Google account to be set up, and within Google's Console the account have API keys set up for its Places service. [https://developers.google.com/maps/documentation/places/web-service/get-api-key] Note that is the Location Finder feature is already being used in the TOTECS project, then the same account and API key can be used also for the address auto-complete functionality.
Within the Administration Centre, under the Stores menu, within the Location Settings interface an additional section labelled "Address Auto-Complete Searching" has been created and contains the following settings to configure the address search auto-complete:

• Restrict address searches to region (ccTLD region code)
  • Set a comma delimited list of ccTLD region codes to limit address auto-complete searches to only the countries specified in Google maps API. Only up to 5 regions can be set, or otherwise leave empty to allow addresses to be searched across all countries.
• Put Premise Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Premise may store the name of a building or place.
• Put Sub Premise Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Sub Premise may store a unit or apartment type name and number
• Put Street Number Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Street Number may store a number of the building or house located the street.
• Put Route Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Route may store a name of the street and type of road it is.
• Put Sub Locality Level 1 Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Locality may store the name of the local town, local suburb, or local area.
• Put Locality Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Locality may store the name of the town, suburb, or area.
• Put Postal Town Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Postal Town may store the name of the town, suburb, or local area known by the postal service.
• Put Administrative Area Level 1 Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Administrative Area Level 1 may store the name of the municipal or council area.
• Put Administrative Area Level 2 Into Address Field
  • For an address selected using an Google map's address auto-complete to create a new address, choose the address field that the Premise data is placed into. Administrative Area Level 2 may store the name of the state, province or region.

Within the each of the content managed web page areas the following settings can be configured:

Order Checkout/Submission

Area Settings

• Allow New Address Auto-Complete Search: If set to Yes and the Google API Key setting has been configured within the Stores Locations settings interface, then if the an delivery or billing auto-complete input has been been embedded within the area's Order Details Form format, the address auto-complete search will be loaded against the form inputs.
• Disable New Delivery Address Mailing Fields: If set to yes then disable the address 1-4 fields, postcode, and country for the new delivery address.
• Disable New Billing Address Mailing Fields: If set to yes then disable the address 1-4 fields, postcode, and country for the new billing address.

Order Details Form Format Hooks:

• delvrnew_search_input_id: ID of the text input that is used to embed a new delivery address search auto-complete against. This allows users to find and select an address from, and populate the new delivery address form fields with. Embed within the ID attribute of a text input element.
• billingnew_search_input_id: ID of the text input that is used to embed a new billing address search auto-complete against. This allows users to find and select an address from, and populate the new billing address form fields with. Embed within the ID attribute of a text input.

Guest Order Checkout/Submission

Area Settings:

• Allow New Address Auto-Complete Search: If set to Yes and the Google API Key setting has been configured within the Stores Locations settings interface, then if a delivery or billing auto-complete input has been been embedded within the area's Guest Order Details Form format, the address auto-complete search will be loaded against the form inputs.
• Disable New Delivery Address Mailing Fields: If set to yes then disable the address 1-4 fields, postcode, and country for the new delivery address.
• Disable New Billing Address Mailing Fields: If set to yes then disable the address 1-4 fields, postcode, and country for the new billing address.

Guest Order Details Form Format Hooks:

• delvrnew_search_input_id: ID of the text input that is used to embed a new delivery address search auto-complete against. This allows users to find and select an address from, and populate the new delivery address form fields with. Embed within the ID attribute of a text input element.
• billingnew_search_input_id: ID of the text input that is used to embed a new billing address search auto-complete against. This allows users to find and select an address from, and populate the new billing address form fields with. Embed within the ID attribute of a text input.

User Registration

Area Settings

• Allow Address Auto-Complete Search: If set to Yes and the Google API Key setting has been configured within the Stores Locations settings interface, then if an address auto-complete search input has been been embedded within the area's User Registration format, the address auto-complete search will be loaded against the form input.
• Disable Address Mailing Fields: If set to yes then disable the address 1-4 fields, postcode, and country for the address form inputs.

User Registration Format Hooks:

• address_search_input_id: ID of the text input that is used to embed an address search auto-complete against. This allows users to find and select an address from, and populate the address form fields with. Embed within the ID attribute of a text input element.
• address_search_input_onfocus: Javascript function that triggers an address search against the address search auto-complete text input. This allows users to find and select an address from, and populate the address form fields with. Embed within the onfocus attribute of a text input element.

User Details/Favourites/Orders

Area Settings

• Allow New Address Auto-Complete Search: If set to Yes and the Google API Key setting has been configured within the Stores Locations settings interface, then if a new address auto-complete search input has been been embedded within the area's User Detail Form format, the address auto-complete search will be loaded against the form input.
• Disable New Delivery Address Mailing Fields: If set to yes then disable the address 1-4 fields, postcode, and country for the new address form inputs.

User Detail Form Format Hooks:

• address_new_search_input_id: ID of the text input that is used to embed a new address search auto-complete against. This allows users to find and select an address from, and populate the new address form fields with. Embed within the ID attribute of a text input.
• address_new_search_input_onfocus: Javascript function that triggers an address search against the new address search auto-complete text input. This allows users to find and select an address from, and populate the new address form fields with. Embed within the onfocus attribute of a text input element.

With each of the area formats the input ID input needs to be placed within a text input's ID attribute, and the onfocus hook within the input's on onfocus attribute.

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission, User Registration, User Details/Favourites/Orders content managed web page areas
Impact: Normal

TOT-3824 - Integrate AfterPay payment type for ordering

There is now the ability for users to pay for orders within content managed websites using Afterpay's Buy Now Pay Later (BNPL) payment service.On a content managed webpage containing either Order Checkout/Submission or Guest Order Checkout/Submission areas, within the Order Detail format there ability to allow users to select Afterpay from the payment types list if the payment type is assigned against the customer account they are using to order with.
A new payment type called "After Pay" (AP) has been added to the list of payment types that can be assigned to each customer account either through the Customer Accounts text file data import, or via the Customer Accounts Connector data import, by including the AP value with the other assigned payments stored in a comma separated list.
Before the Afterpay payment type can be used, a Merchant account needs to be first applied for and created with Afterpay. Once approved, API credentials need to be requested from the API support staff. Once obtained, then within the Administration Centre, under the stores menu, within the Payments settings interface, a section labelled "After Pay" has been added that contains the following settings:

• Environment: The Afterpay environment to be used to submit payments to. For testing choose the Sandbox environment where no money in exchanged. Choose the Live environment to allow real payments and money to be exchanged.
• Afterpay Merchant ID: ID of the merchant within Afterpay's system that will receive the payments and obtain payment configurations against. Businesses wanting to receive payments need to sign up to Afterpay as a merchant. Once approved Afterpay provides a Merchant ID
• API Secret Key: The API Key used to authenticate with Afterpay's API to raise payments with. Once a merchant account is set up with Afterpay a secret key to their API can then be obtained. This setting will always initially display as empty for security reasons even if it has a value previously set, and only be updated if a value is given.

Once the Afterpay settings have been set and its payment type is assigned against a customer account, then when the user proceeds through the order checkout process, on the Order Details page the user will be able to choose the Afterpay payment type option. If selected then at the order review stage a request is made to Afterpay to set up a Checkout within their system, if confirmed by Afterpay the user can then proceed to the Order Review stage. If they then confirm and submit the order, the user will be redirected to Afterpay's website to complete the payment process. If the user cancels completing the payment process within Afterpay's website then they will be taken back to the order details page.
Once the user has completed payment steps within Afterpay's system the user will be redirected back to the content managed webpage area displaying the Order Checkout/Submission area. A check will then be made to Afterpay's Capture Payment API endpoint to confirm the payment transaction and check that that the payment was successfully approved or not. If successful then the user will see the "Order Submission Success Message" format will display in the area, or otherwise the "Order Submission Failure Message" format will display in the area, informing the user of the payment and order submission results. Optionally the user can be shown a link to redirect them back to the Order Details step if the payment fails, allowing them to choose another payment type, and try again in completing the ordering process.Notes:

• Afterpay require that their logo appear on Product Detail areas before they will approve using their live system. This can be separately done through website implementation.
• Afterpay require order monetary amounts be provided to 2 decimals. If the project stores pricing in more than 2 decimal places then the pricing will be rounded to 2 decimal places when pricing ordering data to Afterway.
• The order information provided to Afterpay include user's emails address, contact name, delivery address, billing address, and ordered products name, product code, ordered quantity and unit price.
• Afterpay provide several limitations on businesses who are allowed to have merchant accounts. They most likely will only approve businesses selling physical products in the retail space. They also specify minimum and maximum limits on total order amount, and may reject allowing payments to be made for users who exceed these limits. An error message will appear at the Order Detail step if Afterpay reject an order, and the user will see an error message containing the error Afterpay is reporting.
• For testing within Afterpay's sandbox system, a test customer account needs to be created or logged in from https://portal.sandbox.afterpay.com/au/login-email . A mobile phone number needs to provided and must be unique. A verifcation code will be asked for but never sent by Afterpay's system. The verification code is: 111111
• For testing within Afterpay's sandbox system, testing credit cards can be found at developers.afterpay.com/afterpay-online/docs/customer-accounts

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission content managed web page areas, Stores Settings Administration Centre interface
Impact: Normal

Improvements

TOT-4129 - Allow ampersand, hyphen and apostrophe characters to be saved within Organisation Name, Address Description, and Contact fields of user addresses being created and updated

On a content managed web page displaying either a Order Checkout/Submission, Guest Order Checkout/Submission, User Registration, or User details/Favourites/Orders area. as well as within the Administration Centre's User Details interface, and additionally within the Trade interface, when the user is either creating a new address or updating an existing address assigned directly to them, within an address's Organisation Name, Contact Name, and Address Description fields the user is now able to set hyphen, apostrophe and ampersand characters within each of the address fields. The user will no longer receive error messages if these characters are applied in the address fields.
This allows support for company and contact names that use hyphens, apostrophes, such as for conjoined names.

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission, User Registration, User details/Favourites/Orders content managed web page areas
Impact: Normal

TOT-4214 - Toggle to switch between 3 different product record layout views within content managed web page areas that list products using Product Search Record web page area format

On a content managed web pages containing areas types that list products using the Product Search Record format, for each area type there is now the ability to toggle between 3 different types of Product Search Record formats, that can display product records in different layouts (such as a grid, list or simplified view). This applies to the following areas:

• Related Products Listing
• Product Search Results Listing
• Product Combination
• Category Listing
• Model Product
• Customer Account Contract Detail
• User Details/Favourites/Orders
• User Viewed Products
• Customer Account Invoice Line Report

Within the header and footer formats of each area type there are now format hooks that can toggle the area to change its Product Search Record format being used and cause the area to reload. Additionally there is now the ability to remember product search record being used across all types product listing areas by using a browser cookie to remember the user's preference. In these areas if the user paginates, changes the sorting of the area, reloads the webpage, or is refreshed from another area (such as from Product Search Form area types) this user preference will be used to display the associated product based format layout. Additionally in each area's settings there is now the ability to specify the Product Search Record format initially used when the area first loads, as well as control if the user can switch to any of the 3 product search formats. In each of the areas the settings can be set:

• Allow Product Record Format Switching: If set to Yes then the user has permission to switch between the Product Search Record formats assigned to content managed web page areas. If set to No the areas's first Product Search Record format will always be used.
• Default Product Record Format: If the Allow Product Record Format Switching setting is set to Yes, then this setting controls which of the 3 product Search Record's assigned to the area should initially display in the area if the user has not previously saved their preferred layout/format in a browser cookie. (or the browser cookie was cleared).

In the following content managed web page areas, the following hooks have added the area's header and footer formats. The format hooks are:

• product_record_layout1_onclick: Javascript function that updates the area to show product records in the first Product Search Record format assigned to the area.
• product_record_layout2_onclick: Javascript function that updates the area to show product records in the second Product Search Record format assigned to the area.
• product_record_layout3_onclick: Javascript function that updates the area to show product records in the third Product Search Record format assigned to the area.
• product_record_layout_class: CSS styling class name that indicates the Product Search Record format used to display the layout of products in the area. This hook can have the values list_record_layout_1, list_record_layout_2, or list_record_layout_3', 'list_record_layout_1
• product_record_layout_allow_change: Indicates if the user is allowed to change the Product Search Record format, allowing the layout of the product records in the area to change. Displays either Y - Yes, or N - No

The format hooks are available for the following areas and formats:

• Related Products Listing
  • Related Products Header
  • Related Products Footer
• Product Search Results Listing
  • Product Search Header
  • Product Search Listing Footer
• Product Combination
  • Combination Product Options Detail
• Category Listing
  • Category Listing Header
  • Category Listing Footer
• Model Product
  • Model Products Header
  • Model Products Footer
• Customer Account Contract Detail
  • Customer Account Contract Detail
• User Details/Favourites/Orders
  • User Favourite Products Listing
• User Viewed Products
  • User Viewed Products Header
  • User Viewed Products Footer
• Customer Account Invoice Line Report
  • Customer Account Invoice Line Report Header
  • Customer Account Invoice Line Report Footer

Because the user's format layout selection in one of these areas is saved as a preference in a cookie can then control the format used in the other areas, it is highly recommended to use the same types of layouts in the Product Search Record, Product Search Record 2, and Product Search Record 3 formats. For example if the first format shows a grid layout, the second a listing layout, and the 3rd a tall layout, then these layouts should be used across all the above areas that allow the user to change the layout selection. Otherwise if no done then if the user may choose a layout in one area, that doesn't look the same in another area, causing the user having to keep switching layouts that may be annoying to them.

Functionality Affected: Related Products Listing,Product Search Results Listing,Product Combination,Category Listing,Model Product,Customer Account Contract Detail,User Details/Favourites/Orders,User Viewed Products,Customer Account Invoice Line Report content managed web page areas
Impact: Normal

TOT-4215 - Add Serpstatbot, Seekport, Zoominfo crawlers and GoBuster to the list of known crawlers/scrapers within the Project Traffic Statistics Administration Centre

For website traffic making webpage requests for a project, there is now the ability to detect when Serpstatbot, Zoominfo and Seekport crawlers are making a request, as well as GoBuster scraper.
Within the Administration Centre interface, under the Statistics menu, in the Project Traffic Statistics interface, under the "Requests By Search Engines, Crawlers and Software" pie graph now can show requests that are made by the Serpstatbot, Seekport and Zoominfo crawlers, as well as GoBuster. Additionally these crawlers have been added to the TOTECS platform's list of Bad Bots that prevent future requests reach projects that are blocking these bots.

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

TOT-4223 - Show and export additional customer account fields in Search Users Administration Centre interface

Within the Administration Centre interface, under the Users menu, within the Search Users interface, in the Search Users table's Custom Data Field column, additional customer account fields have been added that allow data for the following fields to display:

• Key Customer Account ID
• Business Number (ABN)
• Contact Name
• Email
• Mobile Phone Number
• Phone Number
• Class
• Territory
• Sales Representative ID
• Shipping Method
• Is On Hold
• On Hold Action
• Outside Payment Terms Action
• Outside Credit Terms Action
• Balance
• Balance Limit

Additionally if the user clicks on the Export Users button, within the Export Users dialog these additional customer account fields can also now be selected and exported with the User CSV spreadsheet file.

Functionality Affected: Search Users administration centre interface
Impact: Normal

TOT-4231 - Set Active setting against Product Review Profiles to allow or not allow product reviews to be raised and viewed for products

Within a content managed webpage that contains either Product Review Form and Product Review Listing areas, the contents of these areas where product reviews can be raised and seen or not is now controllable by setting an Active state against the Product Review Profile that a product belongs to. This makes it easier to control if product reviews should appear and raised for different collections of products that belong to each review profile.
Within the Administration Centre, under the Inventory menu, within the Product Reviews interface, upon clicking on the "Criteria and Options" button for a product review profile, within the "Product Review Profile Criteria and Options" dialog a check box labelled "Profile Is Active" has been added. If selected then on content managed web pages that contain Product Review Form and Product Review Listing areas, the product review form and review listing content will display in the areas for any products assigned to the profile. If the checkbox is unselected then for products assigned to the profile, the contents of these areas will not display, not allowing a user to raise a product review, nor see existing reviews against the product.

Functionality Affected: Product Review Form, Product Review Listing content managed web page areas, Product Reviews Administration Centre interface
Impact: Normal

TOT-4232 - Setting to control how customer account discount is applied to price-level and customer account product pricing

On a content managed website or within the Trade interface, for pricing calculated for a product, if a customer account has a discount percentage specifically applied to account in the discount field, there is now a setting that controls if account's discount is applied to all price-level pricing, customer account pricing, both or none of a product when displayed. This allows more flexibility on determining how a general account discount can be applied all applicable pricing to the account.
Within the Administration Centre, under the Inventory menu, within the Product Settings interface, a new setting has been added labelled "Apply Customer Account Discount To" that can be set to one of the following options:

• None: If set then doesn't allow the customer account discount to be applied to any prices across all customer accounts and users
• Price-Level Pricing: If set then allows the customer account discount to be applied only to each product's price-level unit price, and price-level volume discount prices, but not any customer account assigned prices.
• Price-Level, Account Pricing: If set then allows the customer account discount to be applied to each product's price-level unit price, and price-level volume discount prices, as well customer account assigned prices (i.e contract prices, promotional prices, special prices).
• Account Pricing: If set then allows the customer account discount to be applied only to customer account assigned prices (i.e contract prices, promotional prices, special prices), but not any price-level prices
• For this setting to have any effect requires a customer account assigned to a user to have a discount not equal to 0 set. This can be done through the Customer Accounts Text File data import, or the Customer Accounts Connector data import, found under the Data menu, within the Data Imports interface of the Administration Centre.

Functionality Affected: Product pricing process, Product Settings Administration Centre interface
Impact: Normal

Bug Fixes

TOT-4046 - Incorrectly unable to add a product from a customer account quote record to an order if the product is out of stock but the user has permission to back order it

On a content managed web page containing a Customer Account Quote Listing area, if the area was displaying a quote that contains a product line, then if the user clicked on a button containing a $quote_order_continue_onclick$ hook that triggered the quote to be converted to an order, if the product was out of stock but the user's assigned inventory permission role contained a back order permission to allow the product to still be ordered, then the product was incorrectly not being imported into the order.
Now in a Customer Account Quote Listing area, if the area is displaying a quote that contains a product line, then if the user clicks on a button containing a $quote_order_continue_onclick$ hook that triggers the quote to be converted to an order, if the product was out of stock but the user's assigned inventory permission role contains a back order permissions to allow the product to still be ordered, then the product will be now included in the order.

• Product's stock quantity is greater than the Stock None Quantity
• The user is assigned to an inventory permission role with the "Backordered Check" permission set to "allow" for the product
• The user is a Sales Representative and assigned to a facility permission role with the "Order out of stock products" permission set to "allow"
• The "Check Stock" setting within the Administration Centre's Store menu, within the "Orders settings interface is not set to "BLOCK"


• Functionality Affected: Customer Account Quote Listing content managed web page area
  Impact: Normal

   

   

  ---

  TOT-4191 - Product deal being removed for an existing product in the basket after another product is added and the 1st product is assigned to deals with offer types that are calculated across multiple products in basket

  On either a content managed website or the Trade interface, if a user added a product to basket, and the product is assigned to a Product Deal that is applied, then if they add another product to basket, if the 1st product is assigned to a product deal that is assigned to an offer type that requires aggregating the quantities of products across the whole basket, if that deal's quantity threshold is not met, then the Add To Basket would incorrectly remove the deal.
  Now it correctly will not remove the the product deal initially applied to the original product. Additionally the Add-To-Basket process will now recalculate deals for all products when the product is assigned to a deal within an offer type that requires aggregating the quantities of products across the whole basket. This ensures that deals are correctly applied or removed from products in the basket based on the overall basket quantity/price threshold being changed.
  
  Functionality Affected: Product Add To Basket process
  Impact: Normal

   

  ---

  TOT-4205 - Incorrect default quantity input set within product records within Redeemable Deals Product Listing content managed webpage area for products assigned to deals containing offers that only apply over a specified quantity

  On a content managed web page containing a Redeemable Deals Product Listing area if products are displayed in the area with the "Redeemable Deal Product Record" format, if the products are assigned to deals with the following offer types, then the quantity textbox hook $product_basket_quantity_input$ would not be set with a default quantity that contains the offer quantity plus 1.
  Now the records will be set with a default quantity that contains the offer quantity plus 1. Previously these deal types were ignored from incrementing the deal quantity.

  • Buy Over X Product Quantity For Y Percent Off Freight Surcharge
  • Buy Over X Quantity Of Total Basket Products (Ex. Product Redeemed), Get Product For Price Y
  • Buy Over X Quantity Of Total Basket Products, Get Product For Price Y
  • Buy Over X Quantity Of Total Basket Products (Ex. Product Redeemed), Get Product For Y Percent Off Price
  • Buy Over X Quantity Of Total Basket Products, Get Product For Y Percent Off Price
  • Buy Over X Total Quantity Of Products In Deal, Get Product For Y Percent Off Price
  • Buy Over X Total Quantity Of Products In Deal, Get Product For Price Y
  • Buy Over X Quantity Of Products Belonging To The Same Parent Combination Product, Get Product For Y Percent Off Price
  • Buy Over X Quantity Of Products Belonging To The Same Parent Combination Product, Get Product For Price Y
  
  Functionality Affected: Redeemable Deals Product Listing content managed web page area
  Impact: Normal

   

   

  ---

  TOT-4207 - Product Has Deals hooks incorrectly not initially indicating the default child combination product has deals available within the Product Detail content managed web page area

  On a content managed page containing a Product Detail area, if the area was initially loading for a parent combination product, and a default child product was initially loaded, the area's "$product_deal_element_classname$" and "product_has_deals" hooks within its Product Detail format would not indicate if the child product has deals applicable to the user or not.
  Now the "product_has_deals" hooks will indicate if the child product has deals applicable to the user or not. Previously the hooks would always indicate that the parent combination product would never have deals applied to it regardless of what a default child product has.
  
  Functionality Affected: Product Detail content managed web page area
  Impact: Normal

   

  ---

  TOT-4213 - order_id hook within subject of Order Review Confirmation Email notification not being evaluated when email is sent to reviewing user

  On content managed webpage containing a Order Checkout/Submission area, with the Order Details section if a user selected another user to review the order. Then after the order is submitted, the Order Review Confirmation Email notification that is being sent out to the reviewing incorrectly did not evaluate out the $order_id$ hook within the subject of the notification email if set.
  Now after the order is submitted and is to be reviewed by a user, the Order Review Confirmation Email notification that is being sent out to the reviewing now correctly evaluates out the $order_id$ hook within the subject of the notification email if set, and shows the ID of the order being submitted.
  
  Functionality Affected: Order Review Confirmation Email notification
  Impact: Normal

   

  ---

  TOT-4216 - Product Add To Basket process calculating incorrect price for existing products in the basket when existing products are assigned to deals with offer types that are calculated across multiple products in basket

  Within either the Trade interface, or within the a content managed website, when a product was added to basket from any webpage areas that contain Product Add To Basket functionality, and the basket already had existing products already in the basket, then if those existing products in the basket are assigned to a product deal containing an deal offer that is based on the basket total, or based on multiple products already existing in the basket, then the price of the existing products deals was being incorrectly recalculated based on the quantities of each the products already in the basket, and deals applicable.
  Now the price of the existing products deals will be correctly recalculated based on the quantities of each the products already in the basket, and deals applicable.
  
  Functionality Affected: Product Add To Basket process
  Impact: Normal

   

  ---

  TOT-4220 - Requests incorrectly taking longer to load when Guest Regions feature is turned on when specific web parameters are set

  If the Guest Regions feature was turned on, then when any content managed web pages were requested that contain certain parameter values within the URL request, this could cause the request to incorrectly take longer to load.
  Now if the Guest Regions feature turned on, then when any content managed web pages are requested that contain certain parameter values within the URL request, this can no longer cause the request to incorrectly take longer to load, due to a request parameters being incorrectly processed by the database.
  
  Functionality Affected: content managed web page load
  Impact: Critical

   

  ---

  TOT-4221 - Unable to export products from within the Product Search Administration Centre interface

  Within the Administration Centre, under the Inventory menu, within the Product Search interface, after one or products was found and the Export button was clicked on, then from within the Export Products dialog after the Export button was pressed, a new browser tab is opened incorrectly showing a 400 error response with the message "Error: 'HTTP Status 400 – Bad Request'"
  Now from the Product Search interface, after one or products has been found and the Export button is clicked on, then from within the Export Products dialog after the Export button is pressed it will allow the product data to be exported again. This issue was caused by the the list of product fields select not being correctly passed to the server. Note it only affected TOTECS projects running on the platform's newer web servers that implement tighter URL character standards.
  
  Functionality Affected: Product Search administration centre interface
  Impact: Normal

   

  ---

  TOT-4222 - Unable to delete a user assigned to a User Subscription Category within the User Subscription Categories Administration Centre interface

  After an administrator user logged into the Administration Centre interface, clicked on the Marketing menu button, then clicked on the User Subscription Categories menu item, within the User Subscription Categories interface after clicking on the View Users button, then within the Category Users table, clicking on the Remove button for a user record incorrectly did not remove the user from the User Subscription Category or their record from the Category Users table.
  Now it correctly removes the user from the User Subscription Category and removes their record from the Category Users table.
  
  Functionality Affected: User Subscription Categories administration centre interface
  Impact: Normal

   

  ---

  TOT-4225 - Products Connector data import fails to complete if multiple product records are being imported for the first time and contain the same product code

  Within the Administration Centre, under the Data menu, within the Data Imports interface, from within Connector Imports tab, if the Products Connector data import was selected and run, and from the product records being imported contained multiple product records not previously imported before with the same product code, then the import failed to complete, and returns the error "An error occurred whilst trying to set up the data import : The data import has been aborted due to an error when processing record #2189. Please report this error. Technical Error: Null pointer expection thrown whilst processing record."
  Now if the Products Connector data import is selected and run, and from the product records being imported contain multiple product records not previously imported before with the same product code, then the import will successfully handle processing records containing the same product codes. Additionally if the product code is empty the data will now ignore processing the product record.
  
  Functionality Affected: Products Connector data import
  Impact: Normal

   

  ---

  TOT-4229 - Customer account pricing not displaying for products within Shopping List Products content managed web page areas if products were added to shopping list with no quantity specified

  On a content managed website, after a user had logged into the website and navigated to a web page containing a Product Detail area. If the user chose to add the product to shopping list but not specify a quantity, then when they navigated to a content managed web page containing a Shopping List Products area displaying the products assigned to the shopping list. The pricing displayed for product records that had no quantity set was incorrectly not factoring in customer account pricing when determining the price to display.
  Now if the user chooses to add the product to shopping list but not specify a quantity, then when they navigate to a content managed web page containing a Shopping List Products area displaying the products assigned to the shopping list. The pricing displayed for product records that had no quantity set now correctly factors in customer account pricing when determining the price to display. It does this calculating the price of the product as if it had a quantity of 1 set when it has a quantity of 0.
  
  Functionality Affected: Shopping List Products content managed web page area
  Impact: Normal

   

New Features

TOT-4142 - Set Delivery Status field against orders and send out delivery status notification emails

For orders that have been submitted there is now additional field called "Delivery Status" that can be controlled by administrator users to update where an order's products are within a delivery/dispatching process. If an administrator user changes the Delivery Status of an order, notification emails can optionally be sent out to the email address sent against the order or nominated email address advising of the delivery status change to an order. This can allow customers to know how an order is progressing, or if it has ceased to move. This awareness can provide additional customer service, and allow them to anticipate when their ordered products may or may not arrive.
An order's Delivery Status can be set to one of the following states (consistent with the Ecommerce Standards Documents delivery statuses):

• AWAITING_PACKAGING
  The ordered goods are awaiting to be packaged up for delivery. This is the initial status by default.
• PACKED
  The ordered goods have been packaged up and awaiting to be loaded on transport for delivery
• LOADED
  The ordered goods have been packaged up and have been loaded on transport for delivery. The transport has not yet left with the packaged goods.
• IN_TRANSIT
  The ordered goods have been packaged up, loaded and are in transit on transport.
• IN_STORAGE
  The ordered goods have been packaged up and are being stored at a location for later delivery.
• DELIVERED
  The ordered goods have been packaged up, transported and delivered to a final location.
• UNPACKED
  The ordered goods have been packaged up, transported and delivered to a final location, then unpacked at that location.
• DELIVERY_MISSED
  The ordered goods have been packaged up, transported to a final location, however they were not able to be received due to the authorized person(s) not being available to accept the goods.
• RECEIVED
  The ordered goods have been packaged up, transported to a final location, delivered and able to be received by the authorised person(s).
• LOST_IN_TRANSIT
  The ordered goods have been packaged up, and transported, however they were lost in transit. They may have been been lost in an accident, by an act of nature, or any other unforseen circumstance.
• DAMAGED_IN_TRANSIT
  The ordered goods have been packaged up, and transported, however they were damaged in transit. They may have been been damaged in an accident, by an act of nature, or any other unforseen circumstance.
• CANCELLED
  The delivery of the ordered goods was cancelled and will no longer be delivered.
• AWAITING_RECEIVER_PICKUP
  The ordered goods are at a location ready to be picked up by the receiver of the goods.

Within the Stores menu, within the Order settings interface, a new section needs to be added labelled "Order Delivery". Within the section the following settings have been added:

• Enable Order Delivery Status field: either Yes, or No. If Yes then allows the Delivery Status column to display in the Orders admin centre interface, and Order Details interface.
• Default Order Delivery Status: Displays a drop containing all of the delivery statuses, by default set to Awaiting Packaging. Controls the Delivery Status that orders are initially set to when created.
• Send Out Delivery Status Notification For Changes To Statuses: Contains a checkbox list of delivery statuses, that controls when delivery status notification emails should be sent out if an order's delivery status is changed to one of the selected statuses.
• Delivery Status Message [Status Name]: Set a message for each delivery status type. This allows highly customised messages to set for each status, that may then be embedded within Delivery Notice Email notifications.
• Delivery Status Notification Email Subject: Set the subject of the Delivery Status Email notification.
• Delivery Status Notification Email Message Format: Set the general message displayed within every Delivery Status Email notification sent out. The format allowed order details to be embedded into the message using format hooks, similar to the "Order Confirmation Email Message Format" setting.

Within the Orders Administration Centre interface, if the "Enable Order Delivery Status" setting is set to yes then the Delivery Status column will show in the table, and contain a drop down in each row allowing admins to change the delivery status once clicked on. Additionally a search drop down will display in the search filters to allow administrator users to filter orders based on delivery status. If the delivery status is changed, then if the status the order is being changed to set within the "Send Out Delivery Status Notification For Changes To Statuses" setting, then an email notification will be sent to the email address set against the order, containing the subject, message, and status message within the email, based on the Delivery Status Notification Email Subject, Delivery Status Notification Email Message Format, and Delivery Status Message [Status Name] settings.
Within the Orders interface, for each order, upon clicking on the Email button, in the Send Order Email Notification dialog, an additional setting labelled "Send Delivery Status Notice" will be displayed, that if selected will allow an administrator user to send a Delivery Status notification with a custom message.

Functionality Affected: Order Submission Process, Order Settings Administration Centre interface
Impact: Normal

TOT-4155 - CXML order submission profile and order punch back from Order Checkout/Submission content managed web page areas

On a content managed webpage that contains a Order Checkout/Submission area, the area can now support allowing users to be redirected back to their own purchasing system once an order has been successfully submitted, if they originated to the website from a purchasing system that supports the Punchout purchasing workflow. This allows users to punch-back with their own system once they have selected products and have a purchase order ready for approval within their own system .
Additionally an order profile has been created to support the CXML data standard http://cxml.org/ that allows users to punch back orders to their purchasing system that support the CXML data standard. The CXML order data can either be returned in 2 different formats, either the CXML Order format, or the CXML Punchout Order format. The Order format includes delivery and billing address data, product lines with quantities, unit pricing excluding tax, unit name, product name, and optionally UNSPSC code. The Punchout Order Format only includes product lines, quantities, unit pricing. Both formats can optionally include or exclude orders surcharges in the order lines.
Within the Administration Centre, under the Stores menu, within the Order Profiles interface, a new profile type can be created called "CXML". Once a profile is created with the type the following settings can be created:

• Product Unit Field: Controls the product field that is used to set the unit name with the cXML order line data.Product UNSPSCode Field: Controls the product field that is used to set the UNSPSC code with the cXML order line data.
• Include Surcharges: If set to Yes then allows surcharges to be included in the cXML order line data, either ignores including surcharges.
• Order Document Type: Either set to cXML Punchout Order, cXML Order, to set the type of cXML document that is returned to the user's purchasing system. This needs to be set to match way the purchasing system allows to receive the order data.

Once a CXML order profile has been created and configured, then the relevant customer accounts need to be assigned to the profile who associated users will utilise. Once done then when a user navigates from their purchasing system to the content managed website with the correct URL being provided from the purchasing system, then after the user has added products to basket, proceeded through the checkout process using a Order Checkout/Submission area, upon an order being successfully submitted, then the area will redirect the user back to their originating purchasing system's webpage with the order data in the CXML document standard. This then allows the order to be approved and sent from the purchasing system to the supplying organisation with a confirmed order using either EDI, email or other means to pass the order.
Within the TOTECS API an additional additional endpoint has been added labelled "setup_cxml_punchout", that will try to read in the CXML Punchout Setup Request within the body of the request, obtain login ID, password, and return URL information in the request, authenticate and create a new user session if successful, then return a CXML Punchout Setup Response containing the status, and if successful the URL to navigate to the content managed website by the purchasing user. The endpoint using the following relative URL:
dataapi/setup_cxml_punchout/[content_managed_website_id]/[content_managed_webpage_id_title]

• content_managed_website_id: set the ID of the content managed website that purchasing users to land on to start purchasing
• content_managed_webpage_id_title: set the ID or title of the content managed page that purchasing users to land on to start purchasing

Within the purchaser's system, the Punchout Setup Request requires that the user's login ID is set within the Identity element within the Credential element of the Sender element, and that the user's password is set within the SharedSecret element within the Credential element of the Sender element. Additionally the Credential element needs to have the "domain" attribute set to "NetworkId". Note that alternatively the user user's login ID and password can instead be set within the URL calling the API endpoint, with the URL parameters user=[user_login_id]&pass=[user_password]. If the user credentials are set in the URL then any credentials set within the body of CXML document will be ignored.
If the API endpoint is successfully able to validate the credentials given in the Punchout Setup Request then it will return a CXML Punchout Setup Response with a 200 success code and punchout URL, otherwise it will return a 406 error code with an error message .

Functionality Affected: Order Checkout/Submission content managed web page area, TOTECS API, Order Profiles Administration Centre interface
Impact: Normal

Improvements

TOT-4156 - Format hooks to show initial product pricing and stock level for Google Shopping crawler in Product Detail content managed web page area

On a content managed web page displaying a Product Detail area, additional format hooks have been added to the area that can be embedded within meta tags for Google's Shopping Crawler, allowing it to find pricing and stock level data used for its Google Shopping search engine. The hooks that have been added are:

• product_stock_level_google: Stock level of the product that indicates if the product is in stock or out of stock, in language for Google shopping crawler. Has either the value OutOfStock or InStock
• _P_PriceEx_initial: Unit price of product initially shown in the area, exclusive of tax amount.
• _P_PriceInc_initial': Unit price of product initially shown in the area, inclusive of tax amount.
• _P_Price_initial', 'Unit price of product initially shown in the area, either including or excluding tax amount based on the tax format setting of the user.
• _P_PriceExProjectCurrency_initial', 'Unit price of product initially shown in the area in the currency the user is assigned to view, exclusive of tax amount.
• _P_PriceIncProjectCurrency_initial', 'Unit price of product initially shown in the area in the currency the user is assigned to view, inclusive of tax amount.
• _P_PriceProjectCurrency_initial', 'Unit price of product initially shown in the area in the currency the user is assigned to view, either including or excluding tax amount based on the tax format setting of the user.

Functionality Affected: Product Detail content managed web page area
Impact: Normal

TOT-4157 - Import Meta Description, Meta Keywords, and Meta Title fields in Products Connector data import

Within the Administration Centre, under the Data menu, within the Data Imports interface, under the Connector Data Imports tab, when a Products data import is run, for each product record imported there is now the ability to set the Meta Description, Meta Keywords, and Meta Title fields for each product that is being imported. Additionally for the Categories Text File Data Import it too also allows the Meta Description, Meta Keywords, and Meta Title fields to be included the uploaded CSV text file spreadsheet data.

Functionality Affected: Products Connector Data Import
Impact: Normal

TOT-4158 - Data fields to change codes and key identifiers for customer accounts, products and categories within CSV text file spreadsheet data imports

Within the Administration Centre, under the Data menu, within the Data Imports interface, under the Text File Imports tab, when running either a Customer Account, Products, or Categories data imports, there needs to be the ability to change the codes of customer accounts, products, or categories in each data import, as well as update the key record identifiers. This makes it possible for administrator users to update these codes, and the references to these codes in associated entities, such as in orders, or against users. This may be needed if these identifiers are updated in linked business systems, and need to be updated to avoid new customer account, product or category records being created in Connector data imports.
For the Customer Account Text File data import the following fields can be set in the CSV spreadsheet file:

• KeyCustomerAccountID: Set the key identifier of customer account records that links it back an account record from an external system. Avoid setting multiple customer accounts with the same Key Customer Account ID otherwise only 1 of the accounts would get updated if an Customer Account Connector data import was run.
• New Account Code: Set the new code of the customer account. This code will be updated across all linked entities (including baskets, users, orders, content managed website regions) but excludes for log tables and order surcharge rules,

For the Products Text File data import the following fields can be set in the CSV spreadsheet file:

• Key Product ID: Set the key identifier of product records that links it back to a product record from an external system. Avoid setting multiple products with the same Key Product ID otherwise only 1 of the products would get updated if an Products Connector data import was run.
• New Product Code: Set the new code of the product. This code will be updated across all linked entities (including baskets, orders, favourites, shopping lists, related products etc...) but excludes log tables, order surcharge rules, inventory permission rules, or settings that reference product codes. This will need to be updated manually.

For the Categories Text File data import the following fields can be set in the CSV spreadsheet file:

• Key Category ID: Set the key identifier of category records that links it back to a category record from an external system. Avoid setting multiple categories with the same Key Category ID otherwise only 1 of the categories would get updated if a Categories Connector data import was run.
• New Category Code: Set the new code of the category. This code will be updated across the category tree. Note that any references to the category code in order surcharges, or inventory role rules will not be updated. This will need to be done manually. Note that when setting New Category Code column in spreadsheet file, avoid including the Parent Category Code, since when each category row is processed if a proceeding row has a reference to a parent category code that no longer exists then the import will report an error and skip the record.

For the Customer Accounts, Products and Categories text file data imports, it will first check if an existing record can be found with the old code, if not it will ignore trying to update the record and report an error message within the Error Log that the existing record could not be found.
Updating the codes of certain records may cause the import to take a long time to complete, such as when a customer account code is referenced against millions of baskets or orders, and products that are in many orders. When this is the case it's advisable to reduce the amount of records being imported in the spreadsheet file at a time.

Functionality Affected: Customer Account, Products, and Categories Connector Data Imports
Impact: Normal

TOT-4161 - Display flags assigned to each product within a Basket Products Listing content managed web page area

Within a content managed web page containing a Basket Products Listing area, for each product listed in the area, with the area's Basket Product Record format there is now the ability to show flags assigned to each product that is listed within the basket.Within the area's Basket Product Record format the following hooks can be embedded:

• basket_product_flag_class_names: Contains a list of space delimited flag names assigned to each product. The hook could be embedded within a HTML element's "class" attribute, allowing CSS styling rules to be setup to determine how each flag appears in the format
• basket_product_flag_image_elements: Displays sequential flag image elements, with each image element containing an image tag with the path to the flag's image. This allows flag images to directly show in the area as the small image size.
• basket_product_flags_assigned: Displays either Y or N, depending on if the product has one or more flags assigned to it.

Additionally the Basket Product Listing area now contains a setting labelled "Show Product Flags" that controls if product flag data should be determined or not for all products in the area. This setting should be left set to No to avoid making additional server processing if no flag data is needed to be shown in the formats. If the setting is set to Yes then the flag format hooks above will then populate if a product is assigned to one or more flags.

Functionality Affected: Basket Products Listing content managed web page area
Impact: Normal

TOT-4170 - Calculate and display freight unit data for basket products within Basket Summary and Basket Product Listing content managed web page areas

On a content managed web page area that contains Basket Summary or Basket Product Listing areas, within the area's Basket Summary format, additional format hooks can now be embedded within the areas, that can display information about the freight unit that may be used to package and deliver all the product quantities in the basket, based on using existing freight unit calculations defined within the Administration Centre, under the Stores menu, within the Freight Providers interface, under the Freight Units section. This allows the indicated freight unit to be shown to the user based on the products currently in their basket, how many freight units would be required to deliver the products, and how much space is partially taken up on the final freight unit. This may lead to users putting more product quantities in their basket, to maximise a freight delivery space and reduce the freight delivery cost.
Note that the freight unit calculations are based on overall basket volume or weight. The feature cannot calculate the exact freight unit quantity required since it does not look at product shapes or other logistics limitations (such as hazardous materials, or oversized issues). As such it is useful only as a general indicator, and any freight unit information updated by dispatch staff when orders land.
Within the Basket Summary's area, the following hooks are available to embed within its format:

• cart_TotalVolume: Total volume that all product quantities in the basket take up in space. The volume is calculated based on the rounded depth, width and height dimensions for each product, multiplied by quantity, and summed together across all products.
• cart_freight_unit_label: Label of the freight unit chosen to package up and deliver all the product quantities in the basket
• cart_freight_unit_amount: The number of freight units required to package up and delivery all the product quantities in the basket
• cart_freight_unit_partial_filled_weight: The amount of weight that has filled up the remaining freight unit used to deliver the product quantities in the basket. Number is rounded to specified number of places in Product Settings.
• cart_freight_unit_partial_filled_volume: The amount of volume that has filled up the remaining freight unit used to deliver the product quantities in the basket. Number is rounded to specified number of places in Product Settings.
• cart_freight_unit_partial_filled_percent: The percentage of space that has filled up the remaining freight unit used to deliver the product quantities in the basket. Number is rounded to integer.

Within the Basket Product Listing area, the following hooks are available to embed within its Basket Header and Basket Products Footer format:

• cart_view_TotalVolume', "Total volume that all product quantities in the basket take up in space. The volume is calculated based on the rounded depth, width and height dimensions for each product, multipled by quantity, and summed together across all products.
• cart_view_freight_unit_label', 'Label of the freight unit chosen to package up and deliver all the product quantities in the basket.
• cart_view_freight_unit_amount', 'The number of freight units required to package up and delivery all the product quantities in the basket
• cart_view_freight_unit_partial_filled_weight', 'The amount of weight that has filled up the remaining freight unit used to deliver the product quantities in the basket. Number is rounded to specified number of places in Product Settings.
• cart_view_freight_unit_partial_filled_volume', 'The amount of volume that has filled up the remaining freight unit used to deliver the product quantities in the basket. Number is rounded to specified number of places in Product Settings.
• cart_view_freight_unit_partial_filled_percent', 'The percentage of space that has filled up the remaining freight unit used to deliver the product quantities in the basket. Number is rounded to integer.

Functionality Affected: Basket Summary and Basket Product Listing content managed web page areas
Impact: Normal

TOT-4174 - Display stock availability for each back order line in a Customer Account Back Order content managed web page area

On a content managed web page displaying a Customer Account Back Order area, for each item line of a back order loaded into the area from a connected business system, there is now the ability to show the product stock availability, allowing users to be aware of the product lines in the back order where stock may now be available, or how much stock is still unavailable. This can either be shown as a percentage amount, the available stock quantity amount, or as a stock level indicator (such as high, low, none).
Within the Customer Account Back Order's content managed web page area the "Customer Account Back Order Line Item" format can now have the following hooks embedded:

• back_order_line_stock_level: Displays the level of stock available for the product associated to the back order line. Displays either 'high', 'low', or 'none'. This level is based on the available stock quantity amount given in the back order line data being compared against the match product's stock levels. If no available stock data is given the back order line data, then the level shown is based on only the amount of available stock set against the product in general.
• back_order_line_stock_available_quantity: Displays the quantity of stock available for the product associated to the back order line. This either displays the available stock quantity amount set within the back order line, or else if not provided then shows the amount of available stock quantity set generally against the matched products.back_order_line_stock_available_percent: Displays the percentage of stock available to cover the product stock quantity set in the back order line. This is calculated based on looking at the back order line's ordered quantity minus the delivered quantity amount, and then compared either to available stock quantity amount set in the back order line, or else if not provided then based on the available stock quantity amount set in general against the matched product.
• Within Customer Account Back Order area's settings editor, an additional setting labelled "Show Back Order Line Product Stock Data" has been created, only if this setting is set to Yes will each of the back order lines try to be matched up with existing products, and the stock format hooks above be calculated. It's best to leave this setting as No if no stock availability data needs to show in the area, since it avoids additional processing occurring on the server.

Functionality Affected: Customer Account Back Order content managed web page area
Impact: Normal

TOT-4202 - Express Order Checkout in Order Checkout/Submission content managed web page areas

Within a content managed webpage containing an Order Checkout/Submission area, there is now the ability for users to proceed through the Order Checkout process and skip the Order Details step, if they are assigned to an Express Order Checkout profile. If they are assigned to a profile then on a web page containing a Basket Products Listing area, when the user clicks on a button containing the checkout link, the area will call the server to validate and automatically create an order, using the predefined settings configured for the order based on the Express Checkout profile the user is assigned to. If successful the user will be redirected to the web page containing the Order Checkout/Submission area showing its review format. This allows the user to verify the order and submit it.

Within the Order Checkout/Submission area's Order Review format the following hooks have been added that allow the Order ID/Code and Terms and Conditions checkbox/link to hide or show, based on if the Express Checkout profile the user is assigned to requires this order information to be seen:

• order_review_display_order_id: Displays either Y or N depending if the the user is allowed to see the order ID.
• order_review_display_terms_conditions: Displays either Y or N depending if the the user is required to select the Terms and Conditions checkbox and see associated information or not.

Note that if the user is required to see the Terms and Conditions then its checkbox will be automatically selected.Also a part of this improvement the web page URL links have modified to display simpler URLs to reduce complexity in the browser's address bar.

Functionality Affected: Order Checkout/Submission content managed web page area
Impact: Normal

Bug Fixes

TOT-4154 - Products deals are not being applied to products in basket when Calculate Volume Discounts For All Products In Basket setting set to Yes

On a content managed website, if a product was added to basket and a deal was applicable to the product, and the project's "Calculate Volume Discounts For All Products In Basket" setting was set to Yes, then during the Product Add To Basket process the deal being applied to the product was removed when the each of the basket's products are being recalculated to factor in the total quantity of products in the basket. This only affected deals containing offer types that are not based on the total price of the basket.
Now if a product is added to basket and a deal is applicable to the product, and the project's "Calculate Volume Discounts For All Products In Basket" setting is set to Yes, then during the Product Add To Basket process the deal applicable to the product will be recalculated after each product in the basket has been repriced after factor in total product quantity and volume discounts. Note that this only affects deals containing offer types that are not based on the total price of the basket, and it's important to be aware that this fix then once again allows double discounting of product prices.

Functionality Affected: Product Add To Basket process
Impact: Normal

TOT-4167 - Content managed website failing to clone when child web pages exist within Websites Administration Centre interface

After a administrator user logged into the Administration Centre, after clicking on the Websites menu button, then clicking on the Websites menu item, within the Websites interface if they expanded the Web Area Format Libraries tree node, then navigated to a format for any content managed web page area, after opening the Edit Web Page Area Format dialog and changing any of the format settings, then upon clicking the Save button, closing the dialog and reopening it again for the same format, the settings of the format incorrectly did not show the previously saved settings. This occurred for all area formats.
Now closing the dialog and reopening it again for the same format, the settings of the format now correctly load again within the dialog again.

Functionality Affected: Websites Administration Centre interface
Impact: Normal

TOT-4184 - Edit Web Page Area Format dialog not loading previously saved settings for content managed web page area formats when reloaded within the Websites Administration Centre interface

After a administrator user logged into the Administration Centre, after clicking on the Websites menu button, then clicking on the Websites menu item, within the Websites interface if they expanded the Web Area Format Libraries tree node, then navigated to a format for any content managed web page area, after opening the Edit Web Page Area Format dialog and changing any of the format settings, then upon clicking the Save button, closing the dialog and reopening it again for the same format, the settings of the format incorrectly did not show the previously saved settings. This occurred for all area formats.
Now closing the dialog and reopening it again for the same format, the settings of the format now correctly load again within the dialog again.

Functionality Affected: Websites Administration Centre interface
Impact: Normal

TOT-4187 - Unable save settings within the General tab of Store Settings Administration Centre interface

If a user logged into the Administration Centre, clicked on the Stores menu button, then clicked on the General settings link, then within the Store Settings interface, under the General tab if the user then clicked on the Save button then an error dialog appeared with the a non-specified error "An Error Occurred while updating settings". Now if the user then Clicks on the Save button the settings now correctly are saved if there are no validation issues with the setting values.

Functionality Affected: Stores Administration Centre interface
Impact: Normal

TOT-4190 - Model records not appearing when users paginate through the Model Search Listing content managed web page area

Within a content managed web page containing a Model Search Listing area, when the user clicked on the any of the paginator links embedded within the format hook "$search_page_list$" of the header and footer formats, the area would update and incorrectly show no model records.
Now within a Model Search Listing area, when the user clicks on the any of the paginator links embedded within the format hook "$search_page_list$" of the header and footer formats, the area will correctly update and show the next page of model records retrieved from the server.

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

New Features

TOT-4124 - Shopping List Product Quick Add Form content managed web page area

On a content managed web page there is now the ability to allow users to find and add a product to the shopping list, similar to the Basket Product Quick Add Form area. The area is called "Shopping List Product Quick Add Form" and allows users to use a auto-complete search to find a product, matching on a selected product field. Once a product has been selected then its details are able to show, allowing a quantity to be set for the shopping list, then have the ability to add the product to basket. The area supports allowing products to be automatically added to shopping list if a single product is found within the autocomplete and the checkbox option is selected to allow product to be automatically added, such as if using a barcode scanner.
Within the Administration Centre, from the Websites menu, under the Websites interface, when editing a content managed webpage, with the Web Page Editor, the area's settings window can have the following settings configured:

• Initial Product Search Field: Set the product field that initially selected in the area to match products on with the search value set.Initially Select Add Product To Basket Checkbox: Controls if the checkbox should be initially selected, that controls if the first found product should be automatically added to basket.Select Product Pack Unit: Controls if a product can be purchased in packs, then the pack quantity of a product is added to basket, instead of the individual quantity.Default Product Quantity: Sets the default quantity that is set in the quantity textbox. This avoids the need for the user to type the quantity.

• quick_add_product_search_field: Input field for entering product code.
• quick_add_product_quantity_field: Input field for entering product quantity.
• quick_add_product_add_onclick: javascript function that adds the product to the user shopping list.
• quick_add_search_field_select: Drop down element that allows a user to select from an allowed product field that they can find products on.
• quick_add_product_found_div_id: ID to set for the element that displays when a product has been selected.
• quick_add_product_found_div_class: Name of the CSS class that controls the element that displays when a product has been selected.
• quick_add_product_allow_add_to_shopping_list_div_id: ID to set for the element that displays when a product has been selected that can be added to shopping list.
• quick_add_product_allow_add_to_shopping_list_div_class: Name of the CSS class that controls the element that displays when a product has been selected and can be added to a shopping list.
• quick_add_product_item_id_input: Hidden input that contains the product code of the product that has been selected.
• quick_add_product_item_id_input_id: ID of the textbox input that contains the product code of the product that has been selected.
• quick_add_product_is_combination_input: Hidden input that specifies if the selected product is a parent combination product or not.
• quick_add_product_is_combination_input_id: ID of the hidden input that specifies if the selected product is a parent combination product or not.
• quick_add_product_not_found_element_class: Name of the CSS class that controls the element that displays when no product could be found when the user performed a search.
• quick_add_product_not_found_element_id: ID to set for the element that displays when no product could be found when the user performed a search.
• quick_add_product_stock_quantity_div_id: ID to set for the element that displays the available stock quantity section of the selected product.
• quick_add_product_stock_quantity_div_class: Name of the CSS class that controls the element that displays the available stock quantity of the selected product.
• quick_add_product_stock_quantity_element_id: ID to set for the element that displays the available stock quantity of the selected product.
• quick_add_product_stock_level_div_id: ID to set for the element that displays the available stock quantity level section of the selected product.
• quick_add_product_stock_level_div_class: Name of the CSS class that controls the element that displays the available stock level of the selected product.
• quick_add_product_stock_level_image_id: ID to set for the image element that displays the available stock level image of the selected product.
• quick_add_product_stock_location_quantity_div_id: ID to place into the div that controls the element that displays the available stock quantity of the selected product for the users primary location.
• quick_add_product_stock_location_quantity_div_class: Name of the CSS class that controls the element that displays the available stock quantity of the selected product for the users primary location.
• quick_add_product_stock_location_quantity_element_id: ID to set for the element that displays the available stock quantity of the selected product for the users primary location.
• quick_add_product_stock_location_level_div_id: ID to set for the element that displays the available stock quantity level section of the selected product for the users primary location.
• quick_add_product_stock_location_level_div_class: Name of the CSS class that controls the element that displays the available stock level of the selected product for the users primary location.
• quick_add_product_stock_location_level_status_element_id: ID to set for the child element of div with ID quick_add_product_stock_location_level_div_id for the users primary location.
• quick_add_product_stock_location_level_status_class: Class to set for the child element of div with ID quick_add_product_stock_location_level_div_id for the users primary location.
• quick_add_product_stock_level_status_element_id: ID to set for the child element of div with ID quick_add_product_stock_location_level_div_id.
• quick_add_product_stock_level_status_class: Class to set for the child element of div with ID quick_add_product_stock_location_level_div_id.

Improvements

TOT-4017 - Send emarketing emails to users for favourite products that become back in stock

For users logged into content managed websites, there is now the ability for them to elect to receive email notifications, and be informed when products are back in stock that are within their favourites list. This may lead to increased sales since users can then receive the email notification and proceed back to the content managed website to purchase the products that are available again.
Within the Administration Centre, under the Inventory menu, within the Product Editor interface, an additional product field has been added labelled "Stock Available Since Date". The field stores the date that the product become back in stock again, based on a product's stock quantity being set greater than the Stock None level. The date field can be set if a product is a local product, otherwise it will be disabled.
Within the Data menu, within the Data Imports interface, under the Connector Imports tab, when a Products Connector data import is run, it will set the Stock Available Since Date, based on checking if the product's previous stock quantity is less than or equal to a product's Stock None level, and its new stock quantity is greater than the Stock None level. When this occurs the Stock Available Since Date will be set to the current date time. If a product's stock quantity was greater than the Stock None level but is now less than the Stock None level, then the Stock Available Since Date will be cleared. Alternatively the Stock Available Since Date field can be explicitly set with the product data received from the Connector software itself. Within the Text File Imports tab, the Products text file import can also have the Stock Available Since Date within the CSV file data. The field needs to have a date set in either the date formats dd/mm/yy or dd/mm/yyyy, or else be set empty for the Stock Available Since Date field to be cleared for a product. Within the inventory menu, under the Product Search interface, once a product is found, if the Export button is pressed then within the Export Products dialog there is now the ability to select the Stock Available Since Date product field, and include the date field.
Within the Administration Centre, under the Marketing menu, within the Marketing Settings interface, a setting has been added that's labelled "Product Back In Stock Notification Subscription Category". This can be set to one of the User Subscription Categories, that controls the subscription category that users can subscribe to if they wish to receive emarketing emails containing product-back-in-stock information.
Within the Users menu, in the Search Users administration centre interface, in the Advance Search, when the Search Category is set to Marketing, a new search rule has been added labelled "Select active users assigned to subscription category name equal to %value1% with favourite products back in stock in last %value2% hours". This rule can find users who are active, are assigned to a subscription category with the specified name, and contain products in their favourites list that have the Stock Available Since Date product field with a date that exists within a specified number of hours from the current date.
In the Marketing menu, within the Emedia Messaging interface, for an Emedia Email, within the Set Users dialog a User Group can be set up that uses this new user search rule to assign users to receive emarketing emails. This in effect allows users to receive emedia emails when they have favourite products that are back in stock within certain number of hours, and the users are assigned to the user subscription category that indicates that they wish to receive these kind of back-in-stock email notifications.
Within the Emedia Messaging interface for the Emedia item, within the Configure Email Message dialog, when the Send Email As setting is set to Rich Text or Both, then upon clicking on the Modify Web Page button, in the Web Page Editor, adding a new area to the page, in the New Webpage Area dialog, there's now the ability to select Search area type, then the new area type "Email Product Search Listing". This area can display a list of products only in Email based content managed web pages that are embedded within Emedia Emails. The area can have the following settings configured:

• Display In Area: If set to Favourite Product Stock Available Again, then the area will display a list of products that is with the user's favourites list that they have permission to view based on their assigned inventory role, and has a Stock Available Since Date that is later than the current date minus the hours set in the Stock Available Since Hours setting.
• Stock Available Since Hours: set the amount of hours that products containing a Stock Available Since Date must be within from the current date.
• Product Records Displayed: Controls the maximum number of product records that can display within the area. The maximum is 50 records, to ensure that the emails that the area embedded into can be generated fast.
• Sort Products By: Controls how the product records listed in the area are sorted by.
• Sort Products Direction: Controls the direction that product records listed in the area sorted by.
• Product Detail Webpage: Controls the content managed web page that is set within the URL for each product record listed in the area, that takes a user to view the details of the product.

• Email Product Search Listing Wrapper
  Displays the overall area contents, including any content wrapping around the list of product records.
• Email Product Search Listing Record
  Displays the details of each product record embedded within the Emedia product Search Listing area.

• A User Subscription Category is created that indicates that it's to be subscribed by users to receive back-in-stock notifications
• Active users area assigned to the nominated User Subscription Category to receive back-in-stock email notifications and have "Receive Marketing" setting selected.
• The user subscription category is assigned to an Emedia Email that has a User Group containing a User Search Rule to find users who have products in their favourites list, and those products have a "Stock Available Since Date" within the last number of hours
• The Emedia Email content contains a Email Product Search Listing area in its Rich Text web page that has the Display Products In Area setting set to "Favourite Product Stock Available Again", with the "Stock Available Since Hours" setting matching the User Group Rule hours
• One or more products have the "Stock Available Since Date" with a date set within the number hours from the current date.

TOT-4052 - Set Domain Keys Identified Mail (DKIM) credentials for all emails sent out

For all emails sent across a project, there is now the ability to include Domain Keys Identified Mail (DKIM) signature key and domain, that identifies the email as being sent from an allowed outgoing email server. This helps the email servers receiving emails to verify that the emails are coming from an allowed sender, and reduces the chances of the emails being bounced or flagged as spam.
For DKIM to work, DKIM private and public cryptographic keys must first be created. This can be done in several ways. One way is to use the OpenSSL console application (that by default is installed in most Linux operating systems) to generate the DKIM keys. To do so open up a console application and enter the following commands:run the following commands:

• openssl genrsa -out private.key 2048
• openssl rsa -in private.key -pubout -out public.key
• openssl pkcs8 -topk8 -nocrypt -in private.key -out private.pem

• Sender Email Address: Set the email address that indicates that the sender of all non-marketing email. If this is left empty then the sender will default to the From emaill address.
• DKIM Domain: Set the DKIM domain and selector that is used to by incoming email servers to validate that the email came from an allow sender. This must also be configured in the DNS text record under the website domain that is used to send the emails from. Set this setting to reduce the changes of emails being blocked. set selector such as default@mydomain.com, that would correspond to default._domainkey.mydomain.com DNS text record with DKIM public key.
• DKIM Private Key (PKCS8 Text Format): Set the DKIM private key (in the PKCS8 pem text format) that is used to encrypt the DKIM data in the emails sent out, that is validated by incoming email servers to validate that the email came from an allow sender. Ensure this private key was paired with the public key stored in the DNS DKIM text record. Ensure the private key starts with -----BEGIN PRIVATE KEY----- and ends with -----END PRIVATE KEY-----

• Sender Email Address: Set the email address that indicates that the sender of the emedia emails. This may be used by incoming mail servers to verify the sender with. If left empty then the From Email Address will be used instead.
• DKIM Domain: Set the DKIM private key (in the PKCS8 pem text format) that is used to encrypt the DKIM data in the emails sent out.
• DKIM Private Key: Set the DKIM private key (in the PKCS8 pem text format) that is used to encrypt the DKIM data in the emails sent out, that is validated by incoming email servers to validate that the email came from an allow sender. Ensure this private key was paired with the public key stored in the DNS DKIM text record. Ensure the private key starts with -----BEGIN PRIVATE KEY----- and ends with -----END PRIVATE KEY-----

• Sender Email Address: Set the email address that indicates that the sender of the website emails. This may be used by incoming mail servers to verify the sender with. If left empty then the From Email Address will be used instead.
• DKIM Domain: Set the DKIM private key (in the PKCS8 pem text format) that is used to encrypt the DKIM data in the emails sent out.
• DKIM Private Key: Set the DKIM private key (in the PKCS8 pem text format) that is used to encrypt the DKIM data in the emails sent out, that is validated by incoming email servers to validate that the email came from an allow sender. Ensure this private key was paired with the public key stored in the DNS DKIM text record. Ensure the private key starts with -----BEGIN PRIVATE KEY----- and ends with -----END PRIVATE KEY-----

TOT-4114 - Filter records by current month or previous month within all customer account listing content managed web page areas

On a content managed web page area that displays either a Customer Account Invoice Listing, Customer Account Sales Order Listing, Customer Account Back Order Listing, Customer Account Credit Listing,Customer Account Payment Listing, Customer Account Quote Listing, Customer Account Transaction Listing area, for the dange range drop down there are now 2 additional options to filter records based on the current month or the previous month. Within each of the content managed webpage area editors there is the ability to set this date range options "Current Month", "Previous Month" as the default for the area.
Additionally within the Administration Centre, from the Users menu, in the Customer Accounts interface, upon clicking on the Live Enquiry button, within the Account Enquiry interface, for each tab, within the date drop down filters there are now the 2 options "Current Month" and "Previous Month" to filter the records by.

Functionality Affected: Customer Account Invoice Listing, Customer Account Sales Order Listing, Customer Account Back Order Listing, Customer Account Credit Listing,Customer Account Payment Listing, Customer Account Quote Listing, Customer Account Transaction Listing content managed webpage areas
Impact: Minor

TOT-4115 - Show total invoice amount for the retrieved invoice records within Customer Account Invoice Listing content managed web page area

On a content managed web page area that displays a Customer Account Invoice Listing area, the area's "Customer Account Invoice Listing" format now contains a format hook labelled "invoices_total_inc_tax" that can show the aggregate total pricing of all retrieved invoice records, inclusive of tax within the area's Customer Account Invoice Listing format. The aggregated pricing hook rounds the pricing to specified number of decimal places controlled by the "Account Enquiry Record Price Decimal Places" setting within the Administration Centre's Stores settings interface, under the Accounting tab.
Note that this functionality is limited to aggregating pricing data to only the invoices that have been retrieved from the external business system.

Functionality Affected: Customer Account Invoice Listing content managed webpage area
Impact: Minor

TOT-4126 - Reset map zoom level after Distance Limit drop down has changed in Location Finder content managed web page area

On a content managed web page containing a Location Finder content managed web page area, if the area's Location Finder format contains the $search_distance_limit$ hook embedded within it, then when the hook's Distance Limit drop down has a value selected, then the zoom level of the map will change to fit the locations found within the selected distance.
Note that that Google's map API contains a limit on how many locations it can calculate distance from an address location given. As such only the nearest 24 locations will display on the map once an address or location has been specified within the Location Finder search form. This means that the user may set a larger distance that could have more than 24 locations available to show in the map, however only the first 24 locations will show. It may be best to display a message to indicate this existing limitation.

Functionality Affected: Location Finder content managed webpage area
Impact: Normal

TOT-4136 - Display customer account own addresses in Addresses drop down in User Details/Favourites/Orders content managed web page area

On a content managed web page area that displays a User Details/Favourites/Orders area, if the area is displaying the User Details form, in the Addresses drop down it now shows active addresses that belong to the customer account that have not been created by any user (such as if the addresses were imported against a customer account). This will also allow sales rep users to see the customer account own addresses, useful when managing customer accounts.
For these customer account "own" addresses the user is not be able to modify, or delete these addresses. Within the area's "User Detail Form" format, elements that allow to update or delete the selected address can be hidden or shown by utilising the following format hooks:

• address_update_class: CSS class name used to control if a Update Address button element should hide or show, allowing the user to save changes to the selected address. Contains either value update_address_Y or update_address_N
• address_update_element_id: Set within the ID of an element to control if a Update Address button element should hide or show, allowing the user to save changes to the selected address by controlling the element class.
• address_delete_class: CSS class name used to control if a Delete Address button element should hide or show, allowing the user to delete the selected address. Contains either value delete_address_Y or delete_address_N
• address_delete_element_id: Set within the ID of an element to control if a Delete Address address update button element should hide or show, allowing the user to delete the selected address by controlling the element class.

TOT-4138 - Automatically select product if only 1 product is found within the Product Quick Add Form content managed web page area

On a content managed web page that contains a Product Quick Add Form area, if the user types a search value into the autocomplete text box, if only one product is found in the autocomplete then the product will be automatically selected and loaded into the form, and focus onto the quantity box (or add the product to basket if the checkbox is selected to allow this). This avoids the user needing to press the enter key or select the product in the autocomplete, allowing products to be added to basket faster.

Functionality Affected: Product Quick Add Form content managed webpage area
Impact: Normal

TOT-4141 - Product Deals and Vouchers deal offer to discount products when a given quantity of combined products belong to the same parent combination product

Within the Product Deals and Vouchers feature, 2 new product deal offer types have been added that allows a user to get a given percentage off, or set price off the un-discounted price of products within their basket, when the products belong to a same parent combination product, and the quantity of those products combined exceeds a specified quantity threshold. This in effect allows users to get deals on products, when they purchase products in volume within each product combination.
Within the Administration Centre, under the Marketing section, within the Product Deals and Vouchers interface 2 new product deal offer types have been added to the Offer drop down, and within the Set Deal Detail dialog, these offers are:

• Buy Over X Quantity Of Products Belonging To The Same Parent Combination Product, Get Product For Y Percent Off Price
• Buy Over X Quantity Of Products Belonging To The Same Parent Combination Product, Get Product For Price Y

TOT-4147 - Profile and view server loading times of a content managed web page

For a content managed web page being requested, there is now the ability to profile and view the server loading times for the different aspects of the web page, before the server returns the final web page back to the web browser for rendering. This allows website implementors and administrators to gain greater insight as to why a web page takes time to load, as well as understand which components of the web page may be causing longer load times.
Within the Administration Centre, from the Websites menu, within the Websites interface, upon right clicking on a webpage and clicking the Properties context menu item, within the Edit Webpage Properties dialog. a setting has been added labelled Enable Webpage Profiler. If set to Yes, then when a content managed webpage is loaded, the Webpage Profiler will popup containing the time taken for the server to load the overall webpage, as well as as how long it took for each web page area to load, overall time for each web page container, and time it takes to create a new guest session if a session doesn't already exist for the user. Using these numbers allows website administrators to determine which areas may be taking longer time to load, and look at how those areas are configured, and whether area caching should be turned on to reduce web page load times.
It's highly recommended to leave the "Enable Webpage Profiler" webpage setting to No, unless profiling is actively being used, otherwise website users may also see web page profiling and not understand why the profiler is appearing.

Functionality Affected: content managed web pages
Impact: Normal

TOT-4149 - Product Deals and Vouchers deal offer to discount products by price or percentage when total quantity of products in basket belong to the same deal

Within the Product Deals and Vouchers feature, 2 new product deal offer types have been added that allows a user to get a given percentage off, or set price off the un-discounted price of products within their basket, when the combined quantity of products in the basket are assigned to the same deal and the aggregated quantity exceeds a specified quantity threshold. This in effect allows users to get deals on products, when they purchase a volume of any applicable products that have a combined quantity over a certain threshold. These applicable products could come from certain product categories, classes, attributes, or overall global inventory, all controlled by utilised using existing product search rules.
Within the Administration Centre, under the Marketing section, within the Product Deals and Vouchers interface 2 new product deal offer types have been added to the Offer drop down, and within the Set Deal Detail dialog, these offers are:

• Buy Over X Total Quantity Of Products In Deal, Get Product For Y Percent Off Price
• Buy Over X Total Quantity Of Products In Deal, Get Product For Price Y

TOT-4150 - Product search rules to find products assigned to product combinations within the Product Search and Product Deals and Vouchers Admin Centre interfaces

Within the Administration Centre, under the Inventory menu, within the Product Search interface, a new advanced search category has been added called "Product Combinations". This search category contains 3 new search rules, which are:

• Select all products assigned to parent combination products with parent %value1% %value2% %equaling% %value3%
• Finds all products that are assigned parent combination products that match the selected product field and value given.
• Select all products assigned to parent combination products and combination profile name %value1% %equaling% %value2%
• Finds all products that are assigned parent combination products that are assigned to the combination profile with the given name
• Select all products assigned to parent combination products with parent assigned to category %value1% %value2% %equaling% %value3%
• Finds all products that are assigned parent combination products, and the parent combination product is assigned to categories that match the selected category field and value given.

TOT-4151 - Canonical link tag webpage template hook for content managed webpages loading product detail URL with referencing category

On a content managed web page being loaded for a product, and the URL contains a query string that contains a referencing category that the request originated from, there is now the ability to embed into the head of the web page template a link tag, that contains a canonical URL without the any of the URL query string parameters. This help aids search engines to not separately rank product detail based pages that display the same product, when the URLs of the product contain differing query string parameters. This may help increase search rank for product detail pages.
Within the Administration Centre, under the Websites menu, within the Websites interface, upon clicking on a web page html template, and within the Webpage Template Properties dialog clicking on the Edit link, in the Edit Webpage Template Content dialog, the following hook can be embedded within the head of the web page template.
webpage_canonical_meta_link
The hook will output a canonical link tag containing the webpage URL if the webpage's URL matches a product, and the URL contains the parameter "ref_cat_id". If these conditions are not met then the template hook will be blank.

Functionality Affected: Content managed web page load
Impact: Normal

Bug Fixes

TOT-4123 - Customer Account Connector data import fails to complete when a new duplicate customer account record is imported

After an administrator user logged into the Administration Centre, clicked on the Data menu, then clicked on the Data Imports menu item. Within the Data Imports interface, under the Connector tab, if the Customer Accounts data import was selected and run, and the customer account record imported contains duplicate records that each have payment types assigned to each record, then the data import may have failed in the post import process and return the error: " a foreign key constraint fails (`kwtdb`.`account_payment_type`, CONSTRAINT `FK_account_payment_type_2` FOREIGN KEY (`Account_id`) REFERENCES `account_base` (`Account_id`) ON DELETE CASCADE ON UPDATE CASCADE)".
Now if the Customer Accounts data import is selected an run, and the customer account record imported contains duplicate records that each have payment types assigned to each record, then the data import is now able to correctly handle the duplicate records and allow the data import to complete. This issue is caused when dupicate customer account records exist that each have the same payment types assigned to the duplicate records. The data import correctly checks if a payment type has been assigned to the customer account record imported, and avoids trying to assign the payment type again.

Functionality Affected: Customer Accounts Connector data import
Impact: Major

TOT-4146 - Customer Account details not correctly displaying within User Detail content managed web page area when sent out within a Emedia Email

On a content managed web page that is linked to Emedia Email. If the web page had a User Detail area embedded within it, the customer account code and any other customer account details were embedded within the area's format, then when the Emedia Email is sent out, the customer account shown incorrectly displayed as the customer account that was assigned to the administrator user who sent out the Emedia.
Now when the Emedia Email is sent out, the customer account shown now correctly displays as the customer account assigned to the user who is receiving the email.

Functionality Affected: Emedia Email Sendout process
Impact: Normal

New Features

TOT-4090 - Integrate order checkout/submission with EFM Logistics freight provider

Within either the Trade interface or in a content managed website, after a user has added products to basket, then when they proceed through order checkout, in the checkout process there is now the ability to integrate into FlipGroup's OneFlo freight system to optionally calculate freight cost and carrier selection by calling OneFlo's system, as well submitting a confirmed order to OneFlo's freight system's, where consignments can be raised with freight carriers to deliver the ordered products.
OneFlo allows organisations to setup relationships with many freight carriers and allows us to use their webservice to obtain freight prices from all available freight companies to the organisation. Additionally OneFlo can have consignment notes created, which are then attached to the packaged goods when packed, and allow the goods to be tracked. Orders sent across to OneFlo can either be imported as orders that require staff to complete, by confirming freight unit and other details. Alternatively orders can be imported as consignment notes that already have most key information set, including freight carrier and freight unit. An account will need to be created within OneFlo's system first, and API credentials determined, before setting up a TOTECS project to push data across to OneFlo's system.
Within the order checkout process, OneFlo system may optionally be used to allow users to select from freight carriers that OneFlo's system has found, based in address data given and dimensions/weights of products being set. If used this can then optionally allow the order's freight surcharge to be accurately be set, using freight costs given by the carrier.
Within the Administration Centre, under the Stores menu, within the Freight Providers setting interface, a number of additional settings have been created.The "Send Freight Orders To 3rd Party Freight Provider" setting now has an option "OneFlo - Order". If set this allows orders submitted to be pushed across to OneFlo's system, to be completed and then create freight consignments for.A new setting labelled "Get Carrier Selection From Freight Provider" that controls the freight provider that should be called to obtain the list of freights carriers and costs used during the order checkout process, if the "Freight Provider Calculate Order Freight Surcharge" is set to Yes. By default if the "Send Freight Orders To 3rd Party Freight Provider" setting was set to a Smartfreight option then the "Get Carrier Selection From Freight Provider" will be set to Smartfreight as well.A new settings section has been added labelled "Freight Provider - OneFlo" that allows the following settings to be configured and required for requests made to OneFlo's system:

• OneFlo Account Number: Set the number/ID of the account in OneFlo's system to use to authenticate and push freight orders into OneFlo's system with. This can be obtained after registering an account with OneFlo.
• OneFlo Web Service API URL: URL of OneFlo's system to call its API. By default this will already be set, but in the future OneFlo may change their API domain in the future. Note only set the domain without the https protocol or any other relative URLs.
• OneFlo Web Service API Key: Key/password of OneFlo's system to authenticate against its API. This will need to be obtained by talking to OneFlo or obtaining it from it's system.

TOT-4122 - REST API endpoint to trigger sending out an Emedia Email from 3rd party software

Within the TOTECS platform's API (Application Programming Interface) there is now an API endpoint that supports being able to send out an Emedia Email called from external software. This will allow emails to be triggered to send out at scheduled times using software such as the Connector software to do so. This may allow any type of Emedia Email to be sent out on schedule basis (such as emails covering topics such as weekly product deals etc..) without requiring administrator users to login to the Administration Centre to trigger the Emedia being sent.

Functionality Affected: API, Emedia Emails Sendout
Impact: Normal

Improvements

TOT-4117 - Display drop down to allow all shared shopping lists for sales rep users to be shown within a Shopping Lists Listing content managed web page area

On a content managed web page displaying a Shopping Lists Listing area for a user who is a sales rep, there is now the ability to embed a format hook that gives the user drop down options to either see only shopping lists shared to them based on their current assigned customer account, or show all shopping lists shared across all the customer accounts they have access to. This filtering option is only be able to be used when the Sales Rep feature is turned on, the user is a sales rep, the Shopping List Sharing feature is turned on, and the user has facility role permission "View Shared Shopping Lists" set to allow.
Additionally the area is also now able to show shopping lists shared to the sales rep that has been shared to them. For each shopping list shared there's the ability to show additional data of the shopping's lists owning user.
Within the Shopping List Listing content managed webpage area's "Shopping List Listing" format, the following hooks have been added:

• shoppinglist_show_shared_filter: Either Y or N. If Y then the user is allowed to filter shopping lists shared with them. This may be used to hide or show the shared filter select element in the following hook.
• shoppinglist_shared_filter_select: Select drop down element that allows the user to filter shared shopping lists, based on the active customer account if the user is a salesrep, or show all shopping lists

• shoppinglist_owner_login_id: Login ID of the user who shared the shopping list. Only displays if the shopping list is shared from another user.
• shoppinglist_owner_account_id: Account ID of the user who shared the shopping list. Only displays if the shopping list is shared from another user.
• shoppinglist_owner_contact: Contact name of the user who shared the shopping list. Only displays if the shopping list is shared from another user.
• shoppinglist_owner_email: Email of the user who shared the shopping list. Only displays if the shopping list is shared from another user.
• shoppinglist_relationship: Displays either MINE, SHARED_TO_ME, or SHARED_BY_ME. Indicates if the shopping list is owned by the user (MINE), it was shared to another user (SHARED_BY_ME), or another user has shared the shopping list (SHARED_TO_ME)

TOT-4120 - Allow sales rep users to share shopping list by Account ID or Login ID within the Shopping List Sharing Form content managed web page area

On a content managed web page displaying a Shopping List Sharing Form area for a user who is a sales rep, and has permission to share shopping lists, as well as view account users with the "View Customer Account Users" facility role permission, there is now the ability for the user to find other users to share a list with, based on matching the Account ID or Login ID of the user. A drop down element can optionally be displayed where the sales rep user can choose the method to find and match a user on, either Email, Account ID, or Login ID. The existing "shoppinglist_share_email_field" can then be used instead to type an Account ID or Login ID to find users on.
Within the Shopping List Sharing Form content managed web page area's "Shopping List User Sharing Form" format the following hooks have been added:

• shoppinglist_salesrep_allow_share: Either Y or N. If Y then the user is a salesrep who is allowed to the find and share the shopping list to existing users. This can be used to control if the shoppinglist_share_search_type_select hook to display or not.
• shoppinglist_share_search_type_select: Select element that controls how salesrep users can search for users to share the shopping list with, based on the user field selected.

TOT-4121 - Dynamically load and paginate records within the Payments Admnistration Centre interface

Within the Administration Centre, under the Stores menu, within the Payments interface, for the payment records loaded within the table, the table now only loads the number of payment records that are need to display for a full page.
Any subsequent pagination will need to call the server to load the next page of records. This can dramatically speed up the payments loading, especially when over 1000 or 10,000 payment records exist.

Functionality Affected: Payments Administration Centre interface
Impact: Normal

TOT-4099 - Additional customer account content managed webpage global format hooks that update when user switches customer account

On a content managed website, for any area, the following global format hooks can now be embedded within any content managed web page area, Each of these global format hooks will change their values when a user switches between customer accounts, showing details of the current customer account in use. Within the Administration Centre, under the Websites menu, within the Websites interface, when modifying a web page area format, in the Edit Web Page Area Format dialog the following hooks are now listed within the Global Format Hooks tab:

• SES_account_authority_number: Authority number (such as ABN, NZBN, ACN) set for the customer account that the user is assigned to.
• SES_account_contact: Name of the contact set for the customer account that the user is assigned to.
• SES_account_email: Email address set for the customer account that the user is assigned to.
• SES_account_address_primary_contact: Name of the contact associated to the primary address of the customer account in use in the user's session.
• SES_account_address_primary_org_name: Name of the organisation associated to the primary address of the customer account in use in the user's session.
• SES_account_address_primary_address1: First address field of the primary address of the customer account in use in the user's session.
• SES_account_address_primary_address2: Second address field of the primary address of the customer account in use in the user's session.
• SES_account_address_primary_address3: Third address field of the primary address of the customer account in use in the user's session.
• SES_account_address_primary_address4: Fourth address field of the primary address of the customer account in use in the user's session.
• SES_account_address_primary_country: Country of the primary address of the customer account in use in the user's session.
• SES_account_address_primary_postcode: Postcode of the primary address of the customer account in use in the user's session.
• SES_account_address_primary_phone: Phone number of the primary address of the customer account in use in the user's session.
• SES_account_address_primary_fax: Fax number of the primary address of the customer account in use in the user's session.

TOT-4103 - Setting to always reload page for a new search within the Product Search Form (Using Search Profiles) content managed web page area

On a content managed web page display a Product Search Form (Using Search Profiles) area, f a search is triggered in the area and the area's "Search link to target page" setting matches the same page that the area displays on, then there is now a setting that allows the search to trigger a full web page reload if set to yes. This can always ensure that the elements on the web page are fully reloaded, as well as the URL updates with the new search.
After logging into the Administration Centre, under the Websites interface, upon editing a web page that contains a Product Search Form (Using Search Profiles) area, in the area's Settings window a setting labelled "Search Reloads Web Page". If the setting is set to Yes, then when the area is loaded on the webpage, any time the area is triggered to perform a new search it will cause the web page URL to change and fully reload.

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

TOT-4105 - Format hooks to paginate to first and last results pages within content managed web page areas containing next and previous paginators

On a content managed web page displaying Product Search Results Listing, Category Listing, Model Search Listing, Basket Listing and Customer Account Contract Detail areas, there is now the ability to allow the user to paginate to the last page of records found, as well as to the first page of records. This allows users to navigate back to the top or bottom of the listings more easily and quickly.The following format hooks have been added to each area:
Product Search Results Listing area
Product Search Header and Product Search Listing Footer formats

• view_first_search_page_anchor: Anchor tag to click through to the first page of the search product list.
• view_last_search_page_anchor: Anchor tag to click through to the last page of the search product list.

• view_first_category_page_anchor: Anchor tag to click through to the first page of the category list.
• view_last_category_page_anchor: Anchor tag to click through to the last page of the category list.

• view_first_search_page_anchor: Anchor tag to click through to the first page of the search model list.
• view_last_search_page_anchor: Anchor tag to click through to the last page of the search model list.

• basket_products_first_page_class: CSS class that specifies if the first page of basket product records can be loaded.
• basket_products_last_page_class: CSS class that specifies if the last page of basket product records can be loaded.
• basket_products_first_page_anchor: Anchor tag to click through to the first page of the basket products list.
• basket_products_last_page_anchor: Anchor tag to click through to the last page of the basket products list.

• product_records_first_page_class: CSS class that specifies if the first page of product records can be loaded.
• product_records_last_page_class: CSS class that specifies if the last page of product records can be loaded.
• product_records_first_page_onclick: javascript function that allows the first page of product records to load
• product_records_last_page_onclick: javascript function that allows the last page of product records to load

TOT-4106 - Include product stock level with data passed to AFTER_PRODUCT_ADD_TO_BASKET content managed webpage event function

On a content managed web page that has implement custom javascript that is listening to when a product was successfully added to basket, using AFTER_PRODUCT_ADD_TO_BASKET web page event function. the basket product data returned in the 2nd argument of the basket's listener function now includes the product's new stock level, factoring in the overall available stock quantity of the product minus the quantity of the product that was added to basket. The data can be found in the attribute named "productStockLevel", and will contain the values, high, low or none.

Functionality Affected: Add To Basket content managed web page javascript
Impact: Normal

TOT-4110 - Allow users to assign other customer account users to review an order within the Order Checkout/Submission content managed web page area

On a content managed web page that contains a Order Checkout/Submission area, there is now the ability to allow users to assign another user to review the order once it has been submitted, if the user is assigned to a facility role with the "View and Submit Quoted Orders" permission set to allow.
After the user has logged in and proceed to a web page containing a Order Checkout/Submission area, in the Order Details a checkbox can be embedded that specifies that a user should be assigned to review the order. Additionally a drop down form element can display a list of users assigned to the same customer account that can be selected. Once the checkbox and user has been selected, then on the Order Review stage the reviewing user's login ID can be displayed. Upon the order being submitted the reviewing user will receive an email advising of the order that is pending their approval, using the existing review email and process.
Within the area's Order Details Form format the following hooks have been added:

• order_user_review_allow: Either Y or N. If Y then a user is allowed to be assigned to review the order.
• order_user_review_select: Select form element containing a list of users that can be assigned to review the order.
• order_user_review_checkbox: Checkbox form element that indicates if a user should be assigned to review the order.

• _PO_ReviewerLoginID: Login ID of the user who is assigned to review the order.
• _PO_ReviewerUserAssigned: Either Y or N. Set to Y when a user is assigned to review the order. This could be used to hide or show the reviewer login ID depending on if a user is assigned or not.

TOT-4111 - Search models on attribute value within the make/model autocomplete search box in Model Search Form content managed web page area

On a content managed web page displaying a Model Search Form area, when a user is using the make/model autocomplete search box to find matching models, there is now the ability to optionally match on models that contain an attribute value that matches the search text given. If a match is found then then the ranking of the model is is higher than all other ranking factors. This allows specific search terms to be set against models that be used to show more relevant models to the user.
Additionally the area now contains a setting that allows the first record in the make/model autocomplete list to not be selected by default. When set the enter key press instead trigger a make/model search to occur instead, taking the user to the content managed web page used to display a list of matching models.
The area's model search autocomplete now ranks higher models that match attribute keyword values given. Previously it was possible that model could be ranked higher if the words matched in the text were highly correlated to the model's name.
Within the Administration Centre, under the Websites interface, for a content managed web page, within the Web Page Editor page, for Model Search Form area, in the Area Settings window the additional settings have been added:

• Model Auto Complete Ranking Attribute - Allows user to select a model attribute that will be used by the make/model autocomplete to optionally match models on and rank up higher compared to other types of matched.
• Model Auto Complete Select First Record - If No then the first make/model record in the make/model autocomplete results is not selected.

• make_model_autocomplete_input_id: ID of the make/model autocomplete textbox input used to type search text in. Place within the text input where the user enters the search text.
• make_model_autocomplete_search_onclick: Javascript function to trigger a make/model search to occur with the value set in the autocomplete input. This hook depends on an text input existing with the make_model_autocomplete_input_id hook set within its ID attribute,

TOT-4116 - Allow an empty shopping list to be created from the Shopping List Products Import Form content managed web page area

On a content managed web page that displays a Shopping List Products Import Form area, in the area it has ability to create a new empty shopping list when configured. This allows a shopping list to be created without requiring products to be in the user's basket initially.
Within the area's "Shopping List Product Import Form" format an additional hook has been added labelled "shoppinglist_create_empty_onclick" that contains a javascript function that calls for a new shopping list to be created without any products in it. After the shopping list has been created any Shopping List Listing areas will reload to show the new shopping list.

Functionality Affected: Shopping List Products Import Form content manged web page area
Impact: Normal

Bug Fixes

TOT-3966 - Add To Basket and User Login taking very long time to load when user has a product deal applied to basket and the product is applicable to more than one "basket total" based deals

If a user logged into a content managed website or the Trade interface and the 'Re-price Basket Products On Login, Basket Switching And Order Checkout' setting is set to 'Yes', if the user had a product in their basket, and that product was assigned to one or more active deals that had the offer type set to one of the following:

• Buy Over X Price Of Basket Total (Ex. Product Redeemed), Get Product For Price Y
• Buy Over X Quantity Of Total Basket Products (Ex. Product Redeemed), Get Product For Price Y
• Buy Over X Quantity Of Total Basket Products, Get Product For Price Y
• Buy Over X Price Of Basket Total (Ex. Product Redeemed), Get Product For Y Percent Off Price
• Buy Over X Price Of Basket Total (Ex. Product Redeemed), Get Product At Price Level Y
• Buy Over X Quantity Of Total Basket Products (Ex. Product Redeemed), Get Product For Y Percent Off Price
• Buy Over X Quantity Of Total Basket Products, Get Product For Y Percent Off Price
• Buy Over X Price Of Total Basket Products (Before Discounts), Get Product For Y Percent Off Price
• Buy Over X Price Of Total Basket Products (Before Discounts), Get Product For Price Y

TOT-4098 - basket_record_user_owns_basket format hook incorrectly displaying N for baskets that a user owns within a Basket Selection content managed web page area

From a content managed web page containing a Basket Selection area, for each basket listed, in the Basket Selection Record format the record hook $basket_record_user_owns_basket$ would incorrectly output 'N' for a basket a user has created and is not actively using. Now correctly outputs 'Y' for a basket a user created and it belongs to.
An additional format hook has been added to the Basket Selection Record format labelled "basket_record_user_can_delete_basket" that outputs either 'Y' if the user has permission to delete the basket or 'N' if the user doesn't have permission to delete the basket. Note that this format hook differs to the basket_record_user_owns_basket hook since it does not indicate whether the user can deleted the basket or not, based on if they are actively using the basket.

Functionality Affected: Basket Selection content managed webpage area
Impact: Normal

TOT-4109 - Payment records failing to load after clicking on Unsent Payments alert link from the Administration Centre home page

After a user logged into the Administration Centre, if they saw an Alert message to view unsent payments, orders, or freight orders, the link to the corresponding administration centre interface had it set to the insecure domain. Because of this the Payments or Orders interface was unable to correctly load.
Now the link to the corresponding administration centre interface is now set to use the secure domain. This ensures that the Payments and Orders interface correctly load.

Functionality Affected: Home Administration Centre interface
Impact: Minor

New Features

TOT-4092 - REST API endpoint to export product images

The Data API in the platform has now been modified to allow administrator users and normal users to export product image reocrds programmatically from a project.
This can allow 3rd party customer systems to obtain all product image data in their own website, squizz, or business systems by using the data API to export the data.
Within Administration Centre interface under the Data menu, in Data API it will now display logs of requests that are made to the API to obtain product image data. This allows administrators to see which users are exporting image data.
When product image data is exported from the API, the product images that are returned from the API endpoint will be limited to the products that are active and the images that are active. Additionally if a non admin user is calling the API endpoint then they will be only be able to retrieve images for products that they are allowed to view, based on their assigned inventory role and contracts. Also within the User Permissions Administration Centre interface, in the Facility Role details the permission "Data API Product Image Export" has been added. For non admin users this permission must be set to allow to allow them to export product images from the API.

Functionality Affected: Product Images data export API endpoint
Impact: Normal

TOT-4093 - REST API endpoint to export category images

The Data API in the platform has now been modified to allow administrator users and normal users to export categoery image records programmatically from a project hosted on the TOTECS platform.
This can allow 3rd party customer systems to obtain all category image data in their own website, squizz, or business systems by using the data API to export the data.
Within Administration Centre interface under the Data menu, in Data API it will now display logs of requests that are made to the API to obtain category image data. This allows administrators to see which users are exporting image data.
When category image data is exported from the API, the category images that are returned from the API endpoint will be limited to the categories that are active and the images that are active. Additionally if a non admin user is calling the API endpoint then they will be only be able to retrieve images for categories that they are allowed to view, based on their assigned inventory role and contracts. Also within the User Permissions Administration Centre interface, in the Facility Role details the permission "Data API Category Image Export" has been added. For non admin users this permission must be set to allow to allow them to export category images when calling the API.

Functionality Affected: Category Images data export API endpoint
Impact: Normal

TOT-4095 - REST API endpoint to export categories

The Data API in the platform has now been modified to allow administrator users and normal users to export category tree records, category records and assigned product mappings programmatically from a project hosted on the TOTECS platform.
This can allow 3rd party customer systems to obtain all category data in their own website, squizz, or business systems by using the data API to export the data.
Within Administration Centre interface under the Data menu, in Data API it will now display logs of requests that are made to the API to obtain category data. This allows administrators to see which users are exporting category data.
When category data is exported from the API, the categories that are returned from the API endpoint will be limited to the categories that are active. Additionally if a non admin user is calling the API endpoint then they will be only be able to retrieve categories that they are allowed to view, based on their assigned inventory role and contracts. Also within the User Permissions Administration Centre interface, in the Facility Role details the permission "Data API Category Export" has been added. For non admin users this permission must be set to allow to allow them to export category data when calling the API.

Functionality Affected: Categories data export API endpoint
Impact: Normal

Improvements

TOT-4041 - Track and display recently viewed products within the user's session in a Product Search Results Listing area

On a content managed website there is now the ability for users to able to view a list of recently viewed products that they have previously viewed within a content managed web page containing a Product Detail area, in a single user session. When a content managed web page displays a product within a Product Detail area, the product will be added to a list of recently viewed products in the user's session. Within the Administration Centre under the Inventory menu, in the Product Settings interface, a setting labelled "Session Recently Viewed Products Limit" has been added that controls the maximum number of products that can be stored in the user's Recently Viewed Product List. Once the list has been filled up then it remove the earliest viewed product within the list.
On a content managed web page displaying a Product Search Results Listing area, the area's "Display In Area setting" a radio option labelled "Session Recently Viewed Products" has been added that allows the list of products in the session's recently viewed list to display in the area. This allows each product to show data and formatting using the area's existing formats, as well as existing settings to control the sorting, and number of products that display in the area, among other settings. Note that the list will always sort the products from the last viewed to earliest viewed.

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

TOT-4061 - Make/model autocomplete search box within Model Search Form content managed web page area

On a content managed web page displaying a Model Search Form area, there is now the ability to display an autocomplete search box that allows the user to search for a list of models that partially match the search text entered by the user, as well as a list of makes. For the first 10 models and makes that match the search text can be displayed within a search list element.
If a model is selected within the list then the user can be redirects to a configured content managed web page that allows the details of the model to be displayed. If a make is selected within the list it can redirect the user to a configured content managed web page that allows a list of models to be displayed in a Model Search Listing areas. Selecting either make or model can also update areas on the same page if the area settings are confirmed to display on the same page.
Both the styling of the autocomplete search text input, and the search results listing can be highly customised within the existing Model Search Form area format. The auto-complete results listing needs to be composed of at least 2 elements. An outer wrapping element that contains all the search elements, and an unordered or ordered list element where the results records will be displayed within. Additionally other elements can be added to display different messages based on the state of the auto-complete occurring.
Within the Model Search Form format the following hooks have been added to the format:

• make_model_autocomplete_onkeyup: Javascript function to to trigger make/model autocomplete search, or handle selection, from a key press. Place in onkeyup attribute of a text input.
• make_model_autocomplete_onblur: Javascript function to hide the make/model autocomplete results elements. Place in onblur attribute of the search text input.
• make_model_autocomplete_results_wrapper_id: ID of the HTML element that is the container to display make/model auto-complete results within. Place within the ID attribute of an element.
• make_model_autocomplete_results_class: Name of the css class used to control the initial stying of the make/model auto-complete results elements.
• make_model_autocomplete_results_list_id: ID of the list HTML element used to display the found records of a make/model auto-complete search. Place within the ID attribute of an unordered or ordered list element.

For the search results wrapper element it's class attribute will be set to one of the following css class names when an auto-complete search is occurring:

• autocomplete_hide_results: Is set when there's no search occurring in the make/model auto-complete.
• autocomplete_show_loading: Is set when there's request is being made to the server to perform a make/model auto-complete search.
• autocomplete_show_results: Is set when the make/model auto-complete search found one or more make or model records.
• autocomplete_show_no_results: Is set when the make/model auto-complete search found no make or model records.
• autocomplete_show_error: Is set when the make/model auto-complete search had an error occur when trying to perform the search. This is most likely due to a internet connection issue, or else a server searching error.

For the search results list element, one of its child list elements may have the following class set if the user had selected the list element, using up or down arrow keys within the auto-complete input element.

• autocomplete_record_selected: Is set when the user has selected the make/model list element.

Within the search results list element, each child list element displayed, its inner HTML may either display the Make Record format of a Make was found, or the Model Search Record format if a Model was found. Within each format the data about the make or model found can be customised, as well as include other elements such as buttons or links to take the user the relevant web page. Use CSS to control how the results elements show, such as an autocomplete that has the results appear as a drop down, as a full search table, or something in between.

Functionality Affected: Model Search Form content managed web page area
Impact: Normal

TOT-4062 - Display RRP pricing for invoice lines within a Customer Account Invoice content managed web page area

On a content managed web page that contains a Customer Account Invoice area, after the area has retrieved the invoice record data from the externally connected business system, for each invoice line displayed within the area that's an "Item" line there is now the ability to display recommended retail pricing (RRP) if the invoice line code matches an active visible product in the project, and the product contains a price-level unit price for the RRP price level that has a price that is greater than invoice line's unit price excluding tax. Within the Customer Account Invoice area a setting labelled "Show RRP Pricing In Invoice Product Lines" specifies whether RRP pricing should be attempted to be found for the invoice lines. If set to Yes then the RRP pricing look ups for each invoice line will be attempted else if set to No then lookups will be ignored.
Within the area's "Customer Account Invoice Line Item" format the following format hooks have been added to be able to display RRP pricing data for each invoice line:

• invoice_line_rrp_price_ex_tax: Recommended retail unit price of the product line, excluding any tax amount.
• invoice_line_rrp_price_inc_tax: Recommended retail unit price of the product line, including all tax amounts.
• invoice_line_rrp_price: Recommended retail unit price of the product line, either exclusive of or including tax amounts, based on the tax format setting of the user.
• show_invoice_line_rrp_price: Either Y or N. Shows Y if the user should see the recommended retail pricing based on if RRP pricing was found and is greater than the unit price of the line excluding tax amounts. Use this hook within element class names to hide or show RRP pricing data using CSS styling rules.

Note that the RRP pricing needs to be previously imported and configured to a price level to be able to show. This RRP pricing is not coming from the retrieved invoice line data.

Functionality Affected: Customer Account Invoice content managed web page area
Impact: Normal

TOT-4076 - Only create a basket for guest users once they attempt to add a product to basket

When a guest user first visits a content managed website an empty basket will no longer be initially created for the user.
This may slightly improve response times for the initial page request, as well as reduce the amount of empty baskets that link in the project.
When an attempt is made to add a product to basket a basket will be created for the user if no basket previously existed.

Functionality Affected: User Login process, Add Product To Basket process
Impact: Normal

TOT-4077 - Add Apple's crawler, Common Crawler, Huawei's and Amazon's crawlers to the list of known crawlers within the Project Traffic Statistics Administration Centre

For website traffic making webpage requests for a project, there is now the ability to detect when Apple's crawler is making a request, as well as Common Crawler, Huawei and Amazon, based on the user-agent in request containing the word "applebot", "ccbot", "amazonbot" or "petalbot".
Within the Administration Centre interface, under the Statistics menu, in the Project Traffic Statistics interface, under the "Requests By Search Engines, Crawlers and Software" pie graph it can now show requests that are made by the Apple crawler, with the crawler's name "Apple" appear in the colour of grey, as well as the "Common Crawler" in the colour of darker yellow, , and "Huawei" in the colour of darker red, and "Amazon" in a yellow colour. Note these Apple, Common Crawler, Huawei and Amazon requests will only be identified by future requests made, for previous requests they will continue to be identified as the generic "Other Crawlers" label.
Note that Apple and Amazon's crawlers have been added to TOTECS default allowed crawler list, since both companies have a large market share in online searching.

Functionality Affected: web page/area requests, Project Traffic Statistics administration centre interface
Impact: Normal

TOT-4080 - HTML escape Searchword format hook value within the Product Search Results Listing content managed web page area

On a content managed web page area that displays a Product Search Result Listing area, within the area's Product Search Header format, for the "searchword" format hook, its value is now HTML escaped to avoid URL code injection attacks to be allowed to occur.
This would only occur if a user had entered html code within a the Product Search Form area, and it called for the Product Search Results Listing to show the search text entered within the Product Search Header format.

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

TOT-4081 - Setting to optionally logout users from a content managed website if their originating public IP address, or browser user agent changes mid session

If a logged in user accesses a content managed website, then there is the ability to log out users out of their session if their session is transferred to another computer, or alternatively web browser when being logged in. This can avoid users being able to share and use sessions across different internet connections, computers or applications, reducing multiple people using the same session.
Within the Administration Centre, under the Website Settings interface, a setting labelled "Logout User Website Session When Shared" has been added. The setting has the following options:

• No: The user's session won't be logged out if the user's session is being used on a different internet connection or web browser/computer.
• Yes - When IP Address Changes: If the originating internet IP address of the user session changes then the user's session will be logged out. Note this will affect users who use alternating internet connections, which may be set up in large organisations, or for home internet connections with routers containing unreliable internet connections, that either regularly swap between fixed internet connections and mobile connections, or else continually need to reconnect to the internet with a different IP address.
• Yes - When Web Browser User Agent Changes: If the web browser identified in the user session changes then the user's session will be logged out. This could occur if the user opens up the session on a different web browser, or computer using not exactly the same browser and operating system version/configuration.

The Yes - When Web Browser User Agent Changes may be a safer option if wanting to put these additional security mechanisms in place.

Functionality Affected: content managed web pages, Website Settings administration centre interface
Impact: Normal

TOT-4087 - Set Price Tax Format field within the Create New User Administration Centre interface

Within the Admin Centre, after opening the Users menu, within the Create New User interface, the Price Tax Format field displays, allowing the administrator user to set if the user sees product pricing inclusive or excluding tax by default after the user has been created.

Functionality Affected: Create New User administration centre interface
Impact: Minor

TOT-4091 - Administration Centre interfaces to load over secure https connection

Within all the Administration Centre's all of the interfaces from within the Administration Centre menus now except for the Websites interface load over a https connection, ensuring data within the interfaces is only accessible between the end client browser and the TOTECS servers.
The Websites interface will be look to be secured in a future release.

Functionality Affected: Administration Centre interfaces
Impact: Normal

TOT-4094 - Optimise the speed and efficiency of the connector pricing data imports

Within the Administration Centre, under the Data menu, within the Data Imports interface, under the Connector tab, when the Product Price Level Pricing, Product Price Level Quantity Pricing and Product Account Pricing data imports are run either from within the interface or from the Connector, the speed and efficiency of the data imports has been improved. These changes can reduce the amount of pricing records that need to be deleted, updated or created in a project's database, as well as avoid existing records having their IDs changed, avoiding upper limits on IDs being reached which causes pricing records to not import.
The pricing data imports will now obtain all existing pricing records and then check against the importing pricing records. For existing price records they will only be updated in the back end database if the record's data has changed, otherwise no changes are needed to be made. This may heavily reduce the amount of pricing records that need to be altered, speeding up the imports when little pricing data has changed between imports. If lots of pricing data has changed since the previous import then the efficiencies may be less, as well as when incremental imports are performed with little pricing changes, but a large amount of pricing records already exist.

Functionality Affected: Product Price Level Pricing, Product Price Level Quantity Pricing and Product Account Pricing Connector data imports
Impact: Major

Bug Fixes

TOT-3176 - All settings changed within all Administration Centre settings interfaces revert back to the old setting if the user navigates between tabs

Within the Admnistration Centre, within any of the settings interfaces accessible from the Inventory, Users, Marketing, Stores, Websites, Statistics, or Data menus, if a user has changed a value of a setting, clicked the save button, then clicked on a different tab in the interface, the settings page will now reload allowing the latest settings to be loaded across all the tabs.
Previously the settings tab would incorrectly display the old values when navigated back to after saving.

Functionality Affected: Settings administration centre interfaces
Impact: Minor

TOT-4074 - Customer Account Contracts Connector data import failing to complete when assigning a product to an existing contract that has a contract code starting with whitespace

Within the Administration Centre, under the Data menu, within the Data Imports interface, under the Connector tab, when a Customer Account Contracts Connector data import ran, an error would occur when the import is trying to assign a product to contract and had white space infront of the contract code.
With changes made to the Customer Account Contracts Connector data import trimming spaces from the contract code, when the products were being assigned to the contract, the contract product records were not correctly being able to match to the contract code containing the space, and the database was incorrectly trying to create new contract product records.
Contract codes have all surrounding whitespace removed to avoid this issue happening in the future. Additionally if errors occur while records are being imported, the error message will now indicate which record number was being processed when the error occurred. This may make it easier to determine which record is causing the problem.

Functionality Affected: Customer Account Contracts Connector data import
Impact: Normal

TOT-4083 - Payments unable to load within Payments Admin Centre interface if a payment record contains a tab character within its Notes field

Within the Administration Centre, under the Stores menu, within the Payments interface, the list of payments may have been failing to load within the Payments table, if one or more payments contained tab characters within its Notes field.
Now the list of payments loaded into its table now correctly handles payments that contains tab characters within its Notes field.

Functionality Affected: Payment administration centre interface
Impact: Normal

TOT-4086 - Security Answer not being correctly set by the Users Text File data import

Within the Administration Centre, upon clicking on the Data menu button, then clicking on the Data Imports menu item link, within the Data Imports interface, if the user uploaded a spreadsheet CSV file against the Users data import, if the CSV file had the "Password Answer" column set to the security answer for the user and the file successfully imported. Then when the user tries to enter the same password within the Forgot Password area on a content managed website, the area would return an error message indicating that the answer is not correct.
Now if the user uploads a spreadsheet CSV file against the Users data import and the CSV file had the "Password Answer" column set to the security answer for the user, then when the file successfully imports the Security Answer will now correctly be set to allow users with the same answer to progress through the Forgot Password feature. This bug was introduced when additional security measures were introduced on how the security answer was stored.

Functionality Affected: Users text file data import
Impact: Normal

New Features

TOT-4056 - Send submitted order data to Google Analytics from Order Checkout/Submission and Guest Order Checkout/Submission content managed web page areas

On a content managed website containing a webpage with either a Order Checkout/Submission area, or a Guest Order Checkout/Submission area, once an order has been submitted there is now the ability to send the confirmed order details across to Google Analytics via its Google Tag Manager feature, allowing Google to provide additional statistics on details of the users, orders and products associated to the orders being submitted.
To allow the ordering areas to send order information back to Google Analytics the following needs to already have occurred:

1. A Google account has been created
2. Google Analytics has been enabled for the account
3. Ecommerce Reporting has been turned on within the Google Analytics account
4. Google Tag Manager has been enabled for the account
5. At least one tag has been created within Google Tag Manager that is used to record submitted orders against it.
6. The Tag within Google Tag Manager is linked to a "Google Analytics: Universal Analytics" tag type, with its Track Type set to "Transaction", and the Google Analytics settings contains the Tracking ID of the Google Analytics account
7. The Tag within Google Tag Manager contains a custom event trigger with a specified name, such as "confirmed-sale, purchase, weborder"

Once both Google Analytics and Google Tag Manager have been set up, then within the Administration Centre, under the Websites menu, within the Websites interface, upon editing a content managed web page that contains either a Order Checkout/Submission area, or a Guest Order Checkout/Submission area, in the area settings dialogs the following settings have been added under the "Order Reporting - Google" sub heading:

• Google Tag Manager ID: ID that google has been for the Google Tag Manager account to report order submissions against
• Google Tag Event Name: Name of the custom event that has been set up in the trigger for the tag within Google Tag Manager
• Report Orders To Google Tag Manager: If set to Yes then when a user submits an order, the order details sent across to Google Tag Manager and on to Google Analytics. The order data reported includes: Order ID, name of the company supplying, order total inc. tax, order total tax, order surcharge total inc. tax
• Report Order Products To Google Tag Manager: If set to Yes then when a user submits an order, the order details sent across to Google Tag Manager will also include a list of products submitted. In the order product data will include, product code, product name, unit price inc. tax, quantity

Note that the Google Tag Manager ID, Google Tag Event Name, Report Orders To Google Tag Manager settings must all have values set, otherwise no order data will be send to Google.
Also note that there's no guarantees that the order data will be successfully recorded within Google's system. This is because the user may have blocked or not allow the ordering data to be sent to Google, or Google's servers were unavailable at the time the order was submitted, or Google Tag Manager/Google Analytics may have been misconfigured.

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission content managed web page area
Impact: Normal

TOT-4033 - Eway Payment Gateway 3D Secure credit card payments within Order Checkout/Submission content managed web page areas

On a content managed webpage containing either Order Checkout/Submission or Guest Order Checkout/Submission areas there is now the ability to handle having credit card payments be made via version 3 of Eway's payment gateway, supporting 3D secure payments that may require users to be taken to a separate website to authenticate themselves (typically the credit card issuing bank's website), before allowing the credit card payment to be applied. The can provide banks with greater certainty of the credit card holder, and transfer the risk of a fraudulent transaction from the seller to the bank. This capability has been added to the Order Checkout/Submission area by supporting Eway's "Transparent Redirect" feature https://eway.io/api-v3/?shell#transparent-redirect
Within the user reaches the Payment Form, after filling in their credit card details and clicking on the Pay button, the user will be redirected to Eway's servers to create the payment. Eway may then either redirect the user onto the banking website to authenticate themselves if Secure 3Ds is turned on in the Eway payment gateway profile. Once the payment is confirmed the user will be redirected back to the content managed website where the payment will be verified with Eway, and if successfully the user will be shown the success area, or otherwise be shown the credit card payment form again with the error that may have occurred (such as incorrect card details).
To enable this capability, within the Administration Centre, under the Stores menu, within the Payment Settings interface, under the Credit Card section, the "Credit Card Payment Gateway" setting now has the option "EWay (With 3D Secure Support/API v3)". If this option is saved then all Order Checkout/Submission areas on content managed websites will use above capabilities for users to pay for orders.
Two additional settings have been added to the Payment Settings interface:

• Credit Card Api Key: This needs to be set to the API key that Eway provides for each customer profile within its system.
• Credit Card Api Password: This needs to be set to the API password that can be customised within the Eway customer profile in its system.

Note that the Credit Card Api Key and Credit Card Api Password settings are only required to be set values if the "Credit Card Payment Gateway" setting is set to "EWay (With 3D Secure Support/API v3)". Otherwise these settings can be left empty for all other payment gateways (as of the time this was written).
Also note that if the "Credit Card Payment Gateway" setting is set to "EWay (With 3D Secure Support/API v3)" and credit card payments are made either through the Administration Centre's Payment interface, or by users for invoices within the Account Enquiry feature, the payment gateway used will be "EWay (With Card CVN Number Checks)" instead. As such the "Credit Card Merchant Id (customer Id)" setting will need to be set to the Eway Customer ID for these credit card payments to be accepted by Eway.
Also note that for sellers wishing to use 3D Secure, this capability needs to be turned on within Eway's system, as well as the merchant bank account that the payments are being placed into needs to be a bank that supports 3D Secure as well as Eway supports. We suggest talking to Eway and the bank itself for performing these checks and setup work.

Functionality Affected: Store Settings administration centre interface, Order Checkout/Submission and Guest Order Checkout/Submission content managed web page areas
Impact: Normal

Improvements

TOT-3930 - Replace Adobe Flash multi file uploader to HTML 5 based file uploader within Administration Centre

Within the Administration Centre, under the Websites menu within the Website Libraries interface, and under the Data menu within the Product Images and Category Images interfaces, the Adobe Flash Multiple File Uploader has been replaced with a Javascript based file uploader using HTML 5 functionality to allow for multi-file selection and uploading of files.
After administrator users can click on the Select Files To Upload button, they can select or more files from the file system, Alternatively users can drag and drop files directly on the Select Files To Upload button from a file explorer window.
These files will be added to the upload queue and be displayed within a list. Upon the user then clicking on the Start Image Uploads button. Each file in the queue will attempt to be uploaded one at a time. The status of the upload will show against the file being uploaded. If successful then the file's status will be changed to uploaded. If an error occurred then a message will display containing the cause of the error. If the Stop Image Uploads button is pressed then any files in the queue not yet uploaded with be cancelled from being uploaded. If the user clicks on the Clear Image Upload List, then any queued files will be cancelled and cleared from the list. If a file is attempted to be uploaded and succeeds or fails, then the file cannot be uploaded again unless its added to the queue again.
Note that for image uploads for products, categories and against content managed web page image libraries the image files need to be under 2MB in size and have the file extension jpg. jpeg, png or gif, otherwise if the files are selected they will be ignored from being added to the queue. For files being uploaded to the content managed website attachment libraries, the max file size is set to 15MB. If these file sizes are exceeded then error messages will display with the reason why the files could not be uploaded.

Functionality Affected: Website Libraries, Product Images, Category Images administration centre interfaces
Impact: Normal

TOT-4012 - Display make/model product attribute values within the Model Product content managed web page area

On a content managed web page that displays a a Model Product area, the area can now be configured to display attribute values that have set against each product that has been assigned to a make/model for a given category. Additionally within the Make/Model Administration Centre interface there is now the ability to see the attribute values assigned to each model-product-category record, as well as create and remove attribute values.
Within the Administration Centre, under the Websites menu, within the Websites interface, upon viewing the a web page containing a Model Product area in the Web Page Editor. Within the area's settings window, a new setting labelled "Display Model Product Attribute Values" now displays, if set to Yes then this allows the areas to find and display attribute values for each product-category displayed in the area.
Additionally the following formats have been added to the Model Products area:

• Model Product Attribute Value Record: This format controls how each attribute value record is displayed when viewed against each product-category record displayed in the area.
• Model Product Category Record: This format controls the surrounding formatting and structure for each product-category record, including the positioning of the collection of attribute values assigned to each product-category record, as well as the positioning of the formatted product data shown using the Product Search Record format.

These formats change how area works, with now the Product Search Record format now embedded within the "product_search_record" hook of the Model Product Category Record format. For existing Model Products areas if no Model Product Category Record format is assigned to the area then the area will directly embed the Product Search Record format into place where this format would be set, allowing existing areas to not be altered or affected.
Note that model-product-category attribute values can be created/imported from external systems through the "Model/Product/Category Mappings" Connector data import, and is the preferred way of creating the attribute data when 1000s of models exist.
Within the Make/Model administration centre interface, upon clicking on the Products count column of a model, within the Model Products dialog an additional column labelled "Attributes" now displays, showing how many attribute values are assigned to each model-product-category record. Upon clicking on a value in the Attributes column, will display the Model Product Category Attributes dialog that shows all the attribute values assigned to each model-product-category record. Attribute values can be deleted by clicking on the delete icon, and attribute values can be assigned by typing in the attribute profile name, attribute, and value into the dialog's form and clicking on the Add Value option. For this to work attribute profiles and attributes need to have previously been created/inported to the Products Attributes administration centre interface.
Also within the Make/Model administration centre interface, within the Model Search drop down the following search filters have been added to provide additional ways to search for models:

• Key Maker Model ID: Find models that have search value matching the Key Make Model ID
• Active Models: Find all models that are active
• Inactive Models: Find all models that are inactive
• Product Code: Find all models that have products assigned to them with a Product Code containing the search value set.
• Product Name:Find all models that have products assigned to them with a Product Name containing the search value set.
• Product Key: Find all models that have products assigned to them with a Product Key containing the search value set.

Within the Model Detail dialog there's now the ability to view the Key Make Model ID set for each model, as well as update the key. This relevant if models have been imported using the Make/Model Connector data import.

Functionality Affected: Make/Model administration centre interface, Model Products content managed web page area
Impact: Normal

TOT-4043 - Limit the number of failed credit card payment attempts allowed by users when paying for orders

Within the Trade interface's Order Detail page, as well as on a content managed webpage containing either an Order Checkout/Submission area, or Guest Order Checkout/Submission area, if the user chooses to pay for an order with the credit card payment type, then after the user enters their credit card details in the credit card payment form and clicks the Pay button, the number of failed payment attempts that is allowed to occur in a user's session is now limited to 5 attempts. Once the limit is reached then no more credit card payment attempts will be passed across to the payment gateway's, avoiding the payment gateways and banks receiving a large amount of credit card payment attempts.
This helps reduce brute force attempts being made to guess credit card credentials, such as when automated software is used to perform these attempts.
When the credit card failed payment attempts threshold is reached, the user will always see the error message "Unable to process the credit card payment due to the maximum number of attempts being reached. Please contact us to complete your payment." until the user logs out and in again. After that they will be allowed another 5 credit card payment attempts. For guest users they would need to create a new session to allow further credit card payment attempts to be made, either by closing and reopening their web browser, or clearing their browser cache, or by using a different web browser.
Guest users would also need to add products to basket again, proceed through the order checkout process again and pass Recaptcha checks before being allowed another 5 credit card payment attempts for orders.

Functionality Affected: Order Checkout/Submission and Guest Order Checkout/Submission content managed web page areas
Impact: Major

TOT-4045 - Add settings to allow Recaptcha to display within credit card payment in Order Checkout/Submission content managed web page areas

On a content managed web page displaying either a Order Checkout/Submission area, or a Guest Order Checkout/Submission area, if a user has selected to pay for an order with the credit card payment type, then upon proceeding to the Credit Card Payment Form, there is now the ability to show a recaptcha form element that checks to see if a real human is entering the credit card details. This reduces the chances of automated software attempting to make a credit card payment.
Within the Administration Centre, under the Stores menu, within the Payment settings interface, under the Credit Card section, a setting labelled "Require Recaptcha For Credit Card Payments" has been added that controls if the Recaptcha element should be used within the credit card payment from within content managed web pages displaying Order Checkout/Submission and Guest Order Checkout/Submission areas.
Within the "Payment Credit Card Form" content managed web page area format a hook labelled "cc_recaptcha_field" has been added that allows the Recaptcha form element to be embedded within the format, allowing it's position to be customised, The hook will only display a Recaptcha form element if the Require Recaptcha For Credit Card Payments setting is set to Yes, otherwise the hook will be empty, This hook must be embedded within the area's format if the Require Recaptcha For Credit Card Payments setting is set to Yes, otherwise the user will be blocked from submitting the payment and see a failed Recaptcha error message.

Functionality Affected: Store Settings administration centre interface, Order Checkout/Submission and Guest Order Checkout/Submission content managed web page areas
Impact: Normal

TOT-4048 - Modify login process to redirect using secure redirect URL after user has successfully logged in from a secure content managed website to avoid browser warnings

On a fully secure content managed website that contains a web page with a User Login area, once the user enters their login credentials and clicks on the Login button, the redirect URL that directs them back to the content managed website now uses the https: protocol to load the content managed webpage without having to resort to an additional secure redirect.
This avoids users logging into a content managed website from seeing an warning messages presented by browsers. If the user is logging into to either the Trade interface or the Administration Centre, then an additional webpage load will occur to correctly redirect the user to the home page of either interface without a browser message occurring.

Functionality Affected: User Login content managed web page areas
Impact: Normal

TOT-4059 - Limit invoice credit card payment attempts to one at a time within Customer Account Invoice Payment Form content managed web page area

On a content managed web page displaying an Account Invoice Payment Form area, if a user double clicks on a Pay button it is no longer possible that multiple requests will be sent to the server to apply credit card payments to pay for the selected invoices.
Within the area's "Invoice Payment Form" format, the credit_card_payment_onclick javascript function will only allow one payment request to be sent through, any subsequent attempts will be ignored until the previous payment request has returned a response and the area has updated itself with the result.

Functionality Affected: Account Invoice Payment Form content managed web page area
Impact: Normal

TOT-4065 - Settings to control passing delivery address details to Paypal in Order Checkout

For the Order Details page on the Trade interface, as well as on content managed web pages that contain the Order Checkout/Submission area, as well as the Guest Order Checkout/Submission area, if a user selects the Paypal payment type, then when the user is directed to Paypal from the Order Review stage, there is now the ability to pass the delivery address information across to Paypal. This allows more information to be stored against the payment in Paypal, and may allow Paypal to perform additional validity checks on the payer, covering costs of fraudulent activity through its Seller Protection mechanism.
Within the Administration Centre, under the Stores menu, within the Payment Settings interface, under the Paypal payment section, an additional setting has been added labelled "Set Delivery Address In Order Payments" that controls if order delivery address should be passed across to Paypal or not during the Order Checkout process. If the setting is set to Yes then when the user proceeds through the checkout process and is redirected to Paypal, within Paypal they will now be able to see the delivery address they set for the order. Note that the user won't have the option to modify the delivery address unless they navigate back to the Order Details page. Once the user has completed the Paypal payment and submitted the sales order, then within the seller Paypal account, in the payment Transaction Details page it will display the delivery address details with a status indicating if the address is eligible for Seller Protection from Paypal.
Note that if the "Set Delivery Address In Order Payments" setting is set to Yes then it's allow customer's address details to be shared with Paypal, and Paypal may use this information for a variety of means (see their terms and conditions to understand). If you don't want Paypal to know your customer's address details then its best to leave this setting to No, which is the default value (and note that you could be liable to cover costs if the payment is charged back at a later stage by Paypal).

Functionality Affected:  Order Checkout/Submission, Guest Order Checkout/Submission content managed web page areas
Impact: Normal

TOT-4067 - Modify Product Search admin centre interface to contain an advanced search rule to find products that have fields without values set

Within the Administration Centre, under the Inventory menu, within the Product Search interface, within the Advanced Search form, for the Search Category "All Products", in its "Select all products where" rule, for the "equal to" drop down it now has 2 options labelled "is empty" and "is not empty", that can be used to find products that don't have a value set within the selected field, or do have a value set in the selected field.
Additionally for the search rule, within the the list of fields to choose from now includes the 4 description fields, and the 3 meta product fields (seo) fields.

Functionality Affected:  Product Search administration centre interface
Impact: Minor

TOT-4070 - Setting to allow Receiver Name in SmartFreight order to be set as delivery contact name if delivery org name is empty

When an order is submitted either through the Trade interface, on from a content managed web page area containing a Order Checkout/Submission area or Guest Order Checkout/Submission area, if the project is configured to send the order to Smartfreight, then in the SmartFreight order request there is now a setting that controls what order data should be placed in Receiver Name when the order is submitted to SmartFreight. This field will be set to the delivery address's org name, or it is empty then either the delivery address contact name, or the customer account company name.
Within the Administration Centre, under the Stores menu, within the Freight Providers settings interface, under the "Freight Provider - SmartFreight" section a new setting labelled "SmartFreight Order Receiver Name" has been added, it can be set to one of the following values:

• Delivery Address Org Name else Account Company Name: When orders are submitted to SmartFreight it will place the order's delivery address org name into the Receiver Name field. If the org name is empty then the Customer Account Company Name will be used instead. This is the default option.
• Delivery Address Org Name else Contact Name: When orders are submitted to SmartFreight it will place the order's delivery address org name into the Receiver Name field. If the org name is empty then the delivery address's Contact Name field will be used instead. If the contact field is empty then the Customer Account Company Name will be used instead.

It's recommended to use the Delivery Address Org Name else Contact Name option if the website supports consumer/retail based ordering, where users may be ordering personally for themselves and not for a company.

Functionality Affected: Smartfreight Order Submission
Impact: Normal

Bug Fixes

TOT-4047 - Product deal with the offer Buy Product Quantity X and Get Quantity Y for Z Percent Off Product Price incorrectly over discounting

Within the Administration Centre, under the Marketing menu, within the Product Deals and Vouchers interface, if a deal was created with the offer "Buy Product Quantity X and Get Quantity Y for Z Percent Off Product Price", when the user redeemed a deal after adding a product to basket with the allowed quantity in a content managed website, the individual quantity was not being multiplied by the Y quantity set in the deal, This in effect allowed an almost 50% discount to always be applied.
The deal now correctly applies the discount percentage against the quantities that are applicable to the deal.

Functionality Affected: Add Product To Basket process
Impact: Normal

TOT-4051 - Previous Instructions drop down not sorting instructions by last order date within the Order Details page in the Trade interface

Within the Trade interface, after clicking on the View Basket button, then clicking on the checkout button, on the Order Details page, within the Previous Instructions drop down the instructions are now being sorted correctly based on the order date that the last unique instruction occurred an order.
Previously the previous order instructions were incorrectly being grouped first, before being sorted, leading to the same instructions for later orders being ordered based on earlier orders where the instructions occurred.

Functionality Affected: Order Detail Trade interface
Impact: Normal

TOT-4053 - Invoice text line description hook is not displaying any text within the Customer Account Invoice content managed web page area

Within a content managed web page containing a Customer Account Invoice area, if the area is displaying an invoice that contained a text line with a description, the Customer Account Invoice Line Text format's "invoice_line_description" is now correctly displaying the description set within the invoice line data.
Previously it was not displaying the invoice line description for text lines.

Functionality Affected: Customer Account Invoice content managed web page area
Impact: Minor

TOT-4054 - Guest Order Checkout/Submission content managed web page incorrectly setting [INVALID FORM VAR] within deliveryOrgName and billingOrgName address fields if fields arn't embedded in area

On a content managed web page area that contains a Guest Order Checkout/Submission area, if the area's Order Details Form format does not have either the delvrnew_orgNameField or billingnew_orgNameField fields embedded within the area, then in the delivery address org name field or the billing address org name field, it will now correctly set empty values for these ordering fields.
If these fields are not embedded within the Order Details Form format then the field values should be set to empty text.
Note that for existing orders this fix won't remove the [invalid form var] text from the billing and delivery address data, the change only affects new orders that are submitted.

Functionality Affected: Guest Order Checkout/Submission content managed web page area
Impact: Normal

TOT-4057 - Yearly Project Traffic statistics displaying incorrect year label within the Project Traffic Statistics Administration Centre interface

Within the Administration Centre, under the Statistics menu, within the Project Traffic Statistics interface, under the Yearly Project Traffic Statistics graph the labels of the years that appear for July and January are now correctly set to show labels a current financial year.
Previously these labels would set the incorrect years to show if the current year was in the second half of the financial year.

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

TOT-4066 - Unable to upload an image to a category within the Categories Admin Centre interface

Within the Administration Centre, under the Inventory menu, within the Category Trees interface, upon right clicking on a category and clicking the View menu item, within the Images tab upon selecting an image to upload and clicking on the Add button, the image now correctly uploads and is added to the images list, if the image is a jpeg, gif, or png under the valid size.
Previously if an image was attempted to be uploaded against a category the image would fail to upload, occurring since the improvement TOT-4031 was released.

Functionality Affected: Category Trees administration centre interface
Impact: Normal

TOT-4068 - _B_StockLevel hook showing incorrect stock level when product stock quantity is over 1000 in Basket Listing content managed web page area

On a content managed webpage displaying a Basket Listing area, if the area is showing products that have been previously added to basket that currently contain stock quantities 1000 or greater, then the _B_StockLevel hook within the area's Basket Product Record format is now correctly determining the stock level, regardless of the amount of stock quantity a product has available.
Previously if the stock quantity had a value of 1,000 or more, only the numbers left of comma would be used to calculate the stock level.

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

Improvements

TOT-4018 - Allow users to control positioning and quantity of shopping list products within the Shopping List Detail tab of the My Items Trade interface page and Shopping List Products content managed web page area

On a content managed web page containing a Shopping List Products area, as well as within the trade interface's Shopping List Detail tab of the My Items page, there is now the ability for users to modify the ordering of products within a shopping list if the user has permission to modify a shopping list, as well as update the quantity set against each product within the shopping list.
Within the Trade interface, after clicking on My Items, within the My Items page, under the My Shopping Lists tab, upon clicking on the name of a shopping list, within the shopping lists details tab. An additional table column has been added labelled "Position". For each product row, if the user has permission to modify the shopping list, then in the Position column a drop down displays that allows the user to change the position of the product within the list. Upon selecting a new position value the table will reload to show the updated positions of the products within the shopping list. When a product is added to an existing shopping list it's position will be set so that it appears at the end of the shopping list. For the Quantity In List column, users are now able to select a quantity in the column, change its value and click on the Enter key to update the quantity. The list will reload showing the updated quantity.
On a content managed page showing a Shopping List Products area, for the area's Shopping List Product Record format the following hooks have been added:

• shoppinglist_product_ordering_pos: Numeric ordering position of the product within the shopping list.
• shoppinglist_product_update_quantity_onclick: Javascript function that calls for quantity of the product in the shopping list to be changed, based on the value set in the Update Quantity textbox.
• shoppinglist_product_update_quantity_input_id: ID of the Update Quantity textbox that allows the quantity of the product in the shopping list to be changed. Set within the ID attribute of a textbox to allow it to be the Update Quantity textbox
• shoppinglist_product_ordering_options: A list of select options containing the ordering positions that a product in the shopping list can be changed to. Is empty if user is not allowed to update product position.
• shoppinglist_product_ordering_onchange: Javascript function that calls for the ordering position of a product in the shopping list to be changed. Set this within the onchange attribute of a select element containing the ordering options.
• shoppinglist_product_allow_reorder: Shows either Y or N. If Y then the user is allowed to reorder the products within the shopping list

WIthin the Administration Centre, under the User menu, within the User Permissions interface, upon editing a Facility Role, if the "My Shopping Lists" permission is set to Allow then the user will be allowed to modify the positioning of the shopping list.

Functionality Affected: Shopping List Products content managed web page area, My Items trade interface page
Impact: Normal

TOT-4026 - Improve processing efficiency of Make Models Connector data import

Within the Administration Centre, under the Data menu, within the Data Imports interface, in the Connector Imports tab, when running a Maker Models data import, the data import has had a number of improvements made to allow it to significantly reduce the amount of time it takes to process model records sent from the Connector.
The data import now updates model and model attribute values records in batches,reducing the amount of time to create and update database queries in the back end. The data import also no longer deactivates all model records in the pre data import phase, reducing the amount of time before records can start being processed.
It also stores in memory existing model data that enables much faster checks when processing each record, and only changes records within the back end if they need to be changed.
All these things combined allow the Make Model Connector data import to run 5 to 1000 times faster, depending on the amount of model data was previously imported, or needs to be deactivated.

Functionality Affected: Maker Models Connector data import
Impact: Normal

TOT-4029 - Display Basket Product Fields for child combination products within the Product Detail content managed web page area

On a content managed web page that contains a Product Detail area, if a parent combination product is loaded within the area and the Basket Product Fields feature is turned on, then there is now the ability to show the basket product fields once a child product has been selected, as well as if a default child product is initially loaded within the area.
Within the area's Product Detail format an additional hook has been added labelled "basket_product_field_table_placeholder" that contains a placeholder div that allows the basket product fields table to be loaded into the div, when the Basket Product Fields feature is turned on, and either the product loaded into the area is assigned to a basket product field profile that contains fields, as well as when a child combination product is selected to display within the area.
If none of these conditions are met then the placeholder hook will display an empty div.

Functionality Affected: Product Detail content managed web page area
Impact: Normal

TOT-4031 - Setting control the category tree that related category products display within in the Related Products Listing content managed web page area

On a content managed web page displaying a Related Products Listing content managed web page area, if the area's "Displays Products Based On" setting is set to "Category Products", then the area has another setting within its Area Settings dialog labelled "Limit Category Products To Tree" that allows the administrator user to choose a category tree to restrict the related products belonging to the same category in the tree selected.
By default this setting will be set to "Any Category Tree" to allow related products assigned to any category to display in the area.

Functionality Affected: Related Products Listing content managed web page area
Impact: Normal

TOT-4034 - Data fields to order product combination fields, field values, and assigned child combination products

Within the Administration Centre, from the Data menu, within the Data Imports interface, when a Product Combinations data import is ran, the data import is able to set the ordering of combination profile fields, profile field values, as well as ordering for each child product assigned to each parent combination product. For combination profile fields the ordering value is set based on the value set in the combination profile field's ordering field. For the combination profile field values, the ordering data field is set based on the order in which values are assigned to each combination profile field in the data obtained from the Connector. For the child combination products ordering, this value is set based on the order that child products are assigned to parent products within the data obtained from the Connector.
Within the Administration Centre's Product Combinations interface it is now able to show the ordering field set for each combination profile field, and combination profile field value. For combination profile field's the ordering value can be updated within the Administration Centre interface. For the combination field values the ordering will need to be controlled from the Connector software.
Within the Product Editor, under the Combinations tab, it now shows an ordering column for each child product assigned to the parent product. This allows administrator users to be sure that the correct ordering is being set from within the Connector software.
On a content managed web page that contains a Product Detail or Product Combination area, the areas will now order the combination field drop downs based on its ordering data, as well as sort the field values in the drop downs based on the combination field value ordering data. Within the Product Combination area, when displayed as a radio list it now will list the child products based on the ordering data set for each child product assigned to the parent product.For each of the different combination data, the fields, values and child products will be sorted from lowest ordering value to highest.
Note that this solution relies mostly on using the Connector software to determine the correct way combination field values should be ordered, as well as child products assigned to parent combination products. It is recommended to use Data Sets, and configure a Order By clause for the combination data exports from the Data Set SQLite database to get the correct ordering required field the combination field values, and child products.

Functionality Affected: Product Combinations Connector data import, Product Editor admin centre interface, Product Combinations admin centre interface, Product Details content managed web page area
Impact: Normal

TOT-4035 - Freight Tracking Code format hooks within Customer Account Invoice and Sales Order content managed web page areas

On a content managed web page displaying Customer Account Invoice Listing, Customer Account Invoice, Customer Account Sales Order Listing or Customer Account Sales Order areas, for each invoice or sales order record displayed, its record area formats new hooks have been addedthat allow freight tracking code data to be displayed. This allows tracking codes to be embedded and viewed by users, allowing them to find where their ordered goods are currently at with the freight carrier performing the delivery.
These format hooks include in the Customer Account Invoice Record and Customer Account Invoice area formats:

• invoice_freight_carrier_consign_code - Name of the freight carrier consignment note set in the invoice.
• invoice_freight_carrier_service_code - Code of the freight carrier service organising the carrier to deliver the goods in the invoice.
• invoice_freight_carrier_tracking_code - Tracking code used to track the delivery by the carrier of the goods in the invoice.
• invoice_freight_system_ref_code - Reference code in the system of the carrier service who is organising the carrier to deliver the goods in the invoice.
• invoice_freight_carrier_tracking_code_set - Displays either Y or N. Set to Y when the freight carrier tracking code has a value set in the invoice.

These format hooks include in the Customer Account Sales Order Record and Customer Account Sales Order area formats:

• order_sale_freight_carrier_consign_code - Name of the freight carrier consignment note set in the sales order.
• order_sale_freight_carrier_service_code - Code of the freight carrier service organising the carrier to deliver the goods in the sales order.
• order_sale_freight_carrier_tracking_code - Tracking code used to track the delivery by the carrier of the goods in the sales order.
• order_sale_freight_system_ref_code - Reference code in the system of the carrier service who is organising the carrier to deliver the goods in the sales order.
• order_sale_freight_carrier_tracking_code_set - Displays either Y or N. Set to Y when the freight carrier tracking code has a value set in the sales order.

Functionality Affected: Customer Account Invoice Listing, Customer Account Invoice, Customer Account Sales Order Listing, Customer Account Sales Order areascontent managed web page areas
Impact: Normal

TOT-4038 - Set ordering value from square brackets in uploaded file name in Product Image Upload Administration Centre interfaces and data imports

Within the the Administration Centre, if a product image is uploaded from either the Inventory Editor interface, or the Product Images Import interface, or the Product Images Connector data import, and the uploaded file name contains square brackets with a containing numeric value, then when the image is being assigned to the product its ordering value will be set based on the number in-between the file name's square brackets.
This avoids administrator users needing to separately set the ordering value of product images within the Product Editor after the image upload has been completed from the other interfaces.
For the Product Images Connector data import it will only look at the ordering value within the image's file name if no ordering value has been explicitly given when the Connector uploads the image.
Functionality Affected: Product Image Upload
Impact: Normal

Bug Fixes

TOT-3982 - Unable to rename content managed website attachment library when the new library name contains the apostrophe character

Within the Administration Centre, under the Websites menu, within the Websites interface, under a content managed website that contained an attachment, upon clicking on the attachment library and view its contents. If the attachment library was attempted to be renamed to a library containing an apostrophe character an error message would appear and files could no longer be uploaded to the library.
Now ff the attachment library is attempted to be renamed to a library containing an apostrophe character, an error message will now display advising that the library cannot be renamed, displaying the error message: "The name of library is not allowed. The name can only contain letters, numbers, spaces, dashes and underscores."

Functionality Affected: Websites Administration Centre interface
Impact: Normal

TOT-3987 - Unable to save Upload and Delete Shared Shopping List Attachments Facility Role permission within the User Permissions administration centre interface

After logging into the Administration Centre, under the Users menu, within the User Permissions interface, upon selecting a facility role and clicking the edit button, the Upload and Delete Shared Shopping List Attachments facility role permission radio buttons are deselected. Upon selecting either the Allow or Deny radio buttons and clicking the save button, upon reloading User Permissions interface and viewing the facility role permissions again, the Upload and Delete Shared Shopping List Attachments permission was once again incorrectly deselected.
Now upon selecting a facility role and clicking the edit button, for the Upload and Delete Shared Shopping List Attachments facility role permission after selecting either the Allow or Deny radio buttons and clicking the save button the permission's value is correctly saved, and shows when the interface is reloaded again.

Functionality Affected: User Permissions Administration Centre interface
Impact: Normal

TOT-4023 - Customer Accounts Connector data import failing often during pre-import due to database transaction locks

Within the Administration Centre, under the Data menu, within the Data Imports interface, under the Connector Imports tab, after selecting the Customer Accounts data import and clicking on the Start Imports button, the import may have failed during pre data import process with the error "Data Import aborted with error: Deadlock found when trying to get lock; try restarting transaction" . This may have occurred when running the data import several times in a row, before the import successfully completed agaub. This happened when many existing customer accounts appear within the project.
Now after selecting the Customer Accounts data import and clicking on the Start Imports button, the import has been modified to more efficiently run and change customer account data within the database. It does this is a couple of ways, customer accounts and its dependent payment type and location linked records are no longer updated at the pre-import stage. Instead all customer accounts, payment type and location linkages are stored in memory in the pre-import stage. Then when the customer records are processed only customer accounts that were not updated in the import will be deactivated in the post import stage, Additionally the import contains further optimisations, leading to faster record changes.
The consequence of these changes is that if lots of customer account data becomes deactivated then it may take more time for the import to complete, which may lead to lock issues. However the chances of this occurring should be reduced in the majority of cases.

Functionality Affected: Customer Account Connector data import
Impact: Normal

TOT-4037 - Basket Product Listing content managed web page area displaying incorrect stock quantity and level for kitted products that use component products to calculate stock quantity

On a content managed web page displaying a Basket Product Listing area. If a product had been added to basket that was set as a kitted product, and is set to calculate its stock quantity and level based on the component products assigned to the kitted product, then within the area's _B_Stock and _B_StockLevel hooks they were displaying the incorrect stock quantity and stock level based on the values directly assigned against the kitted product. These format hooks should display stock values based on lowest available stock of a component product assigned to each kitted product.
Now if a product has been added to basket that is set as a kitted product, and is set to calculate its stock quantity and level based on the component products assigned to the kitted product, then within the area's _B_Stock and _B_StockLevel hooks they are now correctly displaying the stock quantity and stock level based on the lowest available stock of a component product assigned to each kitted product. Previously the stock hooks were only looking at the stock quantity directly set against the kitted product.

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

Improvements

TOT-3944 - Model Search Listing content managed web page area to support finding models based on keyMakerModelID model field

On a content managed web page containing a Model Search Listing area, the area now accepts an additional input called "inp_key_maker_model_ids". This input allows a pipe delimited list of key maker model IDs to be passed, from where a model search will be performed that will try to match and display any models that have a matching Key Maker Model ID.
The area also now contains a search type called "keymakermodelid_startswith" that allows models to be found that have a Key Maker Model ID start with the search word given.
This new capability allows the model searches to be coupled with 3rd party make/model databases, such as PARtsDB to enable advanced model searching combinated with model data stored within a TOTECS project.

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

TOT-3957 - Setting to allow additional default child combination product details to display within placeholder hooks of the Product Detail content managed web page area

On a content managed web page that displays either a Product Detail area or a Random Product area, if the product loaded within the area is a parent combination product and it contains a default child product, then within the area's placeholder hooks there is the ability for the child product code, name,descriptions, and barcode data to display within the placeholder hooks.
Within the Administration Centre, within the Websites menu, in the Websites interface, upon clicking on a content managed web page that contains a Product Detail or a Random Product area, clicking on the area to open its area settings window appears a new setting labelled "Initially Show Child Combination Product Data". If set to true then when the area loads the following hooks will be filled with the default combination child product's data:

• _P_ItemIDHolder
• _P_NameHolder
• _P_DescriptionHolder
• _P_Description2Holder
• _P_Description3Holder
• _P_Description4Holder
• _P_BarcodeHolder
• _P_BarcodeInnerHolder

TOT-3990 - Display products belonging to the same category within the Related Products Listing content managed web page area

On a content managed web page area containing a Related Products Listing area, the area now has the ability to show products based on products assigned to the same active category as the product specified in the web page's URL.
Additionally the area can also products based on products in the basket that are assigned to active categories that have products not yet in the basket.
These 2 modes allow the category tree to be used to determine related products, reducing the amount of data work that needs to occur to allow users to find products that they may wish to add to basket.
Within the Administration Centre, under the Websites interface, upon right clicking on a content managed web page, within the Web Page Editor that contains a Related Products Listing area, in its area editor the "Displays Products Based On" setting now has the option "Category Products". If set and the "Display Related Basket Products" setting is set to No then the area will display products based on products assigned to the same category as the product specified in the web page's URL. If the "Display Related Basket Products" setting is set to Yes the area will show products based on products that area in the basket that are assigned to categories that have products not yet in the basket.
Note that if a product displayed on the web page or in the basket is assigned to multiple categories, then the Related Products Listing will display products across any of the connected categories.

Functionality Affected:  Related Products Listing content managed web page area
Impact: Normal

TOT-4001 - Additional order search filters within the Sales Summary drop down in the Sales Summary statistics administration centre interface

Within the Administration Centre, under the Statistics menu, within the Sales Summary interface, for each of the statistics graphs, in the search filter drop down a number of additional options have been added. This allows administrator users to gain further insight into how orders are being submitted, based on several fitlers. This includes the options:

• Orders With Payment Types: Matches orders that have the payment type specified in the search field. The search field may contain a comma delimited list of payment types, based on either the payment type codes (AC,RQ,CC,DD,PP,ZP) or payment type names (account,runningquote,creditcard,directdeposit,paypal,zippay)
• Orders Excluding Payment Types: Matches orders that don;t have the payment type specified in the search field. The search field may contain a comma delimited list of payment types, based on either the payment type codes (AC,RQ,CC,DD,PP,ZP) or payment type names (account,runningquote,creditcard,directdeposit,paypal,zippay)

• Orders Matching Login ID: Matches orders that have a user assigned to with the exact matching login ID in the search field
• Orders Matching Email: Matches orders that have the exact matching email address set in the search field
• Orders Matching Purchase Order Number: Matches orders that have the exact matching purchase order number set in the search field
• Orders Matching Carrier: Matches orders that have the exact matching carrier set in the search field
• Orders Matching Freight Carrier: Matches orders that have the exact matching freight carrier code set in the search field
• Orders Matching Location Name: Matches orders that have the exact matching location name set in the search field
• Orders Matching Deal Activation Code: Matches orders that have the exact matching deal activation code set in the search field
• Orders Containing Delivery Org Name: Matches orders that have the start, end with, or contain the delivery address organisation name set in the search field
• Orders Containing Delivery Contact: Matches orders that have the start, end with, or contain the delivery address contact name set in the search field
• Orders Containing Delivery Address1: Matches orders that have the start, end with, or contain the delivery address 1 value set in the search field
• Orders Containing Delivery Address 2 Matches orders that have the start, end with, or contain the delivery address 2 value set in the search field
• Orders Containing Delivery Address 3: Matches orders that have the start, end with, or contain the delivery address 3 value set in the search field
• Orders Containing Delivery Address 4: Matches orders that have the start, end with, or contain the delivery address 4 value set in the search field
• Orders Containing Delivery Postcode: Matches orders that have the start, end with, or contain the delivery address postcode set in the search field

TOT-4004 - Settings to control if freight carrier, service and freight unit measurements should be included when partial freight orders are sent to Smart Freight

When a user submits an order through either a content managed website, or via the Trade interface, or administrator resubmits a freight order, if the order is submitted to SmartFreight as a partial order, then the details of the freight carrier/service selected, freight unit amount, freight total weight, and freight total volume can now be selectively included or excluded within the freight order.
These partial freight order details are controlled within the Administration Centre, under the Stores menu, within the Freight Providers settings interface, via the following settings that now exist:

• Partial Order Import - Include Freight Carrier/Service: If the order is set to be sent to SmartFreight as a partial order, then this controls if the freight carrier and freight service should be included in the partial order. The freight carrier and service will only be set if the ordering user selected a freight carrier in the Order Freight Carrier Selection screen, or if an Administrator set the Freight Carrier and Freight Carrier Service fields against an order when viewing its details within the Administration Centre's Orders interface.
• Partial Order Import - Include Freight Unit Amount: If the order is set to be sent to SmartFreight as a partial order, then this controls if the amount of freight units should be included in the partial order sent to SmartFreight.
• Partial Order Import - Include Freight Weight: If the order is set to be sent to SmartFreight as a partial order, then this controls if the total weight amount (in kilograms) of the order should be included in the partial order sent to SmartFreight.
• Partial Order Import - Include Freight Volume: If the order is set to be sent to SmartFreight as a partial order, then this controls if the total volume (in metres cubed) of the order should be included in the partial order sent to SmartFreight.

TOT-4008 - Thumbnail image list and image viewer within Product Search Results Listing content managed web page area

On a content managed web page displaying either a Product Search Results Listing area or a Category Listing area, for each product displayed there is now the ability to display the product's image list, as well as an image placeholder.
When a user clicks on an image within the image list it can either open within an image viewer, or else update the image placeholder. Additionally there is now an option display an image magnifying glass when the user hovers over an image displayed within the placeholder, allowing the user to digitally zoom 3 times in on the image displayed.
Within both areas the following settings have been added:

• Image Placeholder Size: Controls the size of the product image displayed within the product image placeholder.
• Show Image Placeholder Magnifier: If set to Yes then displays an magnifying glass when a user hovers over the image placeholder. It's highly recommended to only set to Yes if the image placeholder only displays image of the same dimensions each time.
• Show Image Thumb List: If set to Yes then it will allow the product image thumbnail list to display product images. Note that this setting may cause the area to take longer to load due the extra time required to get the list of images for each product. Its recommended to only set this setting to Yes if the product_image_thumbnail_list hook is embedded within the area's assigned format.
• Image Thumb List Size: Set the size of the product images that display within the image thumb list.
• Image Thumb List Target: If a user clicks on an image within the product image thumbnail list then this set controls if the the selected image should display within a modal image viewer, or otherwise update the image shown within the image placeholder.

• product_image_placeholder: Initially displays the default image of a product, then displays another product image when selected from the image thumbnail list. By default displays a medium sized product image unless the image size is configured within the area settings.
• product_image_thumbnail_list: Displays a list of product images that can be clicked on to either display within an image viewer, or displayed within the image placeholder. By default displays a thumbnail sized product images unless the image size is configured within the area settings.

• img-magnifier-container: displays styling need to control positioning that the magnifying glass displays within.
• img-magnifier-glass: displays styling for the magnify glass.

TOT-4014 - Setting to run Geocode Locations after Locations Connector data import has completed

When a Locations And Stock Quantities Connector data import is run, upon completing there is now the ability for it to optionally geocode active searchable locations that don't contain any latitude and longitude data. This is important if the locations being imported need to be immediately visible on a content managed website containing a Location Finder area, and those locations don't have the latitude and longitude data that enables them to display.
Within the Administration Centre, under the Data menu, within the Data Imports interface under the Connector Imports tab, for the Locations And Stock Quantities data import clicking on the settings button 2 settings can now be checked, these are:

• Geocode Active Searchable Locations: If checked then after the data import runs the Geocode Locations process will run.
• Send Geocode Locations Report Email: If checked and the Geocode Active Searchable Locations setting is checked then when the process runs it will email out a report containing the results of trying to geocode locations.

Bug Fixes

TOT-3997 - Unable to enter 4 digit security code for AMEX credit cards within Customer Account Invoice Payment Form content managed web page areas

Within a content managed webpage containing an Invoice Payment Form area, users were unable to pay for their invoices if they are using an American Express credit card that uses a 4 digit security code, since they were only allowed to enter up to 3 characters within the "credit_card_security_code_input" hook's textbox.
Within the Invoice Payment Form area, the "credit_card_security_code_input" area format hook's text box max length has now been increased from 3 to 4 characters to allow AMEX credit card holders to enter their security code in full.

Functionality Affected: Invoice Payment Form content managed web page area
Impact: Normal

TOT-3998 - Guest Checkout/Order Submission setting value set empty if a non super administrator user saves settings within the Checkout Settings Administration Centre interface

Within the administration centre, under the Stores menu, within the Store Settings interface's Checkout tab, if an administrator user clicked on the Save button, then the value of the 'Guest Checkout/Order Submission' setting would be set to empty. Because of this the Guest Checkout/Order Submission feature would be turned off, not allowing guest users to order without logging in first.
Now within the Store Settings interface's Checkout tab, if an administrator user clicks on the Save button, then the value of the 'Guest Checkout/Order Submission' setting will now correctly not be changed, ensuring that the Guest Checkout/Order Submission feature's setting is not changed.

Functionality Affected: Store Settings Administration Centre interface
Impact: Major

TOT-3999 - Product Search Results Listing content managed web page area incorrectly showing product unit price as $0.00 when no price level price exists but an account price exists

Within a content managed web page containing a Product Search Results Listing area, for products listed in the area that contained no price-price level for the user's assigned price level, if the product had customer account pricing that is applicable to the user and product, the pricing hooks in the area's Product Search Record format were still incorrectly showing with $0.00 prices.
Now within a Product Search Results Listing area, for products listed in the area that contained no price-price level for the user's assigned price level, if the product had customer account pricing that is applicable to the user and product, the pricing hooks in the area's Product Search Record format will now show the customer account price, instead of showing $0 price-level prices.

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

TOT-4002 - Users with Login IDs exceeding 35 characters in length are unable to add products to their list of favourites

Within a a content managed website, within any web page areas that allowed a user to add a product to their list of favourites, if a user had a Login ID that is longer than 35 characters then they were unable to add products to their favourites list, with an error message anytime they tried to do so.
Now within any web page areas that allow a user to add a product to their list of favourites, if a user has a Login ID that is longer than 35 characters, or the product has a product code exceeding 35 characters then the user will now be able to correctly add products to their favourites list.

Functionality Affected: Product content managed web page areas
Impact: Normal

TOT-4005 - News/Blog Item content managed web page area editor not saving setting changes

Within the Administration Centre, under the Websites interface, upon right clicking on a content managed web page that contains a News/Blog Item area, after clicking on View All Areas, then clicking on a News/Blog Item area, after un-checking the "Allow Any News/Blog Group To Show Items" setting then setting a value in the News/Blog Item ID setting, after clicking on the Save button, the settings were not being saved when the area editor is re-opened again.
Now within the News/Blog Item area editor, after un-checking the "Allow Any News/Blog Group To Show Items" setting then setting a value in the News/Blog Item ID setting, after clicking on the Save button, the settings are now correct saved.

Functionality Affected: News/Blog Item content managed web page area editor
Impact: Normal

TOT-4006 - Project Traffic Statistics administration centre interface unable to load daily statistics when the user clicks on the View Traffic Statistics button on the Home page

After a user logged into the Administration Centre, on the Home page, after the user clicked on the View Traffic Statistics button, the Project Traffic Statistics interface was incorrectly unable to load the graph data and an error message was displaying.
Now the Project Traffic Statistics interface correctly loads its data over a secure connection when the interface is loaded after the user clicks on the View Traffic Statistics button.

Functionality Affected: Home Administration Centre interface
Impact: Normal

TOT-4009 - HTML character codes for currency symbols incorrectly display within the minimum order pop-up message within the Basket Listing content managed web page area

On a content managed web page that contained a Basket Listing area, if minimum order checks had been turned on and the basket total was under the minimum order total, then when the minimum order alert box was turned on it displayed a message that incorrectly showed the currency symbol as a html character code.
Now when the minimum order alert box is turned on it displays a message it now correctly shows a currency symbols not as a html character codes.

Functionality Affected: Home Administration Centre interface
Impact: Normal

Improvements

TOT-3981 - Facility Role permission to control if users have ability to choose SmartFreight freight carrier options within Order Checkout/Submission content managed webpage areas

On a content managed web page containing a Order Checkout/Submission area, or within the Trade interface's Order Checkout page, if the project's "Freight Provider Calculate Order Freight Surcharge" setting is set to Yes and the "Integrated Freight" project setting is set to ON, then previously in the Order Details the Freight Carrier Selection format would display allowing the user to choose from a list of carriers obtained from SmartFreight. Now there is a facility role permission called "View Order Freight Carrier Selection" that additionally controls whether users assigned to each role are allowed to view the freight carrier selection. This will allow certain users to skip choosing a freight carrier when this new permission is set to deny.
When the "View Order Freight Carrier Selection" facility role permission is set to deny and the "Send Freight Orders To 3rd Party Freight Provider" setting is set to "SmartFreight - Full Import", the permission will cause a submitted order to partially import into SmartFreight to occur instead, since no freight carrier had been assigned to the order.
Within the Administration Centre, under the Users menu, within the User Permissions interface, upon editing a Facility Role, the "View Order Freight Carrier Selection" permission can be to either Allow or Deny from there. Once a facility permission role is saved, then when a user assigned to the role next logs in the permission's setting will come into effect.

Functionality Affected: Order Checkout/Submission content managed web page area, Trade interface's Order Checkout page, SmartFreight Freight Order Submission process
Impact: Normal

TOT-3859 - Ability for Sales Reps to view and use other users baskets linked to customer accounts they are allowed to order with

On a content managed web page containing Basket Selection areas, there is now the ability for Sales Rep users to be able to see baskets assigned to other users who are assigned to the same customer accounts that the Sales Rep user is able to order with. Additionally Sales Rep users are able to switch and order with these other user baskets. This will allow both Sales Reps and customers to share and order with the same basket.
Within the Administration Centre, from the Users menu, within the User Permissions interface, when modifying a Facility Role, under the "Sales Representative Permissions" a new permission labelled "Switching Customer Account User Baskets" has been added that if set to Allow sales rep users assigned to the permission role are allowed to see and use other users baskets. The user will be able to switch to and use any other user's basket if the "View Customer Account Users" is also set to allow, otherwise the user will only be able to switch and use other users baskets when those users are assigned to a customer account that the sales rep user's sales representative ID matches.
The Customer Account Selection content managed web page area has been modified to contain a setting labelled "User Basket Selection Web Page" that controls the web page that user's may be taken to when wanting to switch to a user basket assigned to the same customer account. That setting controls the "search_record_view_user_baskets_webpage_url" hook that can be within the "Customer Account Selection Record" area format. The area also now has a hook labelled "search_record_view_user_baskets" that indicates whether the user is allowed to switch baskets for the customer account. It is either set to Y or N, and can be used to hide or show a button/anchor that takes the user to a page containing a Basket Selection area.
The Basket Selection content managed web page area now supports displaying user baskets associated to a customer account that a sales rep user has permission to switch to. The area's "Basket Selection Record" format now contains a hook labelled "basket_record_user_owns_basket" that indicates whether the user viewing to basket owns it or not. The hook may be used to hide a basket deletion anchor/button from showing, since only users who own a basket are allowed to delete a basket.
The order checkout process has now been modified to allow users who have the "Switching Customer Account User Baskets" permission to be able to view, add products to a basket that is owned and used by another user, then perform checkout to confirm the order.
All these changes can a sales rep user who is given permission to perform the process where they view a content managed web page containing a Account Selection area, click on a View/Switch Basket button to be taken to a web page showing all the user baskets that they are allowed to switch to and order on behalf of, then choose a basket that they wish to use and order with.

Functionality Affected: Basket Selection and Customer Account Selection content managed web page areas, Basket Switching process, Order Submission process
Impact: Normal

TOT-3980 - Allow selected year drop down to stay selected after a model is selected within the Model Search Form content managed web page area

On a content managed web page containing a Model Search Form area, as well as within the Trade interface's Model Search Form. If the user selects a Make within the Make drop down, then chooses a year in the Year drop down, if the user then chooses a model in the Model drop down, then the Year drop down will now keep the previous year selected as long as the selected model has match for the year. If it doesn't then the year drop down will revert to displaying the All Years option.

Functionality Affected: Model Search Form content managed web page area, Trade interface
Impact: Normal

TOT-3960 - Resend Emedia Email to users who haven't read the email within Emedia Messaging Admin Centre interface

Within the Administration Centre, under the Marketing menu, within the Emedia Messaging interface, upon clicking on the View Results button for an Emedia Email, in the Emedia Results dialog within the Send Out Date table there is an additional button labelled "Resend Unviewed". If clicked on it will display a confirmation dialog, that when confirmed will allow the Emedia Email to be resent to any users who had not viewed the email at the particular send date.
Note that users may receive this email multiple times if they either don't allow images/content to be downloaded when the email is viewed, or they are viewing the email in its plain text form. Also note that the email resent to the users will be based on the currently configured email set for the Emedia at the time.

Functionality Affected: Emedia Messaging administration centre interface
Impact: Normal

Improvements

TOT-3952 - Facility role permission setting to determine if a sales rep user can choose from the payment types of the customer account they are assigned to or currently using

There is now the ability to restrict users when switching customer accounts on using the payment types assigned to their primary assigned customer account, instead of switching across to the payment types matching the customer account in use.
Within the Administration Centre, under the Users menu, within the User Permissions interface, upon modifying a Facility Role, under the "Briefcase My Details Permissions" section a new permission now appears labelled "Switch Customer Account Payment Types". If these is set to Allow (default) then when a user switches customer accounts, then the payment types they are allowed to select to order with will match payments set for the customer account in use. If the permission is set to Deny, then the payment types the user is allowed to order with always remain the same, based on the customer account they are directly assigned to.
Note that this new permission is ignored if the user tries to checkout with a customer account that requires the order to be paid with a credit card because the account is on hold, outside its payment terms, or outside its balance limit.

Functionality Affected: Basket Switching process, Order Checkout/Submission process
Impact: Normal

TOT-3962 - Don't allow users to proceed through order checkout if no freight carrier is selected from available 3rd party retrieved carriers

On a content managed web page containing either a Guest Order Checkout/Submission area or a Order Checkout/Submission area, if the project's "Freight Provider Calculate Order Freight Surcharge" setting is set to yes and the "Freight Provider Surcharge Calculation Fail Action" setting is set to "Continue Processing Surcharge Rules". Then when a user proceeds through the order checkout process and has the ability to choose from one or more freight carriers found via SmartFreight, if the user does not select a carrier they will now be blocked from continuing on to the Order Review page and instead see the error message that is set in the "3rd Party Freight Carrier Not Found" project setting.
Note that if SmartFreight did not find any 3rd party carriers then the user will be still allowed to proceed with the order checkout process, ensuring they can complete the process if Smartfreight's system was unavailable.

Functionality Affected: Basket Switching process, Order Checkout/Submission process
Impact: Normal

TOT-3969 - Order Surcharge ACTION rule to control if order is allowed to be sent to SmartFreight

There's now the ability to control which orders submitted by users are sent to SmartFreight if the Integrated Freight feature is turned on.
Within the Administration Centre, under the Stores menu, within the Order Surcharges interface, upon creating an ACTION rule, within the "Add New Action Rule Node" dialog, in the actions drop down a new option labelled "Send Order To Freight Provider %VALUE%" now appears. If selected, and the value textbox is set to NO, N, or FALSE, then when a user proceeds through the Order Checkout/Submission process, once they have submitted the order and the Integrated Freight Feature is turned on, then the order will be ignored from submitting to Smart Freight. If the surcharge rule is set to Y or YES then the order will be allowed to be sent to SmartFreight if configured to do so.
Note that this surcharge rule does not have any bearing if orders are resubmitted by admins from the within the Orders Administration Centre interface, or by Purchasing Manager users without modifying a pending order.

Functionality Affected: Basket Switching process, Order Checkout/Submission process, Order Surcharges administration centre interface
Impact: Normal

TOT-3977 - Payment gateway to send credit card payments to Eway that forces credit card CVN number validation

An additional credit card payment gateway has been added the enables credit cards to be set to Eway's payment gateway that provides additional checks on a credit card's CVN number (3 or 4 digit code on the back of a card). This may be required when a merchant bank account is set up with certain banks, such as Bendigo Bank.
Within the Administration Centre, under the Stores menu, within the Payments interface, under the Credit Card section, for the "Credit Card Payment Gateway" setting there is now an option labelled "Eway (With Card CVN Number Checks)". When selected this will allow credit card payments made either through the Payments admin centre interface, Order Checkout/Submission process, or customer account invoice payments to be sent to Eway, and processed through its CVN web service endpoint.

Functionality Affected: Eway Credit Card Payment process, Stores Payments administration centre interface
Impact: Normal

TOT-3979 - Pagination within Basket Products Listing content managed web page area

On a content managed web page containing a Basket Products Listing area, there is now the ability to limit the amount of products that display in the area, and allow users to paginate the area. This can be used to speed up how long it takes for the area to load, especially when many products exist within the user's basket.
Within the Administration Centre, under the Websites menu, within the Websites interface, upon viewing a content managed web page within the Web Page Editor, viewing the Editor of a Basket Products Listing area a new setting labelled "Basket Products Records Per Page" now appears. If the setting is set to a number then it will limit the amount of products that appear in the area.
Within the area's Basket Header and Basket Products Footer formats the following format hooks now exist that allow paginator elements to be embedded within the area:

• basket_products_page_number: Number of the page currently showing products within the basket.
• basket_products_page_list: List of page numbers allowing the user to paginate between pages of basket product records.
• basket_products_next_page_class: Suffix CSS class text that specifies if the user can paginate forward any further
• basket_products_prev_page_class: Suffix CSS class text that specifies if the user can paginate backwards any further
• basket_products_next_page_anchor: Anchor element that allows the user to paginate to the next page of products
• basket_products_prev_page_anchor: Anchor element that allows the user to paginate to the previous page of products
• basket_products_per_page_dropdown: Drop down that allows the user to change the amount of products displayed per page.
• basket_products_page_number: Number of the page currently showing products within the basket.

Bug Fixes

TOT-3972 - User Detail admin centre interface not correctly saving Sales Representative ID field of user if the field is unselected

Within the Administration Centre, under the Users menu, in the Search Users interface, after finding a user and clicking on its login ID, within the User Detail interface, if the administration user had left the Sales Representative ID field unselected, then when they clicked on the Update button, the user's Is Password Expired field was ignored from being saved. Now the Password Expired field is correctly saved.
Note this change also occurs for any other user fields in the User Details admin centre interface that are set based on checkboxes.

Functionality Affected: User Detail administration centre interface
Impact: Normal

TOT-3976 - Users unable to filter customer accounts assigned to them within the Customer Account Selection content managed web page area when they don't have permission to view all customer accounts

Within a content managed webpage that contains a Customer Account Selection area, if the user had multiple customer accounts assigned to them and the user was assigned to a Facility permission role that had the View All User Accounts permission set to deny, then the area would initially display all customer accounts assigned to them. If the user then tried to filter the customer accounts by either setting an company name, account code, or login ID search text fields, then after clicking on the Search button no customer accounts would display, regardless of whether the search term matches a customer account. The area now correctly returns a list of customer accounts assigned to them based on the search filters set.

Functionality Affected: Customer Account Selection content managed web page area
Impact: Normal

Improvements

TOT-3903 - Setting to customise the subject in an Enquiry Form content managed web page area submission

When a user submits an enquiry form on an Enquiry Form content managed web page area, the email notification's subject is now configurable for each Enquiry Form area.
Within the Administration Centre, under the Websites interface, for a web page that contains an Enquiry Form area, within the Webpage Editor, in the Enquiry Form area's settings dialog, a new setting labelled "Emarketing Email Subject" has been added that allows the admin user to set the subject that appears in the enquiry form submission email notification.
In the setting admin users may put placeholders allowing the values of enquiry form elements to appear in the subject. To do so place the data hook $element_value_[element_name]$ where [element_name] is replaced with the actual name of the enquiry form's value you wish to embed in the subject ie. $element_value_phone_number$ for an enquiry form that has a phone_number element.
If the Emarketing Email Subject setting is not set or left empty then the email notification subject will default to the default "ENQUIRY REQUEST" subject when an enquiry form email notification is sent.

Functionality Affected: Enquiry Form content managed web page area
Impact: Normal

TOT-3920 - Identify traffic from SEOKicks crawler within the Project Traffic Statistics Administration Centre interface

Within the Administration Centre, under the Statistics menu, within the Project Traffic Statistics interface, under the "Requests By Search Engines, Crawlers and Software" section it now is able to report and show requests made by the SEO Kicks crawler. This crawler is associated to www.seokicks.de, which is a marketing company in Germany that crawls websites. Additionally the Project Traffic Statistics interface now loads over a secure connection.

Functionality Affected: Project Traffic Statistics admin centre interface
Impact: Minor

TOT-3922 - Allow value_holder data hooks to be placed within Order Surcharge IF rule values

Within the Administration Centre, under the Stores menu, within the Order Surcharges interface, if an IF rule is added to the surcharge tree, there is now the ability to compare the value of a basket/order field with the value set within a value holder. Upon editing or adding an IF rule node, within the Add/Modify IF Rule Node dialog, in the value textbox administrator users can enter the data hooks $value_holder$, $value_holder2$, $value_holder3$ or $value_holder4$.
When the order surcharge rules are executed within the Trade interface for a content managed webpage containing Freight Surcharge Calculator or within the Order Checkout/Review area the value_holder data hooks will be replaced with the value previously set against them. The evaluated value will then be compared against the order/basket field value that is selected for the IF rule.
Note that only value_holder data hooks will evaluate within IF order surcharge rule values, and other data hooks will fail to evaluate.

Functionality Affected: Order Surcharges admin centre interface, Order Submission process
Impact: Normal

TOT-3927 - Customer Account and user hooks in Basket Selection Record area format in Basket Selection content managed web page area

On a content managed web page displaying a Basket Selection area, for each basket record displayed in the area, it is now able to display additional data about the user and customer account assigned to each basket. in the area's Basket Selection Record format the following hooks have been added:

• basket_record_customer_account_company_name: Name of the company set against the customer account who is assigned to the basket.
• basket_record_customer_account_contact: Name of the contact person set against the customer account who is assigned to the basket.
• basket_record_customer_account_business_number: Business number set against the customer account who is assigned to the basket.
• basket_record_customer_account_territory: Territory set against the customer account who is assigned to the basket.
• basket_record_user_login_id: Login ID of the user who is assigned to the basket.
• basket_record_user_contact: Name of contact for the user who is assigned to the basket.
• basket_record_user_email: Email address of the user who is assigned to the basket.
• basket_record_user_mobile: Mobile phone number of the user who is assigned to the basket.
• basket_record_user_name1: First name of the user who is assigned to the basket.
• basket_record_user_name2: Second name of the user who is assigned to the basket.
• basket_record_user_name3: Third name of the user who is assigned to the basket.
• basket_record_user_company_name: Company name set against the user who is assigned to the basket.
• basket_record_user_display_name: Display name of the user who is assigned to the basket.', 'User Display Name

Any of these format hooks can be optionally embedded within the area's format.

Functionality Affected: Basket Selection content managed web page area
Impact: Normal

TOT-3929 - Setting to not allow customer account quotes to be converted to orders if one or more products cannot be priced and raise email notification

On a content managed web page area that contains a Customer Account Enquiry Quotes Listing area, if the user has permission to convert a selected quote to an order, there are now settings that controls if the user is allowed to convert a quote to an order when one or more products in the quote cannot be priced. There is also the ability for an email notification to be sent out to nominated email addresses when a user attempts and fails to convert a quote to an order. Additionally new settings have been added to set the message that users see if a quote fails to be converted to an order.
Within the Administration Centre, under the Stores menu, within the Order Settings interface, a section has been added labelled "Quote To Order Conversion". Within that section the following settings have been added:

• Quote To Order Conversion Line Matching Conditions: Determines the conditions on whether a retrieve account enquiry quote record can be converted into an order, based on how quote lines are matched to products. If set to "At Least One Quote Line Matches A Product" then at least one item line in the quote must match an active priced product for a quote to be allowed to convert to an order. If set to "All Quote Lines Must Match Products" then all item lines in the quote must match an active priced product for the quote to be allowed to convert to an order.
• Quote To Order Conversion Fail Permission Message: Set the message that displays when a retrieved account enquiry quote record fails to be converted to an order because the user's Facility permission role does not allow them to convert quotes into orders.
• Quote To Order Conversion Fail No Lines Matched Message: Set the message that displays when a retrieved account enquiry quote record fails to be converted to an order because the none of the quote lines match any active products that the user is allowed to buy
• Quote To Order Conversion Fail Line(s) Not Matched Message: Set the message that displays when a retrieved account enquiry quote record fails to be converted to an order because one or more of the quote lines match any active products that the user is allowed to buy
• Send Notification Email When Quote To Order Conversion Fails: Set if an email notification should be sent out when a retrieved account enquiry quote record fails to be converted to an order.
• Quote To Order Conversion Notification Email Recipients: Set a comma separated list of email addresses who will receive an email notification when a user fails to convert an account enquiry quote record to an order
• Quote To Order Conversion Notification Email Subject: Set the subject that displays with the notification email when the user fails to convert an account enquiry quote record to an order
• Quote To Order Conversion Fail Notification Email Content Format: Set the message content that displays within the notification email when the user fails to convert an account enquiry quote record to an order.

Once these settings have been saved then the next time a quote is attempted to be converted into an order within the Customer Account Enquiry Quotes Listing area the settings will come into effect.

Functionality Affected: Customer Account Enquiry Quotes Listing content managed web page area
Impact: Normal

TOT-3933 - Add settings to Product Quick Add Form content managed web page area to allow the first found product to automatically be added to basket with a default quantity

On a content managed web page containing a Product Quick Add Form area, it now has the ability to automatically add the first found product to basket as soon as one or more products matches the search text given. Additionally the area now supports adding the pack quantity of a product to basket if selected from the unit selection drop down. The area also supports setting the quantity of the product already added to basket in the quantity text box, as well as setting a customisable default quantity if the product has not yet been added to basket.
With the area's settings window within the Administration Centre's Web Page Editor interface the following settings have been added to the Product Quick Add Form area:

• Initially Select Add Product To Basket Checkbox: If set to Yes, then within the area's Basket Quick Add Form area format if a checkbox exists with the ID of the "quick_add_product_auto_add_checkbox_id" data hook value, then the check box will be selected when the area initially loads on page. This controls if the first product found in the quick add should be added automatically to basket or not.
• Select Product Pack Unit: If set to Yes then if a drop down element is embedded within the Basket Quick Add Form area format with the ID of the "quick_add_product_unit_select_element_id" data hook value, then the default option set for the drop down should be set to PACK if the product found can be added to basket in as the quantity that makes up a pack.
• Default Product Quantity: Either leave empty or set a numeric quantity that will be set in the area's quantity textbox when a product is found and hasn't been previously added to basket.
• Increase Product Quantity By: Either leave empty or set a numeric quantity that will be added to the quantity of a product that has already been added to basket, and is displayed in the quantity textbox. This allows the quantity of the product added to basket to increase when added to basket from the area multiple times, such as using a barcode scanner device.

Within the area's Basket Quick Add Form area the following hooks have been added:

• quick_add_product_auto_add_checkbox_id: Contains the ID that needs to be set within the ID attribute of a checkbox element, that controls if the first found product should be automatically added to basket without being selected.
• quick_add_product_unit_select_element_id: Contains the ID that needs to be set within the ID attribute of a drop down select element, that allows the user to choose if a product is added to basket as individual units, or in pack quantities.

Within the area a checkbox can be embedded within its format to allow the user to choose if they want products to be automatically added to basket if they are the first option found with the search text given. Is this checkbox is selected then the area will select the product automatically and load its details into the area, as well as try to add the product to basket. For this to work the quantity textbox must have a default value set, based on the settings configured within the area. If the product is successfully added to basket then the area will clear the details of the product and focus back to the search textbox. If a product previously added to basket is loaded in the area, then its quantity will be set in the quantity textbox. If the Increase Product Quantity By area setting is set to a numeric value then the quantity in the textbox will be increased by the amount set. This allows barcode scanners to be used to repeatedly enter the same product code, with each scan increasing the product quantity added to basket.
Additionally within the area a select drop down can be embedded that allows the user to choose if they wish to add an individual quantity to basket or a pack quantity (if the product has multiple quantities per pack set). This drop down can be automatically set to always choose the pack option if available for the product based on the area's Select Product Pack Unit setting.

Functionality Affected: Product Quick Add Form content managed web page area
Impact: Normal

TOT-3934 - Settings to calculate freight order units based on weight for SmartFreight orders

For an order submitted by a user through either the Trade interface, or content managed website, or an freight order resent from the within the Administration Centre's Orders interface, if the order is sent to Smartfreight then the freight unit set within the order data can now be determined based on the total weight of products in the the order. Additionally there is now the ability to determine the freight unit set in the SmartFreight order data factoring both volume and weight of the order.
Project settings have been created to specify the maximum weight of each freight unit, and the weight threshold before a larger freight unit should be used.
Within the Administration Centre under the Stores menu, within the Freight Providers settings interface, under the Freight Provider - SmartFreight section the following settings have been added:

• Freight Unit 1 Weight: Sets the the amount of weight (in kilograms) that can fit into the selected first freight unit setting. This is used to calculate the quantity of units needed to carry the freight, which is used for freight cost estimates and full order importing.
• Freight Unit Chosen By Checking: Determines which freight unit is set within the order when sent to SmartFreight. This is based on checking either the volume thresholds against the total order volume, the weight thresholds against the order total weight, or both. If both volume and weight is checked then the highest unit of either will determine the freight unit used.
• Freight Unit Weight Threshold 1: Set the a value in kilograms that if the total order weight exceeds will cause the second freight unit to be set in the order details sent to SmartFreight.
• Freight Unit 2 Weight: Sets the the amount of weight (in kilograms) that can fit into the selected second freight unit setting. This is used to calculate the quantity of units needed to carry the freight, which is used for freight cost estimates and full order importing.
• Freight Unit Weight Threshold 2: Set the a value in kilograms that if the total order weight exceeds will cause the third freight unit to be set in the order details sent to SmartFreight.
• Freight Unit 3 Weight: Sets the the amount of weight (in kilograms) that can fit into the selected third freight unit setting. This is used to calculate the quantity of units needed to carry the freight, which is used for freight cost estimates and full order importing.
• Freight Unit Weight Threshold 3: Set the a value in kilograms that if the total order weight exceeds will cause the fourth freight unit to be set in the order details sent to SmartFreight.
• Freight Unit 4 Weight: Sets the the amount of weight (in kilograms) that can fit into the selected fourth freight unit setting. This is used to calculate the quantity of units needed to carry the freight, which is used for freight cost estimates and full order importing.
• Freight Unit Weight Threshold 4: Set the a value in kilograms that if the total order weight exceeds will cause the fifth freight unit to be set in the order details sent to SmartFreight.
• Freight Unit 5 Weight: Sets the the amount of weight (in kilograms) that can fit into the selected fifth freight unit setting. This is used to calculate the quantity of units needed to carry the freight, which is used for freight cost estimates and full order importing.

If the Freight Unit Chosen By Checking setting is set to Volume then only the Freight Unit Volume Thresholds settings will be checked against when a freight order is sent to SmartFreight. Is the setting is set to Weight then only the Freight Unit Weight Thresholds settings will be checked against when a freight order is sent to SmartFreight. If the setting is set to Volume and Weight then both the volume and weight threshold settings will be checked against. In this case the freight unit chosen will be based on the freight unit that meets the highest volume or weight threshold. If thresholds are set to 0 then freight units for these thresholds will be ignored.
It is recommended to use both weight and volume settings to determine the most accurate amount of freight the that ordered products need to be packaged in. Note that these settings only need to be set if the "Send Freight Orders To 3rd Party Freight Provider" is set to "SmartFreight - Full Import" or the "Freight Provider Calculate Order Freight Surcharge" setting is set to Yes, to ensure that SmartFreight can correctly price the order with the correct number of freight units specified.

Functionality Affected: SmartFreight Order submission
Impact: Normal

TOT-3938 - Settings to control how order products are sorted when sales order is displayed within the Trade interface, content managed website, Administration Centre and sent to the Connector software

Within the Trade interface, Administration Centre, content managed websites, and Connector order submission the ordering of products in Order Review and Order Detail areas and listings is now controlled 2 new settings added to the Administration Centre. This allows administrators to have further control over how products are sorted, both for users and within their own connected business system.
Within the Administration Centre, under the Stores menu, within the Order settings interface, the following settings have been added:

• Order Products Sort By Field: Set the field used to sort products that display within an order, as well as when sent to the Connector software/connected business system. By default the setting is set to Product Code to maintain previous sorting behaviour.
• Order Products Sort By Direction: Set the direction that products are sorted by when displayed within an order, as well as when sent to the Conenctor software/connected business system. By default the setting is set to Ascending to maintain previous sorting behaviour.

Once these settings have been saved then they will apply when any users reference the webpage where they are viewing the order detail from, or when an order is next submitted to the Connector software.

Functionality Affected: Order Submission process
Impact: Normal

TOT-3939 - Setting to set the prefix text within the Special Instruction field when an order is sent to SmartFreight

When an order is submitted through either the Trade interface, content managed website, or the order resent from the Administration Centre's Orders interface to SmartFreight, within the SmartFreight order detail, within the first Special Instructions field a setting now exists to control what prefix text is set in the field before the delivery contact name and order instructions.
Within the Administration Centre, under the Stores menu, within the Freight Providers settings interface a new setting has been added labelled "Smart Freight Order Special Instructions Prefix Text". The value set in this setting will be placed at the beginning of the SmartFreight order's Special Instructions field. By default the setting is set to "ATTN:". The maximum length for the setting is set to 50 characters.

Functionality Affected: SmartFreight Order Submission process
Impact: Minor

TOT-3947 - Setting to allow the allocated Sales Rep ID to be seen on Order Confirmation Email Notification when a non sales rep user submits an order

When a user submits a sales order either through the Trade interface, or from a content managed web page containing an Order Checkout/Submission, Guest Order Checkout.Submission, Pending Order.Review areas, when the order is submitted by a user who is not set as a sales rep user, and the "Sales Rep Assigned To The Order" setting within the Administration Centre's Order interface is set to "Account", then when the order confirmation email notification is sent out the details of the sales representative assigned to the order are able to display within both the email content, and order attachment with the existing data hooks provided in the "Order Confirmation Email Message Format" and "Order Confirmation Email Order Detail Format" settings.
Within the Administration Centre, under the Stores menu, within the Order settings interface, a new setting labelled "Display Sales Rep Details Assigned To Order" has been added. If it is set to Yes then the details of sales rep assigned to the order will display in the order confirmation email, else if the setting is set to No then if the user who submitted the order is assigned as a sales rep user, then the details of the sales rep assigned to the user will be displayed (the default behaviour).

Functionality Affected: Order Submission process
Impact: Normal

TOT-3950 - Set a sender email field when an order is submitted to SmartFreight

When an order is submitted via either the Trade interface, content managed website, or via the Administration Centre, if the project is configured to be send the order to the SmartFreight service with either the partial import or full import, in the order details an additional field called "sendemail" will now be set that places the email address of the "Order Sender Email Address" project setting into the field, if the setting is not empty. This will allow SmartFreight to send out an email notifications to the customer notifying them of the delivery taking place with the freight carrier.

Functionality Affected: SmartFreight Order Submission process
Impact: Normal

TOT-3954 - Ordering field for product images to sort list of images for a product

For product images a new field has been added called "Ordering" that can be set to control how product images are sorted when multiple images are assigned to a product, and the product is displayed in a list on a content managed web page containing a Product Detail area.
Additionally the image's ordering field may determine which image should show for an image within Product Search Results Listing areas, order details areas, and other places a product's image displays. The ordering field is only used if no primary image is set for a product. The product images will be sorted based on the image containing the lowest ordering to the highest ordering.
Within the Administration Centre, under the Inventory menu, in the Product Editor interface, under the Images tab a new field called "ordering" has been added to allow a numeric value set by an administrator user.
The ordering field of a product image can also be set by the Connector via the Product Image connector data import, if the ordering field is set active within the Connector, otherwise the ordering field's data won't be changed.

Functionality Affected: Product Image data import, Product Editor admin centre interface
Impact: Normal

Bug Fixes

TOT-3918 - User Detail Administration Centre interface incorrectly showing primary inactive customer account address

Within the admin centre, under the Users menu, within the User Search interface, after finding a user and clicking on the user's login ID, within the Users Details interface, under the the Account Information section, it was incorrectly showing an inactive primary address of the customer account the user is assigned to.
Now within the Users Details interface, under the the Account Information section, it will only show active primary address details of the customer account the user is assigned to. If no active primary address exists for the customer account then it will display empty address fields.

Functionality Affected: User Detail admin centre interface
Impact: Normal

TOT-3921 - Orders and invoices paid with SecurePay credit card payment type incorrectly rounding payment amount

Within either the Trade interface, or on a content managed website that contains an Order Checkout/Submission area, after a user had added products to basket and proceeded to the Order Checkout Detail area, if they clicked on the Credit Card payment type, then clicked the next button, and enter the credit card details and clicked the pay button, if the payment gateway handling the credit card payment is set to Secure Pay, then the payment amount may have its cents incorrectly rounded up or down. This caused a difference between the order total amount inc. tax, and the payment amount.
Now the payment amount is correctly not rounded when sent to SecurePay, ensuring that the payment total matches the invoice/order/custom payment amount required.

Functionality Affected: Secure Pay Credit Card Payment process
Impact: Normal

TOT-3931 - Add to Basket Javascript event listener is not being fired after product added to basket in Product Deals Listing content managed web page area contained within an area popup

On a content managed web page containing any area that calls an area popup, if the area within the popup caused an event to take place that 3rd party javascript is listening to, the event won't be called because at the time the event listening function was added the area within the popup wouldn't have existed.
To get around this issue an additional parameter has been added to the TOTECS.retail.fs.createWebPageAreaPopupDialog dialog called afterAreasLoadedFunction.
This parameter takes a function that will be called once the areas within the popup dialog have loaded. It is within this function that Javascript code called to add an event listener to one or all areas that loaded in the function, or on the web page.

Functionality Affected: content managed web page
Impact: Normal

TOT-3932 - Customer Account Listing content managed web page areas displays incorrect date range when pagination is selected and date range is set to Last 90+ Days

On a content managed web page that contains either a Customer Account Invoice Listing, Customer Account Sales Order Listing, Customer Account Back Order Listing, Customer Account Credit Listing, Customer Account Payment Listing, Customer Account Quote Listing or Customer Account Transaction Listing, if the user had set the date range drop down to the "Last 90+ Days" option, then if the record list contained multiple pages of records, upon the user clicking on any page number link, the date range drop down would incorrectly no longer display "Last 90+ Days" date option.
Now if the user had selected the "Last 90+ Days" date range drop down option, then the option will correctly still stay selected if the user paginates to another page of records.

Functionality Affected: Customer Account Invoice Listing, Customer Account Sales Order Listing, Customer Account Back Order Listing, Customer Account Credit Listing, Customer Account Payment Listing, Customer Account Quote Listing or Customer Account Transaction Listing content managed web page areas
Impact: Normal

TOT-3935 - Related Products Connector data import unable to link products together when a product contains letters in its keyProductID

Within the Administration Centre, under the Data menu, within the Data Imports interface, in the Connector Imports tab when the Related Products data imports ran, for each related product record being processed, if the Key Product ID of a product contained a letter character, then the data import would fail to relate one product to another.
Now if the Key Product ID of a product contains a letter character, then the data import will now correctly relate one product to another.

Functionality Affected: Related Products Connector data import
Impact: Normal

TOT-3936 - Users incorrectly allowed to add an out of stock product to basket when Check Stock setting is turned on and the user does not have permission to back order

Within either the Trade interface or from a content managed website, if a user tried to add a product to basket and they are assigned to a inventory role that either has the backorder permission set to deny, or the product has an override with the backorder permission set to deny, and the Check Stock project setting is turned on, then the user would incorrectly be to add the product to basket that they weren't allowed to.
Now users will correctly be unable to add a product to basket when the quantity being added exceeds the available stock quantity.
Previously the add-to-basket process was incorrectly checking to see if the user's inventory role had the back order permission set to Allow, as opposed to Deny. The bug only affects customers who have the "Check Stock" project setting turned on.

Functionality Affected: Add Product To Basket process
Impact: Normal

TOT-3941 - User Detail content managed web page area not showing correct customer account balance when the user is not a sales rep and has permission to switch accounts assigned to them

On a content managed webpage display a User Detail area, if the user was not a sales rep user and was assigned to a Facility Role that had the "View Customer Accounts" permission set to allow, then when they switched to a customer account they were assigned to the User Detail area would not incorrectly still show the balance of the account assigned to their primary basket.
The User Detail area now will show the details of the customer account that the user has assigned to them and has switched to.

Functionality Affected: User Detail content managed web page area
Impact: Normal

TOT-3943 - Product back order warning message not displaying when an out-of-stock product quantity is added to basket and Check Stock is setting set to WARN and user has permission to back order a product

Within in either a content managed website or on the Trade interface, if the "Check Stock" order setting is set to "Warn" then the warning message wasn't being displayed if a user added a product to basket from either interface and the quantity added exceeded the available quantity of the product when the user is assigned to an inventory permission role that allowed them to back order the product.
Now if the "Check Stock" order setting is set to "Warn" then warning message will be displayed if a user adds a product to basket from either interface and the quantity added exceeds the available quantity of the product, regardless of whether the user has permission to back order the product or not.
Note that if the "Check Stock" setting is set to BLOCK and the user has permission to back order a product being added to basket that is out-of-stock, the product will be silently added to basket and no blocking mechanism will occur.

Functionality Affected: Product Add To Basket process
Impact: Normal

TOT-3945 - Checkout process fails when using ZipPay payment method with invalid user/product data.

Within a content managed webpage containing a Order Checkout/Submission area, when a user tried to checkout using the ZipPay payment method and either the order product data or user data was invalid, the ZipPay API would fail and the user would not receive feedback of the failure. This could cause confusion for the user.
Now if a user tries to checkout using the ZipPay payment method and either product or user data is invalid, an error message will be returned from the ZipPay API and displayed to the user. The user will remain at the Order Detail screen until either the invalid data is corrected or a different payment method is selected.

Functionality Affected: Order Checkout/Submission content managed web page area
Impact: Normal

TOT-3948 - Product Attributes Connector data import failing to complete successfully when attribute records contain no dataType property

Within the Administration Centre, under the Data menu, within the Data Imports interface, in the Connector Imports tab, if a Product Attributes data import was ran, the import was not able to successfully complete if the attribute records being imported contain no dataType property. When this property wasn't included in the data then data import would abort with the error "An error occurred whilst trying to create a new attribute in the product attribute data import".
Now if a Product Attributes data import is ran, the import will now successfully complete if the attribute records being imported contain no dataType property. When this property isn't included in the data the data import will ignore trying to read the dataType property if it doesn't exist and by default set an attribute's data type to STRING.

Functionality Affected: Product Attributes Connector data import
Impact: Normal

TOT-3949 - Un-priced combination products incorrectly appearing in Category Listing and Product Search Result Listing content managed web pages when Allow Zero Price Combination Products setting is set to no

On a content managed web page containing either Category Product Listing, Product Search Results Listing, or any other areas that display a list of products, if the project's Allow Zero Price Combination Products setting was set to No then any combination products that have no pricing set would incorrectly appear in product listing areas.
Now if the project's Allow Zero Price Combination Products setting is set to No then any combination products that have no pricing set will now correctly not appear within the product listings.
Previously the Allow Zero Price Combination Products setting was ingored when standardised pricing was built into the TOTECS platform.

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

Improvements

TOT-3836 - Hook to denote when a product is assigned to a contract within the Shopping List Products content managed web page area

On a content managed web page containing a Shopping List Products area, there is now the ability to highlight when a product assigned to the shopping list has it's price is coming from a contract.
Within the area's Shopping List Product Record format a new hook labelled "product_price_is_on_contract" now exists that returns the value "Y" if the product's price came from a contract, either "N" if the price did not come from a contract.
Using this hook in a HTML element's class could be used to highlight or flag products that contains pricing that are contract in the area.

Functionality Affected: Shopping List Products content managed web page area
Impact: Normal

TOT-3895 - Exclude unconfirmed, pending or declined orders from summary order statistics within Sales Summary Statistics admin centre interface

Within the Administration Centre, under the Statistics menu, within the Sales Summary interface, under the Sales Summary heading the Total Sales (Today), Total Sales (Current Month) and Total Sales (YTD) numbers no longer include orders that have not been submitted.
These numbers now exclude unconfirmed, pending, and declined orders.

Functionality Affected: Sales Summary admin centre interface
Impact: Normal

TOT-3896 - Move existing webpage and Email templates, image and attachments libraries between content managed websites within the Websites admin centre interface

Within a TOTECS project there is now the ability for administrator users to move web page and Email templates, as well as web pages assigned to the templates, and image and attachment libraries between content managed websites. This enables different content to be moved between content managed websites and utilised.
Within the Administration Centre, under the Websites menu, within the Websites interface if an administrator user right clicks on a web page template or a Email template, a context menu item labelled "Move" now exists. Once clicked on the Move dialog will appear where the user can choose the content managed website where the template should be moved to. Once the move button is pressed then the template will be moved the website and the Websites interface will reload showing the template under its new website. Note that when a template is moved any web pages that are assigned to it will also be moved across. If another template or web page contains the same name as the template or web page being moved into the website, then the user won't be able to move the template. This can be avoided by either renaming the webpages assigned to the template, or renaming the webpages in the website where the template is being moved to. For conflicting template names, the template in the website where its being moved to would need to be deleted first.
Additionally if an administrator user right clicks on a image or attachment library, a context menu item labelled "Move" now exists. Once clicked on the Move dialog will appear where the user can choose the content managed website where the library and its file contents should be moved to. Once the move button is pressed the library and its files will be moved the selected website and the Websites interface will reload showing the library under its new website. Note that when a library is moved if another library in the selected website contains the same name as the library being moved, then the user won't be able to move the library. This can be avoided by either renaming the conflicting library in the old or new websites.
In order for administrator users to be able to select and perform a move on templates they must be assigned to a Website Permission Role that gives them permission to modify web page templates. In order for administrator users to be able to select and perform a move on image and attachment libraries they must be assigned to a Website Permission Role that gives them permission to modify image libraries and attachment libraries. If the user does not have such permissions then the Move context menu item will stay disabled.

Functionality Affected: Websites admin centre interface
Impact: Normal

TOT-3897 - Setting to configure subject line for submitted order quotes notification email

When an order is successfully submitted through either a content managed website, or via the trade interface, if the order has the "running quote" payment type assigned to it, then when an email notification is sent out, the subject of the email can be controlled by a separate setting within the Administration Centre.
Within the Administration Centre, under the Stores menu, within the Order Settings interface, under the Order Notification Emails section, a setting labelled "Order Quote Email Subject" now exists, that allows an administrator user to set the subject of the quote email notification.
Note that this setting will be used not just at the time of order submission, but also if an administrator re-sends out an email notification from within the Orders administration Centre interface.

Functionality Affected: Order Submission process
Impact: Normal

TOT-3898 - Project setting to control the URL of the SmartFreight web service requests

Within the Administration Centre, under the stores menu, within the Freight Providers settings interface, under the "Freight Provider - SmartFreight" section a new setting labelled "SmartFreight Web Service URL" has been added, that allows the URL of the SmartFreight web service to be set.
When an order is successfully submitted an configured to be sent to SmartFreight, the order will be sent to the SmartFreight server specified in this URL. This same URL is also used for freight quote calculations.

Functionality Affected: Order Submission process
Impact: Normal

TOT-3899 - Filter locations that area searchable, active or have an assigned product within Locations administration Centre interface

Within the Administration Centre, under the Inventory menu within the Locations interface, in the search drop down the following options have been added:

• Location Key: Finds locations based on the search value field partially matching the location key
• Active Locations: Finds all locations that are active
• Inactive Locations: Finds all locations that are marked inactive
• Allowed Searching: Finds all locations where the Allowed Searching is set to Yes
• Not Allowed Searching: Finds all locations where the Allowed Searching is set to No
• Product Code: Finds all locations where a product is assigned to the location and has a product code partially matching the search value field
• Product Name: Finds all locations where a product is assigned to the location and has a product name partially matching the search value field
• Product Key: Finds all locations where a product is assigned to the location and has a product key partially matching the search value field

Note that no search value needs to be set when the search drop down is set to Active Locations, Inactive Locations, Allowed Searching or Not Allowed Searching

Functionality Affected: Locations admin centre interface
Impact: Minor

TOT-3900 - Sales rep hooks to show if a sales rep is assigned to the order in Order Confirmation Email Order Detail Format setting

When an order is successfully submitted either through a content managed website, or via the Trade interface, or within the Administration Centre's Orders interface an adminstrator user re-sends an email for an order, when the order notification email is sent out the sales representative hooks within the email format settings will specify the details linked to the user who is assigned to the order. Additionally new data hooks exist to denote if the user is a sales rep or not when generating the email content.
Within the Administration Centre, under the Stores menu, within the Order Settings interface, under the Order Notification Emails section, within the "Order Confirmation Email Message Format" and "Order Confirmation Email Order Detail Format" settings, a new data hook is available labelled $order_user_is_salesrep$ that either displays the value Y if the user assigned to the order is a sales representative, otherwise displays N if the user is not a sales representative.
This hook may be used with CSS classes to hide or show different details of an order within the order email notification.

Functionality Affected: Order Submission process
Impact: Normal

TOT-3901 - Always allow combination child products to display in Related Products Listing content managed webpage area

Within a content managed website, on a webpage displaying a Related Products Listing area it will now always display combination child products, regardless of whether child combination products are allowed to display in any product listing areas or not.

Functionality Affected: Related Products Listing content managed web page area
Impact: Normal

TOT-3902 - Setting to control the label of default product sorting field select option within the Product Search Results Listing and Category Listing content managed web page areas

There is now a setting that allows Administrator users to configure the label of the default product sorting field option that displays with product search results listings and category listing content managed web page areas.
Within the Administration Centre, under the Stores menu, within the Product Search Settings interface, a setting labelled "Product Default Sort Field Label" now exists that allows administrator users to set the default product sorting field label.

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

TOT-3904 - Setting to include deals in order line attributes when order is submitted to Connector

When an order is sent to the Connector software there is now the ability to optionally include deal information with each ordered product, if a deal was applied to the order.
This product deal data is added to the Connector's order as a a line attribute, and may be used to include additional details about the ordered product when being imported into the connected system.
Within the Administration Centre, under the Stores menu, within the Order Settings interface, 2 new settings have been added:

• Send Order Product Deals As Order Line Attributes: If set to Yes then the deal details associated to a ordered product will be placed on the order line attributes of the order sent to the connector.
• Order Product Deal Attribute Profile ID: Set the value of the Key Profile ID that will be set in an order product line attributes when an order is sent to the connector software and the Send Order Product Deals As Order Line Attributes setting is set to Yes.

When the deal information is set within the order's line attribute, the deal's ID will be placed in the attribute's keyAttributeID field, the deal's offer type in the attribute code, the deal's description in the attribute name, and the number of times the deal was applied in the attribute value field.

Functionality Affected: Order Submission process
Impact: Normal

TOT-3909 - Phone number customer account fields

2 additional fields have been added to customer accounts to store the phone number, and mobile phone number associated to an account.
These fields may be used by administrator users to contact a customer, show a phone number linked to a customer account for users who can view account details, such as sales rep users, or be used to set up 2 factor authentication for users created against new customer accounts.
Within the Administration Centre, under the Users menu, within the Customer Accounts interface, upon searching for a customer account and click on the Details button, in the Customer Account Detail dialog the fields labelled "Phone Number" and "Mobile Phone Number" now display the phone numbers linked to the customer account.
Separately within the Customer Accounts interface additional search options have been added to provide more ways to find customer accounts based on matching data on different fields.
Within the Data menu, in the Data Imports interface, under the Text File tab, the Customer Account text file import now has the Phone Number and Phone Number Mobile fields added to the list of fields that may be set in a text file importing customer account data.
In the Connector Imports tab the Customer Accounts Connector data import now supports importing the phone field for customer accounts obtained from the connector. A setting has been added to the import labelled "Place Phone Number into Mobile Phone Number field". If ticked then then phone number field value will instead be placed in the mobile phone number field for each customer account.
Within the Websites administration centre interface, upon viewing any Web Page Area Format, in the Edit Web Page Area Format, under the Global Format Hooks, 2 hooks labelled "SES_account_phone_number_mobile" and "SES_account_phone_number" have been added that will display the phone number and mobile phone number of the customer account that user's are assigned to when they login, or switch customer account's to within a content managed website.

Functionality Affected: Customer Accounts Connector data import, Customer Accounts Text File data import, content managed website
Impact: Normal

TOT-3910 - Setting to allow locations to be searchable when initially imported through the Locations And Stock Quantities Connector data import

When new locations are first imported through the Locations And Stock Quantities Connector data import, there is now a setting that controls if new locations should be marked as searchable or not when initially imported. This can allows locations to be displayed within Location Finder content managed webpage areas once first imported into a project. This setting may reduce the amount of work administrator users need by avoiding having to set locations as searchable.
Within the Administration Centre, under the Data menu, within the Data Imports interface, under the Connector Imports tab, when the Locations And Stock Quantities Connector data import is run and imports a new location, the data import now contains a setting labelled "Set locations searchable when first created". If the setting it ticked then when a new location is imported its Is Searchable field will be initially set to Yes, otherwise if un-ticked locations initially be set to false when initially imported.

Functionality Affected: Locations And Stock Quantities Connector data import
Impact: Normal

Bug Fixes

TOT-3906 - Location Finder content managed web page area unable to correctly load

On a content managed web page displaying a Location Finder area sometimes the map was unable to load on a webpage where the secure domain of the web page's website did not match the insecure domain.
The area was modified to ensure that it can always correctly load on any content managed web page regardless of the domain it was loading on.

Functionality Affected: Location Finder content managed web page area
Impact: Normal

New Features

TOT-3857 - 2 Factor Authentication for user login using SMS codes

When a user logs into a TOTECS project from a User Login content managed web page area, there is now the ability to authenticate the user using both the login ID and password, as well as a separate 1-time-use code sent to their mobile phone via SMS. This two factor authentication code helps ensure that the user is in possession of an authorized mobile phone, reducing the ability for users to share account credentials which can allow others to easily gain access to the project's data.
To achieve this, TOTECS has integrated into the SMS service provider https://www.smsbroadcast.com.au to send out authentication codes. The platform now supports storing mobile numbers against users, as well as assigning mobile numbers to users generated in the Customer Accounts Connector data import. Additionally a user setting has been added to control whether or not a user requires two factor authentication. If two factor authentication is turned on, but the user does not have a mobile number, then the platform will ignore two factor authentication.
The new settings against a user can be seen by viewing the details of a user, which can be achieved by going to the Administration Centre, under the Users menu, navigate to the Search Users option. Within the Search Users interface, once a user has been searched for, click on the users' Login Id to view the User Details interface. Here you can set the Mobile Number for a user, and also tick the check box "Two Factor Authentication" to turn on this feature for a user.
Settings to control two factor authentication have been added within the Administration Centre, under the Users menu, within the Two Factor Authentication settings interface.
The new settings include:

• SMS Broadcast Username and Password settings
  This is where you store the credentials to your SMS Broadcast service account
• Sender Name/Number
  This setting determines the name of the sender that SMS messages will be sent from
• Message Format
  It is important to note that you must include the $code$ hook within this setting to ensure that the authentication code is sent to the user
• Code Validity Time
  This setting determines how many minutes an authentication code is valid for
• Error messages
  The remaining settings are for customising the error messages that will be displayed to users when something goes wrong.

The login form web area format has been modified to allow users to enter the authentication code. This format can be found by going to the Administration Centre, within the Websites menu navigate to the Websites option, then for a given website expand the Web Area Formats Libraries section, expand the User Login/Logout section, expand the User Login section, expand the User Login Form section, now a format can be modified.The new hooks include:

• two_factor_auth_code_field
  Input for entering the two factor authentication code.
• two_factor_auth_resend_onclick
  Javascript function that requests another authentication code.
• two_factor_auth_stage
  Used to hide/show two factor auth content. Returns Y when the user is at the two factor authentication stage, otherwise returns N.

The user registration form web area format has been modified to allow users to enter a mobile number upon registration. his format can be found by going to the Administration Centre, within the Websites menu navigate to the Websites option, then for a given website expand the Web Area Formats Libraries section, expand the User Registration section, expand the User Registration Form section, now a format can be modified.
The new hook includes:
mobile - Text field for the mobile number of the new user

NOTE:
If using two factor authentication within a Master Website Design project, ensure that the javascript is modified to cause the Login dialog to automatically pop up when a user is in the two factor authentication stage of the login process. This can be achieved by modifying the initWebpageElements function within the mwd scripts to ensure that the URL is being checked for both "login_failure_message" and "two_factor_auth_state".

Functionality Affected: User Login, User Login content managed web page area, User Detail Admin Centre interface, User Text File Data Import
Impact: Major

TOT-586 - Currency Exchange Rates Connector data import

Within the Administration Centre, under the Data menu, within the Data Imports interface, under the Connector Imports tab, a new data import labelled "Currency Exchange Rates" has been added.
This data import will call the project's configured Connector software to have its Currency Exchange Rates adaptor data export that will retrieve the currency exchange rates from its data source. The data import will then update the exchange rate for all currencies that have been provided in the data.
In order for a currency's exchange rate to update in the project the record data from the Connector must have the Sell Currency Code match the project's default currency, and the Buy Currency Code must match the 3 character currency code of a currency listed in the project's Currencies admin interface. Additionally both the buy and sell currencies must have the type set to "FIAT" in order for the exchange rate to update for a currency.
Use the Connector software's adaptor data export schedule to have currency exchange rates automatically update at a specified date/time interval, such as once hourly, daily, or weekly.

Functionality Affected: Currency Exchange Rates Connector data import
Impact: Normal

Improvements

TOT-3731 - Assign new users to project's default locale currency when created through New User Admin Centre interface and Customer Accounts Connector data import

Within the Administration Centre, under the Users menu, within the Create User interface, when a new user is created they will be assigned to the same currency as the project's default currency (as controlled by the "Currency" setting within the Stores setting's General tab, under the Locality section).
Additionally if a Customer Accounts Connector data import is run and it creates new users for an account, it too will set the currency for the new users the same as the project's currency setting.

Functionality Affected: Create User admin centre interface, Customer Accounts connector data import
Impact: Normal

TOT-3741 - User Search Rules to find users who have not placed orders based on a date period within the Administration Centre

Within the Administration Centre, under the Users menu, within the Search Users interface, as well as within Marketing menu under the Marketing User Groups interface, 2 new User Search Rules in the Order History search category have been added to find users that have not ordered products over a date range, or that have not ordered products in the last amount of days/months/years.

Functionality Affected: Users, Product Deals and Vouchers, Marketing User Groups admin centre interfaces
Impact: Normal

TOT-3871 - Alt HTML attribute to product flag images within Product Detail, Product Search Listing, Category Listing content managed web page areas

On a content managed website, when a product flag image is displayed in content managed web page areas that list products, the flag image now contains an alt attribute which contains the label of the product flag being used. This may help search engines and accessibility to the web pages where these images display.

Functionality Affected: Category Listing, Product Search Results Listing content managed web page areas
Impact: Minor

TOT-3874 - Basket Summary content managed web page area to refresh once order has successfully submitted in Order/Checkout Submission areas

On a content managed web page area displaying either an Order Checkout/Submission area, or a Guest Order Checkout/.Submission area, if a user proceeds through checkout and successfully submits an order, then any Basket Summary areas displayed on the web page will dynamically update to show that the basket has been cleared and has no products within it. This ensures users are not confused on whether the order successfully submitted and their basket was cleared.

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission content managed web page areas
Impact: Minor

TOT-3883 - Settings to control the number of decimal places for quantities and prices displayed in Customer Account Enquiry records

On a content managed webpage displaying any account enquiry areas, as well as within the Trade interface and Administration Centre's Account Enquiry feature, any pricing or quantity displayed from records retrieved from connected business systems are now able to display numbers with configurable number of decimal places, based on new settings that control the amount of rounding occurring.
Within the Administration Centre, under the Stores menu, within the Accounting settings interface, the following 2 settings have been added:

• Account enquiry Record Price Decimal Places
  Set the number of decimal places that prices displayed within any customer account enquiry records are rounded to. Match this setting with the price rounding occurring in the connected system where records are being retrieved from.
• Account enquiry Record Quantity Decimal Places
  Set the number of decimal places that quantities displayed within any customer account enquiry records are rounded to. Match this setting with the quantity rounding occurring in the connected system where records are being retrieved from.

These settings will control the rounding of pricing and quantities displayed in customer account enquiry content managed web page areas, as well within the records displayed in the Account Enquiry page within the Trade interface and the Administration Centre.

Functionality Affected:  Account Enquiry Trade interface/Administration Centre page, Stores Settings admin centre interface, Customer Account Enquiry Record content managed web page areas
Impact: Normal

TOT-3890 - Use price groups when Generate Contract Pricing process is run to reduce product account pricing records generated

Within the Administration Centre, under the Users menu, within the Customer Account Contracts interface, when the Generate Contract Pricing button is pressed, or when a Contract Products text file data import is run, the Generate Contract Pricing process will now create pricing-groups for each contract, and assign the accounts to each contract's pricing group. This generates product account pricing records once for each product assigned to the contract and will eliminate large amounts of pricing records being generated when many accounts accounts are assigned to the same contract.

Functionality Affected:  Customer Account Contract Pricing Generation process
Impact: Normal

TOT-3891 - Settings Administration Centre interfaces to load over secure https connection

Within all the Administration Centre's settings the links to the settings interfaces from within the Administration Centre menus now cause the settings interface to load of a https connection, ensuring data within the interfaces is only accessible between the end client browser and the TOTECS servers.

Functionality Affected:  Settings Administration Centre interfaces
Impact: Minor

TOT-3894 - User Registration Profile settings to control the Price Tax Format, 2 Factor Authentication and News/Blog Comment Notifications fields for new users

When a new user registers through the User Registration content managed web page area, the User Registration Profile that they register with is now able to control the values of the Price Tax Format, 2 Factor Authentication and News/Blog Comment Notification fields that are set for the new user initially.
Within the Administration Centre, under the Users menu, within the User Registration Profiles interface, when modifying a profile, under the Profile Details section the following fields have been added that allow the default values for new user's created through the User Registration content managed web page area:

• Price Tax Format
  Controls if registered users sees pricing inclusive of or excluding tax
• Two Factor Authentication
  Controls if the user must use 2 factor authentication to login (such as receiving a login code via SMS)
• Receive News/Blog Notifications
  Controls if users are notified of news/blog item comments made against their posts or posts they have commented on

Functionality Affected: User Registration administration centre interface, User Registration content managed web page area
Impact: Normal

Bug Fixes

TOT-3868 - Primary product image incorrectly being changed to the last product image uploaded when Product Images data import runs

When a product images export is run from the Connector, if a product had multiple images uploaded against it then the last image to be uploaded would incorrectly be made the primary image, regardless of whether the product already had a primary product image set.
The Product Images data import has been modified to correctly not change the existing primary image of a product to a no longer be primary.

Functionality Affected: Product Image data import
Impact: Normal

TOT-3873 - When orders are submitted using ZipPay as a payment method, the payment method in the connector is unpaid

When an order was submitted by a user through either the Trade interface or via an Order Submission content managed web page are, if the order's payment type was set to ZipPay, then when the order was submitted into the connector the payment method incorrectly displayed is Unpaid.
Now when an order is submitted with the payment type set to Zippay, the payment method set within the Connector is now correctly displaying as PROPRIETARY.

Functionality Affected: Order submission
Impact: Major

TOT-3876 - Customer Account Contracts Admin Centre interface unable to load products of a contract when a product contains a newline character in its name

Within the Administration Centre, under the Users menu, within the Customer Account Contracts interface, upon right clicking on a the Edit context menu item, the Products tab was unable to load products when a product contains a newline character within its product name.
Now the Products tab is able to correctly load products when a product name contains a new line character.

Functionality Affected: Customer Account Contracts Admin Centre interface
Impact: Normal

TOT-3879 - User Performance Statistics Admin Centre interface incorrectly showing total ordered products count instead of order count

Within the Administration Centre, under the Statistics menu, in the User Performance Statistics interface the Total Orders displayed in both the summary and table rows was incorrectly displaying the total number of sales order product lines, not the total number of sales.
This figure has now correctly been fixed to show the total number of orders. Additionally the quantity column has been changed to show total number of unique products ordered for each user over the selected date range.
Lastly the User Performance and Product Performance statistics interfaces now initially load data into the data table when the interface initially displays.

Functionality Affected: User Performance and Product Performance statistics Admin Centre interfaces
Impact: Minor

TOT-3887 - Global News Group Blogs/Items Listing content managed website area incorrectly not displaying news/blog items when news/blog group visibility is set to display only on content managed websites

On a content managed web page that contained a News Group Blogs/Items Listing area, if the area was assigned to a global container then the area incorrectly did not display any news/blog items for a news/blog group if the group's visibility settings were set to be displayed only on a content managed website.
Now if the area is assigned to a global container and the group of the news/blog items being displayed only is visible from content managed websites, the area will now correctly allow the group's news/blog item's to appear.

Functionality Affected: News Group Blogs/Items Listing content managed web page area
Impact: Normal

TOT-3888 - Customer Account Selection content managed web page area Sort By dropdown defaults back to User Login ID if other sort by is selected

On a content managed web page containing a Customer Account Selection area the the Sort By dropdown incorrectly defaulted back to User Login ID if Company Name or any another sort by field was selected.
Now if the Sort By dropdown has a selection changed to Company Name then the area will correctly reload with customer accounts sorted by Company Name and the sort by drop down remembering the last selected option.

Functionality Affected: Customer Account Selection content managed web page area
Impact: Normal

TOT-3892 - Make Model Attributes and Products not all loading within the Model Details dialog of the trade interface when bottom most category has multiple products assigned to it

Within the Trade interface, after performing a Make/Model search, upon clicking a model row from the Model search results table, within the Model Detail dialog it failed to finish loading the product data, with the loading messages remain showing and no attribute data displaying.
Now within the Model Detail dialog, if the Model had multiple products assigned to the last category in the Make/Model category tree, the dialog has been modified to ensure that product and attribute data correctly loads when the model's last category contains multiple products assigned to it.

Functionality Affected: Make/Model Search Trade interface
Impact: Normal

Improvements

TOT-3328 - Setting to control if order taxes are calculated and rounded at the order total or line level

When products are added to basket and derived orders, tax rounding applied can now be applied in 2 ways, to match the 2 different different ways that business systems can perform rounding.
There is now the ability for baskets and orders to have the tax rounding calculation done in 2 different ways, either by first rounding tax totals for each product/surcharge and then summing up the taxes together to get the final tax total, or the new 2nd method is to calculate the tax by first totalling all the products and surcharges together that use the same taxcode then apply the tax rate to calculate the tax total that is rounded.The tax total from these product/surcharge tax groups is then summed together to provide the final tax total.
The rounding method used should be set the same as the business system that orders are being imported into to ensure the business system calculates tax the same way. Note that if the 2nd method is used then it is recommended to not show the tax amount calculated for each product in the basket and order review web page areas, since the tax amount may not be accurate due to rounding occurring at the order/basket total level.
Within the Administration Centre, under the Stores menu, within the Order Settings interface a new setting labelled "Basket/Order Tax Rounding Method". By default it is set to "Product Line Total" which causes taxes to be rounded for each line total to the number of decimal places specified in the Product Setting's "Price Decimal Places" value. If the setting is set to "Order/Basket Total".then the tax will be rounded at the basket/order level.

Functionality Affected: Product Add To Basket, Order Submission
Impact: Normal

TOT-3674 - Automatically set up URL route for categories to be routed to the same page as their parent category

For content managed websites a new Webpage URL routing rule has been added that allows users to be taken to a specified webpage based on the URL matching a specified category, or any of its child categories. This can heavily reduce the amount of routing rules needing to be set up when top level category web pages are used for the same child web pages.
Webpages can be set up for each top level category, with the correct attribute profile. When a user navigates to a sub-category it will automatically route to the webpage assigned to the top level category, therefore having the correct attribute profile.
When new sub-categories are added, an admin user will no longer have to manually set up routing for those sub-categories.
Within the Administration Centre under the Websites interface, within the Webpage URL Routing dialog a new routing entity labelled "Category and Children" has been added. This is the type of routing that needs to be configured for top level categories, to enable the children categories to be automatically routed to the specified webpage.

Functionality Affected: Websites Administration Centre interface
Impact: Normal

TOT-3844 - Send an email notification when a user unsubscribes from eMarketing

When Emedia Emails are sent out there is now the ability for an administrator to receive an email notification if any recipient users unsubscribe from emarketing. This allows admins to be easily made aware on who is unsubscribing.
When an Emedia Email is sent out from within the Administration Centre's Emarketing Emedia interface, if a user clicks on the unsubscribe link and unsubscribes from receiving Emails from a given category or all emarketing, a notification email can be sent to the Admin email of the project advising of the unsubscription.
To turn this feature on, within the Administration Centre, within the Marketing menu option, go to the Marketing Settings page.
The following new settings have been added that control the notification emails:

• Send Administrator Email Notification When Users Unsubscribe From Emarketing
  If set to Yes, then when a user unsubscribes from emarketing, the project administrator will be sent an email notification which can contain details of the user.
• Unsubscribe Notification Email Subject
  Subject to go within the notification email
• Unsubscribe Notification Email From Email
  Email address that the notification email is sent from
• Unsubscribe notification email Format
  Body to go within the notification email.

Functionality Affected: Emarketing Email Unsubscribe, Marketing Settings administration centre interface
Impact: Normal

TOT-3847 - Location finder requires web area format for controlling the map marker details

On a content managed web page displaying a Location Finder area, when a user cllicks on a location marker, the Location Detail popup can now be customised to show the required details of the location.
Within the Location Finder content managed web page area, when a user clicks a marker on the map, a window will be displayed showing details of the location.
The information within this window can now be controlled by a format within the web area formats library. This format can be found under Location / Location Finder / Location Marker Detail.
This format contains the same hooks as the existing Location Search Record format, except for post search data (distance from user) and onClick functions.
Additionally a new hook has been added, reset_map_onclick. This hook is to be set within the "onclick" attribute of a HTML element within the format.
When the element is clicked, a javascript function will be called which will clear the search input, search results and reset the map to the initial state.

Functionality Affected: Location Finder content managed web page area
Impact: Normal

TOT-3860 - Speed improvements for Make Model Mapping Connector data import

The Make/Model Mappings Connector data import has been improved to run around 7 times faster then previously. Allowing more make/model data to be imported quicker.
Within the Administration Centre, under the Data menu, within the Data Imports interface, when a Make Model Mappings Connector data import is run, it now is able to import and process make model mapping records around 7 times faster than it previously did.

Functionality Affected: Make/Model Mappings Connector data import
Impact: Normal

TOT-3869 - Increase of the platform API data upload maximum size to 30MB per request

On the TOTECS platform the maximum upload size of any data uploaded for a project has been increased from 20MB to 30MB per request. The allows for larger data imports from the Connector, as well as larger product image and file attachments.

Functionality Affected: All File Uploads
Impact: Normal

TOT-3870 - Allow all products on contract to display in Customer Account Contract Detail content managed webpage area when they are assigned to parent combination products and should not be normally shown

On a content managed web page displaying a Customer Account Contract Detail area, if a product in a contract is assigned to a parent combination product and the project's "Show Combination Children" setting is set to OFF, the area will now ignore this setting and always show products regardless of if they are assigned to a parent combination product or not.

Functionality Affected: Customer Account Contract Detail content managed web page area
Impact: Normal

TOT-3871 - Alt HTML attribute to product flag images within Product Detail, Product Search Listing, Category Listing content managed web page areas

On a content managed website, when a product flag image is displayed, the image now contains an alt attribute which contains the label of the product flag being used. This can help for search engine optimization by allowing search engine crawlers to find more information about the displayed image, as well as accessibility.

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

TOT-3874 - Basket Summary content managed web page area to refresh once order has successfully submitted in Order/Checkout Submission areas

On a content managed web page area displaying either an Order Checkout/Submission area, or a Guest Order Checkout/.Submission area, if a user proceeds through checkout and successfully submits an order, then any Basket Summary areas displayed on the web page will dynamically update to show that the basket has been cleared and has no products within it.

Functionality Affected: Order Checkout/Submission, Guest Order Checkout/Submission content managed web page area
Impact: Normal

Bug Fixes

TOT-3787 - Sales Representatives Connector data import fails to complete if a sales rep record matches a different existing record that contain the same sales rep code

When running the Sales Rep import from the Connector or the Connector imports interface within the admin centre, the import could fail to complete if there is an existing sales representative record with the same keySalesRepID to be updated.
Now if a Sales Representatives Connector data import is run, the data import will now check to see if a conflicting sales rep code exists for a matching record being imported, and if so it will now delete the existing sales rep record, before updating another record to have the same sales rep code.
This avoids issues where an existing sales rep record in an external system has been changed to have the sales rep code that matches another previous record that was deleted.
When this occurs the Sales Rep Connector data import too will remove the old record.

Functionality Affected: Sales Representatives Connector data import
Impact: Normal

TOT-3848 - Product attachment files deleted within the Product Editor Admin Centre interface still are still hosted and downloadable

Within the Administration Centre, under the Inventory menu, within the Product Editor interface, after a product has been loaded, within the Attachments tab if an attachment is right clicked on and the Delete context menu option is selected, the product attachment's file may wasn't being removed from the platform's servers.
Now the product attachment will be correctly removed from the project's database, as well as its file removed from the platform's servers.

Functionality Affected: Product Attachment Deletion
Impact: Normal

TOT-3849 - Unable to paginate or scroll down to the bottom of Customer Accounts Assigned To User dialog in the Search Users Admin Centre interface when dialog height is greater than browser height

Within the administration centre, under the Users menu, within the Search Users interface when viewing the customer accounts assigned to a login, when the interface initially loaded there was no pagination offered despite the number of accounts assigned to a user being greater than the initial 10 results. When the number of results per page is increased, admin users were unable to scroll down to see more the accounts within the account listing area.
The Search Users interface has been modified so that when it's displaying large amounts of records per page, users are now able to scroll down correctly, preventing the dialog from disappearing off the page.

Functionality Affected: Search Users admin centre interface
Impact: Normal

TOT-3854 - Product Search Results Listing incorrectly displaying 0 results when attribute search contains multiple attributes with the same word in its name

On content managed web page that is displaying a Product Search Form area. If the area was configured to display a Product Attribute Search Form and the attribute profile used contains multiple attributes, if the name of one attribute has its word(s) contained within the name of another attribute, then when an attribute search is performed in the Product Search Results Listing area it will always fail to display any product search records.
Now if the area is configured to display a Product Attribute Search Form and the attribute profile used contains multiple attributes, if the name of one attribute has its word(s) contained within the name of another attribute before ot, then when an attribute search is performed in the Product Search Results Listing area now correctly is able to search for products.

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

TOT-3861 - Product Attachment filenames not being updated when Product Attachment import is run

When the Product Attachments data import is run and a file is replaced by another file with the same keyAttachmentID, the attachment's filename was not being updated.
Now when the Product Attachments and Product Images data imports are run it correctly updates the details of the files being imported

Functionality Affected: Product Image and Product Attachment data imports
Impact: Normal

TOT-3864 - Facility role permissions for setting billing/delivery organisation names to be not mandatory functioning incorrectly

On a content managed web page containing a Order Checkout/Submission area, users may have been unable to proceed past the Order Details web area format if the 'Show Address Organisation Name' setting is set to 'Yes', despite the user having the 'Billing Address Organisation Name Not Mandatory' and 'Delivery Address Organisation Name Not Mandatory' permissions both set to allow.
The area has been modified to allow users to successfully checkout when a billing or delivery organisation name is not set and their assigned facility role permission "Billing Address Organisation Name Not Mandatory" and "Delivery Address Organisation Name Not Mandatory" allows them to not specify an address.

Functionality Affected: Order Checkout/Submission content managed web page area
Impact: Normal

TOT-3868 - Primary product image incorrectly being changed to the last product image uploaded when Product Images data import runs

When a product images data export is run from the Connector, if a product had multiple images already assigned to then the last image to be uploaded will be made the primary image, overwriting the original primary image that was set in the admin centre.
The Product Images data import has been modified to correctly not change the existing primary image of a product to a no longer be primary. Previously if a product image being uploaded was the primary image then the import would make it no longer primary, which would cause the next image for the product uploaded to become the primary image.

Functionality Affected: Product Search Product Images data import
Impact: Normal

TOT-3873 - When orders are submitted using ZipPay as a payment method, the payment method in the connector is unpaid

If an order was made through either a content managed website or the Trade interface and it was paid via ZipPay, when the order was submitted into the Connector its payment method was set to UNPAID.
Now when an order is paid for using ZipPay and submitted to the Connector, the payment method shown within the Connector is now correctly displaying PROPRIETARY

Functionality Affected: Connector Order Submission
Impact: Normal

TOT-3876 - Customer Account Contracts Admin Centre interface unable to load products of a contract when a product contains a newline character in its name

Within the Administration Centre, under the Users menu, within the Customer Account Contracts interface, upon right clicking on a the Edit context menu item, the Products tab may have been unable to load products when a product contains a newline character within its product name.
Now within the Customer Account Contracts interface Products tab is able to correctly load products when a product contains a newline character within its product name.

Functionality Affected: Customer Account Contracts admin centre interface
Impact: Normal

TOT-3879 - User Performance Statistics Admin Centre interface incorrectly showing total ordered products count instead of order count

Within the Administration Centre, under the Statistics menu, in the Use Performance Statistics Interface, the incorrect values were being shown for the total order quantities and sales amounts.
The Total Orders displayed in both the summary and table rows was incorrectly display the total number of sales order product lines, not the total number of sales.
This figure has now correctly been fixed to show the total number of orders.
Additionally the quantity column has been changed to show total number of unique products ordered for each user over the selected date range.
Lastly the User Performance and Product Performance statistics interfaces now initially load data into the data table when the interface initially displays.

Functionality Affected: User Performance, Product Performance, Category Performance admin centre interface
Impact: Normal

TOT-3867 - Unable to paginate in Product Search Results Listing content managed web page area after initial login

On a content managed web page display a Product Search Results Listing area that has products loaded within it, after the user clicked on a paginator element the area could have failed to paginate and update with the next page of product data.
Now if the area is being loaded on a web page that contains parameters within the URL from the first time a user logged in and landed on the webpage with the area, it will now correctly handle the parameters to ensure that the the paginators in the URL correctly reload the area.

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

New Features

TOT-3750 - Zippay payment method

Users now have the ability to pay for orders using the Zip Pay payment service.
If a users account includes the payment type "ZP", when a user assigned to that account goes to checkout an order from a Order Checkout/Submission web page area on a content managed website, they will have the ability to select ZipPay as a payment method.
This will redirect the user to the ZipPay website where they can login and confirm payment for the order.
The user will then be redirected back to the content managed website, where they can review the order, and upon submitting the order the ZipPay payment will be confirmed and money transferred from Zip Pay to the business's bank account.
The user then will then need to pay back ZipPay based on the agreed payment terms with Zip Pay.
New settings have been added to the Administration Centre, Stores, Payment Settings interface, which allow admin users to set the ZipPay API key, environment mode (sandbox/live) and locale/currency codes.

Functionality Affected: Store Settings Administration Centre interface, Order submission process, Order Checkout/Submission content managed web page area
Impact: Major

Improvements

TOT-2534 - Add date filtering to the User, Product and Category Performance statistics within the Admin Centre

Within the Administration Centre, under the Statistics menu, within the User Performance, Product Performance and Category Performance interfaces there is now a drop down that allows statistics to be filtered based on a selected number of months. By default this value it set at 1 year.

Functionality Affected:  User Performance, Product Performance and Category Performance admin centre interfaces
Impact: Normal

TOT-2908 - Apply credit card transaction fee when users pay for invoices using Account Enquiry

Within the Trade interface's account enquiry page, or on a content managed web page that contains an account enquiry invoice payment form area, when the user is making a credit card payment for outstanding invoices, there is now the ability to set a surcharge amount or percentage on top of the invoice totals.
This allows customers to factor in the cost of the credit card payment transactions.
Within the Administration Centre, within the Stores menu, within the Accounting Settings interface, there is 4 new settings for configuring credit card surcharges.

• Credit Card Payments Surcharge
  Adjust this setting to either turn surcharges ON or OFF for credit card payments.
• Credit Card Payments Surcharge Type
  Adjust this setting to set a fixed amount or percentage based surcharge.
• Credit Card Payments Surcharge Amount/Rate
  If using fixed amount, enter a dollar value in this field.
  If using a percentage rate, enter a percentage value in this field.
• Credit Card Payments Surcharge Type
  Select the surcharge type to be used. This can either be the default WEB_CC_SURCHARGE or a surcharge imported from an accounting system.

TOT-3151 - Flags Connector data import to re-assign contract flags to products after data is imported

Within the Administration Center, in the Data menu, within the Data Imports interface, under the Connector Imports tab, when a Product Flags data import is run from within the interface or from the Connector software, after the flag records have updated the the data import will call for all flags assigned to active contracts that have not expired to be re-assigned to active products.This allows flags to be assigned to products again using flags assigned to imported contracts.
Previously the Flags data import would remove all contract based flags from products that are not local products.

Functionality Affected: Product Flags connector data import
Impact: Normal

TOT-3574 - Create a hook to allow managers to approve or deny orders in pending order detail review format

Within a Pending Order Detail content managed webpage area, improvements have been made to allow users to approve/decline pending orders.
Two new hooks have been added to the Pending Order Detail format:

• order_approve_onclick (Javascript function that allows a pending order to be approved.)
• order_decline_onclick (Javascript function that allows a pending order to be declined.)

TOT-3717 - Display Basket Product Field records within Pending Order Review, Basket Products Listing, User Details/Favourites/Orders, Order Print Form, Order Checkout/Submission and Guest Order Checkout/Submission content managed web page areas

On a content managed web page containing either a Pending Order Review, User Details/Favourites/Orders, Order Checkout/Submission, Order Print Form or Basket Products Listing content managed web page area, there is now the ability to display the values of product info fields that a user has set for each product within the order.
A new format has been added to each of these areas, the Basket Product Field Record format. This format contains two hooks:

• basket_product_field_label (prints the label of the product info field)
• basket_product_field_value (prints the value set for the product info field)

• basket_product_fields (prints the Basket Product Field Record formats)
• has_basket_product_fields (prints Y if there are Basket Product Field records, or N if there are not)

• the setting is turned on (Admin Centre > Stores > Order Settings > Basket Product Fields)
• a Basket Product Field Record format has been selected
• data exists

TOT-3838 - Setting to set a tax free taxcode to lines in sales orders being delivered internationally

For orders being shipped internationally there is now a setting that controls the tax free taxcode assigned to these order lines.
Within the Administration Centre, under the Stores menu, within the Order Settings interface, a new setting has been added labelled "Tax Free Taxcode On International Orders".
This setting allows admin users to set the tax code that will be assigned to order lines when the order is sent to the Connector software, and the order's delivery country does not match the TOTECS project's country (hence the order is being shipped internationally).
If this setting is not set then the original taxcode assigned to the order line's product will still remain assigned.

Functionality Affected: Store Settings admin centre interface, Connector Order Submission process
Impact: Normal

TOT-3843 - Project Traffic Statistics Administration Centre interface to show statistics created by the SQUIZZ.com Connector and Domain Crawler

For any project server requests made by the SQUIZZ.com Connector and Domain Crawler, these requests are now logged and reported within the Administration Centre, under the Stastistics menu, within the Project Traffic Statistics interface, under the Requests By Search Engines, Crawlers and Software section.

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

TOT-3846 - REST API endpoint to export product customer account pricing

The Data API in the platform has now been modified to allow administrator users to export product customer account pricing data programmatically from a project hosted on the TOTECS platform.
This can allow 3rd party customer systems to obtain all custoemr account product pricing data in their own website, squizz, or business systems by using the data API to export the data.
Within Administration Centre interface under the Data menu, in Data API it will now display logs of requests that are made to the API to obtain product customer account pricing data. This allows administrators to see which users are exporting pricing data.
When the admin user exports product customer account pricing data from the API, the pricing that is returned from the API endpoint will be limited to the products that are active against customer accounts that are active.
Limits have been put in place to ensure that the API in not abused by users, or outside intruders. A maximum of 15 login requests can occur in a 20 minute window create sessions for the API.
When exporting product pricing data its API endpoint can only be called 5 times within a 30 minute window.

Functionality Affected: Data API
Impact: Normal

TOT-3847 - Location finder requires web area format for controlling the map marker details

Within the Location Finder content managed web page area, when a user clicks a marker on the map, a window will be displayed showing details of the location.
The information within this window can now be controlled by a format within the web area formats library. This format can be found under Location / Location Finder / Location Marker Detail.
This format contains the same hooks as the existing Location Search Record format, except for post search data (distance from user) and onClick functions.
Additionally a new hook has been added, reset_map_onclick. This hook is to be set within the onClick attribute of a HTML element within the format.
When the element is clicked, a javascript function will be called which will clear the search input, search results and reset the map to the initial state.

Functionality Affected: Location Finder content managed web page area
Impact: Normal

Bug Fixes

TOT-3594 - Unable to update content managed website details when its domain changes within the Website Details admin centre interface

Within the Administration Centre, under the Websites menu, within the Websites interface, upon clicking on the website domain, in the Website Details interface when updating the website details, an error message could be displayed and the website's domain fail to update in web page areas.
Now upon modifying the website domain and clicking on the Update Site button, the website's domain will be correctly updated within free draw web page areas, news/blog items and formats that are linked to the website.
The bug was caused by mishandling of data on the server side.

Functionality Affected: Website domain update process
Impact: Normal

TOT-3798 - Users created in Customer Accounts Connector data import not being assigned to default permission roles

When a Customer Accounts Connector data import was run from the connector or the Administration Centre's Data Imports interface, the user that was created for a freshly import customer account wasn't assigned to the default facility and inventory user permission roles set for the project.
Now when a Customer Account data export is run, if a new user is created for an account, then at the time the password is being set for the new users they will also be assigned to the default facility and inventory permission roles, based on the default roles configured within the User Permisions admin centre interface.

Functionality Affected: Customer Accounts connector data import
Impact: Normal

TOT-3809 - _P_PriceEx_rrp_titled hook outputting unnecessary nbsp characters

On a content managed web page displaying a Product Detail area, within the area's Product Detail format the hook _P_PriceEx_rrp_titled was outputting unnecessary nbsp characters, causing conflicts when the CSS property text-decoration is set to line-through.
Within a Product Detail content managed web page area, the hook _P_Price_Ex_rrp_titled now no longer outputs unnecessary nbsp characters.

Functionality Affected: Product Detail content managed web page area
Impact: Minor

TOT-3832 - Related Products Export incorrectly limiting to only export 1000 rows of data from the Related Products Report admin centre interface

Within the Administration Centre, from the Inventory menu, within the Related Product Report interface, when exporting a .CSV file, the .csv file that was exported was being limited to 1000 related product mappings.
Now if the Export Report button is clicked on, then upon clicking on the Download Export Data button, the CSV spreadsheet file downloaded will allow up to 10000 records to display within it.

Functionality Affected: Related Product Report admin centre interface
Impact: Minor

TOT-3835 - Unable to remove User from the Search Users Admin Centre interface when they have related users assigned to them

Within the Adminsitration Centre, under the Users menu, within the Search Users interface, once a user has been found and is selected to be removed, the user could not be removed the user if they had one or more related users assigned to them.
Now the Remove Users functionality has been modified to remove all related users from a user before removing the user themselves. This then allows a user to be correctly removed.

Functionality Affected: Search Users admin centre interface
Impact: Normal

TOT-3842 - Location finder exceeds distance calculation limit, formats being output in incorrect order

On a content managed web page that has a Location Finder area, if there are more than 25 searchable locations within a project, the Google API would return an error when trying to calculate driving distances as there is a limit of 25 calculations per request. The order of locations listed in the search results also occasionally appeared in the incorrect order.
Within a Location Finder content managed webpage area, a new hook "search_distance_limit" has been added, which provides a select dropdown containing distances that a user can limit the search by.
The amount of locations that appear in the search results has been limited to 25, to prevent exceeding the driving distance calculation limit. The search results ordering has been modified to ensure results will always appear ordered by driving distance ascending.

Functionality Affected: Location Finder content managed web page area
Impact: Normal

TOT-3845 - Location finder fails to parse JSON after multiple location searches

Within a Location Finder content managed webpage area, the area was failing to show search results if one of the locations could not have driving distance calculated.
The area will no longer fail to show search results if one of the locations could not have driving distance calculated.

Functionality Affected: Location Finder content managed web page area
Impact: Normal

New Features

TOT-3825 - Clone content managed website within the Websites Admin Centre interface

There is now the ability for administrator users to clone an existing content managed website, allowing a new content managed website containing all content copied from an existing website.
This makes it easy for businesses to set up secondary websites based on the exact same structure and content of an existing website.
Within the Administration Centre, in the Websites menu, within the Websites interface, in the Websites tree for each website a new tree node appears labelled "Clone Website".
When this is clicked on the Clone Website dialog will appear where users can enter the domain and other details about the new website.
Once the Create button is clicked on a new content managed website will be created and all of the content of the existing website will be copied across to the new website.
Once a new content managed website is created the TOTECS service will need to be notified about the new website so that the TOTECS platform servers can be configured to forward requests to the website based on its new domain.
Separate the domain of the new website will need to be purchased and DNS records configured to point the domain to the TOTECS platform servers.

Functionality Affected: Websites Administration Centre interface
Impact: Normal

Improvements

TOT-2615 - Import the SEO code field via product text file import within the Data Imports Admin Centre interface

When importing product data from CSV spreadsheet file there is now the ability to set SEO Code field data for each product.
Within the Administration Centre, under the Data menu, within the Data Imports interface, under the Text File Imports tab, when running a Products data import, there is now the ability to import the SEO Code data for each product.

Functionality Affected: Products Text File Data Import
Impact: Normal

TOT-3749 - Allow guest users to an upload attachment file within the Enquiry Form content managed web page area

On a content managed web page area containing an Enquiry Form area, if the area is viewed as a guest user then it is now able to support displaying the File Upload form element if a ReCaptcha element is also included in the Enquiry Form.
This allows a guest user to upload an attachment file. In order to allow this uploading functionality the ReCaptcha form element must also be embedded within the area. This ensures that only humans can upload files and protects the project from getting spanned with questionable files.

Functionality Affected: Enquiry Form content managed web page area
Impact: Normal

TOT-3804 - Display products against news items that aren't assigned to categories

Within a content managed website, in a Product News Listing area, all products assigned to a news item will now display regardless of whether or not that product is assigned to a category.
Previously a product had to be assigned to a category to allow it to display in the Product News Listing area.

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

TOT-3808 - Export Product Stock Levels Data API to return product description fields

Within the TOTECS API, when calling the Export Product Stock Levels endpoint, for each product record returned it now includes the product's description1, description2, description3, and description4 fields for each record returned.
This allows customers and other external systems to obtain more data about the products being sold that are connected through the TOTECS API.

Functionality Affected: Export Product Stock Levels API endpoint
Impact: Normal

TOT-3810 - Display product customer account prices with a quantity break of less than 1 in Category and Product Search Result Listing content managed web page areas

There's now the ability for products with customer account specific volume discounts pricing to display in product search result listings, when the volume has a quantity set at below 1 and the project is configured to allow volume discounts above a quantity.
Both on the Product Search page of the Trade interface and on any content managed web page areas that contain Category Listing and Product Search Results Listing areas, the the product search results now are able to display customer specific pricing for a product when the "Volume Discounts Threshold Direction" project setting is set to Above Quantity or Equal and Above Quantity, and the "Units Per Pack" setting is set to off, and the customer account product price is set for a quantity less than 1.

Functionality Affected: Product Search Results process
Impact: Normal

TOT-3819 - Product search rule to find products assigned to a flag within the Product Search and Product Deals and Vouchers Admin Centre interfaces

Within the Administration Centre, under the Inventory menu, within the Product Search interface, a new advanced search category has been added called "Flags".
This search category contains two new search rules, one rule that allows products that are assigned to a flag to be found based on either the Flag ID or Flag Name and another rule that allows all products that either are, or are not, assigned to a flag to be found.

Functionality Affected: Product Search and Product Deals and Vouchers Administration Centre interface
Impact: Normal

TOT-3823 - Protect TOTECS.retail.loader.loadFunction from being called with an undefined, or invalid parameter.

When a content managed web page area is loaded and contains 3rd party javascript code, additional error handling has been added to ensure that uncaught Javascript errors are raised when calling the TOTECS.retail.loader.loadFunction.
When this occurs the Javascript output in a web browser's console will provide more details information about the reason why the Javascript being loaded has not been correctly configured.

Functionality Affected: Content managed web page areas
Impact: Normal

TOT-3827 - Assign primary customer account location to users and orders

If the Locations feature is turned on, then when a user logs into either the Trade interface or a content managed website then a location will be assigned to the user's session.
If the project's "Customer Accounts Assign Location To Orders" setting is set to Yes then the location assigned to the user will be based on the primary location that their customer account is assigned to.
If that setting is set to No, then the location assigned to them will be based on location with the code matching the value set in the "Default Location Code" setting.
If a user switches between accounts then the primary location assigned to the account assigned to the user if the "Switch Warehouse When Sales Rep Switches Account" setting is set to "Yes".
When a user goes through the Order Checkout/Submission process if a order surcharge rule explicitly sets the location to be assigned to the order then it will be set as so, otherwise the location assigned to the order will be based on the location assigned in the user's session.
If the Locations feature is turned on the within the Administration Centre, Under the Stores menu, within the Orders interface, upon clicking on an order, the location assigned to an order will display with the other details, as labelled "Location Code", "Location Name".
This makes it easier for administrator users to understand the location that was assigned to the order.

Functionality Affected: User Login, Customer Account Switching, Order Submission processes, Order Detail Administration Centre Interface
Impact: Normal

Bug Fixes

TOT-3818 - Product Combinations Connector data import fails to successfully finish if duplicate parent combination product records are being imported

Within the Adminsitration Centre, clicking on the Data menu button, within the Data Imports interface, in the Connector Data Imports tab, when a Product Combinations data import was run and the data contained multiple parent combination products that are the same product, the data import would fail to successfully complete and display an error with the message tem_matrix_data_field`, CONSTRAINT `item_matrix_data_field_ibfk_1` FOREIGN KEY (`matrix_id`) REFERENCES `item_matrix` (`matrix_id`) ON DELETE CASCADE ON UPDATE CASCADE).
Now when a Product Combinations data import is run and the data contains multiple parent combination products that are the same product the data import will now ignore importing a parent combination product record if a previously record with the same product has already been imported. This will ensure that the data import does not try to create multiple parent combination product records in the database, which is not allowed.

Functionality Affected: Combination Products Connector data import
Impact: Normal

TOT-3821 - Child combination stock levels are not being updated when combinations have been selected

On a content managed web page displaying the parent combination product within a Product Detail area, within the Product Details format the $product_stock_level_element_id$ used with $product_stock_level_class$ was not updating theproduct stock quantity values when a combination child product has been selected.
Now within a Product Detail webpage area, if the volume discount table is not present, a JavaScript error will no longer occur causing other features to fail, allow the stock levels to update when a different child combination product is displayed.

Functionality Affected: Product Detail content managed web page area
Impact: Normal

TOT-3822 - Product Combinations Connector data import fails to provide enough details in error message when it cannot import the duplicate combination field values

Within the Adminsitration Centre, clicking on the Data menu button, within the Data Imports interface, in the Connector Data Imports tab, when a Product Combinations data import was run and the data being imported contained multiple combination profile field values that had the same keyComboProfileFieldValueID, the data export fails, but its error message does not provide enough details about why it failed.
The Product Combinations Connector data import has been modified to provide more information in the error message to specify the KeyComboProfileID, KeyComboProfileFIeldID, and keyComboProfileFieldValueID of the duplicate record that needs to be fixed for removed from the the data being imported

Functionality Affected: Combination Products Connector data import
Impact: Normal

TOT-3809 - _P_PriceEx_rrp_titled hook outputting unnecessary nbsp characters

On a content managed web page area that displays a Product Detail area, the hook _P_PriceEx_rrp_titled was outputting unnecessary nbsp characters, causing problems in being able to style the data using CSS.
Within a Product Detail content managed web page area, the hook _P_Price_Ex_rrp_titled has been modffied no longer output unnecessary nbsp characters.

Functionality Affected: Product Detail content managed web page area
Impact: Minor

TOT-3811 - Order confirmation emails for orders submitted by customers with Sales Reps are being sent to the order notification email address twice

When a user whose account was assigned to a salesrep that is set to receive order confirmation emails submits an order the order notification email was sent to the email address set in the 'Order Submission And Registration Email' twice.
The system sales email will no longer receive duplicate order confirmation emails when a user who is assigned to a sales rep, who has the receive order confirmation email notifications turned on, and submits an order.

Functionality Affected: Order Submission process
Impact: Normal

TOT-3814 - $product_records_per_page_drop_down$ displays 50 when 200 has been selected

On a content managed webpage displaying a Categpry Listing or Product Search Reults Listing area, when a user selects 200 from the $product_records_per_page_drop_down$ the value still displays 50, and only 50 records are displayed.
Within a content managed web page displaying a Category Listing or Product Search Results Listing area, a user can now successfully choose to display 200 product records per page.

Functionality Affected: Product Search Results Listing, Category Listing content managed web page areas
Impact: Minor

TOT-3817 - Product Combinations Connector data import fails to complete when a parent product combination product tries to be assigned to a different combination profile

Within the Administration Centre or through the Connector software, when running a Combination Products Connector data import, the data import would fail if an existing parent combination product had previously been set up in the project, then when the data import runs it tried to assign the parent product to a different combination profile.
The Product Combinations Connector data import has been modified to correctly handle when an existing parent combination product is being reassigned to a different combination profile. Previously the platform would not allow this to occur.

Functionality Affected: Combination Products Connector data import
Impact: Normal

New Features

TOT-3536 - Allow users to login from external/centralised websites using OAuth

A new workflow has been developed which allows users to login to a content managed website using another service (Google, external systems, etc).
When the user goes to the login area of the website, they will be given the option to login via another service. If the user chooses to login like this, they will be redirected to the external system.
After successfully logging into the external system, the user will be returned to thecontent managed website where their information will be verified.
If there is a website user with a matching login ID to the ID retrieved from the external system, the user will be automatically logged into the TOTECS website.
This process will use the OAUTH 2.0 workflow to allow for separate authentication of users in a centralised website.
To turn on this feature, within the Administration Centre, in the Websites interface, when viewing the Website Details, the setting "Allow External Login (OAUTH)" needs to be ticked.
Once this has been turned on, at the bottom of the page within the External Login section an admin user will be able to add a new Oauth server and configure the settings.
To learn more about configuring the connection to an Oauth server, documentation can be found here https://tools.ietf.org/html/rfc6749#section-4.1


Functionality Affected: User Login, User Login content managed web page area
Impact: Normal

Improvements

TOT-3373 - Allow an address to be saved when an apostrophe has been set within an address field

A restriction has been removed to allow users to save apostrophies within address fields for orders.
On a content managed web page displaying either a User Details/Favourites/Orders area, or an Order Checkout/Submission area, or within the Trade interface under My details, when a user saves an address which contains an apostrophe within one of the address fields (O'Connor, ACT), they are now able to save the address.

Functionality Affected: Content managed - User Details/Favourites/Orders, Order Review and Trade interface - My Details
Impact: Normal

TOT-3676 - Send Order Confirmation Email to sales rep users assigned to the order's customer account

There is now a setting for sales represenative users to control if they should receive order email notifications if an order has been created for an account that their Sales Representative ID is assigned to. This allows sales reps to be informed when customers or other people are creating orders under the accounts they are managing.
Within the Administration Centre, within the Users menu, in the Search Users interface after searching for a User and going to the User Details interface, a new setting is available for sales representative users.
When the Receive Account Order Notifications setting is turned on, the sales representative user will receive an email order notification whenever an account assigned to that sales representative submits an order.

Functionality Affected: Order Submission Process, User Details Admin Centre interface
Impact: Normal

TOT-3772 - Hooks to display billing and delivery address postcodes within Invoice, Back Order, Sales Order, and Credit Customer Account Enquiry content managed web page areas

On a content managed web page displaying either "Customer Account Invoice", "Customer Account Sales Order", "Customer Account Back Order" and "Customer Account Credit" areas, for each of these area's formats there are now hooks that can display the postcode/zipcode for the billing and delivery addresses set within the records.

Functionality Affected: Customer Account Invoice, Customer Account Sales Order, Customer Account Back Order, Customer Account Credit content managed web page areas
Impact: Normal

TOT-3780 - Content managed web page area event listener for when a product has been added to a Shopping List

On any content managed web page within its Javascript API there is now the ability for 3rd party javascript to listen to an event that occurs after a user has successfully added a product to a shopping list. This allows customised functionality such as pop ups and notifications to appear when this event is fired.
The new area event type is AFTER_PRODUCT_ADD_TO_SHOPPING_LIST.
For more information about using the Javascript API, go to http://docs.totecs.com/TOTECS/Anatomy-Of-A-Content-Managed-Webpage.html and read the section Adding Your Own Area Reload Javascript Listeners.

Functionality Affected: Content managed webpage API
Impact: Normal

TOT-3782 - Product Account Pricing Connector data export to support importing 2 million plus pricing records

When a Product Account Pricing Connector data import is run it now supports processing over 2 million records at a time.
The data import has been modified so that it can import records 10-20 times quicker, allowing pricing imports that previously would take 60 mins to import 4 million records to only take 4-6 minutes.
This allows for far more account based pricing data to be imported in a shorter period of time.

Functionality Affected: Product Account Pricing Connector data import
Impact: Major

TOT-3784 - Allow volume_discount_table hook within Product Details content managed web page area to update when a child combination product is selected

Within the Product Detail content managed webpage area, if the area is displaying a combination product and has the volume_discount_table hook embedded within the area's format, then when a user selects a child product from the combination's fields, the pricing displayed within the volume discount table hook will be updated with quantity break prices set against the child product.

Functionality Affected: Product Detail content managed web page area
Impact: Normal

TOT-3785 - Hooks in content managed web page areas to display taxcode information assigned to products

Within all content managed web page areas that display product pricing data, there is now the ability to display information about the taxcode that is assigned to each product. This information includes the taxcode, taxcode label, and taxcode description.
The new hooks that have been added are:

• taxcode
• taxcode_description
• taxcode_label
• taxcode_pricing_label

Tax pricing labels can be set by going to the Administration Centre, then under the Inventory menu going to the Product Settings interface. The settings "Tax Inclusive Pricing Label" and "Tax Exclusive Pricing Label" determine the message that will appear when the taxcode_pricing_label hook is used. The taxcode, taxcode_description and taxcode_label hooks can be used within the "Tax Inclusive/Exclusive Pricing Label" settings.

Functionality Affected: Product Detail, Category Listing, Product Search Results Listing, Shopping List Products, Contract Products content managed web page area
Impact: Normal

TOT-3786 - User setting to control if users see pricing excluding or inclusive of tax

Within the Administration Centre, under the Users menu, in the Search Users interface, when viewing the details of a user in the User Details interface a new setting called "Price Tax Format" has been added that allows administrator users to change the price tax format set against each user.
This setting has taken over both the "Content Managed Website Price Tax Format" and "Trade Interface Price Tax Format" project settings which could be found under the Inventory menu, within the Product Settings interface.
These settings have been replaced with "Default Retail Price Tax Format" and "Default Wholesale Price Tax Format", which determines whether the Price Tax Format will be set as inclusive or exclusive against a new user.

Functionality Affected: User Login, User Details Admin Centre interface
Impact: Normal

TOT-3792 - Increase the size of Model keyMakerModelID field to 100 characters in size

For Model records stored within a project the Key Make Model ID field now supports storing up to 100 characters. This allows more data to be stored in the Key Make Model ID field which is used to link a Model to a record in an external system.

Functionality Affected: Model Connector Data Import
Impact: Minor

TOT-3799 - Location Finder Improvements

Within the Location Finder content managed webpage area, several improvements have been made.
When a user types an address into the address search input and the Google suggestions dropdown box appears, instead of having to manually click the first result or press an arrow key to select a result, the user can now simply press enter to automatically select and search for the first suggested address.
The Location Finder's javascript library now has the ability to accept a list of locations and plot those locations on the map. This allows developers to build custom filtering functionality into the map which could allow a user to filter locations by "Available Brands", etc.
If you are interested in having custom filtering configured for your Location Finder, please contact the TOTECS service team to arrange a quote.

Functionality Affected: Location Finder content managed web page area
Impact: Normal

TOT-3800 - Update Forums link within Admin Centre to reference new TOTECS website forums

Within the Administration Center, the Forums link has been updated to point to the new TOTECS website forums URL.

Functionality Affected: Home Administration Centre interface
Impact: Minor

TOT-3802 - With Data Imports admin centre interface show number of records created, updated and deleted in history of Connector imports

Within the Administration Centre, under the Data menu, within the Data Imports interface, in the History tab there is now additional columns displayed that show the number of records that were created, updated, or deleted when a data import was run.
This additional information makes it easier for Administrator Users to understand how many records were changed when a Connector data import was run.

Functionality Affected: Data Imports Administration Centre interface
Impact: Normal

TOT-3773 - Order confirmation PDF attachment showing html tags for rep users

In an order confirmation pdf attachment, when an order has been created by a Rep user, text was inserted automatically under the special instructions area to advise the rep user’s name (who created the order). This text was being added with html code starting and finishing the paragraph.
Within an attachment of an Order Confirmation email created by a Sales Representative user, the Sales Rep Message within the Instructions field will no longer display HTML tags.
The HTML will be printed correctly allowing the use of HTML tags within the Purchase Order Sales Representative Message setting.
This setting can be found by going to the Administration Centre, clicking the Stores menu, going to Order settings and then finding the Purchase Order Sales Representative Message field under the Order Labelling section.

Functionality Affected: Order Confirmation Email
Impact: Minor

Bug Fixes

TOT-3774 - User Search Results table within Administration Centre interface not paginating correctly

In the User Search interface within the Administration Centre, if the Results Per Page is set to anything other than 10, and a user search is performed afterwards, the returned results will only display 10 records.
If there is less records than what the Results Per Page WAS set to, a 2nd page will not be displayed in the pagination, which results in records being inaccessible, lost in the void.
Within the Administration Centre, in the User Search interface, if the Results Per Page is set to anything other than 10, and a user search is performed afterwards, the returned results will now display the correct amount of records.

Functionality Affected: User Search Administration Centre interface
Impact: Minor

TOT-3775 - Unable to view user login statistics data after clicking on the View Login Statistics button from the Admin Centre Home interface

Within the Administration Centre's Home page when clicking on the 'View Login Statistics' button user was taken to the User Login Statistics interface, however no user data was loaded into the statistics table and the "Error loading user login logs." error displays.
The View Login Statistics button has been modified to correctly direct the URL to the secure domain that loads the User Login Statistics interface. This ensures that the user statistics data displays again.

Functionality Affected: Home Administration Centre interface
Impact: Minor

TOT-3776 - Delivery Address Fax Number hook is bringing incorrect information on confirmation email order detail format when an Order Confirmation Email is sent

Within an attachment of an Order Confirmation email, the delivery fax field was incorrectly displaying the delivery fax number within the delivery phone field.
The delivery fax field will now display correctly, instead of displaying the delivery phone field.

Functionality Affected: Order Confirmation Email
Impact: Normal

TOT-3778 - Unable to view a webpage's properties if the webpage's meta description contains a new line character within Websites admin centre interface

Within the Admin Centre, in the Websites menu, clicking on the Websites menu item, within the Websites interface when viewing the properties of a webpage, if the webpages meta description contained a new line character the properties would fail to load.
Nowhen viewing the properties of a webpage, if the webpages meta description contains a new line character the properties will load correctly.

Functionality Affected: Websites Administration Centre interface
Impact: Normal

TOT-3779 - Product description saving as [INVALID FORM VAR] if it contains a degrees or ring symbol within the Product Editor admin centre interface

Within the Admin Centre, in the Inventory menu, within the Product Editor interface, when modifying an existing product's description if in any of the description fields it contained a ring symbol '?', then the product description with the degrees symbol will be saved as [INVALID FORM VAR].
Now when modifying an existing product's description if in any of the description fields it contains a ring above symbol '?' or degrees symbol '°', then the product description will be encoded correctly and saved to the database.

Functionality Affected: Product Editor Administration Centre interface
Impact: Normal

TOT-3790 - Unable to add a new region against a website within the Websites Admin Centre interface

Within the Admin Centre, in the Websites menu, clicking on the Websites menu item, within the Websites interface click on a website's domain, in the Websites Details interface users were unable to create a new region against a project if the Regions feature was turned on.
Now within the Website Details interface, the Add button under Website Regions it correctly shows the form for adding a new region.

Functionality Affected: Website Details Administration Centre interface
Impact: Normal

TOT-3795 - Volume discount prices not displaying for price quantities over 1 in Product Detail and Product Search Results Listing content managed web page areas when Volume Discounts Threshold Direction project setting is set to Above

In a content managed website, in both Product Details and Product Search Result Listing area the volume discount pricing would not display if the pricing is set to buy more than 1.The $product_has_volume_discount_prices$ in the product search result listing didn't return Y and in the product details area the $volume_discount_table$ data wouldn't return any html.
Within the Product Detail content managed web page area, and all areas that display the Product Search Record format, both the $product_has_volume_discount_prices$ and $product_volume_discount_prices$ hooks now display correctly volume discount price records when the quantity is set to 1 and the "Volume Discounts Threshold Direction" project setting is set to Above or Above and Equal To. This change also allowed these changes to be reflected within the Trade interface.

Functionality Affected: Product Details content managed web page area, Product Searching function
Impact: Normal

TOT-3796 - Web area format Shopping List Product Record hook shoppinglist_product_add_onclick not working

On a content managed web page containing a Shopping List Products area, for its Shopping List Product Record format hook $shoppinglist_product_add_onclick$ is not working correctly with he javascript being returned contains an additional '?' character and an [INVALID_FORM_VAR] in place of a paramater.
The shoppinglist_product_add_onclick hook now returns the correct javascript code to enable a product to be added to basket.

Functionality Affected: Shopping List Products content managed web page area
Impact: Normal

TOT-3797 - Admin Centre Account Enquiry Quotes table not appearing

Within the Admin Centre, in the Users menu, within the Customer Accounts interface, upon clicking the Account Enquiry button of an account, in the Account Enquiry interface when clicking on the Quotes tab, the quotes table did not appear.
Now when performing a Live Enquiry against an account and when viewing the Quotes tab, the quotes table now appears correctly.

Functionality Affected: Account Enquiry Administration Centre interface
Impact: Normal

TOT-3807 - Emedia Messaging Administration Centre interface unable to load any emedia records when one contains a double quote in its name

Within the Administration Centre, under the Marketing menu, upon clicking on the Emedia Messaging link, within its interface it was incorrectly displaying a "Data Error" message when it tried to load any Emedia records where a record contains a double quote character within its name.
Now within its interface it now correctly loads in Emedia data into the data table when a emedia item contains a double quote character within its name.

Functionality Affected: Emedia Messaging Administration Centre interface
Impact: Normal

New Features

TOT-2848 - Location Finder Content Managed Webpage Area

On a content managed website a new webpage area has been developed called the "Location Finder". This area allows a user to search for a list of nearby locations, based on a user input address.
The area uses the Google Maps API service to perform the search. The area is able to display a list of retrieved locations, as well as a Google Map with the locations plotted on the map as pins.
The list of locations records is able to display information about each location as well as display a button that allows a user to set a location as the users preferred location.
Settings have been added within the Administration Centre to configure the default behaviour of the Location Finder as well as Google API credentials.
A facility role permission has been added to determine if the user must order against a location or not, which also determines if a user can set a location as preferred.
The User Details content managed webpage area has been modified to contain information about a users current preferred location.

Functionality Affected: Location Finder content managed web page area.
Impact: Normal

TOT-3762 - Locations Geocoder Tool

Within the Administration Centre, within the Locations interface, a new tool has been added that allows a user to geocode addresses of locations that are set to appear within the Location Finder content managed webpage area and do not yet have latitude and longitude values set.
This tool can be accessed by clicking the "Geocode Locations" button next to the "Create Locations" button. The tool will look at all locations that do not yet have latitude and longitude data set, and using the address data stored against the location call Google's API to find the co-ordinates of the locations.
This tool can significantly reduce the amount of time that it takes to set up location positioning, especially when 10s or 100s of locations exist within a TOTECS project.

Functionality Affected: Location Finder content managed web page area.
Impact: Normal

Improvements

TOT-3352 - Allow Product Deals and Vouchers discounts to apply on top of global basket product quantity break discounts

If global volume discount pricing is turned on and a user within a content managed website or Trade interface adds a product to basket, all prices of products in the basket will be recalculated based on the volume discounts set for each product factoring the total quantity of products in the basket.
After this re-pricing has been done for any products that have deals already applied, the deals will be re-applied on top of the updated quantity break product prices.
Because of this deal prices be applied on top of volume discount pricing, allowing for double discounting.
This will occur when within the the Adminsitration Centre, under the Inventory menu, within the Product Settings interface, if the "Calculate Volume Discounts For All Products In Basket" setting is set to Yes.

Functionality Affected: Product Add To Basket process
Impact: Major

TOT-3399 - Setting to set web page link for $item_link$ hook within Product News Listing content managed web page area

On a content managed web page that contains a Product News Listing area, the area's options now contains a setting to define the web page that the $item_link$ hook within the Product Search Record format will target.
This setting allows administrator users to control the web page users are linked to when they click on a product listed against a news/blog item.

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

TOT-3453 - Reprice and clean user's basket after login, basket switching and at order checkout

When users login to the Trade interface or on a content managed website, for any existing products in their basket there is now a setting can cause the products to be re-priced, as well as have inactive, hidden products removed from the basket. This ensures that users can only purchase valid products based on up-to-date pricing.
Additionally if users switch baskets, and proceed through the order checkout process their basket will be re-priced and cleaned to ensure if pricing changes while they are logged in then these changes are immediately reflected before they submit an order.
Within the Administration Centre, under the stores menu, in the Basket Settings interface a new setting has been added labelled "Re-price Basket Products On Login, Basket Switching And Order Checkout". If this setting is set to Yes, then when users login, switch baskets, or proceed through order checkout their baskets will be re-priced. If the setting is set to No then this re-pricing will not occur.
Products will always be removed from a user's basket at login, basket switching, and order checkout if a product is marked as inactive, hidden, or the user does not have permission to buy the product.
Additionally product deals will also always be checked are recalculated at these times to ensure accurate pricing and that deals are still valid.

Functionality Affected: User Login, Accounting Switching, Order Checkout, Product Settings administration centre interface
Impact: Major

TOT-3669 - Export traffic statistics as CSV file from Project Traffic Statistics Administration Centre interface

Within the Project Traffic Statistics Administration Centre interface there is now the ability to export the statistics data as a CSV file.
To export data, first choose the date and search settings, then choose the export type from the new dropdown menu, and click the export button. A CSV file containing the relevant data will be downloaded to a user's browser.

Functionality Affected: Project Traffic Statistics Administration Centre interface
Impact: Normal

TOT-3705 - Allow users to choose locations within Order Checkout/Submission

On a content managed website a new workflow has been developed to allow users with the correct permissions to order goods against a location.
When the user submits an order, the preferred location address will be available as a shipping address option for the user. Alternatively, the user can ship the order to their own address without previously selecting a preferred location.
In this case, the system will determine the nearest location to the users shipping address and store the location code against the order.

Functionality Affected: Order Checkout/Submission content managed webpage areas
Impact: Normal

TOT-3722 - Product Deals and Vouchers deal offer frequency to allow deals to be redeemed for an unlimited amount of times across a limited number of orders

There is now the ability to offer product deals to users that allow them to redeem a deal for an unlimited amount of times across a limited number of orders. This allows users to redeem a product deal as many times as they like in their basket, but can only redeem the deal for a certain number of orders, for example "get 10% off all products for the first order you submit." or "buy 2 or more products for $15 each for your first 2 orders".
Within the Administration Centre, under the Marketing menu, within the Product Deals and Vouchers interface, upon clicking either the Create Deal or Set Deal buttons, within the Set Deal Details dialog a new option has been added to the Frequency drop down labelled "Unlimited Times Per User For Number of Orders". With this frequency option is set the admin user can then set in the frequency text box the amount of orders that the deal is allowed to be redeemed within. If the Frequency Unit drop down is set to one of the following options then the deal will apply like so:

• For Each Product: The product deal can be redeemed for each product in the specified number of orders. This allows multiple products assigned to the deal to be independently counted as being redeemed against an order. This allows each product assigned to the deal to all be redeemed across the allowed number of orders, regardless if other products in deal have been redeemed in an order.
• Total Products In Deal: The number of times that the product deal can be redeemed if based on any products assigned to the deal being already redeemed in the order. Meaning only 1 product assigned the deal needs to be redeemed to count as the deal being redeemed once for an order.
• Total Products In Deal Group: The number of times that the product deal can be redeemed if based on any products assigned across all deals in the deal's group being already redeemed in the order. Meaning only 1 product assigned to any of the deals in the group needs to be redeemed to count as the deal being redeemed once for an order.

TOT-3753 - Product Deals and Vouchers deal offer - Buy over X quantity of total basket products, get Y price/percent off product Z

Within the Product Deals and Vouchers feature 2 new product deal offers have been added to allow products to be discounted to a user when the total quantity of products in the user's basket is over a specified quantity.
Within the Administration Centre, under the Marketing menu, within the Product Deals and Vouchers interface the following offer types have been added to the Offers drop down:
Buy Over X Quantity Of Total Basket Products, Get Product For Price Y
When the quantity of products in the user's basket is over the amount set in the "Quantity X" field then any of products in the user's basket that are are assigned to the deal will be discounted by the percentage set within the "Percentage Y" setting.
Buy Over X Quantity Of Total Basket Products, Get Product For Y Percent Off PriceWhen the quantity of products in the user's basket is over the amount set in the "Quantity X" field then any of products in the user's basket that are are assigned to the deal will be set to the price set within the "Price Y" setting, as long as the product's un-discounted price is higher than the price set within the deal.
These offers can be redeemed by users assigned to the deals in both the Trade and content managed websites.

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

TOT-3754 - Product Deals and Vouchers deal offers - get Y percent off/price Y for products when basket's un-discounted total is over price Z

Within the Product Deals and Vouchers feature 2 new product deal offers have been added to allow products to be discounted to a user when their basket's undiscounted total is over a specified limit.
Within the Administration Centre, under the Marketing menu, within the Product Deals and Vouchers interface the following offer types have been added to the Offers drop down:
OVER_TOTAL_UNDISC_BUY_PRODUCT_PRICE_%Y
(Buy Over X Price Of Total Basket Products (Before Discounts), Get Product For Y Percent Off Price)
When the user's basket total price (before discounts) is over the amount set in the "Basket Price X" then any of products in the user's basket that are are assigned to the deal will be discounted by the percentage set within the "Percentage Y" setting.
OVER_TOTAL_UNDISC_BUY_PRODUCT_PRICE_Y
(Buy Over X Price Of Total Basket Products (Before Discounts), Get Product For Price Y)
When the user's basket total price (before discounts) is over the amount set in the "Basket Price X" then any of products in the user's basket that are are assigned to the deal will be set to the price set within the "Price Y" setting, as long as the product's un-discounted price is higher than the price set within the deal.
These offers can be redeemed by users assigned to the deals in both the Trade and content managed websites.

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

TOT-3760 - Administration Centre Locations Interface read/write additional location information

Within the Administration Centre, within the Locations interface, the Location Details dialogue has been modified to contain additional data fields against a given location.
The additional data includes latitude/longitude coordinates, location type settings to determine if the location is internal/external to the company, location searching settings to determine if the location should appear within the Location Finder content managed webpage area, website address and email address.

Functionality Affected: Locations administration centre interface
Impact: Normal

TOT-3771 - Categories Connector Data Import to assign category to category tree based on keyCategoryTreeID record field

Within the Administration Centre, under the Data menu, within the Data Imports interface, in the Connector Data Imports tab, when a Categories Connector data import is run, if a category record being imported has the keyCategoryTreeID set to match the code of a category tree, then the category will be re-assigned to that category tree.
This allows category data coming from Connector to control which tree a category is assigned to.

Functionality Affected: Categories Connector data import
Impact: Normal

Bug Fixes

TOT-3757 - Sales rep user being assigned to the incorrect customer account territory when first logged in to Trade interface or content managed website

When a sales rep user logged into either the Trade interface or a content managed website, if the sales rep user was assigned to a basket that had a different customer account assigned to them, then the Territory/Warehouse Code in their session was still incorrectly being set based on the territory of the user's customer account assigned to them. Because of this if the user performed Order Checkout without switching accounts then the incorrect warehouse code was being assigned to the order.
If the sales rep user was assigned to a basket that had a different customer account assigned to them, then the Territory/Warehouse Code in their session now correctly is set based on the territory of the customer account assigned to their basket.

Functionality Affected: Account Switching process
Impact: Normal

TOT-3764 - Unable to export users to a CSV file for a 2nd time within the User Search Administration Centre interface

Within the Administration Centre, after clicking on the Users menu button then clicking on the Search Users menu item, within the User Search interface after searching for users and clicking on the Export, once the user data had been download to the browser, if the Export button is clicked on again the dialog did not display allowing the user data to be exported again.
If a user clicks the Export button then closes the dialog and then clicks the Export button again, the browser will no longer hang.

Functionality Affected: Users administration centre interface
Impact: Minor

TOT-3767 - Unable to see import types after Categories Text File data import is run within the Data Imports Administration Centre interface

Within the Administration Centre, after clicking on the Data button, then clicking on the Data Imports menu item, within the Data Imports interface, under the Text File Imports tab, upload clicking on the Upload File button for the Categories data import, the import failed to successfully complete and a Data Error message incorrectly displayed, with the data imports no longer shown within the data imports table.
The problem comes from special characters within product codes that have been imported from linked accounting/ERP systems. When performing a data import the special characters cause an error which gets written to the data import logs.
When the data imports admin centre interface loads, the log data cannot be parsed due to the special characters within the error, causing the 'Data Error' to appear.
Now special characters will be removed for data import errors ensure that the table of data imports can display within the interface.

Functionality Affected: Data Imports administration centre interface
Impact: Normal

TOT-3770 - Error when saving Basket Settings when "Column To Order Basket Products" setting set to "Custom"

Within the Administration Centre, under the Stores menu, in the Basket Settings interface, when the "Column To Order Basket Products" setting set to "Custom" and a user clicks the button to save the settings, the following error appeared "Incorrect value for (default order products column)".
The Basket Settings interface has been correctly modified to ensure that all of its settings can be saved.

Functionality Affected: Basket Settings administration centre interface
Impact: Normal

TOT-3775 - Unable to view user login statistics data after clicking on the View Login Statistics button from the Admin Centre Home interface

Within the Administration Centre's Home page when clicking on the 'View Login Statistics' button user was taken to the User Login Statistics interface, however no user data is loaded into the statistics table and the "Error loading user login logs." error displayed.
On the Home interface the View Login Statistics button has been modified to correctly direct the URL to the secure domain that loads the User Login Statistics interface. This ensures that the user statistics data displays again.

Functionality Affected: Home administration centre interface
Impact: Minor

New Features

TOT-3445 - Quotes Listing Account Enquiry content managed web page area

A new content managed webpage area has been created called the "Customer Account Quotes Listing" area. This area is able to load quotes retrieved from a connected accounting/ERP/business system through the Connector software.
This area can retrieve a list of quotes associated to the user's active customer account, and allow quotes to be filtered by a date range, as well as allow the user to search for quotes matching a quote number. The area also has an option to allow users to display only quotes that haven't expired.

Functionality Affected: Customer Account Quotes Listing content managed web page area
Impact: Normal

TOT-3744 - Quotes Detail Account Enquiry content managed web page area

A new content managed webpage area has been created called the "Customer Account Quote Details" area. This area is able to load a quote retrieved from a connected accounting/ERP/business system through the Connector software.
This area displays the details of a quote associated to the user's active customer account.

Functionality Affected: Customer Account Quote Details content managed web page area
Impact: Normal

TOT-3746 - Customer Account Quotes Account Enquiry LIsting within Trade/Admin Centre

Within the Account Enquiry feature for both the Trade interface and the Administration Centre a quotes tab now exists that displays a list of quote records and quote details queried from the connected acounting/ERP/business system through the Connector software.
The user can search for quote records based on date range, as well view the details of each quote record retrieved from the connected business system.

Functionality Affected: Account Enquiry trade interface page, Account Enquiry admin centre interface
Impact: Normal

TOT-3745 - Customer Account Enquiry Quote Record to Sales Order Conversion

Within any content managed websites deployed on the platform there is now the ability for users to convert quotes retrieved from connecting accounting and ERP systems into sales orders.
This feature allows customers, sales reps and staff to load up quotes, then select a quote to convert into a sales order, by completing the order checkout process for that quote.
On a content managed web page that contains either a "Customer Account Quote Listing" and "Customer Account Quote Details" content managed webpage area, a button can be displayed that allows the user to create an order from a given quote.
If the quote has expired, the quote pricing will be overwritten by system pricing, otherwise the user will be able to order the products at the price specified within the quote.
If the products are successfully found and in stock, the user will be taken to the order review page and can proceed through the checkout process, allowing a sales order to be created based on the products set within the quote.
Within the Order Details page the user will be able to choose either the address set within the quote, or else select an address they have previously saved.
Note that when the user proceeds to the Order Review step that the surcharges will be recalculated and this may cause the total of the original quote to alter, due to the way they have selected to pay for the order, or where the order is being delivered to.

Functionality Affected: Order Checkout/Submission content managed web page area, Customer Account Quote Listing content managed web page area, Customer Account Quote Details content managed web page area
Impact: Normal

TOT-3729 - Make/Model Connector Data Imports

3 Connector data exports have been added to the TOTECS platform to all Make/Model data to be imported into a project from external systems, through the Connector software.Within the Administration Centre, under the Data menu, in the Data Imports interface, within the Connector Imports tab, three new import types have been added.

• - Makes import: Imports a list of makes (Manufacturers) that each specify a business that creates models (collections of component products bundled into a single product).
• Models import: Imports a list of models, where each model represents a collection of component products bundled into a single product. Models are typically designated a time or code when they were first released. For each model record a collection of attribute values are also imported, that contains any additional information about a model.
• Model/Product/Category Mappings import: Imports a list of mapping records, that each assign a product to category for a given model. These mappings are used to show the products that are included in a model, and are categorised to make it easy for users to find where in the model the product exists.

Bug Fixes

TOT-3718Opening curly bracket "{" set in a product name causes basket details, and product quick add form to not display correctly within the Trade Interface

Within the trade Interface, if a product name contains an opening curly bracket "{", then within the basket details page's basket products listing table, the record for that product would not load. Addtionally The user would not be uble to add that product to basket using the quick add form.
Now on the basket page for product names containing curly or square brackets will now have the brackets replaced with regular rounded brackets. This ensures that the product name does not interfere with the underlying code that formats each of the product records.

Functionality Affected: Basket Products Trade interface page
Impact: Normal

TOT-3730 - Quick add not returning results if search string has non alphanumerical character

Within the Trade interface, within the basket page, when using the Quick Add function searching on the name field, if the search string contains a non alpha-numerical character, no results will be incorrectly returned.
Now the Quick Add correctly returns matching products when the search text entered contains only non alpha-numerical characters.

Functionality Affected: Basket Products Trade interface page
Impact: Normal

TOT-3736 - Semrush Bot Server requests being shown as Seznam Bot within Project Traffic Statistics admin centre interface

Within the Administration Centre, under the Statistics menu, within the Project Traffic Statistics interface, the crawler statistics for the SemRush bot were incorrectly being included in the Seznam bot statistics.The Project Traffic Statistics interface has been modified so that all crawler project server requests associated within Semrush now correctly show.

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

TOT-3737 - Date information not displaying within transactions listing content managed webpage area

On a Transactions Listing content managed web page area the dates of the transactions records were incorrectly showing as empty values.
Now the date hooks for the transsaction records retrieved from the connected business system correctly display.

Functionality Affected: Transactions Listing content managed web page area
Impact: Minor

TOT-3739 - Product added to back order message is displaying extra html entities at the end of the message text

Across any content managed web page if a user attempted to add a product to basket that was out of stock, then if a back order message displayed within an browser alert dialog, the end of the message would incorrectly display a break HTML tag text.
The Add to Basket message dialog has been modified to ensure that no HTML code displayed within the dialog.

Functionality Affected: Add To Basket process.
Impact: Minor

TOT-3742 - Customer Account Invoice Payment Form content managed webpage area not available to be created when conditions are met.

Within the Administration Centre, under the Websites menu, within the Websites interface, when adding a webpage area to a content managed webpage in the Web Page Editor, within the Account Enquiry area type, the Customer Account Invoice Payment Form area type does not display and cannot be created.
The Add Area To Web Page dialog has now been modified to ensure that the Customer Account Invoice Payment Form area can be selected and added to a content managed web page area.

Functionality Affected: Web Page Editor administration centre interface
Impact: Normal

TOT-3751 - Product dimensions not being rounded within Basket Product Listing content managed web page area

On a content managed web page containing a Basket Product Listing area, if the area's Basket Product Record formatted had the $_B_UnitWidth$, $_B_UnitHeight$, $_B_UnitDepth$ or $_B_UnitWeight$ hooks embedded within it, the values for these hooks were not being rounded and always displaying with 4 decimal place numbers.
The area has been modfiied to now correctly round the numbers displayed in the hooks based on the "Dimension Decimal Places" and "Weight Decimal Places" settings, found within the Administration Centre, under the Inventory menu, within the Product Settings interface.

Functionality Affected: Basket Product Listing content managed web page area
Impact: Minor

TOT-3752 - Forgot Password content managed web page area not allowing users to reset their password

On a content managed web page area displaying a Forgot Password Form area, users may not have been able to use the area to view security questions or reset their password, depending on if other areas loaded on the web page or not.
A bug has been fixed to ensure that the area always loads correctly on a content managed web page, ensuring that users can use the area to reset their password.

Functionality Affected: Forgot Password Form content managed web page area
Impact: Normal

Improvements

TOT-3650 - Allow details of product to be received by 3rd party Javascript function listening to After Product Add To Basket content managed web page area event

When a product is added to basket from any areas on a content managed webpage, there is now the ability for 3rd party javascript code to listen for when a product has been successfully added to basket. When this event gets fired the details of the product are also returned, allowing custom messages such as showing the details of the product that was added to basket to display.
On a content managed web page the Javascript function designated to handle the AFTER_PRODUCT_ADD_TO_BASKET event that can be listened for using the TOTECS.retail.fs.addAreaEventListener function, now receives an additional object within the arguments, containing details of the product that was added to the basket.
The product object is in the second position in the arguments array of the function designated to handle the AFTER_PRODUCT_ADD_TO_BASKET event.
The object properties received are:

• item_code
• item_id
• name
• description
• description2
• description3
• description4
• description_short
• thumbnail_image
• small_image
• medium_image
• large_image
• price_ex
• price_inc
• price_tax
• total_ex
• total_inc
• total_tax
• locale_price_ex
• locale_price_inc
• locale_price_tax
• locale_total_ex
• locale_total_inc
• locale_total_tax
• locale_currency_symbol
• flags (contains an array of flags that the product is assigned to)

TOT-3680 - Display product attribute search profile attribute values with counts of products and filtering

On a content managed web page displaying a Product Search Form (Using Search Profiles) area, if the area is displaying a Product Attribute Search Form, then for each of the attribute values displayed in the area, there is now the ability to display the count of the products that contain the attribute value.
Settings have been added wtihin the Search Profiles administration centre interface to give the ability to control if, and how the attributes are filtered, and whether or not the attributes are dynamically reloaded.
To do this the attribute assigned to the search profile has settings to specify the filtering behaviour, to enable dynamic searching and set if the count should be shown or not.

Functionality Affected: Product Attribute Searching, Attribute Profiles administration centre interface, Product Search Form (with search profiles) content managed web page area
Impact: Normal

TOT-3684 - Default quantity set within Redeemable Deals Products Listing content managed web page area for deal offer "Buy Product Quantity X, Get Quantity Y for Z Percent Off Price" to be sum of X and Y quantities

On a content managed web page displaying a Redeemable Deals Product Listing content managed web page area, if the area displays a product assigned to a deal that contains the deal offer "Buy Product Quantity X, Get Quantity Y for Z Percent Off Price" or the deal offer "Buy Product Quantity X, Get Quantity Y For Price Z", then in the quantity box of the product now displays the default quantity as being the sum of the X quantity plus the Y quantity of the deal offer.
This ensures that when the user adds the product to basket that the quantity threshold is met and the deal to be redeemed when the product is added to basket.

Functionality Affected: Redeemable Deals Product Listing content managed web page area
Impact: Normal

TOT-3706 - Categories Connector data import to assign categories to the same category tree as their parent category

For a Categories Connector data import there is now a setting that controls if an existing category record should be re-assigned to the same category tree as its parent category.
Within the Administration Centre, under the Data menu, within the Data Imports, in the Connector Imports tab, within the Categories row clicking on the Modify Settings link, in the Categories Import Settings a new setting has been added labelled "Update tree that categories are assigned to match parent category".
If this setting is checked then when the Categories Connector data import is run, for an existing category record that is being updated, if it is assigned to a parent category record then the category tree that the parent is assigned to will also be set for the child category record.
Additionally if a new category record is imported, it will now be assigned to the same category tree as its parent category.
If no parent category record exists at the time a new category record was being created then a category will be assigned to the category tree marked as a mirrored tree. Because of this it may take multiple Categories data imports to be run to ensure that all parent category records exist before subsequent child category records are assigned to the same category tree as the parents.

Functionality Affected: Categories connector data import
Impact: Normal

TOT-3708 - Settings to sort products and category listings and searches that have pricing associated to contracts

Settings have been added within the Administration Centre to allow product searches and category listings to sort products based on if a product is flagged as being on contract or not.
Within the Trade interface's product search page, as well as within content managed web page areas that use the Product Search Record format to display products, these listings allow the user to products on contract listed first (ascending) or last (descending).
This can help make it easy for users to see when products are specifically priced for them, which can give a user more incentive to purchase a product.
Within the Administration Centre, under the Inventory menu, in the Categories settings interface, for the "Category Product Sort Field" setting, an option has been added labelled "On Contract". When set then Category Listings can sort products based on products marked on contract.
Within the Administration Centre, under the Stores menu, in the Product Search settings interface, for the "Product Sort Field" setting, an option has been added labelled "On Contract". When set then product searches can sort products based on products marked on contract (if search profiles have the sorting option set to default).
Within the Administration Centre, under the Inventory menu, in the Search Profiles interface, when editing a search profile, for its "Sort Search By" setting, an option has been added labelled "On Contract". When set then product searches using the search profile can sort products based on products marked on contract.
On a content managed web page that displays either a Category Listing area, or a Product Search Results Listing area, in the sort drop downs there is now an option labelled "On Contract" that allows users to ort products based on products marked on contract.

Functionality Affected: Product Searching Process, Stores Settings administration centre interface
Impact: Normal

TOT-3710 - Product field to set how products are ordered by

A new field has been added to Products called "ordering" that allows a numeric value to be set that can be used to sort products by, within category and product search resutl listings, within both the Trade interface and on content managed websites.
Within the Administration Centre, under the Inventory menu, in the Product Editor interface, a new "Ordering" field has been added.
Under the Inventory menu, in the Search Profiles page, when editing a Product, Product Attribute or Product Combination search profile, the Ordering option has been added to the Sort Search by settings.
Under the Inventory menu, in the Categories settings page, the Ordering option has been added to the Category Product Sort Field settings.
Under the Stores menu, in the Product Search settings page, the Ordering option has been added to the Product Sort Field settings.
Under the Websites menu, on the Websites page, expanding the Web Pages section of a website, within the All Areas page of a webpage, when viewing the area options of a Product Search Results Listing area, the Ordering option has been added to the Sort product by setting.
Under the Websites menu, within the Web Area Formats Libraries, within any format that contains a Product Search Record a hook labelled "_P_Ordering" is now available that contains the ordering value set against the product.

Functionality Affected: Product Editor Administration Centre interface, Product Searching Process
Impact: Normal

TOT-3723 - Categories Connector data import to set ordering field for each product assigned to a category

For a Categories Connector data import there is now a setting that controls if the "ordering" field for each product assigned to a category should be set when the data import runs.
Within the Administration Centre, under the Data menu, within the Data Imports, in the Connector Imports tab, within the Categories row clicking on the Modify Settings link, in the Categories Import Settings a new setting has been added labelled "Update ordering field for each product assigned to a category".
If this setting is checked then when the Categories Connector data import is run, then for each product being assigned to a category the "ordering" field will be set to a number based on the order in which products are assigned to a category from the data being imported.
This allows the Connector software to control the ordering of products assigned to category based on the order in which category product records are exported from the Connector.
If the "Update ordering field for each product assigned to a category".setting is not checked then when the Categories Connector data import runs if the product was previously assigned to category from the Category Connector data import then the ordering field will default back to 0, if the product was not previously assigned to a category from the data import then the ordering field's value will remain unchanged for the products.

Functionality Affected: Categories connector data import, Data Imports administration centre interface
Impact: Normal

TOT-3727 - Setting to control the direction that categories are sorted by within Category Listing content managed web page areas

On a content managed web page containing a Category Listing area the area now has a setting that controls the direction that categories are sorted by.
Within the Administration Centre, under the Websites menu, within the websites interface, when modifying a content managed web page that contains a Category Listing area, within the area's settings window a setting has been added labelled "Order Category Records".
When this setting is set to Ascending category records will be ordered top to bottom. When set to Descending categories will be ordered from bottom to top.

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

Bug Fixes

TOT-3716 - Freight surcharge total incorrectly being calculated when "Set freight charge to average product deals percentage off freight" order surcharge rule is set and freight price (ex tax) contains decimals

Within the Administration Centre, under the Stores menu, within the Order Surcharges interface, if the ACTION rule "Set freight charge to average product deals percentage off freight" is set, then if a user uses the freight calculator or proceeds through the Order Checkout process on either the Trade interface or on a content managed website, the freight total was incorrectly being calculated when the freight total excluding tax was a decimal number.
Now in the Order Surcharges interface, if the ACTION rule "Set freight charge to average product deals percentage off freight" is set, then if a user uses the freight calculator or proceeds through the Order Checkout process on either the Trade interface or on a content managed website, the freight total is now correctly being calculated when the freight total excluding tax is a decimal number.
This issue was being caused due to rounding error that would occur when calculating the freight order surcharge price including tax. This rounding error would only occur when freight deal price rule existed and the freight surcharge excluding tax value was a decimal number.

Functionality Affected: Order Surcharge Calculation
Impact: Normal

TOT-3725 - Order Email notifications sent to Outlook and Hotmail email clients incorrectly displaying no message when the email contains an attachment file

When a user hasdsuccessfully submitted an order through the Trade interface or from a content managed website, or an admin user has resent an order confirmation email from within the Orders administration centre interface, when the order confirmation email was received by a Microsoft based email client, such as Outlook 2016, outlook.com, or hotmail.com the email's body was displaying an empty messsage, and the contents of the message iwas incorrectly being attached as a file labelled ATT00001.htm
Now when the order confirmation email is received by Microsoft based email clients, such as Outlook 2016 app, outlook.com, or hotmail.com the email's message now correctly appears within the email's body.
This issue only occurred for emails sent out by the TOTECS platform that contained an attachment file sent with the email content to Microsoft email clients. The issue is caused by the unique way that Microsoft's email clients now interpret the the different parts of an email, and its strict need for the message to be set first within the email data.
The email sending process has been modified for all emails being out with attachments from the TOTECS platform to support Microsoft's way of interpreting emails, ensuring that all major email clients can correctly display the content of emails.

Functionality Affected: Order Submission Emails
Impact: Normal

New Features

TOT-3572 - Forgot Password content managed web page area

On a content managed web page a new area called "Forgot Password" has been created within the User Login/Logout area section. The Forgot Password area allows a user to search for their security question based on either Login ID or email. Once the users account has successfully been found, if they have set a security question, they will be shown the security question as well as an input for entering the security question answer. Upon successfully answering the security question, the user will receive an email containing a new temporary password, and a link to a login page which can be set in the Forgot Password area options. The area takes over the forgot password functionality embedded within the User Login area.
Formats for the new Forgot Password area can be found within the Web Area Formats Libraries, in the User Login/Logout section, in the Forgot Password section.
Two formats are available, the new Forgot Password Form format and the existing Forgot Password Email format.
Within the Forgot Password Form format, the following hooks are available:

• user_input_select - Select input which allows user to switch from Login ID to email searching.
• user_login_id_input - Text input where user enters login id.
• user_email_input - Text input where user enters email.
• forgot_password_question - HTML span element which contains users security question.
• user_answer_input - Text input where user enters question answer.
• forgot_password_status - HTML span element which shows status messages.
• forgot_password_button_id - ID to set for the form submit button/anchor.
• forgot_password_button_onclick - onclick to set for the form submit button/anchor.

Improvements

TOT-3249 - Hooks to display freight details associated to an invoice in the Customer Account Invoice content managed web page area

On a content managed web page that displays a Customer Account Invoice area, hooks have been added that can display the freight information associated to the invoice. These freight details include consignment number, freight carrier name, tracking code, freight carrier code, and account code.
The following hooks have been added:

• invoice_freight_carrier_name
• invoice_freight_carrier_code
• invoice_freight_system_code
• invoice_freight_carrier_consign_code
• invoice_freight_carrier_tracking_code
• invoice_freight_carrier_service_code
• invoice_freight_carrier_account_code

TOT-3474 - Display web page area IDs and container IDs within the Web Page Editor admin centre interface

Within the Administration Centre, under the Websites menu, within the Websites interface, after right clicking on a web page and clicking on the View All Areas menu item, in the All Areas interface there is now the ability to see the IDs of the web page areas and container IDs.
For each web page area its ID now displays to the left of the area name. For containers the ID can be found by hovering the mouse over the container's hook name.
Additionally the containers have been sorted so that the local containers always appear above the global containers. This makes it easier for administrator users to find local web page areas.

Functionality Affected: Web Page Editor administration centre interface
Impact: Minor

TOT-3546 - Add product detail URL hook into Redeemable Deal Products Listing content managed webpage area's Product Deal Record format

On a content managed web page that displays a Redeemable Deal Products Listing area, for products displayed in the area using the Redeemable Deal Product Record format a hook is now available that links to a web page that displays the details of the product.
Within the area's settings there is a setting that allows an administrator user to configure the web page that the product detail URL links to.

Functionality Affected: Redeemable Deal Products Listing content managed web page area
Impact: Normal

TOT-3608 - Display Company Name field with User Details Administration Centre interface

Within the Administration Centre, under the Users menu, within the Search Users interface, after performing a user search and finding users, clicking on the user's login ID brings up the User Details interface.
Within that a text field has been added that displays the company name field associated to the user. This allows company names associated to users to be set, then displayed within content managed websites.

Functionality Affected: Uset Details administration centre interface
Impact: Normal

TOT-3675 - New news/blog groups created through website deployer within Websites admin centre interface to be assigned only to new website

Within the Administration Centre, under the Websites menu, within the Websites interface, after an admin user clicks on the New Website button, upon selecting a Master Website Design from the Design drop down and clicking the Create button, a new content managed website is being created as well as new news/blog groups for that website.
For these new news/blog groups the "displayed as" setting is now set to "Content Managed Website" by default to ensure that the new news/blog groups only appear on the new content managed website.

Functionality Affected: Websites administration centre interface
Impact: Normal

TOT-3678 - Hooks to display tax pricing for each product ordered in the Order Confirmation Email notification

When an order is submitted from either the Trade interface or a content managed website, in the Order Confirmation Email that is sent out there is now the ability to show the unit and overall tax pricing that has been applied to each product line in the order.
Within the Administration Centre, under the Stores menu, within the Order settings menu option, under the Order Notification Emails heading the format labeled "Order Confirmation Email Order Detail Product Format" the following new hooks have been added:

• order_product_price_unit_tax - Monetary amount of tax applied to each unit of product ordered.
• order_product_price_total_tax - Monetary amount of tax applied to the overall quantities of product units ordered.

TOT-3680 - Display product attribute search profile attribute values with counts of products and filtering

Within the Administration Centre, under the Inventory menu, within the Search Profiles page, when editing a search profile with the search type, Product Attribute, new settings have been added to the Assign Search Attribute dialog which can be seen when adding or updating a Product Attribute assigned to the Search Profile.
The area now supports multiple styles of filtering, dynamic searching and showing Attribute Value counts.Filtering options:

• All attribute values - This option will show all attribute values assigned to the selected Product Attribute
• Values assigned to active visible products - This option will show attribute values assigned to the selected Product Attribute, where products are active and visible
• Values relevant to search results or category listing - This option will show attribute values assigned to the selected Product Attribute, where products exists within either the current search results, or the current category listing page. This option will cause the list of attribute values to refine if a dynamic search is performed. For attribute values displayed as dropdowns, checkboxes or radio buttons, a "Show All" option will be added

• No count - no count will be displayed against attribute values
• Inline - a simple count will be displayed in brackets next the each attribute value
• Span - a count will be displayed within span tags next to each attribute value, allowing for custom styling. Not available for all attribute display types.

TOT-3682 - Initially filter product attribute values displayed in search form elements based on products that are initially searched for

On a content managed web page that contains a Product Search Form (Using Search Profiles) content managed web page area and displays a Product Attribute Search Form within the area, when the area is initially displayed and an attribute product search is called (either because a category ID exists within the web page's URL, or an attribute search is called upon) then the attribute values displayed within the area will only display if they are assigned to the products that were found in the search.
For each product attribute, there is the ability to independently control if its initial values are filtered or not, through a configurable setting when assigning the attribute to the product attribute search profile.
This setting can be found within the Administration Centre, under the Inventory menu, in the Search Profiles page, when editing a search profile with the Search Type set to Product Attribute, under the Search Profile Attributes heading a list of Product Attributes assigned to the search profile can be viewed.
Upon adding or modifying an attribute within this list, the "Show filtered results on initial search" checkbox can be accessed.

Functionality Affected: Search Profiles administration centre interface, Product Search Form (using Search Profiles) content managed web page area
Impact: major

TOT-3685 - User Search Rules to find users who are assigned to a customer account that is assigned to a sales rep ID

Within the Administration Centre, under the Users menu, within the Search Users interface, as well as within Marketing menu under the Marketing User Groups interface, after selecting Order History option from the Search Category drop down, the following search rule has been added:

• Select all %value1% users assigned to an account with Sales Rep ID %equaling% %value2% and account is %value3%

TOT-3687 - User search rules to match users based on not equal to, not starting with, not ending with, and not containing operators

Within the Administration Centre, under the Users menu, within the Search Users interface, as well as within Marketing menu, under the Marketing User Groups interface, for the existing user search rules there are now operators set that allow users to be matched on that are not equal to, not start with, not ending with, or not containing based on the rule's search terms.
These new options can be used for finding users within the User Search administration interface, as well as assigning users to deals, or assigning users to receive Emedia Emails.

Functionality Affected: User Search, Marketing User Groups administration centre interface
Impact: minor

TOT-3688 - User Search Rules to find users who have ordered or not products based on a category over a date period

Within the Administration Centre, under the Users menu, within the Search Users interface, as well as within Marketing menu under the Marketing User Groups interface, after selecting Order History option from the Search Category drop down, the following Search Rules have been added to the Search Rules drop down:

• Select users who have ordered products assigned to category with the ID %equaling% %value1% in the last %value2% %value3%s
  • selects users who have ordered products in the last number of days|weeks|months, where the products are assigned to category matching a specified ID
• Select users who have not ordered products assigned to category with the ID %equaling% %value1% in the last %value2% %value3%s
  • selects users who have ordered products within a given start and end dates, where the products are assigned to category matching a specified ID
• Select users who have ordered products assigned to category with the ID %equaling% %value1% in the date range from %value2% to %value3%.
  • selects users who have not ordered products in the last number of days|weeks|months, where the products are assigned to category matching a specified IDto category matching a specified ID
• Select users who have not ordered products assigned to category with the ID %equaling% %value1% in the date range from %value2% to %value3%.
  • selects users who have not ordered products within a given start and end dates, where the products are assigned to category matching a specified ID

TOT-3689 - Product search rules to match product based on not equal to, not starting with, not ending with, and not containing operators

Within the Administration Centre, under the Inventory menu, within the Product Search interface, as well as within Marketing menu, under the Product Deals and Vouchers interface, for the existing product search rules there are now operators set that allow products to be matched on that are not equal to, not start with, not ending with, or not containing based on the rule's search terms.
This has been placed into the search rule under the "Category" search category, for the rule labelled: "Select products %value1% to a category with the category %value2% %equaling% %value3%".

Functionality Affected: Product Search, Product Deals and Vouchers administration centre interface
Impact: minor

Bug Fixes

TOT-3677 - Deal total saved price hooks within Basket Products Listing content managed webpage area incorrectly rounding pricing based on "Quantity Decimal Places" setting

Within a content managed web page containing a Basket Products Listing area, for each product displayed in the Basket Product Deal Format the $deal_total_saved_price_label$ hook was displaying pricing data that was being rounded to a number of decimal places the is determined by the 'Quantity Decimal Places' setting found in the Products Settings within the Inventory Settings in the Admin Centre.
Within the Basket Products Listing area, for each of the products displayed that contained a deal applied to it, for the deal saved pricing hooks the pricing is now correctly rounded to the number of decimal places using the "Price Decimal Places" project setting, found within the Administration Centre under the Inventory menu's Products settings interface.

Functionality Affected: Basket Products Listing content managed web page area
Impact: Minor

New Features

TOT-3652 - Assign users to multiple customer accounts within the Search Users Administration Centre interface

For each user in a TOTECS project there is now the ability to assign multiple customer accounts to a user. This can then be used to allow users to switch between accounts within a content managed website (similar to repspace).
Within the Administration Centre, under the Users menu, within the Search Users interface, for each user record displayed in the Users table, in the Manage User column, there is a button labelled "Accounts".
When clicked on this button allows the user to see a dialog labelled "Customer Accounts Assigned To User" that shows a table of customer accounts assigned to users.
Within this dialog an administrator user can add a customer account to a user by typing the account ID of the customer account into the Account Code search box.
To add or remove customer accounts against a user, the administrator user must have the "Modify Users" permission set to allow.

Functionality Affected: User Search administration centre interface, customer account switching process, basket switching process.
Impact: Normal

Improvements

TOT-2804 - Warning dialog if admin users change deal offer on active deals within Product Deals admin interface

Within the Administration Centre, under the Marketing menu, within the Product Deals and Vouchers admin interface, in the Set Deals Detail dialog, if the admin user changes the deal offer when the deal is currently active, and within the start and finish dates, a dialog appears showing a warning that users who have already redeemed the deal based on the previous offer will still have the previous offer applied to their basket.

Functionality Affected: Product Deals and Vouchers admin centre interface
Impact: Normal

TOT-3586 - Product Combination content managed web page area to show child product details with the Product Search Record format when area showing child products as Radio Button List

On a content managed web page containing a Product Combination web page area, when its "Show Combination Options As" setting is set to Radio Button List, for each child product displayed with the Combination Product Option List Record format, the "combination_product_search_record" hook has been added that allows details of the product to display with the selected Product Search Record format.
This allows additional details of the product to be shown, such as volume discount pricing based on the extra data that a Product Search Record format can display.

Functionality Affected: Product Combination content managed web page area
Impact: Normal

TOT-3636 - Hooks on Product Detail, Basket Product Listing and Product Quick Add Form content managed web page areas to show the location stock availability of product based on assigned location

On a content managed web page containing Product Detail, Basket Product Listing, Category Listing, Product Search Results Listing and Product Quick Add Form content managed web page areas, for each product displayed in these areas hooks have been created to show the location based stock quantity and level based on the primary location assigned the user's customer account.
The following hooks have been added to the Product Detail area format:

• product_stock_location_quantity
• product_stock_location_quantity_holder
• product_stock_location_level
• product_stock_location_level_holder

• product_stock_location_quantity
• product_stock_location_level

• _P_StockWarehouse
• _P_StockWarehouseLevel

• quick_add_product_stock_location_quantity_div_id
• quick_add_product_stock_location_quantity_div_class
• quick_add_product_stock_location_quantity_element_id
• quick_add_product_stock_location_level_div_id
• quick_add_product_stock_location_level_div_class
• quick_add_product_stock_location_level_status_element_id
• quick_add_product_stock_location_level_status_class

TOT-3638 - Purchaser managers to be restricted to approve orders when order total is within allowed price range

Within the Administration Centre, under the Users menu, within the Purchaser Manager Approvals interface, after assigning a user to another managing user and clicking on the Conditions button, in the Purchasing Conditions dialog a new section called Manager Conditions has been added.
This section contains the following settings:

• Can Only Approve Orders Within Order Total Range: If set to yes then the manager user is only allowed to view and approve pending orders that have an order total (inclusive of taxes) with a set date range. If set to no then the managing user can approve any pending orders submitted by the assigned user.
• Lower Order Total Amount (Inc Tax): Set the lowest order total that the managing user is allowed to approve orders with, if the Can Only Approve Orders Within Order Total Range setting has been set to yes.
• Upper Order Total Amount (Inc Tax): Set the highest order total that the managing user is allowed to approve orders with, if the Can Only Approve Orders Within Order Total Range setting has been set to yes.

TOT-3642 - Hooks to display a product's height, width, depth dimensions and weight within Basket Product Listing content managed web page area

On a content managed web page displaying a Basket Product Listing content managed web page area for each product displayed in the Basket Product Record format, the format now contains hooks that display the weight, height, width, and depth dimensions for each product's units, as well as hooks to display the overall dimensions based on the quantity of product ordered.
This allows additional product dimension data to be shown for each ordered product in the area.
The following hooks have been added to the Basket Product Record format within the Basket Products Listing area:

• _B_UnitWeight
• _B_UnitWidth
• _B_UnitHeight
• _B_UnitDepth
• _B_UnitCubicVolume
• _B_TotalCubicVolume

TOT-3653 - Allow value submitted for Emarketing Sign Up element within Enquiry Form content managed web page area to be shown within submission results and email notification

On a content managed webpage displaying an Enquiry Form area, if an Emarketing Sign Up form element is displayed in the area, when the user submits the form the area will now record if the user had checked the Emarketing Sign Up form element or not. If checked the value of "yes" will show and display in both the Email notification, as well as within the Website Enquiry Submission admin centre interface. If not checked then the value of no will display.
Note that this change will only apply to new enquiry form submissions from the date that this improvement has been released.

Functionality Affected: Enquiry Form content managed web page area
Impact: Normal

TOT-3662 - Category connector data import to support importing categories when keyCategoryID field is up to 255 characters in length

For each category stored against a TOTECS project the KeyCategoryID column now has been increased to support storing text up to 255 characters in length. This will allow categories with long unique identifiers to be imported into the platform as well as being assigned to parent categories.

Functionality Affected: Categories, Categories Connector data imports
Impact: Minor

TOT-3666 - Sales Rep Customer Account Selection content managed web page area renamed to Customer Account Selection and allow users to select from assigned accounts

On a content managed web page containing a Customer Account Selection area, the area can list customer accounts that have been explicitly assigned to the user, as well as accounts available to them if they were a sales rep.
The area has been renamed from "Sales Rep Customer Account Selection" to "Customer Account Selection" as it can be used for both salesrep and non-sales rep users.
A new Facility Role permission has been created called "View Customer Accounts" under the label "Briefcase My Details Permissions".
If this permission is set to allow, a non-sales rep user is allowed to switch between accounts assigned to them, if the permission is set to deny the area will not display unless they have sales rep permissions to allow them to see it.

Functionality Affected: Customer Account Selection content managed webpage area
Impact: Normal

TOT-3668 - Product flag placeholder hooks to show flags assigned to child combination products within Product Detail content managed web page areas

On a content managed webpage displaying a Product Detail area, if the area is displaying a parent combination product and the user selects a child product using the product combination options, the flags displayed for the product can now change based on the flags assigned to the child product.
The following hook has been added to the Product Detail format:

• _P_ProductFlag_holder_ID

TOT-3672 - Sales Rep Basket Selection content managed web page area renamed to Customer Account Selection and allow users to select baskets from assigned accounts

On a content managed web page containing a Basket Selection area, the area can list baskets created by the user which are associated to customer accounts that have been explicitly assigned to the user, based on if the user has the Facility Role permission "View Customer Accounts" set to allow, or are a sales rep user with access to all accounts or accounts assigned to their sales rep ID.
The area has been renamed from "Sales Rep Basket Selection" to "Basket Selection" as it can be used for both salesrep and non-sales rep users.

Functionality Affected: Basket Selection content managed web page area
Impact: Normal

TOT-3673 - Add to cart notification showing when no quantity set and product added to cart

Within the trade interface, when adding a product via the Add Item dialog, if the quantity text field was blank and a user clicked the add button, a notification appears which read "Product Successfully Added" despite no product actually being added to the basket.
Now within the trade interface, when adding a product via the Add Item dialog, if no existing quantity is found the quantity field is set to 1, preventing a false "Product Successfully Added" notification.

Functionality Affected: Add Item Trade interface dialog
Impact: Normal

TOT-3681 - Update payment method within the Order Checkout/Submission area when switching accounts in a content managed website

On a content managed web page containing a Customer Account Selection area or a Sales Rep Basket Selection area, when a user switches accounts the payment method within the Order Checkout/Submission area is now updated to the payment method assigned to the account the user is switching to.
This ensures that when the user proceeds through the order checkout process, in the order details form area they will only be able to choose from payment types that are enabled for the customer account that they are currently using.

Functionality Affected: Customer Account Selection, Basket Selection content managed web page areas
Impact: Normal

Bug Fixes

TOT-3436 - Uploaded Webpage Template stays in file form element when editing a different template within the Websites Admin Centre interface

Within the Administration Centre, under the Websites menu, within the Websites interface, when an admin user uploaded a HTML file for a web page template within the Webpage Template Properties dialog, if the dialog was re-opened to modify a different web page template.
The upload form element now is cleared ensuring that the user does not accidentally upload the incorrect web page file.

Functionality Affected: Websites admin centre interface
Impact: Minor

TOT-3590 - Deleting a parent web page in the Websites Admin Centre interface causes child webpages to no longer be found

Within the Administration Centre, under the Websites menu, within the Websites interface, if a content managed webpage was removed from the websites tree and it had child web pages assigned to it, the child web pages became inaccessible and could not be found any more.
Now if a content managed webpage is removed from the websites tree and it had child web pages assigned to it, the child web pages now get reassigned to the parent web page of the web page being removed. This ensures that these child web pages are still can be found by administrator users.

Functionality Affected: Websites admin centre interface
Impact: Normal

TOT-3612 - On the trade Interface Product search button is not visible

On the Trade interface the product search input field in the left hand navigation overflowed the sidebar menu causing the search button to be hidden.
The left hand navigation section has been fixed to correctly fit the available space. The Search for product button is now visible.

Functionality Affected: Trade interface left hand navigation
Impact: Minor

TOT-3647 - PrettyPhoto not displaying images after selecting combination product.

Within a content managed web page containing a Product Detail area, if the area was showing a parent combination product then after selecting a combination product from the combination field drop downs, the image viewer for the product would not update to show images for the selected child combination product.
The Product Detail content managed web page area has been modified so that its image viewer correctly shows the product images of the selected child combination product again.

Functionality Affected: Product Detail content managed web page area
Impact: Normal

TOT-3649 - addProductQuantityField hook in a Product Detail content managed web page area format incorrectly outputting span tags within javascript function

On a content managed web page displaying a Product Detail area in the product details format when a rep user viewed a combination product in the web page area that has no pricing set the addProductQuantityField hook outputted span tags within the add qty onclick which caused the page layout to break.
When a rep user views a combination product in the web page area and neither the parent combination product or default child product have no pricing set the addProductQuantityField hook gets correctly set to have a $0 value in the hook's javascript function, instead of incorrectly displaying span tags.

Functionality Affected: Product Detail content managed web page area
Impact: Normal

TOT-3658 - Sales rep adding product to basket with unit price discount incorrectly rounds discount price to 2 decimal places

Within the Trade or a content managed website, when a user logged in as a salesrep user and had permission to discount a product's unit price when adding a product to basket, if the user had set price discount with up to 4 decimal places, the unit price was being rounded to 2 decimal places.
Now if the user had set price discount with up to 4 decimal places, the unit discount price now is no longer rounded to 2 decimal places, and is now rounded to 4 decimal places.
Note that if the "Quantity Decimal Places" setting for a TOTECS project is set to less than 4 decimal places then the discount prices displayed in both the Trade interface and content managed websites may be displayed as a rounded price even though the price stored against the product in the basket will still be in more decimals.
It is for this reason that it is recommended that the "Quantity Decimal Places" setting should be set to 3 or 4 decimal places so that users can see the more accurate pricing.

Functionality Affected: Basket Products Listing content managed web page area, Basket Products Trade interface page
Impact: Normal

TOT-3659 - Git repositories deployed with Master Website Design content managed websites cannot have file changes pushed up due to a permission issue

After deploying a new MWD websites, administrator users could not successfully push changes to the TOTECS Git Repo. Even though the Git Push reports success, the actual files on the TOTECS web server were not added or modified.
Within the Administration Centre, under the Websites menu, within the Websites interface, after clicking on the Create Website tree node and filling out the details of a new website. When the new website is created the files and folders created for that website's GIT repositories, they are now allowed to be modified when pushing up files changes to the GIT repository.

Functionality Affected: Websites adminsitration centre interface
Impact: Normal

TOT-3665 - Flags Connector data import failing to assign flags to products when a flag's KeyFlagID field contains lowercase characters

When a Flags Connector data import in run, if a flag record is being imported contains a lowercase character then the data import is unable to assign the flag to any products being imported.
The Flags Connector data import has been modified to correctly handle when a flag contains a lower case character within its keyFlagID field, and correctly match a flag being imported into the platform, allowing products to be assigned to flags.

Functionality Affected: Flags connector data import
Impact: Normal

TOT-3679 - Customer Account Transaction Listing content managed web page area incorrectly showing [INVALID FORM VAR] for date hook in Customer Account Transaction Record format

On a content managed web page displaying a Customer Account Transaction Listing area, the area was incorrectly showing '[INVALID FORM VAR]' text within the transaction_date hook displayed with the "Customer Account Transaction Record" format for the first 2 transaction records displayed.
The area now no longer shows '[INVALID FORM VAR]' text within the transaction_date hook displayed within the "Customer Account Transaction Record" format if the transaction_date data does not exist for a record.

Functionality Affected: Customer Account Transaction Listing content managed web page area
Impact: Normal

New Features

TOT-3641 - Master Content Managed Website Design 2 Deployer

There is now the ability to deploy a content managed website that is has been implemented based on a 2nd Master Website Design (MWD). The design is similar to MWD1 however contains differences in the top header bar, uses a later version of the Foundation library, and has differences in popups when products are added to basket to use a notification style popup.
Within the Administration Centre, under the Websites menu, in the Websites interface, when creating a new content managed website, in the New Website dialog there is now the ability for admin users to choose from the Master Website Design version 2 to deploy a website from. Additionally there is now a link that users can click on to view how each of the website designs look by viewing images in a popup dialog.

Functionality Affected: Websites admin centre interface
Impact: Normal

Improvements

TOT-3624 - Modify secure_logo hook to display Secured By TOTECS image within the Order Checkout/Submission content managed web page area

On a content managed web page containing a Order Checkout/Submission area, in the Order Submission Success Message web page area format the secure_logo hook has been updated to display a "Secured By TOTECS" message to be consistent with the branding of the TOTECS platform.

Functionality Affected: Order Checkout/Submission content managed web page area
Impact: Normal

TOT-3629 - Hook to display product field drop down allowing users to choose how to find products by in Product Quick Add Form content managed web page area

On a content managed web page displaying a Product Quick Add Form area there is now the ability to embed a hook that displays a drop down, allowing a user to choose the product field that they can find products by.
This functionality would work the same as the Product Quick Add form that appears within the Trade interface's Basket Detail page.
Within the Administration Centre, under the Websites menu, within the Websites interface, from the Web Area Formats Libraries tree node, navigating to the Shopping Basket area types, in the Product Quick Add Form area, when modifying a Product Quick Add Form format, add new hook has been added called "quick_add_search_field_select".
This hook displays a drop down that allows the user to choose the product field that they wish to find a product on the quick add search textbox.
The product fields that will display in the drop down are based on the the product fields that are set to display from within the Stores menu, within the Product Search settings interface, for the Search Columns that are set to be visible.
These drop down options will be also sorted based on these settings.
If the quick_add_search_field_select hook is not embedded within the area then the Product Quick Add search will be based on the product code.

Functionality Affected: Product Quick Add Form content managed web page area
Impact: Normal

TOT-3631 - Faster loading times of content managed web pages loading flagged products in Product Search Results Listing areas

On a content managed web page display a Product Search Results Listing area, if the area was displaying products assigned to a flag or category then the area may load faster due to extra optimisation being added to the platform's database.

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

TOT-3633 - Format hook to allow order confirmation notification email to have order details embedded within the message body

When an order is submitted from either a content managed website or through the Trade interface, when an order confirmation is sent there now the ability to display all the details of the order (that would otherwise be saved in the file attachment) in the body of the email message.
Within the Administration Centre, under the Stores menu, within the Order settings interface, under the Order Notification Emails section, when viewing the format content for the Order Confirmation Email Message Format setting, a hook as has been added called "order_detail_content".
This hook will get all the order details formatted from the following settings that are combined together:

• Order Confirmation Email Order Detail Format
• Order Confirmation Email Order Surcharge Format
• Order Confirmation Email Order Freight Format
• Order Confirmation Email Order Detail Product Format
• Order Confirmation Email Order Detail Product Deal Format
• Order Confirmation Email Order Detail Product Field Format
• Order Confirmation Email Order Detail Product Attachment Format

TOT-3635 - Product Search Profiles allow products to be search on using the Meta Keyword field

For product searches using Product Search Profiles within the Trade interface, or on content managed web pages display Product Search Form areas there is now the ability to configure product search profiles to find products by matching text set in a Product's Meta Keyword field.
Within the Administration Centre, under the Inventory menu, in the Search Profiles interface, within modifying a "Product" search profile, within the Add Input form the Link Field To select element the Meta Keywords field can now be selected. This field can then be used to allow users to directly find products by matching data in the Meta Keywords field, or be used as a hidden input that can be used to match products on based on an other field that is mapped to the Meta Keywords field.

Functionality Affected: Search Profiles admin centre interface, Product Search process
Impact: Normal

TOT-3637 - Cacheable content managed web page areas for user sessions

When a content managed web page loads there is now the ability for chosen web page areas when displayed to be cached/remembered in the user's session. When the user next loads a content managed web page the content of these previously cached web page areas can then be loaded from the platform's servers memory, allowing web pages to load faster. The consequence is that the content of these cached areas will not change between page reloads until the user either logs in again, logs out, or their session no longer exists.
Within the Administration Centre, under the Websites menu, in the Websites interface, upon right clicking on a content managed web page, in the Web Page Editor interface, clicking on the blue circle of an area, in the Area Settings popup a new setting has been added labelled "Is Cacheable". If this setting is ticked then the web page area will become cacheable when user's next load the web page that the area belongs to. It is recommended for certain areas such as basket areas, account enquiry areas, order submission areas to never be set to Is Cacheable since the content in these areas will change regularly.
Note that if known search engines/automated crawler software makes requests to load a web page that the caching will be ignored. This ensures that the platform's server's don't store redundant session data.
If you are working on a content managed web page and temporarily don't want the web page area caching to be used, if at the end of the URL the parameter "ignore_area_caching=Y" is set, then the platform will ignore loading cached areas for that request. This is useful when administrators are actively checking or modifying the content of a web page.


Functionality Affected: Content managed webpages, content managed web page areas
Impact: Major

TOT-968 - Sort product search and category listings by price within the Trade interface and content managed webpage areas

There is now the ability on the Trade interface as well as on content managed web pages displaying Category Listing and Product Search Results Listing areas to be able to sort products by price.
Within the Administration Centre there are a number of settings that can now control if category and product searches order products by price:

• Under the Inventory menu, within the Categories settings interface, the Category Product Sort Field setting now has an option to have products sorted by price when products are display in category product listings.
• Under the Stores menu, within the Product Search settings interface, the Product Sort Field setting now has an option to have products sorted by price in product searches that use this default setting.
• Under the Inventory menu, within the Search Profiles interface, when modifying a Product search profile or Product Attribute search profile the Sort Search By drop down now allows admin users to set Price field to sort products by default when the search profile is used.

TOT-2998 - Admin Centre Facebook link to point to TOTECS Facebook profile

Within the Administration Centre, the Facebook link has now been updated to to point the TOTECS facebook profile page.

Functionality Affected: Administration Centre
Impact: Minor

TOT-3190 - Ability for administrator users to resend order confirmation emails within the Orders admin centre interface

Within the Administration Centre there is now the ability for administrator users to resend order confirmation emails to nominated email addresses of there choice.
In the Administration Centre, under the Orders menu, within the Orders interface, when a one or more order records display within the orders table, in the options column a button labelled Email now appears.
If a user clicks on the Email button it will display a dialog that allows the user to set email addresses that they wish to send an order confirmation email to.
Upon the user clicking on the Send Email button the platform will resend the order confirmation email to the nominated recipients and display a dialog showing the results of sending the email.

Functionality Affected: Orders admin centre interface, order confirmation email sending process
Impact: Normal

TOT-3307 - Settings to show only attribute values assigned to active visible products within Product Attribute Search Profile forms

For product attribute search profile forms displayed within the Trade interface or in "Product Search Form (Using Search Profiles)" content managed web page areas, for each product attribute field there is now a setting that decided if all values assigned to the attribute should display, or only values assigned to products that are active and not hidden.
Within the Administration Centre, under the Inventory menu, in the Search Profiles interface, when editing a Product Attribute search profile, under the Search Profile Attributes section upon clicking on Product Attribute assigned to the form or clickin on the Add button, in the Assign Search Attribute dialog a new setting has been added labelled "Show Only Values Assigned To Active Visible Products".
If this setting is ticked then when the product attribute search profile form is displayed in the Trade interface or on a content managed webpage then only attribute values that are assigned to products that are active and not hidden will display. if the "Show Only Values Assigned To Active Visible Products" setting is unticked then all attribute values will display regardless on whether the values are assigned to active products or not.

Functionality Affected: Product Search Form (Using Search Profiles)" content managed web page area, Home Trade interface page, Product Search Trade interface page
Impact: Normal

TOT-3557 - Flagged products displayed on the Trade Interface homepage to always be sorted descending from highest order weighting to lowest

Within the Trade interface, on the Home page for each section of Flagged products, the ordering of the products now always set to highest Order Weighting products to lowest, based on the Order Weighting field set when a product is assigned to a flag.

Functionality Affected: Home Trade interface page
Impact: Normal

TOT-3558 - Hooks to sort contracts by in Customer Account Contract Listing content managed web page area

On a content managed web page displaying a Customer Account Contract Listing area there is now the ability for administrator users to set how the contracts are ordered by default when the area first displays. Additionally hooks have been added to the area to allow users to control how they wish to sort contracts by.
Within the Administration Centre, under the Websites menu, within the Websites interface, when editing a web page, within the Web Page Editor and opening the Customer Account Contract Listing area the following settings have been added:

• Contract Sort Field: Sets the field that contracts are ordered by when the area is first displayed on a web page
• Contract Sort Direction: Sets the direction that contracts are ordered by when the area is first displayed on a web page

• contract_records_sort_drop_down: Drop down that allows the user to select the contract field to sort contracts by.
• contract_records_sort_direction_drop_down: Drop down that allows the user to select the direction that contracts are sorted by.

TOT-3573 - Save order confirmation email attachment as a PDF file

Within the Administration Centre, under the Stores menu, within the Order Settings interface, under the Order Notification Emails section a new setting has been added called "Order Confirmation Email - Order Details Set As". This setting controls how the order details are setting within the Order Confirmation Email that is sent out once a user successfully submits an order. The setting can be configured to one of the following options:

• HTML Webpage Attachment: The order details are attached as a HTML web page file of the notification Email. This is previous way the platform has worked.
• PDF Attachment (Converted from HTMLv4 Formats): The order details are attached as a PDF file to the notification Email. The PDF is generated from a HTML web page that has been set within formats set against the project. These formats need to confirm to the XHTML strict 4 standards for the PDF to be able to generate.
• PDF Attachment (Converted from HTMLv5 Formats): The order details are attached as a PDF file to the notification Email. The PDF is generated from a HTML web page that has been set within formats set against the project. These formats need to confirm to the HTML 5 standards for the PDF to be able to generate.
• Within Email Message: The order details will not be added as an attachment, but instead the HTML of the order detail can be embedded directly within the email message.

TOT-3576 - Formats to control the content and styling of the order confirmation email attachment file

When an order is submitted from either a content managed website or through the Trade interface, for the attached order details file that is sent out confirmation email, the contents of the attachment file are now configurable in both the content and styling of the order. This is done through the introduction of project settings that can format different parts of the order.
Within the Administration Centre, under the Stores menu, within the Order settings interface, under the Order Notification Emails section the following settings have been added:

• Order Confirmation Email Attachment Format: Controls the overall formatting of the attached file that is attached to the confirmation email.
• Order Confirmation Email Order Detail Format: Controls the overall formatting of the order detail and its layout.
• Order Confirmation Email Order Surcharge Format: Controls the formatting for each type of surcharge record applied to the order.
• Order Confirmation Email Order Freight Format: Controls the formatting of the freight information set in the order.
• Order Confirmation Email Order Detail Product Format: Controls the formatting for each product line assigned to the order.
• Order Confirmation Email Order Detail Product Deal Format: Controls the formatting of each deal applied to each product line in the order.
• Order Confirmation Email Order Detail Product Field Format: Controls the formatting of each basket field set with a value by the user, that is applied to each product line in the order.
• Order Confirmation Email Order Detail Product Attachment Format: Controls the formatting of each attachment file assigned to its associated product line in the order.

TOT-3601 - Hooks within Product Quick Add Form content managed web page area's autocomplete for showing stock availability, pricing, sales rep discounting, combination products

On a content managed web page displaying a Product Quick Add Form area it now contains additional hooks that allow the following data and features to be displayed when a user is using the quick add form:

• Display product available stock quantity
• Display product available stock level
• Display product available stock level image
• Display if a product is a parent combination product
• Display product price if the user is sales rep
• Display customer account price level price of a product if the user is a salesrep
• Allow sales reps to set discounts on pricing if they have permission to do so
• Display Not Found text if a product could not be found with the search term entered by the user
• Hide Add To Basket elements if the product cannot be added to basket

• quick_add_product_found_div_id: ID to set for the element that displays when a product has been selected.
• quick_add_product_found_div_class: Name of the CSS class that controls the element that displays when a product has been selected.
• quick_add_product_allow_add_to_basket_div_id: ID to set for the element that displays when a product has been selected that can be added to basket.
• quick_add_product_allow_add_to_basket_div_class: Name of the CSS class that controls the element that displays when a product has been selected and can be added to basket.
• quick_add_product_item_id_input: Hidden input that contains the product code of the product that has been selected.
• quick_add_product_item_id_input_id: ID of the textbox input that contains the product code of the product that has been selected.
• quick_add_product_is_combination_input: Hidden input that specifies if the selected product is a parent combination product or not.
• quick_add_product_is_combination_input_id: ID of the hidden input that specifies if the selected product is a parent combination product or not.
• quick_add_product_not_found_element_class: Name of the CSS class that controls the element that displays when no product could be found when the user performed a search.
• quick_add_product_not_found_element_id: ID to set for the element that displays when no product could be found when the user performed a search.
• quick_add_product_price_discount_div_id: ID to set for the element that displays when the user has the ability to discount the price of the found product.
• quick_add_product_price_discount_div_class: Name of the CSS class that controls the element that displays when the user has the ability to discount the price of the found product.
• quick_add_product_price_discount_checkbox_id: ID to set for the checkbox form element that allows the user to specify if the product price is to be discounted or not.
• quick_add_product_price_discount_textbox_id: ID to set for the textbox form element that allows the user to set the percentage discount of the price of the product they wish to discount by.
• quick_add_product_price_discount_price_total_span_id: ID of the element that displays the price of the product that a price may be discounted by.
• quick_add_product_price_level_discount_div_id: ID to set for the element that displays when the user has the ability to discount the price-level price of the found product.
• quick_add_product_price_level_discount_div_class: Name of the CSS class that controls the element that displays when the user has the ability to discount the price-level price of the found product.
• quick_add_product_price_level_discount_checkbox_id: ID to set for the checkbox form element that allows the user to specify if the product price-level price is to be discounted or not.
• quick_add_product_price_level_discount_textbox_id: ID to set for the textbox form element that allows the user to set the percentage discount of the price-level price of the product they wish to discount by.
• quick_add_product_price_level_discount_price_level_total_span_id: ID of the element to set that displays the price-level price of the product that a price may be discounted by.
• quick_add_product_stock_quantity_div_id: ID to set for the element that displays the available stock quantity section of the selected product.
• quick_add_product_stock_quantity_div_class: Name of the CSS class that controls the element that displays the available stock quantity of the selected product.
• quick_add_product_stock_quantity_element_id: ID to set for the element that displays the available stock quantity of the selected product.
• quick_add_product_stock_level_div_id: ID to set for the element that displays the available stock quantity level section of the selected product.
• quick_add_product_stock_level_div_class: Name of the CSS class that controls the element that displays the available stock level of the selected product.
• quick_add_product_stock_level_image_id: ID to set for the image element that displays the available stock level image of the selected product.
• quick_add_product_stock_level_status_element_id: ID to set for the element that displays the available stock level of the selected product.
• quick_add_product_stock_level_status_class: Name of the CSS class that controls the element that shows the available stock level of the selected product. Will display either none, low or high.

• The user can only use the price discount fields if they are a sales rep user who's assigned to a Facility Role that has the Override Product Pricing permission enabled.
• The sales rep user needs to have the View Product Pricing Discounting permission set to allowed to allow them to set the product price based on a percentage off the current price of the product.
• The sales rep user needs to have the View Product Pricing Level Discounting permission set to allowed to allow them to set the product price based on a percentage off the price-level price of the user's assigned customer account.
• For the user to view product stock quantities the "Display Stock Column" setting within the Administration Centre's Stores - Basket settings interface needs to be set to ON, and the Product setting's Stock In Numeric Form needs to be set to ON.
• For the user to view product stock levels the "Display Stock Column" setting within the Administration Centre's Stores - Basket settings interface needs to be set to ON, and the Product setting's Stock In Numeric Form needs to be set to OFF.

TOT-3617 - Hooks to be able to display organisation name and contact name in Customer Account Invoice, Sales Order, Back Order and Credit content managed web page areas

On a content managed web page containing either an Customer Account Invoice, Customer Account Sales Order, Customer Account Credit or Customer Account Back Order area, hooks have been added that allow the organisation name and contact fields to be displayed for both delivery and billing addresses associated with the account enquiry record retrieved from the Connector.
The following content managed web page area formats now have additional hooks added:Customer Account Invoice Format:

• invoice_delivery_org_name: Displays the name of the organisation assigned to the delivery address of the invoice
• invoice_delivery_contact: Displays the name of the person who can be contacted in regards to the delivery of the invoice
• invoice_billing_org_name: Displays the name of the organisation assigned to the billing address of the invoice
• invoice_billing_contact: Displays the name of the person who can be contacted in regards to the billing of the invoice

• order_sale_delivery_org_name: Displays the name of the organisation assigned to the delivery address of the sales order
• order_sale_delivery_contact: Displays the name of the person who can be contacted in regards to the delivery of the sales order
• order_sale_billing_org_name: Displays the name of the organisation assigned to the billing address of the sales order
• order_sale_billing_contact: Displays the name of the person who can be contacted in regards to the billing of the sales order

• credit_delivery_org_name: Displays the name of the organisation assigned to the delivery address on the credit
• credit_delivery_contact: Displays the name of the person who can be contacted in regards to the delivery on the credit
• credit_billing_org_name: Displays the name of the organisation assigned to the billing address on the credit
• credit_billing_contact: Displays the name of the person who can be contacted in regards to the billing on the credit

• back_order_delivery_org_name: Displays the name of the organisation assigned to the delivery address of the back order
• back_order_delivery_contact: Displays the name of the person who can be contacted in regards to the delivery of the back order
• back_order_billing_org_name: Displays the name of the organisation assigned to the billing address of the back order
• back_order_billing_contact: Displays the name of the person who can be contacted in regards to the billing of the back order

TOT-3620 - Facility Role permissions to allow users to not set the organisation name in delivery and billing address when proceeding through order checkout

On a content managed webpage containing a "Guest Order Checkout/Submission" area, or on the Order Details page within the Trade interface, when a user proceeds through the Order Details page, previously if the Organisation Name Address setting was turned on for the project then the order validation process required that the organisation name for both the delivery address and billing address contained data for all users. 2 new Facility Role permissions have now been created that independently control if a user should be required to set the organisation name for a delivery address, as well as the billing address, in both the Guest Order Checkout/Submission, as well as when creating or updating existing delivery addresses.
These permissions allow different groups users to be required to set organisation name in addresses or not, such as for group users who are individuals, or users ordering on behalf of companies.
Within the Administration Centre, under the Users menu, in the User Permissions interface, upon modifying a Facility Role the following permissions have been added:

• Billing Address Organisation Name Not Mandatory: If set to allow then the assigned users to the role do not have to set an organisation name in the billing address when using the Guest Order Checkout feature. If set to deny then they must set a value in the Billing Organisation Name field during checkout.
• Delivery Address Organisation Name Not Mandatory: If set to allow then the assigned users to the role do not have to set an organisation name in the delivery address when using the Guest Order Checkout feature, or when creating a new delivery address, or updating an existing delivery address. If set to deny then they must set a value in the Delivery Organisation Name field during checkout, as well as when creating or modifying existing addresses.

Bug Fixes

TOT-3623 - update_product_price_level_discount_field hook displaying unreadable characters within Basket Products Listing content managed web page area when unit product price is greater than $1000

On a Basket Products Listing content managed web page area, if the area was displaying a product that had a unit price of over $1000 dollars then in the Basket Product Record web page area format the update_product_price_level_discount_field hook would display a question mark character instead of the amount that the product was discounted by.
The Basket Products Listing content managed web page area has been modified to correctly calculate the discount applied to the basket's product price, ensuring that no question mark appears in the update_product_price_level_discount_field hook if the product's unit price is over $1000.

Functionality Affected: Basket Products Listing content managed web page area
Impact: Normal

TOT-3632 - Incorrect http protocol being set for secure images and libraries URLs in the Edit Image/Attachment Library Admin Centre interface

Within the admin centre, when copying an image or image URL from a website library within the admin centre, the image URL has its protocol set to http:// regardless of whether or not the website's 'Website Security Mode' setting is set to 'Secured (HTTPS)' or not.
Within the Websites interface, from the Tree menu when clicking on either an image or attachment library, in the Edit Image Library interface or within the Edit Attachment Library interface the URLs of the image and attachment files now have the protocol of the URL set based on if the file belongs to a library that is assigned to a fully secured content managed website or not.

Functionality Affected: Edit Image/Attachment Library admin centre interface
Impact: Minor

New Features

TOT-3555 - Master Content Managed Website Design Deployer

Within the Adminisration Centre there is now the ability to deploy new content managed web pages that have been already been implemented with TOTECS own "Master Website Design". This can dramatically speed up deployment of new websites, implementing a secure mobile/respsonsive design featuring many TOTECS features out of the box.
In the Administration Centre, under the Websites menu, within the Websites interface, upon clicking on the New Website tree node, a new dialog called "Create New Content Managed Website". Within the dialog it allows you to set the following details of the new website being created:

• Website Domain: Set the domain of the website
• Website Root Domain: Set the domain that will be set against the session cookie. It should be set to either match the website domain, or be a root domain.
• Email Address: Email address that website specific notifications may be sent to, such as enquiry form submissions.
• Login URL: URL that users will be redirected to once logged into the website.
• Logout URL: URL that users will be redirected to once logged out of the website.
• Website Design: The design of the website that will be deployed. If set to Empty Website then no assets such as webpages or libraries will be initially deployed. If set to Master Website Design 1 then webpages an other assets will be initially deployed when the website is first created based on the TOTECS Master Website Design.

• Category Tree - Navigation: Set the category tree that will be configured to show and allow users to navigate through from the top navigation bar of the website's pages.
• Category Tree - Brands: Set the category tree that will be configured to show and allow users to navigate through from the Brands footer section of the website's pages.
• Product Search Profile - Web Page Headers: Set the product search profile that will be used to search for products from the search box in the top navigation bar on all web pages. Ensure that the search profile has only one text input.
• Product Flag - Featured - Home Page: Set the product flag that will be used to display all products under the Featured section on the home page.
• Product Flag - New - Home Page: Set the product flag that will be used to display all products under the New section on the home page.
• Product Flag - On Special - Home Page: Set the product flag that will be used to display all products under the On Special section on the home page.

Improvements

TOT-3592 - Hook to display Y or N if product can be added to basket from a content managed web area that uses the Product Search Record format

On a content managed website that displays any areas that use the Product Search Record format a new hook has been added to the format called "addProductQuantityAllowed", that displays either Y or N to indicate if the product can be directly added to basket or not.
The hook will return N if a product is a parent combination product or the product is part of a product group.

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

TOT-3595 - Setting for Related Products Listing content managed web page area to display products as records or in a list

On a content managed webpage containing a Related Products Listing area there is now the option of displaying product records in a HTML list, or as records without any list elements wrapping the records.Within the Administration Centre, in the Websites interface, in the All Areas section of a Web Page, when adding or editing a Related Products Listing Area, a new option has been added called "Display Records As" that allows a user to choose to display product search records in two different ways, as a list or as records.
The setting contains 2 options:

• List - Each Product Search Record format displayed in the area will be displayed within an unordered list element
• Records - Each Product Search Record format displayed in the area will not be wrapped around with any HTML elements.

TOT-3602 - Content managed webpage javascript API function to get URL parameters of a Product Search Form area

On a content managed web page, in the javascript API there is now a function that can be called to the URL paramters of a Product Search Form.
These parameters could then be used by 3rd party Javascript to call Product Search Results Listing web page areas to update on the web page and pass the search parameters to the areas, allowing results of a product search to display.
Within the content managed webpage javascript API a new function has been added called: TOTECS.retail.fs.getProductSearchFormAreaSearchParams(webpageAreaID);
The function takes one argument, the ID of the web page area that contains the Product Search Form area. The function will return a string containing the URL parameters that the product search would call to allow Product Search Result Listing areas to perform a product search and display the results.
If the incorrect web page area ID is given then the function will return either false, or otherwise raise a browser alert box advising that the incorrect area was provided.

Functionality Affected: Content managed webpage Javascript API
Impact: Normal

Bug Fixes

TOT-3589 - Incorrect URL set in link immediately after uploading attachment or image file in News/Blogs Admin Centre interface

Within the Administration Centre, under the Marketing menu, within the News/Blogs interface, upon viewing the details of a news/blog item, when uploading a file via the News/Blog item editor and then immediately inserting a link to that file in the body of the news/blog item field, the base href would appear twice in the URL for the file attachment.
Now when uploading an attachment or image file to a content managed website library in the News/Blog Item Editor, the URL is now correctly set if the image or attachment file is immediately inserted into the heading, body, or spare fields of the news/blog item.

Functionality Affected: News/blogs administration centre interface
Impact: Normal

TOT-3593 - Product Stock Quantities data import not updating product stock quantities when obtaining records from Connector version 1.x

Within the Administration Centre, under the Data menu, within the Data Imports interface, if a Product Stock Quantities data import is run and requests data from a Connector running version 1.0 or higher, the data import was not updating product stock quantities.
Now if a Product Stock Quantities data import is run and requests data from a Connector running version 1.0 or higher, the data import now is able to correctly update product stock quantities. The issue was caused by the data import not being able to handle data in from the Connector 1.x in the updated form.

Functionality Affected: Product Stock Quantities connector data import
Impact: Normal

TOT-3598 - Shopping Lists Listing and Shopping List Products content managed web page areas not displaying the Login ID and Email of the user who created a shared shopping list

On a content managed web page containing either a Shopping Lists Listing or Shopping List Products content managed web page areas, if the shopping list displayed in the areas was shared to the user viewing it, the Login ID and and Email hooks in the area's formats incorrectly show the details of the user viewing the shopping list, instead of the user who created the shopping list.
For the Shopping List Products content managed web page area it has now been modified so that the shoppinglist_login_id hook now displays the correct login ID of the user who created the shopping list.

Functionality Affected: Shopping Lists Listing , Shopping List Products content managed web page areas
Impact: Minor

TOT-3605 - Product upper stock limit being ignored in trade interface search results if product stock quantity is over 2,000

Within the trade interface's Product Search page and on content managed webpage areas that use the Product Search Record to display search results, if the project is configured to limit the stock quantities to an upper limit that a user can see, it was possible that users could see a product's actual available stock amount if the amount was over 1000.
The product search feature has been modified to ensure that if a project limits the upper quantity that a user can see, then they cannot see the actual stock quantity when its over 1000.

Functionality Affected: Product searching
Impact: Normal

TOT-3609 - Not Found image not being set for basketProduct_image hook in Basket Products Listing content managed web page area if an image is not assigned to a product

On a content managed webpage containing a Basket Products Listing area, for each product displayed with the Basket Product Record format, in a format's basketProduct_image hook it was being incorrectly set to a empty value instead of a URL that points to the anotfound.png image file when no active image has been assigned to the product. Because of this the user did not see any image displayed, instead of a the placeholder image.
The Basket Products Listing area has been modified so that for each product displayed with the Basket Product Record format, in a format's basketProduct_image hook when no active image has been assigned to the product the placeholder image now displays the correct anotfound.png image.

Functionality Affected: Basket Products Listing content managed web page areas
Impact: Minor

TOT-3615 - Pressing enter key on quantity textbox does not add product to basket within Product Quick Add Form content managed web page area

On a content managed web page area containing a Product Quick Add Form area, after the user had selected a product and entered a quantity into the quantity textbox, if they then had pressed the enter key the product was not being added to basket.
The Product Quick Add Form area has been modified so that the quantity textbox allows users to add a product to basket once it has been set a quantity and the user presses on the enter key.

Functionality Affected: Product Quick Add Form content managed web page area
Impact: Normal

New Features

TOT-3579 - Canvas content managed web page area

On a content managed web page a new area type has been created called "Canvas" that can display any content in the area that has been set within the area's format. This allows implementors to set and save HTML within the format, as opposed to setting HTML within a Free Draw area where admin users can easily destroy HTML markup and other hidden elements in the Freedraw area's editor.
Within the Administration Centre, under the Websites menu, in the Websites interface, under the Web Area Format libraries, a new area has been added called "Freedraw Canvas" which can be found under the "Canvas" area type.
The Freedraw Canvas area can be used to set and save HTML within its "Freedraw Canvas" format. Upon creating a Freedraw Canvas area on a content managed webpage, a user can select any of the formats that have previously been created within the Freedraw Canvas format library.
A Freedraw Canvas area contains 10 settings that can store any data that a user wishes to set. These settings can then be embedded within the area's format, allowing data such as labels, names, or any other content to be configured by the user.
It is recommended to use the Freedraw Canvas instead of a Freedraw area any time where hidden HTML markup needs to be placed within a Freedraw area's content.

Functionality Affected: Freedraw Canvas content managed web page area
Impact: Normal

TOT-3585 - Content Managed Website Global Data Hooks

For any content managed website there's now the ability to set data hooks that each can be embedded within any web page template across the website.
These "website data hooks" allow the same pieces of data such as file references to be controlled in one location and referenced across many web page templates, making it easy to update the same references across many areas.
Within the Administration Centre, under the Websites menu, within the Websites interface, upon clicking on the domain of a website, in the Website Site Details interface a new section called "Global Website Data Hooks" has been added.
Upon clicking on the Add Data Hook button will display a form that allows a new Website Data Hook to be created.
Each data hook needs a Hook Name which can be placed within any webpage templates of the website, additionally a "Hook Value" needs to be set that will set the text that is substituted in the webpage templates were the hook name is set. After setting the fields and clicking on the Save button the Website Data Hook will be added to the list of hooks that can then be changed by clicking on the Save button.
There is no limit to the amount of Global Website Data Hooks that can be created but the more hooks that are created, the slower content managed web pages may load. It is recommended to only create data hooks that are necessary and group data together into single data hooks where possible.

Functionality Affected: Content managed webpages, Website Detail administration centre interface
Impact: Normal

Improvements

TOT-3498 - Display product stock quantities for salesrep users within Product Detail content managed web page areas

On a content managed web page that is displaying a Product Detail area, the area can now be configured to list different stock quantities for a product if the user has permission to view such quantities.
The area now requires a format to be set called "Product Stock Quantity" that allows the overall available product stock quantity, live stock quantities, and location based stock quantities to be displayed in a customised way using the following hooks:

• product_stock_label: Displays a label of the type of stock being shown in the record.
• product_stock_quantity_available: Displays the amount of stock that is available for purchase based on the type of stock shown.
• product_stock_quantity_back_ordered: Displays the amount of stock that has already been ordered based on the type of stock shown.
• product_stock_quantity_consigned: Displays the amount of stock that is on consignment based on the type of stock shown.
• product_stock_quantity_on_hand: Displays the amount of stock that is on hand based on the type of stock shown.
• product_stock_quantity_reserved: Displays the amount of stock that has been reserved based on the type of stock shown.

TOT-3575 - Format to set message for submitted pending orders in Order Checkout/Submission content managed web page area

On a content managed web page that is displaying a Order Checkout/Submission area or a Guest Order Checkout/Submission area, the area can now be configured to display a customised message based on if a user was submitting an order that must first be approved by another user.
The area now requires a format to be set called "Order Submission Pending Message" that will be used to display a message to a user when they have submitted an order and its status has been set to pending.
If this new format has not be assigned to the area then it will continue to use the "Order Submission Success Message" format to display a message to the user advising that the order successfully submitted.

Functionality Affected: Order Checkout/Submission area, Guest Order Checkout/Submission content managed web page area
Impact: Normal

TOT-3578 - Display name of webpage in title and header of Web Page Editor admin centre interface

Within the Administration Centre, under the Websites menu, within the Websites interface, upon clicking on a web page and going to the Web Page Editor, the title of the web page now displays in the title of the browser, additionally the title displays within the All Areas interface, as well as for secure webpages the URL displayed is now SEO friendly.

Functionality Affected: Web Page Editor administration centre interface
Impact: Minor

TOT-3582 - Hooks to set web page link for most ordered products displayed within User Details/Favourites/Orders content managed web page area

Within the Administration Centre, under the Websites menu, within the Websites interface, when navigating through the Web Area Formats Libraries, under the User Details/Favourites/orders area, in the Ordered Products Record format the following hooks have been added to the format:

• ordered_product_link: Displays a URL of the ordered product based on web page set in the area.
• ordered_product_onclick: Contains a javascript function that allows the ordered product to be displayed in other areas listening on the web page.

TOT-3583 - Hooks to add product to basket in Product Combination content managed web page area when displaying child products in a list

On a content managed web page displaying a Product Combination area, when the area is displaying child products in a radio list, there is now the ability to directly add products to basket for each product. For the format the following hooks have been added:

• add_product_price_field: Textbox field that shows for permitted salesrep users and allows them to alter the price of a product when adding a product to basket.
• add_product_price_discount_field: Textbox field that shows for permitted salesrep users and allows them to set a discount against the current price of a product when adding a product to basket.
• add_product_price_level_discount_field: Textbox field that shows for permitted salesrep users and allows them to set a discount against the price-level price of a product when adding a product to basket.
• add_product_price_changes_allowed: Set to either Y or N to denote if the user has permission to alter the pricing of a product, or not.
• add_product_basket_qty_field: Contains a textbox that allows the user to enter a quantity of a product to add to their basket.
• add_product_basket_qty_field_ex_discount: Contains a textbox that allows the user to enter a quantity to add to basket and does not factor in price or percentage discount fields if they press the enter key on the field.
• add_product_basket_onclick: Contains a javascript function that allows a user to add a product to basket, as long as the quantity field has been also set within the format.
• add_product_basket_onclick_ex_discount: Contains a javascript function that does not factor in price or percentage discount fields when adding a product to basket.
• add_product_unit_selection: Contains a drop down that allows the user to choose the unit for adding a product to basket with.

TOT-3597 - Product Detail content managed web page area loading image viewer with Jquery 2.2.4

On a content managed website that displays a Product Detail area, if it has an image viewer embedded within it to show product images, the javascript code that sits behind the image viewer has now been updated to support Jquery 2.2.4.
This ensures that the image viewer can load on web pages that are loading the latest version of Jquery.

Functionality Affected: Product Detail content managed web page area
Impact: Normal

Bug Fixes

TOT-3580 - Ordered quantity hook incorrectly named within Ordered Products Record format of User Details/Favourites/Orders area

Within the Administration Centre, under the Websites menu, within the Websites interface, when navigating through the Web Area Formats Libraries, under the User Details/Favourites/orders area, in the Ordered Products Record format the name of the ordered_product_quantity_orderedint hook has been correctly changed to ordered_product_quantity_ordered_integer.

Functionality Affected: Websites administration centre interface
Impact: Normal

TOT-3581 - Unable to set Website Default for Product Detail Webpage setting within Customer Account Contract Detail content managed web page area

Within the Administration Centre, under the Websites menu, within the Websites interface, within the Web Page Editor, when modifying a Customer Account Contract Detail area, for the Product Detail Webpage setting there was no ability to set the setting to the Website Default product webpage.
When modifying a Customer Account Contract Detail area, for the Product Detail Webpage setting there is now the ability to set the setting to the Website Default product webpage.

Functionality Affected: Customer Account Contract Detail content managed web page area
Impact: Normal

New Features

TOT-3564 - Customer Account Enquiry Payment Listing content managed web page area

A content managed web page area has been created called "Customer Account Payments Listing" that will list all of the payments on a content managed web page, associated to the user's customer account that has been retrieved from the connected business system through the Connector.
The area will make a request to the Connector software that will in real time retrieve a list of payments from the configured business system.

• The area allows payments to be filtered based on date range, or the payment number of a given record.
• The area also allows users to paginate through a list of payment records, and have configured the number of records that display per page.
• The area can be displayed on both a secure and insecure content managed web page.
• The area requires that the Connector has been installed, configured, and is accessible to the TOTECS servers. It also requires that the connected business system allows for retrieval of payment data.
• The area allows it to be styled, structured, and customised to flexible designs.
• The area provides payment listing functionality that is the same as available in the Account Enquiry feature provided within the Trade interface.

• Customer Account Payment Listing: Displays the header and footer that wraps around the payment records. It contains hooks for allowing payment records to be filtered.
• Customer Account Payment Record : Displays the details of a single payment record.
• Customer Account Payment Error Message: Displays an error message if the payments could not be retrieved through the Connector.

• Payments Per Page: Sets the number of payment records that can display per page in the area.
• Payment Detail Webpage: Sets the web page that will be set in the URL that allows the details of a payment to be loaded.
• Load Payments In Date Range: Sets the date range that will be used to filter payments when the area is first loaded on the web page.

TOT-3566 - Customer Account Enquiry Credit Listing content managed web page area

A content managed web page area has been created called "Customer Account Credits Listing" that will list all of the credits on a content managed web page, associated to the user's customer account that has been retrieved from the connected business system through the Connector.
The area will make a request to the Connector software that will in real time retrieve a list of credits from the configured business system.

• The area allows credits to be filtered based on date range, or the credit number of a given record.
• The area also allows users to paginate through a list of credit records, and have configured the number of records that display per page.
• The area can be displayed on both a secure and insecure content managed web page.
• The area requires that the Connector has been installed, configured, and is accessible to the TOTECS servers. It also requires that the connected business system allows for retrieval of credit data.
• The area allows it to be styled, structured, and customised to flexible designs.
• The area provides credit listing functionality that is the same as available in the Account Enquiry feature provided within the Trade interface.

• Customer Account Credit Listing: Displays the header and footer that wraps around the payment records. It contains hooks for allowing credit records to be filtered.
• Customer Account Credit Record : Displays the details of a single credit record.
• Customer Account Credit Error Message: Displays an error message if the credit could not be retrieved through the Connector.

• Credits Per Page: Sets the number of credit records that can display per page in the area.
• Credit Detail Webpage: Sets the web page that will be set in the URL that allows the details of a credit to be loaded.
• Load Credits In Date Range: Sets the date range that will be used to filter credits when the area is first loaded on the web page.

TOT-3567 - Customer Account Enquiry Transactions Listing content managed web page area

A content managed web page area has been created called "Customer Account Transactions Listing" that will list all of the transactions on a content managed web page, associated to the user's customer account that has been retrieved from the connected business system through the Connector.
The area will make a request to the Connector software that will in real time retrieve a list of transactions from the configured business system.

• The area allows transactions to be filtered based on date range.
• The area also allows users to paginate through a list of transaction records, and have configured the number of records that display per page.
• The area can be displayed on both a secure and insecure content managed web page.
• The area requires that the Connector has been installed, configured, and is accessible to the TOTECS servers. It also requires that the connected business system allows for retrieval of transaction data.
• The area allows it to be styled, structured, and customised to flexible designs.
• The area provides transaction listing functionality that is the same as available in the Account Enquiry feature provided within the Trade interface.

• Customer Account Transaction Listing: Displays the header and footer that wraps around the transaction records. It contains hooks for allowing transaction records to be filtered on date.
• Customer Account Transaction Record : Displays the details of a single transaction record.
• Customer Account Transaction Error Message: Displays an error message if the transactions could not be retrieved through the Connector.

• Transactions Per Page: Sets the number of transaction records that can display per page in the area.
• Credit Detail Webpage: Sets the web page that will be set in the URL that allows the details of a transaction that is associated to a credit record to be loaded.
• Invoice Detail Webpage: Sets the web page that will be set in the URL that allows the details of a transaction that is associated to a invoice record to be loaded.
• Sales Order Detail Webpage: Sets the web page that will be set in the URL that allows the details of a transaction that is associated to a sales order record to be loaded.
• Back Order Detail Webpage: Sets the web page that will be set in the URL that allows the details of a transaction that is associated to a back order record to be loaded.
• Payment Detail Webpage: Sets the web page that will be set in the URL that allows the details of a transaction that is associated to a payment record to be loaded.
• Load Transactions In Date Range: Sets the date range that will be used to filter transactions when the area is first loaded on the web page.

TOT-3569 - Customer Account Enquiry Payment content managed web page area

A content managed web page area has been created called "Customer Account Payment" that will display the details of a single payment record on a content managed web page, retrieved in real time from the business system configured to the Connector.
The area will make a request to the Connector software that will in real time retrieve the detail of a single payment from the configured business system, associated to the user's customer account.

• The area can be displayed on both a secure and insecure content managed web page.
• The area requires that the Connector has been installed, configured, and is accessible to the TOTECS servers. It also requires that the connected business system allows for retrieval of payment data.
• The area allows it to be styled, structured, and customised to flexible designs.
• The area provides payment record functionality that is the same as what is available in the Account Enquiry feature provided within the Trade interface.

• Customer Account Payment: Displays the details of the payment record.
• Customer Account Payment Line Item: Displays the details of a payment applied against a referenced record.
• Customer Account Payment Line Text: Displays the details of a single line associated with a text description included in the payment record.
• Customer Account Record Error Message: Displays in the area if the payment record could not be retrieved.

TOT-3570 - Customer Account Enquiry Credit content managed web page area

A content managed web page area has been created called "Customer Account Credit" that will display the details of a single credit record on a content managed web page, retrieved in real time from the business system configured to the Connector.
The area will make a request to the Connector software that will in real time retrieve the detail of a single credit from the configured business system, associated to the user's customer account.

• The area can be displayed on both a secure and insecure content managed web page.
• The area requires that the Connector has been installed, configured, and is accessible to the TOTECS servers. It also requires that the connected business system allows for retrieval of credit data.
• The area allows it to be styled, structured, and customised to flexible designs.
• The area provides credit record functionality that is the same as what is available in the Account Enquiry feature provided within the Trade interface.

• Customer Account Credit: Displays the details of the credit record.
• Customer Account Credit Line Item: Displays the details of a credit applied against a referenced record.
• Customer Account Credit Line Text: Displays the details of a single line associated with a text description included in the credit record.
• Customer Account Record Error Message: Displays in the area if the credit record could not be retrieved.

Improvements

TOT-3152 - Allow all content managed web page areas be be placed within secure web pages and generate HTTPS links

Within the Administration Centre, under the websites menu, within the websites interface, upon clicking on the domain link of a content managed web site, in the Website Details interface a new setting has been added labelled "Website Security Mode". If this setting is changed to "Secure (HTTPS)" then all of the website's webpage templates will be changed to become secure, and because of that all web pages in the website will also become secured. Additionally changing this setting will enforce all web page areas assigned to global webpage formats to be reassigned to secure global formats that set HTTPS in any links.
Once a website's secure mode is set to Secure then on any secure web page the any areas can be added to the web pages through the Web Page Editor. Additionally all local web page formats should be checked to see that no HTTPS javascript, CSS, image and other files are referenced within format content. The same also has to be done for web page templates.
It is highly recommended to only change the website security mode after a TLS/SSL security certificate has been purchased for the website's domain, and has been set up beforehand on the TOTECS platform.
As a part of this improvement the following content managed web page areas having links modified to support embedded https:// into web page URLs:

• Enquiry Form
• Thumb Image Gallery
• Image Window Gallery
• Image Gallery Upload
• News Group Forum
• News Item Form
• News/Blog Crumbs
• Alphabetical Sitemap
• Tier Sitemap
• User Details/Favourites/Orders
• Shopping Lists Listing
• Shopping List Sharing Form
• Shopping List Attachments List
• Shopping List Products Import Form
• Customer Account Contract Listing
• Category Listing Header
• Category Listing
• Category Crumbs
• Category Tree Nested Navigation
• Category Tree Panel Navigation
• User Registration
• Model Product
• Order Checkout/Submission
• Basket Summary
• Basket Products Listing
• Product Quick Add Form
• Product Detail
• Product Group
• Product Combination
• Product Search Form
• Product Search Results Listing

TOT-3526 - Display Average Cost Price record within Product Detail content managed web page area's Price-Level Price list

On a content managed web page containing a Product Detail area. if a user in the area is allowed to display the price-level pricing of a product, then the price-level pricing can now display a price record that shows the average cost of the product if the price is greater than 0, as well as allowing the user to add the product to basket at the cost price (if they have permission to discount pricing).
The average cost price will show first in the list of product prices. and the label of the average cost price can be controlled based on a setting within the Administration Centre, under the Product Settings interface labelled "Product Average Cost Price Label"

Functionality Affected: Product Detail content managed web page area, Product Settings administration centre interface
Impact: Normal

TOT-3533 - Hooks in Basket Products Listing content managed web page area to control if user's are allowed to checkout based on account status

On a content managed web page containing a Basket Products Listing area, the area's header and footer formats now have hooks that specify if a user is allowed to proceed through the Order Checkout/Submission process based on the status of their assigned customer account.
These hooks can be used to advise a user if they are not allowed to order, or warn them if there is a problem with their account and requires payment before allowing more orders to continue.
In the Basket Products Listing area the following hooks have been added to the area's "Basket Products Heading" and "Basket Products Footer" formats:

• basket_checkout_status: Contains the status of whether the user is allowed to proceed to order checkout. Set to either OK - user are allowed WARN - user is allowed but should be shown message - WARNCC - user is allowed but should be shown message and can only pay with credit card. BLOCK - user is not allowed.
• basket_checkout_message: Message that indicates to the user if they are allowed or not allowed to checkout based on the status of their account.', 'Your account is on hold.
• basket_message_html_escaped; Message that indicates to the user if they are allowed or not allowed to checkout based on the status of their account. Message can be safely placed in HTML code.
• basket_message_js_escaped; Message that indicates to the user if they are allowed or not allowed to checkout based on the status of their account.

TOT-3534 - Enable live check of user's customer account status if user is logging into a content managed website or changing accounts within it

On a content managed website there is now the ability to check if a user is allowed to create an order, based on performing checks on their assigned customer account similar to the functionality within the Trade interface.
Within the Administration Centre, under the Stores menu, within the Checkout Settings interface a new setting has been added labelled "Check live user's account status in interfaces".
This setting controls if live customer account checks should occur when a user logs into to either the Trade interface or a content managed website, as well as if the user tries to switch accounts during their session. The setting can be set to one of the following values:

• Trade: Only when a user logs into the Trade interface will customer account status checks occur.
• Content Managed Website: Only when a user logs into a content managed website interface will customer account status checks occur.
• Both: If a user logs into either the Trade interface or a content managed website will customer account status checks occur.
• None: No checks will be made when a user logs in either the Trade interface or a content managed website.

TOT-3548 - Add paginator event listener to Customer Account Contract Detail content managed web page area

On a content managed web page that displays either a Customer Account Contract Listing and Customer Account Contract Detail area, if the user updates the list of contracts or products within the area, there is now the ability for Javascript logic to listen for area's lists being updated, allowing customised javascript functionality to be called, such as scrolling the user to the top of the area, or displaying a loading message.Each of the areas will now fire off a BEFORE_PAGINATOR_RELOAD event that allows any 3rd party Javascript to listen for the event and perform actions as the area reloads contracts, or products listed within the area.

Functionality Affected: Customer Account Contract Listing, Customer Account Contract Detail content managed web page areas
Impact: Normal

TOT-3559 - Increase maximum number of characters set for names of content managed web page area formats

Within the Administration Centre, under the Websites menu, within the Websites interface, when creating or modifying an existing content managed web page area format, the name of the format now allows up to 80 characters to be set in the name field.
This additional field length allows admin users to set longer and more meaningful names of web page area formats.

Functionality Affected: Websites Administration Centre interface
Impact: Minor

TOT-3562 - Allow web pages with the same title name to be created in each content managed website

Within the Administration Centre, under the Websites menu, in the Websites interface previously only one web page could exist across all content managed websites with the same title name.
This restriction has now been removed to allow multiple web pages to exist with the same title across multiple content managed web sites in the same TOTECS project.
Within the Administration Centre, under the Websites menu, in the Websites interface, under the Websites tree node when clicking on the New Web Page node, administrator users are now able to set the title name of the web page to match the same name of a web page that already exists in a different content managed website.
When a content managed web page is loaded the platform will now use the web page title and the domain set in the URL to determine the correct content managed web page to load on the web page.

Functionality Affected: Websites Administration Centre interface, content managed webpage load
Impact: Normal

TOT-3563 - Formats based on if a category is a leaf or a branch in Category Tree Nested Navigation and Category Tree Panel Navigation content managed web page areas

On a content managed web page displaying either a Category Tree Nested Navigation or Category Tree Panel Navigation areas, the areas need have been modified to support having different category record formats, based on if a category contains child categories or not (known as a leaf or branch category in the tree).
Within the Administration Centre, under the Websites interface, under the Webpage Area Formats Libraries expanding the Product Category node under the Category Tree Nested Navigation area, two new formats have been added called "Nested Category Branch Record" and "Nested Category Leaf Record".
These appear in a Category Tree Panel Navigation area for each category based on if a category contains, or does not contain child categories.
Two new hooks have been for each of these areas, "category_record_id" which returns the unique ID of the category and "category_parent_record_id" which returns the unique ID of the parent category that the category is assigned to.

Functionality Affected: Category Tree Nested Navigation, Category Tree Panel Navigation content managed web page areas
Impact: Normal

TOT-3568 - Hooks in User Details/Favourites/Orders content managed web page area to show the login ID and account code of the user who created the order

On a content managed web page that displays a list of submitted orders in the User Details/Favourites/Orders area, the area's "Historic Order Record" format now contains hooks that can show the Login ID of the user who submitted the order, as well the customer account that the order was assigned to.
These hooks can be used for when the area is used to show a list of pending orders to a managing user who needs to approve the order.
In the area's "Historic Order Record" format the following hooks have been added to be able to display the account and user who the order was created by:

• ordering_user_login_id: Login ID of the user who created the order.
• ordering_account_code: Code of the customer account that is assigned to the order when it was created.

TOT-3571 - Hooks to ignore discount fields when adding products to basket in Product Detail, Product Search Results Listing, Category Listing, or a Basket Product Listing content managed webpage areas

On a content managed web page containing either Product Detail or Basket Product Listing areas, or any areas that display a product using the Product Search Record format, there is now the ability to allow sales rep users to add the product to basket, or update an ordered quantity and not factor in values in the discount fields, allowing the platform to independently price a product factoring in any volume discount pricing, and account pricing.
In Product Detail and other areas using the Product Search Record format, if no discount fields and set within the area then the platform will not factor is the discounts when pricing a product being added to basket.
The following formats have additional hooks added:

• Product Detail Format
  • addProductQuantityField_ex_discount: Contains a quantity textbox that allows the user to enter a quantity to order and does not factor in price or percentage discount fields if they press the enter key on the field.
  • addProduct_onclick_ex_discount: Contains a javascript function that does not factor in price or percentage discount fields when adding a product to basket.
• Product Search Record Format
  • addProduct_onclick_ex_discount: Contains a javascript function that does not factor in price or percentage discount fields when adding a product to basket.
  • addProductQuantityField_ex_discount: Contains a quantity textbox that allows the user to enter a quantity to order and does not factor in price or percentage discount fields if they press the enter key on the field.
• Basket Product Record Format
  • updateProduct_onkeypress_ex_discount: Contains a javascript function that does not factor in price or percentage discount fields when adding a product to basket when the enterkey is pressed.
  • updateProduct_onchange_ex_discount: Contains a javascript function that does not factor in price or percentage discount fields when adding a product to basket.

Bug Fixes

TOT-3560 - Customer Account assigned to a user's basket doesn't get switched when a user's account is changed within the User Detail admin centre interface

Within the Administration Centre, under the Users menu, within the Search Users interface, after locating a user and viewing the user's details, in the User Detail interface if the user's customer account had changed then the account was not being updated in the user's basket. Because of this when the user logs in they were still getting pricing based on their former assigned customer account.
In the User Detail interface if the user's customer account code is changed the platform will now correctly update the account assigned to the user's primary basket, or else if an existing basket already exists for the user with the account then it will become the user's primary basket that is used initially when the user logs in.

Functionality Affected: User Detail administration centre interface
Impact: Normal

TOT-3565 - Unable to load details of a product with the Inventory Editor admin centre interface if the product's class field contains an ampersand character

Within the Administration Centre, under the Inventory menu, after clicking on Inventory Editor menu item, upon finding and loading product that contained an ampersand within the the class field, the interface failed to load the details of the product.
In the Inventory Editor interface, when a user tries to load a product that contains an ampersand within the class field data, the interface will now correctly load the product data. The bug fix will ensure that any special character set within any product fields can correctly within the interface.

Functionality Affected: Inventory Editor administration centre interface
Impact: Normal

Improvements

TOT-3527 - Global format hook to allow a customer account's company name to be displayed in all content managed web page areas

Within the Administration Centre, under the Websites interface, when modifying any content managed web page area format, in the Global Hooks list a hook labelled "SES_account_company_name" has been added.
When set within a format it displays the name of the company set for the customer account that is currently assigned to the user. If the user switches customer accounts then this global hook will update to the new customer account.

Functionality Affected: Websites Administration Centre interface
Impact: Normal

TOT-3528 - Sort product attribute values within Product Search Form content managed web page areas

On a content managed web page displaying a Product Attrbute Search From within a Product Search Form (With Search Profiles) area, or on the Trade interface the values for each product attribute now are ensured to be ordered alphabetically ascending.

Functionality Affected: Product Search Form content managed web page areas
Impact: Minor

TOT-3544 - HTTPS Trade Login Webpage

The Trade interface login now supports being run from a secure domain, where the URL is set as https://securedomain.com/login/[projectkey].
All trade interface login's will have a redirect put in place to take the user to secure domain allowing them to login and not have the web browsers report security issues.
Additionally within the Administration Centre, under the Stores menu, in the Interface settings interface a setting labelled "Project Login Webpage" has been added that allows admins to modify the project login web page.

Functionality Affected: Project login webpage
Impact: Major

Bug Fixes

TOT-3522 - Product Flags Excluded From Showing On Page setting on Product Settings Admin Centre interface not showing the previously saved settings

Within the Administration Centre, under the Inventory menu, in the Product Settings interface after the "Product Flags Excluded From Showing On Page" setting had been modified and the Save button clicked, when reloading the interface the selected flags in the setting may have been unselected again.
The Product Settings interface it has been modified to ensure that the Product Flags Excluded From Showing On Page setting correctly selects the flags for the settings. This issue would occur if the flags that were to be selected had an internal ID greater than 9. Now this is no longer a factor.

Functionality Affected: Product Settings Admin Centre interface
Impact: Normal

TOT-3531 - Categories Connector data import not assigning child categories to parent categories if the parent category was not originally created through the Connector data import

When a Categories Connector data import is run and it imports category data, child categories were not getting assigned to parent categories if the parent categories had been previously created within the Administration Centre or Categories Text File data import.
When the platform's Categories Connector data import now runs, for any existing categories previously created within the Administration Centre, the import will now update the existing categories to reference the connected business system by storing the KeyCategoryID. This in effect will convert a "local" category into a "mirrored" linked category. Once this has been done then for child categories imported the import can then find the parent categories that contain the matching KeyProductID data and setup the parent child relationship.

Functionality Affected: Categories Connector data import
Impact: Major

TOT-3532 - Unable to delete attachment and image files within the Edit Website Library admin centre interface when any file contains a single quote character

Within the Administration Centre, under the Websites menu, within the Websites interface, upon clicking on an image or attachment library from the websites tree, if the library had either an image or attachment file assigned to it that had a single quote character within its file name then none of the files in the library were able to be deleted.
The Websites Administration Centre interface so that when clicking on an image or attachment library from the websites tree, if the library had either an image or attachment file assigned to it that had a single quote character within its file name then any files are now allowed to be correctly deleted. Additionally if a user uploads an image file to an image library the file will be shown as having been successfully uploaded.

Functionality Affected: Edit Website Library admin centre interface
Impact: Normal

TOT-3535 - Inventory Settings Admin Centre interface failing to load if Volume Discount Record Format setting contains new line characters

Within the Administration Centre, under the Inventory Menu, within the Products inventory settings interface, no setting form element would load if the "Volume Discount Record Format" setting contained a new line character set within its value.
Within the Products inventory settings interface it now correctly loads the settings when the "Volume Discount Record Format" setting contains a new line character set within its value.

Functionality Affected: Inventory Settings Admin Centre interface
Impact: Normal

TOT-3538 - Deal Results dialog within the Product Deals and Vouchers admin interface fails to load stats when totals are over $1000

Within the Administration Centre, under the Marketing menu, within the Product Deals and Vouchers interface, after clicking on the Results button, in the Deals Results dialog the message "Error loading statistics data." message incorrectly displayed when the results values were over $1000.
Within the Product Deals and Vouchers interface, after clicking on the Results button, in the Deals Results dialog the statistics of a deal now display when any deal totals are over a $1000.

Functionality Affected: Product Deals and Vouchers admin interface
Impact: Normal

TOT-3539 - Salesrep users in Sales Rep Basket Selection and Sales Rep Customer Account Selection content managed web page areas unable to change basket or account in Microsoft Edge browser

On a content managed web page containing either "Sales Rep Basket Selection" or "Sales Rep Customer Account Selection" areas, if the Microsoft Edge browser was used to load the web page, sales rep users after selecting a basket or account to use in the areas, the areas would fail to reload and sales rep users would still be assigned to the same basket or customer account.
The forms in these web page areas have been modified to allow the Microsoft Edge browser to correctly be able to find a use the forms to allow sales rep users to search and switch customer accounts, as well as baskets. Unlike all other browsers Microsoft Edge is very specific on the IDs of forms must be set, which was causing this issue.

Functionality Affected: Sales Rep Basket Selection and Sales Rep Customer Account Selection content managed web page areas
Impact: Normal

TOT-3540 - Related Products spreadsheet CSV file data import failing to import data when product code is greater than 35 characters in length

Wtihin the Administration Centre, under the Data menu, within the Data Imports interface, if a Related Products spreadsheet CSV file data import was run and the CSV file was importing product codes greater than 35 characters in length then the import would not be able to assign a related product to another product.
Now when uploading a spreadsheet CSV file for the Related Products import, the import now correctly allows products to be related to other products when either contains a product code that is up to 50 characters in length, consistent with the Products data imports.

Functionality Affected: Related Products spreadsheet CSV file data import
Impact: Normal

TOT-3542 - Product Search Results Listing content managed web page area ignoring filtering products by attribute values when attribute name contains an ampersand character

On a content managed web page that contains a Product Search Results Listing area, if a Product Attribute search profile was used to update the area and the user was filtering products based on a selected valued assigned to an attribute that had its name contain an ampersand character, then the search results would ignore filtering products on the attribute value.
The Product Search Results Listing area has been modified to correctly handle filtering products within product attribute searches when a product attribute name contains an ampersand character.
Additionally product attributes searches within the Trade interface have also been updated to correctly handle ampersand characters in product attribute names.

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

TOT-3543 - Area displaying empty when users paginate through a Product Search Results Listing web page display products assigned to category when the webpage URL uses URL Routing

On a content managed web page displaying a Product Search Results Listing area, if the area was set to show all products assigned to a given category, and the category was set with a SEO Routed URL for the web page that the area is displaying on, then when a user tried to paginate through the area's products, the area would reload and become empty.
The Product Search Results Listing area has been modified to check that if it is being used to display products assigned to a category, that the paginators of the area correctly reload the next page of products in the category, if the URL of the webpage does not specifically identify itself as a category URL (such as a SEO optimised URL).

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

New Features

TOT-3442 - Category Tree Nested Navigation content managed web page area

On a content managed web page a new area can be added called "Category Tree Nested Navigation" that can list all categories within a specified category tree. Each category can embed its child categories into its format.
This nested structure gets generated for up to 5 tiers of categories within the category tree. Tiers of categories can then be hidden or shown through the use of CSS and Javascript as the user navigates through the category tree structure.
The area will only list categories that are active and the user has permission to see based on the Inventory Permission Role that the user is assigned to.
The area can be configured to show up to 5 levels/tiers of categories, and can be configured to specify which level to show categories from. It is recommended to display the minimum amount of levels of categories in the area to allow the web page to load as fast as possible.

Area Settings
The area contains following settings

• Category Tree: The category tree that categories should be obtained from to display in the area.
• Starting Category Tier: Tier to display categories from.
• Ending Category Tier: Last tier of categories to display within the area.
• Category Tier 1 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the first tier of the category tree.
• Category Tier 2 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the second tier of the category tree.
• Category Tier 3 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the third tier of the category tree.
• Category Tier 4 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the fourth tier of the category tree.
• Category Tier 5 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the fifth tier of the category tree.
• Category Link Web Page: The web page that users can be directed to after clicking on the category link.
• Category Sort Field: The field to sort categories that display within the area on.
• Category Sort Direction: Direction to sort categories by.

• The area contains the following formats to structure the content in the area.
• Category Tree Heading: Format that displays before any categories are listed within the area.
• Category Tree Footer: Format that displays after categories are listed within the area.

TOT-3502 - Category Tree Panel Navigation content managed web page area

On a content managed web page a new area can be added called "Category Tree Panel Navigation" that can list all categories within a specified category tree. For each parent category and its list of child categories the area will generate a panel. These panels can then be dynamically hidden or shown on a web page based on a user navigating through a category tree.
The area will only list categories that are active and the user has permission to see based on the Inventory Permission Role that the user is assigned to.
The area can be configured to show up to 5 levels/tiers of categories, and can be configured to specify which level to show categories from. It is recommended to display the minimum amount of levels of categories in the area to allow the web page to load as fast as possible.

Area Settings
The area contains following settings

• Category Tree: The category tree that categories should be obtained from to display in the area.
• Starting Category Tier: Tier to display categories from.
• Ending Category Tier: Last tier of categories to display within the area.
• Category Tier 1 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the first tier of the category tree.
• Category Tier 2 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the second tier of the category tree.
• Category Tier 3 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the third tier of the category tree.
• Category Tier 4 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the fourth tier of the category tree.
• Category Tier 5 CSS Class: The CSS class that can be embedded within the category record formats for categories that are in the fifth tier of the category tree.
• Category Link Web Page: The web page that users can be directed to after clicking on the category link.
• Category Sort Field: The field to sort categories that display within the area on.
• Category Sort Direction: Direction to sort categories by.

• Category Tree Heading: Format that displays before any category panels are listed within the area.
• Category Tree Footer: Format that displays after category panels are listed within the area.
• Category Parent Record: Format that displays the details of a parent category and contains a hook to embed the list of formatted child categories.
• Category Child Record: Format that displays the details of a single category that is a child of a parent category.

TOT-3503 - Pending Order Detail Content Managed Web Page Area

On a content managed web page there is now the ability to add a new area type called "Pending Order Review". This area allows users to view details of an order that has been submitted to them for review. Additionally can allow the user to modify the details of the order including changing the following:

• Purchase Order Number
• Carrier
• Instructions
• Billing Address
• Delivery Address
• Ordered Product Quantities
• Removing ordered products
• Adding products to order

• Pending Order Detail: Displays details of the order and optionally allowing details to be modified
• Order Products Header: Displays above the list of products ordered
• Pending Order Product Record: Displays the details of each product ordered, and optionally allow product quantities to be changed, or be removed.
• Order Product Deal Record: Displays any deals that have been applied to each ordered product.
• Product Attachment Record: Displays the details of each attachment file associated with each ordered product.
• Order Products Footer: Displays below the list of products ordered