Description
The Friends module takes you a step further towards Social Networking for your website. It allows your users to create and manage lists of friends just like Facebook. Aside from the typical friend request/confirm method, some alternate usages might be to follow other members, only allow “friends” to view your full profile, “bookmark” your favorite authors and subscribe to their channel entries, etc.
Along with Facebook-esque friends functionality, Friends includes complete private messaging (which works off of native EE private messaging), status updates, comment walls, “hugging”, website invites and referral tracking system, and virtual groups where users can create and join groups. In combination with the User addon, the possibilities are endless.
Finally, a better way to make friends.
Works on: ExpressionEngine 2.x Shortcut:
Compare
Link to this page:
Changelog
- Version 1.6.2
- Version 1.6.1
- Version 1.6.0
- Version 1.5.8
- Version 1.5.7
- Version 1.5.6
- Version 1.5.5
- Version 1.5.4
- Version 1.5.3
- Version 1.5.2
- Version 1.5.1
- Version 1.5.0
- Version 1.1.0
- Version 1.0.0
Version 1.6.2 (May 1, 2013)
- Added reply_email="" parameter to the Message_Form tag to allow a no-reply email address to be used.
- Added {friends_inviter_photo_url}, {friends_sender_photo_url}, {friends_invitee_photo_url} and {friends_recipient_photo_url} variables in notification templates.
- Added a number of standard Friends member variables, including {friends_total_combined_posts}.
- Updated for compatibility with ExpressionEngine 2.6.
- Fixed a bug in the Friends:Members where the 'if friends_no_results' conditional would not be triggered when using the username="" parameter with a username that does not exist.
- Fixed a bug where PHP errors would occur in the control panel on PHP 5.2.x.
- Deprecated the 'friends_daylight_savings' variable for EE 2.6+ as it's no longer available.
Version 1.6.1 (March 12, 2013)
- Added internal Demo Templates tab in control panel (replaces older "code pack" approach).
- Updates are now automatic and no longer require a manual update screen.
Version 1.6.0 (January 24, 2013)
- Removed support for ExpressionEngine 1.x (Friends is now EE2 only).
- Added offline documentation files to download package.
- Added {friends_count} and {friends_total_results} variables to the Friends:Hugs tag.
- Added {friends_total_results} variable to the Friends:Messages tag.
- Fixed a bug where MySQL errors could occur in front end templates in EE 2.5.4+.
- Fixed a bug where new installs of Friends were not MySQL strict compatible.
- Fixed a bug where errors could occur on some forms if the IP to Nation module was not installed.
- Fixed a bug where running more tags after Wall or Group Comment forms could result in PHP errors.
Version 1.5.8 (September 20, 2012)
- Fixed a bug where PHP errors could show on sites using ExpressionEngine 2.5.3+ and PHP 5.3+.
Version 1.5.7 (February 7, 2012)
- Updated pagination to support ExpressionEngine 2.4.
- Updated Friends to use the 'required by' method for install/uninstall of extension.
- Modified Friends:Group_Form tag to allow displaying of both {friends}{/friends} and {members}{/members} variable pairs together.
- Fixed a bug in Friends:Status where the {friends_count} would return '0' instead of the current friend count.
- Fixed a potential XSS issue with EE template tags in Friends:Group_Wall and Friends:Profile_Wall comments.
- Fixed a bug in Friends:Profile_Wall where passing friend_id="CURRENT_USER" would be ignored.
- Fixed a bug where pagination links did not parse correctly in Friends:Entries in EE1.
Version 1.5.6 (November 2, 2011)
- Updated pagination to use a better parsing function in order to more easily support future upgrades of the EE pagination library.
- Updated non-existant member deletion process for better performance.
- Fixed a bug where the {friends_profile_views} variable wasn't parsing inside Friends:Members tag.
- Fixed a bug where the 'dynamic' parameter was misspelled in the sample Code Pack message forward template.
- Fixed a bug where friends did not do a cleanup on the deletion of members through the Solspace User module.
Version 1.5.5 (September 15, 2011)
- Fixed a bug where a preference variable was misnamed and caused errors to be shown in templates.
- Fixed a bug where if a user's account has been deleted through a non-native method, it would trigger PHP errors in templates calling that member.
Version 1.5.4 (August 19, 2011)
- Fixed a bug where the 'class' attribute on EE1 wasn't added to generated forms.
- Fixed a bug that stopped message folders with non-alphanumeric characters being created or renamed.
- Fixed a bug where old wall comments from a deleted user was outputting errors when trying to access their details.
- Fixed a bug where pagination data in the URI would affect Friends tags when it shouldn't.
- Fixed a bug where a member couldn't comment on their own profile wall.
- Fixed a bug where the {friends_count} variable in the Friends:Messages tag would always return '0'.
- Fixed a bug where the preference to parse custom member data was defaulting to false.
- Fixed a bug where the friend delete method in the CP wouldn't accept batch deletes.
Version 1.5.3 (May 27, 2011)
- Updated module to use Solspace Add-on Builder Framework in EE2.
- Added 'form_class' parameter to the Friends:Status_Form tag.
- Fixed a bug where Friends Groups were always being assigned to Site ID 1.
- Fixed a bug where Friends:Groups wouldn't order randomly.
- Fixed a SQL bug on Friends:Members and Friends:Invites when passing orderby="random".
- Fixed a bug where deleting a friendship in the Friends module CP would give an PHP error.
- Fixed a bug where the Status_Delete tag would not allow users and Super Admins to delete statuses.
- Fixed a bug where the Group_Entries tag would sometimes display an error.
- Fixed a bug where a miscount on total_friends and total_reciprocal_friends occurred when a friendship was deleted via the CP.
Version 1.5.2 (February 24, 2011)
- Added NSM Add-on Updater support.
- Added a check for enabled extensions in case a user upgrades from EE 1.x to EE 2.x and the Friends extension becomes disabled.
- Modified the Friends Referrals feature to now tie directly into native EE and User Register forms.
- Fixed a bug where a SQL error would be triggered when deleting a message folder.
- Fixed a bug in Friends:Groups tag where EE 1.x weblog functions were attempting to be called in EE 2.x.
- Fixed a bug where some functions' URL detection would only detect single digits, such as the Status_Delete tag.
- Fixed a bug where the reciprocal="" parameter was being ignored in EE 2.x on the Friends:Mutual_Friends tag.
- Fixed a bug where the {friends_total_reciprocal_friends} variable seemed to work intermittantly.
- Fixed a bug where the offset="" parameter did not work in Friends tags (requires Bridge 1.1.7+).
- Fixed a bug where the Group_Entry_Add function did not work when creating new SAEF entries.
- Fixed a bug where the show_blocked="no" parameter was not working in the Friends:Invites tag with invite_type="incoming" parameter specified.
- Removed MSM Site ID checking from retrieving member statuses.
Version 1.5.1 (December 21, 2010)
- Updated and enhanced Friends module CP area (in EE 2.x) to conform completely to native EE styling.
- Removed "flow_ui" theme from Friends module in EE 1.x.
- Fixed various DB inputs that were not inserting the correct site_id and causing errors in MSM.
- Fixed a bug where specifying "random" in the orderby="" parameter in Friends:Mine would cause a MySQL error.
- Fixed a bug where the friend_id="" parameter in Friends:Profile_Wall tag would not accept values like "CURRENT_USER" or "{segment_3}".
Version 1.5.0 (October 21, 2010)
- Upgraded module to use Solspace Bridge 1.1 with CodeIgniter, therefore allowing compatibility with EE 2.x.
- Added new forward_mode="y" parameter to Message_Form tag so the author isn't over notified by forwards.
Version 1.1.0 (September 2, 2010)
- Added new Profile Wall and Group Wall features to Friends.
- Added new performance preference to Preferences tab to enable/disable parsing of all custom member fields for notification templates.
- Added {if pagination_links} conditonal to the Group_Entries tag.
- Changed the "Message Preferences" tab to now be called just "Preferences".
- Updated Friends Code Pack to accomodate the new Profile Wall and Group Wall features.
- Removed all legacy instances of "public friends" from calculations and DB tables.
- Fixed a bug where total friends counts were not being calculated properly.
- Fixed a bug where the {friends_member_group_title} variable was not being parsed correctly.
- Fixed a bug where the {friends_count} and {friends_total_results} variables were not being parsed correctly in the Groups tag.
- Fixed a bug where other tags could not parse within any Friends tags.
- Fixed percentages and counts of total friends/members in the CP area.
- Fixed a bug where custom member field parsing did not work for some email notifications.
Version 1.0.0 (June 7, 2010)
- Added the "friends_status_update_status" extension hook to be used by Facebook Connect module.
- Added support for removal of weblog entries from a Friends group.
- Added the new Friends:Status_Delete tag to allow users to delete their statuses.
- Added {friends_group_entry_date format=""} and {friends_group_edit_date format=""} variables to the Friends:Groups tag.
- Fixed a bug where the {friends_count} variable was not working in Friends:Group_Members.
- Fixed a bug where if hardcoding a Group ID for editing a Friends Group, you would receive an error saying the group already existed.
- Fixed a bug where the Friends:Message_Folder_Form tag would not let you create new folders.
- Fixed a bug where stray debugging code was left in the module.
- Fixed a bug where if someone had read all of their messages and the recount_private_messages routine ran, their inbox count would not be updated to 0.
- Fixed a bug where the recipient name of a private message was incorrect when viewing message data in the CP or the forum.
- Fixed a bug where the {friends_count} and {friends_total_count} variables displayed incorrectly in some functions.
- Fixed a bug where Friends was causing incorrect unread message counts on the EE Member/Forums private messages side.
- Fixed a bug where the Friends extension was conflicting with other extensions.
- Fixed a bug where an MySQL error was outputted when trying to remove a member from a group.
- Fixed a bug in the "groups/manage_members" Friends Code Pack template where it displayed incorrect wording for the notification when removing a member from a group.
- Fixed a bug where there was a typo in the input type of the Subject field in the "messages/compose", "messages/reply", "messages/forward", and "main/sendmessage" Friends Code Pack templates.
Installation
ExpressionEngine 2.x Installation Instructions
1. Copy Add-on Files
Friends includes the Code Pack module software to install the Friends Code Pack sample templates and data (optional). It is included with your download in a separate folder.
- Within the /EE2/system/expressionengine/third_party/ directory, copy all folders into your sites’ ./system/expressionengine/third_party/ directory.
- Within the /EE2/themes/third_party/ directory, copy all folders into your sites’ ./themes/third_party/ directory.
2. Installing the Add-On
- Go to the Modules area in the ExpressionEngine Control Panel, find Friends in the list, and click Install.
3. Loading the Friends Code Pack sample data (optional)
To make use of the Friends Code Pack sample templates, you’ll need to make sure the Code Pack module and Friends Code Pack extension is installed:
- Go to the Extensions area in the ExpressionEngine Control Panel, find Friends Code Pack in the list, and click Enable.
- Go to the Modules area in the ExpressionEngine Control Panel, find Code Pack in the list and make sure it is installed. If not, click Install. Then, click the link for Code Pack.
- In the list of available Code Packs, click Friends Code Pack.
- Create a prefix name for the sample data such as test_ or friends_.
- Select the Default code pack and click the Submit button. The Code Pack module will output sample templates and other data, all prefixed with the value you specified.
4. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
ExpressionEngine 1.x Installation Instructions
1. Copy Add-on Files
This add-on requires that you use the Solspace Bridge software with ExpressionEngine 1.x. It will be included with your download in a separate folder. Additionally, Friends includes the Code Pack module software to install the Friends Code Pack sample templates and data (optional). It will be included with your download in a separate folder.
- Within the /EE1/system/ directory, copy the bridge folder into your sites’ ./system/ directory.
- Within the /EE1/system/modules/ directory, copy all folders into your sites’ ./system/modules/ directory.
- Within the /EE1/system/extensions/ directory, copy all folders and files into your sites’ ./system/extensions/ directory.
- Within the /EE1/system/language/english/ directory, copy the lang.friends_code_pack.php file into your sites’ ./system/language/english/ directory.
- Within the /EE1/themes/ directory, copy all folders into your sites’ ./themes/ directory.
2. Installing the Add-On
- Go to the Modules tab in the ExpressionEngine Control Panel, find Friends in the list, and click Install.
- Go to the Extensions Manager area in the ExpressionEngine Control Panel, and make sure the jQuery for the CP extension exists and is enabled.
3. Loading the Friends Code Pack sample data (optional)
To make use of the Friends Code Pack sample templates, you’ll need to make sure the Code Pack module and Friends Code Pack extension is installed:
- Go to the Extensions area in the ExpressionEngine Control Panel, find Friends Code Pack in the list, and click Enable.
- Go to the Modules tab in the ExpressionEngine Control Panel, find Code Pack in the list and make sure it is installed. If not, click Install. Then, click the link for Code Pack.
- In the list of available Code Packs, click Friends Code Pack.
- Create a prefix name for the sample data such as test_ or friends_.
- Select the Default code pack and click the Submit button. The Code Pack module will output sample templates and other data, all prefixed with the value you specified.
4. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
Updates
After downloading the latest version of the add-on, unzip the download file and follow these instructions...
ExpressionEngine 2.x Updating Instructions
1. Copy Add-on Files
Friends includes the Code Pack module software to install the Friends Code Pack sample templates and data (optional).
- Within the /EE2/system/expressionengine/third_party/ directory, copy all folders into your sites' ./system/expressionengine/third_party/ directory.
- Within the /EE2/themes/third_party/ directory, copy all folders into your sites' ./themes/third_party/ directory.
2. Updating the Add-On
- Go to the Modules area in the ExpressionEngine Control Panel and click the link for Friends
- Click the Update link now displayed in the module's control panel.
- If an update has been made to the Code Pack module, repeat the same steps as above, but with the Code Pack module.
If you're installing the Friends Code Pack for the first time, click here for setup instructions.
3. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
ExpressionEngine 1.x Updating Instructions
1. Copy Add-on Files
This add-on requires that you use the Solspace Bridge software with ExpressionEngine 1.x. It is included with your download in a separate folder. Additionally, Friends includes the Code Pack module software to install the Friends Code Pack sample templates and data (optional).
- Within the /EE1/system/ directory, copy the bridge folder into your sites' ./system/ directory.
- Within the /EE1/system/modules/ directory, copy all folders into your sites' ./system/modules/ directory.
- Within the /EE1/system/extensions/ directory, copy all folders and files into your sites' ./system/extensions/ directory.
- Within the /EE1/system/language/english/ directory, copy the lang.friends_code_pack.php file into your sites' ./system/language/english/ directory.
- Within the /EE1/themes/ directory, copy all folders into your sites ./themes/ directory.
2. Updating the Add-On
- Go to the Modules tab in the ExpressionEngine Control Panel and click the link for Friends
- Click the Update link now displayed in the module's control panel.
- If an update has been made to the Code Pack module, repeat the same steps as above, but with the Code Pack module.
If you're installing the Friends Code Pack for the first time, click here for setup instructions.
3. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
Software Support
We pride ourselves on our level of support and our attention to the customer. If you have an issue, we're here to help.
30-day Money Back Guarantee
If your software purchase does not meet your expectations, or is not right for you, just let us know and we'll give you a full refund within 30 days of purchase.
Affiliate Program
Add a Solspace Affiliate link to your site and make 5% on referred purchases. Read more »



