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)17632[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 today

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 72% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity18

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

798d 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-haste

haste extension for Contao Open Source CMS

41668.4k162](/packages/codefog-contao-haste)[metamodels/core

MetaModels core

9956.1k68](/packages/metamodels-core)[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3187.0k6](/packages/codefog-contao-news-categories)[terminal42/contao-node

Node bundle for Contao Open Source CMS

3075.6k5](/packages/terminal42-contao-node)[terminal42/contao-url-rewrite

URL Rewrite bundle for Contao Open Source CMS

15100.0k3](/packages/terminal42-contao-url-rewrite)[heimrichhannot/contao-encore-bundle

This bundle brings deep integration for symfony encore into contao. On the one hand, your can prepare your bundles to define own webpack entries, which added with just one command to your webpack entries. On the other hand, this bundle allows you to add encore entries only on the pages you need them for optimizing your website performance.

1016.3k](/packages/heimrichhannot-contao-encore-bundle)

PHPackages © 2026

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