Forum Update Notes for Version 3.0.0 Public Beta¶

Discussion Forum 3.0.0 Public Beta requires version 2.0.0 Public Beta or greater of ExpressionEngine.

If you have a customized forum theme that you wish to update to work with 3.0.0 Public Beta’s new forum theme format, you will need to make some changes to the file structure.

Open your theme folder For each file (e.g. theme_css.php) create a corresponding directory with the pattern forum_css. (“theme_” becomes “forum_” and drop the “.php” extension. Open the theme file in a text editor and for every method in the file, create a correspondingly named .html file, and place that method’s contents in that file.

Example: for theme_category.php create a directory named ‘forum_category’. In the original theme_category.php file, you’ll find:

function category_page() {
        return <<< EOF

        {include:html_header}
        {include:top_bar}
        {include:page_header}
        {include:page_subheader}

        <div id="content">
                {include:main_forum_list}
                {include:forum_legend}
        </div>

        {include:html_footer}

EOF;
}
/* END */

Which will become a new file in the forum_category directory named category_page.html, with the contents:

{include:html_header}
{include:top_bar}
{include:page_header}
{include:page_subheader}

<div id="content">
        {include:main_forum_list}
        {include:forum_legend}
</div>

{include:html_footer}

There is also a small standalone script utility to help you automate these changes. If you have greatly deviated from structure and files in your own theme, there may be some manual changes you will still need to make, but on most themes, running this utility and moving the resulting files will be all you need to do.

To utilize the standalone script, download and unzip it, and upload it inside your forum theme folder, access it directly from your browser (e.g. http://example.com/themes/forum_themes/your_theme/convert_forum_theme.php) and follow the included instructions.

Return to Update Page