The BuddyPress Activity shortcode plugin allows you to insert a BuddyPress activity stream on any page/post using a shortcode. It has a lot of flexibility built into the shortcode.
With the BuddyPress Activity Shortcode Plugin, site administrators can customize the display of the activity feed using a variety of options, including the number of items to display, the type of activity to show, and the display format. Shortcodes can be easily inserted into any page or post using the WordPress editor, and the activity feed will be displayed wherever the shortcode is placed.
The plugin is easy to use and configure and can be customized to suit the needs of different communities and users. It can be downloaded and installed like any other WordPress plugin, and once activated, users can start using the shortcode to display their BuddyPress activity feed on any page or post.
You can customize almost all aspects of the activity list, including what should be listed, how many, and everything using the shortcode.
Let’s have a look at all the features of the plugin
- List all activities
- List activities for a user
- List activities for a group
- List activities of specific user roles.
- Allow users to post from the pageAll options supported by
BuddyPress Activity Shortcode
The BuddyPress Activity Shortcode plugin allows you to embed BuddyPress activities in posts/pages using shortcodes.
Once the plugin is installed and activated you are able to enter the shortcode [activity-stream] in any page or post and the output will return the last five items in the site’s activity stream.
The Activity Stream shortcode comes with a number of options that give it great flexibility in the range of activity items it can display:
Here is a sample use example
[activity-stream]
That will list the most recent 5 activities.
Here is the way you can specify options
[activity-stream option_name=option_val option_name2=option_val2 and so on]
The accepted parameters:-
- title(string):- what should be the title of the activities section
- pagination(int):- 0 or 1(do you want to hide or show the activity pagination at the bottom of the list)
- display_comments(string, int):- possible values are threaded|stream|0(use 0 to hide activity comments)
- include(int|string):- individual activity id or comma-separated list of activities, useful in case you want to list specific activities
- exclude(int|string):-individual activity id or comma-separated list of activities, useful in case you want to exclude specific activities from the list
- sort(string):- ASC|DESC (how to sort the activities in ascending or descending order)
- page (int):- which page to load, e.g 1st page or 10th page of activity
- per_page(int):- How many activities per page(default is 5)
- load_more(int) :- 0 or 1. Use a load more button for loading the activities in the current context.
- max(int):- Limit the maximum no. of activities to be included in the list
- scope(string):- – pre-built activity filters for a user (possible values are friends/groups/favorites/mentions)
- user_id(int):- If you want to list a particular user’s activity
- for(string):- User type you want to display for. Possible values ‘logged’, ‘displayed’, ‘author’.
- role(string):- One of more WordPress roles. eg. ‘administrator’ or ‘administrator, editor’. It will filter the activity and list for the given roles only.
- object(string):- object to filter on e.g. groups, profile, status, friends(what type of activity is this)
- for_group(string):- specify a group slug. Only valid if the object=groups is specified
- 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.
- 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 with 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 the 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 shortcode. It is suggested to change it if hide_on_activity=0 is set.
Different Examples to show the shortcode
List all activities of a user with user_id=24: Using this shortcode we are able to display the activities of a particular user on a single page.
[activity-stream user_id=24]
List all activities of the administrator: Here on writing this code we are able to see all the activities of the admin
[activity-stream role=administrator]
List activities of administrator and editor: Through this, we are able to see all the posts of the administrator and editor also.
[activity-stream role=” administrator, editor”]
List 10 recent activities per page:-By writing this code we are able to see the 10 posts on a single page or as many activities as we want to show on a single page.
List activities containing the word “awesome”: Using this shortcode we are able to see the activities containing a particular word
[activity-stream search_terms=’awesome’]
Note: Above plugin will not work if the youzify plugin is installed
Conclusion
I have used this plugin on a few sites and find it particularly useful for the creation of special pages that include different views of activities. I give this plugin 9 out of 10, overall it does what it says however I do find it to be a bit complex to use when looking at advanced options.
Interesting Reads: