Info on functions?

[Wired1]

I'm looking for information on a specific function (build_forum_permissions() and how it is used, yet the comments in the code in vB 3 RC4 aren't descriptive enough to help. Does anyone know of a good resource to ask about this? FYI, yes, I had been thinking about asking directly at vb.com

[Andreas]

Well, it queries the database for usergroups and forums adnd builds up the datastore records usergroupcache and forumcache..
To use it just call build_forum_permissions().

[Wired1]

IIRC, when used to make a forum, it SHOULD see what the forum defaults are and set the newly created forum to said defaults? Oh and yes, I know how to use a function, just having problems with this 1 in particular. When I use it in my forum creation script, everything is set to the table defaults for the forum. Basically I'm trying to figure out a way to have it set the new forum's permissions to the default of the site without manually going into the admin panel, or manually slapping them in by a mySQL insert.

[Andreas]

The forum defaults (eg. allow bb code, active, etc.) AFAIK are hardcoded in admincp/forum.php, so if you want them in your own script too you will have to copy that code.

[Wired1]

I don't think they're hard coded in PHP, since I believe you can change the forum default from within the admincp, and I think it's just a mySQL query / update when it does that. I'll take a look at that though.

Has anyone ever attempted to make a script to automatically create forums?

[Andreas]

Copy & Paste from admincp/forum.php

PHP Code:

// Set Defaults;
$forum = array(
        'displayorder' => 1,
        'daysprune' => 30,
        'parentid' => $parentid,
        'styleid' => '',
        'cancontainthreads' => 1,
        'active' => 1,
        'allowposting' => 1,
        'allowbbcode' => 1,
        'allowsmilies' => 1,
        'allowicons' => 1,
        'allowimages' => 1,
        'allowratings' => 1,
        'countposts' => 1,
        'indexposts' => 1,
        'showonforumjump' => 1,
        'warnall' => 0
); 


That's what i'd call hardcoded ...

[Wired1]

I stand corrected! I'll look for that. Just goes to prove that the world DOES keep on moving when I take a nap!

[Wired1]

By George, I think I've got it! The code you mentioned that is hard coded doesn't go directly into the $forum. Somewhere along the line it gets turned into $forum['options']. Took ages, but I finally stumbled upon the sequence:

PHP Code:

$options = array(
    'displayorder' => 1,
    'daysprune' => 30,
    'parentid' => $parentid,
    'styleid' => '',
    'cancontainthreads' => 1,
    'active' => 1,
    'allowposting' => 1,
    'allowbbcode' => 1,
    'allowsmilies' => 1,
    'allowicons' => 1,
    'allowimages' => 1,
    'allowratings' => 1,
    'countposts' => 1,
    'indexposts' => 1,
    'showonforumjump' => 1,
    'warnall' => 0
);

$forum['options'] = convert_array_to_bits($options, $_FORUMOPTIONS); 


Here's the (I think) complete code to automate the creation of a forum:

PHP Code:

require_once('./global.php'); 
require_once('./includes/functions_misc.php'); 
require_once('./includes/adminfunctions_forums.php'); 
require_once('./includes/adminfunctions.php');

$parentid = 12;
$title = 'Some foobar title';
$description = 'Some foobar description';

$forum = array( 
    'displayorder' => 1,
    'daysprune' => 30,
    'parentid' => $parentid,
    'title' => $title,
    'description' => $description,
    'styleid' => '0'
);

$options = array(
    'displayorder' => 1,
    'daysprune' => 30,
    'parentid' => $parentid,
    'styleid' => '',
    'cancontainthreads' => 1,
    'active' => 1,
    'allowposting' => 1,
    'allowbbcode' => 1,
    'allowsmilies' => 1,
    'allowicons' => 1,
    'allowimages' => 1,
    'allowratings' => 1,
    'countposts' => 1,
    'indexposts' => 1,
    'showonforumjump' => 1,
    'warnall' => 0
);

$forum['options'] = convert_array_to_bits($options, $_FORUMOPTIONS);

$parentlist = fetch_forum_parentlist($forum['parentid']); 
$DB_site->query(fetch_query_sql($forum, 'forum')); 

$forumid = $DB_site->insert_id(); 
$DB_site->query(" 
        UPDATE " . TABLE_PREFIX . "forum 
        SET parentlist='" . addslashes("$forumid,$parentlist") . "', 
        childlist = '$forumid,-1' 
        WHERE forumid = $forumid 
"); 

build_forum_parentlists($forumid);
build_forum_child_lists($parentid); 

build_forum_permissions(); 


I'm pretty sure this won't qualify as a hack per se, but I hope this code will help out other vB module coders out there!

Now, does anyone see any potential errors or boo-boos that I might have missed? It is 5:10 AM for me after all