Personal tools
Namespaces

Variants
Actions

Multibrand 1.X For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
Line 232: Line 232:
 
====General====
 
====General====
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|General tab contains cofiguration of the brand.<br />
+
|style="padding: 10px 0px 15px 15px;"|General tab contains configuration of the brand.<br />
 
You can modify your brand at any time, simply alter wanted parameters and press '' 'Save Changes' ''.
 
You can modify your brand at any time, simply alter wanted parameters and press '' 'Save Changes' ''.
 
|}
 
|}
Line 241: Line 241:
 
{|
 
{|
 
|style="padding: 10px 0px 15px 15px;"|This tab allows you to assign products configured in your system to the brand.<br />
 
|style="padding: 10px 0px 15px 15px;"|This tab allows you to assign products configured in your system to the brand.<br />
''Note: Product can be assigned to mutiple brands in the same time.''
+
''Note: Product can be assigned to multiple brands in the same time.''
 
|}
 
|}
 
{|
 
{|
Line 248: Line 248:
 
====Ticket Department====
 
====Ticket Department====
 
{|
 
{|
|style="padding: 10px 0px 20px 15px;"|Here you can choose department available on the brand.
+
|style="padding: 10px 0px 20px 15px;"|Here you can choose ticket departments available in the brand.
 
|}
 
|}
 
{|
 
{|
Line 286: Line 286:
 
====Back To Brands Management====
 
====Back To Brands Management====
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|Alternatively, you can edit brand values visible at the '' 'Brands Management' '' tab by pressing on them.<br />
+
|style="padding: 10px 0px 15px 15px;"|Alternatively, you can edit brand values visible in '' 'Brands Management' '' tab by pressing on them.<br />
 
Choose/type desired value and confirm changes.
 
Choose/type desired value and confirm changes.
 
|}
 
|}
Line 293: Line 293:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|Each brand can be disabled through pressing '' 'Published' '' (red) or set up as default through clicking on '' 'Default' '' (blue) button.<br />
+
|style="padding: 0px 0px 15px 15px;"|Each brand can be disabled/enabled through pressing '' 'Published'/'Unpublished' '' (red) or set up as default through clicking on '' 'Default' '' (blue) button.<br />
 
Both of them are placed in '' 'Change Status' '' column as shown on the screen below.
 
Both of them are placed in '' 'Change Status' '' column as shown on the screen below.
 
|}
 
|}
Line 300: Line 300:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|In order to view more details of brand, press '' 'Toggle Details' '' button next to a brand.<br />
+
|style="padding: 0px 0px 15px 15px;"|In order to view the details of a brand, press '' 'Toggle Details' '' button next to the brand.<br />
Here you can find ID of a brand, provided address and check whether this brand is set up as a default for new accounts.
+
Here you can find basic information about the brand as well as quick access links to the brand reports.
 
|}
 
|}
 
{|
 
{|
Line 307: Line 307:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|You can also access the client area of a brand through pressing a '' 'Preview' '' button.<br />
+
|style="padding: 0px 0px 15px 15px;"|You can also view the client area of the brand through pressing '' 'Preview' '' button.<br />
 
Client area should appear in a popup window as shown on the following screen.<br />
 
Client area should appear in a popup window as shown on the following screen.<br />
 
You can easily log into/register client account via this popup window.
 
You can easily log into/register client account via this popup window.
Line 317: Line 317:
 
===Brand Reports===
 
===Brand Reports===
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|At the '' 'Brand Reports' '' tab you can easily view reports concerning specified brand.<br />
+
|style="padding: 10px 0px 15px 15px;"|In '' 'Brand Reports' '' tab you can easily view reports concerning specified brand.<br />
 
You can check reports of clients, invoices, orders, tickets and services bounded to selected brand.
 
You can check reports of clients, invoices, orders, tickets and services bounded to selected brand.
 
|}
 
|}
Line 324: Line 324:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 15px;"|In an addition to that, you can select quantity of records per page, search specified record and order records by selected column.
+
|style="padding: 0px 0px 20px 15px;"|In an addition to that, you can select the quantity of records per page, search specified record and order records by selected column.
 
|}
 
|}
 
{|
 
{|
Line 332: Line 332:
 
|style="padding: 0px 0px 20px 15px;"|You can also compare all your brands using tabs marked on the following screen.<br />
 
|style="padding: 0px 0px 20px 15px;"|You can also compare all your brands using tabs marked on the following screen.<br />
 
Here you can compare them by amount of clients, orders, services, tickets, invoices, domains and income using various graph types.<br />
 
Here you can compare them by amount of clients, orders, services, tickets, invoices, domains and income using various graph types.<br />
On the following screen you can see web graph with shown popup with amount of services.<br />
+
On the following screen you can see a web graph with shown popup containing amount of services in brands.<br />
Popups with different information are shown upon hovering over specific parts of graph.
+
Popups with different information are shown upon hovering over specified parts of graph.
 
|}
 
|}
 
{|
 
{|
Line 342: Line 342:
 
{|
 
{|
 
|style="padding: 10px 0px 15px 15px;"|Multibrand For WHMCS makes management of WHMCS easier through introducing '' 'Brand Details' '' column.<br />
 
|style="padding: 10px 0px 15px 15px;"|Multibrand For WHMCS makes management of WHMCS easier through introducing '' 'Brand Details' '' column.<br />
'' 'Brand Details' '' column inform you about membership of clients, invoices or services to a brand.<br />
+
'' 'Brand Details' '' column inform you about membership of clients, invoices, tickets, orders or services.<br />
 
Let's see how it looks for a client list.
 
Let's see how it looks for a client list.
 
|}
 
|}
Line 349: Line 349:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|At the order list it looks similar. This column was implemented for lists of clients, invoices, orders, tickets and services.<br />
+
|style="padding: 0px 0px 15px 15px;"|At the order list it looks similar.<br />
 
Through pressing a brand name, you will be moved directly to a report page of that brand.<br />
 
Through pressing a brand name, you will be moved directly to a report page of that brand.<br />
 
''Notice: Client, service etc. status has to be set to active in order to show brand it is assigned to.''
 
''Notice: Client, service etc. status has to be set to active in order to show brand it is assigned to.''
Line 356: Line 356:
 
|style="padding: 0px 0px 30px 25px;"|[[File:MB_28.png]]
 
|style="padding: 0px 0px 30px 25px;"|[[File:MB_28.png]]
 
|}
 
|}
 
 
===Branded Client Area===
 
===Branded Client Area===
 
{|
 
{|
|style="padding: 10px 0px 20px 15px;"|Owing to Multibrand For WHMCS your clients can log into different client areas which are using one WHMCS solution.
+
|style="padding: 10px 0px 20px 15px;"|Owing to Multibrand For WHMCS your clients can log into assigned client areas while all client areas are using one WHMCS solution.
 
|}
 
|}
 
{|
 
{|
Line 365: Line 364:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 15px;"|Also invoices generated for different brands use settings of brand on which client is logged in.
+
|style="padding: 0px 0px 20px 15px;"|On the following screen you can see invoices generated for a brand.
 
|}
 
|}
 
{|
 
{|
Line 374: Line 373:
 
{|
 
{|
 
|style="padding: 10px 0px 15px 15px;"|Settings of brand also apply to emails sent to clients.<br />
 
|style="padding: 10px 0px 15px 15px;"|Settings of brand also apply to emails sent to clients.<br />
On the following screen you can see exemplary order email.
+
On the following screen you can see example order email.
 
|}
 
|}
 
{|
 
{|
Line 434: Line 433:
 
===Multibranded Clients===
 
===Multibranded Clients===
 
{|
 
{|
|style="padding: 10px 0px 15px 0px;"|You can set up a client as '' 'Multibranded' '', this status allows the client to log into all brands.<br />
+
|style="padding: 10px 0px 15px 0px;"|You can set up a client as '' 'Multibranded' '', this status allows clients to log into all brands.<br />
 
To benefit from this, you need to set up a client custom field.
 
To benefit from this, you need to set up a client custom field.
 
|}
 
|}
Line 452: Line 451:
 
====Setting A Client As Multibranded====
 
====Setting A Client As Multibranded====
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|Now, to allow a client to log into all brands follow this single step.<br />
+
|style="padding: 10px 0px 15px 15px;"|Now, to allow a client to log into all brands follow this steps.<br />
 
Proceed to client's profile → '' 'Profile' '', mark '' 'MultiBranded' '' and press '' 'Save Changes' ''.
 
Proceed to client's profile → '' 'Profile' '', mark '' 'MultiBranded' '' and press '' 'Save Changes' ''.
 
|}
 
|}
Line 459: Line 458:
 
|}
 
|}
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|Now, proceed to management of a brand to which the client is assigned → '' 'Clients' ''.<br />
+
|style="padding: 10px 0px 15px 15px;"|Now, go to management of a brand to which the client is assigned → '' 'Clients' '' tab.<br />
Afterwards, remove the client from the brand as shown on the following screen.<br />
+
Afterwards, remove the client from the brand through pressing on him and saving changes.<br />
''Note: If you firstly remove client and then assign him as multibranded, some relations will be removed and as a result graph and reports may be incorrect.''
+
''Note: If you start by removing client from a brand and then assign him as multibranded, some relations will be removed and as a result graph and reports may be incorrect.''
 
|}
 
|}
  

Revision as of 15:19, 5 November 2014

Contents

About Multibrand For WHMCS

Article update is ongoing on this page, watch out for broken links and unclear descriptions!
We are sorry for the inconvenience caused.

Multibrand For WHMCS will allow you to handle multiple brands on multiple websites while using a single WHMCS installation.

You will be able to customize your brand through modifying factors like client area template, logo, brand name, address and more.
Owing to Multibrand For WHMCS your customers will be able to log in to specified client areas in accordance to the brand under which they purchased a product or service.

  • Admin Area Features:
✔ User Friendly Management Of Multiple Brands
✔ Easy Modification Of Existing Brands
✔ Assign Unbranded Clients To Brands
✔ Unassign Branded Clients From Brands
✔ Migrate Clients Between Brands
✔ Assign Products To Brands
✔ Assign Product Groups To Brands
✔ Assign Ticket Departments To Brands
✔ Configure Payment Gateways For Each Brand Separately - PayPal And 2CheckOut (beta)
✔ Display Active Clients, Invoices, Orders, Tickets And Services Associated To Brands
✔ Quick Preview Of The Branded Client Area
✔ Publish/Unpublish Brand On Click
✔ Set Brand As Default - Automatic Assignment Of New Clients
✔ Brand Reports - The List Of Clients, Invoices, Orders, Tickets And Services
✔ Dynamic Brands Comparison Reports - Various Graph Types
✔ Generate And Manage Email Templates For Brands
  • Client Area Features:
✔ Branded Clients Can Only Log Into The Brand They Are Assigned To
✔ Multibranded Clients Can Log Into All Existing Brands With The Same Access Details
✔ Receive Branded Emails And Invoices
✔ Access To Products, Invoices, Ticket Departments and Payment Gateways Assigned To The Brand
✔ Displayed Client Area Template And Default Language Depend On The Brand
  • Brand Configuration:
✔ Brand URL Address
✔ Brand Name
✔ Company Name
✔ Brand Logo
✔ Brand Language
✔ Brand Template
✔ Brand Address
✔ Brand Email
✔ Default Brand For New Accounts
✔ Brand Graph Color
  • General Info:
✔ Multi-Language Support
✔ Supports WHMCS V5 and Later

Installation

This tutorial will show you how to successfully install and configure Multibrand For WHMCS.

We will guide you step by step through the whole installation and configuration process.

1. Log in to your client area and download Multibrand For WHMCS.
MB 1.png
2. Upload and extract the module into the main WHMCS directory.

Files in your WHMCS directory should look like this.

MB 2.png
3. When you install Multibrand for the first time you have to rename 'license_RENAME.php' file.

File is located in 'modules/addons/MultibrandFunctionality/license_RENAME.php' . Rename it from 'license_RENAME.php' to 'license.php' .

MB 3.png
4. In order to configure your license key, you have to edit a 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 your client area → 'My Products' .

MB 4.png
5. Now you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area. Go to the 'Setup' 'Addon Modules' . Afterwards, find 'Multibrand' and press 'Activate' button.

MB 5.png
6. In the next step you need to permit access to this module.

To do so click on 'Configure' button, tick 'Access Control' near required admin role groups and press 'Save Changes' .

MB 6.png
7. Last step is setting 'logos' folder as writeable.

Folder is located at the 'you_whmcs/modules/addons/MultibrandFunctionality/storage/' .

MB 7.png
8. You have just successfully installed Multibrand For WHMCS!

You can access your module in 'Addons' 'Multibrand' .

MB 8.png

Configuration and Management

At this section we will show you how to properly set up and use Multibrand For WHMCS.

Dashboard

Under 'Dashboard' you can find basic information about the module and current status of 'logos' folder.

It is required to set up 'logos' folder as writable in order to upload logos of your brands.
Additionally, here you can find links to articles guiding you through setting up CNAME records in the most popular platforms.

MB 9.png

Brands Management

'Brands Management' tab allows you to create and manage your brands using a single instance of WHMCS solution.

Important 1: Unbranded clients will be able to log into the main client area until you set up any brand as published.
Important 1: If you set up any brand as published, unbranded clients will be able to log into the default brand only.

New Brand

Let's start by creating a new brand. For that purpose go to 'Brands Management' tab and press 'Create New Brand' button.
MB 10.png
Now, fill out 'Brand Base URL' , 'Brand Email' , 'Brand Name' , 'Company Name' and 'Address' with desired values.

Values at the 'Address' field will be used as a company address and will be displayed for example on created invoices.
'Brand Email' will be used for branded emails send to clients.

MB 11.png
Afterwards, select desired brand language, template and brand colour.

Additionally, upload logo which will be used in the branded invoices, emails and client area.
Finish through deciding whether to set this brand as default and press 'Save Changes' .
Note: New users created by admin or through API will be assigned to the default brand.

MB 12.png
Last step is setting up DNS record, which will be pointing from branded domain towards your main domain used by WHMCS.

To learn more about setting up CNAME records, proceed to Creating CNAME Records section.
Do not forget to publish the brand as soon as the CNAME record propagate worldwide.

Management of Existing Brands

To manage your brand, press 'Manage' button next to it as show on the following screen.

General

General tab contains configuration of the brand.

You can modify your brand at any time, simply alter wanted parameters and press 'Save Changes' .

MB 13.png

Products

This tab allows you to assign products configured in your system to the brand.

Note: Product can be assigned to multiple brands in the same time.

MB 14.png

Ticket Department

Here you can choose ticket departments available in the brand.
MB 15.png

Client

'Client' tab allows you to assign unbranded clients to the brand.
File:MB 16.png

Migrations

While 'Client' enables you to brand unbranded clients, 'Migrations' allows you to move clients between brand.

As you can see on the following screen, brand to which client is assigned, is displayed next to him.

File:MB 17.png

Payment Gateway

This tab allows you to configure payment gateway for the brand.

Note: Owing to 'Payment Gateway' tab, you can use different details per brand.

MB 18.png

Email Templates

Here you are able to generate email templates for the brand only.

Check 'Create Brand Templates' and press 'Save Changes' to create them.

MB 19.png

Back To Brands Management

Alternatively, you can edit brand values visible in 'Brands Management' tab by pressing on them.

Choose/type desired value and confirm changes.

MB 20.png
Each brand can be disabled/enabled through pressing 'Published'/'Unpublished' (red) or set up as default through clicking on 'Default' (blue) button.

Both of them are placed in 'Change Status' column as shown on the screen below.

MB 21.png
In order to view the details of a brand, press 'Toggle Details' button next to the brand.

Here you can find basic information about the brand as well as quick access links to the brand reports.

MB 22.png
You can also view the client area of the brand through pressing 'Preview' button.

Client area should appear in a popup window as shown on the following screen.
You can easily log into/register client account via this popup window.

MB 23.png

Brand Reports

In 'Brand Reports' tab you can easily view reports concerning specified brand.

You can check reports of clients, invoices, orders, tickets and services bounded to selected brand.

MB 24.png
In an addition to that, you can select the quantity of records per page, search specified record and order records by selected column.
MB 25.png
You can also compare all your brands using tabs marked on the following screen.

Here you can compare them by amount of clients, orders, services, tickets, invoices, domains and income using various graph types.
On the following screen you can see a web graph with shown popup containing amount of services in brands.
Popups with different information are shown upon hovering over specified parts of graph.

MB 26.png

Membership In The Admin Area

Multibrand For WHMCS makes management of WHMCS easier through introducing 'Brand Details' column.

'Brand Details' column inform you about membership of clients, invoices, tickets, orders or services.
Let's see how it looks for a client list.

MB 27.png
At the order list it looks similar.

Through pressing a brand name, you will be moved directly to a report page of that brand.
Notice: Client, service etc. status has to be set to active in order to show brand it is assigned to.

MB 28.png

Branded Client Area

Owing to Multibrand For WHMCS your clients can log into assigned client areas while all client areas are using one WHMCS solution.
MB 29.png
On the following screen you can see invoices generated for a brand.
MB 30.png

Branded Email Templates

Settings of brand also apply to emails sent to clients.

On the following screen you can see example order email.

MB 31.png

Creating CNAME Records

In this section you will find guides on how to create CNAME record in popular control panels.

For sample where your branded domain is reseller.com and domain with your WHMCS is whmcs.domain.com, your CNAME will be 'www.reseller.com. CNAME whmcs.domain.com.'.
Note 1: As you can see above, each domain have to be closed with dot.
Note 2: To know more about certificate requirement, visit Common Problems section.

cPanel

1. Log into your cPanel panel.
2. Press 'Simple DNS Zone Editor' under 'Domains' section.
3. Select from the menu the domain you wish to manage.

Note: This step is required only if you won more than one domain.

4. Fill in 'Name' and 'CNAME' record and press 'Add CNAME Record' .

Note: To define record's TTL, use you have to use 'Simple DNS Zone Editor'.

DirectAdmin

1. Log into your DirectAdmin panel.
COMING SOON!

Plesk

1. Log into your Plesk panel.
2. Press 'Domains' under 'Hosting Services' section.
4. Find the domain to be edited, and click on the corresponding Control Panel link.

Afterwards, proceed to 'Websites & Domains' tab and press 'DNS Settings' .

4. Find the domain to be edited, and click on the corresponding Control Panel link.

Afterwards, proceed to 'Websites & Domains' tab and press 'DNS Settings' .

5. Add a new record or edit an existing one.
6. Now, change the record type to 'CNAME' and fill in both 'Domain name' and 'Canonical name' .

Finish by pressing 'Ok' .
Note: The changes will take between 4 to 8 hours to update worldwide.

Multibranded Clients

You can set up a client as 'Multibranded' , this status allows clients to log into all brands.

To benefit from this, you need to set up a client custom field.

1. Proceed to 'Setup' 'Custom Client Fields' .
MB 32.png
2. Fill 'MultiBranded' into 'Field Name' , choose 'Tick Box' field type and mark 'Admin Only' .

Afterwards, press 'Save Changes' .

MB 33.png

Setting A Client As Multibranded

Now, to allow a client to log into all brands follow this steps.

Proceed to client's profile → 'Profile' , mark 'MultiBranded' and press 'Save Changes' .

MB 34.png
Now, go to management of a brand to which the client is assigned → 'Clients' tab.

Afterwards, remove the client from the brand through pressing on him and saving changes.
Note: If you start by removing client from a brand and then assign him as multibranded, some relations will be removed and as a result graph and reports may be incorrect.

Tips

1. The logo image is usually hard coded into the WHMCS template files.

In order to use logo file provided at the 'Multibrand For WHMCS' module, find proper line at the template file and replace it with '{$logo}' variable.
The line responsible for displayed logo is placed at the 'header.tpl' file located in currently used template.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
2. Using 'Login as Client' functionality returns:
The page isn't redirecting properly

Solution: This issue will be solved in the next version of module.

3. If your CNAME record is not working, remember that first domain name in CNAME record should be branded domain.

The second one is the domain on which you have your WHMCS. The redirection goes from the first domain to the second.
Dots after domains are also important.
Take note that there could be a delay with propagation of changes for DNS servers while using A type CNAME records.

4. If your branded domain or WHMCS domain are using SSL connection, both of them need to have the same certificate.

If both of them are using the same domain, you will need a wildcard certificate.
If they are using different domains, secure them with the SAN certificate.
This is due the way in which WHMCS works. It is not the limitation of our module.

Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community