Fortunately, bbPress comes loaded with a function called bb_register_view() that makes this extremely simple. I’ll be showing you how to create new views in this tutorial.

Some things worth noting:

• Views are displayed according to the view.php file within your theme.
• bbPress comes loaded with with two default views: “Topics with no replies” and “Topics with no tags.”
• The My Views plugin creates some neat views and is definitely worth checking out.

Here’s a look at some custom views I’ve create:

Custom bbPress views

The bb_register_view() function

bb_register_view() is the function that handles creating new views. Let’s take a look at its parameters and what we can do with them.

bb_register_view( $view, $title, $query_args = '', $feed = TRUE );

$view is what you’ll name the view. What you put here will also become part of the permalink to the view page.

$title is the title of the view that you’ll see on screen. It’ll show in view lists and likely on your view page. Note: Theme and plugin developers should localize this so it can be translated.

Optional: $query_args should be an array of arguments on how to display the topics and such on the view’s page.

Optional: $feed is whether the view should have its own feed. This is set to true by default.

Creating a custom view

Now that you know how the bb_register_view() function works, it’s time to create a couple of views. The first thing you should do is open your theme’s functions.php. If your theme doesn’t have this file, create one.

We’ll create two new views: Alphabetical (ascending) and Alphabetical (descending). Drop this code in your functions.php file:

<?php

add_action( 'bb_init', 'my_custom_views_init' );

function my_custom_views_init() {
	$args = array( 'order_by' => 'topic_title', 'order' => 'ASC' );
	bb_register_view( 'alphabetical-ascending', __('Alphabetical: Ascending (A – Z)', 'example'), $args, false );

	$args = array( 'order_by' => 'topic_title', 'order' => 'DESC' );
	bb_register_view( 'alphabetical-descending', __('Alphabetical: Descending (Z – A)', 'example'), $args, false );
}

?>

In your views list, you should now be able to click on either of these views and see what happens.

Custom view templates

By default, bbPress will use your theme’s view.php template to display a view. Sometimes, you might want to create an entirely custom template though, which is perfectly fine.

For the sake of simplicity, we’ll create two new templates with the same names as our views from above: alphabetical-ascending.php and alphabetical-descending.php. Place those files in your theme’s folder.

Then, add this code to your functions.php file:

<?php

add_action( 'bb_custom_view', 'my_custom_views_templates' );

function my_custom_views_templates( $view ) {

	if ( 'alphabetical-ascending' == $view ) {
		bb_load_template( 'alphabetical-ascending.php' );
		exit();
	}
	elseif ( 'alphabetical-descending' == $view ) {
		bb_load_template( 'alphabetical-descending.php' );
		exit();
	}
}

?>

Of course, what goes in your custom templates is entirely up to you. Use your imagination.

Note: There may be a more elegant way to load custom view templates, so if you have suggestions, I’d love to hear them.

How to list your views

Most bbPress themes will likely list your views somewhere within the theme, but if yours doesn’t, just drop this code wherever you need to list them:

<ul>
	<?php foreach ( bb_get_views() as $view => $title ) : ?>
		<li class="view"><a href="<?php view_link( $view ); ?>" title="<?php view_name( $view ); ?>"><?php view_name( $view ); ?></a></li>
	<?php endforeach; ?>
</ul>

Views are not pages

On a final note, I wanted to point out that views are not pages. bbPress is not a CMS like WordPress, which is what you’d use to create things like pages. One could use views to create ad hoc pages, but this seems a bit crude.

I can see the need for something like a page feature for forum-only sites, but I’ll leave that discussion for another time.

What I’ll be showing you in this tutorial is a simple way to do this.

I prefer to have the list of forums in the sidebar while showing the most recent posts in the content area. But, you can use this code in any of your template files for use anywhere on your forums.

The code

What we’ll be doing is using the get_forums() function to grab an array of all of your forums. Then, we’ll loop through the array, listing a link to each forum, showing the number of posts, and linking to the RSS feed.

<div class="forums-list">

	<h3>Forums</h3>

	<ul>

	<?php $forums = get_forums(); ?>
	<?php foreach ( $forums as $forum ) : ?>

		<li>
			<a class="forum-link" href="<?php forum_link( $forum->forum_id ); ?>"><?php forum_name( $forum->forum_id ); ?></a>
			<span class="forum-posts">(<?php forum_posts( $forum->forum_id ); ?> posts)</span>
			<a class="rss-link" href="<?php bb_forum_posts_rss_link( $forum->forum_id ); ?>">(<abbr title="Really Simple Syndication">RSS</abbr>)</a>
		</li>

	<?php endforeach; ?>

	</ul>

</div>

The finished product

I worked a little extra CSS magic on mine and came up with this:

I hope you have fun with this code and come up with more unique ways to show off your forums. I provided a few CSS classes to help you out if you want to add your own style. Here they are for reference:

/* Containing <div> */
.forums-list {}

/* Header */
.forums-list h3 {}

/* List */
.forums-list ul {}
.forums-list li {}

/* Forum link */
a.forum-link {}

/* Number of forum posts */
span.forum-posts {}

/* Forum RSS Link */
a.rss-link {}

More bbPress tutorials and discussion to come

I’m not really sure how many folks are using bbPress these days, but it’s the forum software of choice for me. It’s simple and lightweight — everything I need in forum software. I hope that I can bring more people to this platform and do my part in helping the bbPress community grow.

I also hope to continue writing more tutorials like this one, so there’ll be more documentation out there. If you have ideas for tutorials, I’ll see if I can squeeze them in sometime.