WordPress.org

Ready to get started?Download WordPress

Plugin Directory

BuddyMenu BuddyLinks

BuddyPress menu widget and menu shortcode. Does three things really well: BuddyPress menu widget, BuddyPress menu shortcode and BuddyPress dynamic lin

Instructions

BuddyMenu Widget

  1. Go to Appearance > Settings
  2. Find the BuddyMenu widget
  3. Drag it into a widget area
  4. Configure the menus to display, their titles, their icons and whether to display the menu horizontally or vertically.

This menu is not visible to visitors who are not logged in.

BuddyMenu Shortcode

BuddyMenu Shortcode displays a vertical or horizontal menu. You can change the anchor text of each menu tab. The link title tooltip will always be the same as the anchor text. Any of the menu tabs can be disabled. This menu is not visible to visitors who are not logged in.

New in version 2: Customize the menu icons

Enter the shortcode in any page, post or widget area (if you are set up to use shortcodes in widget areas).

The shortcode for the menu is:

[buddymenu]

The basic options/attributes are:

  1. bmact="" to change the activity tab
  2. bmfor="" to change the forum tab
  3. bmfri="" to change the friends tab
  4. bmmsg="" to change the messages tab
  5. bmpro="" to change the profile tab
  6. bmedpro="" to change the edit profile tab
  7. bmchav="" to change the change avatar tab
  8. bmset="" to change the settings tab
  9. bmlay="" to change the layout from horizontal to vertical

If no option is set, the full menu is displayed as a horizontal row. For example, using [buddymenu] will display the full menu where the shorcode is placed.

Setting any option to -1 will disable that option's menu item.

Any text entered within the quotes of an option will become the link anchor text and the link title for that option's menu item.

For example,

To show the full menu horizontally:

[buddymenu]

To show the full menu as a vertical list:

[buddymenu bmlay="vertical"]

To show the menu without the activity tab:

[buddymenu bmact="-1"]

To show the menu with the message tab text changed to Inbox:

[buddymenu bmmsg="Inbox"]

To show a horizontal menu with the settings tab changed to Configs:

[buddymenu bmset="Configs" bmlay="horizontal"]

This menu is very useful in horizontal widget areas in multilingual environments.

The icon customization attributes are:

  1. bmacti="" sets the activity icon.
  2. bmfori="" sets the forum icon.
  3. bmfrii="" sets the friends icon.
  4. bmmsgi="" sets the messages icon.
  5. bmproi="" sets the profile icon.
  6. `bmedproi="" sets the edit profile icon.
  7. `bmchavi="" sets the change avatar icon.
  8. bmseti="" sets the settings icon.
  9. `bmicons="0" Disables all icons.

Put the URL to any image into an link icon attribute to use that image as the icon for that link.

For example,

[buddymenu bmicons="0"] Disables all icons.

[buddymenu bmacti="http://example.com/icon.png"] Will replace the default activity icon with the image at http://example.com/icon.png.

BuddyLinks

The BuddyLinks shortcode provides a stub URL that is dynamically generated by BuddyPress. This URL looks like example.com/members/[USERNAME]/. You need to provide the path that follows the username (represented by the asterisk in this case).

This shortcode is good for putting links to your network users' pages in the content of your pages and posts.

None logged in users see the text "login to view this link" which links to the WordPress login page. This text link is configurable.

BuddyLinks has four main options/attributes:

  1. bllink="" for setting the link
  2. bltitle="" for setting the tooltip title
  3. bltext="" for setting the anchor text that users click
  4. blicon="" for configuring an icon for the link

If you provide no attributes, the shortcode returns a link to a user's profile page with the anchor text "your profile", no tool-tip title and no icon.

blicon=""

can be used to display a custom icon or an icon from the plugin's default icon set. Accepted values are activity, friends, messages, profile, edit-profile, avatar and settings or any URL to an image.

For example,

To link to a logged in user's activity page:

[buddylink bmlink="activity" bltext="your activity page"]

To link to a logged in user's message inbox:

[buddylink bmlink="messages/inbox" bltext="view your inbox"]

To link to a logged in user's message inbox with an icon accompanying the link:

[buddylink bmlink="messages/inbox" bltext="view your inbox" blicon="messages"]

There are three options for controlling what non logged in users see:

  1. blolink="" for setting the link
  2. blotitle="" for setting the title
  3. blotext="" for setting the anchor text

By default, a non logged in user will see a link to your site's login/registration page. To change that destination you could do something like this:

[buddylink bmlink="messages/inbox" bltext="view your inbox" blolink="http://example.com/reasons-to-register" blotext="reasons to register"]

QuickLinks

BuddyLinks has quicklinks built into it to facilitate quick placement of links to common BuddyPress areas.

Used with the [buddylink] shortcode, the options are:

  1. blq="act" to link to 'activity'
  2. blq="for" to link to 'forums'
  3. blq="fri" to link to 'friends'
  4. blq="msg" to link to 'messages'
  5. blq="pro" to link to 'profile'
  6. blq="edpro" to link to 'edit profile'
  7. blq="chav" to link to 'change avatar'
  8. blq="set" to link to 'settings'

Quicklinks can be used in conjuction with the blicon="" attribute.

For example,

To link to a user's activity page:

[buddylink blq="act"]

To link to a user's activity page and print a custom message to non logged in users:

[buddylink blq="act" blotext="You can't go here because you're not logged in!"]

QuickLinks do not accept custom title and link attributes except for those intended for non logged in users.

FAQ

I'm getting a space between the BuddyLink and my punctuation marks, why is this?

This is a known bug with BuddyLinks. I am working on a fix. In the meantime, put the punctuation (fullstop, period, comma) in the bltext="" attribute. For example, bltext="click here." instead of bltext="click here".

Contact

[General support]http://journalxtra.com/websiteadvice/wordpress/use-buddypress-dynamic-links-in-your-network-with-buddymenu-buddylinks/ and [Commercial support]http://vizred.com/

Supported Languages

  • English

Requires: 3.0 or higher
Compatible up to: 3.7.1
Last Updated: 2013-10-25
Downloads: 6,047

Ratings

5 stars
5 out of 5 stars

Support

0 of 1 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,1,1
100,3,3 100,3,3
100,1,1