[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. 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. You can use the poup box if you want to display the annnoucement as popup and the other box if in a table in forum home.

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[posts]==1)]] Show this announcement if page visitor has just 1 posts [[/($bbuserinfo[posts]==1)]]

* [[($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.

Hope this document helps you to understand the term conditional. Needless to say my hack's conditional syntax is different than vb3's default conditional syntax and this is because I use my syntax for a long time (before vb3 was up).

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). You are welcomed to ask them in thread but my apologies in advance if I'm too busy to answer all questions. Thank you.

[Logician]

[reserved for future use like FAQ]....

[TyleR]

heyyy, nice to see this ported to 3.5

/me clicks install

[Feckie (Roger)]

Nice One Thanks

[David_R]

Originally Posted by Feckie (Roger)

Nice One Thanks

hey Logician, thanks for updating the hack. just one question, does the 3.5 version carries any improvements over 3.x version ?

thanks.

[Logician]

Originally Posted by David_R

hey Logician, thanks for updating the hack. just one question, does the 3.5 version carries any improvements over 3.x version ?

It is mostly same but there a few improvements:

1- You can set up the frequency of popup announcement. Eg. you can make it popup in every 12 hours for the same user instead of every visit. (See admin cp screenshot above)

2- I get rid of the complainted "green" color Popup window and make it inherit your vb style with a cool red border.

3- It does not require any PHP hacking and can be installed through your admin cp as a pluggin.

4- Unlike vb3.x version, I don't support "header" version of it in which the announcement is displayed in all forum pages, not only forum home. It caused some minor bugs in post cached enabled forums so I only support forumhome announcement version which is stable

[TTG]

Great hack and could be very useful, I do however have one problem

I have a flash header on my forum and the popup announcements are hidden behind the flash .. is there any way of placing the popup announcements to show lower within the forum ?

[Logician]

Originally Posted by TTG

Great hack and could be very useful, I do however have one problem

I have a flash header on my forum and the popup announcements are hidden behind the flash .. is there any way of placing the popup announcements to show lower within the forum ?

Sure.. You can edit template 'dfh_announcement_popup'. The location of popup announcement is fixed there in the line:

Block Disabled:      (Update License Status)
Suspended or Unlicensed Members Cannot View Code.

[Sovereign]

Yay awesome! Been wanting this.

[TTG]

Originally Posted by Logician

Sure.. You can edit template 'dfh_announcement_popup'.

Thanks Logician .. clicked install.

[SHANE-D-PAIN]

Looks great, I will be sure to install this tomorrow after College or maybe even in College depending on the mood of the lesson!

Could be useful for letting members know about parts of the site that are not used all to often!

[Gottcha]

downloaded and installed ... can get the popup to work fine but cant get the Forum Home Table Announcement to work...any ideas?

[memorex]

Looks sweet, I'll install as soon as I have 3.5.0 gold upped

[dieselpowered]

Please forgive my ignorance, however, I did a quick little test for the pop-up, just a one line announcement and the red window is the size of my screen???

How do I make it look like yours with just a small red outline around the window?

Great hack!