PHPackages                             outstand/query-loop-analytics - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. outstand/query-loop-analytics

ActiveWordpress-plugin

outstand/query-loop-analytics
=============================

1.1.1(today)12GPL-3.0-or-laterPHP ^8.2

Since Jul 7Compare

[ Source](https://github.com/pixelalbatross/outstand-query-loop-analytics)[ Packagist](https://packagist.org/packages/outstand/query-loop-analytics)[ GitHub Sponsors](https://github.com/s3rgiosan)[ Fund](https://ko-fi.com/s3rgiosan)[ RSS](/packages/outstand-query-loop-analytics/feed)WikiDiscussions Synced today

READMEChangelog (3)Dependencies (16)Versions (4)Used By (0)

Outstand Query Loop Analytics
=============================

[](#outstand-query-loop-analytics)

> Populates the Query Loop block with popular posts based on analytics data.

Connects to your analytics provider, retrieves the top posts by pageviews, resolves them to WordPress post IDs, and caches the results. Works with all existing Query Loop features — pagination, filtering, and custom templates.

Features
--------

[](#features)

Currently supports **Google Analytics 4**, connecting to the GA4 Data API over OAuth 2.0 to retrieve pageview data. See [docs/popular-posts.md](docs/popular-posts.md) for the full feature guide.

Installation
------------

[](#installation)

### Manual Installation

[](#manual-installation)

1. Download the latest release ZIP from the [Releases page](https://github.com/pixelalbatross/outstand-query-loop-analytics/releases/latest).
2. Go to Plugins > Add New > Upload Plugin in your WordPress admin area.
3. Upload the ZIP file and click Install Now.
4. Activate the plugin.

### Install with Composer

[](#install-with-composer)

To include this plugin as a dependency in your Composer-managed WordPress project:

1. Add the plugin to your project using the following command:

```
composer require outstand/query-loop-analytics
```

2. Run `composer install`.
3. Activate the plugin from your WordPress admin area or using WP-CLI.

Quick start
-----------

[](#quick-start)

1. Go to **Settings > Query Loop Analytics** and connect your analytics provider ([setup guide](docs/popular-posts.md#supported-integrations)).
2. Select your analytics property.
3. In the block editor, insert the **Popular Posts** block (a Query Loop variation) from the inserter — or start from a **Popular Posts** pattern (*titles & dates* or *grid with excerpt*). Posts are ordered by pageviews automatically.

Requirements
------------

[](#requirements)

- WordPress 6.7 or higher
- PHP 8.2 or higher

### Tests

[](#tests)

JS tests run locally via Jest:

```
npm run test:js
```

PHP tests run inside a `wp-env` container:

```
npm run test:setup   # first time only — starts Docker WP + test DB
npm run test:unit
```

Changelog
---------

[](#changelog)

All notable changes to this project are documented in [CHANGELOG.md](https://github.com/pixelalbatross/outstand-query-loop-analytics/blob/main/CHANGELOG.md).

License
-------

[](#license)

This project is licensed under the [GPL-3.0-or-later](https://spdx.org/licenses/GPL-3.0-or-later.html).

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance99

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

3

Last Release

0d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/42eed63db46bd6dc4df88e37095ad4f8aeacfcc63f68e7e11c637eb9ec18a652?d=identicon)[s3rgiosan](/maintainers/s3rgiosan)

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/outstand-query-loop-analytics/health.svg)

```
[![Health](https://phpackages.com/badges/outstand-query-loop-analytics/health.svg)](https://phpackages.com/packages/outstand-query-loop-analytics)
```

###  Alternatives

[symfony/runtime

Enables decoupling PHP applications from global state

74798.8M1.1k](/packages/symfony-runtime)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5445.4M568](/packages/drupal-core-composer-scaffold)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)[drupal/core-project-message

Adds a message after Composer installation.

2124.7M205](/packages/drupal-core-project-message)[altis/core

Core module for Altis

19228.0k3](/packages/altis-core)[altis/local-server

Local Server module for Altis

18221.6k3](/packages/altis-local-server)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)