The Arcive of Official vBulletin Modifications Site.

vB Event Forums · **Released**: 08-07-2006

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

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:

Quote:

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:

Quote:

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:

Quote:

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

thincom2000 · #**262** 02-19-2007, 05:05 AM

In order to add attachments to your forum events (once the event is posted):

Create new plugin.

Product: Lv vB Event Forums
Title: Attachment Permissions
Hookname: showthread_post_start
Phpcode:

PHP Code:


			
$show['caneditattach'] = ($threadinfo['lv_vb_eventforums_eventid'] AND $forumperms & $vbulletin->bf_ugp_forumpermissions['canpostattachment'] AND $vbulletin->userinfo['userid'] AND !empty($vbulletin->userinfo['attachmentextensions'])) ? true : false;

FILE EDIT: calendar.php

Find:

PHP Code:


			
        case 'edit':
        {
            $_POST['do'] = 'edit';
        }
        break;

Add underneath:

PHP Code:


			
        case 'attach':
        {
            $eventpostid = $db->query_first("
                SELECT firstpostid 
                FROM " . TABLE_PREFIX . "thread
                WHERE lv_vb_eventforums_eventid = $eventinfo[eventid]
            ");

            exec_header_redirect($vbulletin->options['bburl'] . '/editpost.php?p=' . $eventpostid[firstpostid]);
        }
        break;

TEMPLATE EDITS: editpost

Find:

Code:

<if condition="$show['deletepostoption']">

Add above:

Code:

<if condition="$attachments_only"><div style="visibility: hidden; position: absolute"></if>

Find:

Code:

$postpreview

Add underneath:

Code:

<if condition="$attachments_only"></div></if>

Find:

Code:

<form name="vbform" action="editpost.php?do=updatepost&amp;p=$postid" method="post"<if condition="!is_browser('webtv')"> onsubmit="return vB_Editor['$editorid'].prepare_submit(0, $vboptions[postminchars])"</if>>

Add underneath:

Code:

<if condition="$attachments_only"><div style="visibility: hidden; position: absolute"></if>

Find:

Code:

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
	<td class="tcat">
		<a style="float:$stylevar[right]" href="#top" onclick="return toggle_collapse('newpost_options')"><img id="collapseimg_newpost_options" src="$stylevar[imgdir_button]/collapse_tcat$vbcollapse[collapseimg_newpost_options].gif" alt="" border="0" /></a>

Add above:

Code:

<if condition="$attachments_only"></div></if>

Find:

Code:

<div class="panel">
		<div style="width:$stylevar[formwidth]" align="$stylevar[left]">

Add underneath:

Code:

<if condition="$attachments_only"><div style="visibility: hidden; position: absolute"></if>

Find:

Code:

$attachmentoption

Replace with:

Code:

<if condition="$attachments_only"></div></if>
	
				$attachmentoption
						
<if condition="$attachments_only"><div style="visibility: hidden; position: absolute"></if>

Find:

Code:

</div>
			</div>
			
			<div style="margin-top:$stylevar[cellpadding]px">
				<input type="submit" class="button" name="sbutton" value="$vbphrase[save_changes]" accesskey="s" tabindex="1" />
				<input type="submit" class="button" name="preview" value="$vbphrase[preview_changes]" accesskey="r" tabindex="1" />
<if condition="$attachments_only">

Replace with:

Code:

				<if condition="$attachments_only"></div></if>

				</div>
			</div>
			
			<div style="margin-top:$stylevar[cellpadding]px">
				<input type="submit" class="button" name="sbutton" value="$vbphrase[save_changes]" accesskey="s" tabindex="1" />
<if condition="$attachments_only"><div style="visibility: hidden; position: absolute"></if>
				<input type="submit" class="button" name="preview" value="$vbphrase[preview_changes]" accesskey="r" tabindex="1" />
<if condition="$attachments_only"></div></if>

TEMPLATE EDITS: calendar_showeventsbit

Find:

Code:

<div>$eventinfo[event]</div>

Add underneath:

Code:

		<if condition="$show['attachments']">
<br />
		<!-- attachments -->
			<div style="padding:$stylevar[cellpadding]px">
			
			<if condition="$show['thumbnailattachment']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attached_thumbnails]</legend>
					<div style="padding:$stylevar[formspacer]px">
					$eventinfo[thumbnailattachments]
					</div>
				</fieldset>
			</if>
		
			<if condition="$show['imageattachment']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attached_images]</legend>
					<div style="padding:$stylevar[formspacer]px">
					$eventinfo[imageattachments]
					</div>
				</fieldset>
			</if>
			
			<if condition="$show['imageattachmentlink']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attached_images]</legend>
					<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
					$eventinfo[imageattachmentlinks]
					</table>
					</fieldset>
			</if>
			
			<if condition="$show['otherattachment']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attached_files]</legend>
					<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
					$eventinfo[otherattachments]
					</table>
				</fieldset>
			</if>
			
			<if condition="$show['moderatedattachment']">
				<fieldset class="fieldset">
					<legend>$vbphrase[attachments_pending_approval]</legend>
					<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0">
					$eventinfo[moderatedattachments]
					</table>
				</fieldset>		
			</if>
			
			</div>
		<!-- / attachments -->
</if>

Find:

Code:

<if condition="$show['caneditevent']">
						<option value="edit">:: &nbsp; $vbphrase[edit_event]</option>
					</if>

Add underneath:

Code:

<if condition="$show['caneditattach']">
<option value="attach">:: &nbsp; Edit Attachments</option>
</if>

I think that's everything I did. In order to add attachments at the same time you create the event a LOT more edits were necessary and I didn't have the patience for it. Adding them after creation was good enough for me.

stwilson · #**263** 02-20-2007, 01:15 AM

Quote:

Originally Posted by thincom2000

It would be really nice if we could add attachments to events. Right now I have to do it manually in the database.

I second that!!! That would be a nice feature add.

bugzy · #**264** 02-23-2007, 07:07 AM

Quote:

Originally Posted by mrjbs

I have the same problem...no new event button. The button will show if the <if></if> is removed. But then it will show in all of the forums. Is there a different if statement that could be used to choose the forum that it will show up in?

i have the same issue

the New Events wont show up after following the instructions

thincom2000 · #**265** 02-28-2007, 12:11 AM

There's a setting for this:

Show the New Event button on the thread list.
Setting this to no will change the New Thread button to forward the user to the add event form.

Setting this to yes will add a New Event button, ONLY if you have also added the necessary template modification in FORUMDISPLAY. See the installation instructions for more information.

Is it set to yes?

stwilson · #**266** 02-28-2007, 03:20 AM

Quote:

Originally Posted by bugzy

i have the same issue

the New Events wont show up after following the instructions

I can only get it to show in mine if I have the Summary of events set to yes. I have updated the template to allow it to show but it does not....even when the setting is set to Yes, while the Summary option is set to no.

thincom2000 · #**267** 02-28-2007, 10:12 AM

Quote:

Originally Posted by stwilson

I can only get it to show in mine if I have the Summary of events set to yes. I have updated the template to allow it to show but it does not....even when the setting is set to Yes, while the Summary option is set to no.

This is because the plugin for forumdisplay_complete that sets $show['neweventlink'] to true uses the condition:

PHP Code:


			
if(($lv_vb_eventforums_showSummaryThisThread) && ($lv_vb_eventforums_thisCalendar > 0))

I am thinking then that what you were experiencing was intentional on the coder's behalf.

objectuser · #**268** 03-03-2007, 10:56 PM

I was trying to change the display of the thread title in the forum display and accomplished that. I updated it by updating the product-lv_vb_eventforums_v3_3.xml file and installing it with "Allow Overwrite" set to Yes.

After my update, the thread title is showing up twice in the thread view (if that's the right term). I've attached an image of what is going on.

If anyone can tell me what went wrong and how to fix it, I would certainly appreciate it. I tested this change on my test forum, but didn't notice the duplication until I had applied it to my live forum.

thincom2000 · #**269** 03-04-2007, 02:12 AM

Check your postbit_display_start hook for Hide the first post on Event Threads. It seems like the first post is not being hidden, and since it's still the firstpostid, would be still be using the showeventsbit template over the regular postbit.

objectuser · #**270** 03-04-2007, 02:55 AM

Quote:

Originally Posted by thincom2000

Check your postbit_display_start hook for Hide the first post on Event Threads. It seems like the first post is not being hidden, and since it's still the firstpostid, would be still be using the showeventsbit template over the regular postbit.

Thanks for the response.

Okay, I found the hook and it's active. I tried rolling back the software in my test forum and it still shows double.

Looking at the content now.

Update: it's definitely getting in that inner condition that does: $this->templatename = '';
Update 2: somehow, Display Event Details on Thread Page/showthread_complete got turned on, while the event attendance/event forum integration actually turns it off. So I'm not sure how I messed it up, but it seems fine now.

thincom2000, thanks for getting me started on this.

thincom2000 · #**271** 03-04-2007, 06:04 PM

You had two copies of the showthread_complete plugin? I thought the integration removes the original too, but I'm glad you solved it.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.05643 seconds Memory Usage 2,369KB Queries Executed 25 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (19)bbcode_code (4)bbcode_php (8)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (6)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (3)pagenav_pagelinkrel (11)post_thanks_box (1)post_thanks_box_bit (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (1)post_thanks_postbit (11)post_thanks_postbit_info (10)postbit (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start fetch_musername post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end post_thanks_function_fetch_thanks_bit_start post_thanks_function_show_thanks_date_start post_thanks_function_show_thanks_date_end post_thanks_function_fetch_thanks_bit_end post_thanks_function_fetch_post_thanks_template_start post_thanks_function_fetch_post_thanks_template_end postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

Благодарность от:
Toorak Times

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!