ExpressionEngine

2.11.9 User Guide

Retired Documentation

You are using the documentation for version 2.11.9. Go here for the latest version or check here for your available upgrades to the latest version.

Membership Preferences

Control Panel Location: Members ‣ Preferences

The Membership Preferences section of the Control Panel allows you to set all of your membership-related preferences.

General Configuration

Allow New Member Registrations?

Set whether site visitors are allowed to register for accounts.

Changed in version 2.1.2: New member registrations are disabled by default on new installations.

Require Member Account Activation?

Here you can choose how membership accounts are activated:

  • No activation required: New members are automatically activated and approved for the site. They can immediately log in and begin using any member areas available at your site.
  • Self-activation via email: New members are sent an email. Inside the email is a special activation link that the user must visit within two days to activate their account. By default ExpressionEngine uses this method since it ensures that the email address the user submitted when signing up is valid.
  • Manual activation by an administrator: New members may only be activated by an admin visiting the Members ‣ Activate Pending section of the Control Panel.

Require Terms of Service

When new members register through the site, a “terms of service” block of text is displayed. This preference determines whether new members must indicate that they agree to abide by these terms before they can register. You may edit the terms of service within the registration form template, located at Design ‣ Themes ‣ Member Profile Templates ‣ Default ‣ Registration Form.

Allow members to set their own localization preferences?

Set whether dates and times are localized to each members’ own localization preferences. If set to “No”, all dates and times will be localized to the site default and localization preferences will be disabled in the Member Profile and My Account pages.

Enable Membership Captcha

Here you can determine whether CAPTCHAs are required for new members registering.

Default Member Group Assigned to New Members

This allows you to specify the Member Group to which approved members will be assigned.

Default Member Profile Theme

The default member profile theme to be used in the Member Profile area of your site. Available, installed themes are listed in the menu.

Profile Triggering Word

When this word is encountered in your URL it will display your member profile area. The word you choose can not be the name of an existing template group. The default value of this is “member”. That means that a URL like the following would trigger ExpressionEngine to display the member profile area:

http://example.com/index.php/member/profile/

Default Member List Preferences

This sets default values for the public member list, typically located at:

http://example.com/index.php/member/memberlist/

Member List - Sort By

Specifies the sorting criteria to be used. Choices are: Total Posts, Screen Name, Total Comments, Total Entries, Join Date.

Member List - Order

Specifies whether to show the list in Ascending or Descending order.

Member List - Rows

Specifies the number of rows to return by default.

Notification Preferences

Send new member notifications?

If enabled, notifications will be sent to the email addresses specified in the next preference field.

Email address for notifications

Here you can specify the email addresses which should receive notifications (see previous preference). Multiple email addresses should be separated by commas.

Private Messaging Preferences

Maximum Number of characters to allow in Private Messages

Specifies the maximum number of characters allowed in a Private Message to limit its total length.

HTML Formatting in Private Messages

This setting determines how raw HTML code within Private Messages is handled. There are three options:

  1. Allow only safe HTML: This will allow “safe” HTML to be rendered: (<b>, <i>, <u>, <em>, <strike>, <strong>, <pre>, <code>, <blockquote>, <h2>, <h3>, <h4>, <h5>, <h6>). All other HTML is converted to character entities.
  2. Convert HTML into character entities: This will convert the HTML tags to HTML character entities so that it will display as plain text when viewed. This is useful if you want to display example code.
  3. Allow ALL HTML: This leaves the HTML code as written and the code will then be interpreted by the browser when the message is viewed.

Server Path for Attachment Upload Directory

Here you set the full server path (not the URL) to the Private Message attachment upload folder. By default, it is the pm_attachments folder inside the images folder.

The full server path might look something like /home/example.com/public_html/images/pm_attachments/. If you do not know what to use for your full server path, contact your Host or server admin. Remember that this upload folder must be set to 777 permissions (or otherwise be “writable”).

Maximum Number of Attachments per Private Message

Specifies the maximum number of file attachments that are allowed to be included with each Private Message.

Maximum Size of Attachment for a Private Message (in Kilobytes)

Specifies the maximum size of the attachment for each Private Message.

Maximum Amount of All Attachments (in Megabytes)

The maximum total storage space allowed for all Private Message attachments in the system. Once this limit is reached, no new Private Message attachments will be allowed.

Avatar Preferences

Enable Avatars

This determines whether avatars are enabled for your site. If enabled, then users will be able to associate an image with their account that you can optionally display with entries, comments, and forum posts.

Allow members to upload their own avatars?

Set whether members can upload their own avatar. If this is set to “No” but avatars are enabled, members will only be able to choose from among the default avatars.

Note

As a site admin, you can add your own avatars by uploading them to /images/avatars/default_set/.

URL to Avatar Folder

The URL to the folder on your site that contains the avatars.

Server Path to Avatar Folder

Here you set the full server page (not the URL) to the avatars folder. By default avatars are located in the avatars folder inside the images folder.

The full server path might look something like /home/example.com/public_html/images/avatars/. If you do not know what to use for your full server path, contact your Host or server admin.

Avatar Maximum Width

The maximum width (in pixels) allowed for user-uploaded avatars.

Avatar Maximum Height

The maximum height (in pixels) allowed for user-uploaded avatars.

Avatar Maximum Size (in Kilobytes)

The maximum file size allowed for user-uploaded avatars.

Note

There are 1024 Kilobytes per Megabyte, so if you want to allow a 2 MB avatar you’ll enter 2048.

Member Photo Preferences

Enable Member Photos

This determines whether member photos are enabled for your site. If enabled, then users will be able to upload an image to be displayed in their member profile area.

URL to Photos Folder

The URL to the folder on your site that contains the member photos.

Server Path to Photo Folder

Here you set the full server path to the member photos folder. By default, it is the member_photos folder inside the images folder. This is not the URL to the folder.

The full server path might look something like /home/example.com/public_html/images/member_photos/. If you do not know what to use for your full server path, contact your Host or server admin. Remember that this upload folder must be set to 777 permissions (or otherwise be “writable”).

Photo Maximum Width

The maximum width (in pixels) allowed for user-uploaded member photos.

Photo Maximum Height

The maximum height (in pixels) allowed for user-uploaded member photos.

Photo Maximum Size (in Kilobytes)

The maximum file size allowed for user-uploaded member photos.

Note

There are 1024 Kilobytes per Megabyte, so if you want to allow a 2 MB photo you’ll enter 2048.

Signature Preferences

Allow Users to have Signatures?

This determines whether member signatures are enabled for your site. If enabled, then users will be able to create a signature for their account that you can optionally display with entries, comments, and forum posts.

Maximum number of characters per signature

The maximum number of characters allowed within a member’s signature.

Allow image hot linking in signatures?

Specifies whether or not members can “hot link” to images located on other sites or servers. Most sites do not like other people to hot link to their content since it basically “steals” their bandwidth.

Allow users to upload an image in their signature?

Determine whether or not members will be allowed to upload images to be used in their signatures.

URL to Signature Image Upload Folder

The URL to the folder on your site that contains the signature image uploads.

Server path to Signature Image Upload Folder

Here you set the full server page (not the URL) to the signature image uploads folder. By default, it is the signature_attachments folder inside the images folder.

The full server path might look something like /home/example.com/public_html/images/signature_attachments/. If you do not know what to use for your full server path, contact your Host or server admin. Remember that this upload folder must be set to 777 permissions (or otherwise be “writable”).

Maximum Width of Signature Image

The maximum width (in pixels) allowed for user-uploaded signature images.

Maximum Height of Signature Image

The maximum height (in pixels) allowed for user-uploaded signature images.

Maximum Size (in Kilobytes) of Signature Image

The maximum file size allowed for user-uploaded signature images.