Miscellaneous Hacks - Tips of the Day

Many computer programs display a "Tip of the day" window when you open it. This mod offers the same functionality for vBulletin.

- The tips are displayed as vB's stock notices.

- You have complete control to define how often a tip is shown. There are the following options: always on, once in a browser session, once a day, once every X minutes or once every X page views.

- Tips are phrased. If you have a multilanguage board, you can easily translate them.

- Every tip can be assigned to a user-group, so only its members will see it. It also checks secondary groups.

- The mod will chose one of the available tips randomly. You can change the probabilistic weight of every tip to control how often they will be shown.

- The appearance of the Tips can be easily configured using stylevars (including background, shadow color, font for the title of the tip, and color for both the title and main tip text). For advanced needs, you can also customize the pod_tips.css template.

- Import / export utility, so you can make security copies, or share with your friends.

- Option to deactivate tips for guests.

- Setting to disable for non-confirmed users (awaiting email confirmation or in moderation) and banned users.

- With the package, I provide a file with a few tips about basic vBulletin usage that you can import after installing the mod, so you have some default tips (if you find some mistake in the file, please tell me, English is not my first language).

- There's a setting to add an icon next to the tips. (The icon used in the screenshots comes from http://www.iconfinder.com/icondetail...es_system_icon ). You can very easily customize the CSS style for that icon using stylevars.

- You can let your users dismiss the Tips of the Day. After dismissing them, they can be enable by clicking the appropriate option in the Quick Links menu. Optionally, users must have been registered for a configurable number of days before they can dismiss (so you ensure they see some Tips before dismissing them). At any moment, users can undismiss Tips by selecting an option in the Quick Links menu.


PERFORMANCE

All the information of the Tips is retrieved using the second call of the datastore (just after init_startup). If you have any other mod that uses the same call to the datastore, it will use the same query.
Also, the mod avoids to load the datastore if it's possible to determine beforehand that there will be no tips displayed (it's not always possible, but most often).
Therefore, this mod increases your query count in AT MOST one single query on every page load.

Furthermore, the CSS uses the main-rollup file (if you are storing css in the file system), or the main call to css.php (if you are not). So it never requires an extra HTTP request.


INSTALL/UPGRADE INSTRUCTIONS

1. Unzip the mod file.

2. Upload all the files in the "upload" folder. Note: If you have renamed your admincp folder in your vb installation, make sure to do so before uploading. This is the file structure you have to upload:

./includes
./includes/xml
./includes/xml/bitfield_pod_tips.xml
./includes/xml/cpnav_podtips.xml
./includes/xml/cssrollup_pod_tips.xml
./admincp
./admincp/pod_tips.php


3. Import the product file.

4. Add few tips in the admincp: Notices > Tips of the day manager. Optionally, you can import the default vB usage tips provided with the package.

5. Go to Settings > Options > Tips of the day Settings, configure options as you wish, and set active to "yes" (the mod installs itself deactivated to give you a chance to add tips before activating).


MEANING OF PROBABILITY

If you set the probability of a tip to be "10", it doesn't mean that it will appear with a probability of 10%. The actual probability will depend on how many tips are availiable to display. The probability setting is relative to other tips. For instance, a tip with probability 10 will appear two times more often that one that you set to 5.


MODIFIED STYLES

This mod partially depends on the built-in notices system. Therefore, if you have modified your navbar template to a way that it cannot show regular vB's notices, this mod will probably not work. Since version 0.2, Tips should most likely work on most styles if ordinary notices are working, but cannot guarantee.


COMPATIBILITY

I tested this mod in vbulletin 4.0.4. However, it might probably work on any 4.0.x release (please, tell me if you run into any problem using this mod on earlier 4.0.x releases).


SIGNIFICANCE OF A BETA RELEASE

Please note that this mod is, at best, in beta stage. Therefore, I hold no responsibility on any harm or data loss it might cause. I strongly recommend testing it as extensively as possible in your testing environment before installing it in your production site.


SUPPORT

Despite its beta status, I'll do my best to support all vb admins that mark this mod as installed. Sometimes, support will be impossible without providing me admincp access (in a test install, preferably).


TRANSLATIONS

I provide a Spanish translation for this mod. You are most welcome to translate it and distribute your translation (only the language file) in any site, provided that you link to the official thread of the mod in vbulletin.org.

Note that you can only distribute the language file, downloaded from the Languages & Phrases section in your admin cp. Redistribution of the product itself is not allowed.


CHANGE LOG

v0.1 (June 21, 2010) Initial beta releases

v0.2 (June 26, 2010)
- Fixed missing phrase in tips manager, when there are no tips to show.
- Setting to disable for non-confirmed users (awaiting email confirmation or in moderation) and banned users
- Import / export utility.
- Setting to add an icon next to the tips. (The icon used in the screenshots comes from http://www.iconfinder.com/icondetail...es_system_icon ).
- Changed the way used to inject the tips into the page (thanks ragtek for the idea). Hopefully, will work better with modified styles.

v0.2.1 (June 27, 2010)
- Fixed bug that made the mod incompatible with mysql prior to 5.0.2.
- Fixed bug that made the mod incompatible with vBulletin prior to 4.0.4.

v0.3 (July 12, 2010)
- Style of the tips can now be customized using stylevars (there's also a pod_tips.css template for advanced needs).
- A new setting now allows you to choose in which areas of vBulletin should tips be displayed.
- Now you have more control to define how often a tip is shown. You have the following options: always on, once in a browser session, once a day, once every X minutes or once every X pageviews.
- Path and style of the icon for the tips has been moved from vBulletin options to stylevars (you'll need to configure it again, sorry).
- Option to make the Tips dismissible.

[dondavis]

Does this mod work on vB 4.1?

[Pod]

Originally Posted by dondavis

Does this mod work on vB 4.1?

To be honest, I have had no time to test. I don't think there should be problems with this mod.

But if it doesn't work, I'll fix it. Can't say when, but I sure will.

[cassis2k]

Hello Pod,

Great mod, i will test it on 4.1.1

[Bisha]

Hi POD, nice mod!

But, where are the settings for the icon? or the css?

thanks

[SEW810]

Installed
Working on vBulletin 4.1.1
Nominated
+5 Stars

EDITED ++++++++++++++++

"Tip of the Day" phrase appears BOLD at forumdisplay but NOT at forumhome.
It looks much better with bold style. Can you make it BOLD at any page? (forumhome,forumdisplay,profile,etc)
Using <b></b> tags don't fix it (phrase manager)


My suggestion: It would be great if we could pick multiple usergroups to show when creating a new Tip of the Day.
And my vote for this suggestion: https://vborg.vbsupport.ru/showpost....9&postcount=59

Thanx a lot for this useful mod

Regards

[Breixo]

I can't translate using the Spanish XML file. I tried in the Download/Upload Languages using the XML importer. Maybe I'm wrong, any advice?

Thanks!

PS: if I try to upload the XML file through "Import/Export Tips" it says "Imported file has no tips".

[Pod]

Originally Posted by Bisha

But, where are the settings for the icon? or the css?

thanks

In the stylevars. Filter them by pod_tips and you'll see all of them related to this mod.

Originally Posted by SEW810

"Tip of the Day" phrase appears BOLD at forumdisplay but NOT at forumhome.
It looks much better with bold style. Can you make it BOLD at any page? (forumhome,forumdisplay,profile,etc)
Using <b></b> tags don't fix it (phrase manager)

I don't think it should look diferent in different pages of the site. Does it still happen in the default style? If so, I'll have to take a deeper look.

Originally Posted by SEW810

My suggestion: It would be great if we could pick multiple usergroups to show when creating a new Tip of the Day.
And my vote for this suggestion: https://vborg.vbsupport.ru/showpost....9&postcount=59

Don't know about multiple usergroups, but the preview thing will definitively be in.

Originally Posted by Breixo

I can't translate using the Spanish XML file. I tried in the Download/Upload Languages using the XML importer. Maybe I'm wrong, any advice?

Thanks!

PS: if I try to upload the XML file through "Import/Export Tips" it says "Imported file has no tips".

Ese XML contiene la traducci?n del mod en si, pero no contiene los consejos. Lo tienes que subir desde la administraci?n de lenguajes de vb, a?adi?ndolo a tu lenguaje normal.

[Bisha]

Originally Posted by Pod

In the stylevars. Filter them by pod_tips and you'll see all of them related to this modl.

Thanks, but it want save my settings... running 404??

[Pod]

Originally Posted by Bisha

Thanks, but it want save my settings... running 404??

The stylevar manager had some bugs on early releases of 4.0.x; some of them were fixed in 4.0.5 (look at this). If that's the bug you're facing, it has to do with vb, not with the mod, so not much I can do about that.

[Bisha]

Originally Posted by Pod

The stylevar manager had some bugs on early releases of 4.0.x; some of them were fixed in 4.0.5 (look at this). If that's the bug you're facing, it has to do with vb, not with the mod, so not much I can do about that.

Yes, maybe is any vb bug...! temporary I edited the $pod_icon!

Thanks again for your prompt reply!