glFusion Wiki

Site Tools



This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Previous revision
glfusion:user_admin [2010/04/26 20:11]
glfusion:user_admin [2016/07/31 11:08] (current)
Mark [Welcome Email]
Line 1: Line 1:
 +====== 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 [[glfusion:​configuration#​users_and_submissions|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 [file:357 Custom Profile Plugin]
 +===== User Submission Configuration Settings =====
 +The configuration settings that control the user registration process are located at **Command & Control >> Configuration >> Users & Submissions**.
 +^Option ​ ^Description ​ ^
 +|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: '​,​'​. ​ |
 +|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: '​,​\.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 [[glfusion:​configuration:​usersandsubmissions#​users_and_submissions|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 [[glfusion:​configuration:​usersandsubmissions#​user_submission|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 ======
 +To customize the formatting of the email message sent out by the registration process, create a file named "​**welcome_email.txt**"​ in  [[glfusion:​configuration:​site#​paths|private/​data directory]].
 +|This text file may use the following template variables:​||
 +|{auth_info} | Pre-built {lang_username}:​ {username} \n {lang_password}:​ {password} |
 +|{site_url} | Site URL |
 +|{site_name} | Site name as configured |
 +|{site_slogan} | Slogan as configured |
 +|{lang_text1} | LANG04[15] |
 +|{lang_text2} | LANG04[14] |
 +|{lang_username} | Language specific ​ "User Name:" label |
 +|{lang_password} | Language specific "New Password:"​ label |
 +|{username} | User's login name |
 +|{password} | Randomly generated password |
 +|{name} | User's name as displayed on the site |
 +<note important>​
 +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.