1.Introduction to WT Domain Check #

WT DOMAIN CHECK is the most flexible and fully domain search engine that allows you to offer the possibility to search the status of a domain against previously defined WHOIS servers, from your website running with wordpress.
This plugin allows you to check top-level domains as well as country code top-level domains (ccTLD)
WT DOMAIN CHECK is fully object-oriented programmed (OOP) which allows its easy expansion and  maintenance. We also use AJAX technology which provides a better experience for users from both sides: Admins and front end users.

Yes No

2.Features #

  • Check status of gTLD and ccTLD domains
  • Possibility of inserting the plugin with a simple shortcode
  • Integrated with Woocommerce, WHMCS, and Custom links
  • 100% OOP (object oriented programming)
  • Quick reports from the WordPress dashboard (pro)
  • Possibility of make multiple suggestions about the consulted domain
  • Add your customs TLD and Whois servers to the default active list (pro)
  • Export the list of Whois servers to a CSV file for better maintenance (pro)
  • Import the list of Whois servers from a CSV file (pro)
  • Administration of WHOIS servers from an easy to use & powerful custom list
  • Powered settings page to change the default behavior of WT Domain Check
  • CSS Editor incorporated to easy change the default styles
  • Activate / Deactivate ReCaptcha to avoid the improper use of the plugin
  • Incorporates AJAX technology
Yes No

3.Installation / Updates #

Before installing WT DOMAIN CHECK in your website, please be sure that you meet the minimum requirements for proper operation. {aca iria un enlace a otra pagina con los requerimiento minimos}

The installation process of WT DOMAIN CHECK is quite simple and should not cause any problems in the normal operation of your website. There are three ways to install the plugin on your website.

Once the plugin is installed and activated, you should see a new option in the left menu of your wordpress admin area as seen in the image below

Yes No

3.1.Install from WordPress Market #

The easiest way is going in your WordPress admin menu until  Plugins -> Add new , and then search in the WordPress Marketplace for our plugin named: WT DOMAIN CHECK. Once our plugin appears in the results list, press the INSTALL button, and finally, activate it by pressing the ACTIVATE button.

Yes No

3.2.Acquire the plugin from envato & upload #

Another way is to acquire the plugin from Codecanyon. There you will download a .zip file to your computer. Then go to Plugins -> Add New , once there,  press the “Upload Plugin” button that appear at the right of the page title.

On the next screen, select the previously .zip downloaded file pressing the button “Select file”, then the button “Install now”.   Once the file has already uploaded, click on the “Activate” link and that’s all! Enjoy!

Yes No

3.3.Manual installation #

IF NONE OF THE TWO PREVIOUS OPTIONS WORKS: Extract the .zip file downloaded from Codecanyon on your computer. This action will create a new folder named as the original .zip file, and it will contain all the plugin files.

Now with a FTP client (like filezilla), connect to your ftp host where you have installed WordPress and upload the folder as it was generated on your computer to the following remote path: public_html / wp-content / plugins

Once it’s done, go back to the WordPress admin and go to Plugins -> Installed Plugins. In the list you will see a new plugin: WT DOMAIN CHECK. Activate it, and that’s all! Enjoy!

Yes No

4.The shortcode #

You can easily insert WT DOMAIN CHECK on any page or post using our shortcode:

Our shortcode has some parameters that can change the default behavior of the plugin, some of them will overwrite  chamges made from the plugin settings page

Parameter Function Sample
button
Changes the default text of search button
[wtomcheck button=”SEARCH NOW”]
width
Defines the width in % of the text box respect of its container
[wtomcheck width=”70″]
width
Defines the width in % of the text box respect of its container
[wtomcheck width=”70″]

 

Combined examples:
[wtomcheck button=”SEARCH NOW” width=”80%”]

This example replaces the default text that comes for the search button and also defines the width of the search box to 80% of the total parent container.

Yes No

5.Integration #

WT DOMAIN CHECK can be integrated only  with one of the three avaible options at the same time.
It means that if you connect the “purchase of an available domain” with Woocommerce, you can´t integrate it with WHMCS, or with a Custom link at the same time.

Yes No

5.1.Integration with WHMCS #

If you wish to integrate the purchase of an available domain with the WHMCS software, follow these steps:

  1. In the “integration” setting option, select WHMCS
  2. Paste in the integration link text box, the complete URL where you have your WHMCS software installed

Setting these two parameters, if a user chooses to buy a free domain, he will be redirected to the url that you specified to acquire the domain for one (1)  year by default.

 

Yes No

5.2.Integration with Woocommerce #

If you want to integrate “the purchase action” with your Woocommerce software, follow these steps:

  1. In the “integration” drop list, select Woocommerce
  2. In the integration link text box write the product id

When you are finish to setting these parameters, the user will be redirected to his shopping cart with an added product (whose id was specified in the plugin settings page). From there he can choose to continue buying or start the checkout process.

* Don’t forget to enable “Redirect to the cart page after successful addition” in your Woocommerce settings page.

If you want to activate the custom price capability for each type of domain for Woocommerce, first, in the list of avaible TLD you must have specified a price for each one of them, otherwise the system will use the global price specified at the settings page. One additional note: You must have activated the option “custom price” in your Woocommerce for the correct integration.

 

Yes No

5.3.Custom Integration #

If you want to integrate WT DOMAIN CHECK with other software not listed above, you can use the custom link option:

  1. In the “integration” drop list, select “Custom Link”
  2. In the integration link text box you must write the complete url with all the variables you need to send considering that you can pass three (3) values returned by the plugin: %%domain%%, %%tld%%, %%price%%
    Example: myecommercesite.com/buydomain.php?domain=%%domain%%&tld=%%tld%%

Yes No

6.Recaptcha #

To prevent malicious use of the plugin, you can activate the Google Recaptcha, which will filter quickly and easily, bots that only wants to abuse the resources of our server.

First go to google and generate a key to use the Google Recaptcha on your website(*).

Then, in the WordPress admin area, go to wtdomcheck -> Settings -> Google recapcha and set the two keys that you previously generated in google.

Once configured these two parameters, activate the option “Enable Recaptcha”

*To generate the keys of Google Recaptcha you must follow these steps:

  1. First and the most important, you must have an account with Google.
  2. Access to the following address: https://www.google.com/recaptcha/
  3. Enter to the “Admin console” (blue button that appears in the upper right corner of your screen)
  4. Now you can create a new recaptcha or go to the configuration directly if you have already created one
  5. Finally you must access to the keys of the recaptcha and there you will get the two keys: the “key of the website” and the “secret key”, copy and paste both  of them in the plugin wtdomcheck -> settings -> Google Recapcha
Yes No

7.Import / Export list of Whois servers #

No other plugin allows you so much flexibility when it comes to keeping your Whois server list up to date.

The Pro version comes with this addiotional module that will allow you to export and re-import the current list of servers to and from .csv file. Once exported. you can perform maintenance tasks in a software such as Microsoft Excel © or Notepad++.

Keep attention in which columns are exported, and mantain the same format when re-importing your modified .csv again into the plugin whois server list.

The ordered columns structure is:
TLD ; whois server ; custom price ; status ; multiple search

The content of each column must be:

Field Value
TLD { gTLD or ccTLD } -required- (for example: .com) | Must always begin with a dot, if this field got an invalid content or you left empty, this TLD will be ignored and not imported.
whois server { whois server host } -required- (for example: whois.nic.ar) | The url of the whois server, if this field got an invalid content or you left empty, this TLD will be ignored and not imported.
custom price { custom price for this TLD } -optional- (for example: 12) the custom price for this TLD, if you left this field empty, this TLD  will adopt the global price especified in the plugin settings page.
status { TLD status } -optional- (for example: enabled) | Possible values: “Enabled” or “Disabled” If you left empty or specify an invalid status, by default the system will give to this TLD the “disabled” value
multiple search { Multiple search status } -optional- (for example: 1) | Possible values:”1″, “0” | “1” means that this TLD will participate in multiple searchs. If you left empty or specify an invalid value, by default the system will give to this TLD the “0” value

 

Keep in mind the mandatory syntax:

  • The data for each column must be always separated by a semicolon symbol (;)
  • Each record ends with a line feed (LF)
  • The encoding character for the csv file must be always UTF-8

WARNING: The import action will overwrite the entire list that is currently active for the plugin. In other words, to be more clear, when you import the new .csv file, the old list is completely deleted, and then the records contained in the .csv file are imported.

 

Yes No

8.Applying custom styles #

WT DOMAIN CHECK comes with a section incorporated in the settings page with a powerful CSS editor (with syntax checker), so you can apply your own CSS rules and styles who will overwrite the ones that come by default in the plugin.

Keep in mind that sometimes the values that you add to the css properties will must end with !important clause to force overwrite the default ones!

Example:
text-align: center !important;

Yes No

9.Manage Whois Servers List #

This module allows you to perform tasks on the servers list that you are currently using to check the status of certain domains. From here you can:

  1. Add / Modify / Remove whois servers
  2. Change their status (enabled / disabled). Please note that any server marked as “disabled” will not appear in the TLD drop-down list in the search box on the front-end of your website.
  3. Define if each whois server will be a part in the result of multiple search. If the toggle button is activated, when a user performs a search, suppose: bestplugins.com, the system will search for that TLD (.com), and also perform a search for each activated TLD as a multiple search to offer to the front-end user several TLD alternatives if the originally one was not avaible.

Yes No

10.Maintenance Tasks #

This module was thought to incorporate actions that have to do with the maintenance of the plugin. At the moment it only contains one action but we don´t discard for futures versions to incorporate more utilities.

Yes No

10.1.Empty queries history #

This action will truncate the queries table leaving that without any record. So, no data will be avaible at that moment to draw the dashboard admin reports until new queries were made.

Yes No

11.Dashboard Admin Reports #

It was a great goal that you acquire our plugin, since not only is it more flexible, more robust; it also allows you to have a feedback about the use that front-end users give to it.

Today we include with the Pro version two reports, but we don’t discard in future versions adding new ones.

Yes No

11.1.Report of queries made #

This report allows you to quickly see the last 10 queries that has been made, the ip and country from which the query was made, and the domain queried.

Yes No

11.2.Access chart by country #

This graphic allows you to quickly see the distribution of queries made among the top 10 countries that most access to your website

Yes No

12.Need more information? #

If you have more questions and you do not find an answer to it in this document, you can access and participate in our forums.

Click here: https://webstower.com/forums

Yes No

13.How translate the plugin #

Our plugin comes with a language template file that contains all the strings that are echoed in the front-end and the admin area. This file resides in the following path:

wp-content / plugins / wtdomcheck / languages / wtdomcheck.pot

This file must be used to create a new language for the plugin using any software that can edit .po or .pot files and generate compiled .mo files. Poedit is a good choice and the free version should be enough for this purpose. Once you fires this software, open the file in the path described above , and Poedit will ask to you to create a new translation, select your preferred language, translate all the strings and finally save the translate.

When yo save the translate, Poedit will generate two new files in the same path: en_US.po and en_US.mo (if you had selected “English USA” for example)

The compiled .mo file is the language file thath WordPress will use to get the translated strings when needed, and from here you must follow two steps more to complete the process:

  1. Rename both, the generated .mo and .po files to: wtdomcheck-{code language created}.mo | Example: wtdomcheck-en_US.mo and do the same for the .po file
  2. Move this two renamed files to the following path: wp-content / languages / plugins

If everything went well.. Ready to go in your own language!

NOTE: In the future if you want to edit your language file to improve the translation, from Poedit you must open the .po file moved in the step 2 (Example: wtdomcheck-en_US.po), edit those strings, and then “save” again. Poedit will generate a new compiled .mo file in the same location and overwrites the old one, so no move action is required.

Yes No