DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:quickstats

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:quickstats [2019-11-09 15:41] – [Maxmind] turnermmplugin:quickstats [2022-01-07 17:09] (current) – [QuickStats Plugin] Updates version date turnermm
Line 6: Line 6:
 email      : turnermm02@shaw.ca email      : turnermm02@shaw.ca
 type       : syntax,action type       : syntax,action
-lastupdate : 2018-12-06 +lastupdate : 2022-01-07 
-compatible :  Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus,"Elenor Of Tsort","Frusterick Manners",Greebo+compatible : Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun, Detritus,"Elenor Of Tsort","Frusterick Manners",Greebo,hogfather
 depends    :  depends    : 
 conflicts  conflicts 
Line 81: Line 81:
  
 %%~~QUICKSTATS:<month_year>~~%% is a synonym for %%~~QUICKSTATS:<month_year>&basics~~%% %%~~QUICKSTATS:<month_year>~~%% is a synonym for %%~~QUICKSTATS:<month_year>&basics~~%%
 +
 +    ~~QUICKSTATS:total~~
 +%%~~QUICKSTATS:total~~%% will print the total number of page hits since the start of record keeping.
  
  
Line 122: Line 125:
 </code>      </code>     
                
 +Total page accesses from beginning of record keeping to present: 
 +  ~~QUICKSTATS:total~~ 
 +The above can be configured for output by using this class: ''quick-total'' 
 +   
 ===== Output for diffferent parameters ===== ===== Output for diffferent parameters =====
  
Line 159: Line 165:
 ===== Sample Output of Basics ===== ===== Sample Output of Basics =====
  
-[[https://mturner.org/devel/quick/6_2017b|June 2017]]+[[https://mturner.org/devel/quickstats/9_2017|September 2017]]
  
 ===== Automating syntax plugin with Dokuwiki templates ===== ===== Automating syntax plugin with Dokuwiki templates =====
Line 243: Line 249:
 For Maxmind,  GeoLite2-City.mmdb must be installed on your server.  You can install it automatically by going to the Admin panel. Click on ''Download DB'' and the database should install. You should periodically reinstall GeoLite2-City.mmdb if you wish to keep current.  For Maxmind,  GeoLite2-City.mmdb must be installed on your server.  You can install it automatically by going to the Admin panel. Click on ''Download DB'' and the database should install. You should periodically reinstall GeoLite2-City.mmdb if you wish to keep current. 
  
-If you have any problems using the auto install feature you can go to the Maxmind [[https://dev.maxmind.com/geoip/geoip2/geolite2/#Databases|database page]] and download the GeoLite 2 City database file.  The download is is a ''.tar.gz'' file with a name that uses this format: GeoLite2-City_20191105.tar.gz, where the number is the date the database was updated.  Unpack this file and copy GeoLite2-City.mmdb to: ''quickstats/GEOIP/vendor/GeoLite2-City''.+If you have any problems using the auto install feature you can go to the Maxmind [[https://dev.maxmind.com/geoip/geoip2/geolite2/#Databases|database page]].  Follow the instructions for setting up an account and downloading the GeoLite 2 City database file.  The download is is a ''.tar.gz'' file with a name that uses this format: GeoLite2-City_20191105.tar.gz, where the number is the date the database was updated.  Unpack this file and copy GeoLite2-City.mmdb to: ''quickstats/GEOIP/vendor/GeoLite2-City''
 +Because of recent changes at Maxmind, you will now have to register for an account to download this database. This doesn't apply to the auto download.
  
  
Line 249: Line 256:
 Maxmind changed the format of its databases.  Previously, it consisted of two self-sufficent database files, GeoIPv6.dat and  GeoLiteCity.dat. The upgrade, GeoLite2, handles both IPv4 and IPv6.  GeoLite2 requires as a phar package. This package comes pre-installed with quickstats. If ever there is a need to reinstall, see the file GEOIP/initialize_vendor.txt.   Maxmind changed the format of its databases.  Previously, it consisted of two self-sufficent database files, GeoIPv6.dat and  GeoLiteCity.dat. The upgrade, GeoLite2, handles both IPv4 and IPv6.  GeoLite2 requires as a phar package. This package comes pre-installed with quickstats. If ever there is a need to reinstall, see the file GEOIP/initialize_vendor.txt.  
  
-Quickstats has left in place the code for accessing the old GeoLite formats.  This means that if yhou have been using quickstats up utnil now and your disable both geoPlugin and geoLite2, the plugin will continue to access the old databases, should they still be on the server.  If for any reason you should still need the old databases, you can get them from this url: https://github.com/turnermm/utils/archive/geocity_zip.zip.  This package contains both GeoIPv6.dat and  GeoLiteCity.dat, which go into the GEOIP folder or the folder selected in the Configuration Options.+The code for accessing the old GeoLite formats has been left in place.  This means that if you have been using quickstats up until now and you disable both geoPlugin and GeoLite2, the plugin will continue to access the old databases.  If for any reason you should still need the old databases, you can get them from this url: https://github.com/turnermm/utils/archive/geocity_zip.zip.  This package contains both GeoIPv6.dat and  GeoLiteCity.dat, which go into the GEOIP folder or the folder selected in the Configuration Settings((See options 3 and 4)).
 ==== Geoplugin ==== ==== Geoplugin ====
 geoPlugin is supplied by [[http://www.geoplugin.com/|http://geoplugin.com]]. It is included with the quickstats plugin. geoPlugin is a free web-based service, while Maxmind's ''GeoLite2-City.mmdb'' installs on your server.  Quickstats defaults to geoPlugin, which means that quickstats is immediately ready to use upon installation. geoPlugin itself uses the MaxMind services. geoPlugin is supplied by [[http://www.geoplugin.com/|http://geoplugin.com]]. It is included with the quickstats plugin. geoPlugin is a free web-based service, while Maxmind's ''GeoLite2-City.mmdb'' installs on your server.  Quickstats defaults to geoPlugin, which means that quickstats is immediately ready to use upon installation. geoPlugin itself uses the MaxMind services.
Line 303: Line 310:
 ===== Discussion ===== ===== Discussion =====
  
-Please use the forum for questions. Thanks. +Please use the forum or github for questions and issues. Thanks.
- +
-Suggestions: +
-  - The ability to request multiple months at once (with merged results) or even to request all data. +
-  - Listing available months as links. Clicking on the links would show the data. +
-  - Some way to view the current month. +
-  - The query feature in the admin only requests very precise bits of data. Since this plugin is most interesting to admins, it would be nice if the admin UI let you get general statistics for any month, selected from a list of available months. +
- +
--[[user>Zioth]] +
- +
-> Could you post these issues to the [[http://forum.dokuwiki.org|forum]] or to the github issues [[https://github.com/turnermm/quickstats/issues|tracker]]? If I understand your questions by the way, I think that most of the issues are already covered by the plugin. See, for instance, [[#the_query_form|The Query Form]] above. +
-Thanks. +
- +
--[[user>Syrus]]+
  
  
-I've put my suggestions (and one more not listed here) in the github issue tracker. 
--[[user>Zioth]] 
  
-> This plugin made my DokuWiki very slow. 
->> Should be fixed in current ajax update, which moves most of the processing after browser loading of page 
  
->> Have you read the section on [[#geo-locating|Geo-locating]]?  And please use the forum. 
  
  
Line 331: Line 320:
 ==== Recent Changes ==== ==== Recent Changes ====
  
-{{rss>https://github.com/turnermm/quickstats/commits/master.atom date}}+{{rss>https://github.com/turnermm/quickstats/commits/master.atom date 10}}
  
 For complete details on fixes and upgrades, see the quickstats [[https://github.com/turnermm/quickstats/commits|commits]] panel on github. For complete details on fixes and upgrades, see the quickstats [[https://github.com/turnermm/quickstats/commits|commits]] panel on github.
plugin/quickstats.1573310500.txt.gz · Last modified: 2019-11-09 15:41 by turnermm

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki