vB Event Forums

Introduction

Ok first things first, before we start. This plugin was originally developed by endquote. You can find the old thread here. I have now taken over the plugin development from him, and I will do my best to make this a plugin that is useful for everyone. I have made quite a few changes to the old plugin. If you have been using the old plugin, then skip to the section "I used the old plugin".

What is this plugin?

This is a plugin which allows you to create relationships between calendars and events, giving each event a thread of its own for users to discuss. This plugin is in BETA, so you are installing this on a live board at your own risk. I have tested this alot, and I am running it myself on a live board.

Sure, so whats it do?

Some examples of the features this plugin offers

• When a new event is created in a calendar, an associated thread is created in the linked forum.
• Links to events in the calendar are forwarded to the associated thread.
• New thread links in the event forum are redirected to a new event form.
• A summary can be shown at the top of the event forum which shows the up and coming events over the next 'x' days.
• The date and time shown in the thread and post title, is calculated on the current viewing users timezone. In other words, times always show in the users timezone, not forced to GMT.
• Full moderation support.
• Editing a thread or event, will update its associated event/thread.

Screenshots

Some screenshots of this plugin

• Admin Options
• Event Thread
• Event Thread with Reply
• Thread List

How do I install it?

Please follow the instructions here for upgrading from Version 1.x to Version 2.5.

Step 1

Install the product
Download the product XML file.

Goto your Admin CP at your forums, then goto Plugin System -> Manage Products. Click [Add/Import Product] at the bottom of the page. Browse to the location where you downloaded the xml file and then click the Import button.

Step 2

Calendar ID:
Goto your Admin CP at your forums, then goto Calendar Manager. Find the calendar you want to link to a forum, then click Edit.
Right at the top of the page you should see:

Calendar: NAME (id: ID)

Make a note of the ID, you will need this soon.

Forum ID:
Goto your Admin CP at your forums, then goto Forum Manager. Find the forum you want to activate as your event forum, then click Edit Forum.
Right at the top of the page you should see:

Forum: NAME (id: ID)

Make a note of the ID, you will need this soon.

Link a Calendar to a Forum:
Goto your Admin CP at your forums, then goto vBulletin Options and find Event Forums.
The first option you should see is Calendar/Forum Map.
Enter in your IDs into the box, as CALENDARID:FORUMID.
Example, my Calendar is 5 and my Forum is 14:

5:14

Click Save.

Step 3

Base permissions check:
You will need to check that users using the Event Forums, have basic permissions to both the Linked Forum AND Calendar.
Basic Permissions include: Can View Forum and Can Post Threads and possibly some others.

Step 4

Install on VB.org:
Browse back to this thread, and click the INSTALL button so you can recieve updates whenever I update this plugin.

Can I give you money to make this?

This isn't a commercial plugin, and can be used by anyone for free. However, a few people have said to me that they would like to donate some money for my time working on the plugin and for picking it up and continuing the development of new features etc. If you do want to donate some money my way, then you can do so through paypal by clicking this link. Thanks!

Bugs / Support

If you find a bug, then please post in this thread and let me know. There are a few bugs that haven't been fixed since the old version, so i'm hoping that we can fix these soon. I will do my best to support the plugin as much as possible, however I also have a busy job which takes up alot of my time.

Known Bugs

Here is a list of known bugs to date

• Soft delete actually hard deletes the thread.
• Search doesn't search the first post of an event thread.
• Inline ajax edit bugs thread title. Need to remove date and time from it before edit.

Feature request list

Here is a list of the requested features. Please note that because it makes this list, doesn't mean it will be added.

• Intergration with the event attendance plugin.
• Customisation of the order of the custom fields in the thread title.
• An option to "import" all the previous events from a Calendar into threads.
• Extra post options support (Attachments, Post Icons, Sticky etc).
• Custom ordering of the %datetime variable.
• Custom ordering of %custom variable.
• Better handling of recurring events.

Credits

Thanks to endquote for originally creating the plugin.
Thanks to the Ninja :ninja: for helping me infiltrate the vb code and finding those hidden hooks!
Thanks to anybody that helps test this plugin.

Changelog

Version: 2.7

• All templates should now be cached.
• Optimised the code which hides the first post on an Event Thread.
• Fixed a bug which was causing smilies and images, as well as possibly other BB code to not be parsed correctly.
• Added better error handling on SQL queries, and using vb functions in all places over raw mysql functions.

Version: 2.6

• Added a AdminCP option to choose between using a custom variable to display the Event Details on the Thread Page, or to append it to the end of the navbar.
• Title now updates in last post block after editing event title.
• Single day events no longer adjust the timezone, which was causing the day to show incorrectly in the thread titles and event details for some timezones.

Version: 2.5

• Single day events: Time has been removed from thread title, so it now only displays the date.
• Date and Time (if applicable) are added to Posts and Navbits when viewing a thread.
• Custom Fields are added dynamically along with times and dates. This solves a few bugs, and is in preperation for the AdminCP option for a custom order and look etc.
• Currently merging is disabled for any Event Threads because it is a bit of a tricky job to handle merging Event Threads, and it could take some time.
• Admin option to format Event Thread titles. Note this does not yet include ordering custom fields.
• Inline mod tools should now all work.
• Added [Finish] and [Start] as phrases into the Calendar phrases for use in the Events Summary.
• Ranged Events that cover multiple days, are now displayed better in the Summary, Title, Post and Navbits.

Version: 2.0

• Moderation is now supported! Permissions are taken from the Calendar. Events will show up as Events only (threads are hidden and handled seperatly by the plugin) in the moderation queue.
• Better error handling when creating an event. This should now correctly handle flooding, min chars and any other errors creating a thread could give. An event is NOT created if there was an error creating the thread. Instead it displays the correct error message.
• Event View is now displayed above the threads, similar to how VB.org does with the addons.
• Links added to the event day view, to View Replies and Post a Reply.
• Added a UserCP option to choose which event it should default to when pressing the "New Thread" button.
• Summary is now totally seperate from the Home Page up "and coming events". The summary will now function even if the homepage version is disabled.
• Ranged Events now show the end date if the Event doesn't finish on the same day.
• Problems with DST and Timezones have been solved. There is an update due in VB v3.6 which corrects confusion with DST. See here for more info. This is more specific to Calendar rather than this plugin though, but its relevant.
• Moving an event to a Calendar not run by the Plugin will remove the link to the assosiated thread.
• Moving an event to a Calendar run by the Plugin will attempt to also move the thread linked to it, to the correct forum.
• Moving a thread to a different event forum, will attempt to move the event to the correct calendar.
• Moving a thread outside an event forum, removes the link to the assosiated event.
• Delete thread or first post now forwards to the Delete Event. Allowing soft-delete of events is something to consider, but for now it only supports Perma Deleting. This would be made much easier if soft deleting events was something supported in the native VB code.
• Fixed Deleting an Event and it now properly updates the forum counters, so the last thread should be correct.
• Event Summary template addition is no longer necessary. A seperate template is added and handled by the plugin.
• Event Summary in the forum now only shows the events for that forum/calendar link.

Version: 1.0

• Taken over development from Endquote. Fixed alot of bugs, I can't remember what now.

[jerx]

Originally Posted by noonespecial

How do you define what forum this posts into? I can't figure that out for the life of me..

You set the mapping between calendar and forum in vbulletin options. Select the event forums setting group. There you specify the calendarid first and then comes the forum id, eg 1:10 (calendar id 1:forum id 10).

[chipsndip]

This is a great hack, and looks a lot better than the last version. I only wish I could customize the title like was mentioned earlier. I may dig into the code where it builds the title and modify it myself soon... Time to pull out that PHP reference and learn some more.

[Evercraft]

First of all my deepest apologies. I thought I had posted an update of what was happening, but it seems I didn't and i've left you all in the Dark for a long time. I'm really really sorry! Things have been really busy, and I basically just stopped whatever I was doing on this for a while. However...

:banana:

I think you will all be interested to hear that vB Event Forums is now at Version 2.5. Version 2 was finished mid week, and i've got to Version 2.5 from doing various tweaks and bug fixes after running with it live for a few days. I'm sure there is still some bugs there, but hopefully i'll get time to fix as many as possible.

Here are the changelogs for the versions. I realise they are a bit big, but I urge you to read through them properly, there is some really big changes! Some of the most notable is how the Event is displayed on the Thread Page & Moderation support. I really feel like this plugin is super close to going Gold now.

Version: 2.5

• Single day events: Time has been removed from thread title, so it now only displays the date.
• Date and Time (if applicable) are added to Posts and Navbits when viewing a thread.
• Custom Fields are added dynamically along with times and dates. This solves a few bugs, and is in preperation for the AdminCP option for a custom order and look etc.
• Currently merging is disabled for any Event Threads because it is a bit of a tricky job to handle merging Event Threads, and it could take some time.
• Admin option to format Event Thread titles. Note this does not yet include ordering custom fields.
• Inline mod tools should now all work.
• Added [Finish] and [Start] as phrases into the Calendar phrases for use in the Events Summary.
• Ranged Events that cover multiple days, are now displayed better in the Summary, Title, Post and Navbits.

Version: 2.0

• Moderation is now supported! Permissions are taken from the Calendar. Events will show up as Events only (threads are hidden and handled seperatly by the plugin) in the moderation queue.
• Better error handling when creating an event. This should now correctly handle flooding, min chars and any other errors creating a thread could give. An event is NOT created if there was an error creating the thread. Instead it displays the correct error message.
• Event View is now displayed above the threads, similar to how VB.org does with the addons.
• Links added to the event day view, to View Replies and Post a Reply.
• Added a UserCP option to choose which event it should default to when pressing the "New Thread" button.
• Summary is now totally seperate from the Home Page up "and coming events". The summary will now function even if the homepage version is disabled.
• Ranged Events now show the end date if the Event doesn't finish on the same day.
• Problems with DST and Timezones have been solved. There is an update due in VB v3.6 which corrects confusion with DST. See here for more info. This is more specific to Calendar rather than this plugin though, but its relevant.
• Moving an event to a Calendar not run by the Plugin will remove the link to the assosiated thread.
• Moving an event to a Calendar run by the Plugin will attempt to also move the thread linked to it, to the correct forum.
• Moving a thread to a different event forum, will attempt to move the event to the correct calendar.
• Moving a thread outside an event forum, removes the link to the assosiated event.
• Delete thread or first post now forwards to the Delete Event. Allowing soft-delete of events is something to consider, but for now it only supports Perma Deleting. This would be made much easier if soft deleting events was something supported in the native VB code.
• Fixed Deleting an Event and it now properly updates the forum counters, so the last thread should be correct.
• Event Summary template addition is no longer necessary. A seperate template is added and handled by the plugin.
• Event Summary in the forum now only shows the events for that forum/calendar link.

I've updated the Plugin Info page to show better installation instructions, which should hopefully help out those having trouble installing and setting this up. I've also added a few screenshots to those who were asking for them. Bit late I know, but better late than never!

If your upgrading, please follow the instructions here for upgrading to Version 2.5.

[Evercraft]

Upgrading from Version 1.x to Version 2.5

Step 1
Admin CP -> Styles & Templates -> Style Manager -> <style name> -> Edit Template

Double Click Calendar Templates
Double Click calendar_showeventsbit

Find and remove the green:

<td class="tcat"><if condition="$eventinfo[nwt_threadid]"><a href="showthread.php?t=$eventinfo[nwt_threadid]"></if>$eventinfo[title]<if condition="$eventinfo[nwt_threadid]"></a></if></td>

Step 2
Admin CP -> Styles & Templates -> Style Manager -> <style name> -> Edit Template

Double Click Forum Display Templates
Double Click FORUMDISPLAY

Find:

$announcebits

And below it remove all of:

<if condition="$show['upcomingevents']">
	<tr>
		<td class="thead" colspan="<if condition="$show['threadicons'] AND $show['inlinemod']">7<else /><if condition="!$show['threadicons'] AND !$show['inlinemod']">5<else />6</if></if>">
			<a style="float:$stylevar[right]" href="#top" onclick="return toggle_collapse('forumhome_events')"><img id="collapseimg_forumhome_events" src="$stylevar[imgdir_button]/collapse_thead$vbcollapse[collapseimg_forumhome_events].gif" alt="" border="0" /></a>
			<if condition="$show['todaysevents']">$vbphrase[todays_events]<else /><phrase 1="$lv_vb_eventforums_showDays">$vbphrase[upcoming_events_for_the_next_x_days]</phrase></if>
		</td>
	</tr>
	<tr id="collapseobj_forumhome_events" style="$vbcollapse[collapseobj_forumhome_events]">
		<td class="alt2"><a href="calendar.php$session[sessionurl_q]"><img src="$stylevar[imgdir_misc]/calendar.gif" alt="$vbphrase[calendar]" border="0" /></a></td>
		<td class="alt1" width="100%" colspan="<if condition="$show['threadicons'] AND $show['inlinemod']">6<else /><if condition="!$show['threadicons'] AND !$show['inlinemod']">4<else />5</if></if>"><div class="smallfont">$upcomingevents</div></td>
	</tr>
</if>

Step 3
Download the latest product XML file.

Goto your Admin CP at your forums, then goto Plugin System -> Manage Products.

Click [Add/Import Product] at the bottom of the page. Browse to the location where you downloaded the xml file and click the OVERWRITE check box. Then click the Import button.

[PennylessZ28]

Excellent work, very much appericated. Thank you for your hard work and effort.

[Hell?]

This was a very nice surprise in my inbox, thank you very much for the excellent update and all the hard work.

[SMO]

have a little issue. I put the event on the 2nd and in the titleit says the day prior. So, i had to schedule it on the day ahead of time to make it show in the title to say when the event actually happen..did that make sense?

[xfaethorx]

it looks excellent but I need the event attendance hack to be bound in with it.

[Evercraft]

Originally Posted by SMO

have a little issue. I put the event on the 2nd and in the titleit says the day prior. So, i had to schedule it on the day ahead of time to make it show in the title to say when the event actually happen..did that make sense?

errm not sure I fully understand. Could you perhaps post a screenshot, or maybe a more detailed example? Also, what type of event is it (i.e Single Day (no times), Ranged (with times), Recuring).

[klaush]

Thanks! But still not working. Permissions are set correctly; even when adding an event and tried to save he wants to have an username and to click the back button.

Any idea?