Difference between revisions of "Domain Registration"

From AWBS Wiki
Jump to: navigation, search
(→‎Domain Registration Process)
(→‎IDN)
 
(77 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
===Domain Transfers===
+
__NOTOC__
 +
==Table of Contents==
 +
# [[BizCN_Configuration|BizCN Configuration]]
 +
# [[dot.tk_Configuration|Dot.TK Configuration]]
 +
# [[eNom_Configuration|eNom Configuration]]
 +
# [[Hexonet_Configuration|Hexonet Configuration]]
 +
# [[Internet.bs_Configuration|Internet.bs Configuration]]
 +
# [[IRRP.Net_Configuration|iRRP.net/Key System Configuration]]
 +
# [[ISPAPI_Configuration|ISPAPI Configuration]]
 +
# [[LogicBox_Configuration|LogicBox Configuration]]
 +
# [[NetEarthOne_Configuration|NetEarthOne Configuration]]
 +
# [[Nominet_EPP_Configuration|NominetEPP Configuration]]
 +
# [[Nokta_TK_Configuration|Nokta TK Configuration]]
 +
# [[OnlineNic_Configuration|OnlineNic Configuration]]
 +
# [[OpenSRS_Configuration|OpenSRS Configuration]]
 +
# [[PlanetDomain_Configuration|PlanetDomain Configuration]]
 +
# [[Reg.ru_Configuration|Reg.ru Configuration]]
 +
# [[RegisterFly_Configuration|RegisterFly Configuration]]
 +
# [[ResellerClub_Configuration|ResellerClub Configuration]]
 +
# [[ResellOne_Configuration|ResellOne Configuration]]
 +
# [[#TLD Config|TLD Config]]
 +
# [[#TLD Setup/Pricing|TLD Setup/Pricing]]
 +
# [[#Domain Name Options|Domain Name Options]]
 +
# [[#For Sale System|For Sale System]]
 +
# [[#IDN|IDN]]
 +
# [[#Domain Push Feature|Domain Push Feature]]
 +
# [[#Legal_Types_for_TLD's|Legal Types for TLD's]]
 +
# [[#Setting_specific_number_of_years_for_registrations_and_renewals|Setting specific number of years for registrations and renewals]]
  
−
===Domain Renewals===
+
==TLD Config==
  
−
==eNom Configuration==
 
  
−
===At www.enom.com===
+
In the TLD Config page of the AWBS configuration area, you will setup the registrar to be used for each tld you offer as well as the whois server that will be used for the domain availability lookups for domain sales. (not used on the whois.php page of your AWBS site)
  
−
Go to resellers on the top menu.
+
''Note: You must have already enabled the domain registrar modules you will be using in the Module Setup page.''
  
−
Click on test account link on that menu.
+
Select the registrar you will use for each TLD.
  
−
#Click Setup your account on the testing server.
+
Enter the whois server to be used for the availability checks. You must use the responsible registry's whois server and the correct Match String their system uses.  
−
#Click Reset your account balance in the test environment to $5000.00.
+
''Note: port 43 outgoing needs to be open on your server in order for the communication to the whois servers to function.''
−
#Click the Add/Edit/Delete IP addresses that are allowed to access your account on the test server and enter your server's main IP address. Save.
+
  
−
 
  
−
=== In AWBS===
+
'''Whois server options:'''
  
−
Login to your AWBS site as super admin.
+
1. For some registrars, you have the option to use the registrar's API to check for domain availability.  
  
−
Enter the Configuration area. Go to the Module Setup page and ensure the eNom module is enabled.
+
eNom
 +
IRRP
 +
OpenSRS
 +
ResellOne
  
−
+
To use the API for domain lookups enter the appropriate of the following into the whois server field for each tld you wish to use it.
  
−
Go to the Registrar Setup page. Click the icon beside Enom to enter the eNom setup area.
+
enom
 +
irrp
 +
opensrs
 +
resellone
  
−
Enter your enom.com reseller account username and password. Make sure you have test mode set to True and secure mode set to False. Do not change the Live URL or Test URL settings. Enter prices as desired for the various enom services.
+
The response strings are not required if using the API for lookups.
  
 
   
 
   
 +
''Note: Using the API lookups will be more accurate than the various whois servers, however it takes longer for the results. If you offer many tlds, you may want to use this feature only for the most popular ones to keep the process quick enough and avoid apache/IIS timeouts.''
  
−
If you have a backorder affiliate account somewhere, enter your backorder url.
+
[[TLD_Whois_Servers|Whois Server Listing]]
  
−
+
2. For TLDs that only have an html based whois server;
  
−
If you wish domain names to be registered with nameservers other than enom's by default, enter desired nameservers in the nameserver fields. If you will be offering any of eNom's dns services such as url forwarding, etc you should leave the nameserver fields blank.
+
Enter the full URL with required parameter(s) of the whois page into the Whois Server column/field.
 +
Example: http://www.ipwebgroup.gr/gr/whois.php?domainName=
  
−
   
+
Enter the correct Match String.
 +
  Example: Domain does not exist
  
−
If you have a default park page you set for all newly registered domains, enter the complet url in the Default parking page url field. This only applies if you have left the nameserver fields empty, as it sets a url frame for the domain if it is using eNom's nameservers.
+
==TLD Setup/Pricing==
  
−
+
On this page you will configure your TLD availability in years and for registration, renewals and transfers as well as the retail pricing and postition they display on the home page and domain name page.
  
−
Save.
+
Enter the tld's in format 'com', not '.com'. (NO BEGINNING DOT)
  
−
+
Only check the renew and transfer boxes according to availability at your configured registrar for each tld. (This may vary depending on the registrar used.)
  
−
Enter the enom registrar setup page again. Click the Test ENOM connection link to verify your configuration is correct.
+
Be sure the minimum years are set lower than the maximum. Make sure the maximum years are not higher than offered by the registrar. (This will vary depending on the registrar used.)
  
−
+
Check the 'Free Option' checkbox if you are offering a free domain name with any hosting plans for all tlds that will be free. The free option will give the domain name free with the initial hosting order only (future domain renewals will not be free).
  
−
If there are no errors, login to your account at enom.com, go to the support area, open a new support request and ask for API access for the IP you entered in the test account setup area.
+
Use the 'pos' column to set the position of the tlds on your domain availability checkbox on the index and check.php pages of the site.
 +
Number them in the order you wish them to appear starting at 0.
  
−
+
''Note: All tlds with pos setting of 0 will rank the same and then be ordered via their row numbers in the database.''
  
−
Once you have completed your testing and are ready to put your site live for orders, go to the Registrar Setup area and set test mode to False and secure connection to True. Run the Test ENOM connection test again to ensure there are no problems.
+
Click the Edit Pricing link by each TLD to setup pricing for each term.  
 +
''Note: prices are total for that number of years''
  
−
+
==Domain Name Options==
 +
 
 +
Allowing discounts will enable discounts to be set on a per user basis by the AWBS administrator. Disabling discounts here will override any settings in the user accounts.
 +
 
 +
Options:
 +
 
 +
Allow discounts for registrations and renewals: (True - False)
 +
 
 +
Allow discounts for transfers: (True - False)
 +
 
 +
You may specify your word search's here as well. Once you have the wordsearch filled in, Be sure to check either "Suffix or Prefix)
 +
This will create the other suggested domain names on the domain name registration page when customers are looking for domain name availability.
 +
 
 +
==For Sale System==
 +
Activate the For Sale System in the AWBS Configuration, system options page.
 +
 
 +
Configure your For Sale categories in the AWBS Configuration, For Sale System page.
 +
 
 +
This allows you to configure the various different categories that a domain displayed in on the domains for sale page of your site.
 +
 
 +
The for sale system will allow users to place their domain name for sale. The system will produce a form for perspective buyers to contact the owner without giving any information on the owner.
 +
 
 +
The domain owner will receive the form results with the purchase offer or request for a price via email (the email address configured in the user's profile).
 +
 
 +
Users can place any of their domains for sale or remove them at any time. They can choose the category they would like the domain displayed in.
  
−
Other settings at enom.com
+
In the user's domain management area, each domain will show the 'S' icon if it is currently not for sale and the 'FS' icon if it is for sale.
  
−
Login to your reseller account at enom.com.
+
They can click on the 'S' icon to place the domain for sale.
  
−
Go to settings.
+
== IDN ==
 +
''(the following configuration information is new as of AWBS version 2.9.4)''
 +
In the AWBS Configuration area, Domain Options area, on the Registrar/Whois tab add in any tlds you want to offer for IDN registrations.
 +
On the Pricing/Availability/EPP tab, check the IDN checkbox and setup the rest of the settings and pricing.
  
−
Select '1' for 'by default, domains will be registered, hosted, and renewed for x year(s).
+
Note: Any tlds that you check the IDN checkbox will not show up on the normal registration page, so you'll need to have duplicates for those you offer both, such as .com.
  
−
Select the 'define your own default host records in the fields below' and setup a default park page. (If you don't define your default host records, your domains will inherit the ones from your master reseller account).
+
IDN orders are taken via this link;<br />
 +
http://[your_awbs_url]/check.php?isidn=1
  
−
Save changes.
+
== Domain Push Feature ==
 +
Your AWBS members (customers) have the option to push a domain name to another account.<br /><br />
  
−
Click the reseller tab.
+
To push a domain name to another account in the system, login to the user account and proceed to the domain list (manage domains link on member menu).<br />
 +
Click the M icon next to the domain name you want to push.<br />
 +
Click the link that says: Push to Another Account<br />
 +
Enter the username of the account you want to push the domain name to.<br />
 +
Enter a new password, something not used anywhere else.<br />
 +
Click the Submit button.<br /><br />
 +
Now give the password you used to the owner of the account you have pushed to. The next time that user logs in, he/she will have a message to retrieve the domain name. They will have to enter the correct password at that time and have a domain profile.<br /><br />
 +
Notes:<br />
 +
1. When a domain name is retrieved, the new owner's default '''domain profile''' will be used to update the whois contact info for that domain name.<br />
 +
2. Domains with hosting services cannot be pushed, customers will need to contact you to move those domain names.<br />
 +
3. Domains moved (assigned to a new user) in the domain manager of the admin area do not get any new contact information.<br />
 +
4. Some registrar modules do not support this feature due to the manner in which domain contact information is edited.<br />
 +
5. Some tlds are exempt from this feature due to their special transfer and ownership change rules.
  
−
Click reseller renewal settings. Select 'do not contact my customers for renewal'. (AWBS will send the renewal notices)
+
== Legal Types for TLD's ==
  
−
Save changes.
+
'''***ONLY APPLICABLE TO VERSION 2.9.0 AND ABOVE***'''
  
−
You may also wish to use the domains >> advanced tools >> global edit to ensure no existing domains are set to auto renew.
+
This file should be place in the /includes/[registrar] directory and be named legal.php
 +
This file must then define ALL legal settings for the entire tld offering from this registrar
  
−
==iRRP.Net/Key System==
+
'''File information:'''
  
−
===OpenSRS===
+
<code><nowiki>$additionaldomainfields[".us"][] = (change the tld to the appropriate setting)</nowiki></code>
  
−
===RegisterFly Configuration===
+
'''Available settings are:'''
 +
*Name (text)
 +
*Type (text, dropdown, tickbox or radio)
 +
*Options (value=name pairs only - name is displayed to the user, value is actual value sent to the api)
 +
*Default (default value - Must be set for tickbox and radio)
 +
*Description (displayed below the input field
 +
*Apicommand (the actual api command sent to the registrar - Example: X-US-NEXUS-CATEGORY)
 +
*Required (make this value required)
  
−
===ResellerClub Configuration===
+
'''Example setting:'''<br />
 +
<code><nowiki>
 +
<?php </nowiki><br />
 +
<nowiki>$additionaldomainfields[".us"][] = array( </nowiki><br />
 +
<nowiki>"Name" => "Nexus Category", </nowiki><br />
 +
<nowiki>"Type" => "dropdown", </nowiki><br />
 +
<nowiki>"Required" => "true", </nowiki><br />
 +
<nowiki>"Options" => "C11=C11,C12=C12,C21=C21,C31=C31,C32=C32", </nowiki><br />
 +
<nowiki>"Default" => "C11", </nowiki><br />
 +
<nowiki>"Description" => "This is the description for this field. This is the description for this field.", </nowiki><br />
 +
<nowiki>"Apicommand" => "nexus1", </nowiki><br />
 +
<nowiki>); </nowiki><br />
 +
<nowiki>?> </nowiki><br />
 +
</code>
  
−
===ResellOne Configuration===
+
== Setting specific number of years for registrations and renewals ==
  
−
===TLD Config===
+
As of 2.9.0 it is possible to set specific number of years that individual TLD's can be registered for or renewed for.
  
−
===TLD Setup/Pricing===
+
For example, you can have it set so .com domains can only be registered for 1, 2 or 5 years, and when renewing they have the option of 1, 5, or 10 years.
  
−
===Domain Name Options===
+
''To do this you need to edit the database manually!''
  
−
===For Sale System===
+
#Open your AWBS Database in PHPmyAdmin or Equivalent editor
 +
#Find the tld_config table, and edit the TLD you would like to change
 +
#Find the config_1 field and enter the years you would like to exclude for registering.  For example:  1,3,5,7,9 would mean this TLD can only be registered for 2, 4, 6, 8, or 10 years. 
 +
#To exclude years for renewals, you can use the following format:  1,3,5,7,9|5,6,7,8,9,10 In this example, the TLD could be registered for 2,4,6,8 or 10 years, but can only be renewed for 1,2,3, or 4 years.

Latest revision as of 11:18, February 7, 2011

Table of Contents

  1. BizCN Configuration
  2. Dot.TK Configuration
  3. eNom Configuration
  4. Hexonet Configuration
  5. Internet.bs Configuration
  6. iRRP.net/Key System Configuration
  7. ISPAPI Configuration
  8. LogicBox Configuration
  9. NetEarthOne Configuration
  10. NominetEPP Configuration
  11. Nokta TK Configuration
  12. OnlineNic Configuration
  13. OpenSRS Configuration
  14. PlanetDomain Configuration
  15. Reg.ru Configuration
  16. RegisterFly Configuration
  17. ResellerClub Configuration
  18. ResellOne Configuration
  19. TLD Config
  20. TLD Setup/Pricing
  21. Domain Name Options
  22. For Sale System
  23. IDN
  24. Domain Push Feature
  25. Legal Types for TLD's
  26. Setting specific number of years for registrations and renewals

TLD Config

In the TLD Config page of the AWBS configuration area, you will setup the registrar to be used for each tld you offer as well as the whois server that will be used for the domain availability lookups for domain sales. (not used on the whois.php page of your AWBS site)

Note: You must have already enabled the domain registrar modules you will be using in the Module Setup page.

Select the registrar you will use for each TLD.

Enter the whois server to be used for the availability checks. You must use the responsible registry's whois server and the correct Match String their system uses. Note: port 43 outgoing needs to be open on your server in order for the communication to the whois servers to function.


Whois server options:

1. For some registrars, you have the option to use the registrar's API to check for domain availability. 

eNom
IRRP
OpenSRS
ResellOne

To use the API for domain lookups enter the appropriate of the following into the whois server field for each tld you wish to use it. 

enom
irrp
opensrs
resellone

The response strings are not required if using the API for lookups.


Note: Using the API lookups will be more accurate than the various whois servers, however it takes longer for the results. If you offer many tlds, you may want to use this feature only for the most popular ones to keep the process quick enough and avoid apache/IIS timeouts.

Whois Server Listing

2. For TLDs that only have an html based whois server;

Enter the full URL with required parameter(s) of the whois page into the Whois Server column/field. 

Example: http://www.ipwebgroup.gr/gr/whois.php?domainName=

Enter the correct Match String. 

Example: Domain does not exist

TLD Setup/Pricing

On this page you will configure your TLD availability in years and for registration, renewals and transfers as well as the retail pricing and postition they display on the home page and domain name page.

Enter the tld's in format 'com', not '.com'. (NO BEGINNING DOT)

Only check the renew and transfer boxes according to availability at your configured registrar for each tld. (This may vary depending on the registrar used.)

Be sure the minimum years are set lower than the maximum. Make sure the maximum years are not higher than offered by the registrar. (This will vary depending on the registrar used.)

Check the 'Free Option' checkbox if you are offering a free domain name with any hosting plans for all tlds that will be free. The free option will give the domain name free with the initial hosting order only (future domain renewals will not be free).

Use the 'pos' column to set the position of the tlds on your domain availability checkbox on the index and check.php pages of the site. Number them in the order you wish them to appear starting at 0.

Note: All tlds with pos setting of 0 will rank the same and then be ordered via their row numbers in the database.

Click the Edit Pricing link by each TLD to setup pricing for each term. Note: prices are total for that number of years

Domain Name Options

Allowing discounts will enable discounts to be set on a per user basis by the AWBS administrator. Disabling discounts here will override any settings in the user accounts.

Options:

Allow discounts for registrations and renewals: (True - False)

Allow discounts for transfers: (True - False)

You may specify your word search's here as well. Once you have the wordsearch filled in, Be sure to check either "Suffix or Prefix) This will create the other suggested domain names on the domain name registration page when customers are looking for domain name availability.

For Sale System

Activate the For Sale System in the AWBS Configuration, system options page.

Configure your For Sale categories in the AWBS Configuration, For Sale System page.

This allows you to configure the various different categories that a domain displayed in on the domains for sale page of your site.

The for sale system will allow users to place their domain name for sale. The system will produce a form for perspective buyers to contact the owner without giving any information on the owner.

The domain owner will receive the form results with the purchase offer or request for a price via email (the email address configured in the user's profile).

Users can place any of their domains for sale or remove them at any time. They can choose the category they would like the domain displayed in.

In the user's domain management area, each domain will show the 'S' icon if it is currently not for sale and the 'FS' icon if it is for sale.

They can click on the 'S' icon to place the domain for sale.

IDN

(the following configuration information is new as of AWBS version 2.9.4) In the AWBS Configuration area, Domain Options area, on the Registrar/Whois tab add in any tlds you want to offer for IDN registrations. On the Pricing/Availability/EPP tab, check the IDN checkbox and setup the rest of the settings and pricing.

Note: Any tlds that you check the IDN checkbox will not show up on the normal registration page, so you'll need to have duplicates for those you offer both, such as .com.

IDN orders are taken via this link;

http://[your_awbs_url]/check.php?isidn=1

Domain Push Feature

Your AWBS members (customers) have the option to push a domain name to another account.

To push a domain name to another account in the system, login to the user account and proceed to the domain list (manage domains link on member menu).
Click the M icon next to the domain name you want to push.
Click the link that says: Push to Another Account
Enter the username of the account you want to push the domain name to.
Enter a new password, something not used anywhere else.
Click the Submit button.

Now give the password you used to the owner of the account you have pushed to. The next time that user logs in, he/she will have a message to retrieve the domain name. They will have to enter the correct password at that time and have a domain profile.

Notes:
1. When a domain name is retrieved, the new owner's default domain profile will be used to update the whois contact info for that domain name.
2. Domains with hosting services cannot be pushed, customers will need to contact you to move those domain names.
3. Domains moved (assigned to a new user) in the domain manager of the admin area do not get any new contact information.
4. Some registrar modules do not support this feature due to the manner in which domain contact information is edited.
5. Some tlds are exempt from this feature due to their special transfer and ownership change rules.

Legal Types for TLD's

***ONLY APPLICABLE TO VERSION 2.9.0 AND ABOVE*** 

This file should be place in the /includes/[registrar] directory and be named legal.php
This file must then define ALL legal settings for the entire tld offering from this registrar

File information:

$additionaldomainfields[".us"][] = (change the tld to the appropriate setting)

Available settings are:

  • Name (text)
  • Type (text, dropdown, tickbox or radio)
  • Options (value=name pairs only - name is displayed to the user, value is actual value sent to the api)
  • Default (default value - Must be set for tickbox and radio)
  • Description (displayed below the input field
  • Apicommand (the actual api command sent to the registrar - Example: X-US-NEXUS-CATEGORY)
  • Required (make this value required)

Example setting:
<?php
$additionaldomainfields[".us"][] = array(
"Name" => "Nexus Category",
"Type" => "dropdown",
"Required" => "true",
"Options" => "C11=C11,C12=C12,C21=C21,C31=C31,C32=C32",
"Default" => "C11",
"Description" => "This is the description for this field. This is the description for this field.",
"Apicommand" => "nexus1",
);
?>

Setting specific number of years for registrations and renewals

As of 2.9.0 it is possible to set specific number of years that individual TLD's can be registered for or renewed for.

For example, you can have it set so .com domains can only be registered for 1, 2 or 5 years, and when renewing they have the option of 1, 5, or 10 years.

To do this you need to edit the database manually!

  1. Open your AWBS Database in PHPmyAdmin or Equivalent editor
  2. Find the tld_config table, and edit the TLD you would like to change
  3. Find the config_1 field and enter the years you would like to exclude for registering. For example: 1,3,5,7,9 would mean this TLD can only be registered for 2, 4, 6, 8, or 10 years.
  4. To exclude years for renewals, you can use the following format: 1,3,5,7,9|5,6,7,8,9,10 In this example, the TLD could be registered for 2,4,6,8 or 10 years, but can only be renewed for 1,2,3, or 4 years.
Retrieved from "https://www.awbswiki.com/index.php?title=Domain_Registration&oldid=1785"