Adding new fields to fe_users with your own extension

Picture

|extendFields|

Add new Fields to the Registraion-/Editform

Basics

  • Use TSConfig to add one or more fields to the field selection in femanager flexform
  • Copy the partial folder and add your fields
  • Create a new extension with ext_tables.sql and ext_tables.php for adding one or more new fields to fe_users
  • Create your own user model with getter/setter for your new fields that extends the user model from femanager
  • Use TypoScript to include your model
  • Override the createAction and updateAction to manipulte the object type

See https://github.com/einpraegsam/femanagerextended for an example extension how to extend femanager with new fields and validation methods

Step by Step

Add new fields to the flexform

|newFields|

Extend Fieldselection in Flexform

Add some Page-TSConfig to extend the selection:

tx_femanager {
	flexForm {
			new {
					addFieldOptions {
							twitterId = Twitter ID
							skypeId = Skype ID
							somethingElse = LLL:EXT:ext/Resources/Private/Language/locallang_be.xlf:custom
					}
			}
			edit < tx_femanager.flexForm.new
	}
}
Copied!

Modify the partial folder

“twitterId” (see TSConfig) means that femanager searches for a partial TwitterId.html to render the field in the form. So you have to copy the folder EXT:femanager/Resources/Private/Partials (e.g.) to fileadmin/Partials and set the new partial path via TypoScript Constants (see exmple below). In addition you have to add the new Partials files.

plugin.tx_femanager.view.partialRootPath = fileadmin/Partials/
Copied!

Example file fileadmin/Partials/Fields/TwitterId.html:

{namespace femanager=In2code\Femanager\ViewHelpers}
<div class="femanager_fieldset control-group">
		<label for="twitterId" class="control-label">
				<f:translate key="tx_femanagerextended_domain_model_user.twitter_id" extensionName="femanagerextended">Twitter</f:translate>
		</label>
		<div class="controls">
				<femanager:form.textfield
								id="twitterId"
								property="twitterId"
								class="input-block-level"
								additionalAttributes="{femanager:Validation.FormValidationData(settings:'{settings}',fieldName:'twitterId')}" />
		</div>
</div>
Copied!

ext_tables.sql

Example SQL file in your extension which extends fe_users with your new fields:

CREATE TABLE fe_users (
	twitter_id varchar(255) DEFAULT '' NOT NULL,
	skype_id varchar(255) DEFAULT '' NOT NULL,
	tx_extbase_type varchar(255) DEFAULT '0' NOT NULL,
);
Copied!

ext_tables.php

Example ext_tables.php file:

\TYPO3\CMS\Core\Utility\GeneralUtility::loadTCA('fe_users');
$TCA['tx_test_domain_model_address']['ctrl']['type'] = 'tx_extbase_type';
$tmp_fe_users_columns = array(
		'twitter_id' => array(
				'exclude' => 1,
				'label' => 'LLL:EXT:femanagerextended/Resources/Private/Language/locallang_db.xlf:tx_femanagerextended_domain_model_user.twitter_id',
				'config' => array(
						'type' => 'input',
						'size' => 30,
						'eval' => 'trim'
				),
		),
		'skype_id' => array(
				'exclude' => 1,
				'label' => 'LLL:EXT:femanagerextended/Resources/Private/Language/locallang_db.xlf:tx_femanagerextended_domain_model_user.skype_id',
				'config' => array(
						'type' => 'input',
						'size' => 30,
						'eval' => 'trim'
				),
		),
		'tx_extbase_type' => array(
				'config' => array(
						'type' => 'input',
						'default' => '0'
				)
		)
);


\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addTCAcolumns('fe_users', $tmp_fe_users_columns, 1);
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addToAllTCAtypes('fe_users', 'twitter_id, skype_id');
Copied!

Own User Model

Example Model User.php which extends to the default femanager Model:

namespace In2code\Femanagerextended\Domain\Model;

class User extends \In2code\Femanager\Domain\Model\User {

	/**
	 * twitterId
	 *
	 * @var string
	 */
	protected $twitterId;

	/**
	 * skypeId
	 *
	 * @var string
	 */
	protected $skypeId;

	/**
	 * Returns the twitterId
	 *
	 * @return string $twitterId
	 */
	public function getTwitterId() {
			return $this->twitterId;
	}

	/**
	 * Sets the twitterId
	 *
	 * @param string $twitterId
	 * @return void
	 */
	public function setTwitterId($twitterId) {
			$this->twitterId = $twitterId;
	}

	/**
	 * Returns the skypeId
	 *
	 * @return string $skypeId
	 */
	public function getSkypeId() {
			return $this->skypeId;
	}

	/**
	 * Sets the skypeId
	 *
	 * @param string $skypeId
	 * @return void
	 */
	public function setSkypeId($skypeId) {
			$this->skypeId = $skypeId;
	}

	/**
	 * @param string $username
	 */
	public function setUsername($username) {
			$this->username = $username;
	}

}
Copied!

TypoScript to include Model and override default controller

config.tx_extbase{
	persistence{
		classes{
			In2code\Femanager\Domain\Model\User {
				subclasses {
					0 = In2code\Femanagerextended\Domain\Model\User
				}
			}
			In2code\Femanagerextended\Domain\Model\User {
				mapping {
					tableName = fe_users
					recordType = 0
				}
			}
		}
	}
	objects {
		In2code\Femanager\Controller\NewController.className = In2code\Femanagerextended\Controller\NewController
		In2code\Femanager\Controller\EditController.className = In2code\Femanagerextended\Controller\EditController
	}
}
Copied!

Own Controller Files

EditController.php:

namespace In2code\Femanagerextended\Controller;

class EditController extends \In2code\Femanager\Controller\EditController {

	/**
	 * action update
	 *
	 * @param In2code\Femanagerextended\Domain\Model\User $user
	 * @validate $user In2code\Femanager\Domain\Validator\ServersideValidator
	 * @validate $user In2code\Femanager\Domain\Validator\PasswordValidator
	 * @return void
	 */
	public function updateAction(\In2code\Femanagerextended\Domain\Model\User $user) {
		parent::updateAction($user);
	}
}
Copied!

NewController.php:

namespace In2code\Femanagerextended\Controller;

class NewController extends \In2code\Femanager\Controller\NewController {

	/**
	 * action create
	 *
	 * @param In2code\Femanagerextended\Domain\Model\User $user
	 * @validate $user In2code\Femanager\Domain\Validator\ServersideValidator
	 * @validate $user In2code\Femanager\Domain\Validator\PasswordValidator
	 * @return void
	 */
	public function createAction(\In2code\Femanagerextended\Domain\Model\User $user) {
		parent::createAction($user);
	}
}
Copied!

Note: If there are PHP warnings like “…should be compatible with…“ for PHP7, see discussion and solution: https://stackoverflow.com/questions/45563671/how-to-extend-femanager-controller-under-php-7/45564378

or try to change the Controller Files to:

Own Controller Files with PHP 7.2 / TYPO3 9.5.x

EditController.php:

namespace In2code\Femanagerextended\Controller;

class EditController extends \In2code\Femanager\Controller\EditController {

	/**
	 * action update
	 *
	 * @param In2code\Femanagerextended\Domain\Model\User $user
	 * @validate $user In2code\Femanager\Domain\Validator\ServersideValidator
	 * @validate $user In2code\Femanager\Domain\Validator\PasswordValidator
	 * @return void
	 */
	public function updateAction($user) {
		parent::updateAction($user);
	}
}
Copied!

NewController.php:

namespace In2code\Femanagerextended\Controller;

class NewController extends \In2code\Femanager\Controller\NewController {

	/**
	 * action create
	 *
	 * @param In2code\Femanagerextended\Domain\Model\User $user
	 * @validate $user In2code\Femanager\Domain\Validator\ServersideValidator
	 * @validate $user In2code\Femanager\Domain\Validator\PasswordValidator
	 * @return void
	 */
	public function createAction($user) {
		parent::createAction($user);
	}
}
Copied!