Domain Monitor Documentation

Installation

Tiny Domain Monitor is a PHP application and it needs one MySQL database. This means that it needs web server with PHP (version 5.3 or higher), MySQL and one cron job for automatic updates. You can use any existing web server, either on home computer or on existing hosting. If you don't have any web server yet you can install a simple one on your existing computer. Check Installing a Web Server.

domain monitor

Installing Tiny Domain Monitor is simple. Just unzip the archive into some sub-directory in the public (usually www) web server directory. You will also need one MySQL database. Once all the files are in place you have to edit settings.php file. Create one MySQL database (use phpMyAdmin for this) and enter database data to corresponding fields in settings.php.

define ('DB_HOST', 'localhost');
define ('DB_NAME', 'test_domains');
define ('DB_USERNAME', 'test_domains');
define ('DB_PASSWORD', 'password');

Upgrade

Upgrading Tiny Domain Monitor requires overwriting old files with the new ones. Before you upgrade make a complete backup of the old installation directory and MySQL database. Make sure you have a copy of the old settings.php and cache/whois_data.txt files. Unzip the archive into the installation (or new) sub-directory, copy database account data (and other settings) from the old settings file to the new settings.php file and put back cache/whois_data.txt file.

Optionally you can also enter Tiny Domain Monitor username and password to protect monitor display from unauthorized viewing.

define ('USERNAME', 'admin');
define ('PASSWORD', 'admin');
define ("ALERT_EMAIL_ADDRESS", '');

You can also enter email address for domain change alerts. In order to automatically update domain data you need to set up a cron job:

0 * * * * wget -O - -q -t 1 'http://mydomain.com/domainmonitor/cron.php' >/dev/null

You have to call /cron.php page to update domains. This is only an example of cron job settings. This command will update domain data every hour. Do not trigger domain updates too often as the data does not change frequently. Also do not update more than few domains with every cron job run - 10 seems to be a good choice. You can change this number in settings.php, but do not change this value unless you know what you are doing. Updating too many domains too fast may trigger protection mechanisms implemented by most WHOIS servers and you will start getting empty data.

To display Domain Authority (DA) data you need to configure also Mozscape API access ID and Mozscape API secret key. You can get them at http://moz.com/products/api/keys

Once all the setting are configured you can go to the address of Tiny Domain Monitor, for example

http://mydomain.com/domainmonitor/

You should get the log-in page.

domain-monitor-log-in

Use username and password you have configured in the settings.php file.. You should get the default page of Tiny Domain Monitor. To log out simply click on the Logout button.

domain-monitor-page

Monitoring Domains

Tiny Domain Monitor can monitor any domain. All you have to do is to enter them.

Entering Domains

Tiny Domain Monitor has two modes of operation: Add and Search. You can toggle between the modes by clicking the last icon in the header.

domain monitor header search switch

You can enter individual domains into the field on the top of the monitor. After you click on the + button the domain will be added to the monitor. Of course, the monitor has to be in the Add mode.

domain-monitor-header-add-domain

You can also add bulk domains.

domain-monitor-header-add-bulk

Click the Bulk Add icon on the header bar to open a text area to add multiple domains.

domain monitor bulk add field

Do not add more than 10 – 12 domains in one go as each domain queries WHOIS server and a lot of request in short time may trigger protection mechanisms. This will result in empty data returned from the WHOIS server.

Editing WHOIS data

Warning: This is an advanced feature – do not use it unless you are familiar with the WHOIS data and Tiny Domain Monitor database.

Some WHOIS servers do not return data unless you enter some captcha code. To monitor also such domains you can enter missing WHOIS data manually.

edit whois

Click on the Edit WHOIS data icon on the header bar. A text area will open.

domain monitor edit whois field

Here you can manually add missing WHOIS data. You should use the INI file format. Each domain should have a section title with domain in square brackets. Then you can add domain data in the form of key = value. Use only keys that are listed on the top of this settings. These settings override the data stored in the database. Check your Tiny Domain Monitor database for details on how domain data is stored.

Deleting Domains

Domains can be deleted from the database by clicking the Delete icon.

domain delete

Exporting Domains

Monitored domains can be exported into a CSV file. Simply click on the Export Domains icon:

domains export

All displayed domains will be exported using currently selected display ordering and filters. You can define which columns (domain data) will be exported in the settings.php file.

Searching Domains

To search for domains switch to Search mode, enter search text and press Enter or click the Search icon on the right. To clear search text click the Clear search icon left of search field.

clear search

Tiny Domain Monitor will search ASCII domain names, IDN domain names, domain statuses and all domain dates. All domains that have search text in those fields will be displayed. To search for domains that start with some text use searchtext* and to search for domains that end with some text use *searchtext.

Sorting Domains

Monitored domains can be sorted according to any displayed parameter: Domain name, Domain name length (click on arrow next to Domain), PageRank, Domain Authority, Status, Last checked time, Created date, Updated date and Expires date. Filters for Own domains and Marked domains can also be used. Simply click on the column title or icon to toggle sorting or filtering.

domain monitor search

Marking Domains

You can mark some domains that need special attention. There are two types of marks. The first one is a general mark just to mark some interesting domains.

domain mark

Simply click on the mark icon to toggle marking. The second marking type is for own domains. You can label them to know that these are already yours.

domain own

Click on the Own domain icon to toggle marking. You can also filter domains by clicking the corresponding icon on the header bar.

Filtering Domains

You can filter domains according to their status or expiration date. There are four groups of filters. The first one is a filter for available domains.

available domains

The second filter is for expired domains.

expired domains

The third filter filters domains before expiration (expiring in one month).

domains before expiration

The fourth filter filters all active domains.

active domains

To clear filters click on the last filter icon.

no filter

RSS feed

Tiny Domain Monitor generates also RSS feed to track domain changes. The Feed icon on the header bar contains a link to the feed. You can disable feed or define which events generate feed items in the settings.php file.

domains rss feed

Domain Status

Each monitored domain is displayed in a row with all important data. After the domain name there is an icon representing the status of the domain. You can get detailed domain status by hovering the cursor over the icon.

domain status

Domain data is updated automatically by the cron job. However, you can manually update the data by clicking the Update icon.

domain update

Lines with expired domains are colored with blue and lines with available domains are colored with green background.