mzz-stat Plugin

Note: Suggested code changes / pull requests are welcome over on the plugin’s companion github repository, here: https://github.com/mjassen/mzz-stat

The Purpose of the plugin
The purpose of the plugin is to show the WP site administrator how many visits per page per day to their WP site.

What the Plugin Does
The plugin records an uri name for each page request on the WordPress site. Then in the WordPress admin area, in the Dashboard menu under Tools > Mzz-stat, a page shows a report of these statistics, including a count of how many URI (page/post) views per day. Thus by looking at the statistics page the WordPress administrator can know whether anyone is visiting their site, and, how many uri requests were made on which page on which day.

How the Mzz-stat plugin works
Upon installing and activating the Mzz-stat plugin, it installs its own table in the WordPress database alongside the other database tables. The plugin logic hooks into the wp_footer action hook, and each time someone requests any page on the site, the plugin inserts a record of that visit into the database table. Then, at any time the WordPress Administrator can go to the Admin page and see the report in the Dashboard menu under Tools > Mzz-stat menu. There will be a list of each page visited (for a time period) along with a count of how many visits for that page per day. If one deactivates the plugin, it will no longer insert records of uri requests unless/until the plugin is again activated. If one deletes the plugin then that will completely uninstall the plugin and remove the files, database table, and data.

Credits

Thanks to CrazyStat ( http://www.christosoft.de/CrazyStat ) for inspiring me and thanks to this discussion: ( https://wordpress.org/support/topic/stats-plugin-8 ) for helping steer the direction of the plugin.

To install the plugin manually, unzip the plugin and upload the entire “mzz-stat” folder into the “wp-content/plugins” directory of your WordPress website.
Then log into the WordPress dashboard, and under Plugins, click Activate.
The plugin follows the same install procedure as described at https://codex.wordpress.org/Managing_Plugins#Installing_Plugins

To completely and permanently uninstall the plugin including its files and data, browse to the WordPress dashboard and under Plugins, under the Mzz-stat plugin, click Deactivate, then click Delete.

1. 

   Plugin activation screen

2. 

   Admin screen

What is the purpose of the plugin, what does the plugin do, and how does the plugin work?

For for a detailed description of what the plugin does and how it works, please see the Plugin Description tab/page of this readme.

Does the plugin support multisite?

Not currently.

Is the plugin internationalized or localized?

Not currently.

How to get support for the plugin?

The primary support is through the plugin’s WordPress.org support forums page: https://wordpress.org/support/plugin/mzz-stat

How to get/download the plugin?

The current version of the plugin can be downloaded from its page here on WordPress.org: https://wordpress.org/plugins/mzz-stat/

Where else to get/download the plugin?

The current version can also be downloaded from its Github page here: https://github.com/mjassen/mzz-stat/archive/master.zip

20170304.1423

• 03 March 2017 by mjjojo(mjassen)
• In this version 20170304.1423 we remove the old database table upgrade logic. More on this: Just before the last mzz-stat plugin v.20160503.2046, there was a notable database table change. In other words if you want to do an upgrade that jumps from before to after plugin version no. 20160503.2046, then please hit version 20160503.2046 along the way, because it contained logic to perform the upgrade from the old table to the new table. This logic isn’t present in subsequent versions.

20160503.2046

• Added fix to address …Missing argument 1 for mzz_mzzstat_upgrade_migrate_db_v1_v2…bug

20160320.2203

• 20 March 2016 by mjjojo(mjassen)
• Extensive changes including the table schema and reporting format.
• Now stores in the database table one row per-page-per-month and has a field representing 31 days of that month.
• Now updates/increments the hit count for the given day in the database, instead of inserting a new record for each hit.
• Now tracks hits by the day — no longer records any record of the hh:mm:ss
• Includes logic to perform the upgrade from the old table to the new table, including migrating the data and deleting the old table.

20151230.2238

• 30 December 2015 by mjjojo(mjassen)
• Changed what data is seen in the Admin page. Now it is All-time hits, last-5-days hits, and then a big table/matrix of hits per page per day for past 5 days.
• Added more clear, complete description of the plugin and what it does, and FAQ, and credits, to the readme file.

20151224.2249

• 24 December 2015 by mjjojo(mjassen)
• Changed what data is seen in the Admin page. Now it is All-time hits, last-30-days hits, and then a big table/matrix of hits per page per day for past 30 days.
• added more thorough code comments.

20151220.2130

• 20 December 2015 by mjjojo(mjassen)
• Put a patch/workaround in the MySQL query code to allow for apparent time zone discrepancy.

20151220.0953

• 20 December 2015 by mjjojo(mjassen)
• Changed what info is shown in the dashboard. Now shows page hits count in the last month for each page that was requested.

20151215.2133

• 15 December 2015 by mjjojo(mjassen)
• Added more info to the dashboard. added top 20 latest hits data displayed.

20151207.2118

• 07 December 2015 by mjjojo(mjassen)
• Streamlined database install logic to run not with every plugin call but rather only during activation on install hook.
• Under the WP dashboard > Tools admin menu, added a menu item to a dashboard page for site administrators. The Mzz-stat admin page displays the Mzz-stat statistics like total site visitor count.
• As the statistics are now shown in the new admin page, removed the shortcode logic so now the stats can’t be viewed via a shortcode.

20151206.2043

• 06 December 2015 by mjassen
• added database install code script that installs the mzzstat database table if it doesn’t already exist.

20151205.1008

• 05 December 2015 by mjassen
• added uninstall.php script that properly removes the mzzstat database table. Upon clicking Delete for the plugin. (In the plugins area of the WP dashboard, after having deactivated the plugin, upon clicking the Delete link.)

20151204.2108

• 04 December 2015 by mjassen
• Changed the footer stat insert code to use native WordPress database call.

20151124.1

• 24 November 2015 by mjassen
• Changed the shortcode display code to use native WordPress database call.

20150903.1

• 3 September 2015 by mjassen
• added a readme.txt changelog file to track changes.
• changed versioning to have datestamp.

0.0.1

• 10 August 2015 by mjassen
• initial release