WP Manifestindependent plugin directory
manifest / analytics / metrika-popular

Metrika Popular

WordPress plugin: most read posts by Yandex.Metrika page views — shortcode & widget, per category. Популярные записи по данным Яндекс.Метрики.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/jekfev/metrika-popular/archive/refs/heads/claude%2Fhappy-newton-m3e5yo.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

English · Русский

"Most read" posts for WordPress based on Yandex.Metrika page views — site-wide, or inside the category of the post being read. No own view counter, no extra writes to your database: page views come from the Metrika Stat API, refreshed by WP-Cron twice a day.

Features

  • [metrika_popular] shortcode and a classic widget.
  • Automatic scope: on a single post it shows the most read posts of its category (current post excluded); elsewhere — the whole site.
  • Fallback: if Metrika data does not fill the list, it is topped up by a meta view-counter field (optional), then by the newest posts.
  • Works with any permalink structure; a filter lets you map legacy URLs to posts.
  • Caches rendered blocks; settings page with status and "Refresh now".
  • Translations: English (source), Russian.

Install

  1. Copy the metrika-popular folder to wp-content/plugins/ and activate it.
  2. Settings → Metrika Popular: enter the counter ID and an OAuth token with the metrika:read permission (how to get a token).
  3. Press Refresh now, then put the block anywhere:
[metrika_popular]                                   auto scope, 5 posts
[metrika_popular n="3" thumbs="1"]
[metrika_popular scope="site" title="Top of the week"]
[metrika_popular scope="category" cat="sport" n="5"]   cat — slug or ID

Hooks

Filter Purpose
mpop_path_to_post_id( $id, $path ) Map a Metrika URL path to a post ID (return null to use url_to_postid).
mpop_current_category( $term_id, $post_id ) Pick which category of a post is used by the auto scope.
mpop_ids( $ids, $n, $cat, $exclude ) Final list of post IDs.

Example — sites whose URLs are not derived from the post slug (legacy URL tables):

add_filter('mpop_path_to_post_id', function ($id, $path) {
    global $wpdb;
    $row = $wpdb->get_var($wpdb->prepare("SELECT obj_id FROM {$wpdb->prefix}my_urls WHERE path = %s", $path));
    return $row ? (int) $row : $id;
}, 10, 2);

Markup: section.mpop > h3.mpop__title + ol.mpop__list > li.mpop__item > a. Switch off the built-in CSS in settings to style it yourself.

Notes

  • The token is stored in the mpop_options option (like any plugin setting). Use a read-only token.
  • Matching Metrika paths to posts runs only in the background job (url_to_postid for up to limit paths).

License: GPL-2.0-or-later.


Русский

«Самые читаемые» на основе просмотров из Яндекс.Метрики — по всему сайту или в рубрике читаемой статьи. Свой счётчик просмотров не нужен, база лишний раз не пишется: просмотры берутся из API Метрики, обновление — WP-Cron два раза в сутки.

Установка: папку metrika-popular в wp-content/plugins/, активировать; Настройки → Metrika Popular: номер счётчика и OAuth-токен с правом metrika:read; «Обновить сейчас»; вставить шорткод [metrika_popular] (например, в виджет «Текст») или добавить виджет «Самые читаемые (Метрика)».

Параметры шорткода: n — сколько (1–20), title — заголовок, scope — auto (на статье — её рубрика, иначе весь сайт), site, category (+ cat — слаг или ID), thumbs="1" — с миниатюрами.

Если адреса сайта отличаются от адресов в Метрике (старые ЧПУ), подставьте свою карту фильтром mpop_path_to_post_id.