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.

[SPARKS MAN]

thanks i re download it
thank u very much for ur reporting

[xixxon]

Greate MOD,Thanks Man =D>

[jerx]

Unsure whether it will be installed, but it is definately a great idea!

[Fungsten]

Love it. But on one of my forums the link does not show up in the "Quick Links" menu. I checked the settings and everything seems fine. "My Forum" is showing up on the Navbar but not in the "Quick Links". TIA.

[MrEyes]

Originally Posted by Fungsten

Love it. But on one of my forums the link does not show up in the "Quick Links" menu. I checked the settings and everything seems fine. "My Forum" is showing up on the Navbar but not in the "Quick Links". TIA.

Is you navigation bar template edited?

If it has, check that the modifications have included the template hook called:

$template_hook[navbar_quick_links_menu_pos4]

This template hook is used in the "My Forum - Navigation Items Control" plugin, check that this is enable in ACP-Plugin Manager-Product: My Forum. The chances are it is enabled, otherwise you wouldn't get the other nav link

If none of that works, post back here as it is probably a bug

[Fungsten]

Originally Posted by MrEyes

Is you navigation bar template edited?

No. But the "My Forum" link does appear in the bar.

If it has, check that the modifications have included the template hook called:

$template_hook[navbar_quick_links_menu_pos4]

But that is there.

This template hook is used in the "My Forum - Navigation Items Control" plugin, check that this is enable in ACP-Plugin Manager-Product: My Forum. The chances are it is enabled, otherwise you wouldn't get the other nav link

It is enabled.

If none of that works, post back here as it is probably a bug

Is it a bug?

[MrEyes]

Originally Posted by Fungsten

Is it a bug?

Sounds like it doesn't it

Could you tell me what settings you have for:

ACP -> vb Options -> My Forum

• Allowed Usergroups
• Add Navigation Bar Link
• Add Quick Links Navigation
• Add Navigation Items for Guests
• Add Navigation Items for Excluded Usergroups

I have also attached an image that shows where the quick links item should appear

[john102774]

Nice mod. How did you randomly put members avatar on the header like how you had yours?

That's pretty cool.

[MrEyes]

Originally Posted by john102774

How did you randomly put members avatar on the header like how you had yours?

Its not avatars they are member submitted images, I did originally want to use avatars but decided against it as:

• I wanted to be able to filter the images being used (i.e. I didn't want a "questionable" avatar in my header)
• Avatar image sizes aren't fixed so it made alignment etc a little more complicated

This is a simple ish mod that I wrote but unfortunately it isn't exportable as a product (hmmm, should really sort that out). So if you are comfortable with creating your own plugins etc send me a PM and I will send you the details

[Fungsten]

Originally Posted by MrEyes

Sounds like it doesn't it

Could you tell me what settings you have for:



ACP -> vb Options -> My Forum

• Allowed Usergroups
• Add Navigation Bar Link
• Add Quick Links Navigation
• Add Navigation Items for Guests
• Add Navigation Items for Excluded Usergroups

All the usergroups that should be able to use it.
Yes.
Yes.
Yes.
Yes.

I have also attached an image that shows where the quick links item should appear

The image does not appear in the Quick Links.