Installation

Following are the highlights of the plugin’s features:

• Activity Streams – Insert and customize the activity stream on any page or post of your BuddyPress powered site using a simple shortcode.
• Group Listings – Instantly embed and personalize the desired group listings and make them appear anywhere on your BuddyPress website using a flexible shortcode.
• Member Listings – Show highly customizable member listings by embedding shortcodes on your BuddyPress site with an easy to use the shortcode.
• Multisite Compatible

BuddyPress is a modern, robust, and sophisticated social networking software that enables you to create your own community website on WordPress. The most popular social networking plugin, it is equipped with member profiles, activity streams, user groups, and many more incredible features. However, it is short-handed when it comes to managing shortcodes on your WordPress site.

To combat this, Shortcodes for BuddyPress was created. It is a simple multisite compatible plugin that allows you to show activity streams, members and group listings on any post or page on your BuddyPress powered website using shortcodes.

1. Download the zip file from My Account << Downloads section of your wbcomdesigns.com profile.
2. Upload the “Shortcodes For BuddyPress” plugin to the “/wp-content/plugins/” directory via FTP.
3. Activate the plugin through the “Plugins” menu.
4. Alternatively, you can use WordPress Plugin installer from Dashboard >> Plugins >> Add New to add this plugin.

Following is the shortcode for activity listing you can use this in your post and pages:

[activity-listing]

Here is the way you can specify options

[activity-listing option_name=option_val option_name2=option_val2 and so on]

For Example: [activity-listing title=Chris_Group object=Groups per_page=1].

The accepted parameters:-

• title (string):- What should be the title of the activities section

Example: [activity-listing title=My_Activity-Listing per_page=2].

• display_comments (sting|bool):- How to handle activity comments.
• Possible values: – ‘threaded’ – comments appear in a threaded tree, under their parent items.
  – ‘stream’ – the activity stream is presented in a flat manner, with comments sorted in chronological order alongside other activity items.
  – false – don’t fetch activity comments at all.
  Default: ‘threaded’.
• include (string):- Activity IDs or string of activity IDs comma-separated to query. Providing an ‘include’ activity IDs will override all other filters passed in the argument. When viewing the permalink page for a single activity item, this value defaults to the ID of that item. Otherwise, the default is false.
• in (string):- Activity IDs or string of activity IDs comma-separated to limit the query by (IN). ‘in’ is intended to be used in conjunction with other filter parameters. Default: false.
• exclude (string):- Activity IDs or string of activity IDs comma-separated to exclude. Default: false.
• sort (string):- ‘ASC’ or ‘DESC’. Default: ‘DESC’.

Example: [activity-listing title=Chris_Group object=Groups sort=ASC].

• per_page (int):- Number of results per page. Default: 20.

Example: [activity-listing per_page=4]

• page_args (int):- String used as a query parameter in pagination links. Default: ‘page’.
• max (int):- Limit the maximum no. of activities to be included in the list.

Example: [activity-listing title=Max_Activity-Listing max=1].

• scope (string):- Use a BuddyPress pre-built filter.
  – ‘just-me’ retrieves items belonging only to a user; this is equivalent to passing a ‘user_id’ argument.
  – ‘friends’ retrieves items belonging to the friends of a user.
  – ‘groups’ retrieves items belonging to groups to which a user belongs to.
  – ‘favorites’ retrieves a user’s favorited activity items.
  – ‘mentions’ retrieves items where a user has received an @-mention.
  The default value of ‘scope’ is set to one of the above if that value appears in the appropriate place in the URL; eg, ‘scope’ will be ‘groups’
  when visiting http://example.com/members/joe/activity/groups/.
  Otherwise defaults to false.
• user_id (int):- If you want to list a particular user’s activity
• object (string):- object to filter on e.g. groups, profile, status, friends(what type of activity is this)
• action (string):- action to filter on e.g. activity_update, new_forum_post, profile_updated(why this activity was created)
• primary_id (int):- object ID to filter on e.g. a group_id or forum_id or blog_id etc. We will see the use in a minute.

Example: [activity-listing object=groups primary_id=2].

• secondary_id (int):- secondary object ID to filter on e.g. a post_id(I don’t think you are going to use it)
• search_terms (String):- In case you want to list the results of activity search
• allow_posting (int):- If you want to allow users to post. It will include the default activity posting form. It is experimental and may have issues on some of the themes.
• hide_on_activity (int):- Default 1. Hide/show the shortcode content on activity pages(If you are using it in the sidebar and want it to be visible on user/group/site activity page, set it to 0)
• container_class (string):- Default ‘activity’ . Allows changing the class of the shortcode contents wrapper. If you have the hide_on_activity=0, then please set it to some other value than ‘activity'(Maybe ‘activities’ or something else). If you do not change it, On the user/group/site activity page, the activity filter will affect the content of the shortcodes. It is suggested to change it if hide_on_activity=0 is set.

This shortcode can take the following parameters:

Examples:-

[activity-listing per_page=2]

This [activity-listing per_page=2] shortcode shows a list of Activity, and it accompanies a great deal of parameters to customize which activity is appeared and how they are spread out.

[activity-listing user_id=1]

You can use this shortcode to shows the content of the user activity list. The shortcode can be used on any page or widget area.

[activity-listing search_terms=’Arts and Science.’]

This shortcode uses to show list activities containing the search word “Arts and Science.”

[activity-listing object=groups]

This [activity-listing object=groups] shortcode uses to shows the List of all activities of the group.

[activity-listing object=groups primary_id=2]

Following is the shortcode for member listing you can use this in your post and pages:

[members-listing]

Here is the way you can specify options

[members-listing option_name=option_val option_name2=option_val2 and so on]

Example: [members-listing title=Member_List object=Groups per_page=2].

The accepted parameters:-

• title (string):– What should be the title of the member’s section.
• type (string):- Sort order. Accepts ‘active’, ‘random’, ‘newest’, ‘popular’, ‘online’, ‘alphabetical’. Default: ‘active’.
• per_page (int|bool):- Number of results per page. Default: 20.
• max (int|bool):- Maximum number of results to return. Default: false (unlimited).

Example: [members-listing max=2]

• include (int|string):- Limit results by a list of user IDs. Accepts a single integer, a comma-separated list of IDs (to disable this limiting). Accepts ‘active’, ‘alphabetical’,’newest’, or ‘random’. Default: false.
• exclude (int|string):- Exclude users from results by ID. Accepts a single integer, a comma-separated list of IDs (to disable this limiting). Default: false.
• user_id (int):- If provided, results are limited to the friends of the specified user. When on a user’s Friends page, defaults to the ID of the displayed user. Otherwise defaults to 0.
• member_type (string):- Can be a comma-separated list. (Note: BuddyPress itself does not register any member types. Plugins and themes can register member types using the bp_register_member_type() or the bp_register_member_types() function.)
• include_member_role (string):- Can be a comma-separated list of members role.
• exclude_member_role (string):- Can be a comma-separated list of members role.
• member_type__in (string):- list only these members type ( Note: This parameter will work when member types exist.)
• member_type__not_in (string):- not list these members type ( Note: This parameter will work when member types exist.)
• search_terms (string):- Limit results by a search term. Default: value of `$_REQUEST[‘members_search’]` or `$_REQUEST[‘s’]`, if present. Otherwise false.

Example: [members-listing search_terms=’zoya’].

• meta_key (string):- Limit results by the presence of a user meta key. Default: false.
• meta_value (string):- When used with meta_key, limit results by matching the user meta value. Default: false. Requires meta_key.
• container_class (string):- Default ‘members’. Allows changing the class of the shortcode contents wrapper.

This shortcode can take the following parameters:

Examples:-

[members-listing per_page=3]

How many items you want to shows. The default is 10.

 [members-listing title=Wbcom_Design_Member]

This shortcode uses to show the title to the member list.

[members-listing include_member_role=’subscriber, admin’]

This shortcode used to displays the member list. and it accompanies a lot of parameters to customize which member is appeared and how they are spread out.

Following is the shortcode for group listing you can use this in your post and pages:

[groups-listing]

Here is the way you can specify options

[groups-listing option_name=option_val option_name2=option_val2 and so on]

Example: [groups-listing title=Group_Listing object=Groups per_page=3].

The accepted parameters:-

• title (string):- What should be the title of the group’s section.

Example: [groups-listing title=Group_Listing_title object=Groups per_page=2].

• type (string):- Shorthand for certain order by/order combinations. ‘newest’, ‘active’, ‘popular’, ‘alphabetical’, ‘random’. When present, it will override order by and order params. Default: null.
• order (string):- Sort order. ‘ASC’ or ‘DESC’. Default: ‘DESC’.

Example: [groups-listing title=Sort_Group_List object=Groups per_page=3 sort=ASC ].

• order by (string):- Property to sort by. ‘date_created’, ‘last_activity’, ‘total_member_count’, ‘name’, ‘random’. Default: ‘last_activity’.
• per_page (int|bool):- Number of items to return per page of results. Default: 20.

Example: [groups-listing per_page=1].

• max (int|bool):- Does NOT affect query. May change the reported number of total groups found, but not the actual number of found groups. Default: false.
• show_hidden (bool):- Whether to include hidden groups in results. Default: false.
• page_arg (string):- Query argument used for pagination. Default: ‘grpage’.
• include (int|string):- Single integer or comma-separated list of group IDs. Results will be limited to groups within the list. Default: false.
• exclude (int|string):- Single integer or comma-separated list of group IDs. Results will exclude the listed groups. Default: false.
• user_id (int):- If provided, results will be limited to groups of which the specified user is a member. Default: value of bp_displayed_user_id().
• scope=’personal’:- If provided, results will be limited to groups of the logged-in member.
• group_type (string):- Single group type or comma-separated list of group types to limit results to.
• search_terms (string):- If provided, only groups whose names or descriptions match the search terms will be returned. Default: value of `$_REQUEST[‘groups_search’]` or `$_REQUEST[‘s’]`, if present. Otherwise false.

Example: [groups-listing title=Search_Group_List search_terms=Big Bang posted an update ].

• parent_id (string|int):- Single group IDs or comma-separated list of group IDs. Results will include only child groups of the listed groups. Default: null.
• container_class (string):- Default ‘group’. Allows changing the class of the shortcode contents wrapper.

This shortcode can take the following parameters:

Examples:-

[groups-listing user_id=1]

This [groups-listing user_id=1] shortcode use to shows the list of the user groups.

[groups-listing per_page=1]

This [groups-listing per_page=1] shortcode shows a list of groups, and it accompanies a lot of parameters to customize which activity is appeared and how they are spread out.

[groups-listing search_terms=’wbcom design’]

This [groups-listing search_terms=’wbcom design’] shortcode uses to show list activities containing the search word “wbcom design”

Following is the shortcode for user’s notification listing you can use this in your post and pages:

[notifications-listing]

Here is the way you can specify options

[notifications-listing order=’ASC’ per_page=10 and so on]

For Example: [notifications-listing title=My_Notification_List order=’ASC’ per_page=2].

The accepted parameters:-

title (string):- What should be the title of the notifications section.

Example: [notifications-listing title=My_Notification_List per_page=2].

order (string):- Sort order. ‘ASC’ or ‘DESC’. Default: ‘DESC’.

Example: [notifications-listing order=’ASC’ per_page=3].

per_page (int|bool):- Number of items to return per page of results. Default: 20.

Example: [notifications-listing title=Notification_List per_page=1].

max (int|bool):- Does NOT affect query. May change the reported number of total notifications found, but not the actual number of found notifications. Default: false.
container_class (string):- Default ‘notification’ . Allows changing the class of the shortcode contents wrapper.

Examples:-

[notifications-listing per_page=2]

This shortcode used to show the number of the notifications list.

Well, guys, it’s up to you to explore the possibilities.