Social Group and Album Enhancements - Social Group Calendars

In short, this modification will allow social groups on your forum have their own calendar area and have upcoming events shown on their group page. Here is a list of features:

1. Upcoming events for a group are shown on the group's page, grouped by day.
2. The group's next event is shown in more detail and can be configured to show the entire event description or be trimmed to a certain number of characters.
3. Members can see events for all the social groups they belong to consolidated into one calendar.
4. The forum home index page can be setup to show upcoming events for social groups.
5. Non-members can see upcoming events for a public group by viewing the group's page if the group doesn't require joining to view content. They will not see events for these groups in the calendar view or on the forum homepage, which will help keep the clutter down.
6. Group's that are moderated, invite only, or must join to view content, will not display their upcoming events to non-members. Their events are also secured, so following a link to an event by a non-member will result in a no permissions error.
7. Group owners can optionally allow members to be able to post events, or they can set their group up so that only they can post events.
8. When clicking on the New Event link from the group's page, the event will automatically be assigned to the referring group.
9. When creating a new event from the calendar view, the creator can assign the event to any group he has permissions to post events. These events will appear in a drop down box on the event.
10. Admins and moderators can be set to be excluded from all filtering and permissions. This allows the administrator an unfiltered view of the social group calendar, and the ability to move or edit group's events as needed.
11. Plays nice with Farcaster's Event Attendance v3.0 (RSVP mod).

Installation Instructions (Remember to Mark Installed)
Follow the installation instructions available here: https://vborg.vbsupport.ru/showthread.php?p=1999324

Revision Log

• 0.1.0 BETA - 01/28/09 - Initial Version
• 1.0.0 - 04/05/09 - Bug Fixes and Release
• 2.0 - 03/07/10 - Updated to work with vb4.

Known Issues
None at this time.

[Farcaster]

Unfortunately, vBulletin lacks some hooks in key places for events, such as hooks to the event SQL statements. This means that there are a number of file edits needed for this modification. Sorry for that, but I hope it will be worth it! Enjoy!

Step One ? Backup Your Database and vBulletin Files!
This really needs to be said, especially since this version is in BETA. Loss of data/time/business is not the responsibility of the developer. Use at your own risk.

Step Two ? Import the Product File
In the Admin CP, import rah_socialgroup_calendars.xml.

Step Three ? Edit vBulletin File: includes/functions_calendar.php
Note: If you do not want to have Social Group Events show up in the upcoming events section on your forum homepage, then you only need do steps 1 through 7 in this section.

1. Find the first instance of (in function cache_events, near the beginning of the file):

PHP Code:

    $events = $vbulletin->db->query_read_slave("
        SELECT event.*, 


2. Above that add:

PHP Code:

// Social Group Calendar **************************************************
 
    // Exempt administrators and other designated groups.
    $exemptgroups = explode(',',str_replace(' ','',$vbulletin->options['rah_socialcal_admins'])); 
 
    if (is_member_of($vbulletin->userinfo,$exemptgroups)) {
        $exemptsql = " OR 1=1 ";
    }    
    if ($vbulletin->userinfo['userid']) {
        $eventjoin = "     LEFT JOIN ".TABLE_PREFIX."socialgroupmember sgm ON sgm.userid = 0".$vbulletin->userinfo['userid']." AND sgm.groupid = event.socialgroupcalendar 
                        LEFT JOIN (SELECT groupid, name FROM ".TABLE_PREFIX."socialgroup) sg ON sg.groupid = event.socialgroupcalendar";
        $eventwhere = " AND (event.socialgroupcalendar = 0 OR sgm.groupid IS NOT NULL $exemptsql) ";
        $eventselect = " sg.name as socialgroupname, ";
    }
 
    // Social Group Calendar END *********************************************** 


3. Scroll back down and after the comma in ?SELECT event.*,? add:

PHP Code:

$eventselect 


4. Scroll down about five lines to find:

PHP Code:

        LEFT JOIN " . TABLE_PREFIX . "user AS user ON (user.userid = event.userid) 


5. Below that add:

PHP Code:

$eventjoin 


6. Scroll down about four lines to find:

PHP Code:

            visible = 1 


7. Below that add:

PHP Code:

$eventwhere 


8. Find the following (in function build_events, near the end of the file):

PHP Code:

    $events = $vbulletin->db->query_read_slave("
        SELECT eventid, userid, event.title, recurring, recuroption, dateline_from, dateline_to, event.calendarid, IF (dateline_to = 0, 1, 0) AS singleday, customfields,
            dateline_from AS dateline_from_user, dateline_to AS dateline_to_user, utc, dst 


9. Above that add:

PHP Code:

    // Social Group Calendar **************************************************
    $eventjoin = "     LEFT JOIN (SELECT groupid, name FROM ".TABLE_PREFIX."socialgroup) sg ON sg.groupid = event.socialgroupcalendar ";
    $eventselect = ", event.socialgroupcalendar, sg.name as socialgroupname ";
    // Social Group Calendar END *********************************************** 


10. After ?dateline_to AS dateline_to_user, utc, dst?, add:

PHP Code:

$eventselect 


11. Scroll down about two lines and find:

PHP Code:

        INNER JOIN " . TABLE_PREFIX . "calendar AS calendar USING (calendarid) 


12. Below that add:

PHP Code:

$eventjoin 


Step Four ? Edit vBulletin File: forum.php
Note: If you do not want to have Social Group Events show up in the upcoming events section on your forum homepage, you can skip this section entirely. Keep in mind though that if you do have your calendar options set to show events from the calendar that social group events will be posted to, the list will not be filtered and everyone will see them.

1. Find the following:

PHP Code:

// ### TODAY'S EVENTS #################################################
if ($vbulletin->options['showevents'])
{ 


2. Below that add:

PHP Code:

// Social Group Calendar **************************************************
// Get Social Group Memberships    
$usersocialgroups = array();    
if ($vbulletin->userinfo['userid']) {
 
    $getsocialgroups = $vbulletin->db->query_read_slave("
    SELECT groupid 
    FROM ".TABLE_PREFIX."socialgroupmember sgm 
    WHERE sgm.userid = ".intval($vbulletin->userinfo['userid']));
 
    while ($group = $vbulletin->db->fetch_array($getsocialgroups)) {
        $usersocialgroups[]=$group['groupid'];
 
    }        
}
 
// Exempt administrators and other designated groups.
$exemptgroups = explode(',',str_replace(' ','',$vbulletin->options['rah_socialcal_admins']));     
 
if (is_member_of($vbulletin->userinfo,$exemptgroups)) {
    $exempt = true;
}
// Social Group Calendar END *********************************************** 


3. Find the following:

PHP Code:

        {
            $sub = $eventinfo['dateline_from_user'] - (86400 * (intval($eventinfo['dateline_from_user'] / 86400)));
        } 


4. Below that add:

PHP Code:

        // Social Group Calendar **********************************************
        $filterevent = false;
        if ($eventinfo['socialgroupcalendar'] AND !in_array($eventinfo['socialgroupcalendar'],$usersocialgroups)) {
            // This is a social group event, and this is not a member.  Suppress the event
            $filterevent = true;
        }
 
        // Add exception for admins and other designated groups.
        if ($exempt) {
            $filterevent = false;
        }
 
        // Add social group name to event title.
        if ($eventinfo['socialgroupcalendar']) {
            $eventstore[$eventinfo[eventid]]['title'] = "<font style=\"font-weight:bold\">[$eventinfo[socialgroupname]]</font> $eventinfo[title]";
        }        
        // Social Group Calendar END ******************************************* 


5. Immediately below the code you just entered, find:

PHP Code:

        if ($vbulletin->userinfo['calendarpermissions']["$eventinfo[calendarid]"] & $vbulletin->bf_ugp_calendarpermissions['canviewcalendar'] OR ($eventinfo['holidayid'] AND $vbulletin->options['showholidays']))
        { 


6. Replace with:

PHP Code:

        // Edited from original for Social Group Calendar
        if (!$filterevent AND $vbulletin->userinfo['calendarpermissions']["$eventinfo[calendarid]"] & $vbulletin->bf_ugp_calendarpermissions['canviewcalendar'] OR ($eventinfo['holidayid'] AND $vbulletin->options['showholidays']))
        { 


Step Five ? Upload Files
Upload the modified files to the appropriate directory in your forum.

Step Six ? Edit Template: socialgroups_form
1. Find the following:

					<vb:if condition="$show['enable_group_messages']">
					<li>
						<label for="enable_group_messages">
						<input type="checkbox" name="options[enable_group_messages]" id="enable_group_messages" value="1" {vb:raw checked.enable_group_messages} tabindex="1" />
						{vb:rawphrase enable_messages}
						</label>
					</li>
					</vb:if>

2. Below that add:

					<li>
						<label for="member_entered_events">
						<input type="checkbox" name="member_entered_events" id="member_entered_events" value="1" {vb:raw checked.member_entered_events} /> 
						{vb:rawphrase member_entered_events}
						</label>
					</li>

Step Seven ? Edit Template: socialgroups_group

Note: You can adjust the placement of the event block to your liking by changing the positioning in the socialgroups_group template.
1. Find the following:

</vb:if><vb:comment>$show['groupinfo']</vb:comment>

2. Above that add:

<br/>{vb:raw socialgroups_events}<br/>

Step Eight ? Edit Template: calendar_edit
1. Find the following:

		<h2 class="blockhead">{vb:raw pagetitle}</h2>
		<div class="blockbody formcontrols">{

2. Below that add:

{vb:raw socialgroup_dropdown}

Step Nine? Configuration
In the Admin CP, go into vBulletin Options -> Social Group Calendar. Set the options as desired. The product will not start working until a calendar ID is entered in this section. Make sure to configure the calendar selected to allow members to post events.

[cindy helmond]

wow thx we needed this for the normal calender !!
Can you fix that ?

[Farcaster]

Originally Posted by cindy helmond

wow thx we needed this for the normal calender !!
Can you fix that ?

Cindy, what do you mean? What this mod does is provide a cross over from the calendar into social groups.

[cindy helmond]

Originally Posted by Farcaster

Cindy, what do you mean? What this mod does is provide a cross over from the calendar into social groups.

o ok i mean if i dont have an social group i can use this for my default calendar ?
thx

[Farcaster]

Cindy,

This doesn't add any functionality to the calendar other than the tie in with social groups, so no, if your site doesn't use social groups, this mod will not do anything for you.

[DivineMessenger]

This hack doesn't show events on the main calendar unless the member is in the group in which the event is for, correct? Is there a way to make it so everyone can see the event regardless of if they are in the group or not on the main calendar?

[Farcaster]

Originally Posted by DivineMessenger

Is there a way to make it so everyone can see the event regardless of if they are in the group or not on the main calendar?

It is possible, but it isn't a feature of the modification at this point.

[ScottiG]

Will this work with vb 3.8.4? Or do you have a version that does? I have installed your RSVP system on 3.8.4 and it works well, but I am hoping to add calendar functionality to social groups AND the RSVP system, THAT would work VERY well on our forum!

[alessai]

Installed,