Title: WP-Stats Author: Lester Chan Published: 3 ژانویه 2006 Last modified: 9 آگوست 2026 --- جستجوی افزونه‌ها ![](https://ps.w.org/wp-stats/assets/banner-772x250.png?rev=3639538) ![](https://ps.w.org/wp-stats/assets/icon.svg?rev=978069) # WP-Stats توسط [Lester Chan](https://profiles.wordpress.org/gamerz/) [دانلود](https://downloads.wordpress.org/plugin/wp-stats.3.0.0.zip) * [جزئیات](https://fa.wordpress.org/plugins/wp-stats/#description) * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/wp-stats/#reviews) * [نصب](https://fa.wordpress.org/plugins/wp-stats/#installation) * [توسعه](https://fa.wordpress.org/plugins/wp-stats/#developers) [پشتیبانی](https://wordpress.org/support/plugin/wp-stats/) ## توضیحات 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 `[page_stats]` 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. 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. ### Features * A full statistics page from one shortcode * Totals for posts, pages, comments, commenters, tags, categories, links and authors * Top X most commented posts and pages, most recent posts and most recent comments * A per-commenter view listing every comment somebody has left, with paging * A sidebar widget for the totals * Every block can be switched off individually ### Donations 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. ### Usage ### Create The Stats Page 1. Go to `WP-Admin -> Pages -> Add New` 2. Type any title you like in the page’s title area 3. If you ARE using nice permalinks, WordPress will generate the permalink to the page after you type the title. You will see an ‘Edit’ link just beside the permalink. 4. Click ‘Edit’, type in `stats` in the text field and click ‘Save’. 5. Type `[page_stats]` in the page’s content area 6. Click ‘Publish’ 7. If you ARE NOT using nice permalinks, go to `WP-Admin -> WP-Stats`, open the `Settings` tab and fill in ‘Stats URL’ with the URL of the page you just created. ### The Block **Blog Statistics** is in the editor’s inserter, under **Widgets**. Add it to a page and that page is your statistics page — 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. 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. **The shortcode still works and is not going anywhere.** `[page_stats]` 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 — including the blocks other plugins contribute — and you can use whichever suits the page. ### The Widget 1. Go to `WP-Admin -> Appearance -> Widgets` 2. The widget name is `Stats`. ### For Plugin Authors A plugin adds a block to the statistics page by answering one filter. Return an entry keyed by your own slug with underscores: ``` add_filter( 'wp_stats_sections', function ( $sections ) { $options = get_option( 'my_plugin_options', array() ); if ( empty( $options['stats_display'] ) ) { return $sections; // the site owner switched this block off } $sections['my_plugin'] = array( 'title' => __( 'My Plugin', 'my-plugin' ), 'priority' => 10, 'render' => 'my_plugin_render_stats', ); return $sections; } ); function my_plugin_render_stats() { echo ''; } ``` ``` title 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. ``` Decide out of your own settings whether to contribute at all, and return `$sections` 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 — if your plugin is not installed, nothing answers the filter and no block appears. WP-Stats then fires `wp_stats_section_my_plugin` with your entry. Its own listener on that action is what prints the heading and calls `render`, so a theme can take one plugin’s block over without disturbing the others: ``` add_action( 'wp_stats_section_my_plugin', function ( $section ) { remove_action( 'wp_stats_section_my_plugin', array( 'WP_Stats_Page', 'render_section' ) ); echo '

drawn by the theme instead

'; }, 5 ); ``` An entry that is malformed — not an array, no title, a `render` that is not callable— is skipped. It will not take the page down, and it will not tell you either, so check your block appears. ## عکس‌های صفحه [⌊Stats -> Statistics: the site, then a section for every plugin that contributes one⌉⌊Stats -> Statistics: the site, then a section for every plugin that contributes one⌉[ Stats -> Statistics: the site, then a section for every plugin that contributes one [⌊The Settings tab, which chooses what the report and the widget carry⌉⌊The Settings tab, which chooses what the report and the widget carry⌉[ The Settings tab, which chooses what the report and the widget carry [⌊The stats page a visitor sees, from the shortcode⌉⌊The stats page a visitor sees, from the shortcode⌉[ The stats page a visitor sees, from the shortcode [⌊The widget, in a sidebar⌉⌊The widget, in a sidebar⌉[ The widget, in a sidebar ## بلوک‌ها این افزونه 1 بلوک ارائه می‌دهد. * Blog Statistics The whole statistics page: totals, listings, and whatever other plugins contribute. ## نصب 1. Install and activate the plugin. 2. Create a page and put the `[page_stats]` shortcode in it, or add the **Stats** block. That page becomes your statistics page. Usage below has the full steps. 3. The same statistics are in wp-admin under `WP-Stats`, and there is a sidebar widget for the totals. 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. ## سوالات متداول ### Which options does the plugin store? Two rows. `wp_stats_options` holds the stats page URL, the “top X” limit and the display toggles; `wp_stats_version` records the version last run so an upgrade knows what it is upgrading from. Deleting the plugin from the Plugins screen removes both. ### I have a plugin that reads `get_option( ‘stats_display’ )`. Will it break? 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 `wp_stats_sections` — see “For Plugin Authors” above. ### The Plugins Stats heading has disappeared 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. ### Why do my author counts look different? “Authors” now means the users who can publish posts, which is what the block always claimed to count. It used to be derived from the legacy `user_level` meta, and it excluded anyone with a password reset in progress. ## نقد و بررسی‌ها ![](https://secure.gravatar.com/avatar/be43b513634d2273b5cd78ccb029754c6ec79553669913cb22a6d89cb1da8b8c? s=60&d=retro&r=g) ### 󠀁[Was much needed](https://wordpress.org/support/topic/was-much-needed/)󠁿 [](https://profiles.wordpress.org/memento000/) 9 نوامبر 2016 Useful for blogs with a lot of posts! ![](https://secure.gravatar.com/avatar/74e6dca69fb5137978a5a91be12d8903711375ccf30e2fc57ba6c23edff53e33? s=60&d=retro&r=g) ### 󠀁[Worked right away](https://wordpress.org/support/topic/worked-right-away-7/)󠁿 [Dinamicore](https://profiles.wordpress.org/dinamicore/) 2 نوامبر 2016 Worked right away. Should be very informative for heavy bloggers. I don´t see a reason nor and argument for the 1 star reviews. Rate it 5 stars. ![](https://secure.gravatar.com/avatar/7c5493fff394b6317443ab4192a832bbb4837c2bf76abb2374557db075c58b05? s=60&d=retro&r=g) ### 󠀁[Disappointing](https://wordpress.org/support/topic/disappointing-34/)󠁿 [Cristina](https://profiles.wordpress.org/darthcena/) 3 سپتامبر 2016 Plugin works until you try to modify the settings. Author refuses to do his due diligence to fix the problems. ![](https://secure.gravatar.com/avatar/6e4bcdcb4749bb317b8260ca1bf9504a16088105d056a2b0d8c5cf0a145a688c? s=60&d=retro&r=g) ### 󠀁[nice and tiny](https://wordpress.org/support/topic/nice-and-tiny/)󠁿 [Mike V. Gorbunov](https://profiles.wordpress.org/michael_zloi/) 3 سپتامبر 2016 I don’t understand previous bad reviews on that plugin as it works fine. It’s very simple and informative, so I recommend it to everyone. [ خواندن تمامی 7 نقد و بررسی‌ ](https://wordpress.org/support/plugin/wp-stats/reviews/) ## توسعه دهندگان و همکاران “WP-Stats” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند. مشارکت کنندگان * [ Lester Chan ](https://profiles.wordpress.org/gamerz/) “WP-Stats” به 5 زبان ترجمه شده است. با تشکر از [مترجمین](https://translate.wordpress.org/projects/wp-plugins/wp-stats/contributors) برای همکاری و کمک‌هایشان. [ترجمه “WP-Stats” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/wp-stats) ### علاقه‌ مند به توسعه هستید؟ [کد را مرور کنید](https://plugins.trac.wordpress.org/browser/wp-stats/)، [مخزن SVN](https://plugins.svn.wordpress.org/wp-stats/) را بررسی کنید، یا از طریق [RSS](https://plugins.trac.wordpress.org/log/wp-stats/?limit=100&mode=stop_on_copy&format=rss) در [گزارش توسعه](https://plugins.trac.wordpress.org/log/wp-stats/) مشترک شوید. ## گزارش تغییرات ### 3.0.0 * FIXED: Recent Posts and Most Commented did not honour a site’s own `posts_where` filter. `get_posts()` suppresses filters by default, so a membership or paywall plugin hiding published posts had them listed on the public statistics page anyway— which contradicted the reasoning the rest of the file is built on, that these queries go through core’s APIs precisely so a site’s content rules still apply * FIXED: One of the three places that builds an author link did not escape the URL, relying instead on the caller having encoded the name first. It happens to be true today; nothing enforces it * BREAKING: Requires WordPress 6.8 and PHP 8.2, up from 6.0 and 7.4. * BREAKING: The `stats_url`, `stats_mostlimit`, `stats_display`, `stats_options` and `stats_db_version` rows are replaced by `wp_stats_options` and `wp_stats_version`, migrated automatically on upgrade and then deleted. The old names are no longer answered. * BREAKING: The unprefixed `stats_page` filter is now `wp_stats_page`, and is handed the page complete with its wrapper element. * BREAKING: The seven `wp_stats_page_*` filters, the two `wp_stats_paging_*` filters and the seven `wp_stats_page_admin_*` filters are removed. A plugin contributing a block answers `wp_stats_sections` and renders through `wp_stats_section_`. * BREAKING: `stats_display_defaults()` is removed. A plugin keeps its own display setting in its own option row. * BREAKING: The statistics screen moved from `Dashboard -> WP-Stats` and the settings from `Settings -> Stats` onto one `WP-Stats` page with two tabs, `Statistics` and `Settings`, at `admin.php?page=wp-stats`. * BREAKING: Every class is prefixed. The widget class is `WP_Stats_Widget`; placed widgets and their settings are unaffected. * NEW: A **Blog Statistics** block, `wp-stats/page-stats`, which renders the statistics page in the editor and on the front end. The `[page_stats]` shortcode is unchanged and still supported — the block calls the same code, so the two render identically and a page already using the shortcode needs no change. * NEW: `wp_stats_sections` and `wp_stats_section_`, the contract other plugins use to add a block to the statistics page. * NEW: `wp_stats_capability`, which every capability check goes through, so the read-only statistics tab can be opened to editors without opening the settings. * NEW: Restructured into `includes/` with one class per responsibility. * NEW: Settings screen rebuilt on the WordPress Settings API. * NEW: PHPUnit test suite and GitHub Actions CI. * CHANGED: The statistics page is wrapped in `
` and the stylesheet is scoped to it, so it no longer restyles WP-PageNavi’s paging and no longer refuses to load when that plugin is active. * CHANGED: The stylesheet moved to `css/wp-stats.css` and inherits the theme’s colours instead of hardcoding blue on white. A theme’s own copy of `stats-css. css` is no longer looked for; dequeue the `wp-stats` handle instead. * CHANGED: Every listing is built from core query APIs rather than hand-written SQL, so the results are cached the way the rest of WordPress caches them and any filter a site already uses to hide content still applies. * CHANGED: The “Authors” counts are the users who can publish posts, rather than users with a legacy `user_level` above 1. * CHANGED: `stats_author` and `stats_page` are registered query variables now. * FIXED: The stylesheet never loaded, because it was hooked to `wp_enqueue_script`, which is not an action. It now loads on pages that render the paging. * FIXED: Rendering the statistics page no longer overwrites the global `$post`, which could leave a theme’s loop pointing at the wrong entry. * FIXED: Uninstalling on multisite stopped at the hundredth site and left the rest of the network’s rows behind. * FIXED: `get_linkcats()` and `get_tags_list()` used arguments and functions deprecated since WordPress 3.0. * FIXED: Removed the unreachable “Comments Protected” branch; every listing already excludes password-protected posts. * FIXED: A negative `stats_page` query argument caused a SQL error. * FIXED: A commenter whose name contains an apostrophe or a quote — “Sinead O’Brien” is enough — got an empty list of comments, under a heading with a stray backslash in it. The `stats_author` query argument was read without removing the slashes WordPress adds to every request value, so the name never matched the row it came from. * FIXED: Undefined index warning reading the post-password cookie. * FIXED: The widget’s “Statistics To Display” label used the wrong text domain and could not be translated. * FIXED: The widget’s spam line read “Spam Blockeds” in the plural. * NOTE: A comment attribution was “Posted By” glued to the author and “On” glued to the date, and a link title was “Posted On” glued to a date. Each is one string with placeholders now, so a translation decides the word order. Those msgids changed, so existing translations of them fall back to English until they are retranslated ## اطلاعات * نگارش **3.0.0** * آخرین به‌روزرسانی **18 ساعت پیش** * نصب‌های فعال **2,000+** * نگارش وردپرس ** 6.8 یا بالاتر ** * آزمایش‌شده تا **7.0.3** * نگارش PHP ** 8.2 یا بالاتر ** * زبان‌ها * [English (Australia)](https://en-au.wordpress.org/plugins/wp-stats/)، [English (Canada)](https://en-ca.wordpress.org/plugins/wp-stats/)، [English (New Zealand)](https://en-nz.wordpress.org/plugins/wp-stats/)، [English (South Africa)](https://en-za.wordpress.org/plugins/wp-stats/)، [English (UK)](https://en-gb.wordpress.org/plugins/wp-stats/)، و [English (US)](https://wordpress.org/plugins/wp-stats/). * [به زبان خودتان ترجمه کنید](https://translate.wordpress.org/projects/wp-plugins/wp-stats) * برچسب * [information](https://fa.wordpress.org/plugins/tags/information/)[popular](https://fa.wordpress.org/plugins/tags/popular/) [statistics](https://fa.wordpress.org/plugins/tags/statistics/)[stats](https://fa.wordpress.org/plugins/tags/stats/) [widget](https://fa.wordpress.org/plugins/tags/widget/) * [نمایش پیشرفته](https://fa.wordpress.org/plugins/wp-stats/advanced/) ## امتیازها 2.6 از 5 ستاره. * [ امتیاز 2 5-ستاره ](https://wordpress.org/support/plugin/wp-stats/reviews/?filter=5) * [ امتیاز 1 4-ستاره ](https://wordpress.org/support/plugin/wp-stats/reviews/?filter=4) * [ امتیاز 0 3-ستاره ](https://wordpress.org/support/plugin/wp-stats/reviews/?filter=3) * [ امتیاز 0 2-ستاره ](https://wordpress.org/support/plugin/wp-stats/reviews/?filter=2) * [ امتیاز 4 1-ستاره ](https://wordpress.org/support/plugin/wp-stats/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/wp-stats/reviews/#new-post) [مشاهده همه بررسی‌ها](https://wordpress.org/support/plugin/wp-stats/reviews/) ## مشارکت کنندگان * [ Lester Chan ](https://profiles.wordpress.org/gamerz/) ## پشتیبانی چیزی برای گفتن دارید؟ نیاز به کمک دارید؟ [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/wp-stats/) ## کمک مالی آیا تمایل دارید از پیشرفت این افزونه حمایت کنید؟ [ کمک مالی به این افزونه ](https://lesterchan.net/site/donation/)