Deprecated: Function eregi_replace() is deprecated in /home/sites/www.vankilsdonk.nl/web/projects/mint/index.php on line 124
************************************************************************** Nametags v0.32 - 20070325 (c) Hans van Kilsdonk Website: http://mint.ufx.nl E-mail: mail [ A T ] mint.ufx.nl Thanks to Simon for the peppers' name and the useful comments =) ************************************************************************** ~ DESCRIPTION ============= Nametags for Mint 1.2 & 2.0 is a Pepper where you can tag your visitors. It views the visitors information like XXX Strong mint does but now you can add some extra tags to specific visitors. Nametags records the IP address of your visitor so please check your private policy. Tagging is done in two different ways: - Tagging by IP address You can add a tag to an IP address so when this IP address visits your website the tag is added in the visitors statistics. Every IP tag is shown as red in the statistics. Nametags 0.2+ has the option to save a cookie when the particular IP address visits your website. When this computer visits your website using a different IP address you can still track them. !! note: if you remove an IP tag Nametags will remove all the tags added to this visitor (also the cookie-tag) - Tagging by cookie This is the cool stuff :) For example: if you have a website where users can login you can track every user using the 'tagging by cookie' functionality. Just set a cookie with the user name and you're done! You can configure multiple cookienames to track. ~ HOW TO INSTALL ================ Copy the directory: hansvankilsdonk/nametags to your 'mint/pepper' directory. Go to the Mint preferences, select 'install' and push the button 'install' next to 'Nametags'. Installation can take some time depending on your database size. In some cases you need to install twice if the pepper does not show up. ~ UPGRADE ========= Just overwrite the directory: hansvankilsdonk/nametags at your Mint installation. Then load Mint. It could take a while when Nametags is upgrading (adding new field to the DB), so please be patient :). ~ USAGE ======= You can use Nametags in many different ways. Some explanation: ~ Track by cookie name ~ First, if you want to track your visitors by - for example - loginname go to the preferences and set at least one cookie name you want to track. When it's set you can see al the tagged users in the 'Tagged' tab. In the 'Visitors' tab you can see all the vistors - tagged and untagged. The last tab - 'Search' - is for searching an IP address or a particular tag. It also shows you the available IP tags. To make things simple: you can click on an IP tag name and it will show up in the search field. ~ Track by IP ~ You can also tag a visitor depending on their IP address. This is useful if you know someone's IP and want to know when this IP visits your website. Their are two ways to set an IP tag: in the preferences you can insert the IP address and the tag name. The other way is inline editing. If you see a visitor in your list you would like to tag by IP address click on it so you'll see all the pages this visitor has seen. At the top there's a link 'edit IP tag'. If you click on it you can insert a tag name. By pressing 'save' the tag is added to that particular IP addres. If you want to clear a tag, just make the field empty and save. !! note: you need to refresh the tab to see the tag added to the visitor In the 'Tagged' tab you can see all tagged visitors -- by cookie and by IP address. ~ Set IP tag as cookie ~ This preference is added in Nametags 0.2 and is very useful if someone's IP changes: when a tagged IP address visits your website Nametags will set a cookie named 'mint_uFx_tagcookie' with the tagname encrypted in it. So your visitor will not see which tag he (or she) has. This cookie is different from the normal cookie you can track. However, if the 'mint_uFx_tagcookie' is set it's the only tag that will show up in the statistics. ~ Favorites ~ If you have many tagged visitors and you want to track only a few you can mark them as 'favorite'. Click on a visitor and you will see the link 'add as favorite'. By clicking on it it will add the visitor to the 'Favorites' tab. You can only add 'tagged' visitors as a favorite; If you want to track all the IP tags you can set in the preferences ('Mark all IP tags as favorite'). Removing a favorite visitor is as simple as clicking on 'remove as favorite'. ~ Wordpress ~ Note for Wordpress users: the name of the User cookie is something like: wordpressuser_hash hash = md5($blogurl) ~ PREFERENCES ============= You can set some preferences: - Show page titles: whether to show the titles or the URL in the visitor information. - Number of results: maximum number of results to show (default: 25) Minimum value: 1, maximum: 100. - Tag cookie names: names of the cookie you want to track, seperated by an enter. The first cookiename that has a value is used so you'll need to sort them based on importance. - Set IP tag as cookie: this will set a unique cookie the first time an IP-tagged visitor will visit your site. Useful if the IP address of that visitors changes. - Mark all IP tags as favorite: this will show all IP tags in the 'Visitors' tab. - IP tags: add a tag to an IP address ~ CHANGELOG =========== ~ 0.32 - 20070325 - Due to a small bug you couldn't add or remove IP tags in the preferences. It's fixed in this release. ~ 0.31 - 20070323 - Due to conflicts with the Secret Crush pepper Nametags now uses it's own field for recording the IP address. Inefficient, but the only way to make Nametags independent of the Secret Crush pepper; - Proxy IP addresses are recognised now; - Still Mint 1.2+ & 2.0 compatible :); - Some code changes & bugfixes. ~ 0.2 - 20070315 - Mint 1.2+ & 2.0 compatible (some colors are weird in 1.2+); - Nametags records the IP address of your visitor. So you're warned :) - Nametags now shows the last used IP address of a visitor; - If you add an IP tag, the database table is updated by adding the tag to all the visits made by this IP address; - You can add/edit the IP tag in place by clicking on a hostname/IP. There you will see a link 'edit IP tag'; - You can mark a visitor as 'favorite' by clicking on the 'add as favorite' link in the page visits; - The tabs are changed into: * Tagged - all tagged visitors (Cookie and IP based) * Favorites - all your 'favorite' visitors * Visitors - all visitors (tagged and untagged) * Search - search for a visitor. - In the preferences you can set that all IP tags are shown in the 'Favorites' tab; - Only hostname is shown. Mouse over shows the IP address; - The color of the IP tags are a bit less red now; - In the search tab you can click on an available tag to fill the search form with this tag; - If you assign a tag to an IP address, optionally a ookie will be set when this IP address visits your website again. Now you can keep track of this visitor, even when his IP address change. - You can set multiple cookie names to track; - Code cleanup and small bugfixes. ~ 0.07 - 20061219 - Fixes incompatibility with the Session Tracker pepper. ~ 0.06 - 20061013 - Fixed the IP tags so all tags are shown (some IP's didn't work); - You can search for an IP address now; - Added the list of available tags to the search form; - Added an indicator image when searching. ~ 0.05 - 20061012 - First public release.