first commit

public/typo3conf/ext/femanager/Documentation/Features/FillEmailAsUsername/Index.rst

@@ -0,0 +1,51 @@
+.. include:: ../../Includes.rst.txt
+
+
+.. _fillEmailAsUsername:
+
+Fill Email as Username during registraion
+-----------------------------------------
+
+Introduction
+^^^^^^^^^^^^
+
+**Available since 2.0**
+
+If this setting is enabled, the mail address is taken as username. The setting can be applied in three situations:
+   * During registration (new)
+   * During edit process of an existing user (edit)
+   * During Invitation process (invite)
+
+Configuration
+^^^^^^^^^^^^^
+
+Enable the "fillEmailWithUsername" option for the area (new, edit, invite), where you like to apply it.
+
+Example for "new" area:
+
+:typoscript:`plugin.tx_femanager.settings.new.fillEmailWithUsername = 1`
+
+Please take care, that the username is not set to required, otherwise it will not work
+
+:typoscript:`plugin.tx_femanager.settings.new.validation.username.required = 0`
+
+Example
+'''''''
+
+TypoScript:
+
+.. code-block:: typoscript
+
+   plugin.tx_femanager.settings {
+       new {
+            fillEmailWithUsername = 1
+            validation.username.required = 0
+       }
+   }
+
+Remarks
+^^^^^^^
+
+Please mind, if you use this setting in the edit view, a user is able to change his username.
+Therefor you should always take care, via validation settings, that a username (and also the mail address) stays
+unique for your users.