Notice You are now in the documentation for the v3.2.0 version. Current version of the documentation v3.3.0

Product of the day and extended promotions

How to update
List of releases
menu

linkGeneral information

The add-on extends the standard CS-Cart functionality for working with promotions, allowing you to use all modern methods of influencing users of the online store to increase sales.

Main possibilities:

1) Adds the ability to create a detailed page for a promotion (with the action type For catalog) with its own layout, open for search engines and a product list in this promotion and displaying a countdown counter. For each promotion you can edit/display:

  • <h1> tag;
  • Page title (<title> tag);
  • Meta <description> tag;
  • Meta <keywords> tag;
  • Image for promotion page;
  • Image for a list of promotions;
  • Filtering by categories of products from this promotion;
  • Filtering by features of products from this promotion.

2) Adds advanced output for all promotions page with announcements of current promotions and a list of available product combinations (form native CS-Cart Product Variations add-on) (with the ability to customize the number of promotions and combinations displayed on this page in pagination)

3) Adds improvements to the product detailed page with an active promotion (type of promotion For catalog):

  • Block for the announcement with a countdown counter (with the possibility of setting the end point: until The end of the promotion or until The end of the day);
  • The Promotions product tab with all the promotions, that are currently available for the product.

4) Adds improvements to product lists:

  • all products for which there are active promotions (with type For catalog) will be marked with the Promotion label;
  • the ability to display list of active promotions for product in list, when you hover over its cell (for UniTheme2, YoupiTheme themes) in the list of products.

5) Adds extra blocks to the store with presentations of promotions:

  • AB: Promotions — list of promotions with possible content filling types: Manually, Active actions, Ended actions, Expected actions;
  • AB: Product of the day and extended promotions — announcement of a chosen promotion with a counter, promo summary and its products.

6) Adds the possibility of advanced management of the promotion activity schedule: the ability to manage campaign activity periods at the level of each day/hour of the year in a convenient interface.

The addon is compatible with the following versions of CS-Cart:

  • CS-Cart 4.10.x and higher;
  • Multi-Vendor 4.10.x and higher.

The addon is compatible with the following Themes:

  • UniTheme (all versions);
  • UniTheme2 (all versions);
  • Responsive.

linkSupport

General technical support conditions are available at this link (be sure to review these conditions, all solutions from the AlexBranding development team come with limited technical support).

In order to use our technical support, you need to:

  1. Log in with your order owner account on https://cs-cart.alexbranding.com;
  2. Go to the page My Account → Orders;
  3. Find the corresponding order with the problem add-on in the orders list and pass to its details;
  4. Find the “Support” link next to the corresponding add-on name (near you can find Documentation link also) and click on it;
  5. Fill in the data with the problem, provide access to your CS-Cart installation (path to the administration panel, admin mail, admin password + FTP access) and create a ticket (after you will create the ticket, you will receive an e-mail and a special code to track the ticket in the future);
  6. Wait for the specialist answer in accordance with the regulations of the technical support service and the priority of your ticket.

If you didn't receive an answer within the deadlines, according to the chosen ticket priority, send e-mail info@alexbranding.com with the ticket number, for which you did not receive an answer in time, and the team manager will solve the problem in compliance with regulations.

Technical support by telephone calls and direct e-mails is not provided. Any help comes through tickets and helpdesk. Carefully learn documentation and technical support conditions before creating a request.

linkRestrictions and warnings

We recommend to note general restrictions:

  1. All solutions from AlexBranding developers team require pre-installation of the AB: Addons Manager service addon. It is delivered free of charge and is responsible for such services: installation, upgrades, license verifications. Excluding this service addon usage is not possible;
  2. Addon files may have a closed (encoded) part, in which only a license check is located;
  3. The addon will work only on those domains, that are specified in the user's license. If you try to use the solution on CS-Cart installations, whose domains are not included in the license, the addon will be automatically turned off;
  4. Local installation is not possible, so that the addon works on the additional domain (subdomain), enter this domain (subdomain) in the Domain field, when ordering (or write to info@alexbranding.com) - adding technical domains for the developing or for testing is always free.

linkUsage

linkInstallation

After your order has been processed by our manager, it will be transferred to Completed state, you will receive an email to your mailbox with ordered addons license numbers (usually it takes from 15 minutes to 8 hours depending on the day time and week day).

Next, follow the steps below:

  1. Check your mail inbox;
  2. Find a letter with theme Licenses for AlexBranding addons, and open it;
  3. From the link in the letter download special service addon AB: Addons Manager;
  4. Install AB: Addons Manager (standard for CS-Cart installation: Add-ons → Manage add-ons → [+] Upload & install add-on), downloaded on previous step;
  5. Go to the administration panel AB: Addons → AB: Addons Manager;
  6. On the page AB: List of available sets/addons you will see all available for this domain addons;
  7. Click Install button to install addon. During installation the system will automatically define the latest version compatible with your version of the CS-Cart platform;
  8. Addon is installed, continue to work with the documentation (configure the addon and check its functionality).

You can also install the addon with a standard installation for CS-Cart. To do this, download the appropriate archive with an addon version compatible with your version of the CS-Cart platform.
Go to the website cs-cart.alexbranding.com, log in under the account of the order holder and go to the page My Profile → Orders → Relevant Order, go to details and you will see a list of available archives for the ordered addon. Download the version (archive) you need and make the installation (standard for CS-Cart installation: Add-ons → Manage add-ons → [+] Upload & install add-on).

Service addon AB: Addons Manager must be installed and have Active status.

The add-on allows creating the promotions which are already filled with data in the automatic mode. They will be by default switched and displayed on the storefront.

For demo data adding, go to the page Administration panel → AB: Add-ons → AB: Product of the day and extended promotions → Demo data and click button Add.

Demo data adding sequence

Result of demo data adding will be next

linkSettings

For access to the add-on settings go to the page Administration panel → Add-ons → Manage add-ons and in the list click the add-on name, the pull-down window with its settings will be opened.

Addon settings window

Promotions for a catalog without established conditions and/or bonuses do not apply to products, which means that their announcements are not displayed in lists, product detailed pages. If you need to create a promotion for the catalog without a discount, you need to add a 0% bonus

linkHow to update

To have possibility to update an addon, you must have an active subscription period for addon license.

AB: Addons Manager will notify you about available updates (you will see an indicator of new alerts). The recommended way is to update via the CS-Cart Upgrade center (a regular procedure of the platform). This method will allow lossless configuration of the transition to the new addon version, that is guaranteed to be compatible with your CS-Cart platform version.

Before updating, always make a full database and your store files backup (we recommend backing up using server or hosting tools).

To make updates procedure:

  1. Go to the Administration panel → Administration → Upgrade center;
  2. Find the appropriate update among the available updates and click the Update button;
  3. Follow all the instructions, that will be shown during the upgrade procedure;
  4. Clear CS-Cart cache and start using new addon version.

If you have an earlier version of the addon (without the Upgrade center support)

linkList of releases

Subscribe to our Telegram-channel to get info about new releases.

v3.2.0 from 20 March 2020

Attention!
If you use the UniTheme2 theme, then to update the add-on you first need to update the theme to version v4.11.3.b and higher (the release contains changes that are not compatible with earlier versions of the theme).


New functionality:
[+] Multivendor: Added support of privileges for vendors;
[+] Added the page "AB: Addons → AB: Product of the day and extended promotions → Layouts", which is designed for recovery of layouts.

Functionality changes:
[~] Refreshed the users’ privileges.
[~] In the “Block settings” tab the settings “Thumbnail width in scroller”, “Outside navigation” and “Show additional products images” were removed from the “AB: Deal of the day” block”;
[~] Unitheme2: Two products were displayed in the “AB: Deal of the day” block on the mobile devices. Changed to one product;
[~] Unitheme2: On the product page was changed the style of the informational block about promotions and improved its adaptivity.
[~] Unitheme2: In all products lists, “Promotion” label was moved from price block to the beginning of the product title and changed its style;
[~] Responsive: Changed the style of “AB: Deal of the day” block;
[~] Responsive: On the product page the style of the informational block about promotion was changed;
[~] Responsive: Changed the style of countdown counter that is used at promotions with the expiration date;
[~] Improved the adaptivity of the "AB: Promotions" block.

Bug fixes:
[!] On the product page when hover in the question mark in the informational block about promotion the link was moving to the promotion page if the short description was empty in the promotion. Fixed;
[!] In the promotions list the images were compressed in reference to the block size. It caused to decrease of image quality. Fixed;
[!] In the promotions block the quantity of the expired days was displayed incorrect for the promotions that has already been expired or scheduled promotions. Fixed;
[!] User's changes were not saved in the layouts when the add-on was reinstalled. Fixed;
[!] Responsive: Buttons "View" and "Add to Cart" in the "Deal of the day" block were displayed in correct. Fixed.

v3.1.3 from 02 December 2019

Functionality changes:
[~] Changed design of expired promotions pages for YoupiTheme and Responsive.

Bug fixes:
[!] On promotions list page, when checked setting "Displaying applied promotions in the product lists", was displayed current promotion. Fixed.
[!] In the Promotions product tab, product combinations with checked setting "Display in promotions" were displayed. Fixed.
[!] In UniTheme2 and YoupiTheme in CS-Cart 4.11.1, when checked setting "Displaying applied promotions in the product lists", in product lists applied promotions weren't displayed (only a frame). Fixed.
[!] In UniTheme2 on expired promotion page greyfilter was dropped from image on hover. Fixed.

v3.1.2 from 05 November 2019

Bug fixes:
[!] On the promotions list page, if promotion hasn't expiration date then it's title fitted closely to image, on smartphones. Fixed.
[!] Fixed issues of style compatibility with UniTheme 2 version 4.10.4.b.
[!] In the Responsive theme, on a promotion page, by default was hidden description, image and countdown timer. Fixed.
[!] In the Responsive theme, in Grid product list, when addon setting "Displaying applied promotions in the product lists" is active, block with applied promotions was misplaced. Fixed.
[!] In the UniTheme 2 theme, on a promotion page, for mobile devices products filter moved under the products block. Fixed.

v3.1.1 from 08 October 2019

Functionality changes:
[~] In the "Product of the day" block link "Active promotions" execution is changed.

Bug fixes:
[!] On the promotion page filter by categories slowed page loading (independent of settings). Fixed.

v3.1.0 from 27 September 2019

Functionality changes:
[~] Adaptivity of the "Product of the day" block elements in the UniTheme2 template on mobile devices is improved.
[~] Adaptivity of the "Product of the day" block is improved.

Bug fixes:
[!] An error occurred while going to the promotion editing page on new language. Fixed;
[!] In the promotions schedule work, if it ended on the last day of the month and didn't work in the next month, periods were not formed correctly. Fixed;
[!] In the "AB: Promotions" block settings displayed untranslated language variable "_sort_order". Fixed;
[!] In the Responsive "AB: Product of the day and extended promotions" block on mobile devices was not adapted. Fixed;
[!] In the administration panel at editing "AB: Promotion schedule" columns were different sizes. Fixed;
[!] In the Responsive elements trimmed from below in "Promotions" block on mobile devices. Fixed;
[!] The direction of the countdown counter in the RTL version was not displayed correctly. Fixed;
[!] On the promotion detailed page, there was no padding between the image and the name of the promotion on the phone. Fixed.

v3.0.0 from 06 September 2019

New functionality:
[+] Action option "Hide products block" is added;
[+] Schedule mechanism for promotions is added.

Bug fixes:
[!] In blocks with promotions time counter on RTL-pages designations "seconds", "minutes", "days" were moved down. Fixed;
[!] On the mobile devices in the YoupiTheme for action with term, less than day, time counter is displayed not by the center. Fixed;
[!] When viewing the catalog promotion with an empty condition by products (rule is added, but without products) — there was a mistake. Fixed;
[!] In the "Product of the day" block on the homepage, if the product didn't have image, stub "no-image" is displayed with incorrect sizes. Fixed;
[!] In the "Product of the day" block on the homepage, a smooth shader at the block with products end was displayed only on the right. Fixed.

v2.0.4 from 08 August 2019

Feature additions:
[+] In the promotions block, on promotions list page and in the promotion card — image lazy load for UniTheme2 and YoupiTheme is added;
[+] In the "Block settings" of the "Product of the day" block option "Hide add to cart button" is added.

v2.0.3 from 04 Jule 2019

Bug fixes:
[!] Fixed compatibility with YoupiTheme v4.10.;
[!] Fixed compatibility with UniTheme2 v4.10.
;
[!] In the "AB: Product of the day and extended promotions" block for UniTheme2, the "Quick view" button for Phones has been removed;

v2.0.2 from 10 June 2019

Feature additions:
[+] Added compatibility with YoupiTheme v4.10.*;

Bug fixes:
[!] Fixed compatibility with UniTheme2 on product page (if the product has more than 1 promo);
[!] Fixed the counter layout bug on older versions of ios;

v2.0.1 from 07 June 2019

Feature additions:
[+] Added preview link on the promotion editing page;
[+] Added link to addon settings into the site menu;
[+] Added connector for further updates;
[+] Added products filters support on the promotion page;
[+] Added settings "Show expired promotions", "Show awaited promotions";
[+] Added promotions block fillings "Expired promotions", "Awaited promotions";
[+] Added integration with "AB: Tag noindex for technical pages" addon (versions 1.10.0 and higher);
[+] Added demo-data import;

Bug fixes:
[!] changed promotions list page and promotion page templates;
[!] Fixed load-more-combinations button text on the promotions list page;
[!] Fixed bug with displaying when two counters on the page;

v1.23 from 24 January 2019

[+] Added hook “ab__deal_of_the_day:detailed_content”;
[!] Fixed bug with displaying link to hidden promotion;

v1.22.3 from 21 January 2019

[!] Fixed output bugs in rtl version;
[!] Fixed js error for browsers that do not support the es6 standard;
[!] Fixed a bug with subcategory products in parent category promotion;
[!] Fixed a bug with the dependence of the products blocks on the promotion page of the filter by category;

v1.22 from 13 December 2018

[+] Added displaying of promotions in product lists for the YoupiTheme;
[!] Fixed bug with loading promotions by the "Show more N products" button;
[~] Improved the adaptability of the "Product of the Day" block for the YoupiTheme. The countdown counter for the YoupiTheme is updated;

v1.21 from 26 November 2018

[!] Fixed a bug with the display of promotion products when using the operator "any" in conditions;
[!] Fixed a bug with the filtering active combinations on the promotions list page by date;

v1.20 from 15 November 2018

[+] Added displaying of promotions in product lists for Responsive, Unitheme and Unitheme2;

v1.19 from 12 September 2018

[!] Fixed an error for promotions with a lot of products;

v1.18 from 06 September 2018

[~] Optimization of the request for products by promotion;

v1.17 from 30 June 2018

[!] Fixed compatibility for multi-store site;
[!] Fixed sorting of expired promotions on promotions list page;

v1.16 from 08 June 2018

[+] Added compatibility with cs-cart 4.8.x;
[+] Added output of expired promotions on promotions list page (sorted by to_date);

v1.15 from 24 April 2018

[+] Added integration with the addon "AB: Advanced sitemap";

v1.14 from 14 December 2017

[+] Added compatibility with hooks in cs-cart 4.7.x;
[+] Added setting "Highlight promotion days left";
[~] If less than a day left, then instead of the number of days, "Only today";
[~] The number of columns in the products grid on the promotion page is depends on the setting of the site "Number of columns in the product list";
[!] Fixed bug with combinations on the promotions list page when products tracking is on;

v1.13 from 24 November 2017

[+] Added setting "Combinations per step";
[+] Added setting "Promotions per page";
[!] Fixed bug in widget-mode;

v1.12 from 26 September 2017

[+] Added users permissions;
[!] Fixed multilanguage counter for responsive theme;

v1.11 from 16 August 2017

[+] Added a setting "Show additional products images" of block "AB: Deal of the day";
[+] Added multilanguage support for counter;
[~] Changed view of expired promotions pages;

v1.10 from 13 Jule 2017

[~] Fixed bug with sorting by specified positions in promotions block;
[~] Fixed bug with displaying expired promotions;

v1.9 from 01 June 2017

[!] Fixed styles for new version v1.5 of Unitheme;

v1.8 from 23 May 2017

[~] Fixed conflict with addon buy_together;

v1.7 from 03 May 2017

[~] Improved layout;

v1.6 from 03 May 2017

[+] Added the ability to create blocks with promotions;
[+] Added product tab with active promotions (if product has more then one promotion);
[~] Setting "Promotion ID" moved from addon settings to block settings;
[~] All products in categories marks with label Promotion;
[~] In product page displaying first active promotion;
[!] Fixed bugs;

v1.5 from 27 March 2017

[+] Added compatibility with CS-Cart 4.5.1.SP1;

v1.4 from 16 March 2017

[!] Fixed bugs validator.w3.org;

v1.3 from 22 December 2016

[+] Added compatibility with the UniTheme;

v1.2.1 from 30 November 2016

[~] Limited products in block;

v1.0 from 21 November 2016