Femanager Mail Subscription

Extension key: femanager_mail_subscribe
Package name: mediaessenz/femanager-mail-subscribe
Version: main
Language: en
Author: Alexander Grein
License: This document is published under the Open Publication License.
Rendered: Thu, 26 Feb 2026 17:31:08 +0000

This extension add mail subscription fields to femanager

Quick start

A quick introduction in how to use this extension.

Introduction

Introduction to the femanager_mail_subscribe extension, dependencies, general information.

TypoScript settings

TypoScript reference of this extension.

Introduction

This chapter gives you a basic introduction about the TYPO3 CMS extension "mail".

What does it do?

Femanager-mail-subscribe is an extension for TYPO3 CMS to add mail subscription fields to femanager extension.

The following fields will be available in the femanager plugin:

Newsletter subscription (Fluid: mailActive)
HTML newsletter (Fluid: mailHtml)
Newsletter categories (Fluid: categories)

New and existing users will be able to subscribe to a mail newsletter and select mail categories if enabled.

Dependencies

Femanager-mail-subscribe requires the following packages, which all can be found at packagist.org or in the TYPO3 TER:

in2code/femanager (https://github.com/in2code-de/femanager)
mediaessenz/mail (https://gitlab.com/mediaessenz/mail)

Sponsoring

This extension and the manual took some hours to create. If this extension helps you in any way to meet your business needs, please consider to give something back.

Here are two ways to balance energy:

Patreon

Support me on patreon.com

PayPal

Support me on paypal.com.

It's just one click away!

TypoScript Constants

templateRootPath

type: string
Default: EXT:femanager_mail_subscribe/Resources/Private/Templates/
Path: plugin.tx_femanagermailsubscribe.view.templateRootPath

Path to template root for femanager_mail_subscribe

partialRootPath

type: string
Default: EXT:femanager_mail_subscribe/Resources/Private/Partials/
Path: plugin.tx_femanagermailsubscribe.view.partialRootPath

Path to partial root for femanager_mail_subscribe

layoutRootPath

type: string
Default: EXT:femanager_mail_subscribe/Resources/Private/Layouts/
Path: plugin.tx_femanagermailsubscribe.view.layoutRootPath

Path to layout root for femanager_mail_subscribe

categories

type: string
Default
Path: plugin.tx_femanagermailsubscribe.settings.categories

Restrict the selectable categories by a comma separated list of its uids

categoryRoots

type: string
Default
Path: plugin.tx_femanagermailsubscribe.settings.categoryRoots

Restrict the selectable categories by a comma separated list of its parent category uids

TypoScript Setup

Change language labels

If you want to add translated language labels, simply add the following TypoScript setup to your TypoScript template (example in german below)

plugin.tx_femanagermailsubscribe {
  _LOCAL_LANG.de {
    label.mailActive = Für Newsletter anmelden
    label.mailHtml = HTML E-Mails empfangen?
    label.categories = Newsletter Kategorien
  }
}

Sitemap

Index

Configuration

To add the subscription fields to femanager, a corresponding TypoScript is provided by this extension.

Goto module Web > Template and chose the same page where you have included the TypoScript of femanager.

Switch to tab Includes and add (after the femanager template) the following template from the list to the right:

femanager mail subscription (femanager_mail_subscribe)

If you want to add your own fluid partials for the subscription field, you can change the corresponding TypoScript constant (plugin.tx_femanagermailsubscribe.view.partialRootPath) or just add your own TypoScript path to the plugin.tx_femanager.view.partialRootPaths array.

Read more about possible configurations via TypoScript in the Reference section.

Quick start

Installation
Configuration

Installation

To add this extension to your existing TYPO3 system, you have tree options:

Composer installation (recommended)

composer require mediaessenz/femanager-mail-subscribe

Extension manager

Open "Admin and maintenance tools" > "TYPO3 extension manager" and search for "femanager_mail_subscribe". Install it by clicking on the install button.
Download

Download it from here: https://extensions.typo3.org/extension/femanager_mail_subscribe and use the extension manager to upload and install it.

Clear all caches

Clearing all caches after installing a new extension is always a good idea.

Since this extension x-classes the TYPO3CMSExtbaseMvcControllerArgument class and also extends some femanager classes (NewController, EditController, User-Model) it is also necessary to clear the cache inside the install tool!