Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Thomas--F committed Feb 21, 2014
1 parent e9bc95c commit c6e9233
Showing 1 changed file with 39 additions and 12 deletions.
51 changes: 39 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,28 @@
BotTracker
==========
# Piwik BotTracker Plugin

BotTracker-Plugin for Piwik
## Description

for additional information go to http://dev.piwik.org/trac/ticket/2391
BotTracker ist a plugin to track the visits of bots, spiders and webcrawler, that hit yout page.

This plugin is still in BETA-status, but I have testet it for a while. It should be stable.

Before you install this plugin, some things you should be aware of:
Before you install this plugin, here's something you should be aware of:
Many webcrawler, spiders and bots don't load the images in a page and most of them don't execute JavaScript. So you cannot track them with Piwik if you don't use the PHP-API. The BotTracker can only track those, who were caught by Piwik itself.



Additional info:
I wrote BotTracker for my own needs but people ask me to make it public - so I put it online.
It's free to use and I will support it as long as I can spend the time. But I will *not* activate a donation button. If someone is paying money, I feel like I have to support him.
I want to work on this plugin because I want to and not because I have to. I hope you can unterstand that.

- many webcrawler, spiders and bots don't load the images in a page and most of them don't execute JavaScript. So you cannot track them with Piwik if you don't use the PHP-API. The BotTracker can only track those, who were caught by Piwik itself.
## Installation / Update

- if you update form Piwik 1.x to Piwik 2.x sometimes the update-script (BotTracker\Updates\0.43.php) is not executed. In this case you get an error about a not existing column "extra_stats" when you open the config-page. Then you have to execute the following 2 statemnts on your Piwik-Database (e.g. with MyPHPAdmin):
See http://piwik.org/faq/plugins/#faq_21

for additional information go to http://dev.piwik.org/trac/ticket/2391

If you update form Piwik 1.x to Piwik 2.x sometimes the update-script (BotTracker\Updates\0.43.php) is not executed. In this case you get an error about a not existing column "extra_stats" when you open the config-page. Then you have to execute the following 2 statemnts on your Piwik-Database (e.g. with MyPHPAdmin):

```sql
ALTER TABLE `piwik_bot_db`
Expand All @@ -30,10 +41,26 @@ CREATE TABLE IF NOT EXISTS `piwik_bot_db_stat`
) DEFAULT CHARSET=utf8
```

- the "extra Stats"-Feature is in "early developing". You can collect the data about the who, when and where, but there is currently no widget to display the data.

The "extra Stats"-Feature is in "early developing". You can collect the data about the who, when and where, but there is currently no widget to display the data.


## Changelog

__0.44__
* more description for the marketplace

__0.43__
* Compatible with Piwik 2.0

## License

GPL v3 / fair use

## Support

Please direct any feedback to:

* [https://github.com/Thomas--F/BotTracker/issues](https://github.com/Thomas--F/BotTracker/issues)
* [http://dev.piwik.org/trac/ticket/2391](http://dev.piwik.org/trac/ticket/2391)

And last but not least:
I wrote BotTracker for my own needs but people ask me to make it public - so I put it online.
It's free to use and I will support it as long as I can spend the time. But I will *not* activate a donation button. If someone is paying money, I fell like I have to support him.
I want to work on this plugin beacute I want to and not because I have to. I hope you can unterstand that.

0 comments on commit c6e9233

Please sign in to comment.