Skip to main content

Options

The LmcUser module has some options to allow you to quickly customize the basic functionality. After installing LmcUser, copy ./vendor/lm-commons/lmc-user/config/lmcuser.global.php.dist to ./config/autoload/lmcuser.global.php and change the values as desired.

The following options are available:

  • user_entity_class - Name of Entity class to use. Useful for using your own entity class instead of the default one provided. Default is LmcUser\Entity\User.
  • enable_username - Boolean value, enables username field on the registration form. Default is false.
  • auth_identity_fields - Array value, specifies which fields a user can use as the 'identity' field when logging in. Acceptable values: username, email.
  • enable_display_name - Boolean value, enables a display name field on the registration form. Default value is false.
  • enable_registration - Boolean value, Determines if a user should be allowed to register. Default value is true.
  • login_after_registration - Boolean value, automatically logs the user in after they successfully register. Default value is false.
  • use_registration_form_captcha - Boolean value, determines if a captcha should be utilized on the user registration form. Default value is true. (Note, right now this only utilizes a weak Laminas\Text\Figlet CAPTCHA, but I have plans to make all Laminas\Captcha adapters work.)
  • login_form_timeout - Integer value, specify the timeout for the CSRF security field of the login form in seconds. Default value is 300 seconds.
  • user_form_timeout - Integer value, specify the timeout for the CSRF security field of the registration form in seconds. Default value is 300 seconds.
  • use_redirect_parameter_if_present - Boolean value, if a redirect GET parameter is specified, the user will be redirected to the specified URL if authentication is successful (if present, a GET parameter will override the login_redirect_route specified below).
  • login_redirect_route String value, name of a route in the application which the user will be redirected to after a successful login.
  • logout_redirect_route String value, name of a route in the application which the user will be redirected to after logging out.
  • password_cost - This should be an integer between 4 and 31. The number represents the base-2 logarithm of the iteration count used for hashing. Default is 10 (about 10 hashes per second on an i5).
  • enable_user_state - Boolean value, enable user state usage. Should user's state be used in the registration/login process?
  • default_user_state - Integer value, default user state upon registration. What state user should have upon registration?
  • allowed_login_states - Array value, states which are allowing user to login. When user tries to login, is his/her state one of the following? Include null if you want user's with no state to login as well.