glFusion Wiki

Site Tools


glfusion:user_admin

User Management System

glFusion provides a complete user management system to assist you in creating, modifying, and deleting users.

A username can contain any character except “ < > $ % & * / characters.

User Registration

glFusion allows you to set up your site where new users can register themselves. To tailor the user registration process to meet your needs, you will need to set the proper configuration options in the Online Configuration system.

There are two types of new user registrations:

Automatic Password Generation
Using this method, the new user will provide their username and email address. glFusion will automatically generate a password and send it to the user using their email address.

This is the default method on a new glFusion installation.
Activation Email
Using this method, a new user will provide their username, password, and email address. A verification email will be sent to their email address and once they select the link in the email, their account will become active.
Disable New Registrations
You can also disable new user registration. In this case, the your site users will not have the ability to 'self-register'. If they need a user account, the site administrator will need to create the account.
User Submission Queue
If you would like to approve all new user registrations, you can enable the User Submission Queue. As new users register, their account will not be active until a site administrator approves the registration. At that time, an email will be sent to the user so they can activate their account.
Additional User Info
Out of the box, glFusion only collects the username, password, email, and optionally the full name of the user. If you need to collect additional information about a user at the time they register, you should consider installing the

User Submission Configuration Settings

The configuration settings that control the user registration process are located at Command & Control » Configuration » Users & Submissions.

User Submission Queue
Enable (true) or disable (false) the user submission queue (i.e. new users must be approved before they receive their password or activation email).
Registration Type
Selects which type of registration process to use.
  • User Enters Password will send an activation email to the user.
  • Generate Password will send an automatically generated password to the user.
Automatic Allow Domains
When the user submission queue is enabled this can contain a comma-separated list of domain names from which user submissions will not be queued (but approved automatically). Regular expressions are also allowed and interpreted. Example: 'mycompany.com,myothercompany.com'.
Automatic Disallow Domains
This is the opposite of allow_domains (see above): A list of domain names that are not allowed in email addresses of new users. Note that this list is always used, even when the user submission queue has been switched off. Again, regular expressions can be used. Example disallow email addresses with a certain domain name and from any ”.edu“ domain: 'somebaddomain.com,\.edu$'.
Full Name option on registration form
Determines if the user's full name is required at registration time.

User Administration

The User Administration section allows you to create, modify, and delete users on your site. Generally, most user account creation happens automatically when a new user registers on your site. Since you can disable new user registration, you may need to manually create new users.

From the User Administration Screen you can do the following:

Edit Users

By selecting the edit icon, you can change a user's password, modify their group memberships, change their member status (active, banned, etc.), or modify any other attribute about the user.

Batch Add

glFusion allows the batch creation of multiple user accounts. At the time these accounts are created, a welcome email is sent to each user containing their login information. Accounts created via the Batch Add import feature are created and activated immediately, bypassing the user submission approval queue.

glFusion will read a tab-delimited text file with the following fields (in this order) listed for each user to add (one per line):

  • full name
  • username
  • email

To import users, browse to the text file, choose Import and the accounts will automatically be created.

The file must have a extension of “txt”, and the 3 tab separated text fields must not be surrounded by quotes.

Batch Administration

This screen allows you to easily see various types of users on your site. You can quickly delete users who have not visited the site in XX months.

Phantom users
Users that registered more than XX months ago, but never logged in.
Short-Time Users
Users that registered more than XX months ago, then logged in within 24 hours, but since then never came back to your site.
Old Users
Normal users, who simply did not visit your site since XX months.
Recent Users
Users that registered in the last XX months

You can also select users to Send a Reminder to, this will email the user with their login information on your site and remind them they have an account.

Global Preference Editor

There are times when you may want to or need to change a user setting for all users on the site. The Global Preference Editor allows you to quickly change any of the following attributes for all users:

  • Language
  • Theme
  • Remember Me For
  • No Topic Icons
  • No Blocks
  • Maximum Stories
  • Time Zone
  • Date Format
  • Show Result Type
  • Comment Display Mode
  • Comment Sort Order
  • Comment Limit
  • eMail from Users
  • eMail from Admin
  • Show Online Status

To change a specific setting, select the value you want to change and check the Select box on the right for that attribute. Press the Save button and the new value will be applied to all site users.

Welcome Email

There are 2 methods to change the New User Welcome Email. You can create a welcome_email.txt file in the private/data directory or customize thew new user email templates in the theme directory. Customizing the email templates in the theme directory is the preferred method.

Custom welcome_email.txt

This method is depreciated. It will be removed from glFusion in a subsequent release.

You can create a custom welcome email by creating a welcome_email.txt template in the private/data/ directory.

The custom email only applies when using the Generate Password registration option. When using the User Enters Password registration process, you cannot customize that email.

The following template variables are available:

{auth_info}
Username: <username> Password: <password>
{site_url}
The URL to your site
{site_name}
The Site Name
{site_slogan}
The Site Slogan
{lang_text1}
A translated text of : Your {$_CONF['site_name']} account has been created successfully. To be able to use it, you must login using the information below. Please save this mail for further reference.
{lang_text2}
Translated text: This password is generated by a randomizer. It is recommended that you change this password immediately. To change your password, log in and then click Account Settings from the My Account menu.
{lang_username}
Translated text for Username
{lang_password}
Translated text for Password
{username}
The username of the user who is receiving the email
{password}
The password of the user who is receiving the email
{name}
The display name of the user

New User Email Templates

Every new user will receive a welcome email. The email will be in both HTML and text format to ensure the user can view on just about any type of email client.

glFusion ships with default templates to handle formatting the email. There are 2 templates for new user emails:

  • <themename>/email/newuser_template_html.thtml
  • <themename>/email/newuser_template_text.thtml

You can customize these templates by creating a copy in the <themename>/email/custom/ directory.

The template variables that are available are dependent upon the type of new user registration that is configured.

Template Variable when using Activation Email - User Enters their own password

{url}
The URL to the verification screen (i.e.;) https://www.glfusion.org/users.php?mode=verify&vid=12341234123&u=200
{lang_site_or_password}
The text for Password
{site_link_url}
The Site URL (i.e.; https://www.glfusion.org)
{lang_activation}
Activation Instructions - 'Please visit the following link in order to activate your account (the activation link is only valid for XX hours):
{lang_button_text}
Text for the Activate Button - i.e.; Activate Account
{title}
The Site Name + 'Account Information'
{site_name}
The site site as configured in Configuration → Site → Site Name
{username}
The user name of the user who just registered

Template Variable when using Automatic Password Generation

{url}
Link to usersettings.php
{lang_site_or_password}
Translated text for New Password
{site_link_url}
Empty - not used
{lang_activation}
Translated text for: This password is generated by a randomizer. It is recommended that you change this password immediately. To change your password, log in and then click Account Settings from the My Account menu.
{lang_button_text}
Translated text for: Change Password
{passwd}
System generated password for user
{title}
Translated text for : Site Name - Account Information
{site_name}
Site name as configured in Configuration → Site → Site Name
{username}
The user name of the person receiving the email
glfusion/user_admin.txt · Last modified: 2017/03/10 10:12 (external edit)

Page Tools