Calendar Enhancements - vB Event Forums

Introduction

This is a continuation of my Event Forums plugin/addon from 3.5. You can find the old version here. The original plugin was developed by Endquote, and I have since taken it over to bring it to what it is today. I hope you can find it useful!

What is this addon?

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. 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, or optionally a seperate New Event button can be added with a minor template edit.
• 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?

For upgrading, please see the section below.

Summary

• 1 xml import.
• 1 (optional) template change.
• 1 (optional) gif file upload.

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 (Optional template edit)

Add the New Event button:
You only need todo this if you want to show a seperate New Event button next to the New Thread button.

First of all, upload newevent.gif to your images/buttons folder. NOTE you will need to upload this to any custom image folders too for different styles you might have.

Second, open up FORUMDISPLAY template for each of your styles you want to show the button, find and add the highlighted code below:

<td class="smallfont"><if condition="$show['newthreadlink']">
<a href="newthread.php?$session[sessionurl]do=newthread&amp;f=$foruminfo[forumid]" rel="nofollow"><img src="$stylevar[imgdir_button]/newthread.gif" alt="$vbphrase[post_new_thread]" border="0" /></a>
<if condition="$show['neweventlink']">&nbsp;<a href="newthread.php?$session[sessionurl]do=newevent&amp;f=$foruminfo[forumid]" rel="nofollow"><img src="$stylevar[imgdir_button]/newevent.gif" alt="$vbphrase[lv_vb_eventforums_phrase_post_new_event]" border="0" /></a></if>
<else />&nbsp;</if></td>

Lastly, go into the Event Forums options, and change the option Show the New Event button on the thread list to yes.

Step 5

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

How do I upgrade it from an old version?

Step 1

Import xml
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. Make sure the overwrite option is set to ON and then click the Import button.

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: 3.3

• Added Farcasters Event Attendance patch to the mod. I've added a self check so it will only run when the Event attendance mod is installed and active.

Version: 3.2

• Fixed a bug which was prevent the thread from being deleted when you try to delete an event.

Version: 3.1

• Fixed a bug which would cause an error with undefined function on the forum display page when summary is turned on.

Version: 3.0

• Version now compatible with 3.6. Please note this plugin will no longer install on a board older than 3.6. I would recommend you upgrade your board as soon as you can!
• Added an optional template edit to show a New Event button next to the New Thread button.
• Plugin no longer in BETA. I feel this has been running enough stablely to take this out of BETA. There are still some bugs which need fixing, but as a whole it works and is used by quite a few people.

Version: 2.7 and below

• See the old thread here

[Joe1967]

Originally Posted by Caerydd

new calender entries will be added as new threads. Currently existing threads will not be affected.

thank you!

[credenscel]

Originally Posted by credenscel

I have installed this on my site and have it set so all my regional sections will have the event option. However, when people try to post an event, besides in the southern california section (i.e. midwest...) the event defaults back to southern california. is there a way to fix this?
here's the link to the regional forums..
http://www.wiredonhonda.com/vb/forumdisplay.php?f=4

The "summary" is showing up on all 4 of the regional forum sections, but the event itself only gets posted in the southern california section. Please help!

thanks

Hi would someone please respond to this one? I uninstalled this hack and re-installed it and am having the same issue. Your assistance will be appreciated.

[powerful_rogue]

ive got it running on 3.7.0RC2 with no problems.

[kderentz]

Originally Posted by credenscel

Hi would someone please respond to this one? I uninstalled this hack and re-installed it and am having the same issue. Your assistance will be appreciated.

I was having the same issue ... I had to create different calendars for each forum. I really wanted one master calendar and regional forums that separate the events by region but I cant seem to get that to work.

Is there any way we can have one master calendar and have the posts broke up in different forums say for example based on region?

[kderentz]

Need some major help guys. ... like a retard I thought a new version of this mod came out and I upgraded my existing install. Now when you add an event I getting a double post

any ideas???

its like its double posting this:

<form action="calendar.php?do=manage&amp;e=$eventinfo[eventid]"

but fi you look at my "calendar_showeventsbit" template it looks fine ...

$spacer_open
<div style="padding:0px 0px $stylevar[cellpadding]px 0px">

<form action="calendar.php?do=manage&amp;e=$eventinfo[eventid]" method="post">
<input type="hidden" name="s" value="$session[sessionhash]" />
<input type="hidden" name="do" value="manage" />
<input type="hidden" name="e" value="$eventinfo[eventid]" />

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
	<td class="tcat">$eventinfo[title]</td>
</tr>
<tr>
	<td class="thead" style="font-weight:normal"><strong>$vbphrase[calendar]</strong>: $calendarinfo[title]</td>
</tr>
<tr>
	<td class="alt1">
		<table cellpadding="0" cellspacing="0" border="0" width="100%">
		<tr valign="bottom">
			<td align="$stylevar[left]"><if condition="$show['postedby']"><a class="bigusername" href="member.php?$session[sessionurl]u=$eventinfo[userid]">$eventinfo[musername]</a><else />&nbsp;</if></td>
			<td align="$stylevar[right]"><if condition="$show['subscribed']"><img class="inlineimg" src="$stylevar[imgdir_misc]/subscribed_event.gif" alt="$vbphrase[event_reminder]" /><else />&nbsp;</if></td>
		</tr>
		</table>
		
		<div class="smallfont">
			<if condition="$show['subscribelink']">
				<div style="float:$stylevar[right]">
					<if condition="$show['subscribed']">
						<a href="calendar.php?do=deletereminder&amp;e=$eventinfo[eventid]">$vbphrase[delete_reminder_for_this_event]</a>
					<else />
						<a href="calendar.php?do=addreminder&amp;e=$eventinfo[eventid]">$vbphrase[request_reminder_for_this_event]</a>
					</if>
				</div>
			</if>
			<if condition="$show['recuroption']">
				$recurcriteria<br />
				<phrase 1="$date1" 2="$date2">$vbphrase[date_x_to_y]</phrase><if condition="$show['adjustedday']">*</if>
				<br /><span class="time"><phrase 1="$time1" 2="$time2">$vbphrase[time_x_to_y]</phrase></span>
			<else />
				<if condition="$show['holiday'] OR $show['singleday']">
					$eventdate
				<else />
					<if condition="$show['daterange']"><phrase 1="$date1" 2="$date2">$vbphrase[date_x_to_y]</phrase><else />$eventdate</if> <span class="time"><phrase 1="$time1" 2="$time2">$vbphrase[time_x_to_y]</phrase></span>
				</if>
			</if>
			<if condition="$show['ignoredst']">
			<div>* $vbphrase[event_ignores_dst]</div>
			</if>
			<if condition="$show['adjustedday']">
				<div>* <phrase 1="$eventinfo[timezone]">$vbphrase[event_posted_for_timezone_x]</phrase></div>
			</if>		
		</div>
	</td>
</tr>
<tr valign="top">
	<td class="alt2">
		
		<if condition="$show['customfields']">
			$customfields
			<hr size="1" style="color:$stylevar[tborder_bgcolor]" />
		</if>
		
		<div>$eventinfo[event]</div>
		
		<if condition="$show['eventoptions']">
			<div style="margin-top:$stylevar[cellpadding]px" align="$stylevar[right]">
				<select name="what" onchange="this.form.submit();">
					<option value="">$vbphrase[event_options]</option>
					<if condition="$show['caneditevent']">
						<option value="edit">:: &nbsp; $vbphrase[edit_event]</option>
					</if>
					<if condition="$show['candeleteevent']">
						<option value="delete">:: &nbsp; $vbphrase[delete_event]</option>
					</if>
					<if condition="$show['canmoveevent']">
						<option value="move">:: &nbsp; $vbphrase[move_event]</option>
					</if>
				</select>$gobutton	
			</div>
		</if>
		
	</td>
</tr>
</table>

</form>

$rsvp_form

</div>
$spacer_close

EDIT: I got it working but had to deinstall it and reinstall it.

[atomhead]

Can the author or someone else make this work with gWoWevents?
https://vborg.vbsupport.ru/showthread.php?t=170592

I installed this mod, it creates the thread in the forum specified, but I get a message "You are not authorised to signup for this event" after I create it. I checked permissions and I have access to both the calendar and the forum.

[MikeJeffs]

Is it possible to have the event threads creates in a pre-existing forum that is used for other posts as well?

I don't want a seperate events forum, I want the event threads to be included in my main discussion forum.

Thanks

[scan-pa]

I updated to vB 3.7.0 Gold and this hack causes the following error msg.

Fatal error: Cannot run code from this file in conjunction with non encoded files in /home/*********/public_html/forum/includes/searchwords.php on line 653

Can we please get this hack updated to work on vB 3.7.0 Gold.

This and Autodate both cause the same error msg. the 3rd. hack that was giving me this problem was fixed by adding code about a security token. could this be the answer to these errors?

Thanks,

[Caerydd]

Evercraft hasn't been on vb.org for a good 8 months now. I think thincom2000 was considering releasing a better version of this after 3.7 went gold, but I don't know how much work he has done on that.

Either way, gold has only been out for 2 days and both this and farcaster's event attendance are only sporadically maintained, so please give the developers (and potential developers) time to pick this up before demanding updates.

[Ted S]

Originally Posted by scan-pa

I updated to vB 3.7.0 Gold and this hack causes the following error msg.

Fatal error: Cannot run code from this file in conjunction with non encoded files in /home/*********/public_html/forum/includes/searchwords.php on line 653

Can we please get this hack updated to work on vB 3.7.0 Gold.

This and Autodate both cause the same error msg. the 3rd. hack that was giving me this problem was fixed by adding code about a security token. could this be the answer to these errors?

Thanks,

You may want to reinstall as that's a mighty odd error (and doesn't seem to have anything to do with the security token change). I've got this running on 3.7.0 gold with no issues...