Forum Display Enhancements - My Forum - Personalised Forum Aggregator

My Forum - Personalised Forum Aggregator

This is the first release of this modification, please read the entire description before proceeding to install.

Background

As a forum administrator the chances are that at some point you have received "feedback" from members that they would prefer a different forum layout. For example, lets say you have the following forum structure:

• Cats
• Parrots
• Eagles

Some members might prefer:

• Parrots & Eagles to be in a single "Birds" forum.
• A single "Animals" forum that includes all three.
• Cats & Eagles to be in a single forum as they have no interest in Parrots.
• Things to be left exactly as they are.

Most sites have many more than 3 forums so the possible user preferred combinations are impossible to cater for, which means you cannot keep everybody happy, until now!

My Forum - What Does it do?

This modification uses the existing vBulletin forum subscription system to allow users to aggregate/mashup/join forums into a single "forum" where they can view all threads in the forums they have subscribed to. This gives a personalised "My Forum" which means that you can cater for all of the preferences mentioned above.

So taking the first preference example given above UserSmith would subscribe to the seperate Parrots & Eagles forums and then visit "My Forum" where he/she would see all threads in these two forums in a single forum.

The following is a brief summary of the key features

• You can specify which user groups are allowed to use My Forum.
• Guests don't have subscribed forums, however you can allow guest access by configuring guest viewable forums. Or you can disable Guest access completely.
• If the current user cannot use my forum you can choose to display the standard vBulletin "no permission" page or a custom message of your choice. You can specify different no permission message for Guests and Registered User, for example "Please purchase XXX subscription to use My Forum" or "Please register to use My Forum".
• With the exception of ACP this modification is fully phrased.
• You can configure the modification to place a link in your navigation bar and/or quick links. You can also choose to hide/show these depending on whether the current viewer has access to My Forum.
• As users are bringing together lots of forums there is a possibility that there will be a lot of stickies (if sticky display is enabled), so these are separated from normal threads and placed into a collapsible box. If there is an unread sticky the title of this box highlights how many sticky threads are unread.
• In ACP you can configure, by usergroup, forums that will always be displayed regardless of user subscriptions.
• You can choose to not display stickies.
• You can choose to display stickies on all pages or only page one.
• You can globally switch the modification on or off and display a custom message if it is off. On first install the default setting is off.
• As with normal forums you can specify a default view age.
• Uses a very similar look and feel to normal forums so your users don't need to get their heads around a different UI.
• Fully integrated into the Who's Online pages (i.e. it won't display "unknown location").
• Can be added to the Forum Jump menu.
• Includes an vBulletin FAQ entry.

Demo

You can see a live demo here:

http://www.therevcounter.com/myforum.php

In this setup My Forum is running in Guest Mode with guest forum subscriptions for "General Mayhem" and "Motorbike Chat". If you want register for an account and play with it in user mode.

Installation

Installation is fairly simple, follow these steps:

1. Download the zip file attached to this thread.
2. Extract the contents to your local machine.
3. Upload everything in the "upload" directory to your forum root directory.
4. Open up your Admin CP and goto : ACP -> Plugins & Products -> Manage Products -> Add/Import Product.
5. In the "EITHER upload the XML file from your computer" section click the browse button and browse to the product XML file on your machine (product-my_forum.xml).
6. If you are performing an upgrade make sure you allow overwrites.
7. Click the import button and sit back while vBulletin does its magic.

There are also some other optional setup steps you can follow to add My Forum to Forum Jump and the Breadcrumb box, these are details in the first post.

Configuration

Once installed you can configure this modification via:

• ACP -> vBulletin Options -> My Forum

The configuration options are fairly self explanatory, so I won't go into details here. However there is a screen shot attached.

What it doesn't do right now, but will/might in later releases

• Allow members to order the columns (i.e. order by replies/views etc).
• It doesn't currently display announcements.
• As vBulletin does not see this as a normal forum you cannot use forum based notices.
• There is no moderation functionality in My Forum you have to use the actual forum for this.
• If the viewing member has ignored users any threads by these users are not shown at all.
• Depending on feedback My Forum might be unlinked from the vBulletin subscription system and a separate forum selection system added.

I have been running this modification as it is here on my own site for almost 6 months and my members love it and the missing functionality has never been a problem.

So there you have it!

This is the first release of this modification, before posting here I have obviously put it through its paces, however there is always a possibility of a current unknown bug rearing its ugly head. If this does happen please post the details here and I will endeavour to quickly resolve the problem. It goes without saying that you should try this on your test forums before going live.

It is also worth mentioning that you should suggest to your members that they choose "no email notification" forum subscriptions.

Support

I have marked this mod as unsupported, this is because I cannot guarantee that I will always be around to quickly answer questions. I will pop in from time to time but I would rather not mark it as supported.


Version History

• 1.0 - First Release
• 1.0 - First Release Update (after 20 minutes of posting )
  • Fixed bug where a DB error would be displayed if the viewing user had people on their ignore list.
  • Fixed Bug where Who's Online would show PHP errors at the top of the page.
• 1.0 - Gold Release
  • No major issues have been found with the original 1.0 BETA release so this is now gold
• 1.0 - Gold Release (Minor Fix)
  • Fixed minor issue with one database call not using table prefixes
• 1.1 - Gold Release (Feature additions)
  • Added the ability to force, by usergroup, forums to be included in My Forum.
  • Added version check URL to product.
  • Added link to this page in product information.

[maidos]

cant you allow members to have options to select wether they want to subscribe a specific thread or forum please

[MrEyes]

Originally Posted by maidos

cant you allow members to have options to select wether they want to subscribe a specific thread or forum please

Forum subscriptions are managed through the default vBulletin system

There is no point in have thread subscriptions as these are already displayed by default on the usercp page

[shuangddr]

users may not have subscribed forums, can I force them to "subscribed" special some forums?

[shuangddr]

any plan to VB 3.8 ?

[MrEyes]

Originally Posted by shuangddr

users may not have subscribed forums, can I force them to "subscribed" special some forums?

At the moment it doesn't do this, however it will be fairly trivial to add the functionality. I will look into it shortly and post an update if it can be done.

Originally Posted by shuangddr

any plan to VB 3.8 ?

Not until it goes gold, have you tried it on the BETA release? Does it work?

[Alfa1]

It should. Not much has changed in vb 3.8

[MrEyes]

Originally Posted by shuangddr

users may not have subscribed forums, can I force them to "subscribed" special some forums?

Originally Posted by MrEyes

At the moment it doesn't do this, however it will be fairly trivial to add the functionality. I will look into it shortly and post an update if it can be done.

This functionality has been added and the mod is now on version 1.1

[shuangddr]

great job！
& I have just tested it on vb3.8 beta1,"my forum" keeps displaying "You do not currently have any forum subscriptions or you do not have access to the forums you are subscribed to.Please visit the main forums to add subscriptions."

[MrEyes]

A couple of question:

Do you have any subscriptions?
Have you set any "auto" subscriptions in ACP?
Does the viewing user have access to the forums you are expecting to see?

As a test would it be possible to do the following:

1. Open myforum.php in a text editor.
2. Find the following line:
   
   

   if ($myforum['hasaccess'] && $myforum['includedforumcount'] > 0)

3. Immediately before that paste in:
   
   

   echo "Auto Sub Forums:".$myforum['autoSubbedForums']."<br/>";
   echo "User Sub Forums:".$myforum['userSubbedForums']."<br/>";
   echo "Included Forums:".$myforum['includedforums']."<br/>";
   exit;

4. Save the file back to the server and goto My Forum.
5. Copy the text that appears on screen and paste it back here.

Once you are done remove the added lines and put the original myforum.php back.

You should end up with something that looks like this:

Auto Sub Forums:2,4
User Sub Forums:5
Included Forums:2,4,5

[shuangddr]

I added the code, ,and it displays :

Auto Sub Forums:1,2,3,4,5,6,7,8
User Sub Forums:2, 4
Included Forums:2,1,2,3,4