FINAL suepr merge step : added all modules to this super repos

sites/all/modules/contrib/users/user_stats/README.txt

@@ -0,0 +1,95 @@
+
+CONTENTS OF THIS FILE
+---------------------
+
+  - Introduction
+  - Installation
+  - Configuration
+  - Accessing statistics from a theme
+
+
+INTRODUCTION
+------------
+
+Current Maintainer: Liam McDermott.
+Contact via: http://www.intermedia-online.com/#contact
+
+The primary goal of User stats is to provide commonly requested user statistics
+for themers. These are:
+
+  - days registered;
+  - join date;
+  - days since last login;
+  - days since last post;
+  - post count;
+  - login count;
+  - user online/offline;
+  - IP address;
+
+The module has also been improved to integrate with the Rules (http://drupal.org/project/rules)
+and Views (http://drupal.org/project/views) modules. Finally, it also provides
+IP address to assist with catching spammers on community sites.
+
+
+INSTALLATION
+------------
+
+User stats is installed in the same way as most other Drupal modules.
+Here are the instructions for anyone unfamiliar with the process:
+
+1. Copy this user_stats/ directory to your sites/SITENAME/modules directory.
+
+2. Back in your Web browser, navigate to Administer -> Site building -> Modules
+   then enable the User Stats module.
+
+
+CONFIGURATION
+-------------
+
+The configuration page for User Stats can be found by browsing to
+Administer -> Site configuration -> User Stats settings
+
+If IP address tracking is enabled (and Views is installed),
+'IP address tracking' will appear under the Administer -> Reports section.
+
+Integration with Rules and Views happens automatically, see these modules'
+configuration pages for functionality provided by User Stats.
+
+
+ACCESSING STATISTICS FROM A THEME
+---------------------------------
+
+Some knowledge of theme authoring is needed for this task. For more information
+on theme authoring, see: http://drupal.org/theme-guide/6 Alternatively the
+Advanced Forum (http://drupal.org/project/advanced_forum) module assists with
+this and provides lots of helpful documentation.
+
+User Stats are accessed from a theme using the user_stats_get_stats() function.
+For example:
+
+<p>Post count: <?php print user_stats_get_stats('post_count', $node->uid); ?></p>
+
+Placed in node-forum.tpl.php would print the user's post count. The first argument
+is a string indicating which statistic should be retrieved, the second is an
+integer user id who's statistics should be retrieved. Following is a list of the
+statistics it is possible to retrieve:
+
+  - ip_address -- IP Address of the user that posted the node;
+
+  - join_date -- time stamp representing when the user joined;
+
+  - login_count -- number of times the user has logged-in;
+
+  - login_days -- number of days since the user was last logged-in to the site;
+
+  - post_count -- number of nodes and comments created by the user (the type of
+    posts to count is configurable in the User stats settings page);
+
+  - post_days -- number of days since the user last posted;
+
+  - reg_days -- number of days since the user registered on the site;
+
+  - online -- whether the user is online (basically whether they have done
+    anything in the last 15 minutes);
+
+For more information, and examples, see: http://www.apaddedcell.com/an-introduction-user-stats-module-drupal