PHPackages madj2k/t3-fe-register - 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. [Authentication & Authorization](/categories/authentication) 4. / 5. madj2k/t3-fe-register ActiveTypo3-cms-extension[Authentication & Authorization](/categories/authentication) madj2k/t3-fe-register ===================== Extension for registration of FE-Users and FE-Usergroups v10.4.14-stable(1mo ago)020712GPL-2.0+PHPPHP >=7.4 Since Mar 1Pushed 1mo ago2 watchersCompare [ Source](https://github.com/skroggel/typo3-fe-register)[ Packagist](https://packagist.org/packages/madj2k/t3-fe-register)[ Docs](https://www.steffenkroggel.de)[ RSS](/packages/madj2k-t3-fe-register/feed)WikiDiscussions master Synced today READMEChangelogDependencies (10)Versions (68)Used By (12) fe\_register ============ [](#fe_register) Features ======== [](#features) - Registration-Process with Double-Opt-In - Login for normal users - Login as guest via link - Self-sign-up to defined usergroups, including approval by admin - Extensive Consent-Management for GDPR - Encryption and anonymization of deleted records (GDPR) - Automatic cleanup of deleted records (GDPR) - Easy to integrate into your own extensions Usage in your own extension =========================== [](#usage-in-your-own-extension) Opt-In ------ [](#opt-in) ### 1. Generate Opt-In in your controller [](#1-generate-opt-in-in-your-controller) For a registration with opt-in simple use the example-code below in your controller. Please ensure to always load FrontendUserRegistration via ObjectManager Explanation: - setData: set the object you want to create after successful opt-in only. In case of a shop this may be an order - setParentData: refers to the parent object of the opt-in-object. This is relevant for the documentation of the consents given by the user. In case of a shop this may be the product that is part of the order. - setCategory: this way you can use your own SignalSlots in your extension that interact with the opt-in process - setRequest: simply the current Request-option. This is relevant for the documentation of the consents given by the user. ``` /** @var \Madj2k\FeRegister\Domain\Model\FrontendUser $frontendUser */ $frontendUser = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(FrontendUser::class); $frontendUser->setEmail($email); /** @var \Madj2k\FeRegister\Registration\FrontendUserRegistration $registration */ $objectManager = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(ObjectManager::class); $registration = $objectManager->get(FrontendUserRegistration::class); $registration->setFrontendUser($frontendUser) ->setData($alert) ->setDataParent($project) // optional, but nice to have ->setCategory('YourCategory') ->setRequest($request) ->startRegistration(); ``` If you want to be able to update the data of the frontendUser after the successful opt-in you can use the method **setFrontendUserUpdate**. This will update the frontendUser-object as soon as the user accepts the opt-in. This way you can be sure that changes to the frontendUser-object only happen if authorized. ### 2. Define MailService for Opt-In-Mail [](#2-define-mailservice-for-opt-in-mail) No you need a MailService class with a defined action for Opt-Ins ``` /** * Handles opt-in event * * @param \Madj2k\FeRegister\Domain\Model\FrontendUser $frontendUser * @param \Madj2k\FeRegister\Domain\Model\OptIn $optIn * @return void * @throws \Madj2k\Postmaster\Exception * @throws \TYPO3\CMS\Extbase\Persistence\Exception\UnknownObjectException * @throws \TYPO3\CMS\Extbase\Persistence\Exception\IllegalObjectTypeException * @throws \TYPO3Fluid\Fluid\View\Exception\InvalidTemplateResourceException * @throws \TYPO3\CMS\Extbase\Configuration\Exception\InvalidConfigurationTypeException */ public function optIn ( \Madj2k\FeRegister\Domain\Model\FrontendUser $frontendUser, \Madj2k\FeRegister\Domain\Model\OptIn $optIn ): void { // get settings $settings = $this->getSettings(ConfigurationManagerInterface::CONFIGURATION_TYPE_FRAMEWORK); $settingsDefault = $this->getSettings(); if ($settings['view']['templateRootPaths']) { /** @var \Madj2k\Postmaster\Mail\MailMessage $mailService */ $mailService = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(MailMessage::class); // send new user an email with token $mailService->setTo($frontendUser, array( 'marker' => array( 'frontendUser' => $frontendUser, 'optIn' => $optIn, 'pageUid' => intval($GLOBALS['TSFE']->id), 'loginPid' => intval($settingsDefault['loginPid']), ), )); $mailService->getQueueMail()->setSubject( FrontendLocalizationUtility::translate( 'mailService.optInAlertUser.subject', 'your_extension', null, $frontendUser->getTxFeregisterLanguageKey() ) ); $mailService->getQueueMail()->addTemplatePaths($settings['view']['templateRootPaths']); $mailService->getQueueMail()->addPartialPaths($settings['view']['partialRootPaths']); $mailService->getQueueMail()->setPlaintextTemplate('Email/OptInAlertUser'); $mailService->getQueueMail()->setHtmlTemplate('Email/OptInAlertUser'); $mailService->send(); } } ``` ### 3. Set Signal-Slot [](#3-set-signal-slot) Now we need a signal-slot that refers to the defined method for sending mails (ext\_localconf.php) ``` /** * @var \TYPO3\CMS\Extbase\SignalSlot\Dispatcher $signalSlotDispatcher */ $signalSlotDispatcher = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(TYPO3\CMS\Extbase\SignalSlot\Dispatcher::class); $signalSlotDispatcher->connect( Madj2k\FeRegister\Registration\AbstractRegistration::class, Madj2k\FeRegister\Registration\AbstractRegistration::SIGNAL_AFTER_CREATING_OPTIN . 'YourCategory', Your\Extension\Service\MailService::class, 'optInAlertUser' ); ``` ### 4. Set Template for Opt-In-Mail [](#4-set-template-for-opt-in-mail) The opt-in-email may look like this: ``` :\n \n\n :\n ``` ### 5. Check Opt-In [](#5-check-opt-in) To check the opt-in you can use the following example-code in your contoller: ``` public function optInAction(string $tokenUser, string $token): void { /** @var \Madj2k\FeRegister\Registration\FrontendUserRegistration $registration */ $registration = $this->objectManager->get(FrontendUserRegistration::class); $result = $registration->setFrontendUserToken($tokenUser) ->setCategory('yourExtension') ->setRequest($this->request) ->validateOptIn($token); if ($result >= 200 && $result < 300) { // sucessfull } elseif ($result >= 300 && $result < 400) { // canceled } else { // error / not found } } ``` ### 6. Signal-Slot for extension specific action after opt-in [](#6-signal-slot-for-extension-specific-action-after-opt-in) We need a second signal-slot in order to do whatever we need to do after the opt-in ``` $signalSlotDispatcher->connect( Madj2k\FeRegister\Registration\AbstractRegistration::class, Madj2k\FeRegister\Registration\AbstractRegistration::SIGNAL_AFTER_REGISTRATION_COMPLETED . 'YourExtension', Your\Extension\Alerts\AlertManager::class', 'saveAlertByRegistration' ); ``` ### 7. Method for the specific action [](#7-method-for-the-specific-action) Then we need to define the corresponding method: ``` /** * Save alert by registration * Used by SignalSlot * * @param \Madj2k\FeRegister\Domain\Model\FrontendUser $frontendUser * @param \Madj2k\FeRegister\Domain\Model\OptIn $optIn * @return void * @api Used by SignalSlot */ public function saveAlertByRegistration( \Madj2k\FeRegister\Domain\Model\FrontendUser $frontendUser, \Madj2k\FeRegister\Domain\Model\OptIn $optIn ) { if ( ($alert = $optIn->getData()) && ($alert instanceof \Your\Extension\Domain\Model\Alert) ) { try { // create alert here } catch (\Your\Extension\Exception $exception) { // do nothing here } } } ``` Another use-cases ----------------- [](#another-use-cases) - You can also: \*\* Send a confirmation-email after the opt-in was successful (Using SIGNAL\_AFTER\_ALERT\_CREATED-Signal-Slot) \*\* Delete all extension-specific data if the frontendUser is deleted (Using SIGNAL\_AFTER\_REGISTRATION\_ENDED-Signal-Slot) \*\* ... do many other fancy stuff ;-) Consent (Privacy, Terms, Marketing) =================================== [](#consent-privacy-terms-marketing) The extension has a ViewHelper and validators to obtain consent to privacy, terms of use and advanced marketing. In order to obtain the consents, only the corresponding ViewHelper must be used in the own extension. As soon as an opt-in is carried out, the corresponding consents are automatically documented and stored in the database. The consents granted are recorded accordingly with the associated data (IP address, browser, etc.). In addition, the consent to the terms of use and to marketing is stored in the FrontendUser, as these consents are usually page-wide and independent of the respective context of the consent. 1. In Fluid ----------- [](#1-in-fluid) The following code can be used to obtain the appropriate consent. It is important that the ViewHelper is used within a form and that the FormErrors are also returned via Fluid. ``` [...] [...] ``` You can also use a dummy, if you have no real object to send ``` [...] [...] ``` 2. In the controller -------------------- [](#2-in-the-controller) Only the corresponding validators are included here. They always refer to the form object. ``` /** * action create * * @param \Your\Extension\Domain\Model\Alert $alert * @param string $email * @return void * @throws \TYPO3\CMS\Extbase\Mvc\Exception\StopActionException * @throws \TYPO3\CMS\Extbase\Mvc\Exception\UnsupportedRequestTypeException * @TYPO3\CMS\Extbase\Annotation\Validate("Madj2k\FeRegister\Validation\Consent\TermsValidator", param="alert") * @TYPO3\CMS\Extbase\Annotation\Validate("Madj2k\FeRegister\Validation\Consent\PrivacyValidator", param="alert") * @TYPO3\CMS\Extbase\Annotation\Validate("Madj2k\FeRegister\Validation\Consent\MarketingValidator", param="alert") */ public function createAction( \Your\Extension\Domain\Model\Alert $alert, string $email = '' ): void { [...] } /** * A template method for displaying custom error flash messages, or to * display no flash message at all on errors. Override this to customize * the flash message in your action controller. * * @return string|false The flash message or FALSE if no flash message should be set */ protected function getErrorFlashMessage() { return false; } ``` Or when using a dummy: ``` /** * action create * * @param bool dummy * @return void * @throws \TYPO3\CMS\Extbase\Mvc\Exception\StopActionException * @throws \TYPO3\CMS\Extbase\Mvc\Exception\UnsupportedRequestTypeException * @TYPO3\CMS\Extbase\Annotation\Validate("Madj2k\FeRegister\Validation\Consent\TermsValidator", param="dummy") * @TYPO3\CMS\Extbase\Annotation\Validate("Madj2k\FeRegister\Validation\Consent\PrivacyValidator", param="dummy") * @TYPO3\CMS\Extbase\Annotation\Validate("Madj2k\FeRegister\Validation\Consent\MarketingValidator", param="dummy") */ public function createAction( array $dummy ): void { [...] } /** * A template method for displaying custom error flash messages, or to * display no flash message at all on errors. Override this to customize * the flash message in your action controller. * * @return string|false The flash message or FALSE if no flash message should be set */ protected function getErrorFlashMessage() { return false; } ``` An opt-in procedure is usually not carried out for logged-in frontend users. If you still want to record the time of consent for a registration, you can achieve this with the following code: ``` \Madj2k\FeRegister\DataProtection\ConsentHandler::add( $request, $frontendUser, $alert, 'new alert' ); ``` When migrating from rkw\_registration to fe\_register ----------------------------------------------------- [](#when-migrating-from-rkw_registration-to-fe_register) Execute the following MySQL-queries BEFORE install! ``` RENAME TABLE `tx_rkwregistation_domain_model_privacy` TO `tx_feregister_domain_model_consent`; RENAME TABLE `tx_rkwregistration_domain_model_encrypteddata` TO `tx_feregister_domain_model_encrypteddata`; RENAME TABLE `tx_rkwregistration_domain_model_shippingaddress` TO `tx_feregister_domain_model_shippingaddress`; RENAME TABLE `tx_rkwregistration_domain_model_title` TO `tx_feregister_domain_model_title`; ``` Execute the following MySQL-queries AFTER install! ``` UPDATE fe_users SET tx_feregister_title = tx_rkwregistration_title; UPDATE fe_users SET tx_feregister_gender = tx_rkwregistration_gender; UPDATE fe_users SET tx_feregister_mobile = tx_rkwregistration_mobile; UPDATE fe_users SET tx_feregister_twitter_url = tx_rkwregistration_twitter_url; UPDATE fe_users SET tx_feregister_facebook_url = tx_rkwregistration_facebook_url; UPDATE fe_users SET tx_feregister_xing_url = tx_rkwregistration_xing_url; UPDATE fe_users SET tx_feregister_register_remote_ip = tx_rkwregistration_register_remote_ip; UPDATE fe_users SET tx_feregister_language_key = tx_rkwregistration_language_key; UPDATE fe_users SET tx_feregister_login_error_count = tx_rkwregistration_login_error_count; UPDATE fe_users SET tx_feregister_data_protection_status = tx_rkwregistration_data_protection_status; UPDATE fe_users INNER JOIN tx_feregister_domain_model_consent ON fe_users.uid = tx_feregister_domain_model_consent.frontend_user AND tx_feregister_domain_model_consent.parent = 0 SET fe_users.tx_feregister_consent_privacy = 1, fe_users.tx_feregister_consent_terms = 1; UPDATE tx_feregister_domain_model_consent SET consent_privacy = 1, consent_terms = 1 WHERE parent = 0; UPDATE tt_content SET list_type = 'feregister_auth' WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Registration->loginShow;%'; UPDATE tt_content SET list_type = 'feregister_auth' WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Registration->registerShow;%'; UPDATE tt_content SET list_type = 'feregister_welcome' WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Registration->welcome;%'; UPDATE tt_content SET list_type = 'feregister_useredit' WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Registration->editUser;%'; UPDATE tt_content SET list_type = 'feregister_userdelete'WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Registration->deleteUserShow;%'; UPDATE tt_content SET list_type = 'feregister_password' WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Registration->editPassword;%'; UPDATE tt_content SET list_type = 'feregister_group' WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Service->list;%'; UPDATE tt_content SET list_type = 'feregister_auth' WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Service->optIn;%'; UPDATE tt_content SET list_type = 'feregister_logout' WHERE list_type = 'rkwregistration_rkwregistration' AND pi_flexform LIKE '%Registration->logout;%'; UPDATE tt_content SET pi_flexform = '' WHERE list_type LIKE 'feregister%'; ``` ### Health Score 48 ↑ FairBetter than 93% of packages Maintenance90 Actively maintained with recent releases Popularity13 Limited adoption so far Community21 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 72.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 ~19 days Recently: every ~107 days Total 63 Last Release 51d ago Major Versions v9.5.1005-stable → v10.4.1-stable2024-04-22 v9.5.1007-stable → v10.4.2-stable2024-05-07 v9.5.1009-stable → v10.4.4-stable2024-05-16 v9.5.1012-stable → v10.4.6-stable2024-05-21 v9.5.1015-stable → v10.4.8-stable2024-10-07 ### Community Maintainers ![](https://www.gravatar.com/avatar/ca11ace9490b8fe0b145e7d32464fba5c8eddaa88d700b95d32241a226623e76?d=identicon)[SteffenKroggel](/maintainers/SteffenKroggel) --- Top Contributors [![skroggel](https://avatars.githubusercontent.com/u/8121847?v=4)](https://github.com/skroggel "skroggel (112 commits)")[![addorange](https://avatars.githubusercontent.com/u/1980618?v=4)](https://github.com/addorange "addorange (23 commits)")[![MaxFaessler](https://avatars.githubusercontent.com/u/45080955?v=4)](https://github.com/MaxFaessler "MaxFaessler (19 commits)") --- Tags loginregistrationTYPO3 CMSregisteruser-groupsFrontend Users ### Embed Badge ![Health badge](/badges/madj2k-t3-fe-register/health.svg) ``` [![Health](https://phpackages.com/badges/madj2k-t3-fe-register/health.svg)](https://phpackages.com/packages/madj2k-t3-fe-register) ``` ### Alternatives [in2code/femanager Modern TYPO3 Frontend User Registration. 53790.4k8](/packages/in2code-femanager)[mfc/oauth2 Generic OAuth2 authentication and authorization for TYPO3 CMS 11310.1k2](/packages/mfc-oauth2)[sandstorm/usermanagement Neos and Flow package for user management, login/logout, password reset and user activation 3928.9k](/packages/sandstorm-usermanagement)[evoweb/sf-register Frontend User Registration 14190.5k2](/packages/evoweb-sf-register)[ibonly/laravel-accountkit Two factor authentication using facebook account kit 2816.6k](/packages/ibonly-laravel-accountkit)[derhansen/sf_yubikey YubiKey two-factor OTP authentication - An authentication service for TYPO3 which extends the backend/frontend login by YubiKey OTP two-factor authentication. 1233.2k](/packages/derhansen-sf-yubikey) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)