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.
This plugin allows you to add a customisable biography to posts, to RSS feeds, to pages, to archives and to each post on your blog’s landing page as well as via a widget in your sidebar. It integrates out of the box with the information that can be provided in each user’s profile and supports custom post types. Display of the Biography Box can be hidden on a global or per user basis for posts, pages and custom post types as well as on a per category basis.
Settings and options include:
The plugin expands and enhances the Contact Info section of your user profile, adding support for Twitter, Facebook, LinkedIn, Google+, Delicious, Flickr, Picasa, Vimeo, YouTube and Reddit profile links as well as Yahoo! Messenger, AIM, Windows Live Messenger and Jabber/Google Talk instant messaging profiles. Your Contact Info links can then be displayed as part of the Biography Box, either as plain text links or as icon links. Further contact links can easily be added to the Biography Box by using the wp_biographia_contact_info
and wp_biographia_link_items
filters.
The position of the Biography Box can be controlled by the plugin’s supported settings and options, or manually via the plugin’s shortcode ([wp_biographia]
) (see the Shortcode Support And Usage section for more information) or via template tags in your theme’s template files (see the Template Tags section for more information).
The position and content of the Biography Box, including adding support for new contact links, changing the content of the Biography Box when displayed via the shortcode, the format of the contact links and the overall format of the Biography Box can be modified by the plugin’s filters. See the Filter Support And Usage section for more information.
The plugin also supports displaying a reduced version of the Biography Box via a sidebar widget and provides a shorter, more terse, biography in the user’s Profile to prevent the full length biography text taking up too much space on the sidebar.
WP Biographia supports a single shortcode, [wp_biographia]
. Adding this shortcode to the content of a post or page or into a theme template as content, expands the shortcode and replaces it with a Biography Box.
The shortcode also supports multiple attributes which allow you to customise the way in which the shortcode is expanded into the Biography Box:
mode
attributeuser
attributeauthor
attribute (deprecated)role
attributeorder
attributeprefix
attributename
attributetype
attributeIn raw
mode, which is the default (specified as [wp_biographia mode="raw"]
or simply as [wp_biographia]
), the plugin inserts the Biography Box in you’ve asked for it, you’ve got it mode.
Or to put it another way, the plugin will honour the settings that you specify under Dashboard / Settings/ WP Biographia for Biography Box Style Settings and for Biography Box Content Settings but will ignore the Biography Box Display Settings and Biography Box Per User Settings.
In configured
mode, specified as [wp_biographia mode="configured"]
, the plugin inserts the Biography Box and will honour all the settings under Dashboard / Settings / WP Biographia with the exception of Display On Front Page, Display On Individual Post, Display On Post Archives and Display On Individual Pages, as well as their equivalents for any custom post types you may have created.
The thinking behind this is that you probably want to honour post or page exclusions and per user exclusions, but by using the shortcode in your posts, you want to be in control of how and where the Biography Box is displayed.
If the user
attribute is omitted, which is the default, the shortcode assumes it’s being used within the WordPress Loop and will display the Biography Box once for the current post’s, page’s or custom post type’s user.
Specifying a user’s login name as the user
attribute overrides this behaviour and allows multi-user sites to use the plugin to create a contributors page, where you use the shortcode as [wp_biographia user="login-name"]
once for each of your site’s users that you want to appear, replacing "login-name"
with a valid login name for one of your users.
You call also use the user
attribute in wildcard mode, specifying the user’s login name as *
as [wp_biographia user="*"]
; this will then loop over all of the users that have logins on your site, displaying the Biography Box once for each user, ordered alphabetically by login name.
Specifying an invalid login name ([wp_biographia user="idontexist"]
) will result in no Biography Box being displayed. Specifying an empty login name ([wp_biographia user=""]
) will cause the user
attribute to be ignored and may result in undefined behaviour, such as a partially populated Biography Box being displayed as the shortcode is being used outside of the Loop and thus no user information is made available to the plugin by WordPress.
The author
attribute is now deprecated in favour of the user
attribute introduced in v3.2.0 of the plugin. If the author
attribute is used and no user
attribute is present, the author
attribute will act in the same way as the user
attribute, described above. If both the user
and author
attributes are present, the author
attribute will be ignored in favour of the user
attribute.
In other words, if you use the shortcode and supply both the author
and user
attributes, such as [wp_biographia author="foo" user="bar"]
, the Biography Box will be displayed for the user bar
, not the user foo
. Likewise, [wp_biographia user="*" author="foo"]
will display the Biography Box in wildcard mode, not for the user foo
.
Support for the author
attribute will be likely be removed in a future release of the plugin to avoid confusion over the author
and user
attributes.
Valid only when used in conjunction with the user
attribute in wildcard mode, the role
attribute allows you to filter the users that have user accounts on your blog according to their WordPress Role. The role
attribute takes one or more comma separated arguments which define the WordPress role(s); at the time of writing, these can be one of:
administrator
editor
author
contributor
subscriber
For example, if you want to display the Biography Box for all users of your blog who have a role of author
you can use the role
attribute plus the author
attribute in wildcard mode to do this, along the lines of [wp_biographia user="*" role="author"]
. If you want to display the Biography Box for all users with a role of author
or contributor
, you can specify both roles, along the lines of [wp_biographia user="*" role="author,contributor"]
.
Specifying an invalid role ([wp_biographia user="*" role="foo"])
will result in no Biography Box being displayed. Specifying the role
attribute without the user
attribute in wildcard mode will have no effect.
Valid only when used in conjunction with the user
attribute in wildcard mode, the order
attribute allows you to specify the display order for the users that have user accounts on your blog. The order
attribute takes a single argument which defines the sorting order; at the time of writing, this can be one of:
account-name
(the default)first-name
last-name
nickname
display-name
login-id
For example, if you want to display the Biography Box for all users of your blog ordered according to their last name you can use the order
attribute plus the author
attribute in wildcard mode to do this, along the lines of [wp_biographia user="*" order="last-name"]
.
Specifying an invalid role ([wp_biographia user="*" order="foo"])
will result in the default account name sort order being used. Specifying the order
attribute without the user
attribute in wildcard mode will have no effect.
It’s important to note that the in order to successfully sort by first-name
or by last-name
, the First Name and/or Last Name fields must be populated in each user’s Profile; by default, these fields are not populated during the creation of a user’s WordPress account. The sorting of the user accounts when the order
attribute is specified uses natural order string comparison, which means than an empty First Name or Last Name will appear before a First Name or Last Name which actually contains a value. If your WordPress site doesn’t have these name fields populated in your user’s Profiles, you may not see the sorting results you expect.
If the prefix
attribute is omitted, which is the default, the Biography Box will be displayed with Biography Prefix text configured in Settings/ WP Biographuia / Biography Box Content Settings before the user’s name. This can be overridden by using the prefix
attribute, along the lines of [wp_biographia prefix="All About"]
.
If the name
attribute is omitted, which is the default, the Biography Box will be displayed with the user’s name as configured by User’s Name in Settings / WP Biographia /Biography Box Content Settings. This can be overriden by supplying one of the following for the name
attribute’s argument:
account-name
first-last-name
nickname
display-name
none
If the type
attribute is omitted, which is the default, the Biography Box will be displayed with the user’s full biography text, taken from the Biographical Info field in the user’s profile. If the type
attribute is specified with a value of full
, this is equivalent to the default behaviour. If the type
attribute is specified with a value of excerpt
, the Biographical Excerpt field in the user’s profile will be used instead, providing the user has filled out this field in their profile. Specifying an invalid type
attribute value ([wp_biographia type="foo"]
) will result in the default behaviour of the full biography being used.
WP Biographia supports multiple filters, which are described in more detail below. The plugin’s filters allow you to:
the_content()
and/or the_excerpt()
[wp_biographia]
shortcodeApplied to the default set of plugin settings and options. Note that this filter is called once, upon plugin activation, when there are no WP Biographia settings/options existing in the database.
Example: Add the date and time that the plugin was first activated
add_filter ('wp_biographia_default_settings', 'add_activation_timestamp'); function add_activation_timestamp ($options) { // options = array (option name => option value) $options['plugin_activation_timestamp'] = date (DATE_ATOM); return $options; }
Applied to the default set of contact information fields that are added to an user’s profile by the plugin. Note that in order to add and display a new contact link to the Biography Box, the contact link must be added to the value returned by the wp_biographia_link_items
filter as well as the value returned by this filter.
Example: Add Pinterest as a supported contact information field
add_filter ('wp_biographia_contact_info', 'add_pinterest_support'); function add_pinterest_support ($contacts) { // contacts = array (field => array (field => field-name, contactmethod => description)) $contacts['pinterest'] = array ( 'field' => 'pinterest', 'contactmethod' => __('Pinterest') ); return $contacts; }
Applied to the default set of contact links that are added to the Biography Box by the plugin. Note that in order to add and display a new contact link, the contact information field must be added to the value returned by the wp_biographia_contact_info
filter as well as the value returned by this filter. Note that $icon_dir_url
will by default contain the URL of the images directory within the plugin directory, which will look something like /wp-content/plugins/wp-biographia/images/
(the trailing slash is important). If an alternate icon directory has been specified in the plugin’s settings and options, then $icon_dir_url
will contain this alternate, configured, directory URL. If the icon you want to add for a new contact link doesn’t reside in the directory URL mentioned previously, you’ll need to set $icon_dir_url
to point to your own custom location.
Example: Add Pinterest as a supported contact link in the Biography Box
add_filter ('wp_biographia_link_items', 'add_pinterest_link', 2); function add_pinterest_link ($links, $icon_dir_url) { // links = array (field => array (link_title => title, link_text => text, link_icon => URL) $links['pinterest'] = array ( 'link_title' => __('Pinterest'), 'link_text' => __('Pinterest'), 'link_icon' => $icon_dir_url . 'pinterest.png' ); return $links; }
Applied to the format string used to position the Biography Box before the post content or after the post content that is returned by the_content()
and/or the_excerpt()
.
Example: Insert a header between post content and Biography Box
add_filter ('wp_biographia_pattern', 'insert_biography_header'); function insert_biography_header ($pattern) { return '%1$s<p class="biography-header">About The User</p>%2$s'; }
Allows display of the Biography Box to be hidden under user-defined circumstances. This only affects the display of the Biography Box that is configured via the plugin’s admin screen or via the shortcode in configured mode.
Example: Hide the Biography Box
add_filter ('wp_biographia_pre', 'hide_biography_box'); function hide_biography_box ($flag) { return true; }
Applied to the current instance of the Biography Box that is produced via the [wp_biographia]
shortcode.
Example: Apply shortcode specific CSS to the Biography Box
add_filter ('wp_biographia_links', 'add_shortcode_css', 10, 2); function add_shortcode_css ($content, $params) { // params = array (mode => shortcode-mode, user => author-id, prefix => prefix-string, name => name-option) return '<div class="custom-shortcode-css">' . $content . '</div>'; }
Applied to the title of the Biography Box.
Example: Override the name prefix for all uses of the Biography Box.
add_filter ('wp_biographia_content_title', 'override_name_prefix', 10, 3); function override_name_prefix ($content, $name_prefix, $formatted_name) { return 'This is ' . $formatted_name; }
Applied to the formatted set of contact links for the current instance of the Biography Box.
Example: Replace the default text link separator character (the pipe symbol “|”) with a dash (“-“).
add_filter ('wp_biographia_links', 'replace_link_separator', 10, 3); function replace_link_separator ($content, $links, $params) { // links = array (link-item) // params = array (glue => separator-string, class => link-item-css-class-name, // prefix => links-prefix-html, postfix => links-postfix-html) return str_replace ($params['glue'], ' - ', $content); }
Example: Wrap the formatted content links in an additional HTML div.
add_filter ('wp_biographia_links', 'wrap_links', 10, 3); function wrap_links ($content, $links, $params) { // links = array (link-item) // params = array (glue => separator-string, class => link-item-css-class-name, // prefix => links-prefix-html, postfix => links-postfix-html) $new_prefix = '<div class="custom-link-class">' . $params['prefix']; $new_postfix = $params['postfix'] . '</div>'; return $new_prefix . implode ($params['glue'], $links) . $new_postfix; }
Applied to each active contact link, in the order in which they are processed by the plugin.
Example: Force all links that point to the current site to open in a new window.
add_filter ('wp_biographia_link_item', 'filter_link_item', 10, 2); function filter_link_item ($content, $params) { // $params = array ( // 'type' => 'link type (icon|text)', // 'format' => 'link format string', // 'meta' => 'additional anchor attributes', // 'title' => 'link title', // 'url' => 'link URL', // 'body' => 'link body text', // 'link-class' => 'link CSS class name', // 'item-class' => 'link item CSS class name (icons only)' // ); $site_url = site_url (); $pos = strpos ($params['url'], $site_url); if ($pos !== false) { $params['meta'] = 'target="_blank"'; } if ($params['type'] === 'icon') { $content = sprintf ($params['format'], $params['url'], $params['meta'], $params['title'], $params['link-class'], $params['body'], $params['item-class']); } else { $content = sprintf ($params['format'], $params['url'], $params['meta'], $params['title'], $params['link-class'], $params['body']); } return $content; }
Applied to the current instance of the Biography Box that is produced via the site’s RSS feed.
Example: Apply RSS feed specific CSS to the Biography Box
add_filter ('wp_biographia_feed', 'add_feed_css'); function add_feed_css ($content) { return '<div class="custom-feed-css">' . $content . '</div>'; }
Applied to the entire content of the current instance of the Biography Box.
Example: Remove all WP Biographia CSS classes commencing wp-biographia-
and replace them with custom CSS classes that adhere to the plugin’s CSS class naming convention.
add_filter ('wp_biographia_biography_box', 'replace_css_classes', 10, 2); function replace_css_classes ($biography, $items) { $new_content = array (); foreach ($items as $item) { $new_content[] = str_replace ('wp-biographia-', 'custom-', $item); } return implode ('', $new_content); }<h3>Template Tags</h3>
WP Biographia supports two template tags that can be used in your theme’s template files. These are described in more detail below; for a full description of the use of each tag’s argument, see the Shortcode Support And Usage section. The plugin’s tags allow you to:
Description: Retrieves the Biography Box. This template tags renders the Biography Box and returns it to the caller as a string. To display the Biography Box immediately, use the wpb_the_biography_box
template tag.
Usage:
<?php $biography_box = wpb_get_biography_box ($mode, $user, $prefix, $name, $role, $type, $order); ?>
Parameters:
$mode
– (string) (optional) Override the Biography Box mode (raw
|configured
). Default: raw
.$user
– (string) (optional) Override the source user (login-name
|*
). Default: the current user’s login name.$prefix
– (string) (optional) Override the Biography Box title prefix. Default: use the plugin’s settings.$name
– (string) (optional) Override the selected user’s name format (account-name
|first-last-name
|nickname
|display-name
|none
). Default: use the plugin’s settings.$role
– (string) (optional) Override the selected user’s role when used in wildcard mode. Specify one or more of the following, as a comma separated list (administrator
|editor
|author
|contributor
|subscriber
). Default: none.$type
– (string) (optional) Override the type of the biography text (full
|excerpt
). Default: use the plugin’s settings.$order
– (string) (optional) Override the sort order when used in wildcard mode (account-name
|first-name
|last-name
|nickname
|display-name
|login-id
). Default: account-name
.Description: Displays the Biography Box. This template tags renders the Biography Box and displays it immediately. To get the current Biography Box as a string, use the wpb_get_biography_box
template tag.
Usage:
<?php wpb_the_biography_box ($mode, $user, $prefix, $name, $role, $type, $order); ?>
Parameters:
$mode
– (string) (optional) Override the Biography Box mode (raw
|configured
). Default: raw
.$user
– (string) (optional) Override the source user (login-name
|*
). Default: the current user’s login name.$prefix
– (string) (optional) Override the Biography Box title prefix. Default: use the plugin’s settings.$name
– (string) (optional) Override the selected user’s name format (account-name
|first-last-name
|nickname
|display-name
|none
). Default: use the plugin’s settings.$role
– (string) (optional) Override the selected user’s role when used in wildcard mode. Specify one or more of the following, as a comma separated list (administrator
|editor
|author
|contributor
|subscriber
). Default: none.$type
– (string) (optional) Override the type of the biography text (full
|excerpt
). Default: use the plugin’s settings.$order
– (string) (optional) Override the sort order when used in wildcard mode (account-name
|first-name
|last-name
|nickname
|display-name
|login-id
). Default: account-name
.wp-biographia
folder to the wp-content/plugins
folder on your web server.manage_options
capability can edit their profile via Users / Your Profile from the Dashboard to hide the display of the Biography Box on posts and/or on pages and also the profiles of other users via the Users / All Users / Edit from the Dashboard.Settings and Options: Display Tab
Settings and Options: Admin Tab - New User Settings
Settings and Options: Admin Tab - User Profile Settings
Settings and Options: Admin Tab - Content and Excerpt Settings
Settings and Options: Admin Tab - Biography Box Override Settings
Settings and Options: Exclusions Tab - Post, Page and Custom Post Type Exclusion and Category Exclusion Settings
Settings and Options: Exclusions Tab - User Hiding Settings
Settings and Options: Style Tab
Settings and Options: Content Tab
Settings and Options: Content Tab, continued
Settings and Options: Defaults Tab
Settings and Options: Colophon Tab - Colophon
Settings and Options: Colophon Tab - Plugin Configuration Settings
Post Install and Upgrade: What's New Pointer
Plugin Tour Pointer: Display Tab
Plugin Tour Pointer: Admin Tab
Plugin Tour Pointer: Exclusions Tab
Plugin Tour Pointer: Style Tab
Plugin Tour Pointer: Content Tab
Plugin Tour Pointer: Defaults Tab
Plugin Tour Pointer: Colophon Tab
Settings and Options: Contact link verification in a user's profile
Edit Post: Biography Box Post Options meta-box
Sample Biography Box; Contact links shown as text
Sample Biography Box; Contact links shown as icons
Widget Settings and Options
Sample Widget Output
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.
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.
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.
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.
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.
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.
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.
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.
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);
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'; }
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 32×32 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 …
/wp-content/plugins/wp-biographia/images
.$icon_url_dir
)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.
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.
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.
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.
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.
functions.php
add support for the new link to the user’s profile by way of the wp_biographia_contact_info
filter.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.
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.
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.
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.
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.
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.
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.
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.
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”.
The current version is 4.0.0 b1 (2018.12.20)
WP_DEBUG
or WPBIOGRAPHIA_DEBUG
are defined and set to true
.wp_biographia_content_title
filter; allow the Biography Boxes’s title to be changed.simple_local_avatars
filter to fixup the avatar’s CSS; hook into both simple_local_avatars
and get_avatars
to support site with mixed Gravatars and locally hosted avatars.order
attribute; allow custom sort orders when in wildcard mode.wpb_get_biography_box
and wpb_the_biography_box
.the_content
or the_excerpt
are used as part of themes or other plugins.wp_biographia_link_item
filter; allow the constituent elements of each contact link to be overriden.$wp_roles
and not against a hard-coded roles list.includes
directory.WP_DEBUG
is set to true
or if WPBIOGRAPHIA_DEBUG
is defined.wpautop
via the the_content
and the_excerpt
filters to ensure these filters fire before the Biography Box is produced when the plugin’s filter priority is less than the default filter priority to avoid formatting issues for contact links.user
attribute; deprecating support for the author
attribute.wp_biographia_feed
filter in readme.txt
.wp_biographia_feed
filter was never called in the context of a feed.role
attribute to further filter display of users when the shortcode is used in wildcard mode.the_content
and the_excerpt
can now be individually defined to cope with priority clashes with other themes and plugins which use these filters.wp_biographia_category_exclusions
setting was not defined in the database upon plugin upgrade, causing an undefined index notice message when the PHP error reporting level is set to E_NOTICE
.author
, prefix
and name
short code attribute support.raw
and configured
modes)