[Logician]

Screenshot1:

General announcement in forum home

[Logician]

Screenshot2:

An announcement addressed to a specific user only. (Needless to say it will be visible only if the visitor is that user)

[Logician]

Screenshot 3:

Admin CP/Settings: Where you customize your announcements

[Logician]

How To Use - Conditionals Help

After you installed the hack:

Basic Usage:

If you want to display an announcement to ALL users, simply login to Admin CP/Choose VB Settings/Dynamic Forum Announcements and enter your announcement as a plain text into the box. (Delete the previous one). You can use smilies and all other bbcode in your announcements. This text will be dragged to your forum home regardless of whoever the page visitor is.

Advanced Usage:
You can use "conditionals" to set announcements displayed if a certain condition applies. If you are using my WebTemplates Hack , you should be already familiar with the term "conditional". In Webtemplates conditionals could be used to put different texts/HTML codes which will be parsed if certain condition appied in your non-vb pages. It's the same concept and their usage is same. Here is its format:

[[(your conditional)]] Your Announcement [[/(your conditional)]]

Conditional Rules:

• Conditionals are covered inside [[ ]] tags
• Conditional itself is in paranthesis ( )
• Announcements are written in between the conditional tags
• Opening and closing conditional are exactly same except closing conditional has a / right before (
• If you are trying to check if a X equals to Y use DOUBLE equation mark not single. eg. Correct: X==Y Incorrect:X=Y
• You can design as many conditional as you like. If more than 1 condition applies at the same time, the conditional which is above (=higher priority) is parsed.
• If you write a plain text without a conditional together with other conditionals, this text is considered "default announcement" and displayed if no conditions applies.

Some examples will help you understand the rules better. Here are some conditionals and the announcement texts which explains what that conditional do:

* [[($bbuserinfo[userid]==32)]] Show this announcement if page visitor's user id is 32 [[/($bbuserinfo[userid]==32)]]

* [[($bbuserinfo[usergroupid]==5)]] Show this announcement if page visitor's usergroupid is 5 (=if he is a Super Mod) [[/($bbuserinfo[usergroupid]==5)]]

* [[($bbuserinfo[usergroupid]==1)]] Show this announcement if page visitor is a guest [[/($bbuserinfo[usergroupid]==1)]]

* [[($bbuserinfo[userid]>1)]] Show this announcement if page visitor is NOT a guest [[/($bbuserinfo[userid]>1)]]

* [[($bbuserinfo[usergroupid]==5 OR $bbuserinfo[usergroupid]==6 OR $bbuserinfo[usergroupid]==7)]] Show this announcement if page visitor's a Super Mod OR a Mod OR an Admin [[/($bbuserinfo[usergroupid]==5 OR $bbuserinfo[usergroupid]==6 OR $bbuserinfo[usergroupid]==7)]]

* [[($bbuserinfo[posts]<10)]] Show this announcement if page visitor has less than 10 posts [[/($bbuserinfo[posts]<10)]]

* [[($bbuserinfo[lastvisit] and $bbuserinfo[lastvisit]<strtotime(-30 days))]]Show this announcement if page visitor has not visited your board for 30 days[[/($bbuserinfo[lastvisit] and $bbuserinfo[lastvisit]<strtotime(-30 days))]]

* [[($bbuserinfo[joindate]>strtotime("-2 weeks") AND $bbuserinfo[joindate]<strtotime("-4 weeks"))]]Show this announcement if page visitor registered in a date between 2 weeks to 4 weeks from now[[/($bbuserinfo[joindate]>strtotime("-2 weeks") AND $bbuserinfo[joindate]<strtotime("-4 weeks"))]]

You can use conditionals together too. Here is an example:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=
[[($bbuserinfo[userid]==32)]] Announcement 1 [[/($bbuserinfo[userid]==32)]]
[[($bbuserinfo[usergroupid]==3)]] Announcement 2 [[/($bbuserinfo[usergroupid]==3)]]
Announcement 3
-=-=-=-=-=-=-=-=-=-=-=-=-=-=
If you set this text as your announcement, the hack will:
Show Announcement 1, if user's userid = 32
Show Announcement 2, if user's usergroupid = 3 (=email confirmation waiting members)
show Announcement 3, For ALL other users

What if user 32 is also from user groupid 3? He will be displayed Announcement 1 because even if he matches both conditional 1 and conditional 2, conditional 1 (which is above) has a higher priority.

Notice About vbulletin admin CP/settings bug: While I code this hack I have noticed that vbulletin Admin CP/Settings section has a bug. This hack's installation step 6 also fixes this bug so you wont be effected by it after the installation. You can find more info about this bug in the official vbulletin.com thread.

Hope this document helps you to understand the term conditional. You can use this help page as a reference for this hack, for WebTemplates Hack and for some of other hacks I am coding at the moment. I have recently noticed that vbulletin version 3 will also have a concept "vb conditionals". I dont know their syntax but their logic will be same so you can consider yourself lucky by using the conditionals before it's officially integrated to the script.

If you need more help to design a "conditional", before asking me please read this document carefully for a few times, try to form it by yourself and if they all fail, ask in the hack's thread giving details about exactly what conditional you tried to form and what text (format) have you tried (and failed). Thank you.

[Logician]

Add-on 1: Forum Tips Depending on visitor's post count

If you copy/paste this text into your announcement box, you'll create a forum tips announcement which will be displayed to your visitors according to their post count.

Eg.
If his post number < 1 displays "Tip 1"
If his post number = 1 displays "Tip 2"
If his post number > 1 AND <=5 displays "Tip 3"
etc..

More info in the text file..

[Logician]

Add-on 2: Forum Tips Depending on visitor's seniority

If you copy/paste this text into your announcement box, you'll create a forum tips announcement which will be displayed to your visitors according to their seniority (register date)
Eg.
If he registered today displays "Tip 1"
If he register day >1 AND <3 displays "Tip 2"
If he register day >=3 AND <5 displays "Tip 3"
etc..

More info in the text file..

[MarkB]

Very interesting hack!!

[KarateKid]

You're great Logican, you alway create very helpfull hacks!

Thank you very much!

[Dean C]

this is AWESOME... one of the best hacks... im definately going to install this later 2nite

- Mist

[assassingod]

Bloody brilliant Defintely going to install this one! Great work Logican

[Floris]

Just like Mist says 'this is awesum!'
We are totally gonna try and see if we can use this.

[g-force2k2]

awesome hack Logician reason why you're one of the best at vb.org keep up the great work...

g-force2k2

[xug]

One of the coolest hacks I have seen in a while.

[Velocd]

Terrific hack Logician, as it will defiantly will prove useful for many

*slaps install*