The Arcive of Official vBulletin Modifications Site.

Social Group Calendars · **Released**: 01-27-2009

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:

Upcoming events for a group are shown on the group's page, grouped by day.
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.
Members can see events for all the social groups they belong to consolidated into one calendar.
The forum home index page can be setup to show upcoming events for social groups.
Non-members can see upcoming events for a public group by viewing the group's page. They will not see events for these groups in the calendar view or on the forum homepage, which will help keep the clutter down.
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.
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.
When clicking on the New Event link from the group's page, the event will automatically be assigned to the referring group.
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.
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.
Plays nice with Farcaster's Event Attendance v2.0 (RSVP mod).

Installation Instructions (Remember to Mark Installed)
Follow the installation instructions available here: https://vborg.vbsupport.ru/showpost....07&postcount=2

Revision Log

0.1.0 BETA - 01/28/09 - Initial Version
1.0.0 - 04/05/09 - Bug Fixes and Release (Upgrade Instructions)

Known Issues
None at this time.

Farcaster · #2 01-28-2009, 09:13 AM

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_1_0_0.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: index.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:

HTML Code:

<legend>$vbphrase[group_options]</legend>
<div class="smallfont">

2. Below that add:

HTML Code:

<div>
    <label for="member_entered_events"><input type="checkbox" name="member_entered_events" id="member_entered_events" value="1" $checked[member_entered_events]/> $vbphrase[member_entered_events]</label>
</div>

Step Seven – Edit Template: socialgroups_group
Note: If you’re trying to install this on version 3.7.x, the section you put the variable in will be different. Try putting it above  for instance, and then adjust to be located where you want.

1. Find the following:

HTML Code:

    </div><br />
</if>
 
 
<!-- Discussions -->

2. Above that add:

HTML Code:

$socialgroups_events

Step Eight – 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.

Farcaster · #3 01-28-2009, 09:15 AM

I have confirmed this to be working on vBulletin version 3.8.1. I assume that it will also work with version 3.7.x. If someone installs it on that version, please confirm if it works appropriately.

Vaupell · #4 01-28-2009, 09:34 AM

Lovely, i simply dont understand why this wasent a standard feature..

tx.. :up: :up: :up: :up: :up:

Farcaster · #5 01-28-2009, 12:41 PM

I don't either. The calendar is truly a bit underdeveloped, and the idea of events goes very well with social groups...

RvG2 · #6 01-28-2009, 01:29 PM

Quote:

Originally Posted by Vaupell

Lovely, i simply dont understand why this wasent a standard feature..

tx.. :up: :up: :up: :up: :up:

You are right.

Trek · #7 01-28-2009, 05:09 PM

Going to install this now, I think this will do what I've been looking for. =)

Trek · #8 01-28-2009, 05:16 PM

Ok, one question. Is there any way (with this mod or something else) to automatically assign someone to a social group? I hope so, or my idea is dead before it gets started. heh

I guess what I'm looking for is social groups based on user group. Or if that's not possible, the ability to automatically give someone access to a social group when they are added to a specific user group.

Farcaster · #9 01-28-2009, 06:34 PM

Quote:

Originally Posted by Trek

I guess what I'm looking for is social groups based on user group. Or if that's not possible, the ability to automatically give someone access to a social group when they are added to a specific user group.

No, I'm afraid this mod doesn't do that. Nor do I know of one that does.

Trek · #10 01-28-2009, 06:49 PM

Quote:

Originally Posted by Farcaster

No, I'm afraid this mod doesn't do that. Nor do I know of one that does.

Bummer... I think this mod will do everything I need other than the auto adding to the social group. I'll do that manually I suppose until figure out something else.

Maybe I'll just write a query that adds everyone in a usergroup to a social group every night on a cron... that should work, but not really the cleanest way to go about it.

With that, this mod and your RSVP mod, I think everything I need to accomplish will work. Thanks!

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.13544 seconds Memory Usage 2,396KB Queries Executed 24 (?)
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 (4)bbcode_html (18)bbcode_php (3)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (4)navbar_link (120)option (1)pagenav (1)pagenav_curpage (2)pagenav_pagelink (10)post_thanks_box (10)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (10)post_thanks_postbit_info (9)postbit (6)postbit_attachment (10)postbit_onlinestatus (10)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 post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_attachment 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:

The Arcive of Official vBulletin Modifications Site.

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