PHPackages                             heimrichhannot/contao-newsalert - 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. heimrichhannot/contao-newsalert

ActiveContao-module

heimrichhannot/contao-newsalert
===============================

A contao module to subscribe to news topics

0.6.3(6y ago)090LGPL-3.0-or-laterPHPPHP ~7.0

Since Feb 27Pushed 6y ago5 watchersCompare

[ Source](https://github.com/heimrichhannot/contao-newsalert)[ Packagist](https://packagist.org/packages/heimrichhannot/contao-newsalert)[ Docs](https://github.com/heimrichhannot/contao-newsalert)[ RSS](/packages/heimrichhannot-contao-newsalert/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (16)Used By (0)

Contao Newsalert Module
=======================

[](#contao-newsalert-module)

[![Latest Stable Version](https://camo.githubusercontent.com/ff1c9d6e9cd85749b08b4b4cc86e85bd08c72d8c93f210fd38b4bab1966324b0/68747470733a2f2f706f7365722e707567782e6f72672f6865696d7269636868616e6e6f742f636f6e74616f2d6e657773616c6572742f762f737461626c65)](https://packagist.org/packages/heimrichhannot/contao-newsalert)[![Total Downloads](https://camo.githubusercontent.com/7ee6eeb696751f00b0a6d959c4020869a6003a16eb290b92ebd4f85b9a3af0d9/68747470733a2f2f706f7365722e707567782e6f72672f6865696d7269636868616e6e6f742f636f6e74616f2d6e657773616c6572742f646f776e6c6f616473)](https://packagist.org/packages/heimrichhannot/contao-newsalert)

> Contao 3 backport from [Contao Newsalert Bundle](https://github.com/heimrichhannot/contao-newsalert-bundle)

A contao module, to let website visitor subscribe to a news topic.

The module comes with an interface to add custom news topic, for example categories, tags, authors.

Features
--------

[](#features)

- subscribe form module
- add custom topic sources
- send notifications to user subscribed to topics with notification center
- use contao cron to trigger send
- security features
    - captcha in form field
    - opt-in process after subscribe
    - token secured opt-out links
- dublicate entry check
    - when dublicate entry is not confirmed, resend activation link instead of showing error message
- archive informations about sent messages
- bundled topic source for news archives

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

[](#requirements)

- Contao 3.5
- PHP &gt;= 7.0
- [Contao Notification Center](https://github.com/terminal42/contao-notification_center)
- [Formhybrid](https://github.com/heimrichhannot/contao-formhybrid)

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

[](#installation)

Install via composer

```
composer require heimrichhannot/contao-newsalert

```

Afterwards call the Contao install procedure to update the database.

Setup
-----

[](#setup)

- add topic sources
- set up notification center notifications
    - `hh_newsalert` for newsalert messages
    - `formhybrid-opt-in` for opt-in mails
- add frontend registration module and configure it
- activate newsalert in news archive you want newsalert for

### Cronjob

[](#cronjob)

For performance reasons, we insist on disabling the "Command-Scheduler" in Settings (enable `tl_settings.disableCron`) and run the cron jobs by a dedicated cronjob within your servers crontab.

Contao 3:

```
* * * * * wget -O /dev/null -q https://[DOMAIN-NAME]/system/cron/cron.php --no-check-certificate

```

Usage
-----

[](#usage)

The module adds a checkbox to news archive to activate (or deactivate) newsalert for archives. It also add a checkbox to the news articles form to set (or unset) an article sent (by setting unsent newsalert will be triggered again for said article).

The overview about sent messages is placed within the news archive section (News -&gt; Newsalert). The management of the receivers is found withing the newsalert section (News -&gt; Newsalert -&gt; Newsalert receivers)

Developers
----------

[](#developers)

### Add topic source

[](#add-topic-source)

To add a topic source, your topics class needs to implement the `NewsTopicInterface` and has to be registered within `$GLOBALS['HUH_NEWSALERT']['TOPIC_SOURCE']`.

Example:

```
$GLOBALS['HUH_NEWSALERT']['TOPIC_SOURCE']['newsarchives'] = \HeimrichHannot\ContaoNewsAlertBundle\Components\NewsArchiveTopics::class;

```

### Notification center tokens

[](#notification-center-tokens)

ContaoNewsalert uses Notification Center for e-mail sending. Following tokens are added to `news_posted` type (in addition to the default ones):

TagDescription\##huh\_newsalert\_topic\_recipient##Emailaddress of the subscriber\##huh\_newsalert\_news\_headline##Title of the news for which newsalert is triggered\##huh\_newsalert\_news\_subheadline##SUbheadline of the news for which newsalert is triggered\##huh\_newsalert\_news\_teaser##Teaser text of the news article\##huh\_newsalert\_news\_content##Article content\##huh\_newsalert\_news\_url##Relative url to the article\##huh\_newsalert\_recipient\_topics##The intersection of news topics and subscribed topics of the receiver\##huh\_newsalert\_recipient\_topic\_count##The the number of topics from ##hh\_newsalert\_recipient\_topics##\##huh\_newsalert\_opt\_out\_html##A list of all recipients topics and the corresponding unsubscribe links in html format (Topic: Link)\##huh\_newsalert\_opt\_out\_text##Same list as above, but textonly\##huh\_newsalert\_year##The current year\##huh\_newsalert\_root\_url##Root url### Hooks

[](#hooks)

NameArgumentsExpected return valueDescriptionhuh\_newsalert\_customTokenNewsModel $objArticle, array $arrTokens, DC\_Table $dc$arrTokensHook to add custom tokens or manipulate existing ones. Don't forget to register them via your config.php file.### Frontend autocompletion

[](#frontend-autocompletion)

We recommend [Chosen](https://harvesthq.github.io/chosen/) to add a search field to the topic select element. It's already used by Contao in the backend.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~46 days

Recently: every ~159 days

Total

15

Last Release

2341d ago

### 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 (31 commits)")

### Embed Badge

![Health badge](/badges/heimrichhannot-contao-newsalert/health.svg)

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

###  Alternatives

[isotope/isotope-core

Isotope is the premier open source eCommerce solution for Contao Open Source CMS

13959.2k74](/packages/isotope-isotope-core)[markocupic/calendar-event-booking-bundle

Contao Calendar Event Booking Bundle

125.0k1](/packages/markocupic-calendar-event-booking-bundle)[tastaturberuf/anystores

Location management and geographic search

121.7k](/packages/tastaturberuf-anystores)

PHPackages © 2026

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