WHITE-LABELING

Thinger.io instances support multi-tenant web console customizations. By means of a management tool that is available at the main menu "Rebranding" section, it is possible to create and manage multiple web customizations, in order to custom the aspect of the web console to different customers or projects by changing some elements such as:
Branding Colors
Web, Favicon and Main Menu logotypes
Links, Email accounts, copyright
Note that each web console rebrand needs to be supported by an individual web domain, which can be managed in the "Domain" section of the main menu.
Create a new Web Console Rebranding Profile
Clicking into "Add Brand" button of the "Rebranding" section allows creating a new branding profile. The process starts by introducing a web domain name, that will be the identification for the brand profile:
If the instance subscription doesn't include any rebranding addon, the next message will be shown in the web console:  
To solve this situation visit "Subscribe Rebranding License" below on this documentation
Adding Branding Details
If the Domain Name is valid, the form context will expand allowing to complete the branding details sections by editing the standard thinger.io values:
All the next elements are non-mandatory, so can be left empty and the system will remove their buttons from the main menu:
Domain Name: Is the URL of the new rebranded web console. This Web Domain needs to be introduced in the system as is explained in the "Custom Web Domain" section. 
Description: Place here some additional information about the rebranding profile in order to identify it from the others.
Page title: Identificator for the web browser tabs
Page URL: To introduce link to the company, customer or project website
Company Name: Name of the project, customer or company this rebranding belongs to. 
Contact Email: address for the main menu"Email" button that the users are going to contact for support.
Twitter Account:  Social media profile can be added by placing here the complete URL of the twitter profile.
Copyright: The bottom of the website includes a copyright declaration that can be customized here to protect the rebranding rights.  
Custom Logotypes
What really makes the difference when creating a rebranding is the use of custom logotypes. The second section of the branding editor allows changing each web console logotype separately. To obtain nice results, it is important to take care about the background color of each logotype in order to obtain enough contrast.
Logotypes need to be introduced in SVG or PNG file format with transparent background 
Custom Top Bar
The top bar has also a big impact on the website aspect. The branding menu allows changing it aspect in two ways: the Top Bar Color and the text color:
It is important also to take care of selected colors in order to obtain a nice contrast between the texts and background. 
PWA
Thinger.io web console has been prepared with PWA Smartphone responsive features, allowing to create web apps with web console custom preferences that when used on the smartphone allow a user experience very similar to a common APP thanks to the creation of a custom logo in the main menu and hiding the web browser navigation bar.
To use the PWA on a smartphone, simply click on the "add to the main menu" option of the browser menu. this functionality can be applied in any of the web console interfaces, even in shared dashboards
The PWA function parameters will be automatically configured based on the preferences of the other tabs of the web console rebranding. So it is not possible to introduce different ones.  
Email Templates
When working on multi-user projects, the platform has a series of communications that allows basic communication with users to verify email, create a new password, Forgot Password and Device Disabled. These emails can also be customized by the developer, being able to modify the following parameters:
From: Is the sender mail address that will be sent in the mail. Leave it empty to use the default configured address configured in the SMTP section
Name: Sender contact mail. Levar it empty to use the default name configured in the STMP section
Subject: Email subject
Template:  Configure the email template workinng directly with the text or with the HTML code
Email Settings
This section allows to custom the email server for this specific brand, note that it is also posible to modify it in the Server Settings to create a default configuration for the hole host, that will be applied to all the rebrands. 
SMTP Configuration
The Simple Mail Transfer Protocol, better known as SMTP, is a protocol used to transmit email messages over the internet. Thinger.io server instances contains an SMTP server that allows sending notifications to the instance users, that has been configured by default to use the same web domain as the IoT server host and the standard parameters, however,  these parameters can be customized by changing the server:
Host: Is the SMTP address or web domain
Port: Custom port to be used in order to send the notifications
Username: SMTP username credentials 
Password: SMTP username password
SSL/TLS Connection: should be enabled if the SMTP has been installed in a different host but can be disabled if it is running in the same one.
Amazon SES Configuration
The integration with Amazon SES provides a much simple and scalable mailing tool. It can be selected instead of the common SMTP by selecting it on Email Type, and placing the credentials on its appropriate section. These credentials can be obtained on the AWS SES configuration section as explained on this link​
Modify Console Rebranding
When the Console Rebranding profile is finished, a new entry will appear into the rebranding administration list as shown in the image below:
It is possible to access the configuration form and edit all parameters by clicking into the brand profile identificator, which is the associated web domain.
Remove a Console Rebranding Profile
A rebranding profile can be easily deleted just selecting it in the Brand List and clicking into the red "Remove Brand" button.
Increase Rebranding Limits 
This feature is reserved for professional uses, so only Grow, Startup, and Business licenses can create custom rebranding profiles when the rebranding license is acquired during the subscription of the license or later using the subscription administration console. If the license didn't include any branding Addon, the next error will be shown during the creation of the new brand: 
The next sections explain how to include the rebranding Addon with a Thinger.io private instance in both situations:   
During the deployment
Our deployment tool allows configuring the license with multiple Add-ons such as custom web domains, custom brands, or additional user accounts. It can be added to the license before the deployment process by means of the configuration table 
Note that more than one branding or web domain profile can be added, as it is possible to create as many brandings as needed in order to adapt the look and feel of the web console to different IoT projects or customers. When the limit is reached, the web console will show the next error message "cannot create more domains" to inform that it is required to upgrade the number of custom domain profiles as explained in the section below. 
After the deployment
If the amount of contracted brand profiles is reached, (or if no additional brands were contracted), it is possible to upgrade the threshold by going to the management portal using the link below. 
​Click here to access the subscription administration portal​
The administration portal only can be accessed by the instance administrator using his email address to obtain a one-time password. Once logged in, the administration portal will show all the licenses that have been subscribed to this e-mail address. Just select the license that wants to be modified and press the option "Edit Subscription", finally, pressing the option "Addons", the portal will show all the available options and pricing in the Add Add-ons menu:
After selecting any of them, it is possible to select the amount just before checking out, note that the price  will be fixed per each unit, but it is possible to introduce a discount coupon that will be provided by Thinger.io team if your business model is quite intensive on any of these features in order to hold a cost-effective solution 
When the subscription begins updated, a confirmation email will be received with an extract of the subscription cost variations. 
After modifying any of the subscription parameters Thinger.io server instance needs to be reset in order to update de configuration file values. 
This process can be executed using the server administration panel as shown in the image below: 

USER ACCOUNTS

CUSTOM WEB DOMAIN

Last modified 4mo ago

Copy link

Edit on GitHub

Outline

Create a new Web Console Rebranding Profile

Adding Branding Details

Modify Console Rebranding

Remove a Console Rebranding Profile

Increase Rebranding Limits

During the deployment

After the deployment