Revision as of 15:45, 18 November 2011 (view source) John (talk | contribs) m (→‎Package Setup/Configuration) ← Older edit		Latest revision as of 17:12, 28 August 2023 (view source) SarahK (talk | contribs)
(17 intermediate revisions by 5 users not shown)
Line 1:		Line 1:
−	Heart Internet is a UK based reseller web hosting and domain name provider and in WHMCS we have modules for both their '''hosting and domain reseller API's'''.	+	== About this Module ==
−	You can download the Heart Internet modules @ [http://www.whmcs.com/members/dl.php?type=d&id=52 www.whmcs.com/members/dl.php?type=d&id=52] '''(Updated 28th September 2011)''' and to install simply upload the files to the modules folder of your WHMCS installation. Then follow the guides below for setting up and configuring the modules.	+	<div class="docs-alert-info">
		+	We removed this module in WHMCS 8.8. Heart Internet discontinued support for its API in February 2023. As a result, this module no longer functions on any version of WHMCS.
		+	</div>
−	==Hosting Module==	+	Heart Internet is a UK based reseller web hosting and domain name provider.
−	===Supported Functionality===	+	<div class="docs-alert-info">
		+	For the Heart Internet domain registration module, see [[Heart Internet Domains]].
		+	</div>
		+	{{Provisioning_Module
		+	| changepackage = Yes
		+	| changepw = Yes
		+	| clientarealink = Yes
		+	| port = 700(live) & 1701(test)}}
		+	== Adding a Heart Internet Server ==
		+
		+	To set up a Heart Internet server in WHMCS:
		+
		+	# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Servers]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
		+	# Click '''Add New Server'''.
		+	# Select ''Heart Internet'' from the menu.
		+	# Enter the hostname or IP address.
		+	# Enter the username and password or the access hash. You can obtain your username and password from [https://customer.heartinternet.co.uk/manage/api Heart's API].
		+	# Click '''Continue'''.
		+	# Enter the desired additional server details.
		+	# Click '''Save Changes'''.
		+	# If this is the only Heart Internet server that is currently in WHMCS, click on the name and ensure that it results in an asterisk (*) next to it. This indicates that it is the default to use when any other non-specific configuration doesn't apply.
−	*Account Creation	+	=== Creating a Heart Internet Product ===
−	*Suspension	+
−	*Unsuspension	+	You can create a product that provisions accounts on your Heart Internet server at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products_and_Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.
−	*Account Termination
−	*Automatic Upgrades/Downgrades
−	*Password Resets (from Client & Admin Area)
−	*Automatic Login
−	===Package Setup/Configuration===	+	=== WHMCS Connect ===
−	Begin by going to '''Setup > Servers''' and adding a new server. The name can be anything you want, the module must be set as "Heartinternet" and your Username & Password for Heart's API (which can be obtained from https://customer.heartinternet.co.uk/manage/api) needs to be entered into the appropriate fields. The other fields of the server profile are all optional.	+	This module does not support [[WHMCS Connect]].
−	Next it's onto the products. If you already have your packages setup then just edit those to add the Heart settings, but if not then create a new product in the normal way from '''Setup > Products/Services''', and then on the '''Module Settings''' tab select "Heartinternet" from the dropdown.  There you'll find 2 fields - Test Mode & Package ID.  Enter the Package ID which should be a value you can get from inside your heart control panel and then select the automation setting you want for orders of this item (ie. auto setup on first payment, or only after accepting the pending order, etc..) then save.	+	==Troubleshooting==
−	Now try a test order to check everything is ok. If setup of the hosting account fails for any reason and the account remains pending, check in '''Utilities > Activity Log''' for any errors returned from the API.	+	''N/A''
−	==Domain Registrar Module==	+	{{modules}}
−
−	===Supported Functionality===
−
−	*Register Domain
−	*Initiate Transfer
−	*Renew Domain
−	*View Nameservers '''(New!)'''
−	*Update Nameservers '''(New!)'''
−
−	===Setup/Configuration===
−
−	Configuring the domain module is very easy, simply go to '''Setup > Domain Registrars''', select '''Heartinternet''' from the dropdown menu and then enter your API Username & Password obtained from https://customer.heartinternet.co.uk/manage/api.
−
−	Then in '''Setup > Domain Pricing''', assign "Heartinternet" in the '''Automation Registration''' dropdown for the TLDs that you want Heart Internet to be used for and you're done.
−
−	==Notes==
−
−	===Required Ports===
−
−	The Heart Internet API operates on ports 700 (live mode) & 1701 (test mode) and so you need to ensure these ports are opened in your servers firewall for connections to be successful.

---

Latest revision as of 17:12, 28 August 2023

About this Module

Heart Internet is a UK based reseller web hosting and domain name provider.

Supported Features

Create	Suspend	Unsuspend	Terminate
Yes	Yes	Yes	Yes

Change Package	Change Password	Usage Updates	Client Area Link
Yes	Yes	No	Yes

The following ports should be open for outbound connections from your WHMCS server: 700(live) & 1701(test)

Adding a Heart Internet Server

To set up a Heart Internet server in WHMCS:

1. Go to Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers.
2. Click Add New Server.
3. Select Heart Internet from the menu.
4. Enter the hostname or IP address.
5. Enter the username and password or the access hash. You can obtain your username and password from Heart's API.
6. Click Continue.
7. Enter the desired additional server details.
8. Click Save Changes.
9. If this is the only Heart Internet server that is currently in WHMCS, click on the name and ensure that it results in an asterisk (*) next to it. This indicates that it is the default to use when any other non-specific configuration doesn't apply.

Creating a Heart Internet Product

You can create a product that provisions accounts on your Heart Internet server at Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services.

WHMCS Connect

This module does not support WHMCS Connect.

Troubleshooting

N/A