BBP_Shortcodes::display_topic_form( array $attr = array(), string $content = '' )

Display the topic form in an output buffer and return to ensure post/page contents are displayed first.

Description

Supports ‘forum_id’ attribute to display the topic form for a particular forum. This currently has styling issues from not being wrapped in

which will need to be sorted out later.

Parameters

$attr

(Optional)

Default value: array()

$content

(Optional)

Default value: ''

Return

(string)

Source

File: bp-forums/common/shortcodes.php

public function display_topic_form( $attr = array(), $content = '' ) {
 
    // Sanity check supplied info
    if ( !empty( $content ) || ( !empty( $attr['forum_id'] ) && ( !is_numeric( $attr['forum_id'] ) || !bbp_is_forum( $attr['forum_id'] ) ) ) )
        return $content;
 
    // Unset globals
    $this->unset_globals();
 
    // If forum id is set, use the 'bbp_single_forum' query name
    if ( !empty( $attr['forum_id'] ) ) {
 
        // Set the global current_forum_id for future requests
        bbpress()->current_forum_id = $forum_id = bbp_get_forum_id( $attr['forum_id'] );
 
        // Start output buffer
        $this->start( 'bbp_single_forum' );
 
    // No forum id was passed
    } else {
 
        // Set the $forum_id variable to satisfy checks below
        $forum_id = 0;
 
        // Start output buffer
        $this->start( 'bbp_topic_form' );
    }
 
    // If the forum id is set, check forum caps else display normal topic form
    if ( empty( $forum_id ) || bbp_user_can_view_forum( array( 'forum_id' => $forum_id ) ) ) {
        bbp_get_template_part( 'form', 'topic' );
 
    // Forum is private and user does not have caps
    } elseif ( bbp_is_forum_private( $forum_id, false ) ) {
        bbp_get_template_part( 'feedback', 'no-access' );
    }
 
    // Return contents of output buffer
    return $this->end();
}

Expand full source code Collapse full source code

Changelog

Changelog
Version	Description
bbPress (r3031)	Introduced.

Uses

Uses
Uses	Description
bp-forums/core/template-functions.php: bbp_get_template_part()	Adds Forums theme support to any active WordPress theme
bp-forums/users/template.php: bbp_user_can_view_forum()	Check if the user can access a specific forum
bp-forums/forums/template.php: bbp_is_forum_private()	Is the forum private?
bp-forums/forums/template.php: bbp_is_forum_hidden()	Is the forum hidden?
bp-forums/forums/template.php: bbp_get_forum_id()	Return the forum id
bp-forums/classes/class-bbpress.php: bbpress()	The main function responsible for returning the one true bbPress Instance to functions everywhere.
bp-forums/common/shortcodes.php: BBP_Shortcodes::unset_globals()	Unset some globals in the $bbp object that hold query related info
bp-forums/common/shortcodes.php: BBP_Shortcodes::start()	Start an output buffer.
bp-forums/common/shortcodes.php: BBP_Shortcodes::end()	Return the contents of the output buffer and flush its contents.
bp-forums/common/template.php: bbp_is_forum()	Check if current page is a Forums forum

Show 5 more uses Hide more uses

Used By
Used By	Description
bp-forums/core/theme-compat.php: bbp_template_include_theme_compat()	Reset main query vars and filter ‘the_content’ to output a Forums template part as needed.

Questions?

We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.

Contents