vb.org Archive - Sitewide Announcement.

This was one of my first hacks, but I've learned so much since then so as to completely invalidate the old code. Not that it didn't work, but it's clumsy.

This template mod (there is no code to hack) generates an announcement in the variable of $announcement that you can then put in you're header or you're navbar if you're so inclined. The announcement changes based on the usergroup but also on whether or not registered users have posted or posted recently.

The key to the code goes in the PHPINCLUDE_START template. You can put this at the very start or the very end of you're template so long as you don't drop it into the middle of something else.

PHP Code:


		
			
// #####################################################

// #####            START ANNOUNCMENTS             #####

// #####################################################



eval('$announcement = "' . fetch_template('announcement_all') . '";');



if (empty($announcement)) //If it's empty we'll get our usergroup announcements

    {

    if (is_member_of($bbuserinfo, 1))  // Guests go first.

        {

        eval('$announcement = "' . fetch_template('announcement_guest') . '";');

        }

    else if (is_member_of($bbuserinfo, 3)) // Pending Registrant

        {

        eval('$announcement = "' . fetch_template('announcement_pending') . '";');

        }

    else if (is_member_of($bbuserinfo, 5) OR is_member_of($bbuserinfo, 6) OR is_member_of($bbuserinfo, 7)) // Staff (Supermods, Admins & Mods)

        {

        eval('$announcement = "' . fetch_template('announcement_staff') . '";');

        }

    else if ($bbuserinfo['posts'] == 0) // User has never posted. Encourage them.

        {

        eval('$announcement = "' . fetch_template('announcement_noposts') . '";');

        }

    else if (TIMENOW - $bbuserinfo['lastpost'] > 1209600) // User hasn't posted in 14 days.

        {

        eval('$announcement = "' . fetch_template('announcement_noposts14days') . '";');

        }

    else // All others

        {

        eval('$announcement = "' . fetch_template('announcement_registered') . '";');

        }  

    }

Now create 7 new templates - the contents of which will be the messages the users receive. Leave announcement_all blank - it's an emergency announcment that, when active, suppresses the other 6. I use it to warn users about an hour ahead of time that I'm going to turn the boards off.

announcement_all
announcement_guest
announcement_pending
announcement_staff
announcement_noposts
announcement_noposts14days
announcement_registered

Ok, that's it and ready to run. You can plug $announcement into your header or the like, though you might want to frame it in a table or layer. You can turn that framing table or layer off when the $announcement is empty like so...

<if condition="!empty($announcement)">
<table><tr><td>$announcement</td></tr></table>
</if>

Now, you can of course do all of the above with raw template conditionals HOWEVER, this approach has the advantage that the $announcement templates are easier to read and modify by someone with very little HTML experience. So, this approach comes in handy for making modification easy for someone else.

However, for the curious, here is the SAME system, entirely as a template conditional done in HTML.

HTML Code:

<if condition="is_member_of($bbuserinfo, 1)">

TEXT OF THE GUEST MESSAGE

<else /><if condition="is_member_of($bbuserinfo, 3)">

TEXT OF THE PENDING USER'S MESSAGE

<else /><if condition="is_member_of($bbuserinfo, 5) OR is_member_of($bbuserinfo, 6) OR is_member_of($bbuserinfo, 7)">

TEXT OF THE STAFF MESSAGE

<else /><if condition="$bbuserinfo['posts'] == 0">

TEXT OF THE MESSAGE TO USERS WITH 0 POSTS

<else /><if condition="(TIMENOW - $bbuserinfo['lastpost'] > 1209600)">

TEXT OF THE MESSAGE TO USERS WITHOUT A POST IN THE LAST 14 DAYS

<else />

TEXT OF THE MESSAGE TO ALL REMAINING USERS.

</if></if></if></if></if>

Does it work? I think so (Not so sure about the subtraction in an <if> tag on that last conditional). But digging through that anytime you want to change one of those can be a pain.

Anyway, if you absolutely must do some hacking, you can perform the following hack to optimize this template modification.

In your global.php file look for this code

PHP Code:


		
			
// identify where we are

define('VB_AREA', 'Forum');

Directly after it add the following:

PHP Code:


		
			
$globaltemplates = array_merge($globaltemplates,

        array(

            'announcement_all',

            'announcement_guest',

            'announcement_pending',

            'announcement_staff',

            'announcement_noposts',

            'announcement_noposts14days',

            'announcement_registered'

               )

);

What that does is cache these 7 templates before they called, resulting in fewer MySQL queries (anytime you fetch an uncached template you cause another query to occur).

I'll leave you with EN World's contents of each of these messages to give you some ideas on what to put in each one in order to encourage folks to post and join you're community.

ANNOUNCMENT_GUEST

HTML Code:

<b>Welcome to EN World, one of the busiest <i>Dungeons &amp; Dragons</i> and 

d20 System fan sites on the internet. You will need to <a href="register.php">join EN World</a> for 

free before you can post messages or use many of the site's features, but you are welcome to read the

boards and news without joining. Please feel free to join and participate in the friendly discussions 

of all things D&amp;D and d20!</b>

ANNOUNCEMENT_NOPOSTS

HTML Code:

Welcome!!  You're seeing this message because you have successfully completed your registration but you've never posted. We'd love to hear from you.  <a href="newreply.php?do=newreply&noquote=1&p=1828845">Click here</a> to say Hello and maybe even post a few details about yourself<br />

<br />

Oh, and welcome to EN World.

ANNOUNCEMENT_NOPOSTS14DAYS

HTML Code:

Hello.  You're seeing this message because you haven't posted in the last 14 days. While participation in the forums isn't required, it is encouraged. We'd love to hear your comments and opinions on all things gaming related.

ANNOUNCEMENT_PENDING

HTML Code:

Welcome to EN World!  You have registered a new account, but you still

 need to verify your email address. Please check your email for details on how to do this, or 

 <a href="register.php?$session[sessionurl]do=requestemail">click here</a> to be sent a new verification 

 email. If you did not receive the email then it's possible it was blocked by your email client. 

 In this case you can either disable your blocker software or enter a new email address in 

 <a href="profile.php?$session[sessionurl]do=editpassword">your profile</a>

ANNOUNCMENT_REGISTERED

HTML Code:

<b>Welcome to EN World!  Please consider becoming a <a href="http://www.enworld.org/forums/subscriptions.php?">community supporter</a>.  A community supporter is somebody who has donated to EN World in order to help cover the costs of very server-intensive, and thus expensive features (in particular, the search feature). The features available only to community supporters are Search, Private Messaging, Custom User Titles, Who's Online and EN World's in-built RPG. Note that you can also get these features separately.</b>

Well, I think that's all. I hope this helps someone.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.01780 seconds Memory Usage 1,784KB Queries Executed 10 (?)
More Information
Template Usage: (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (6)bbcode_html_printable (3)bbcode_php_printable (4)bbcode_quote_printable (1)footer (1)gobutton (1)header (1)headinclude (6)option (1)pagenav (1)pagenav_curpage (1)pagenav_pagelink (1)post_thanks_navbar_search (1)printthread (10)printthreadbit (1)spacer_close (1)spacer_open Phrase Groups Available: global postbit showthread	Included Files: ./printthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/class_bbcode_alt.php ./includes/class_bbcode.php ./includes/functions_bigthree.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete printthread_start pagenav_page pagenav_complete bbcode_fetch_tags bbcode_create bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete printthread_post printthread_complete
Messages: