Administrator Manual
Resellers are inside the “ System” branch. They identify, at a lower level than administrators of the system, the person that commercially manages managers and advertisers.
In case you are not interested in this level and in managing a sales network, you can name it with the same name as your manager (the company that host the hotspot). Under the reseller level, you can configure managers and advertisers.
By clicking the bar with the right mouse button, or by pressing the context properties button , you expand the context dropdown menu with a range of options grouped by: default; edit; admin.
It contains the following options:
| Option | Description |
| Advertising Dashboard |
By selecting the branch, you are displayed the advertising dashboard for the reseller. For further details about the contents of the various tiles, please refer to the “Tile Types of the Dashboards” paragraph. |
| Dashboard |
Selecting the branch, you will open the reseller’s dashboard. For further details about the content of the various tiles, please refer to the “Tile Types of the Dashboards” paragraph. |
In addition to the standard editing options, it contains the following options:
|
Option |
Description |
|
Add Advertiser |
Allows you to add a new advertiser. |
|
Add Manager |
Allows you to add a new event manager. |
Contains the following options:
| Option | Description |
| Currency and Payment Systems |
Allows you to define the configuration data of the currency and payment systems of the reseller. |
| Daily Summary of the Campaigns |
Shows a table with the daily summary of results of all campaigns of the reseller with the description of the campaign, number of impressions, cost of impressions, number of clicks and cost of clicks. |
| Display all Connected Users |
Shows in a table all the users connected to the reseller’s gateways. |
| Display all Users |
Shows all the reseller’s registered users |
| External Authentications |
It allows you to define the parameters required to enable custom external user authentication procedures for the users for the reseller. This option is available only in the Enterprise edition. |
| Federation Groups among Domains |
Opens the page for managing federation groups across reseller’s domains. |
| List of Access Points |
Opens the page containing the list of all the access points entered at the reseller-wide level |
| List of the Gateways |
Opens the page containing the list of all the gateways entered at reseller-wide level. |
| Map of the Gateways |
Shows the map of all the gateways configured based on their GPS coordinates. |
| Notifications |
Opens a page for managing notifications for the reseller |
| Product Policies |
Opens the management of the product policies specific for the reseller. |
|
Products |
Opens the management of the products saleable to the users, specific for the reseller |
| Prepaid Credit for Advertising |
Shows in a table with the summary by manager or/and advertiser, month and year, the sales amounts for the advertising campaigns to invoice to the managers and advertisers. |
| Prepaid Credit of the Managers |
Shows in a table grouped by the manager, month and year, the sales made for charging prepaid amounts to the managers. |
| Reseller System Users |
Opens the page for managing users that can log in to the system with the “Reseller” role |
| Sales to Users |
Shows in a table, grouped by manager, product, month and year, the costs to be invoiced to the managers and the revenue obtained from managers for the sales of connectivity to users. |
| SMS Sales |
Shows in a table, grouped by manager, product, month and year, the amounts to be invoiced to managers for the sales of SMS packages. |
|
SSL Certificates |
Shows the SSL certificate management page that can be used in custom domains for the reseller (Enterprise edition) or Mikrotik gateways type. |
|
Tax Rates |
Allows defining a tax rate list with the relative parameters to be assigned to the reseller or to the manager when selling products to the users. |
| Data Management Tool |
Opens the page for managing reseller-wide data. |
It contains the following options:
| Option |
Description |
| Bypass or block IP/MAC-address |
Open the page that allows defining the IP addresses, the subnets or the MAC-addresses of devices that must bypass the Welcome Portal and/or that must be blocked into all the gateways of the reseller. |
| Surveys, Quizzes and Tests |
Opens the page for managing surveys, quizzes and tests. |
For further details about roles and permissions for the resellers, please refer to the “Users Administering the System” section.
To add a reseller, select the data tab, press the context properties button of " System" and select Add reseller. On the other hand, to change a reseller, always in the data tab, press the context button on reseller and choose “Edit”. In both cases, a page appears that allows you to manage the following fields:
|
Field |
Description |
|
ID |
ID of the record. Auto-assigned Identifier of the record. It can be used to use the API or external integrations. It is displayed during editing phase of an existing data and not during insertion of a new record. |
| Created on |
Date and time of the creation of the reseller. |
| Company Name |
Enter the company name of the reseller. |
| Address |
Address (E.g. 1234 Rome St). |
| City |
City. |
| VAT-Id Number |
VAT identification number. |
| Phone |
Enter the phone number (mobile or landline). |
| Fax |
Fax number. |
| Web Address |
Enter the web address. |
| Email Address |
Enter your e-mail address. It is used as the sender in sending notification emails to users if it has not been defined prior in the manager. |
| Registered at Register of Companies of |
Indicates the place of registration of the company in the register of companies. It will appear in the page’s footer. |
| Advertising Fees |
Percentage of commission for advertising sold by the reseller. Editable only if the user has permission to manage the reseller’s data. |
| Discount |
Enter the discount percentage (without the% symbol) that will be applied to the price list of the products sold by the reseller. For example, if the HSNM administrator has created a product with the price of € 10 and the discount percentage of the reseller is 20%, the administrator will invoice the product to the reseller at the cost of € 8 (when it will be bought by the user). Editable only if the user has the permissions to manage the reseller’s data. |
| Timezone |
Reseller’s timezone. Using this value, you can parameterize international gateways with different timezones than the one set in the system. |
|
Field |
Description |
|
Enable |
Enable gateway management features for internet connections. Visible only if also the license for fleet tracking has been purchased. |
|
Maximum Number of Gateways |
Maximum number of definable gateways. A value equals to zero states that the maximum number is limited only by the licence currently in use in your system. It is used to create a multi-tenant system. Using this feature allow you to give freedom to resellers and manager to create, modify and add gateways but also it sets a limit on the maximum number that can be inserted. Editable only if user has the permissions to manage the reseller’s data. |
|
Maximum Number of Users |
Maximum number of concurrent users connected to the gateways. The defined value states the maximum number of users definable in the gateway given by the sum of the maximum number of users defined in the gateway. A value equals to zero indicates an infinite number. By defining a value, you also activate a control on the minimum number of simultaneous users for each gateway that is set on five. It is used to create a multi-tenant system. This option gives to the resellers and the managers the opportunity to create and modify data but it gives a limitation on the the maximum number of concurrent users that can be inserted. Editable only if user has the permissions to manage the reseller’s data. |
|
Maximum Number of Users per Gateway |
Maximum number of concurrent users defined in each gateway. A value equals to zero indicates an infinite number. If a value is set in each reseller’s gateway, in the field “Maximum number of users” it will not be possible to set more values. It is used to create a multi-tenant system. Editable only if user has the permissions to manage the reseller’s data. |
|
Maximum Number of Views per Minute |
Maximum number of Welcome Portal views per minute. The sum of the maximum number of views per minute, entered in the reseller’s managers, cannot exceed the value you define. To indicate that the number of views is not limited, edit a zero value. If you need to decrease or reset this value, you must first change the values defined in the managers. It is used to create a multi-tenant system. It allows limiting the access to the Welcome Portal. When several devices try to view the Welcome Portal in the same minute and their number exceeds the defined value, the user will be displayed a message that the system is busy and to wait for X seconds. Editable only if the user has permissions to administrate the reseller’s data. |
|
Reduce the Maximum Number of Users of the Gateways to |
If you select a non-zero value, during the disabled months of the gateway, the service will work the same, reducing the maximum number of users to the indicated percentage. For example, if in the gateway, in the “Maximum Number of Users” field, you defined fifty users, in the field you select ten per cent and the current month is disabled by the values selected in the gateway “Operating Months” field, the maximum number of users will be reduced to five. If you select zero per cent, in the disabled months it will not be possible to use the service and the message “Sorry, the system is not active in this month” will be displayed to users. This option is also definable at manager level. |
|
Maximum Media Size (MB) |
Maximum size in megabytes of image, audio and video files that the reseller’s managers can upload. The count considers the custom images, the images for the campaign banners and the media uploaded to the places of the maps. The express value defines the maximum media size of all reseller’s managers. A value of zero declares to consider only the maximum size defined in each individual manager. |
|
Current Size (MB) |
Current size of image, audio and video files. Read-only property. |
|
Field |
Description |
|
Enable |
Enable the fleet GPS tracking & telemetry feature. |
|
Maximum Number of Vehicles |
Maximum number of vehicles the reseller can add. A value equal to zero states that the maximum number is limited only by the license in use in the system. Used to create a multi-tenant system. The use of this feature allows the managers to create, modify and add vehicles but places a limit on the maximum number that can be inserted. Editable only if the user has reseller data administration permissions and if the system user is enabled to manage data for fleet GPS tracking & telemetry. Visible only if you have purchased the license for fleet tracking and if you have enabled fleet GPS tracking & telemetry from previous feature. |
Custom SMTP for the reseller to use to send email notifications and/or advices. If defined:
|
Field |
Description |
|
SMTP Server Address |
Enter the address of the SMTP server that will be used to send email notifications and/or advices. |
|
Secure Connection for SMTP |
It enables secure connections (SSL or TLS) for SMTP. For Gmail use SSL and port 465, and enable access to less secure app at the URL https://www.google.com/settings/security/lesssecureapps. Possible options are:
|
|
SMTP Port |
Enter the SMTP port. Generally, it is 25. For Gmail, you need to enter 587. |
|
Enable SMTP Authentication |
If enabled, it enables SMTP authentication. |
|
SMTP Username |
The username of the SMTP. |
|
SMTP Password |
The password of the SMTP. |
Allows defining a domain, the alternative hosts and the system logos. The use of the custom domain will involve the automatic upload of custom logos
This option is available only in Enterprise edition.
This configuration, apart from logos, must be performed into all the high availability devices.
| Field | Description |
| System Access Domain Name |
System Access DomainSystem Access Domain Name for the resellers and managers once they access the system.If defined, it allows accessing to the backend with the indicated domain displaying the defined logos. Also the reseller Welcome Portals will be available with this domain or eventually, in a system set up in high availability, to alternative hosts. Warning, the domain must be properly configured and solvable by DNS otherwise an error will occur. In the note on the right, the IP address to which associate the domain in the DNS is displayed. |
| SSL Ceriticate |
Select the SSL certificate to use.The list displays the “Non Private” certificates entered in the system or reseller level. It must have been issued for the “System Access Domain” defined in the previous field. |
| Administrator Email Address | Enter the email address of the system Administrator. |
| General Login Image | Image displayed on the login page accessing the management area with the custom domain. It must have a size of 200×70 pixels. |
| Logo Displayed in the Top-Left Corner | Logo displayed in the top-left corner of the backend portal when accessing with the custom domain. It must have a size of 170×70 pixels. |
Custom round-robin hosts allow you to define up to two domains to which are associated alternative devices that share the workload (Load Balancing) and which can respond in case of failover.
Roun robin domains can be defined only if you have enabled them in the “ System Settings”.
This function is available only in the Enterprise Edition and only if you have defined the round robin hosts at system level.
|
Field |
Description |
|
Domain Name of the 1st Host |
Define the domain name of the 1st custom round robin host to be accessed by the resellers and managers for the displayed IP address. Visible only if you have defined the “Domain Name of the 1st Host” and its IP address in the “ System Settings”. Warning! The domain must be properly configured and solvable by DNS otherwise an error will occur. In the note on the right, the IP address to associate the domain in the DNS is displayed. |
|
Domain Name of the 2nd Host |
Define the domain name of the 2nd custom round robin host to be accessed by the resellers and managers for the displayed IP address. Visible only if you have defined the “Domain Name of the 2nd Host” and its IP address in the “ System Settings”. Warning! The domain must be properly configured and solvable by DNS otherwise an error will occur. In the note on the right, the IP address to associate the domain in the DNS is displayed. |
Define it if you want to provide users with a single domain name to access a system in high availability that involves multiple HSNMs. The destination system will then decide whether to redirect the request to one of the alternative systems based on round robin and load distribution rules. The DNS resolution of the defined domain must point to the various round robin domains.
Basically, if you have two systems in high availability, you need to configure the load balancing domain in such a way as to resolve both the IP addresses or the domains of the systems involved
This function is available only in the Enterprise Edition and only if you have defined the round robin hosts at system level.
|
Field |
Description |
|
Name of the Load Balancing Domain |
Define the name of the load balancing domain. |
|
SSL Cert for Load Balancing Domain |
Select the certificate you need to use for the load balancing domain. The available certificates must be entered on “SSL Certificate” available in the “Admin” tab. Editable only if you have permissions to administrate data. |
Available only in the “Enterprise” edition, it allows you to define data relating to the system brand to customize, for example, the text and URL of the Welcome Portal “Powered By”, with the corresponding destination URL, the Wiki logo, and the logo to display for managers.
|
Field |
Description |
|
Brand Name |
Brand name to be assigned to the system. It is used, for example, to customize the Powered By of the Welcome Portal, the product name within the Wiki, etc. Available only in the “Enterprise” edition. |
|
Destination URL |
URL to open at the click of Powered By. If not defined, the system URL will be used. Available only in the “Enterprise” edition. |
|
Logo for Managers/Advertisers |
Logo displayed in the top-left corner, in the area of management for managers/advertisers. It must have a size of 170 x 70 pixels |
If in the gateway type, you chose “Mail transport” or “HTTP request”, it allows you to define a custom gateway for the reseller, avoiding the use of the system one. Using a custom gateway allows the reseller to use his own gateway to send SMSs by his managers without buying SMS packages from the administrator.
To receive you can define an HTTP request to the URL http://DomainName/functions/sms-receive.php? number = Phonenumber and text = message text
| Field | Description |
| SMS Gateway Type |
Defines the type of gateway to be used for sending SMSs specific to the reseller. Possible values are:
This option can be modified only if the system user has the administrator role and administrative rights. |
| Number | Define the number that is associated with the gateway to receive SMS.Visible only if the type of gateway is “Mail transport” or “HTTP request” |
| Sender Email Address |
Sender’s email address for the gateway with transport via mail. Visible only if the type of gateway is “Mail transport”. |
| Recipient’s Email Address |
Recipient’s email address for the gateway with transport via mail. Usually it is in the form %Number%@NomeDominioGateway.com or %NumberNoIntPrefix%@NomeDominioGateway.com where instead of %Number%, the destination mobile phone number will be inserted and instead of %NumberNoIntPrefix%, the mobile number without the international country calling code will be inserted. Visible only if the type of gateway is “Mail transport”. Some SMS gateways require the recipient’s email address in the form InternationalPrefixMobileNumber@GatewayDomainName.com (example: +393351234567@nomedominiogateway.com); in these cases, you have to use the %NumberPlus% variable (example: %NumberPlus%@NomeDominioGateway.com). |
| Email Subject |
Object of the email to be sent to the gateway. The available variables are the same as the ones defined in the recipient’s address. Visible only if the type of gateway is “Mail transport”. |
| Request Type |
Defines the type of request to execute for the specified URL. Visible only if the type of gateway is “HTTP request”. |
| URL Address |
URL address for gateway with HTTP requests. In the address, you can use the variables:
Example: http://DomainSmsGateway/smssend.php?username=%UserName%&password=%Password%&to=%Number%&text=%Message%. Visible only if the type of gateway is “Http request”. |
| Gateway Username |
Username of the gateway. It is used to enhance the % UserName% variable. Usually gateways that use HTTP requests, require the credentials in the URL. Visible only if the type of gateway is “HTTP request”. |
| Gateway Password |
Password of the gateway. It is used to enhance the %Password% variable. Usually gateways that use HTTP requests, require the credentials in the URL. Visible only if the type of gateway is “HTTP request”. |
| Type of Country Calling Code in Receiving |
Defines the type of international country calling code received by the SMS gateway. Possible values are:
The field is visible only if you have defined “Http request” in the type of gateway. |
| Unit Price per SMS |
Enter the price that the administrator of HSNM will apply to the reseller for each SMS that has been sent. Editable only if the user has the system administrator role and has permissions to administrate the reseller data. Visible only if the type of gateway is “Default”. |
If the used gateway allows also receiving SMSs and is able to make HTTP requests, you have to define the following URL:http://DomainName/functions/sms-receive.php?phone=Numero&text=test of the message where “DomainName” is the domain of HSNM, “Number” and “Test of the message” are respectively the variables defined in the gateway that contain the sender’s number and the text of the sent message.
The Terms & Conditions statement to use the product must be accepted by the “Manager” and “Advertiser” system users before gaining access to the backend.
|
Field |
Description |
|
Terms & Conditions |
Multilingual text of the Terms & Conditions statement for using the the service to be accepted by the system users. |
|
Version |
Version of the Terms & Conditions statement. Modifying the version prompts system users for re-approval. If the revision number is not provided, the Terms & Conditions are not displayed. |
|
Revision Date |
Date of the last revision of the Terms & Conditions statement. |
The Privacy Policy statement must be accepted by the “Manager” and “Advertiser” system users before gaining access to the backend.
|
Field |
Description |
|
Privacy Policy |
Multilingual text of the Privacy Policy statement to be accepted by the system users. |
|
Version |
Version of the Privacy Policy statement. Modifying the version prompts system users for re-approval. If the revision number is not provided, the Terms & Conditions are not displayed. |
|
Revision Date |
Date of the last revision of the Privacy Policy. |
| Field | Description |
| Maximum Number of Active Campaigns |
It indicates the maximum number of campaigns that can be activated simultaneously by the managers or by the reseller’s advertisers. A value equal to zero indicates a limited number based on the licence. It is used to create a multi-tenant system. Editable only if user has the permissions to manage the reseller’s data. |
| Delete Users Inactive since |
Deletes automatically the inactive users according to the time indicated. Editable only if user has the permissions to manage the manager’s data. |
| Logo for Managers/Advertisers |
Logo displayed at the top left in the management area for managers/advertisers. It must have the dimensions of 170 x 70 pixels. |
| External ERP/PMS Code |
External code of the ERP/PMS. It is used to associate the reseller with the registry of an external ERP/PMS database. Editable only if user has the permissions to manage the reseller’s data. |
| Notes |
Notes for the reseller. |
| Reseller Locked |
If enabled, it blocks the access on all gateways of the resellers and users cannot access anymore |