FreeMember: Free your member templates!
FreeMember is a free add-on for ExpressionEngine 2.2+, which adds powerful inline member profile & authentication tags using the native EE template syntax, instead of using the ugly and inflexible static member templates bundled with EE.
Requirements
- ExpressionEngine 2.6+ (EE Core is not supported)
- PHP 5.3+
Installation
- Copy the
freemember
folder tosystem/expressionengine/third_party
on your server. - Create an encryption key in
config.php
if you have not already done so (see below). - Visit Add-ons > Modules > FreeMember on your server, and click Install next to FreeMember.
If you are upgrading from FreeMember 1.x, please note that FreeMember is now a module, and you must enable it by following the above instructions.
How do I create an encryption key?
ExpressionEngine and CodeIgniter have a built in encryption class, which FreeMember uses to securely store form parameters between page loads (such as required fields on your registration page).
Many ExpressionEngine add-ons use this library, so you may have already set an encryption key. If you have not, you will see the following poorly worded error message when you try to use FreeMember tags on your website:
In order to use the encryption class requires that you set an encryption key in your config file.
Creating an encryption key is easy. Simply follow these steps:
- Visit this page to generate a random key. The key you generate must be unique for each ExpressionEngine site. The 63 random alpha-numeric characters box will do nicely. You could also use 1Password or similar to generate a random string - just be sure it is at least 32 characters long.
- Open
system/expressionengine/config/config.php
. Scroll down to where you see$config['encryption_key']
, and paste in your random string. For example:
$config['encryption_key'] = "yourrandomstringhere";
That's it. Now your encryption key is set, and you're ready to start using FreeMember!
Documentation
The following tags are available:
- Login Tag
- Logout Url Tag
- Register Tag
- Update Profile Tag
- Members Tag
- Forgot Password Tag
- Reset Password Tag
Support
If you have found a bug, or would like to request a feature, please use the GitHub Issue Tracker.
If you have a question about using FreeMember, please check ExpressionEngine Answers
to see whether anyone else has had the same issue, or ask a new question. Be sure to tag your question
with freemember
so it can be easily found.
Release Notes
For a complete list of changes in each FreeMember release, please see our Changelog.
License
FreeMember is released under the MIT License. For more information, see License.