Whmcsmod addons - User contributions [en]

Leasewebvps

2025-10-16T10:47:07Z

Nathan: /* LEASEWEB VPS PRODUCT CONFIGURATION */

== INSTALL INSTRUCTIONS ==

1) Unzip leasewebvps.zip file

2) Upload the leasewebvps folders to your whmcs install location

== LEASEWEB VPS ADDON CONFIGURATION ==

Setup->addon modules

Click on activate link in the Leaseweb VPS module

Scroll down and fill the configuration fields:

Leaseweb region apikey: Your leaseweb reseller region account apikey for each region.

Bandwidth limit notification: Set a bandwidth usage % limit to send notifications.

Whmcsmod module license: The FULL license whmcsmod.com provided you. Example: OWNED-1234567890

Access Control: Click Full administrator

[[File:leaseweb-vps-activationb.png]]

== IMPORT SERVER SERVERS ==

Click in the addons->leaseweb VPS addon link.

Click the "import" tab.

Click the "import" button.

== LEASEWEB VPS PRODUCT CONFIGURATION ==

1) Create a leaseweb product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A random name for you product, for example "leaseweb VPS plan 1"

Pricing tab:

Set your prices

Module tab:

Module name: leaseweb

Set the monthly bandwidth limit

Enable or disable the features required ( reinstall, etc)

Set the account region (each region use a different api key)

Check "Automatically setup the product as soon as the first payment is received"

[[File:leaseweb-vps-product.png]]

Save Changes

== Setup bandwidth quota (optional ) ==

Set your productbandwidth quote in the product settings, module tab "Bandwidth limit" field.

Create a template named "leaseweb vps quota limit" that will be used for email notifications, for example:

''Hi:

{$client_name}

Your service {$service_product_description} is reaching the bandwidth limit.

Best regards''

[[File:leaseweb_email.png]]

== Admin service management ==

If a client has a leaseweb product assigned, the list of features available are:

- Display server info.

[[File:leaseweb-vps-service-admin.png]]

== Client area ==

In the client area, the client will be able to manage the server:

Dashboard

[[File:leaseweb-clientarea-vps-dashboard.png]]

Network area

[[File:leaseweb-clientarea-vps-network.png]]

Reverse DNS area

[[File:leaseweb-clientarea-vps-rdns.png]]

Reinstall area

[[File:leaseweb-clientarea-vps-reinstall.png]]

Remote console

[[File:leaseweb-clientarea-vps-ipmi.png]]

== Multilanguage support ==

The client area templates supports multi language. The available language files are available at "modules/servers/wmleaseweb/lang/", if you need to add support to a language not available, copy the file "english.php" to your language one( for example swedish.php" ) and translate the file strings.

Leasewebvps

2025-10-16T10:46:33Z

Nathan: /* LEASEWEB VPS ADDON CONFIGURATION */

== INSTALL INSTRUCTIONS ==

1) Unzip leasewebvps.zip file

2) Upload the leasewebvps folders to your whmcs install location

== LEASEWEB VPS ADDON CONFIGURATION ==

Setup->addon modules

Click on activate link in the Leaseweb VPS module

Scroll down and fill the configuration fields:

Leaseweb region apikey: Your leaseweb reseller region account apikey for each region.

Bandwidth limit notification: Set a bandwidth usage % limit to send notifications.

Whmcsmod module license: The FULL license whmcsmod.com provided you. Example: OWNED-1234567890

Access Control: Click Full administrator

[[File:leaseweb-vps-activationb.png]]

== IMPORT SERVER SERVERS ==

Click in the addons->leaseweb VPS addon link.

Click the "import" tab.

Click the "import" button.

== LEASEWEB VPS PRODUCT CONFIGURATION ==

1) Create a leaseweb product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A random name for you product, for example "leaseweb VPS plan 1"

Pricing tab:

Set your prices

Module tab:

Module name: leaseweb

Set the monthly bandwidth limit

Enable or disable the features required ( reinstall, etc)

Check "Automatically setup the product as soon as the first payment is received"

[[File:leaseweb-vps-product.png]]

Save Changes

== Setup bandwidth quota (optional ) ==

Set your productbandwidth quote in the product settings, module tab "Bandwidth limit" field.

Create a template named "leaseweb vps quota limit" that will be used for email notifications, for example:

''Hi:

{$client_name}

Your service {$service_product_description} is reaching the bandwidth limit.

Best regards''

[[File:leaseweb_email.png]]

== Admin service management ==

If a client has a leaseweb product assigned, the list of features available are:

- Display server info.

[[File:leaseweb-vps-service-admin.png]]

== Client area ==

In the client area, the client will be able to manage the server:

Dashboard

[[File:leaseweb-clientarea-vps-dashboard.png]]

Network area

[[File:leaseweb-clientarea-vps-network.png]]

Reverse DNS area

[[File:leaseweb-clientarea-vps-rdns.png]]

Reinstall area

[[File:leaseweb-clientarea-vps-reinstall.png]]

Remote console

[[File:leaseweb-clientarea-vps-ipmi.png]]

== Multilanguage support ==

The client area templates supports multi language. The available language files are available at "modules/servers/wmleaseweb/lang/", if you need to add support to a language not available, copy the file "english.php" to your language one( for example swedish.php" ) and translate the file strings.

Leasewebvps

2025-10-16T10:45:35Z

Nathan: /* LEASEWEB VPS ADDON CONFIGURATION */

== INSTALL INSTRUCTIONS ==

1) Unzip leasewebvps.zip file

2) Upload the leasewebvps folders to your whmcs install location

== LEASEWEB VPS ADDON CONFIGURATION ==

Setup->addon modules

Click on activate link in the Leaseweb VPS module

Scroll down and fill the configuration fields:

SSC Region: Set the account region (each region use a different api key)

Bandwidth limit notification: Set a bandwidth usage % limit to send notifications.

Whmcsmod module license: The FULL license whmcsmod.com provided you. Example: OWNED-1234567890

Access Control: Click Full administrator

[[File:leaseweb-vps-activationb.png]]

== IMPORT SERVER SERVERS ==

Click in the addons->leaseweb VPS addon link.

Click the "import" tab.

Click the "import" button.

== LEASEWEB VPS PRODUCT CONFIGURATION ==

1) Create a leaseweb product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A random name for you product, for example "leaseweb VPS plan 1"

Pricing tab:

Set your prices

Module tab:

Module name: leaseweb

Set the monthly bandwidth limit

Enable or disable the features required ( reinstall, etc)

Check "Automatically setup the product as soon as the first payment is received"

[[File:leaseweb-vps-product.png]]

Save Changes

== Setup bandwidth quota (optional ) ==

Set your productbandwidth quote in the product settings, module tab "Bandwidth limit" field.

Create a template named "leaseweb vps quota limit" that will be used for email notifications, for example:

''Hi:

{$client_name}

Your service {$service_product_description} is reaching the bandwidth limit.

Best regards''

[[File:leaseweb_email.png]]

== Admin service management ==

If a client has a leaseweb product assigned, the list of features available are:

- Display server info.

[[File:leaseweb-vps-service-admin.png]]

== Client area ==

In the client area, the client will be able to manage the server:

Dashboard

[[File:leaseweb-clientarea-vps-dashboard.png]]

Network area

[[File:leaseweb-clientarea-vps-network.png]]

Reverse DNS area

[[File:leaseweb-clientarea-vps-rdns.png]]

Reinstall area

[[File:leaseweb-clientarea-vps-reinstall.png]]

Remote console

[[File:leaseweb-clientarea-vps-ipmi.png]]

== Multilanguage support ==

The client area templates supports multi language. The available language files are available at "modules/servers/wmleaseweb/lang/", if you need to add support to a language not available, copy the file "english.php" to your language one( for example swedish.php" ) and translate the file strings.

Leasewebvps

2025-09-03T18:00:49Z

Nathan: /* LEASEWEB VPS PRODUCT CONFIGURATION */

== INSTALL INSTRUCTIONS ==

1) Unzip leasewebvps.zip file

2) Upload the leasewebvps folders to your whmcs install location

== LEASEWEB VPS ADDON CONFIGURATION ==

Setup->addon modules

Click on activate link in the Leaseweb VPS module

Scroll down and fill the configuration fields:

Leaseweb API key: Your leaseweb reseller region account apikey.

Bandwidth limit notification: Set a bandwidth usage % limit to send notifications.

Whmcsmod module license: The FULL license whmcsmod.com provided you. Example: OWNED-1234567890

Access Control: Click Full administrator

[[File:leaseweb-vps-activationb.png]]

== IMPORT SERVER SERVERS ==

Click in the addons->leaseweb VPS addon link.

Click the "import" tab.

Click the "import" button.

== LEASEWEB VPS PRODUCT CONFIGURATION ==

1) Create a leaseweb product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A random name for you product, for example "leaseweb VPS plan 1"

Pricing tab:

Set your prices

Module tab:

Module name: leaseweb

Set the monthly bandwidth limit

Enable or disable the features required ( reinstall, etc)

Check "Automatically setup the product as soon as the first payment is received"

[[File:leaseweb-vps-product.png]]

Save Changes

== Setup bandwidth quota (optional ) ==

Set your productbandwidth quote in the product settings, module tab "Bandwidth limit" field.

Create a template named "leaseweb vps quota limit" that will be used for email notifications, for example:

''Hi:

{$client_name}

Your service {$service_product_description} is reaching the bandwidth limit.

Best regards''

[[File:leaseweb_email.png]]

== Admin service management ==

If a client has a leaseweb product assigned, the list of features available are:

- Display server info.

[[File:leaseweb-vps-service-admin.png]]

== Client area ==

In the client area, the client will be able to manage the server:

Dashboard

[[File:leaseweb-clientarea-vps-dashboard.png]]

Network area

[[File:leaseweb-clientarea-vps-network.png]]

Reverse DNS area

[[File:leaseweb-clientarea-vps-rdns.png]]

Reinstall area

[[File:leaseweb-clientarea-vps-reinstall.png]]

Remote console

[[File:leaseweb-clientarea-vps-ipmi.png]]

== Multilanguage support ==

The client area templates supports multi language. The available language files are available at "modules/servers/wmleaseweb/lang/", if you need to add support to a language not available, copy the file "english.php" to your language one( for example swedish.php" ) and translate the file strings.

File:Leaseweb-clientarea-vps-rdns.png

2025-09-03T17:59:53Z

Nathan:

File:Leaseweb-vps-service-admin.png

2025-09-03T17:58:58Z

Nathan:

File:Leaseweb-clientarea-vps-dashboard.png

2025-09-03T17:58:14Z

Nathan:

Leasewebvps

2025-09-03T17:45:34Z

Nathan:

== INSTALL INSTRUCTIONS ==

1) Unzip leasewebvps.zip file

2) Upload the leasewebvps folders to your whmcs install location

== LEASEWEB VPS ADDON CONFIGURATION ==

Setup->addon modules

Click on activate link in the Leaseweb VPS module

Scroll down and fill the configuration fields:

Leaseweb API key: Your leaseweb reseller region account apikey.

Bandwidth limit notification: Set a bandwidth usage % limit to send notifications.

Whmcsmod module license: The FULL license whmcsmod.com provided you. Example: OWNED-1234567890

Access Control: Click Full administrator

[[File:leaseweb-vps-activation.png]]

== IMPORT SERVER SERVERS ==

Click in the addons->leaseweb VPS addon link.

Click the "import" tab.

Click the "import" button.

== LEASEWEB VPS PRODUCT CONFIGURATION ==

1) Create a leaseweb product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A random name for you product, for example "leaseweb VPS plan 1"

Pricing tab:

Set your prices

Module tab:

Module name: leaseweb

Set the monthly bandwidth limit

Enable or disable the features required ( reset password, rescue, etc)

Check "Automatically setup the product as soon as the first payment is received"

[[File:leaseweb-product.png]]

Save Changes

== Setup bandwidth quota (optional ) ==

Set your productbandwidth quote in the product settings, module tab "Bandwidth limit" field.

Create a template named "leaseweb vps quota limit" that will be used for email notifications, for example:

''Hi:

{$client_name}

Your service {$service_product_description} is reaching the bandwidth limit.

Best regards''

[[File:leaseweb_email.png]]

== Admin service management ==

If a client has a leaseweb product assigned, the list of features available are:

- Display server info.

[[File:leaseweb-service-admin.jpg]]

== Client area ==

In the client area, the client will be able to manage the server:

Dashboard

[[File:leaseweb-clientarea-dashboard.jpg]]

Network area

[[File:leaseweb-clientarea-network.jpg]]

Reverse DNS area

[[File:leaseweb-clientarea-rdns.jpg]]

Reinstall area

[[File:leaseweb-clientarea-reinstall.jpg]]

Remote console

[[File:leaseweb-clientarea-ipmi.jpg]]

== Multilanguage support ==

The client area templates supports multi language. The available language files are available at "modules/servers/wmleaseweb/lang/", if you need to add support to a language not available, copy the file "english.php" to your language one( for example swedish.php" ) and translate the file strings.

2021-04-05T18:34:17Z

2021-04-05T18:30:33Z

Nathan: /* ADMIN ADDON AREA */

== INSTALL INSTRUCTIONS ==

1. Unzip the teamspeak3 zip file

2. Upload the "addons/teamspeak3" folder to your whmcs install location in the "modules/addons" folder

3. Upload the "server/teamspeak3" folder to your whmcs install location in the "modules/servers" folder

4. Upload the file "includes/hooks/teamspeak3.php" to your whmcs install location in the "includes/hooks/" folder.

== ADMIN ADDON SETUP ==

1. Enable the teamspeak 3 admin addon at "Setup->addon modules"

2. Click on activate link in the teamspeak 3 module

3. Select "Full administrator" access control

[[File: teamspeak_enable_addon.png]]

== ADMIN ADDON SETTINGS ==

1- Activate your module license in the "License" tab.

[[File: adminlicense.png]]

2- Set the default provisioning settings:

[[File: adminsettings.png]]

* Minimum port ( REQUIRED ): Minimum port range for teamspeak services.

* Maximum port ( REQUIRED ): Maximum port range for teamspeak services.

* Default server name ( OPTIONAL ): Default virtual server name.

* Host message ( OPTIONAL ): Server welcome message

* Host message mode ( OPTIONAL ): Server welcome message type.

* Banner Url ( OPTIONAL ): The image url to be shown in the teamspeak 3 client.

* Banner gfx url ( OPTIONAL ): The image to be shown in your teamspeak 3 client.

* Host button tooltip / url / icon ( OPTIONAL ): The teamspeak 3 client tooltip button settings.

* Default download/upload quota ( OPTIONAL ): The default server file quota size.

* Html viewer footer text ( OPTIONAL ): The text displayed in the HTML teamspeak 3 channel viewer.

3- Set the TSDNS provisioning settings ( OPTIONAL )

[[File: tsdns_settings.png]]

* Enable: Enable/disable TSDNS zone provisioning
* DNS zone domain: Default DNS zone domain
* DNS zone ip: Default DNS zone ip.
* Use Cloudflare: enable Cloudflare DNS provisioning
* Cloudflare email: Your Cloudflare account email
* Cloudflare api key: Your Cloudflare account api key
* Use TSDNS server: Enable eTSDNS server provisioning, deprecated and not supported in future updates.
* TSDNS API url: TSDNS api URL
* TSDNS API key: TSDNS api key

== PRODUCT SETUP ==

1. Create a welcome email template at "WHMCS->SETUP->EMAIL TEMPLATES"

Type: product

Unique name: teamspeak 3 welcome

Click on create button

Subject: your email subject

Body: Paste the text below

Ip: {$service_server_hostname}

Port: {$service_custom_fields.0}

Token admin: {$service_custom_fields.1}

Click on Save Changes button

[[File:welcome-email.jpg]]

2. Add a teamspeak 3 server:

WHMCS->SETUP->PRODUCTS/SERVICES->SERVERS->Add new server

Name: The server name

Hostname: Your server hostname , used for email templates for example ts3.mydomain.com. If you have TSDNS or cloudflare enabled the hostname MUST exists.

IP: The teamspeak 3 server ip

Type: teamspeak3

Username: The server query admin username ( by default serveradmin)

Password: The server admin query password

click "save"

Note: To test the connection click the "TEST" button. If you get a connection failed, verify that the port 10011 is opened in your whmcs hosting firewall.

[[File:server.jpg]]

3. Create a teamspeak 3 product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A name for you product, for example "teamspeak 3 plan 1"

Welcome email: welcome teamspeak 3

Module tab:

Module name: teamspeak 3

Server group: A server group in case you made server groups.

If you want to use fixed product slots settings instead of configurable options or it is a product adddon, check the "Fixed settings" checkbox.

Check "Automatically setup the product as soon as the first payment is received"

Add 2 text custom fields:

1- Port

2 - Token

IMPORTANT!!!!: DO NOT CHECK "admin only""Required field"/"Show on order form"/"Show on invoice"".

Save Changes

[[File:customfields.jpg]]

4) Create a Slots configurable option:

whmcs->setup->products/services->configurable options

Click "create new group" button

Group name : "Teamspeak 3"

Description: "Teamspeak 3"

In Assigned products select all your teamspeak 3 plans

Click "Add new configurable option" button Option

Name: "Slots" (Or the one you specified in the addon setting)

NOTE: its CASE SENSITIVE.

Option Type: Quantity

Add option: "1"

Click "save changes" button

Set the price for EACH slot.

Click "save changes" button.

[[File:coption.jpg]]

== TSDNS SUPPORT ( OPTIONAL ) ==

Teamspeak 3 offer a TSDNS server to be able to connect with the teamspeaks using just a domain instead of the ip:port but unfortunately it does not offer any api and requires you to manually add each teamspeak 3 virtual server domain. To be able to offer automatic TSDNS support with our addon we developed our own open source TSDNS server free to download and modify for anyone at https://github.com/nathanrod/nodejs-tsdns , once installed (check https://cp.whmcsmod.com/knowledgebase/29/Tsdns-server-install-and-setup.html ) your teamspeak 3 services will automatically create a subdomain for each service).

Once the TSDNS is installed and running just follow these steps to enable it:

1. Check "Enable TSDNS" in the addon settings

2. Set "Tsdns domain" with your tsdns domain in the addon settings. The domain must point to your tsdns ip, for example if your domain is myts3.com and the client use the subdomain "test", he should be able to connect with his service with test.myts3.com.

3. Set the "Tsdns api url" in the addon settings. By default the tsdns api server use the port 3000, if your tsdns servrer ip is 1.2.3.4 then your api url must be http://1.2.3.4:3000

4. Set the "Tsdns api key" api key. It's the api key set in the TSDNS server config.

5. Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.
subdomain

6. Add a A entry in your tsdns domain pointing to the tsdns server ip.

7. Add a SRV entry. For example if your tsdns domain is "myts3.com" the DNS entry must look like:

_tsdns._tcp.myts3.com 86400 IN SRV 5 0 41144 myts3.com

== CLOUDFLARE.COM SUPPORT ( OPTIONAL ) ==

1- Create an account at cloudflare.com ( if you don't have one already)

2- Create a "Global api key" in your account settings

3- Set "Tsdns domain" with your domain in the addon settings. If you want to offer subdomain for the domain "myts3.com", the value mut be myts3.com.

4- Add your domain in the cloudflare account

5- Check "Enable cloudflare" in the addon settings.

6- Fill the "cloudflare email/api key" field in the addon settings with the credentials provided by cloudflare.

7- Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.

[[File:subdomain.jpg]]

Every time a new service is created an A and a SRV entry will be created in your cloudflare dns zone. When a serivce is terminated those entries will be automatically removed.

Check https://docs.whmcsmod.com/index.php?title=Teamspeak3-cloudflare for additional info.

== REGION SUPPORT ( OPTIONAL ) ==

It is possible to display a region dropdown field in the order form to select the server region based on whmcs server groups.

For example if you have a server in London and another in California :

* Create a server group named "Teamspeak 3 London" ast SETUP->PRODUCTS->SERVERS
* Create a server group named "California" SETUP->PRODUCTS->SERVERS.
* Assign the whmcs teamspeak 3 server to each group.
* Create a product custom field named "region" :
** Check "required"
** Check "show on order form".
** Fill the "Select options" with the whmcs server group ids you want to display. If the "london" server group ID is 15 and the "California" server group id is 16 the value must be "15|London,16|California" . For custom field personalization check the "friendly custom fields" section at https://docs.whmcs.com/Custom_Fields .

[[File:region.jpg]]

== ADMIN ADDON AREA ==

In this area you can manage your teamspeak 3 servers and virtual servers.

'''Manage''': Display the list of virtual teamspeak 3 servers in the teamspeak 3 host.

[[File: admin_manage.png]]

'''Suspend''': Stop the teamspeak 3 virtual server.

'''Unsuspend''': Start the teamspeak 3 virtual server.

'''Delete''': Delete the teamspeak 3 virtual server.

'''Groups''': Manage the teamspeak 3 virtual server groups.

[[File:admin_manage.jpg]]

== CLIENT AREA ==

[[File:client_area.jpg]]

'''Start''': Start the teamspeak 3 server.

'''Stop''' : Stop the teamspeak 3 server.

'''Reset permission''' : Reset the teamspeak 3 server permissions to default.

'''Reinstall''': Reinstall the teamspeak 3 server. All tokens, channels and groups will be lost.

'''Settings''': Edit the teamspeak 3 server settings.

'''Bans''': Manage the teamspeak 3 server ban list.

'''Tokens''': Manage the teamspeak 3 server token list.

'''Snapshots''': Make a teamspeak 3 server backup.

'''Logs''': List the teamspeak 3 server logs.

'''Html viewer''': Displays a HTML code widget to use in your client web pages.

Teamspeak3

2021-04-05T18:30:22Z

Nathan: /* ADMIN ADDON AREA */

== INSTALL INSTRUCTIONS ==

1. Unzip the teamspeak3 zip file

2. Upload the "addons/teamspeak3" folder to your whmcs install location in the "modules/addons" folder

3. Upload the "server/teamspeak3" folder to your whmcs install location in the "modules/servers" folder

4. Upload the file "includes/hooks/teamspeak3.php" to your whmcs install location in the "includes/hooks/" folder.

== ADMIN ADDON SETUP ==

1. Enable the teamspeak 3 admin addon at "Setup->addon modules"

2. Click on activate link in the teamspeak 3 module

3. Select "Full administrator" access control

[[File: teamspeak_enable_addon.png]]

== ADMIN ADDON SETTINGS ==

1- Activate your module license in the "License" tab.

[[File: adminlicense.png]]

2- Set the default provisioning settings:

[[File: adminsettings.png]]

* Minimum port ( REQUIRED ): Minimum port range for teamspeak services.

* Maximum port ( REQUIRED ): Maximum port range for teamspeak services.

* Default server name ( OPTIONAL ): Default virtual server name.

* Host message ( OPTIONAL ): Server welcome message

* Host message mode ( OPTIONAL ): Server welcome message type.

* Banner Url ( OPTIONAL ): The image url to be shown in the teamspeak 3 client.

* Banner gfx url ( OPTIONAL ): The image to be shown in your teamspeak 3 client.

* Host button tooltip / url / icon ( OPTIONAL ): The teamspeak 3 client tooltip button settings.

* Default download/upload quota ( OPTIONAL ): The default server file quota size.

* Html viewer footer text ( OPTIONAL ): The text displayed in the HTML teamspeak 3 channel viewer.

3- Set the TSDNS provisioning settings ( OPTIONAL )

[[File: tsdns_settings.png]]

* Enable: Enable/disable TSDNS zone provisioning
* DNS zone domain: Default DNS zone domain
* DNS zone ip: Default DNS zone ip.
* Use Cloudflare: enable Cloudflare DNS provisioning
* Cloudflare email: Your Cloudflare account email
* Cloudflare api key: Your Cloudflare account api key
* Use TSDNS server: Enable eTSDNS server provisioning, deprecated and not supported in future updates.
* TSDNS API url: TSDNS api URL
* TSDNS API key: TSDNS api key

== PRODUCT SETUP ==

1. Create a welcome email template at "WHMCS->SETUP->EMAIL TEMPLATES"

Type: product

Unique name: teamspeak 3 welcome

Click on create button

Subject: your email subject

Body: Paste the text below

Ip: {$service_server_hostname}

Port: {$service_custom_fields.0}

Token admin: {$service_custom_fields.1}

Click on Save Changes button

[[File:welcome-email.jpg]]

2. Add a teamspeak 3 server:

WHMCS->SETUP->PRODUCTS/SERVICES->SERVERS->Add new server

Name: The server name

Hostname: Your server hostname , used for email templates for example ts3.mydomain.com. If you have TSDNS or cloudflare enabled the hostname MUST exists.

IP: The teamspeak 3 server ip

Type: teamspeak3

Username: The server query admin username ( by default serveradmin)

Password: The server admin query password

click "save"

Note: To test the connection click the "TEST" button. If you get a connection failed, verify that the port 10011 is opened in your whmcs hosting firewall.

[[File:server.jpg]]

3. Create a teamspeak 3 product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A name for you product, for example "teamspeak 3 plan 1"

Welcome email: welcome teamspeak 3

Module tab:

Module name: teamspeak 3

Server group: A server group in case you made server groups.

If you want to use fixed product slots settings instead of configurable options or it is a product adddon, check the "Fixed settings" checkbox.

Check "Automatically setup the product as soon as the first payment is received"

Add 2 text custom fields:

1- Port

2 - Token

IMPORTANT!!!!: DO NOT CHECK "admin only""Required field"/"Show on order form"/"Show on invoice"".

Save Changes

[[File:customfields.jpg]]

4) Create a Slots configurable option:

whmcs->setup->products/services->configurable options

Click "create new group" button

Group name : "Teamspeak 3"

Description: "Teamspeak 3"

In Assigned products select all your teamspeak 3 plans

Click "Add new configurable option" button Option

Name: "Slots" (Or the one you specified in the addon setting)

NOTE: its CASE SENSITIVE.

Option Type: Quantity

Add option: "1"

Click "save changes" button

Set the price for EACH slot.

Click "save changes" button.

[[File:coption.jpg]]

== TSDNS SUPPORT ( OPTIONAL ) ==

Teamspeak 3 offer a TSDNS server to be able to connect with the teamspeaks using just a domain instead of the ip:port but unfortunately it does not offer any api and requires you to manually add each teamspeak 3 virtual server domain. To be able to offer automatic TSDNS support with our addon we developed our own open source TSDNS server free to download and modify for anyone at https://github.com/nathanrod/nodejs-tsdns , once installed (check https://cp.whmcsmod.com/knowledgebase/29/Tsdns-server-install-and-setup.html ) your teamspeak 3 services will automatically create a subdomain for each service).

Once the TSDNS is installed and running just follow these steps to enable it:

1. Check "Enable TSDNS" in the addon settings

2. Set "Tsdns domain" with your tsdns domain in the addon settings. The domain must point to your tsdns ip, for example if your domain is myts3.com and the client use the subdomain "test", he should be able to connect with his service with test.myts3.com.

3. Set the "Tsdns api url" in the addon settings. By default the tsdns api server use the port 3000, if your tsdns servrer ip is 1.2.3.4 then your api url must be http://1.2.3.4:3000

4. Set the "Tsdns api key" api key. It's the api key set in the TSDNS server config.

5. Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.
subdomain

6. Add a A entry in your tsdns domain pointing to the tsdns server ip.

7. Add a SRV entry. For example if your tsdns domain is "myts3.com" the DNS entry must look like:

_tsdns._tcp.myts3.com 86400 IN SRV 5 0 41144 myts3.com

== CLOUDFLARE.COM SUPPORT ( OPTIONAL ) ==

1- Create an account at cloudflare.com ( if you don't have one already)

2- Create a "Global api key" in your account settings

3- Set "Tsdns domain" with your domain in the addon settings. If you want to offer subdomain for the domain "myts3.com", the value mut be myts3.com.

4- Add your domain in the cloudflare account

5- Check "Enable cloudflare" in the addon settings.

6- Fill the "cloudflare email/api key" field in the addon settings with the credentials provided by cloudflare.

7- Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.

[[File:subdomain.jpg]]

Every time a new service is created an A and a SRV entry will be created in your cloudflare dns zone. When a serivce is terminated those entries will be automatically removed.

Check https://docs.whmcsmod.com/index.php?title=Teamspeak3-cloudflare for additional info.

== REGION SUPPORT ( OPTIONAL ) ==

It is possible to display a region dropdown field in the order form to select the server region based on whmcs server groups.

For example if you have a server in London and another in California :

* Create a server group named "Teamspeak 3 London" ast SETUP->PRODUCTS->SERVERS
* Create a server group named "California" SETUP->PRODUCTS->SERVERS.
* Assign the whmcs teamspeak 3 server to each group.
* Create a product custom field named "region" :
** Check "required"
** Check "show on order form".
** Fill the "Select options" with the whmcs server group ids you want to display. If the "london" server group ID is 15 and the "California" server group id is 16 the value must be "15|London,16|California" . For custom field personalization check the "friendly custom fields" section at https://docs.whmcs.com/Custom_Fields .

[[File:region.jpg]]

== ADMIN ADDON AREA ==

In this area you can manage your teamspeak 3 servers and virtual servers.

'''Manage''': Display the list of virtual teamspeak 3 servers in the teamspeak 3 host.

[[File:: admin_manage.png]]

'''Suspend''': Stop the teamspeak 3 virtual server.

'''Unsuspend''': Start the teamspeak 3 virtual server.

'''Delete''': Delete the teamspeak 3 virtual server.

'''Groups''': Manage the teamspeak 3 virtual server groups.

[[File:admin_manage.jpg]]

== CLIENT AREA ==

[[File:client_area.jpg]]

'''Start''': Start the teamspeak 3 server.

'''Stop''' : Stop the teamspeak 3 server.

'''Reset permission''' : Reset the teamspeak 3 server permissions to default.

'''Reinstall''': Reinstall the teamspeak 3 server. All tokens, channels and groups will be lost.

'''Settings''': Edit the teamspeak 3 server settings.

'''Bans''': Manage the teamspeak 3 server ban list.

'''Tokens''': Manage the teamspeak 3 server token list.

'''Snapshots''': Make a teamspeak 3 server backup.

'''Logs''': List the teamspeak 3 server logs.

'''Html viewer''': Displays a HTML code widget to use in your client web pages.

Teamspeak3

2021-04-05T18:28:09Z

Nathan: /* ADMIN ADDON SETTINGS */

== INSTALL INSTRUCTIONS ==

1. Unzip the teamspeak3 zip file

2. Upload the "addons/teamspeak3" folder to your whmcs install location in the "modules/addons" folder

3. Upload the "server/teamspeak3" folder to your whmcs install location in the "modules/servers" folder

4. Upload the file "includes/hooks/teamspeak3.php" to your whmcs install location in the "includes/hooks/" folder.

== ADMIN ADDON SETUP ==

1. Enable the teamspeak 3 admin addon at "Setup->addon modules"

2. Click on activate link in the teamspeak 3 module

3. Select "Full administrator" access control

[[File: teamspeak_enable_addon.png]]

== ADMIN ADDON SETTINGS ==

1- Activate your module license in the "License" tab.

[[File: adminlicense.png]]

2- Set the default provisioning settings:

[[File: adminsettings.png]]

* Minimum port ( REQUIRED ): Minimum port range for teamspeak services.

* Maximum port ( REQUIRED ): Maximum port range for teamspeak services.

* Default server name ( OPTIONAL ): Default virtual server name.

* Host message ( OPTIONAL ): Server welcome message

* Host message mode ( OPTIONAL ): Server welcome message type.

* Banner Url ( OPTIONAL ): The image url to be shown in the teamspeak 3 client.

* Banner gfx url ( OPTIONAL ): The image to be shown in your teamspeak 3 client.

* Host button tooltip / url / icon ( OPTIONAL ): The teamspeak 3 client tooltip button settings.

* Default download/upload quota ( OPTIONAL ): The default server file quota size.

* Html viewer footer text ( OPTIONAL ): The text displayed in the HTML teamspeak 3 channel viewer.

3- Set the TSDNS provisioning settings ( OPTIONAL )

[[File: tsdns_settings.png]]

* Enable: Enable/disable TSDNS zone provisioning
* DNS zone domain: Default DNS zone domain
* DNS zone ip: Default DNS zone ip.
* Use Cloudflare: enable Cloudflare DNS provisioning
* Cloudflare email: Your Cloudflare account email
* Cloudflare api key: Your Cloudflare account api key
* Use TSDNS server: Enable eTSDNS server provisioning, deprecated and not supported in future updates.
* TSDNS API url: TSDNS api URL
* TSDNS API key: TSDNS api key

== PRODUCT SETUP ==

1. Create a welcome email template at "WHMCS->SETUP->EMAIL TEMPLATES"

Type: product

Unique name: teamspeak 3 welcome

Click on create button

Subject: your email subject

Body: Paste the text below

Ip: {$service_server_hostname}

Port: {$service_custom_fields.0}

Token admin: {$service_custom_fields.1}

Click on Save Changes button

[[File:welcome-email.jpg]]

2. Add a teamspeak 3 server:

WHMCS->SETUP->PRODUCTS/SERVICES->SERVERS->Add new server

Name: The server name

Hostname: Your server hostname , used for email templates for example ts3.mydomain.com. If you have TSDNS or cloudflare enabled the hostname MUST exists.

IP: The teamspeak 3 server ip

Type: teamspeak3

Username: The server query admin username ( by default serveradmin)

Password: The server admin query password

click "save"

Note: To test the connection click the "TEST" button. If you get a connection failed, verify that the port 10011 is opened in your whmcs hosting firewall.

[[File:server.jpg]]

3. Create a teamspeak 3 product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A name for you product, for example "teamspeak 3 plan 1"

Welcome email: welcome teamspeak 3

Module tab:

Module name: teamspeak 3

Server group: A server group in case you made server groups.

If you want to use fixed product slots settings instead of configurable options or it is a product adddon, check the "Fixed settings" checkbox.

Check "Automatically setup the product as soon as the first payment is received"

Add 2 text custom fields:

1- Port

2 - Token

IMPORTANT!!!!: DO NOT CHECK "admin only""Required field"/"Show on order form"/"Show on invoice"".

Save Changes

[[File:customfields.jpg]]

4) Create a Slots configurable option:

whmcs->setup->products/services->configurable options

Click "create new group" button

Group name : "Teamspeak 3"

Description: "Teamspeak 3"

In Assigned products select all your teamspeak 3 plans

Click "Add new configurable option" button Option

Name: "Slots" (Or the one you specified in the addon setting)

NOTE: its CASE SENSITIVE.

Option Type: Quantity

Add option: "1"

Click "save changes" button

Set the price for EACH slot.

Click "save changes" button.

[[File:coption.jpg]]

== TSDNS SUPPORT ( OPTIONAL ) ==

Teamspeak 3 offer a TSDNS server to be able to connect with the teamspeaks using just a domain instead of the ip:port but unfortunately it does not offer any api and requires you to manually add each teamspeak 3 virtual server domain. To be able to offer automatic TSDNS support with our addon we developed our own open source TSDNS server free to download and modify for anyone at https://github.com/nathanrod/nodejs-tsdns , once installed (check https://cp.whmcsmod.com/knowledgebase/29/Tsdns-server-install-and-setup.html ) your teamspeak 3 services will automatically create a subdomain for each service).

Once the TSDNS is installed and running just follow these steps to enable it:

1. Check "Enable TSDNS" in the addon settings

2. Set "Tsdns domain" with your tsdns domain in the addon settings. The domain must point to your tsdns ip, for example if your domain is myts3.com and the client use the subdomain "test", he should be able to connect with his service with test.myts3.com.

3. Set the "Tsdns api url" in the addon settings. By default the tsdns api server use the port 3000, if your tsdns servrer ip is 1.2.3.4 then your api url must be http://1.2.3.4:3000

4. Set the "Tsdns api key" api key. It's the api key set in the TSDNS server config.

5. Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.
subdomain

6. Add a A entry in your tsdns domain pointing to the tsdns server ip.

7. Add a SRV entry. For example if your tsdns domain is "myts3.com" the DNS entry must look like:

_tsdns._tcp.myts3.com 86400 IN SRV 5 0 41144 myts3.com

== CLOUDFLARE.COM SUPPORT ( OPTIONAL ) ==

1- Create an account at cloudflare.com ( if you don't have one already)

2- Create a "Global api key" in your account settings

3- Set "Tsdns domain" with your domain in the addon settings. If you want to offer subdomain for the domain "myts3.com", the value mut be myts3.com.

4- Add your domain in the cloudflare account

5- Check "Enable cloudflare" in the addon settings.

6- Fill the "cloudflare email/api key" field in the addon settings with the credentials provided by cloudflare.

7- Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.

[[File:subdomain.jpg]]

Every time a new service is created an A and a SRV entry will be created in your cloudflare dns zone. When a serivce is terminated those entries will be automatically removed.

Check https://docs.whmcsmod.com/index.php?title=Teamspeak3-cloudflare for additional info.

== REGION SUPPORT ( OPTIONAL ) ==

It is possible to display a region dropdown field in the order form to select the server region based on whmcs server groups.

For example if you have a server in London and another in California :

* Create a server group named "Teamspeak 3 London" ast SETUP->PRODUCTS->SERVERS
* Create a server group named "California" SETUP->PRODUCTS->SERVERS.
* Assign the whmcs teamspeak 3 server to each group.
* Create a product custom field named "region" :
** Check "required"
** Check "show on order form".
** Fill the "Select options" with the whmcs server group ids you want to display. If the "london" server group ID is 15 and the "California" server group id is 16 the value must be "15|London,16|California" . For custom field personalization check the "friendly custom fields" section at https://docs.whmcs.com/Custom_Fields .

[[File:region.jpg]]

== ADMIN ADDON AREA ==

In this area you can manage your teamspeak 3 servers and virtual servers.

'''Manage''': Display the list of virtual teamspeak 3 servers in the teamspeak 3 host.

'''Security''': Will run a group permission check in all the host teamspeak 3 server.

[[File:admin_area.jpg]]

'''Suspend''': Stop the teamspeak 3 virtual server.

'''Unsuspend''': Start the teamspeak 3 virtual server.

'''Delete''': Delete the teamspeak 3 virtual server.

'''Groups''': Manage the teamspeak 3 virtual server groups.

[[File:admin_manage.jpg]]

== CLIENT AREA ==

[[File:client_area.jpg]]

'''Start''': Start the teamspeak 3 server.

'''Stop''' : Stop the teamspeak 3 server.

'''Reset permission''' : Reset the teamspeak 3 server permissions to default.

'''Reinstall''': Reinstall the teamspeak 3 server. All tokens, channels and groups will be lost.

'''Settings''': Edit the teamspeak 3 server settings.

'''Bans''': Manage the teamspeak 3 server ban list.

'''Tokens''': Manage the teamspeak 3 server token list.

'''Snapshots''': Make a teamspeak 3 server backup.

'''Logs''': List the teamspeak 3 server logs.

'''Html viewer''': Displays a HTML code widget to use in your client web pages.

File:Tsdns settings.png

2021-04-05T18:24:00Z

Nathan:

Teamspeak3

2021-04-05T18:23:44Z

Nathan: /* ADMIN ADDON SETTINGS */

== INSTALL INSTRUCTIONS ==

1. Unzip the teamspeak3 zip file

2. Upload the "addons/teamspeak3" folder to your whmcs install location in the "modules/addons" folder

3. Upload the "server/teamspeak3" folder to your whmcs install location in the "modules/servers" folder

4. Upload the file "includes/hooks/teamspeak3.php" to your whmcs install location in the "includes/hooks/" folder.

== ADMIN ADDON SETUP ==

1. Enable the teamspeak 3 admin addon at "Setup->addon modules"

2. Click on activate link in the teamspeak 3 module

3. Select "Full administrator" access control

[[File: teamspeak_enable_addon.png]]

== ADMIN ADDON SETTINGS ==

1- Activate your module license in the "License" tab.

[[File: adminlicense.png]]

2- Set the default provisioning settings:

[[File: adminsettings.png]]

* Minimum port ( REQUIRED ): Minimum port range for teamspeak services.

* Maximum port ( REQUIRED ): Maximum port range for teamspeak services.

* Default server name ( OPTIONAL ): Default virtual server name.

* Host message ( OPTIONAL ): Server welcome message

* Host message mode ( OPTIONAL ): Server welcome message type.

* Banner Url ( OPTIONAL ): The image url to be shown in the teamspeak 3 client.

* Banner gfx url ( OPTIONAL ): The image to be shown in your teamspeak 3 client.

* Host button tooltip / url / icon ( OPTIONAL ): The teamspeak 3 client tooltip button settings.

* Default download/upload quota ( OPTIONAL ): The default server file quota size.

* Html viewer footer text ( OPTIONAL ): The text displayed in the HTML teamspeak 3 channel viewer.

3- Set the TSDNS provisioning settings ( OPTIONAL )

[[File: tsdns_settings.png]]

== PRODUCT SETUP ==

1. Create a welcome email template at "WHMCS->SETUP->EMAIL TEMPLATES"

Type: product

Unique name: teamspeak 3 welcome

Click on create button

Subject: your email subject

Body: Paste the text below

Ip: {$service_server_hostname}

Port: {$service_custom_fields.0}

Token admin: {$service_custom_fields.1}

Click on Save Changes button

[[File:welcome-email.jpg]]

2. Add a teamspeak 3 server:

WHMCS->SETUP->PRODUCTS/SERVICES->SERVERS->Add new server

Name: The server name

Hostname: Your server hostname , used for email templates for example ts3.mydomain.com. If you have TSDNS or cloudflare enabled the hostname MUST exists.

IP: The teamspeak 3 server ip

Type: teamspeak3

Username: The server query admin username ( by default serveradmin)

Password: The server admin query password

click "save"

Note: To test the connection click the "TEST" button. If you get a connection failed, verify that the port 10011 is opened in your whmcs hosting firewall.

[[File:server.jpg]]

3. Create a teamspeak 3 product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A name for you product, for example "teamspeak 3 plan 1"

Welcome email: welcome teamspeak 3

Module tab:

Module name: teamspeak 3

Server group: A server group in case you made server groups.

If you want to use fixed product slots settings instead of configurable options or it is a product adddon, check the "Fixed settings" checkbox.

Check "Automatically setup the product as soon as the first payment is received"

Add 2 text custom fields:

1- Port

2 - Token

IMPORTANT!!!!: DO NOT CHECK "admin only""Required field"/"Show on order form"/"Show on invoice"".

Save Changes

[[File:customfields.jpg]]

4) Create a Slots configurable option:

whmcs->setup->products/services->configurable options

Click "create new group" button

Group name : "Teamspeak 3"

Description: "Teamspeak 3"

In Assigned products select all your teamspeak 3 plans

Click "Add new configurable option" button Option

Name: "Slots" (Or the one you specified in the addon setting)

NOTE: its CASE SENSITIVE.

Option Type: Quantity

Add option: "1"

Click "save changes" button

Set the price for EACH slot.

Click "save changes" button.

[[File:coption.jpg]]

== TSDNS SUPPORT ( OPTIONAL ) ==

Teamspeak 3 offer a TSDNS server to be able to connect with the teamspeaks using just a domain instead of the ip:port but unfortunately it does not offer any api and requires you to manually add each teamspeak 3 virtual server domain. To be able to offer automatic TSDNS support with our addon we developed our own open source TSDNS server free to download and modify for anyone at https://github.com/nathanrod/nodejs-tsdns , once installed (check https://cp.whmcsmod.com/knowledgebase/29/Tsdns-server-install-and-setup.html ) your teamspeak 3 services will automatically create a subdomain for each service).

Once the TSDNS is installed and running just follow these steps to enable it:

1. Check "Enable TSDNS" in the addon settings

2. Set "Tsdns domain" with your tsdns domain in the addon settings. The domain must point to your tsdns ip, for example if your domain is myts3.com and the client use the subdomain "test", he should be able to connect with his service with test.myts3.com.

3. Set the "Tsdns api url" in the addon settings. By default the tsdns api server use the port 3000, if your tsdns servrer ip is 1.2.3.4 then your api url must be http://1.2.3.4:3000

4. Set the "Tsdns api key" api key. It's the api key set in the TSDNS server config.

5. Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.
subdomain

6. Add a A entry in your tsdns domain pointing to the tsdns server ip.

7. Add a SRV entry. For example if your tsdns domain is "myts3.com" the DNS entry must look like:

_tsdns._tcp.myts3.com 86400 IN SRV 5 0 41144 myts3.com

== CLOUDFLARE.COM SUPPORT ( OPTIONAL ) ==

1- Create an account at cloudflare.com ( if you don't have one already)

2- Create a "Global api key" in your account settings

3- Set "Tsdns domain" with your domain in the addon settings. If you want to offer subdomain for the domain "myts3.com", the value mut be myts3.com.

4- Add your domain in the cloudflare account

5- Check "Enable cloudflare" in the addon settings.

6- Fill the "cloudflare email/api key" field in the addon settings with the credentials provided by cloudflare.

7- Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.

[[File:subdomain.jpg]]

Every time a new service is created an A and a SRV entry will be created in your cloudflare dns zone. When a serivce is terminated those entries will be automatically removed.

Check https://docs.whmcsmod.com/index.php?title=Teamspeak3-cloudflare for additional info.

== REGION SUPPORT ( OPTIONAL ) ==

It is possible to display a region dropdown field in the order form to select the server region based on whmcs server groups.

For example if you have a server in London and another in California :

* Create a server group named "Teamspeak 3 London" ast SETUP->PRODUCTS->SERVERS
* Create a server group named "California" SETUP->PRODUCTS->SERVERS.
* Assign the whmcs teamspeak 3 server to each group.
* Create a product custom field named "region" :
** Check "required"
** Check "show on order form".
** Fill the "Select options" with the whmcs server group ids you want to display. If the "london" server group ID is 15 and the "California" server group id is 16 the value must be "15|London,16|California" . For custom field personalization check the "friendly custom fields" section at https://docs.whmcs.com/Custom_Fields .

[[File:region.jpg]]

== ADMIN ADDON AREA ==

In this area you can manage your teamspeak 3 servers and virtual servers.

'''Manage''': Display the list of virtual teamspeak 3 servers in the teamspeak 3 host.

'''Security''': Will run a group permission check in all the host teamspeak 3 server.

[[File:admin_area.jpg]]

'''Suspend''': Stop the teamspeak 3 virtual server.

'''Unsuspend''': Start the teamspeak 3 virtual server.

'''Delete''': Delete the teamspeak 3 virtual server.

'''Groups''': Manage the teamspeak 3 virtual server groups.

[[File:admin_manage.jpg]]

== CLIENT AREA ==

[[File:client_area.jpg]]

'''Start''': Start the teamspeak 3 server.

'''Stop''' : Stop the teamspeak 3 server.

'''Reset permission''' : Reset the teamspeak 3 server permissions to default.

'''Reinstall''': Reinstall the teamspeak 3 server. All tokens, channels and groups will be lost.

'''Settings''': Edit the teamspeak 3 server settings.

'''Bans''': Manage the teamspeak 3 server ban list.

'''Tokens''': Manage the teamspeak 3 server token list.

'''Snapshots''': Make a teamspeak 3 server backup.

'''Logs''': List the teamspeak 3 server logs.

'''Html viewer''': Displays a HTML code widget to use in your client web pages.

Teamspeak3

2021-04-05T18:22:55Z

2021-04-05T18:19:08Z

Nathan: /* ADMIN ADDON SETTINGS */

== INSTALL INSTRUCTIONS ==

1. Unzip the teamspeak3 zip file

2. Upload the "addons/teamspeak3" folder to your whmcs install location in the "modules/addons" folder

3. Upload the "server/teamspeak3" folder to your whmcs install location in the "modules/servers" folder

4. Upload the file "includes/hooks/teamspeak3.php" to your whmcs install location in the "includes/hooks/" folder.

== ADMIN ADDON SETUP ==

1. Enable the teamspeak 3 admin addon at "Setup->addon modules"

2. Click on activate link in the teamspeak 3 module

3. Select "Full administrator" access control

[[File: teamspeak_enable_addon.png]]

== ADMIN ADDON SETTINGS ==

Activate your module license in the "License" tab.

[[File:: adminlicense.png]]

* Minimum port ( REQUIRED ): Minimum port range for teamspeak services.

* Maximum port ( REQUIRED ): Maximum port range for teamspeak services.

* Default server name ( OPTIONAL ): Default virtual server name.

* Host message ( OPTIONAL ): Server welcome message

* Host message mode ( OPTIONAL ): Server welcome message type.

* Banner Url ( OPTIONAL ): The image url to be shown in the teamspeak 3 client.

* Banner gfx url ( OPTIONAL ): The image to be shown in your teamspeak 3 client.

* Host button tooltip / url / icon ( OPTIONAL ): The teamspeak 3 client tooltip button settings.

* Default download/upload quota ( OPTIONAL ): The default server file quota size.

* Viewer provided by text ( OPTIONAL ): The text displayed in the HTML teamspeak 3 channel viewer.

* TSDNS/Cloudflare settings ( OPTIONAL ): check the "TSDNS SUPPORT"/"CLOUDFLARE SUPPORT" step.

* Configurable option name for service slots ( OPTIONAL ): Your configurable option name for the service slots.

* Module license( REQUIRED ): The license whmcsmod.com provided you. Example: LEASED-1234567890

* Access Control: Click Full administrator or the admin role you have assigned.

[[File:addon setup.jpg]]

== PRODUCT SETUP ==

1. Create a welcome email template at "WHMCS->SETUP->EMAIL TEMPLATES"

Type: product

Unique name: teamspeak 3 welcome

Click on create button

Subject: your email subject

Body: Paste the text below

Ip: {$service_server_hostname}

Port: {$service_custom_fields.0}

Token admin: {$service_custom_fields.1}

Click on Save Changes button

[[File:welcome-email.jpg]]

2. Add a teamspeak 3 server:

WHMCS->SETUP->PRODUCTS/SERVICES->SERVERS->Add new server

Name: The server name

Hostname: Your server hostname , used for email templates for example ts3.mydomain.com. If you have TSDNS or cloudflare enabled the hostname MUST exists.

IP: The teamspeak 3 server ip

Type: teamspeak3

Username: The server query admin username ( by default serveradmin)

Password: The server admin query password

click "save"

Note: To test the connection click the "TEST" button. If you get a connection failed, verify that the port 10011 is opened in your whmcs hosting firewall.

[[File:server.jpg]]

3. Create a teamspeak 3 product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A name for you product, for example "teamspeak 3 plan 1"

Welcome email: welcome teamspeak 3

Module tab:

Module name: teamspeak 3

Server group: A server group in case you made server groups.

If you want to use fixed product slots settings instead of configurable options or it is a product adddon, check the "Fixed settings" checkbox.

Check "Automatically setup the product as soon as the first payment is received"

Add 2 text custom fields:

1- Port

2 - Token

IMPORTANT!!!!: DO NOT CHECK "admin only""Required field"/"Show on order form"/"Show on invoice"".

Save Changes

[[File:customfields.jpg]]

4) Create a Slots configurable option:

whmcs->setup->products/services->configurable options

Click "create new group" button

Group name : "Teamspeak 3"

Description: "Teamspeak 3"

In Assigned products select all your teamspeak 3 plans

Click "Add new configurable option" button Option

Name: "Slots" (Or the one you specified in the addon setting)

NOTE: its CASE SENSITIVE.

Option Type: Quantity

Add option: "1"

Click "save changes" button

Set the price for EACH slot.

Click "save changes" button.

[[File:coption.jpg]]

== TSDNS SUPPORT ( OPTIONAL ) ==

Teamspeak 3 offer a TSDNS server to be able to connect with the teamspeaks using just a domain instead of the ip:port but unfortunately it does not offer any api and requires you to manually add each teamspeak 3 virtual server domain. To be able to offer automatic TSDNS support with our addon we developed our own open source TSDNS server free to download and modify for anyone at https://github.com/nathanrod/nodejs-tsdns , once installed (check https://cp.whmcsmod.com/knowledgebase/29/Tsdns-server-install-and-setup.html ) your teamspeak 3 services will automatically create a subdomain for each service).

Once the TSDNS is installed and running just follow these steps to enable it:

1. Check "Enable TSDNS" in the addon settings

2. Set "Tsdns domain" with your tsdns domain in the addon settings. The domain must point to your tsdns ip, for example if your domain is myts3.com and the client use the subdomain "test", he should be able to connect with his service with test.myts3.com.

3. Set the "Tsdns api url" in the addon settings. By default the tsdns api server use the port 3000, if your tsdns servrer ip is 1.2.3.4 then your api url must be http://1.2.3.4:3000

4. Set the "Tsdns api key" api key. It's the api key set in the TSDNS server config.

5. Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.
subdomain

6. Add a A entry in your tsdns domain pointing to the tsdns server ip.

7. Add a SRV entry. For example if your tsdns domain is "myts3.com" the DNS entry must look like:

_tsdns._tcp.myts3.com 86400 IN SRV 5 0 41144 myts3.com

== CLOUDFLARE.COM SUPPORT ( OPTIONAL ) ==

1- Create an account at cloudflare.com ( if you don't have one already)

2- Create a "Global api key" in your account settings

3- Set "Tsdns domain" with your domain in the addon settings. If you want to offer subdomain for the domain "myts3.com", the value mut be myts3.com.

4- Add your domain in the cloudflare account

5- Check "Enable cloudflare" in the addon settings.

6- Fill the "cloudflare email/api key" field in the addon settings with the credentials provided by cloudflare.

7- Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.

[[File:subdomain.jpg]]

Every time a new service is created an A and a SRV entry will be created in your cloudflare dns zone. When a serivce is terminated those entries will be automatically removed.

Check https://docs.whmcsmod.com/index.php?title=Teamspeak3-cloudflare for additional info.

== REGION SUPPORT ( OPTIONAL ) ==

It is possible to display a region dropdown field in the order form to select the server region based on whmcs server groups.

For example if you have a server in London and another in California :

* Create a server group named "Teamspeak 3 London" ast SETUP->PRODUCTS->SERVERS
* Create a server group named "California" SETUP->PRODUCTS->SERVERS.
* Assign the whmcs teamspeak 3 server to each group.
* Create a product custom field named "region" :
** Check "required"
** Check "show on order form".
** Fill the "Select options" with the whmcs server group ids you want to display. If the "london" server group ID is 15 and the "California" server group id is 16 the value must be "15|London,16|California" . For custom field personalization check the "friendly custom fields" section at https://docs.whmcs.com/Custom_Fields .

[[File:region.jpg]]

== ADMIN ADDON AREA ==

In this area you can manage your teamspeak 3 servers and virtual servers.

'''Manage''': Display the list of virtual teamspeak 3 servers in the teamspeak 3 host.

'''Security''': Will run a group permission check in all the host teamspeak 3 server.

[[File:admin_area.jpg]]

'''Suspend''': Stop the teamspeak 3 virtual server.

'''Unsuspend''': Start the teamspeak 3 virtual server.

'''Delete''': Delete the teamspeak 3 virtual server.

'''Groups''': Manage the teamspeak 3 virtual server groups.

[[File:admin_manage.jpg]]

== CLIENT AREA ==

[[File:client_area.jpg]]

'''Start''': Start the teamspeak 3 server.

'''Stop''' : Stop the teamspeak 3 server.

'''Reset permission''' : Reset the teamspeak 3 server permissions to default.

'''Reinstall''': Reinstall the teamspeak 3 server. All tokens, channels and groups will be lost.

'''Settings''': Edit the teamspeak 3 server settings.

'''Bans''': Manage the teamspeak 3 server ban list.

'''Tokens''': Manage the teamspeak 3 server token list.

'''Snapshots''': Make a teamspeak 3 server backup.

'''Logs''': List the teamspeak 3 server logs.

'''Html viewer''': Displays a HTML code widget to use in your client web pages.

File:Teamspeak enable addon.png

2021-04-05T18:15:10Z

Nathan:

Teamspeak3

2021-04-05T18:14:06Z

Nathan: /* ADMIN ADDON SETUP */

== INSTALL INSTRUCTIONS ==

1. Unzip the teamspeak3 zip file

2. Upload the "addons/teamspeak3" folder to your whmcs install location in the "modules/addons" folder

3. Upload the "server/teamspeak3" folder to your whmcs install location in the "modules/servers" folder

4. Upload the file "includes/hooks/teamspeak3.php" to your whmcs install location in the "includes/hooks/" folder.

== ADMIN ADDON SETUP ==

1. Enable the teamspeak 3 admin addon at "Setup->addon modules"

2. Click on activate link in the teamspeak 3 module

3. Select "Full administrator" access control

[[File: teamspeak_enable_addon.png]]

== ADMIN ADDON SETTINGS ==

* Minimum port ( REQUIRED ): Minimum port range for teamspeak services.

* Maximum port ( REQUIRED ): Maximum port range for teamspeak services.

* Default server name ( OPTIONAL ): Default virtual server name.

* Host message ( OPTIONAL ): Server welcome message

* Host message mode ( OPTIONAL ): Server welcome message type.

* Banner Url ( OPTIONAL ): The image url to be shown in the teamspeak 3 client.

* Banner gfx url ( OPTIONAL ): The image to be shown in your teamspeak 3 client.

* Host button tooltip / url / icon ( OPTIONAL ): The teamspeak 3 client tooltip button settings.

* Default download/upload quota ( OPTIONAL ): The default server file quota size.

* Viewer provided by text ( OPTIONAL ): The text displayed in the HTML teamspeak 3 channel viewer.

* TSDNS/Cloudflare settings ( OPTIONAL ): check the "TSDNS SUPPORT"/"CLOUDFLARE SUPPORT" step.

* Configurable option name for service slots ( OPTIONAL ): Your configurable option name for the service slots.

* Module license( REQUIRED ): The license whmcsmod.com provided you. Example: LEASED-1234567890

* Access Control: Click Full administrator or the admin role you have assigned.

[[File:addon setup.jpg]]

== PRODUCT SETUP ==

1. Create a welcome email template at "WHMCS->SETUP->EMAIL TEMPLATES"

Type: product

Unique name: teamspeak 3 welcome

Click on create button

Subject: your email subject

Body: Paste the text below

Ip: {$service_server_hostname}

Port: {$service_custom_fields.0}

Token admin: {$service_custom_fields.1}

Click on Save Changes button

[[File:welcome-email.jpg]]

2. Add a teamspeak 3 server:

WHMCS->SETUP->PRODUCTS/SERVICES->SERVERS->Add new server

Name: The server name

Hostname: Your server hostname , used for email templates for example ts3.mydomain.com. If you have TSDNS or cloudflare enabled the hostname MUST exists.

IP: The teamspeak 3 server ip

Type: teamspeak3

Username: The server query admin username ( by default serveradmin)

Password: The server admin query password

click "save"

Note: To test the connection click the "TEST" button. If you get a connection failed, verify that the port 10011 is opened in your whmcs hosting firewall.

[[File:server.jpg]]

3. Create a teamspeak 3 product:

WHMCS->SETUP->PRODUCTS/SERVICES->Create a new product

Details tab:

Product type: other

Product name: A name for you product, for example "teamspeak 3 plan 1"

Welcome email: welcome teamspeak 3

Module tab:

Module name: teamspeak 3

Server group: A server group in case you made server groups.

If you want to use fixed product slots settings instead of configurable options or it is a product adddon, check the "Fixed settings" checkbox.

Check "Automatically setup the product as soon as the first payment is received"

Add 2 text custom fields:

1- Port

2 - Token

IMPORTANT!!!!: DO NOT CHECK "admin only""Required field"/"Show on order form"/"Show on invoice"".

Save Changes

[[File:customfields.jpg]]

4) Create a Slots configurable option:

whmcs->setup->products/services->configurable options

Click "create new group" button

Group name : "Teamspeak 3"

Description: "Teamspeak 3"

In Assigned products select all your teamspeak 3 plans

Click "Add new configurable option" button Option

Name: "Slots" (Or the one you specified in the addon setting)

NOTE: its CASE SENSITIVE.

Option Type: Quantity

Add option: "1"

Click "save changes" button

Set the price for EACH slot.

Click "save changes" button.

[[File:coption.jpg]]

== TSDNS SUPPORT ( OPTIONAL ) ==

Teamspeak 3 offer a TSDNS server to be able to connect with the teamspeaks using just a domain instead of the ip:port but unfortunately it does not offer any api and requires you to manually add each teamspeak 3 virtual server domain. To be able to offer automatic TSDNS support with our addon we developed our own open source TSDNS server free to download and modify for anyone at https://github.com/nathanrod/nodejs-tsdns , once installed (check https://cp.whmcsmod.com/knowledgebase/29/Tsdns-server-install-and-setup.html ) your teamspeak 3 services will automatically create a subdomain for each service).

Once the TSDNS is installed and running just follow these steps to enable it:

1. Check "Enable TSDNS" in the addon settings

2. Set "Tsdns domain" with your tsdns domain in the addon settings. The domain must point to your tsdns ip, for example if your domain is myts3.com and the client use the subdomain "test", he should be able to connect with his service with test.myts3.com.

3. Set the "Tsdns api url" in the addon settings. By default the tsdns api server use the port 3000, if your tsdns servrer ip is 1.2.3.4 then your api url must be http://1.2.3.4:3000

4. Set the "Tsdns api key" api key. It's the api key set in the TSDNS server config.

5. Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.
subdomain

6. Add a A entry in your tsdns domain pointing to the tsdns server ip.

7. Add a SRV entry. For example if your tsdns domain is "myts3.com" the DNS entry must look like:

_tsdns._tcp.myts3.com 86400 IN SRV 5 0 41144 myts3.com

== CLOUDFLARE.COM SUPPORT ( OPTIONAL ) ==

1- Create an account at cloudflare.com ( if you don't have one already)

2- Create a "Global api key" in your account settings

3- Set "Tsdns domain" with your domain in the addon settings. If you want to offer subdomain for the domain "myts3.com", the value mut be myts3.com.

4- Add your domain in the cloudflare account

5- Check "Enable cloudflare" in the addon settings.

6- Fill the "cloudflare email/api key" field in the addon settings with the credentials provided by cloudflare.

7- Add custom field named "Subdomain" to each one of your teamspeak 3 products and check the "required"/"show on order form" options.

[[File:subdomain.jpg]]

Every time a new service is created an A and a SRV entry will be created in your cloudflare dns zone. When a serivce is terminated those entries will be automatically removed.

Check https://docs.whmcsmod.com/index.php?title=Teamspeak3-cloudflare for additional info.

== REGION SUPPORT ( OPTIONAL ) ==

It is possible to display a region dropdown field in the order form to select the server region based on whmcs server groups.

For example if you have a server in London and another in California :

* Create a server group named "Teamspeak 3 London" ast SETUP->PRODUCTS->SERVERS
* Create a server group named "California" SETUP->PRODUCTS->SERVERS.
* Assign the whmcs teamspeak 3 server to each group.
* Create a product custom field named "region" :
** Check "required"
** Check "show on order form".
** Fill the "Select options" with the whmcs server group ids you want to display. If the "london" server group ID is 15 and the "California" server group id is 16 the value must be "15|London,16|California" . For custom field personalization check the "friendly custom fields" section at https://docs.whmcs.com/Custom_Fields .

[[File:region.jpg]]

== ADMIN ADDON AREA ==

In this area you can manage your teamspeak 3 servers and virtual servers.

'''Manage''': Display the list of virtual teamspeak 3 servers in the teamspeak 3 host.

'''Security''': Will run a group permission check in all the host teamspeak 3 server.

[[File:admin_area.jpg]]

'''Suspend''': Stop the teamspeak 3 virtual server.

'''Unsuspend''': Start the teamspeak 3 virtual server.

'''Delete''': Delete the teamspeak 3 virtual server.

'''Groups''': Manage the teamspeak 3 virtual server groups.

[[File:admin_manage.jpg]]

== CLIENT AREA ==

[[File:client_area.jpg]]

'''Start''': Start the teamspeak 3 server.

'''Stop''' : Stop the teamspeak 3 server.

'''Reset permission''' : Reset the teamspeak 3 server permissions to default.

'''Reinstall''': Reinstall the teamspeak 3 server. All tokens, channels and groups will be lost.

'''Settings''': Edit the teamspeak 3 server settings.

'''Bans''': Manage the teamspeak 3 server ban list.

'''Tokens''': Manage the teamspeak 3 server token list.

'''Snapshots''': Make a teamspeak 3 server backup.

'''Logs''': List the teamspeak 3 server logs.

'''Html viewer''': Displays a HTML code widget to use in your client web pages.