Administrator Manual
The Resellers

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 of your manager (the company that host the hotspot). Under the reseller level, you can configure managers and advertisers.

The Context Dropdown menu

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.

The “Default” Section

It contains the following options:

Option Description
 Advertising Dashboard

By selecting the branch, you are displayed the advertising dashboard for the reseller with the following tiles: main chart; context data; advertising sold; clicks; impressions; click through rate; users/customers across multiple gateways.

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, if you are logged in with a user who the “Administrator” role, it contains the same tiles of “System” but with specific values for the reseller. When logging in with a user who has the “Reseller” role, you are displayed the following tiles: the main chart; number of users per domain; connections; traffic; new users; sold GW; sold advertising; clicks; impressions; click through rate; domains with multiple connections; users with more traffic; social users; context data.

For further details about the content of the various tiles, please refer to the “Tile Types of the Dashboards” paragraph.

The “Edit” Section

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.

The “Admin” Section

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 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 managements of the products saleable to the users, specific for the reseller

Prepaid Credit for Advertising

Shows in a table with the summary by manager and/or 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 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.

 Tools for Managing Data

Opens the page for managing reseller-wide data.

The “Welcome Portal” Section

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.

Adding or Editing

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:

General Data

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 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 mails to users if it has not been prior defined 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 user has the permissions 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 a cost of € 8 (when it will be bought by the user).

Editable only if user has the permissions to manage the reseller’s data.

Timezone

Reseller’s timezone.
It defines the timezone for the reseller. The entered value parameterizes dates/hours, based on the time zone and effects the start time, end time and the working times of the gateway.

Using this value, you can parameterize international gateways with different timezones than the one set in the system.
If you select “Use default”, it will consider the Timezone defined in the “System Settings” (this setting is only available for the administrator of the system.

Custom Domain

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.

System Access Domain

System Access DomainSystem Access Domain 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 CeriticateSelect 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 AddressEnter the email address of the system Administrator.Alternative 1st Host DomainDomain of the 1st alternative host to access the system by the reseller and managers.It is only visible if you have defined the 1st alternative host 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 which associate the domain in the DNS is displayed.

Domain of the 2nd alternative host to access the system by the reseller and managers.It is only visible if you have defined 2nd alternative host 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 which associate the domain in the DNS is displayed.

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 CornerLogo 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.

SMS Gateway

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

SMS Gateway Type

Defines the type of gateway to be used for sending SMSs specific to the reseller. Possible values are:

  • Default (to send, it uses what defined in system options); 
  • Mail transport (it uses an external gateway for sending SMSs and requests are transmitted via smtp);
  • HTTP request (SMS sending is done via an HTTP request. You must fill in the “URL” field with the proper variables.

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:

  • %Number%, %NumberPlus% (destination number with + in the international county calling code);
  • %NumberNoIntPrefix% (destination number without international country calling code);
  • %NumberNoIntPrefixZero% (destination number with no zeros in the international county calling code);
  • %UserName%, (username);
  • %Password% (password);
  • %Message% (text to be sent).

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:

    • Auto (auto recognises the international country calling code);
    • Wit 00 (e.g. 0039);
    • With + (e.g. +39);
    • Without 00 nor + (e.g. 39).
    • 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.

Options

Field Description
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 number of gateways and 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.

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 percent 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 percent, 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 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.
Possible values are: default (it uses the value defined in the the General Options); never; one day; one week; two weeks; one month; three months; six months; one year; eighteen months; two years; three years.

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 HGWs and PGWs of the resellers and users cannot access anymore