WordPress.org

Ready to get started?Download WordPress

Plugin Directory

WP Biographia

Add and display a customisable user biography to the front page, single post types, archives and RSS feeds as well as via a widget in your sidebar.

How do I get help or support for this plugin?

In short, very easily. But before you read any further, take a look at Asking For WordPress Plugin Help And Support Without Tears before firing off a question. In order of preference, you can ask a question on the WordPress support forum; this is by far the best way so that other users can follow the conversation. You can ask me a question on Twitter; I'm @vicchi. Or you can drop me an email instead. I can't promise to answer your question but I do promise to answer and do my best to help.

Is there a web site for this plugin?

Absolutely. Go to the WP Biographia home page for the latest information. There's also the official WordPress plugin repository page and the source for the plugin is on GitHub as well.

I've configured WP Biographia to display the user's image but it's not working; what's happening here?

User profile pictures, or avatars, are part of the WordPress core but enabling them isn't done at the level of the user profile, instead it's part of the way in which comments are configured. If you enable the display of the post user’s image, make sure avatar support is turned on; from the Dashboard, navigate to Settings / Discussion and ensure that Show Avatars is enabled. WordPress uses the email address that is part of your user's profile to look up the right avatar image from gravatar.com, so you need to ensure that you're using the same email address on your site as well as for your avatar.

I want to upload my user's images, host them on my web server and not use Gravatars; how do I do this?

WP Biographia uses the get_avatar pluggable function to output the user's avatar image. Theoretically, any plugin that supports locally hosted avatar images and which overrides the default WordPress implementation of get_avatar should be able to be used. In practice, whether this approach will work for you or not depends on the combination of the theme you're using and the interactions that the other plugins that you're using has with the WordPress core and with your theme. The Simple Local Avatars plugin plugs get_avatar and cooperates nicely with WP Biographia, at least in my local testing environment; your mileage may vary.

I've configured WP Biographia to show my website/Twitter/Facebook/etc links but I don't see them in the Biography Box; where do I define these links?

WP Biographia adds a number of social media and web link fields to your WordPress user profile; from the Dashboard, navigate to Users / Your Profile and enter the links you want displayed to the fields in the Contact Info section.

I've installed and configured WP Biographia and now I see not one but two differing Biography Boxes; what's going on?

There's probably one of two things going on here. Firstly, you've already got another plugin that makes a Biography Box installed and active and this plugin, as well as WP Biographia, are doing their job properly. Secondly, the theme you're using hard codes a Biography Box into the theme templates. Both the TwentyTen and TwentyEleven themes supplied as part of a standard WordPress install do this.

I only want to show the Biography Box for certain users and not for others; can I do this?

WP Biographia allows you to hide the Biography Box from being displayed on a per user basis. You can hide for posts only, for pages only or for both posts and pages. There's two ways of configuring this. If your user has the manage_options capability, you can choose the degree of hiding, if any, from your user profile or for any other user's profile; from the Dashboard, navigate to Users and check the Hide From Posts and/or Hide From Pages checkbox options. You can also configure this easily from the plugin's Settings And Options; from the Dashboard, navigate to the Settings / WP Biographia page, click on the Exclusions tab and under User Hiding Settings, add and/or remove the users to fit your model of who should have the Biography Box displayed.

I want to show the Biography Box for all users but only for certain categories; can I do this?

From the Dashboard, navigate to the Settings / WP Biographia page, click on the Exclusions tab and under Category Exclusion Settings, add and/or remove the categories to fit your model of when the Biography Box should be displayed.

How do I add HTML to the Biographical Info section of a user's profile?

In previous releases of the plugin, I've recommended that you add this code to your theme's functions.php file:

remove_filter('pre_user_description', 'wp_filter_kses');

But as WebEndev helpfully pointed out on the WordPress forums, this allows all HTML to be added to the Biography Info section of a user's profile, which may be going too far. The following code, in your theme's functions.php, will allow line breaks to be honoured but filter out any HTML tags and attributes which are not allowed by the $allowedposttags WordPress global.

remove_filter('pre_user_description', 'wp_filter_kses');
add_filter('pre_user_description', 'wp_filter_post_kses');
add_filter('pre_user_description', 'wptexturize');
add_filter('pre_user_description', 'wpautop');
add_filter('pre_user_description', 'convert_chars');
add_filter('pre_user_description', 'balanceTags', 50);

How do I remove the bio on pages using page templates?

Add this code to your theme's functions.php file:

add_action ('wp_head', 'remove_user_box_page_template');

function remove_user_box_page_template() {
  if (is_page_template ('page_blog.php'))
        add_filter ('wp_biographia_pattern' , 'content_only_pattern');
}

function content_only_pattern($pattern) {
    return '%1s';
}

I want to use my own icon set for my user's contact links; how do I do this?

Firstly select the icon set you want to use. You'll need to ensure that the icon files are in .png format and are named to match the icon set that WP Biographia ships with; take a look in wp-biographia/images to see the naming convention. Upload your icon set to your web server and note the URL (not the local path) to where your icons will live. Navigate to Settings / WP Biographia and click on the Content tab, ensure that the Use Alternate Icon Set option is checked and the URL to your alternate icons is specified in the Alternate Icon Set URL text box. By default, WP Biographia sizes the contact link icons at 32x32 pixels; you can override this in your local CSS file by redefining the .wp-biographia-item-icon CSS class (see wp-biographia/css/wp-biographia.css).

You can also override the icon file name and source URL on a per contact link basis via the $icon_url_dir parameter via the wp_biographia_link_items filter.

So to recap, the plugin uses its own default set of icons, followed by the Alternate Icon Set URL to allow you to point to an entire alternate set of icons, if the supplied ones aren't to your liking, followed by link specific overrides via the wp_biographia_link_items filter. The order of precedence looks something like ...

  1. the plugin's icon set - for all icons - typically this is /wp-content/plugins/wp-biographia/images.
  2. the alternate icon set - for all icons (even added via the filter, if no override takes place on $icon_url_dir)
  3. an override of the icon set URL for the single contact method you're adding via wp_biographia_link_items (assuming it's also added via wp_biographia_contact_info)

See the Filter Support And Usage section for more information on the plugin's filters.

I want to change the CSS used to format the Biography Box; how do I do this?

The HTML and CSS classes that the plugin emits follows a consistent structure and naming convention. See Hacking WP Biographia’s Appearance With CSS for more information.

I've changed the Biography Box CSS but my changes aren't showing up; what's happening?

WP Biographia uses minified CSS files to improve the speed at which a page loads. If you make changes to the plugin's CSS in /wp-content/plugins/wp-biographia/css/wp-biographia.css the plugin will still load the minified version in /wp-content/plugins/wp-biographia/css/wp-biographia.min.css. So if you make any site specific changes to the plugin's CSS, which isn't recommended (see Hacking WP Biographia’s Appearance With CSS), you'll need to ensure you (re)minify the master CSS to get the changes to be picked up by the plugin.

WP Biographia doesn't support social network FOO; can you add this to the next version?

Yes. But also no. One of the wonderful things about today's web is the vast amount of ways we have to interact with each other. I can't keep up. No, really. In practical terms, this would mean that the plugin's settings and options panels would soon get out of hand, plus the overhead of adding, testing and releasing a new version of the plugin would get out of hand before the settings and options do. But ... see the next FAQ for the answer.

WP Biographia doesn't support social network or contact method BAR; how can I add this?

With the cunning use of the filters that WP Biographia supports, you can add support for as many social networks and/or contact methods as you like. You'll need to do two things for each link you want to add to the plugin.

  1. In your theme's functions.php add support for the new link to the user's profile by way of the wp_biographia_contact_info filter.
  2. Still in your theme's functions.php add support for the new link to be displayed, with an icon if you wish, via the wp_biographia_link_items filter.

See the Filter Support And Usage section for a working example of these two filters to add support for a new contact link.

The "More Posts" link in the Biography Box links to my site's landing page and not an author's archive page; what's happening?

If you're using an SEO plugin, this might be optimising out the More Posts link. Specifically, Yoast's WordPress SEO plugin has this side effect as this plugin allows you to enable/disable author archive pages. Thankfully, the SEO plugin has a setting called Disable Author Archives that, if disabled, allows WP Biographia to successfully link to an author's archive page.

The Biography Box is showing up in places it shouldn't; such as the footer or within widgets in the sidebar; why is this happening and how can I stop this?

Why is this happening? Some themes or plugins use the WordPress the_content and/or the_excerpt filters as part of a secondary query to select posts or pages to show as content in the theme's sidebars, footers or as part of a plugin's widget. As WP Biographia also uses these filters to add the Biography Box, this means that the Biography Box can sometimes show up unexpectedly, in places where it shouldn't be.

How can I stop this? You can lock the plugin to run only in the context of the main WordPress Loop; in other words, WP Biographia will run when selecting posts or pages to be displayed on your site's landing page, archive pages or any other template, but not when run in the context of a secondary query loop in a sidebar or footer. From the Dashboard, navigate to Settings / WP Biographia / Admin / Content And Excerpt Settings and ensure that the Lock Display Of The Biography Box To The Main Loop setting is checked.

My site features guest posts; can I override my contributor account's biography for each of my guest authors?

Yes. Firstly you'll need to enable post specific overrides in the plugin. From the Dashboard, navigate to Settings / WP Biographia / Admin / Biography Box Override Settings and ensure that the Enable Post Specific Overrides setting is checked.

Now edit a post or a page. In the Biography Box Post Options meta-box (for posts), or the Biography Box Page Options meta-box (for pages), you'll find that four new settings are now visible.

  • Override Biography Text For This Post - checking this setting will show a text box, pre-populated with the currently logged in user's biography, which can be overriden. If you want to revert to the currently logged in user's biography, clicking on the Reload Default Profile Biography will reset your changes.
  • Override Biography Title For This Post - checking this setting will show a text box that can be used to override the default Biography Box title.
  • Suppress Avatar For This Post - checking this setting will stop the post or page's author's avatar from being displayed as part of the Biography Box.
  • Suppress Contact Links For This Post - checking this setting will stop the contact links being displayed as part of the Biography Box.

All of the above settings are post or page specific; in other words they will only override the post or page that is currently being edited.

The thinking behind these settings is that if you have guest posts, you'll probably have one or more accounts with a contributor role. That account's biography text, avatar or contact links won't make much sense in the context of a guest post, so you can override them or suppress them in a way which does not impact the Biography Boxes produced for other users on your site.

WP Biographia isn't available in my language; can I submit a translation?

WordPress and this plugin use the gettext tools to support internationalisation. The source file containing each string that needs to be translated ships with the plugin in wp-biographia/lang/src/wp-biographia.po. See the I18n for WordPress Developers page for more information or get in touch for help and hand-holding.

This plugin looks very much like the WP About Author; what's the connection?

Version 1 of WP Biographia was inspired by and based on the WP About Author plugin by Jon Bishop. Thanks and kudos must go to Jon for writing a well structured, working WordPress plugin released under a software license that enables other plugins such as this one to be written or derived in the first place. Jon's written other WordPress plugins as well; you should take a look.

I want to amend/hack/augment this plugin; can I do the same?

Totally; like the original plugin by Jon, this plugin is licensed under the GNU General Public License v2 (GPLV2). See http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt for the full license terms.

Where does the name WP Biographia come from?

WP Biographia is named after the etymology of the modern English word biography. The word first appeared in the 1680s, probably from the latin biographia which itself derived from the Greek bio, meaning "life" and graphia, meaning "record" or "account" which derived from graphein, "to write".

Requires: 3.7 or higher
Compatible up to: 3.7.0
Last Updated: 2013-10-25
Downloads: 47,483

Ratings

4 stars
4.8 out of 5 stars

Support

0 of 6 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,3,3 100,3,3
50,2,1 100,1,1 100,1,1 100,1,1
100,5,5 50,2,1 100,1,1 75,4,3 100,2,2 100,1,1
100,1,1 100,1,1
0,1,0
100,2,2 100,3,3 100,1,1
100,1,1
100,3,3
100,1,1
50,2,1
100,1,1
0,1,0 100,1,1
100,1,1
100,1,1
100,1,1
100,1,1