PHPackages                             heimrichhannot/contao-news-pagination-bundle - 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. [Utility & Helpers](/categories/utility)
4. /
5. heimrichhannot/contao-news-pagination-bundle

ActiveContao-bundle[Utility & Helpers](/categories/utility)

heimrichhannot/contao-news-pagination-bundle
============================================

Automatic or manual content pagination for news or other content in contao.

2.6.1(2y ago)17552[1 issues](https://github.com/heimrichhannot/contao-news-pagination-bundle/issues)LGPL-3.0-or-laterPHPPHP ^8.1

Since Oct 13Pushed 2y ago5 watchersCompare

[ Source](https://github.com/heimrichhannot/contao-news-pagination-bundle)[ Packagist](https://packagist.org/packages/heimrichhannot/contao-news-pagination-bundle)[ RSS](/packages/heimrichhannot-contao-news-pagination-bundle/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (10)Dependencies (5)Versions (38)Used By (0)

News Pagination
===============

[](#news-pagination)

This bundle offers automatic content pagination for the core news reader module and the [heimrichhannot/contao-reader-bundle](https://github.com/heimrichhannot/contao-reader-bundle).

Features
--------

[](#features)

- add a pagination for navigating between the news parts
- automatic splitting
    - split news articles by an adjustable character amount respecting html tags
- manual splitting
    - split news content by wrapping the content elements in special start and stop content elements
- optional support for [hofff/contao-content-navigation](https://github.com/hofff/contao-content-navigation)

Usage
-----

[](#usage)

### Setup

[](#setup)

1. Install with composer or contao manager

    ```
     composer require heimrichhannot/contao-news-pagination-bundle

    ```
2. Update database
3. You'll find new configuration options in the news reader frontend module or your reader configuration
4. Add `` to your details template (e.g. "news\_full") to output the pagination navigation

### Known limitations for automatic pagination

[](#known-limitations-for-automatic-pagination)

- currently only ce\_text not nested in another content element (like an accordion) is supported for splitting, other elements are removed properly according to current page number though (completely)

Developers
----------

[](#developers)

### PaginationUtil

[](#paginationutil)

The script to do the automatic pagination can be used by developers by using the `PaginationUtil`.

Example:

```
use HeimrichHannot\NewsPaginationBundle\Util\PaginationUtil;
use Wa72\HtmlPageDom\HtmlPageCrawler;

class ParseArticlesListener {
    /** @var PaginationUtil */
    protected $paginationUtil;

    public function __invoke(FrontendTemplate $template, array $newsEntry, Module $module) {
        $result = $this->paginationUtil->paginateHtmlText($template->text, 500, 1, [
                'selector' => '.ce_text_custom div.text',
                'removePageElementsCallback' => function (array $result, int $currentPage, int $page) {
                    // Always show page 1
                    if (1 === $page) {
                        return false;
                    }
                    // Insert custom html after page 3
                    if (3 === $page) {
                        $someCustomInsertion = new HtmlPageCrawler('Custom Notice!');
                        $someCustomInsertion->insertAfter(end($result[$page])['element']);
                    }
                    // Remove all element not on the current page (default)
                    return $page != $currentPage;
                }
            ]);
    }
}
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity84

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

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 ~68 days

Recently: every ~109 days

Total

36

Last Release

747d ago

Major Versions

1.0.6 → 2.0.02018-03-06

PHP version history (4 changes)1.0.0PHP >=5.6.0

2.4.0PHP ^7.1

2.5.3PHP ^7.1 || ^8.0

2.6.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/28ad3224d8727b622ebd229840eea6b9dbcb83eb0bd609e6ce65b614830ff538?d=identicon)[digitales@heimrich-hannot.de](/maintainers/digitales@heimrich-hannot.de)

---

Top Contributors

[![koertho](https://avatars.githubusercontent.com/u/12064642?v=4)](https://github.com/koertho "koertho (18 commits)")[![cliffparnitzky](https://avatars.githubusercontent.com/u/1247552?v=4)](https://github.com/cliffparnitzky "cliffparnitzky (1 commits)")[![fatcrobat](https://avatars.githubusercontent.com/u/480054?v=4)](https://github.com/fatcrobat "fatcrobat (1 commits)")[![Paddy0174](https://avatars.githubusercontent.com/u/1948551?v=4)](https://github.com/Paddy0174 "Paddy0174 (1 commits)")

---

Tags

contaonews

### Embed Badge

![Health badge](/badges/heimrichhannot-contao-news-pagination-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/heimrichhannot-contao-news-pagination-bundle/health.svg)](https://phpackages.com/packages/heimrichhannot-contao-news-pagination-bundle)
```

###  Alternatives

[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3183.3k6](/packages/codefog-contao-news-categories)[inspiredminds/contao-wowjs

Integrates WOW.js for Contao content elements and form fields.

1813.0k](/packages/inspiredminds-contao-wowjs)[numero2/contao-storelocator

Contao Plugin for managing stores (or in common address data) and providing a frontend-search based on geo data

121.5k](/packages/numero2-contao-storelocator)

PHPackages © 2026

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