ft.cki_mblist.php
This is an EE2.0 custom field type that will add a drop down list of all your site members to your ExpressionEngine publish form. When displaying the field in your ExpressionEngine templates the custom field tag will allow you to retrieve any information stored for that member, such as Email, Screen name, Member ID, Member group name etc.
Developed by Christopher Imrie, http://www.christopherimrie.com
This field type is inspired by LG Member list (http://leevigraham.com/cms-customisation/expressionengine/lg-member-list/)
- ExpressionEngine 2.0
- Copy the
cki_mblist
folder to yoursystem/expressionengine/third_party/
folder. - Go to Add-ons → Fieldtypes in the ExpressionEngine control panel and install the fieldtype labelled ‘CKI Member List’
- Select CKI Member List as the field type when creating a new custom field type
The field type supports single tag and tag pairs, depending on whether you want more than one element of member data at any one time.
The member_id of the selected member can be produced by simply using the Field name of your custom field with no parameters. If you want to retrieve a specific item of member data, you can use the get
parameter to specify what data you want returned.
Lets say you have defined a custom field with a field label of Member_list and field name member_list and through the publish form selected a member with an ID of 3. You can produce the Member ID of the selected member by simply calling the field name tag on its own:
{exp:channel:entries channel="blog"}
<p>You selected member ID {member_list}</p>
{/exp:channel:entries}
Returns:
<p>You selected member ID 3</p>
Using the same member you have selected in the above example, we can retrieve this member’s email address by using the show
parameter:
{exp:channel:entries channel="blog"}
<p>You selected member email is {member_list show="email"}</p>
{/exp:channel:entries}
Returns:
<p>Your selected member email is john@smith.com</p>
show="screen_name"
Allows you to specify what member data to return. Accepts field names of the exp_members and exp_member_groups database tables.
Valid examples:
- member_id
- username
- screen_name
- group_title
- group_description
- bio
- avatar_filename
- url
- location
- occupation
- avatar_filename
- avatar_width
- avatar_height
- total_entries
- total_comments
- total_forum_posts
- total_forum_topics
1.3
- Removed tag pair functionality due to conflicts
- Now promoting use of “show” parameter instead of “get”
- Compatibility fixes for EE 2.0.2 PB
1.2
- Updated to use newly published field type API
1.1.1
- Fixed bug for when using single field tags in templates
1.1
- Separated members into member groups in publish form drop down list
- Updated member existence checker
1.0
- Initial Commit