BuddyPress BuddyLinks does three things really well:
BuddyPress BuddyLinks does three things really well:
Put a BuddyPress menu or dynamic user link in your sidebar, post, page, widget, footer or anywhere else. Needs BuddyPress to work. There is no need to network activate in WP Multisite. Does not display to logged out users.
BuddyPress menus are dynamic. Their URLs change for each logged in user. This makes it difficult for most community admins and webmasters to add links to areas in their BuddyPress sites. Unless you know how, you can’t create a welcome page and send new users to their profile page with a link in the welcome page because the link will be different for each user.
For example, a link to a user’s own activity stream would look like http://example.com/members/[USERNAME]/activity/.
The [USERNAME] bit of the URL is added dynamically by BuddyPress. This means you need to use pictures, videos, diagrams and lots of text to send people to different locations within a BP site or you can use the widget and shortcodes this BuddyMenu BuddyLinks provides.
See ‘Other Notes’ section usage guide.
The BuddyMenu Widget displays the main BP menus items:
As easy to use as going to Appearance > Widgets and dragging the BuddyMenu widget into your sidebar or any other widget area.
BuddyMenu Shortcode displays the BuddyPress menus tabs. Being a shortcode, it can be embedded in any page or post. If you use Ultimate TinyMCE you can even put the shortcode in a widget.
This is for adding single links within page and post content. Ideal for linking to a user’s profile, settings, personal activity stream or any other other BuddyPress page from within a post. For example, you’ve written a getting started guide for new members and you want to send them to upload an avatar; you can use the BuddyLinks shortcode to link to new users’ avatar upload page. The dynamic slug is created by BuddyLinks.
BuddyLinks Features
This menu is not visible to visitors who are not logged in.
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:
bmact=""
to change the activity tabbmfor=""
to change the forum tabbmfri=""
to change the friends tabbmmsg=""
to change the messages tabbmpro=""
to change the profile tabbmedpro=""
to change the edit profile tabbmchav=""
to change the change avatar tabbmset=""
to change the settings tabbmlay=""
to change the layout from horizontal to verticalIf 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:
bmacti=""
sets the activity icon.bmfori=""
sets the forum icon.bmfrii=""
sets the friends icon.bmmsgi=""
sets the messages icon.bmproi=""
sets the profile icon.bmseti=""
sets the settings icon.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.
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:
bllink=""
for setting the linkbltitle=""
for setting the tooltip titlebltext=""
for setting the anchor text that users clickblicon=""
for configuring an icon for the linkIf 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:
blolink=""
for setting the linkblotitle=""
for setting the titleblotext=""
for setting the anchor textBy 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”]
BuddyLinks has quicklinks built into it to facilitate quick placement of links to common BuddyPress areas.
Used with the [buddylink] shortcode, the options are:
blq="act"
to link to ‘activity’blq="for"
to link to ‘forums’blq="fri"
to link to ‘friends’blq="msg"
to link to ‘messages’blq="pro"
to link to ‘profile’blq="edpro"
to link to ‘edit profile’blq="chav"
to link to ‘change avatar’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.
[General support]http://journalxtra.com/websiteadvice/wordpress/use-buddypress-dynamic-links-in-your-network-with-buddymenu-buddylinks/
and
[Commercial support]http://vizred.com/
None yet.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".