Requires WordPress 6.8 and PHP 8.2.<\/p>\n\n
Both admin screens moved, and they are now one screen.<\/strong> The statistics were at Update all seven WP-Stats plugins together.<\/strong> WP-Stats, WP-EMail, WP-Polls, WP-PostRatings, WP-PostViews, WP-UserOnline and WP-DownloadManager put their own blocks on the statistics page, and all seven shared one unprefixed Everything WP-Stats stores is renamed and migrated for you.<\/strong> Hook names changed.<\/strong> Two smaller changes.<\/strong> The "Plugins Stats" heading no longer appears when no plugin has contributed a block to it, and the front-end stylesheet is scoped to WP-Stats' own markup, so it no longer restyles WP-PageNavi \u2014 which also means WP-Stats no longer switches its own styles off when WP-PageNavi is active.<\/p>"},"ratings":{"1":"4","2":0,"3":0,"4":"1","5":"2"},"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":978069,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3639538,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3639538,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"wp-stats\/page-stats":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"wp-stats\/page-stats","version":"3.0.0","title":"Blog Statistics","category":"widgets","icon":"chart-area","description":"The whole statistics page: totals, listings, and whatever other plugins contribute.","keywords":["stats","statistics","totals"],"textdomain":"wp-stats","supports":{"html":false,"multiple":false,"reusable":false},"editorScript":"file:.\/index.js"}},"tagged_versions":["1.00","2.00","2.01","2.02","2.03","2.04","2.05","2.06","2.10","2.11","2.20","2.30","2.31","2.40","2.50","2.55","2.56","2.56.1","3.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3639088,"resolution":"1","location":"assets","locale":"","width":1100,"height":1900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3639088,"resolution":"2","location":"assets","locale":"","width":1100,"height":1034},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3639088,"resolution":"3","location":"assets","locale":"","width":1000,"height":1900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3639088,"resolution":"4","location":"assets","locale":"","width":327,"height":873}},"screenshots":{"1":"Stats -> Statistics: the site, then a section for every plugin that contributes one","2":"The Settings tab, which chooses what the report and the widget carry","3":"The stats page a visitor sees, from the shortcode","4":"The widget, in a sidebar"}},"plugin_section":[],"plugin_tags":[1641,4132,521,522,162],"plugin_category":[36,43],"plugin_contributors":[77620],"plugin_business_model":[],"class_list":["post-1205","plugin","type-plugin","status-publish","hentry","plugin_tags-information","plugin_tags-popular","plugin_tags-statistics","plugin_tags-stats","plugin_tags-widget","plugin_category-analytics","plugin_category-customization","plugin_contributors-gamerz","plugin_committers-gamerz"],"banners":{"banner":"https:\/\/ps.w.org\/wp-stats\/assets\/banner-772x250.png?rev=3639538","banner_2x":"https:\/\/ps.w.org\/wp-stats\/assets\/banner-1544x500.png?rev=3639538","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/wp-stats\/assets\/icon.svg?rev=978069","icon":"https:\/\/ps.w.org\/wp-stats\/assets\/icon.svg?rev=978069","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/wp-stats\/assets\/screenshot-1.png?rev=3639088","caption":"Stats -> Statistics: the site, then a section for every plugin that contributes one"},{"src":"https:\/\/ps.w.org\/wp-stats\/assets\/screenshot-2.png?rev=3639088","caption":"The Settings tab, which chooses what the report and the widget carry"},{"src":"https:\/\/ps.w.org\/wp-stats\/assets\/screenshot-3.png?rev=3639088","caption":"The stats page a visitor sees, from the shortcode"},{"src":"https:\/\/ps.w.org\/wp-stats\/assets\/screenshot-4.png?rev=3639088","caption":"The widget, in a sidebar"}],"raw_content":"\n WP-Stats builds a statistics page for your blog out of what is already in your database: how many posts, pages, comments, tags, categories and links there are, which posts drew the most comments, who has commented most often, and who writes for you. Put the Other plugins of mine can add their own blocks to that page. WP-Stats does not need to know anything about them in advance and never reads their settings.<\/p>\n\n I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations.<\/p>\n\n Blog Statistics<\/strong> is in the editor's inserter, under Widgets<\/strong>. Add it to a page and that page is your statistics page \u2014 there is nothing to configure on the block itself, because what the page shows comes from the settings and from whichever companion plugins are installed, not from the post.<\/p>\n\n It renders on the server, so the preview in the editor is the real page rather than an approximation, and the numbers are counted afresh on every view rather than frozen into the post when you save it.<\/p>\n\n The shortcode still works and is not going anywhere.<\/strong> A plugin adds a block to the statistics page by answering one filter. Return an entry keyed by your own slug with underscores:<\/p>\n\n Decide out of your own settings whether to contribute at all, and return WP-Stats then fires An entry that is malformed \u2014 not an array, no title, a Other plugins of mine add their own sections to that page when they are installed. WP-Stats needs to know nothing about them in advance.<\/p>\n\n\n Two rows. Yes. That row is deleted during the upgrade, and 3.0.0 no longer answers for it. Seven plugins used to share it, which meant none of them could change how it was stored without breaking the other six. Keep your own copy of the setting in your own option row and answer It only appears now when a plugin has actually contributed a block. Before 3.0.0 it was printed whether or not there was anything under it.<\/p><\/dd>\nDashboard -> WP-Stats<\/code> and the settings at Settings -> Stats<\/code>; there is one WP-Stats<\/code> menu now opening one page with two tabs, Statistics<\/code> and Settings<\/code>. Bookmarks to either old screen stop working: the page is wp-admin\/admin.php?page=wp-stats<\/code>, and the settings are wp-admin\/admin.php?page=wp-stats&tab=settings<\/code>. The menu has no submenu entries any more. Nothing else about the screens changed.<\/p>\n\nwp_stats_capability<\/code> still tells the two apart.<\/strong> It is filtered per tab rather than per screen, with the same statistics<\/code> and settings<\/code> contexts. A tab the current user cannot open is not drawn, and the page itself is registered with whichever of the two capabilities that user holds \u2014 so handing out the statistics tab alone works exactly as it did when it was its own menu entry.<\/p>\n\nstats_display<\/code> row between them. Each plugin keeps that setting in its own settings now, and the shared row is deleted during the upgrade. An older copy of any of the six simply stops appearing on the statistics page until you update it; if a block does not come back, switch it on again in that plugin's own settings.<\/p>\n\nstats_url<\/code>, stats_mostlimit<\/code> and stats_display<\/code> become one wp_stats_options<\/code> row, and the upgrade marker becomes wp_stats_version<\/code>. The old rows are read once and then deleted, so code calling get_option( 'stats_url' )<\/code> or get_option( 'stats_display' )<\/code> now gets false<\/code>.<\/p>\n\nstats_page<\/code> is now wp_stats_page<\/code>. The wp_stats_page_general<\/code>, wp_stats_page_plugins<\/code>, wp_stats_page_recent<\/code>, wp_stats_page_most<\/code>, wp_stats_page_authors<\/code>, wp_stats_page_comments_members<\/code>, wp_stats_page_misc<\/code>, wp_stats_paging_start<\/code> and wp_stats_paging_end<\/code> filters, the seven wp_stats_page_admin_*<\/code> filters, and the stats_display_defaults()<\/code> function are all removed. The replacement is one filter, wp_stats_sections<\/code> \u2014 see "For Plugin Authors" in the description. Every template tag a theme calls (get_totalposts()<\/code>, get_recentcomments()<\/code>, stats_page()<\/code>, snippet_text()<\/code> and the rest) keeps its name and its arguments.<\/p>\n\n[page_stats]<\/code> shortcode on a page and that page becomes your statistics page. There is a sidebar widget for the totals, and the same statistics appear in wp-admin under WP-Stats.<\/p>\n\nFeatures<\/h3>\n\n
\n
Donations<\/h3>\n\n
Usage<\/h3>\n\n
Create The Stats Page<\/h3>\n\n
\n
WP-Admin -> Pages -> Add New<\/code><\/li>\nstats<\/code> in the text field and click 'Save'.<\/li>\n[page_stats]<\/code> in the page's content area<\/li>\nWP-Admin -> WP-Stats<\/code>, open the Settings<\/code> tab and fill in 'Stats URL' with the URL of the page you just created.<\/li>\n<\/ol>\n\nThe Block<\/h3>\n\n
[page_stats]<\/code> behaves exactly as it always has, and a page already containing it needs no change. The block calls the same code the shortcode calls, so the two render identically \u2014 including the blocks other plugins contribute \u2014 and you can use whichever suits the page.<\/p>\n\nThe Widget<\/h3>\n\n
\n
WP-Admin -> Appearance -> Widgets<\/code><\/li>\nStats<\/code>.<\/li>\n<\/ol>\n\nFor Plugin Authors<\/h3>\n\n
add_filter( 'wp_stats_sections', function ( $sections ) {\n $options = get_option( 'my_plugin_options', array() );\n\n if ( empty( $options['stats_display'] ) ) {\n return $sections; \/\/ the site owner switched this block off\n }\n\n $sections['my_plugin'] = array(\n 'title' => __( 'My Plugin', 'my-plugin' ),\n 'priority' => 10,\n 'render' => 'my_plugin_render_stats',\n );\n\n return $sections;\n} );\n\nfunction my_plugin_render_stats() {\n echo '<ul><li>42 things.<\/li><\/ul>';\n}\n<\/code><\/pre>\n\ntitle is a translated heading and is required. `render` is a callable that echoes the block body, takes no arguments, and is required. `priority` sorts the blocks and defaults to 10; ties are broken by the array key.\n<\/code><\/pre>\n\n$sections<\/code> untouched if the answer is no rather than adding an entry with an empty body. WP-Stats never reads another plugin's option row and never checks whether your classes exist \u2014 if your plugin is not installed, nothing answers the filter and no block appears.<\/p>\n\nwp_stats_section_my_plugin<\/code> with your entry. Its own listener on that action is what prints the heading and calls render<\/code>, so a theme can take one plugin's block over without disturbing the others:<\/p>\n\nadd_action( 'wp_stats_section_my_plugin', function ( $section ) {\n remove_action( 'wp_stats_section_my_plugin', array( 'WP_Stats_Page', 'render_section' ) );\n echo '<p>drawn by the theme instead<\/p>';\n}, 5 );\n<\/code><\/pre>\n\nrender<\/code> that is not callable \u2014 is skipped. It will not take the page down, and it will not tell you either, so check your block appears.<\/p>\n\n\n\n
[page_stats]<\/code> shortcode in it, or add the Stats<\/strong> block. That page becomes your statistics page. Usage below has the full steps.<\/li>\nWP-Stats<\/code>, and there is a sidebar widget for the totals.<\/li>\n<\/ol>\n\n\n
Which options does the plugin store?<\/h3><\/dt>\n
wp_stats_options<\/code> holds the stats page URL, the \"top X\" limit and the display toggles; wp_stats_version<\/code> records the version last run so an upgrade knows what it is upgrading from. Deleting the plugin from the Plugins screen removes both.<\/p><\/dd>\nI have a plugin that reads `get_option( 'stats_display' )`. Will it break?<\/h3><\/dt>\n
wp_stats_sections<\/code> \u2014 see \"For Plugin Authors\" above.<\/p><\/dd>\nThe Plugins Stats heading has disappeared<\/h3><\/dt>\n