How to change the text of link 'Home' in bbPress forum breadcrumb?

Question

I just installed bbPress 2.0.2 forum plugin for WordPress, and would like to change the text of link Home to iGeek (or anything else, for that matter).

So the breadcrumb Home › Community becomes iGeek › Community (or something like that). How do I do that?

In case it helps, this is the code in \wp-content\plugins\bbpress\bbp-includes\bbp-common-template.php that determines the text:

/** Home Text *********************************************************/

// No custom home text
if ( empty( $args['home_text'] ) ) {

    // Set home text to page title
    if ( $front_id = get_option( 'page_on_front' ) ) {
        $pre_front_text = get_the_title( $front_id );

    // Default to 'Home'
    } else {
        $pre_front_text = __( 'Home', 'bbpress' );
    }
}

Answer 1

The string is now in bbpress/includes/common/template-tags.php.

Hook into bbp_no_breadcrumb, register a filter for gettext and change the text:

add_filter( 'bbp_no_breadcrumb', 'wpse_44597_change_home_text' );

function wpse_44597_change_home_text( $translated, $original = '', $domain = '' )
{
    if ( 'bbp_no_breadcrumb' === current_filter() )
    {
        add_filter( 'gettext', __FUNCTION__, 10, 3 );
        return FALSE;
    }

    if ( 'Home' === $original && 'bbpress' === $domain )
    {
        remove_filter( current_filter(), __FUNCTION__ );
        return get_bloginfo( 'name' );
    }

    return $translated;
}

The difference to a filter on bbp_get_breadcrumb is: bbp_get_breadcrumb is the complete bread crumb, and it is really hard to find the string for the home page without touching the wrong matches. WordPress might be installed in /www/Home/wp/, or another item might contain the word Home. You do not want to touch that.

Answer 2

There is no specific hook to filter the home text only, so we need to filter the whole breadcrumb and replace 'Home' with 'iGeek':

function wpse_44597_custom_home_text_in_bbp_breadcrumb( $trail ) {
    return str_ireplace( 'Home', 'iGeek', $trail );
}
add_filter( 'bbp_get_breadcrumb', 'wpse_44597_custom_home_text_in_bbp_breadcrumb' );

The above example has been successfully tested on my own site running bbPress 2.2.3.

Answer 3

There are two possibilities, depending what theme you are using:

1 Locate call to bbp_breadcrumb or bbp_get_breadcrumb function in your template files and add arguments to your function, like this:

$args = array(
    'home_text' => 'iGeek'
);
bbp_breadcrumb( $args );
// or bbp_get_breadcrumb( $args ), depending on which theme has been used in the first place

2 Create a page that you will use as your home page (depends on weather your theme supports such functionality or not; if there is a page template available for homepage then select it), name it 'iGeek'. Go to Reading -> Settings in your WP admin, select 'Static page' in 'Front page displays' option and select your 'iGeek' page as front page. Save options and the link in breadcrumb should change its name. This may change the way your home page is displayed and can vary from theme to theme.

I suggest trying the former method first.

EDIT:

I have found another method to do that - put below code in your functions.php:

function modify_breadcrumb_args() {
    $args['home_text'] = 'iGeek';

    return $args;
}

add_filter( 'bbp_before_get_breadcrumb_parse_args', 'modify_breadcrumb_args' );

Answer 4

jQuery alternative if no plugin hook exists:

<script type="text/javascript">
    jQuery(document).ready( function($) {
        $('#bborg-crumbs a:first').html('iGeek');
    });
</script>

Answer 5

I found out how to change the breadcrumb url, alt and text myself. You can change the code in bbp-common-template.php (/wp-content/plugins/bbpress/bbp-includes/bbp-common-template.php) on line 1889

 // Add the breadcrumb
        $crumbs[] = 'iGeek';