User Tools

Site Tools


Sidebar

addons:site_stats:start

Site Stats Addon

This feature will be available beginning with v7.1

This addon allows you to insert stats about listing count and user count into your site. There are several statistics provided by this addon and you can see the full list of tags and what they provide below. Each tag only returns one number and no text. If you want to identify the statistic you'll need to place that label in the html around the addon tag in your templates.

Addon Template Tags

Fixed tags

These tags are fixed and no additional information can be passed in to affect the data returned.

{addon author='geo_addons' addon='site_stats' tag='number_listings_all_types'} This returns the total number of live listings within the site at that moment. This includes classifieds, auctions,….etc.

{addon author='geo_addons' addon='site_stats' tag='number_classifieds'} This returns the total number of live classifieds within the site at that moment.

{addon author='geo_addons' addon='site_stats' tag='number_auctions'} This returns the total number of live auctions within the site at that moment.

{addon author='geo_addons' addon='site_stats' tag='number_listings_all_types_last_24hrs'} This returns the total number of currently live listings placed in the site within the last 24 hours.

{addon author='geo_addons' addon='site_stats' tag='number_classifieds_last_24hrs'} This returns the total number of currently live classifieds placed in the site within the last 24 hours.

{addon author='geo_addons' addon='site_stats' tag='number_auctions_last_24hrs'} This returns the total number of currently live auctions placed in the site within the last 24 hours.

{addon author='geo_addons' addon='site_stats' tag='number_listings_all_types_last_7days'} This returns the total number of currently live listings placed in the site within the last 7 days.

{addon author='geo_addons' addon='site_stats' tag='number_classifieds_last_7days'} This returns the total number of currently live classifieds placed in the site within the last 7 days.

{addon author='geo_addons' addon='site_stats' tag='number_auctions_last_7days'} This returns the total number of currently live auctions placed in the site within the last 7 days.

{addon author='geo_addons' addon='site_stats' tag='number_listings_all_types_last_30days'} This returns the total number of currently live listings placed in the site within the last 30 days.

{addon author='geo_addons' addon='site_stats' tag='number_classifieds_last_30days'} This returns the total number of currently live classifieds placed in the site within the last 7 days.

{addon author='geo_addons' addon='site_stats' tag='number_auctions_ending_next_24hrs'} This returns the total number of currently live auctions on the site that expire in the next 24 hours.

{addon author='geo_addons' addon='site_stats' tag='number_auctions_ending_next_7days'} This returns the total number of currently live auctions on the site that expire in the next 7 days.

{addon author='geo_addons' addon='site_stats' tag='number_auctions_last_30days'} This returns the total number of currently live auctions on the site that expire in the next 30 days.

{addon author='geo_addons' addon='site_stats' tag='number_of_registrants_24hrs'} This is the total number of new registrants in the last 24 hours.

{addon author='geo_addons' addon='site_stats' tag='number_of_registrants_7days'} This is the total number of new registrants in the last 7 days.

{addon author='geo_addons' addon='site_stats' tag='number_of_registrants_30days'} This is the total number of new registrants in the last 30 days.

Tags With Variables

These tags have one or more variables that can be passed in to affect the data returned.

{addon author='geo_addons' addon='site_stats' tag='total_views' listing_type='0,1,2'} This tag returns the total view count of currently live listings on your site. The variables you can pass in are:

  • listing_type (optional) - If '0' is passed in all listing types will be polled. If you passed in '1' only classified total views will be polled. If you pass in '2' only auctions will be pulled. If you do not pass in this variable all listing types will be polled.

{addon author='geo_addons' addon='site_stats' tag='number_of_registrants_last' days='#'} This tag returns the total number of registrants within the last number of 'days'. This measure registrants through the JIT registration and Social Connect features as well as those that complete the registration process. The variable you can pass in is:

  • days (optional) - This must be numerical. If any other value type is passed in all registrants within the last 24 hours will be returned. This is the allows you to set the number of days from now into the past to get a registrant total. If you set to '10' the software will pull the total number of registrants in the last 10 days. If this is '0' or no 'days' value is passed in the registrant total in the last 24 hours will be returned.

{addon author='geo_addons' addon='site_stats' tag='number_of_logins_last' days='#'} This tag returns the total number of registrants logged into the site in the last number of 'days'. This does not count the number of multiple logins but whether there was a login within that time period. Anonymous users stats have no effect in this stat as they do not log into the site. If you have a lot of anonymously placed listings in your site this stat will not be too useful to gauge the site usage as a whole. The variable you can pass in is:

  • days (optional) - This must be numerical. If any other value type is passed in all registrants logging into the site within the last 24 hours will be returned. This is the allows you to set the number of days from now into the past to get a login total. If you set to '10' the software will pull the total number of registrants logging in within the last 10 days. If this is '0' or no 'days' value is passed in the registrant total in the last 24 hours will be returned.

{addon author='geo_addons' addon='site_stats' tag='number_of_users_place_listing_in_last' days='#' listing_type='0,1,2'} This tag returns the total number of registrants placing listing in the last number of 'days'. Anonymous users stats count only as one in this stat no matter how many anonymously placed listings there have been in the time period. If you have a lot of anonymously placed listings in your site this stat will not be too useful to gauge the site as a whole. The variable you can pass in are:

  • days (optional) - This must be numerical. If any other value type is passed in all registrants logging into the site within the last 24 hours will be returned. This variable allows you to set the number of days from now into the past to get a login total. If you set to '10' the software will pull the total number of registrants logging in within the last 10 days. If this is '0' or no 'days' value is passed in the registrant total in the last 24 hours will be returned.
  • listing_type (optional) - If '0' is passed in all listing types will be polled. If you passed in '1' only unique registrants placing classifieds will be totalled. If you pass in '2' only auctions will be polled. If you do not pass in this variable all listing types will be polled.

{addon author='geo_addons' addon='site_stats' tag='number_listings_region_category' region='#' listing_type='0,1,2' category='#'} This tag returns the total number of listings of a specific listing type from within a category a region or a region and category. For this tag to return any results the geographic navigation addon must be installed and enabled. The variable(s) you can pass in are:

  • region (required) - This must be numerical. This returns the number of listings within this region and sub-regions. If you set to '10' the software will pull the total number of listings within region 10 and it's subregions. If this is '0' or no 'region' value is passed in this tag will return nothing irregardless of the other values passed in. You can find the region id for any specific region within the GEOGRAPHIC SETUP > REGIONS admin tool. The region id for a region is the number in parentheses next to that region within the above mentioned admin tool.
  • category (required) - This must be numerical. This returns the number of listings within this category and sub-categories. If you set to '10' the software will pull the total number of listings within category 10 and it's sub-categories. If this is '0' or no 'category' value is passed in the category will not be considered in the count returned by this tag. The category id passed in must be a valid category id for a category within the software. You can find the category id for any specific category within the CATEGORIES > CATEGORY SETUP admin tool. The category id for a category is the number in parentheses next to each category name within the above mentioned admin tool.
  • listing_type (optional) - If '0' is passed in all listing types will be polled. If you passed in '1' only unique registrants placing classifieds will be totalled. If you pass in '2' only auctions will be polled. If you do not pass in this variable all listing types will be polled.

{addon author='geo_addons' addon='site_stats' tag='number_listings_category' listing_type='0,1,2' category='#'} This tag returns the total number of listings of a specific listing type from within a category . For this tag to return any results the geographic navigation addon must be installed and enabled. The variable(s) you can pass in are:

  • category (required) - This must be numerical. This returns the number of listings within this category and sub-categories. If you set to '10' the software will pull the total number of listings within category 10 and it's sub-categories. If this is '0' or no 'category' value is passed in the category will not be considered in the count returned by this tag. The category id passed in must be a valid category id for a category within the software. You can find the category id for any specific category within the CATEGORIES > CATEGORY SETUP admin tool. The category id for a category is the number in parentheses next to each category name within the above mentioned admin tool.
  • listing_type (required) - If '0' is passed in all listing types will be polled. If you passed in '1' only unique registrants placing classifieds will be totalled. If you pass in '2' only auctions will be polled. If you do not pass in this variable all listing types will be polled.

Example Usage Within templates

number of registrants in last 24 hours: {addon author='geo_addons' addon='site_stats' tag='number_of_registrants_24hrs'} <br>
number of registrants who have placed classifieds in the last 5 days: {addon author='geo_addons' addon='site_stats' tag='number_of_users_place_listing_in_last' days='5' listing_type='1'}<br>
number of unique logins the last 12 days: {addon author='geo_addons' addon='site_stats' tag='number_of_logins_last' days='12'}<br>
number of registrants in the last 12 hours: {addon author='geo_addons' addon='site_stats' tag='number_of_registrants_last' days='.5'}<br>
total views on the site: {addon author='geo_addons' addon='site_stats' tag='total_views'}
addons/site_stats/start.txt · Last modified: 2015/01/14 23:07 by geojames