Forum Display Enhancements - Advanced Snowstorm Integration for Christmas

Please take some time and read this feature list before you go "Oh no, another of those pesky snowflake Mods!".

Features:
- The snow is optionally piling up on the bottom of the screen (customize the script to your liking)
- The script is lightweight and fast
- The script works on all current browsers and uses PNG images incl. GIF fallback
- Can be turned off by your users via quicklink or in the UserCP
- User can change the direction of the blowing wind

HackDetails:
Difficulty: easy
Templates to edit: 2
Approx. Time: 5-8 Minutes
Compatibility: All vB versions

As we all know, those nice scripts come at a price, and that is performance at the client side! I didn't want to pester my users with a CPU intensive script for the next 30 days and not offering a solution to switch it off in the UserCP (or temporarily). So with this hack everyone can decide for him/herself is he/she wants those nifty flakes flying around while reading the forum

Allright let's move to the hack itself:

First of all, I have to give full kudos to Scott Schiller who came up with the original Javascript for this nifty snowing effect. Secondly it is VERY easy to incorporate in your forum if you follow these 10 steps to success:

1) Get the latest version of the script from Scott Schiller's Homepage
2) Upload the script as well as all images included
3) AdminCP -> User Profile Fields -> Add New User Profile Field
4) Choose "Single Selection Radio Buttons"
5) Fill in all required fields and insert two values in the Options Box: (seperated with a return)
YES
NO
6) Set "Default" to YES
7) Hit "Save" and memorize the name of your field, in my case it's "field8".
8) Open up the Template "headinclude" and add at the bottom:

<if condition="$bbuserinfo['field8']=='YES'">
<script type="text/javascript" src="[path to your script]/script/snowstorm.js"></script>
</if>

Notice that I included the name of my field (field8) in the first line!

9) Hit "Save" and open up the template "navbar" and look for this code:

<if condition="$show['member']">
	
		<td class="alt2" valign="top" nowrap="nowrap">
		<div class="smallfont">

below add:

<if condition="$bbuserinfo['field8']=='YES'">
<a href="javascript:snowStorm.randomizeWind()">Change Wind</a>&nbsp;&nbsp;<a href="javascript:snowStorm.stop()">Stop snowing</a><br /><br />
</if>

Please note again that I included the name of my field (field8) in the first line!

10) Hit "Save" and you're ready to go!


Further thoughts:

This little hack adds the two control links directly above the login-details of your users. But it can of course be implemented where you like, you can also add graphical buttons to it. Furthermore you can use phrases to make all this multilingual, a step I took because my forums are multilingual.

Troubleshooting:

Q: It doesn't work?!
A: Be aware that this hack USES a script, which you have to download here!

Q: Argh, I don't see any snow flakes, but my CPU get's mangled
A: That's because the script doesn't find the images for the snowflakes. Open up the script (snowstorm.js) and set the "imagePath" to the folder where your snowflakes are in. You can even hardcode an absolute link there is everything fails.

Q: My switch in the UserCP doesn't work!
A: Make sure that you filled in the exact name of your field in the two locations which are specified in the steps above.

Q: The snow falls too slow or the flakes are too small
A: Open up the script and modify it to your liking, it's a great piece of code and well documented

Q: Is the snow only visible for registered users?
A: Yes, that's on perpose. Guests can't store any infos on the forum, therefore they can't switch it off if they don't like it.

Q: Oh my god it still doesn't snow... and it's mid December already!
A: Welcome to the age of global warming! Switch to a Hybrid Car, and walk more often. If everybody does that, we should get real snow again in a couple of decades

[JamieLee2k]

Not working, I have uploaded all the files into the root Dir and in the forum folder and it's still not working, can you give me the path the files should be in please?

[Shazz]

So far people that have tried 0-2?

[sezmar]

Hey nice mod but you forgot to attach the file.

I attached

[Shazz]

Originally Posted by sezmar

Hey nice mod but you forgot to attach the file.

I attached

Lol, maybe thats why?
[high]* Shazz waits for someone to confim it works[/high]

[daklay]

Ah, I see the problem.

Instead of Putting it at the bottom of headerinclude, just put it at the bottom of header

[JD45]

Ok, I got it working and here's how:

You need to upload the contents of the attached file (image and script) to your forums root directory.

Second modify header not headinclude like a previous poster had mentioned.

Here's how my header template code looks like:

<if condition="$bbuserinfo['field5']==YES">
<script type="text/javascript" src=" /forum/script/snowstorm.js"></script>
</if>

You can see a live demo at:

http://www.justpressplay.net/forum/

Edit: well, since it's a user option you won't be able to see it unless you register.

[Jeordie015]

var snowCollect doesn't seem to work. I have it off, but the snow still collects at the bottom.

[yoyoyoyo]

The code posted above is incorrect. Here is the proper code:

put this at the bottom of the header template:

<if condition="$bbuserinfo[field8] !='YES'">
<script type="text/javascript" src=" /forum/script/snowstorm.js"></script>
</if>

In your navbar template find:

<if condition="$show['member']">
	
		<td class="alt2" valign="top" nowrap="nowrap">
		<div class="smallfont">

add below:

<if condition="$bbuserinfo[field8] !='YES'">
<a href="javascript:snowStorm.randomizeWind()">Change Wind</a>&nbsp;&nbsp;<a href="javascript:snowStorm.stop()">Stop snowing</a><br /><br />
</if>

naturally substitute your proper profile field ID numbers as needed.

[WildSharky]

It does not seem to trun on and off tho and yes i have the right field its 6
it just stays on all the time..
and anyways to make a to start snowing with the stop to?

<if condition="$bbuserinfo[field6] !='YES'">
<a href="javascript:snowStorm.randomizeWind()">Change Wind</a>&nbsp;&nbsp;<a href="javascript:snowStorm.stop()">Stop snowing</a><br /><br />
</if>

[doberlec]

Originally Posted by yoyoyoyo

The code posted above is incorrect. Here is the proper code:
put this at the bottom of the header template:

<if condition="$bbuserinfo[field8] !='YES'">
<script type="text/javascript" src=" /forum/script/snowstorm.js"></script>
</if>

Dude, $bbuserinfo[field8] !='YES' doesn't make any sense. Why should the Javascript be included when the Users have set the Snow-Mode to NO?! Please get your knowledge on operators in php up to date.

@all the others: Please read all the text I posted VERY thoroughly! I didn't include the javascript in my hack because it is NOT my work. It seems that most people didn't even bother to read the first step in my list And also the second step, which even mentions that there are files to upload!

If you follow it to the letter it works flawlessly, either in headinclude or an the end of the header template.