Tiny Monitor Documentation

Simple AdSense, Amazon and PayPal Monitor

TinyMonitor is a simple PHP script to monitor AdSense and Amazon earnings and PayPal transactions. It present a simple solution to display all the data on a single page. It updates automatically, shows various reports, generates charts to monitor parameters over time and generates RSS feeds to monitor earnings in feed readers.

Tiny Monitor is a framework that supports plugins. Currently there are plugins for Google AdSense, Amazon Associates and PayPal.

Installation

Since Tiny Monitor is a PHP application it needs web server with PHP support. You can use any commercial hosting or home web server. If you don't have one you can install a package with everything you will need to run TinyMonitor. There are many popular packages for Windows, Mac and Linux. Please check Installing a Web Server.

windows mac linux

Tiny Monitor Installation

Installing Tiny Monitor is simple. Just unzip the archive into some directory in the public (usually www) web server directory. No database is needed. Upgrading TinyMonitor requires overwriting all files with the new ones. In this case some files (settings.php for example) will not be overwritten as they are not present in the install archive.

If you have an AdSense or Amazon Associates account then you probably already have also a hosting account. If this is the case you can simply upload TinyMonitor into some folder on any existing domain.

Once all the files are in place simply go to the address of TinyMonitor, for example http://127.0.0.1/tinymonitor/ or http://mydomain.com/tinymonitor/ You should get the log-in page.

login box

If this is a clean install then use the default username admin and the default password admin, otherwise, if you have upgraded with a new version then simply use username and password you set previously. You should get the default page of TinyMonitor. If this is the first install and no monitors (plug-ins) are enabled you will only get empty page with the header bar of Tiny Monitor.

tiny monitor header

To log out simply click on the Logout button.

Settings

To access Tiny Monitor settings click on the Settings button in the header. You will get the Tiny Monitor Settings page divided into tabs. The General tab is for general Tiny Monitor settings, other tabs are for installed plugins.

tiny monitor general settings

Username and Password

Set Username and Password to prevent unauthorized access to the monitor. Leave Username empty if you don't want password protection.

Warning

All Tiny Monitor settings including plugins and all usernames and passwords are stored in the settings.php file. When Tiny Monitor is installed under your account on a commercial hosting web server this file is normally only accessible by TinyMonitor. It is not possible to get the data from this file using browser. However, if you place Tiny Monitor files on some other web server make sure nobody else has access to the files.

RSS Feed Password

RSS feeds (for all plugins) can be password protected. Default password is admin. To access feed you add password as query variable:

http://127.0.0.1/tinymonitor/index.php?rss=adsense&password=admin

You must include password query variable even if the password is empty. For each RSS feed you have a direct link to the feed in the appropriate plugin settings tab.

Page Width

Page Width defines the width of the main monitor page. Default value works fine in most cases but if you are including Tiny Monitor into some existing web page you might change this value to fit monitor into available space.

Page Title

Page Title is the text that is displayed on the browser tab. You can put any text there. To efficiently use this place for essential information you can use predefined tags which are replaced with actual values. Of course, appropriate plugin must be installed and enabled.

Google AdSense plugin tags
{adsense_today}
{adsense_yesterday}
{adsense_last7days}
{adsense_thismonth}
{adsense_lastmonth}
{adsense_sincelastpayment}

Amazon Associates plugin tags
{amazon_XX_monthtodate}
{amazon_XX_yesterday}
{amazon_XX_lastsevendays}
{amazon_XX_lastmonth}
{amazon_XX_unpaidbalance}
{amazon_XX_sincelastpayment}

XX should be replaced with one of the following codes:
com for amazon.com
uk for amazon.co.uk
de for amazon.de
fr for amazon.fr
it for amazon.it
es for amazon.es
ca for amazon.ca
jp for amazon.co.jp

PayPal plugin tags
{paypal_thismonth}
{paypal_lastmonth}
{paypal_balance}
{paypal_balance_xxx} (Currency xxx)
{paypal_xxx_to_yyy} (Exchange Ratio for currency xxx to yyy)

You can use more than one tag mixed with arbitrary text. Page title in not only displayed on the tab of TinyMonitor. If this page is selected and the browser is minimized, this text is also displayed on the button in the taskbar. This is useful to monitor key parameters even when you work with other applications.

Custom tags

Tiny Monitor supports also custom tags. You can define up to 4 tags (name and value). This can be used to perform some calculations. For example you define a tag with name thismonth:

{adsense_thismonth}+{paypal_thismonth}+{amazon_com_monthtodate}*{paypal_usd_to_eur}

This will convert Amazon monthtodate earnings to EUR (using PayPal exchange rate) and add AdSense earnings and PayPal payments in EUR. You can then use tag {monitor_thismonth} to display this month's earnings in the page title or in the Overview Monitor.

Favicon

Favicon is the icon that browsers display on each page tab. This is another place Tiny Monitor can use to display data. Favicon is used to display time in minutes until the next update (AdSense and Amazon) or the number of payments (PayPal). You can choose between Default value which will display standard Tiny Monitor icon, AdSense which will display time to AdSense update, Amazon which will display time to Amazon update or PayPal which will display the number of payments . If time to update is greater than 59 minutes the favicon text will display hours and it will be a little reddish.

If AdSense is chosen the favicon background will show colors from top 3 rows from the Today domain report.

If Amazon is chosen the favicon background will show colors from top 3 rows from the This Month tracking IDs report. You can select which amazon monitor will be the data source in the Amazon Favicon settings.

If PayPal is chosen the favicon background will show colors from top 3 rows from the This Month transaction report.

Debug System

This enables debugging of the TinyMonitor. For normal use this should be set to No.

Views

tiny monitor header

Tiny Monitor has 3 different views: normal, monitor body only and low-bandwidth display for mobile devices. Normal display is what you see after you log in. The page contains top header and monitor body. You can display monitor body only (no header row) by clicking the first icon on the header row or by navigating to page monitor. Example of url for monitor body only:

http://127.0.0.1/tinymonitor/monitor

alternative url:

http://127.0.0.1/tinymonitor/?view=monitor

To display simple, low-bandwidth monitor for mobile devices you can click the second icon on the header row or by navigating to page m. This page is not updated automatically, i.e. you have to reload it manually. Example of mobile url:

http://127.0.0.1/tinymonitor/m

alternative url:

http://127.0.0.1/tinymonitor/?view=mobile

tinymonitor mobile

Rearrange Layout

If you have more than one monitor you might want to change their display order. There is a button on the Tiny Monitor header labeled Rearrange Layout. When you click this button you enable monitor layout rearrangement. Simply click monitor (AdSense or Amazon) on the logo image in the header and drag it to a new position. When you are finished click again Rearrange Layout button to save layout settings.

Plugins

Tiny Monitor without plugins contains only basic framework without any monitoring function. Plugins are extensions for Tiny Monitor which add new functionality. Each monitor (AdSense, Amazon, PayPal) is implemented as a plugin. Tiny Monitor plugin is a collection of files that need to be located in the plugins folder. Plugins are updated like Tiny Monitor by simply overwriting all files.

Troubleshooting

If you get some error message when you load Tiny Monitor then this error is very likely related to one of the plugins. In most cases the error occurs when TinyMonitor fail to download data. Either because the account data is missing or is incorrect.

The error message always displays some information. Check if username and password are entered correctly. Please follow the instructions on how to enter required data.

Check also web server. Make sure it works and PHP is enabled.

When you start Tiny Monitor for the first time with enabled plugins they have no data yet. While the data will be downloaded, reports updated and charts created the web page might stop responding for a while. Be patient and wait until everything is in place. The next time there will be less data to update so updates will be faster.

In most cases problems you might encounter can be solved simply by reloading the page (F5 in most browsers).

If you see only the plugin header after the plugin was just enabled simply double-click on the logo image to display the toolbar. Then you can select displays and options. Once you set desired display the settings will be automatically saved in the browser.

If everything fails, you have the latest version and you are not able to get Tiny Monitor to work please contact us.