Discount Center For WHMCS

About Discount Center For WHMCS

Discount Center For WHMCS module allows you to set up discounts for products ordered in a specified combination or quantity. It will let you define discount rules, validity periods, and limitations as well as exclude certain clients from being offered price cuts or promote new customers only! After integrating with Product Cross-Selling For WHMCS, your clients will get the option to track the most appealing discounts among individual product recommendations. Achieve unprecedented sales success by leveraging the Discount Center For WHMCS and the Lagom One Step Order Form For WHMCS in tandem.

• Admin Area:

✔ Create Multiple Discounts For Products, Domains And Product Addons

✔ Create Multiple Quantity Discounts With Thresholds For Products, Product Groups, Domains And Product Addons

✔ Create Early Payment Discounts

✔ Configure Module Settings:

✔ Define Length Of New Client Status

✔ Auto-Apply Newly Created Discounts

✔ Select Order Form Type

✔ Enable Order Notes

✔ Hide Original Prices

✔ Enable Product Upgrade/Downgrade Discounts

✔ View Discount Summary

✔ View Discounts Logs

• Client Area:

✔ View Before And After Discount Item Prices

✔ Build Your Own Discounted Product Bundle

• Discounts:

✔ Define Items To Apply Discount To:

✔ Offered Items In Store

✔ Required Items In Client Shopping Cart

✔ Active Items In Client Account

✔ Required Items' Billing Cycles

✔ Define Discounts For Chosen Items Per Billing Cycle:

✔ Percentage

✔ Fixed Amount

✔ Define Clients To Whom Discount Should Be Applied:

✔ All Clients And Guests

✔ New Clients

✔ Chosen Clients And Client Groups

✔ Define If Discount Should Be Applied One Time Or Recurring

✔ Define Time Period For Recurring Discount

✔ Define Discount Validity Period

✔ Define If Discount Should Be Applied When Product Bundles Are Enabled

✔ Define Discounts Limitations:

✔ Total Number Of Products, Product Addons And Domains

✔ Maximum Number Of Items In Cart

✔ Restrict Time Period To Apply Discount After Single Usage

• Quantity Discounts:

✔ Define Items To Apply Discount To:

✔ Offered Items In Store

✔ Required Items In Client Shopping Cart

✔ Active Items In Client Account

✔ Required Items' Billing Cycles

✔ Define Discounts For Chosen Items Per Billing Cycle:

✔ Percentage

✔ Fixed Amount

✔ Define Discount Type:

✔ Percentage

✔ Fixed Amount

✔ Define Items Required To Be In Shopping Cart To Apply Discount

✔ Define Items Required To Be Owned By Client To Apply Discount

✔ Define Multiple Promotion Thresholds And Discount Values

✔ Define Items To Be Summed Up And Compared With Thresholds

✔ Choose Type Of Discount Application:

✔ All Specified Items

✔ More Expensive Than Specified Value

✔ Less Expensive Than Specified Value

✔ Chosen Products/Addons/Domains

✔ Number Of Active Services

✔ Choose Clients To Which Discount Should Be Applied:

✔ All Clients And Guests

✔ New Clients

✔ Chosen Clients And Client Groups

✔ Define If Discount Is Of One Time Or Recurring Type

✔ Define Time Period For Recurring Discount

✔ Define If Products With 'Allow Multiple Quantities' Should Be Supported

✔ Define Whether To Count User Owned Services

✔ Define If Discount Should Be Applied Along With Promotion Code

✔ Define Discount Validity Period

✔ Define If Discount Should Be Applied When Product Bundles Are Enabled

✔ Define Discounts Limitations:

✔ Total Number Of Products, Product Addons And Domains

✔ Maximum Number Of Items In Cart

✔ Restrict Time Period To Apply Discount After Single Usage

• Early Payment Discounts:

✔ Define Number Of Days Of Discount Validity

✔ Define Items To Apply Discount To

✔ Define Discounts For Chosen Items Per Billing Cycle

✔ Define Email Notifications:

✔ On Invoice Creation

✔ On Discount Expiration

✔ Discount Cancelation Reminders With Defined Number Of Days Before Expiration

• General Info:

✔ Integrated With Lagom One Step Order Form For WHMCS - Give Clients Instant Preview Of Discounted Prices While Completing The Order

✔ Integrated With Product Cross-Selling For WHMCS - View Discounts Applied To Related And Recommended Products

✔ Recognizes Identity Of Not Logged In Client To Assign Discount Accordingly

✔ Updates Amount On Unpaid Invoices Dynamically When 'Active Services Quantity' Discount Is Used

✔ Supports Default And Custom Order Forms

✔ Multi-Language Support

✔ Supports PHP 8.2 Back To PHP 7.4

✔ Supports WHMCS Themes "Six", "Twenty-One" And "Lagom WHMCS Client Theme"

✔ Supports WHMCS V8.11 Back To WHMCS V8.8

✔ Requires ionCube Loader V13 Or Later

✔ Easy Module Upgrade To Open Source Version

Installation

This tutorial will show you how to successfully install and configure Discount Center For WHMCS. We will guide you step by step through the whole installation and configuration process.

1. Log in to our client area and download the module.

2. In the downloaded file you might find one or two packages that support different PHP versions. In the most recent versions of the module, you will find only one package that supports PHP 7.4 and later.

Previous updates of the module may contain two packages dedicated to various PHP versions. The first one that supports PHP 5.6 up to PHP 7.3, and the second one addressed to PHP 7.4 up to PHP 8.1. Note: Keep in mind that PHP versions 5.6 up to 7.3 are no longer officially supported and their security issues are not fixed or released any more. Find more info here.

Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' → 'System' → 'PHP Info'.

3. Extract the package and upload its content into the main WHMCS directory. The content of the package to upload should look like this.

4. When you install Discount Center For WHMCS for the first time you have to rename the 'license_RENAME.php' file. This file is located in 'modules/addons/discount_center/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

5. In order to configure your license key, you have to edit the previously renamed 'license.php' file. Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

6. Now you have to activate the module in your WHMCS system. Log in to your WHMCS admin area. Go to 'System Settings' → 'Addon Modules'. Afterward, find 'Discount Center' and press the 'Activate' button.

7. In the next step you need to permit access to this module. To do so, click on the 'Configure' button, check required group of administrators and press 'Save Changes'.

8. Finally, set up the cron command line provided below and define its frequency (once a day interval is recommended). php -q /yourWHMCS/modules/addons/DiscountCenter/cron/cron.php This will allow to enable sending email notifications, reminders and correct functioning of early payment discounts.

9. You have just successfully installed Discount Center For WHMCS! You can access your module under 'Addons' → 'Discount Center'.

Configuration and Management

Discount Center For WHMCS has been created to help you vary your offer with personalized discounts that can be applied to chosen products and/or clients. Configure advanced activation rules to make your offer the most attractive and competitive.

Configure Discounts

In order to configure your module properly, proceed to 'Addons' → 'Discount Center' and start with setting up rules to offer attractive prices to your clients.

Standard Discounts

To start, move to the 'Discounts' section. There, press the 'Add New' button.

You are moved to the 'General' information page of the currently composed discount. Here you have to fill out the form to configure the rule. Select the box to enable the discount, it will be put into practice immediately on creation. You may also configure this option under 'Settings'. Name the discount and, the most importantly, declare promotional and required products.

'Apply Promotion To' - there can be products from your offer, addons and domains. According to a specified rule, pointed here items' price will be adequately changed. Note: You must select at least one promotional product to be allowed to move to the next step.

Below, you can specify a list of 'Products Required In Cart' that a client must also have in the cart to be entitled to get the discount for promotional products. Among them, there can be again products, addons and domains. In case a client does not have all of the required products in the cart, the discount won't be applied. Surely, you may leave these parts blank if you do not demand any other products to be purchased at the time. Additionally, you may add any items into 'Required Active Products' - a client must already own and have them active. Only then the discount can be applied. All of the chosen here products are required. Please note that only active products are taken into consideration.

In the last part you may specify the required billing periods. The discount will be applied only if the items' billing cycle requirement is met. You may specify the required billing cycles for items in the cart. Every item in the cart must have one of the pointed here billing cycles. If an item in the cart is of a different billing cycle than pointed out here, the discount will not be applied. Leave this section blank if the billing cycle is not a demand for you. Press 'Next' to continue.

Product Discounts

Under 'Product Discounts' you have to set up discount rates for every product's pricing. To do so press the plus button as marked on the screen.

Enter the discount value and select its type. It can be either percentage that will be counted from the price or a fixed amount by which the final price and/or setup fee will be reduced. In case you are using more than one currency, you may quickly copy the rule to all available currencies to save the time. Press 'Next' when ready.

Activation Rules

Next, you are moved to activation rules. Here you may decide which of your clients should be entitled to purchase products with a discount. You may grant it to: All - all of your clients and guests Offer it to new clients only. Move to 'Addons' → 'Discount Center' → 'Settings' to define which of your clients shall be considered 'new'. Chosen clients only: enumerate specific clients or enter clients group name. All clients from this group will be given a discount. Recurring Discounts - enable discount for recurring orders. If you do not select this option, then discount will be applied only once with the first payment. If this option is enabled, you also have to define the number of months that the discount will be applied to the invoice. You can also provide 0 value for lifetime discount. Finally, you may define the Validity Period. If selected, you have to point the starting and ending date of the promotion. This option is especially helpful when setting up sales like Cyber Monday or Black Friday. It is usually clearly stated how long such sale shall last.

Limitation Rules

This section allows limiting the number of applied discounts per client, depending on the criteria defined here: Global Limits - responsible for limiting the overall number of products, addons, and domains that can receive a discount - includes also already ordered products with "active", "pending" and "suspended" status Enter the number that will be the top limit for the referred items Discount Usages - limit the number of discount usages in the established here time period. The time period when the discount will be unavailable after its single usage by the client Discounted Items in Cart - define the maximum number per item in the cart that can receive a discount (includes only items in the cart, the already ordered items are not included in contrast to the "Global Limits" feature) Press 'Save Changes' to confirm the creation of the new discount.

All available discounts are now visible, with their name, status and number of assigned products/domains/addons. You may always change the status to disabled/enabled, check starting and ending dates of the promotion and edit the discount or delete it. Use action buttons to do so.

Quantity Discounts

'Quantity Discounts' - offer different price depending on the number of products added into the cart. Press 'Add New' to begin.

In the 'General' section you have to name a new discount rule, enable (if you want to apply it immediately on its creation) and select required client products. Specified Products In Cart - select products/domains/addons which you expect to be in the cart. The sum of these items is compared with the set up later on thresholds to apply an adequate discount. Select the Discount Type - it can be either Percentage that will be counted from the price or a Fixed Amount by which the final price and/or setup fee will be reduced. Required Active Products - the discount can be applied only if a client already owns pointed here items. Please note that the products must be active! Required Billing Cycles - the discount will be applied only if the items' billing cycle requirement is met. Specify the required billing cycles for items in the cart. Important: Please note that items added into these fields are required.

Under 'Quantity Discount' you have to decide when the discount will be applicable. If Price Is Higher Than - declare a price limit and only more expensive of the products than the limit here will be charged with the discount If Price Is Lower Than - declare a maximum price limit and only cheaper products than the limit declared here will be charged with the discount

Promotional Products - list items that the discount can be applied to (products/addons/domains)

All Specified Products - every product that is on the list of specified (see previous point) will be charged with the discount

In this section you also have to set up 'Thresholds'. These are the minimum numbers of products, that must fulfill the above application rule, and that must be in the cart of a single order. Specify a percentage discount for the threshold, you can set up more than one. Press the '+' button to add more possibilities.

Active Services Quantity - the discount takes account of the total number of ordered products and active services already owned by a client. The services have to be added in the 'Specified Products In Cart' section. The 'Active Services Quantity' discount may apply to: the existing services of a recurring type - to its next billing cycle, the newly ordered services - to the first and subsequent invoices (if applicable).

In 'Thresholds' you set up the minimum number of client's active services which, together with products included in a new order, are taken into account by this application type. Specify a percentage value for each discount threshold, you can set up as many of them as you need by pressing the '+' button. For example: The administrator sets a 10% discount valid when a number of active products amounts to 5. When a client who already owns 3 active services puts in a new order, only 2 additional products need to be added to the cart to activate this discount. In case there are multiple discount levels configured, the module will adjust the discount to the highest tier possible. For instance: The administrator formulates two rules: a 10% discount available when a number of active products amounts to 5 and a 15% discount valid if a quantity of active services equals 8. When a client owns 3 active services and purchases 5 new products, the module will switch the discount from 10% to 15%. What is more, if any of active services is terminated and a current number of active services is lower than the one set for the discount, the module removes the discount from all active products. However, if there are multiple discount thresholds configured, then the module will downgrade the discount applied to the lower tier.

The process of increasing and decreasing of the discount levels also apply to unpaid invoices. If the customer has an unpaid invoice and the amount of active services has changed in the meantime, the amount on unpaid invoice will also be updated accordingly.

When ready, press 'Next' to continue.

Next, you are moved to 'Activation Rules'. Here, you may decide which of your clients the discount should be entitled to purchase products with a discount. You may grant it to all of your clients and guests, offer it to new clients only or manually select desired usernames. It is also possible to enter client groups names here and offer discounts to bundles of clients. Other options: 'Recurring Discounts' - discount is applied to following payments as well 'Multiple Quantity' - apply the discount to more than one product (Important: Please do not use this option if you aim to apply limits on your discounts! Items with multiple quantities will not be taken into consideration when calculating the limits) 'Count User Services' - include user services when counting the total number of products to apply a discount (both active and inactive services are counted, their status is not taken into consideration) 'Promotion Code' - decide if you want to disable the discount if a promotion code is used 'Validity Period' - set up time frames 'Bundle' - toggle to disable the discount if product bundles are used You can read more about these options and their functions here

Finally you may set up the limits on the number of applied discounts per client, depending on the criteria defined here: Global Limits - responsible for limiting the overall number of products, addons, and domains that can receive a discount - includes also already ordered products with "active", "pending" and "suspended" status Enter the number that will be the top limit for the referred items Discount Usages - limit the number of discount usages in the established here time period. The time period when the discount will be unavailable after its single usage by the client Discounted Items in Cart - define the maximum number per item in the cart that can receive a discount (includes only items in the cart, the already ordered items are not included in contrast to the "Global Limits" feature) Press 'Save Changes' to confirm the creation of the new discount.

All available quantity discounts are now visible, with their name and status. You may always change the status to disabled/enabled, edit the discount or delete it. Use action buttons marked on the screen below to do so.

Early Payment Discounts

'Early Payment Discounts' option allows creating and applying discounts to selected services when they are paid within defined time range. All you need to do is specify the number of days that the discount will be active since the invoice has been created. Look below to see how to configure such a discount exactly.

First of all, like in case of 'Discounts' and 'Quantity Discount' decide whether to enable it on creation and enter the early discount name. Next, you must enter a number of days that the early discount will remain active since the moment the invoice has been created. This is an obligatory field. Underneath, there are 'Products', 'Addons' and 'Domains' fields - select which of the services will allow early payments with the discount. Note: Only recurring services are supported and allowed to choose. Important: Early payment's discount for recurring invoices is calculated based on the product pricing, not the service recurring amount.

In 'Product Discounts' tab you can define the discount fixed amount or percentage for selected payments and currencies.

'Email Notifications' - set up reminders for clients to assure they are aware of the early payment benefits.

Early Discount Notification - select the email templates from available that will be sent to clients when the invoice has been created. The other notification is sent on the day the discount expires.

Early Discount Cancellation Reminders - select an email template that will be sent to clients just to remind about the early payment discount. Define the number of days before the cancellation date - it will be sent that day. You may specify here more than just one day. Remember to save the changes when the early payment discount configuration is ready.

The just added Early Payment Discount is now visible on the list. As in case of other discounts types, you may enable/disable it any moment, edit and delete.

View of the discounted items on an invoice. Please note that the early payment discounts are presented with separate minus values.

Email Templates

There are three prepared custom email templates with basic information on the discounts: Discount Center - Early Payment Discount Created Discount Center - Early Payment Discount Canceled Discount Center - Early Payment Discount Notification They are included in the module, once you install or update the module, they will appear in the System Settings → Email Templates → Invoice Messages section.

Open an email template to see information included in the message.

You may edit the message, list of supported be the module merge fields: {$client_name} {$signature} {$invoice_num} {$invoice_date_created} {$invoice_date_due {$invoice_total} {$invoice_balance} {$invoice_html_contents} {$invoice_link} {$earlyPayment.name} {$earlyPayment.due_date} {$earlyPayment.period}

This is how an exemplary notification sent to a client may look like.

Additional Options

Settings

Under the 'Settings' tab you must define a few useful options. New Client Status - Number Of Days - set up the number of days a client will be considered 'New'. Such information is necessary when you select 'New - give promotion to new clients only' option as 'Activation Rule' for any of your set up discounts. If you enter for example 14, then, if this option is selected for any of the discounts, clients with accounts not older than 14 days can have the discount applied. Note that providing 0 value will make discount applicable only for unregistered clients. Hide Guide here if you are already familiar with its content or unselect to read it again. Autoapply Discounts - if checked, all newly created discounts will be enabled. You may change the status of a single discount manually. Order Form - define an order form if you are using a custom one. Order Note - decide if information about discounts should be saved in order note. Hide Original Prices - select if you want only the final (discounted) prices to be visible for clients. Upgrade/Downgrade Orders - select if you want to add discounts to products that are being upgraded or downgraded

Integration Code

A list of available variables that can be inserted into the order form template. These are: {$dc_product_price} - Variable that allows a full product price to be displayed {$dc_product_discount_price} - Variable displaying a discount product price {$dc_product_setup_price} - Variable displaying a full setup price {$dc_product_setup_discount_price} - Variable displaying a discount setup price {$dc_addon_prices[$addon.name]} - Variable that allows a full addon price to be visible {$dc_total_discount_price} - Variable displaying total discount product price {$dc_recurring_price} - Variable displaying full product recurring price {$dc_hide_crossed_pricing} - Variable determining whether prices are to be crossed Open the order form you are currently using, for example 'Modern', find 'ordersummary.tpl' file and enter the above variables as shown below: <tr><td>{$producttotals.productinfo.name}</td><td class="text-right"> VARIABLE ONE {$producttotals.pricing.baseprice}</td></tr> <tr><td>+ {$addon.name}</td><td class="text-right"> VARIABLE FIVE </span>{/if} {$addon.recurring}</td></tr> Please note that the below screen is just an example of variable usage, you may simply enter pure variable without any styles or change them according to your needs. Be careful when you change the code snippets. If you are not sure how to change it, then consult it firstly with a professional.

If entered correctly, your order summary will include the discounts applied, with the new price counted and the final price visible in the order summary.

Logs

In the 'Logs' tab there are enumerated information on any orders that discounts were applied, such as: invoice number, discount ID and value.

Clear all the entries or delete only some of them. Use buttons marked on the screen above.

Dashboard

On the dashboard you can find 'Summary' table with detailed statistics on applied discounts with the most frequently used ones and the highest amount granted. Next to 'Summary' table, a chart can be found with number of discounts applied per specified period of time. You can display the chart per week, month or a year.

Documentation

The very last tab 'Documentation' once clicked will redirect you to the article you are currently reading!

Product Cross-Selling For WHMCS Integration

Seamless integration with the Product Cross-Selling For WHMCS enables intelligent expansion of your personalized product offerings, by presenting individualized product recommendations with enticing discounts. Please follow the module's official documentation to learn everything you need to know about the scope of possibilities the module may give you. Meanwhile, look at the picture below and see the client area view with both modules active and configured. Pay attention to the varied "Related Items" and "Recommended Items" sections, which are much-upgraded thanks to the module. Your clients may now see suggested products and services based on the careful analysis of their preferences and items already added to the cart.

Tips

1. If a client adds to the cart a product that can have more than one discount applied, then a higher discount is applied on the invoice.

2. If the 'Active Services Quantity' discount is used and statuses of services are switched manually without using 'Terminate' functionality (this action may be performed either manually or automatically by the system), the module will not take that action into account and thus will not remove the discount.

3. The Discount Center module supports the WHMCS "Monthly Pricing Breakedown" option which allows showing discounts for quarterly, semi-annual, annual, and biennial prices in the equivalent monthly price. You can read more about this option here.

4. The Discount Center module supports the WHMCS domain pricing and shows discounted prices of selected TLDs (domain registration and transfer only). You can read more about this option here.

Update Instructions

Essential guidance through the process of updating the module is offered here. Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues.

Before upgrading your WHMCS to version 8.9.0, it is strongly recommended to perform the following steps: Execute the following commands, for instance, via phpMyAdmin; ALTER TABLE `disccent_EarlyPaymentRecurring` DROP FOREIGN KEY `disccent_EarlyPaymentRecurring_ibfk_1`; ALTER TABLE `disccent_EarlyPaymentRecurring` DROP FOREIGN KEY `disccent_EarlyPaymentRecurring_ibfk_2`; ALTER TABLE `disccent_EarlyPaymentRecurring` DROP FOREIGN KEY `disccent_EarlyPaymentRecurring_ibfk_3`; ALTER TABLE `disccent_EarlyPaymentRecurring` DROP FOREIGN KEY `disccent_EarlyPaymentRecurring_ibfk_4`; Next, add the UNSIGNED attribute to the invoice_id column in the disccent_EarlyPaymentRecurring table. Finally, execute these commands after upgrading to version 8.9.0: ALTER TABLE `disccent_EarlyPaymentRecurring` ADD FOREIGN KEY (invoice_id) REFERENCES tblinvoices(id) ON DELETE CASCADE; ALTER TABLE `disccent_EarlyPaymentRecurring` ADD FOREIGN KEY (invoice_item_id) REFERENCES tblinvoiceitems(id) ON DELETE CASCADE; ALTER TABLE `disccent_EarlyPaymentRecurring` ADD FOREIGN KEY (early_payment_id) REFERENCES disccent_EarlyPayment(id) ON DELETE CASCADE; ALTER TABLE `disccent_EarlyPaymentRecurring` ADD FOREIGN KEY (early_payment_item_id) REFERENCES disccent_EarlyPaymentItems(id) ON DELETE CASCADE;

Upgrade Guide

Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability? There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment. Opt for the Open Source version of your Discount Center For WHMCS module to unlock these benefits. Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied. Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.

2. The module is currently not compatible with: Multibrand For WHMCS Payment Gateway Charges For WHMCS Resellers Center For WHMCS - Integration issues occur because each of the modules affects the product price in a different manner. Product Free Trial Manager For WHMCS - Discounted prices are not displayed on product tiles in the client area when the Product Free Trial Manager for WHMCS module is active.

3. Currently, the configured discount limits are not calculated for product items with multiple quantities. Please do not impose "Limitations" on products with the "Multiple Quantity" option enabled.