Mini Calendar

[Colin F]

Mini Calendar

What it does:
The Mini Calendar is just what it's name says. It allows you to add a small calendar to any or all vBulletin page(s). It links back to the month, next and previous month as well as any days with an event.

Is it complicated?
Installation is easy. Just include the cal.php file on any page that you want it shown, make one new template and insert $smallcalendar at the exact place you want it shown. Look at the instructions below.

Changes:
New files (1):
cal.php

Changed files(0-1):
depending on where it should be shown

New database fields/tables(0):
none

New templates(1):
small_calendar

Changed templates(1-2):
wherever mini calendar should be shown
(phpinclude_start, if shown on all pages)

New phrases(0):
none

Screenshots:
see attachments

screenshot1.jpg (https://vborg.vbsupport.ru/attachment.php?attachmentid=20082&stc=1)
screenshot2.jpg (https://vborg.vbsupport.ru/attachment.php?attachmentid=20083&stc=1)
Instructions:

Backup all your files as well as your database.
For help backing up your database, look here: http://www.vbulletin.com/docs/html/main/manual_database_backup
Upload cal.php (attachment (https://vborg.vbsupport.ru/attachment.php?attachmentid=20081&stc=1)) to your forum home directory
Make a new template with the name small_calendar and insert the contents of template.txt (attachment (https://vborg.vbsupport.ru/attachment.php?attachmentid=20084&stc=1)) into it
Decide if you want to have your mini calendar on specific pages or on all your pages

If you decide to have the mini calendar on all your pages (for example in a sidebar) edit your phpinclude_start template and add include ("cal.php"); to the end of it.
If you only want the mini calendar on specific pages, open the php file that makes that page and under require_once('./global.php'); add include ("cal.php");

edit the template that shows the area in which you want to insert your mini calendar and add $smallcalendar to the exact spot where your mini calendar should be shown.
Donations: This hack will always be free, however your donations are kindly accepted and will help towards further development. If you donate, please leave me some info (either your forum site or username at vB.org) so that I can thank you.
https://vborg.vbsupport.ru/external/2010/02/12.gif (https://www.paypal.com/xclick/business=colin%40jesus.ch&no_shipping=1&cn=vBulletin.org+Username&tax=0&currency_code=USD)

Install:
Don't feel like donating, but still want to thank me for my work? Click the install button to show your appreciation. As a great side effect, you'll get an email update once there is a bigger update or important security fix!
https://vborg.vbsupport.ru/ (https://vborg.vbsupport.ru/vborg_miscactions.php?do=installhack&threadid=68117)

Updates:
10.08.2004: Updated cal.php to fix (hopefully) the events being on the wrong day with far out timezones.

[Colin F]

Tips and Tricks

But its... *english*?!?
To translate the few hardcoded dayvalues, go to lines 21-27 and edit the Su, Mo Tu, We, Th, Fr, Sa values near the end of each line to your liking.
DON'T change these values if you think there's a problem with the first day of the week! The script checks on the browsing users start of week day and changes the mini calendar so that the day is also all the way on the left!

German:
$dayname_su="<td class=\"thead\">Su</td>";
$dayname_mo="<td class=\"thead\">Mo</td>";
$dayname_tu="<td class=\"thead\">Di</td>";
$dayname_we="<td class=\"thead\">Mi</td>";
$dayname_th="<td class=\"thead\">Do</td>";
$dayname_fr="<td class=\"thead\">Fr</td>";
$dayname_sa="<td class=\"thead\">Sa</td>";
French:
$dayname_su="<td class=\"thead\">Di</td>";
$dayname_mo="<td class=\"thead\">Lu</td>";
$dayname_tu="<td class=\"thead\">Ma</td>";
$dayname_we="<td class=\"thead\">Me</td>";
$dayname_th="<td class=\"thead\">Je</td>";
$dayname_fr="<td class=\"thead\">Ve</td>";
$dayname_sa="<td class=\"thead\">Sa</td>";
How can I have it use my other calendar?
If you have more than one calendar and would like mini calendar to pull the events from a different calendar, do the following:

Go to yourforums.com/pathtoyourforum/calendar.php?s=&month=6&year=2004&do=&c=1
Pick the calendar you want to use as the base for mini calendar from the Calendar Jump box on the bottom right.
Now look in your adressbar. The adress should be something like
yourforums.com/pathtoyourforum/calendar.php?s=&month=6&year=2004&do=&c=1Look for the c variable (marked green above) and write that down or remember that or whatever
Edit cal.php. Change the variable $calendarid on line 5 to the value of that c variable you picked out of the adress.
save / reupload

[nexialys]

thanks for the final release!

[PUPSTAHS]

Hi Colin,
Excellent work, but the single all-day events still do not appear correctly for me (and others). Example:

A single all-day event on August 20th appears on the Mini Calendar on August 19th, thereby resulting in an incorrect link and a "no events to display" error from the calendar. Using a ranged event works fine, but all-day events result in erroneous links to the previous day every time.

FYI I did a straight, simple install, with no modifications.

Any help would be great, as I love the idea.

[Colin F]

S***!

Ok...
I'm thinking it has something to do with your timezone. what timezone are you in?

[PUPSTAHS]

Hmm

I'm PST... (-8:00)

[Colin F]

I have an idea... but I don't have access to phpmyadmin here at work. I'll look at it when I come home :)

[spence2]

To be clear ... the .php I alter should look like:

require_once('./global.php');
include ("cal.php");

Is this correct?
So far I'm having trouble getting this to work, so I wanted to clarify.
Thanks.

[Colin F]

To be clear ... the .php I alter should look like:

require_once('./global.php');
include ("cal.php");

Is this correct?
So far I'm having trouble getting this to work, so I wanted to clarify.
Thanks.
That is correct spence2.

[PUPSTAHS]

Regarding the all-day-event bug--

I'm no PHP or vBulletin expert, but it seems strange that a different time zone would be causing a problem that seems to only deal with dates, not times.

I could be wrong tho... mostly I just want my mini-calendar up and kicking :squareeyed:

[Colin F]

If someone with this problem could give me access to their site as well as ftp for trying this out, I would be most grateful.

In the meantime, could someone try the following:
exchange this: $eventdateday = date("mj",$event[dateline_from]);

with this: $eventdateday = vbdate("mj",$event[dateline_from],false,true,false,true);

[PUPSTAHS]

Ok I just tried that out... it seems to fix half of the problem. Now all-day-events are shown on the correct day, but if you click the link, it still goes to the day before.

So for example, before the fix an all-day August 14th event would appear on August 13th and link to August 13th, resulting in an error. Now it appears on August 14th on the mini calendar, but still links to the 13th, so there is still an error.

For more information, here is August 2004 on my mini calendar.

Original, unmodified install:
*12th - Midnight to 9AM
--Correct
*14th - All-day
--Incorrect, the 13th is highlighted/linked instead and the link points to the 13th
*20th - All-day
--Incorrect, the 19th is highlighted/linked instead and the link points to the 19th
*21st (8am) to 22nd (9am)
--Only the 21st is highlighted as having an activity, even tho the event extends over two days
*29th - 8am - 11:30pm
--Correct
*30th - All-day
--Incorrect, the 29th is highlighted/linked instead and the link points to the 29th

Now w/ your fix:
*12th - Midnight to 9AM
--Correct
*14th - All-day
--The correct day is highlighted, but the link points to the 13th, resulting in an error
*20th - All-day
--The correct day is highlighted, but the link points to the 19th, resulting in an error
*21st (8am) to 22nd (9am)
--Only the 21st is highlighted as having an activity, even tho the event extends over two days
*29th - 8am - 11:30pm
--Correct
*30th - All-day
--The correct day is highlighted, but the link points to the 29th, resulting in an error

[spence2]

Hi, Colin ... thanks for the hack!, which I got working on my forumhome ... but, of course, I wanted MORE, so I decided to try to make a second small calendar as well. Here's what I did:

First, I completed the hack for one calendar ... then:

Made second (duplicate) template and named it small_calendar_bal.

Duplicated cal.php and named it bal.php
assigned it to:
$calendarid = 2;
Replaced all instances of $calendarbits with $balendarbits
changed the last line of that file to:
eval("\$smallcalendarbal .= \"".fetch_template("small_calendar_bal")."\";");

Uploaded bal.php
Called it from the template: $smallcalendarbal

Added this in index.php:
require_once('./global.php');
include ("cal.php");
include ("bal.php");

Both instances now link to the correct calendars.
HOWEVER, entries made in either calendar show up as day links in both.
While if incorrect, they link to the "no entry" error page ... it would be sweet if I could correct his one remaining problem.

Any ideas?

[Colin F]

OK, to fix the wrong link problem, find:
$eventday= date("Y-n-j", $event[dateline_from]);

replace with:
$eventday= vbdate("Y-n-j", $event[dateline_from],false,true,false,true);

Do this with all three instances of the find text.
I'll upload an updated cal.php shortly.

[Colin F]

Great that you got it to wrok spence2!

Could you add an event on calendar 1 and an event on a different date in calendar 2?
Then check which event is displayed (linked) on each of your three minicalendars.

[PUPSTAHS]

Works like a dream, thank you! Definitely going to be making good use of this... keep up the good work.

[Colin F]

See the bottom part of my first post to see what's to do if you like/installed the hack ;)

* Colin F is happy it's finally working!

[PUPSTAHS]

See the bottom part of my first post to see what's to do if you like/installed the hack ;)

* Colin F is happy it's finally working!Well it's *close* to perfection :) ... ranged events still don't work! Unlike the mini calendars on the main calendar page, the mini calendar hack only shows the first day of a ranged event as having an event.

i.e. i've got a ranged event from August 14th to 15th, but only August 14th on the mini calendar has a link.

I've been using your hack for the last few days, and I think that's the last bug.

[Colin F]

I also don't use ranged events on my calendar :)

But I'll look into it aswell when I get home this evening.

[spence2]

Great that you got it to wrok spence2!

Could you add an event on calendar 1 and an event on a different date in calendar 2?
Then check which event is displayed (linked) on each of your three minicalendars.

Still have events showing up in all calendars (see post #13).
Thanks

[PUPSTAHS]

I also don't use ranged events on my calendar :)

But I'll look into it aswell when I get home this evening.Hehe... yea, it'd just be a cool feature to have. Also having the preview text for the day's events when you hover over the link would be damn cool.

If you don't get around to it I might give it a shot down the line.

[Colin F]

Can you try it with this file?

I did something for the ranged events...

Eventpreview is kind of complicated. What should I do if there are 5 events? which one is the first?

[PUPSTAHS]

I'd say ignore the ordering... it's more of a nice small feature than anything that should be robust, in my opinion... so just grab the events so people can see what's going on.

As for the ranged events... very close to working. The one bug I have seems to be related to timezone offset. Since I'm PST (-8), any event 4pm or after is showing up for the next day instead.

[Colin F]

Any event that starts 4pm or after is showing up for the next day....

Can you check if this is only for ranged events or also for recurring events?
If so, then it's most probably the utc field in the database...

[Colin F]

Here's an updated file, try this and tell me if it works please...

[PUPSTAHS]

Hmm, that just seems to have pushed the threshold back an hour, to 5pm. The bug happens with any event that allows you to schedule a time.

Anytime that's 5pm or after appears for the next day. So if I have a single-day ranged event from 9pm-11pm on August 10th, the link will appear on August 11th.

[Colin F]

Hmm, that just seems to have pushed the threshold back an hour, to 5pm. The bug happens with any event that allows you to schedule a time.

Anytime that's 5pm or after appears for the next day. So if I have a single-day ranged event from 9pm-11pm on August 10th, the link will appear on August 11th.
Now that's unusual... I have no idea why it should push it back only 1 hour...

[spence2]

Daylight Savings Time?

[Colin F]

I don't see how it can be daylight savings time, as I "actually" didn't touch anything that has to do with that. Thanks for the input though...

Why dont you try changing the three occurences of $theday = date( to $theday = gmdate(

I'll also look into changing the thing checking the date, if that doesn't solve the problem.

[PUPSTAHS]

Ok it has to be a time-zone bug. Because when you enter calendar event data it allows you to choose the timezone, so vbulletin must be doing some additional calculations based on the user's own timezone selection, and the timezone for which the event was added.

Pacific Time (for both event and user setting):
August 14th 8am - 4:30pm ---works fine
August 14th 8am - 5:00pm ---links the 15th as well

[Colin F]

meaning, we have the date going till the 15th.
So I'm assuming vB is actually reading it as: August 14th 4:00pm - August 15th 1:00am

Is this *with* gmdate?

[PUPSTAHS]

Yep, that's exactly what it seems like it's doing, with gmdate. Quite weird.

I wish there were other people trying this out too so I didn't feel insane :o

[Colin F]

If this doesn't work, then I guess I'll have to redo a big part... oh well...

Thanks for helping me sort this out PUPSTAHS

[jlegge]

Is it possible to port this to a page outside of vB? For example, I have my main index at http://www.milwaukeenights.com/index.php and my forums are located in a sub domain at http://forums.milwaukeenights.com . I want to show the mini calendar on my index page outside of vB but some reason I am just getting a blank spot where the calendar should. Not even a db error message or anything, just an empty spot....

[Bieddos]

to put this minicalendar here http://www.elaborare.info/forum/vbulletin/forumdisplay.php?f=25 what i must modificate???

[Ber|Art]

Hi, can you put some examples where to put the "$smallcalendar", where did you put it?

[traderx]

Hello Colin.... I have changed the size to 160 pixels and removed all of the padding... how can I fix the top to be on one line, my month looks like this

< November 2004
>

where can I edit this to take care of it.

[Colin F]

You should be able to edit this in the template, I think the current width is 200, so just exchange that with whatever you want.

[traderx]

BUMP... cuz I edit the post right after I posted, but before your reply..... sorry

[Colin F]

You'll have to use a smaller font size, as that's the problem. Having it on one line will just stretch the table, making it bigger than those 160 pixels you wanted.

[traderx]

Thanks alot... I really like this, I would like to know if you have thought of (or know of one around) creating a scrolling event display that would be clickable that could the same size as the mini calendar. It would/can display the events of that given day and would change to the next days events

Some thing like this:
www.jaxen.com (it's a mambo addon component, but it doesn't change)

Thanks
Coll

[traderx]

Thanks alot... I really like this, I would like to know if you have thought of (or know of one around) creating a scrolling event display that would be clickable that could the same size as the mini calendar. It would/can display the events of that given day and would change to the next days events

Some thing like this:
www.jaxen.com (it's a mambo addon component, but it doesn't change)

Thanks
Coll

Any one?

PLEEEEEEASE :)

[h2ojunkie]

I found a couple bugs for you.

http://www.thumpertalk.com/home.php

Now that it's January, the < arrow to show the previous month is not working.
Is the link for that arrow: http://www.thumpertalk.com/forum/calendar.php?month=0&year=2005&c=1&do=displaymonth

Looks like it needs some kind of logic for if current month is 1, previous month needs to be 12 and year needs to be minus 1 from the current year.

Also, an event on January 8th isn't showing on the small calendar (probably something to do with the time zone thing you guys were talking about)

[MajorFm.com]

can i use ssi to call the cal.php onto a shtml page?

[MajorFm.com]

If not i will be forced to use a iframe in which case can i edit the width of the tables?

[MajorFm.com]

ok i have installed it, shouldn't i be able to see the calender at www.majorfm.com/forum/cal.php?

I get nothing on that...

[yoyoyoyo]

ok i have installed it, shouldn't i be able to see the calender at www.majorfm.com/forum/cal.php?

I get nothing on that...
you are asking the hack to do something that it wasn't designed to do. It works as described.

1) Upload the cal.php file to your forum home directory
2) create the new template small_calendar and add the text provided in the download
3) make the new addition to the phpinclude_start template
4) edit whichever template you want to have the mini calendar by adding $smallcalendar to the exact spot where you want the calendar to appear (If you want it to appear on every page add it to the phpinclude_start template)

Works like a champ!

[MajorFm.com]

Ok, let me put it another way, how can i include it in a blank php file

Then i can include that...

[DRJ]

Great Mod!!

*Clicks Install

[DRJ]

Ok, let me put it another way, how can i include it in a blank php file

Then i can include that...
Why do you want to put it in a blank php file? Just upload the attached cal.php to your forum home directory and include that file.

[DRJ]

Seems to be a small bug. I have my time set as PST gmt-8 and it is 2am on the 26th but the calendar shows the current date is the 25th.

If I change my time to gmt it is then 10am and shows the right date of the 26th. When I set it back to PST it goes back to the wrong date.

Any ideas?

[Colin F]

I know about the timezone bug. I'll try to fix it when I get some time, but don't expect anything soon...

[DRJ]

Sounds good

Great job so far. :)

[bashbang]

This doesn't appear to have been addressed yet. Sorry if this is a repeat.

I was having issues with the mini cal taking a long time to load as well as getting a lot of items href'd that resulted in a link to an event that didn't exist for that day.

It turns out that even though I hard coded the calendar id at the top of cal.php it was searching through events for all calendars. I just added an extra filter onto he SELECT to fix the problem:

Was

$events=$DB_site->query("SELECT dateline_from,title,eventid,utc FROM " . TABLE_PREFIX . "event WHERE (dateline_from BETWEEN $from AND $to) AND visible=1 ORDER BY dateline_from ASC");


To:

$events=$DB_site->query("SELECT dateline_from,title,eventid,utc FROM " . TABLE_PREFIX . "event WHERE (dateline_from BETWEEN $from AND $to) AND visible=1 AND calendarid=$calendarid ORDER BY dateline_from ASC");

[Mighty Mojo]

For sites that use the calendar extensivley, I've suggested a format for the mini-calendar that would allow for easier use:

Ideally, this would plug into Vbadvanced cmps 2

This is what I had in mind for the Mini-calendar ala Vbadvanced--see attached.

The user sees easily navigatable calendar. They can navigate through the months and can see a list of events for each month (or the results can be truncated to a specified number of events, with a more option at the bottom if there are to many events that month). When they refresh the page or return to the page they are given the month that we are currently in again.

The user can cycle through the months seeing all of the events for that corresponding month. They could do this by using the arrows or the ultra-mini calendars.

The ultra-mini calendars on the side would be optional---seeing as they would probably break up the formating of most every other module. (of course this leaves less space for event names, the register option etc. but I bet you could fit all that in there with a small text)

They can register for an event simply by checking the box next to the event---then the admin and/or other users can see who is registered for the event.

A notification can be sent either via PM or email to the user when the event comes within a specified range of time before the event. User or admin controlled.

The user is then prompted upon their next login to let the admin know if they actually attended the event and a poll is created to determine if the event went well---the poll is pulled as a result of all feedback from members that attended the event (poll optional per event and/or globally for all events set by admin)

(Points can be given depending on how often they attend events)

[GSX-Racing]

Can this work on a non vb forum page? For example an index page that doesn't use vB.

[wildondallas]

mighty mojo, did you create the hack for what you have an image attached for?

[MajorFm.com]

Can this work on a non vb forum page? For example an index page that doesn't use vB.ditto

[ngto]

I have searched all morning, and cannot seem to find anyone with a mod/hack to get a mini-calendar or events listing to show independently of vB (so it can be included in an iframe or sucked via http). Does anyone know if this mod does this? I tried and cannot get it to work outside VB

[Bonee70]

I have searched all morning, and cannot seem to find anyone with a mod/hack to get a mini-calendar or events listing to show independently of vB (so it can be included in an iframe or sucked via http). Does anyone know if this mod does this? I tried and cannot get it to work outside VB

Any info so far?

[Eddymvp]

I have searched all morning, and cannot seem to find anyone with a mod/hack to get a mini-calendar or events listing to show independently of vB (so it can be included in an iframe or sucked via http). Does anyone know if this mod does this? I tried and cannot get it to work outside VB

I will make that hack for you once i get home.

[Bonee70]

I will make that hack for you once i get home.

Thx a lot in advance!

[Bonee70]

Anyone may have a hack for non VB pages here?

[andreamarucci]

Is this mod compatible with 3.5.1 and 3.5.2?

Can I use it to display the minicalendar in a php page outside VB?

Thanks in advance

[andreamarucci]

No reply? :ermm:

[andreamarucci]

I will make that hack for you once i get home.

This would be fantastic. When you'll be at home? :nervous:

[andreamarucci]

Not yet at home? :rolleyes:

[Freakpyromaniac]

yes,

Need a calender hack for version 3.5.2 :ermm:

[LBmtb]

Am I just dense or something? I can't find the phpinclude_start template. I'm using vB 3.5.3 btw.

[snyx]

Am I just dense or something? I can't find the phpinclude_start template. I'm using vB 3.5.3 btw.the problem is in the cal.php file
line 113 $events=$DB_site->query("SELECT dateline_from,title,eventid,utc FROM " . TABLE_PREFIX . "event WHERE (dateline_from BETWEEN $from AND $to) AND visible=1 ORDER BY dateline_from ASC"); im trying to debug, but I know little about php :p

[51HipHop]

anyway to include this on non vb pages?

[tommac]

I am using minicalendar.php from the portal download ...

but if I try to click on a date it cant find the page ...

I realize that it does not recognize the module without the /forums/

so it is going to http://www.myfoo.com/calender.php?blahblahblah

rather than to http://www.myfoo.com/forums/calender.php?blahblahblah

is there an easy way to fix that ?

[MamboCube]

i also need this to work on a page outside of vb. It includes global, as i use the user information for my site aswell as the forum.

Would really appreciate it if someone can sort this out!

Thanks!

[Zweeper]

Am I just dense or something? I can't find the phpinclude_start template. I'm using vB 3.5.3 btw.


i have the same problem.
is there a hack version for 3.5.4 out?

[Freakpyromaniac]

Is there a scripter which can maker this mod suitable for Not-VBulletin pages?
Tried to include several sections of other pages, but nothing worked..

More people like to have this feature.. help us out!

[MamboCube]

the problem is in the cal.php file
line 113 $events=$DB_site->query("SELECT dateline_from,title,eventid,utc FROM " . TABLE_PREFIX . "event WHERE (dateline_from BETWEEN $from AND $to) AND visible=1 ORDER BY dateline_from ASC"); im trying to debug, but I know little about php :p

yeh, i have a problem with this, all i get is

Fatal error: Call to a member function on a non-object in /home/****/public_html/forum/cal.php on line 113


anyone know how to fix this?

[MamboCube]

anyone?

its like the last thing i have to do to complete my homepage

[MamboCube]

has anyone had a similar problem?

[[email protected] vbmenu_register("postmenu_1019646", true);]

I'm getting that same error on line 113 I believe that reads
$events=$DB_site->query("SELECT dateline_from,dateline_to,title,eventid,utc FROM " . TABLE_PREFIX . "event WHERE (dateline_from BETWEEN $from AND $to) AND visible=1 ORDER BY dateline_from ASC");

I too would sure like to figure out how to get a mini-calendar onto any VBulletin page that I want.

not having any luck searching for one as of yet.. still looking.

[travisjerome]

Colin,

So to clarify I go to the index.php and add include ("cal.php");

To where do I put this in the code? I added it and my homepage went blank.

I am a little confused on do I add it to the global.php file also?

[AFemaleProdigy]

I was hoping this might work with the latest version of vB, but I keep getting this error:

Fatal error: Call to a member function on a non-object in /home/content/i/c/i/*name removed*/html/*name removed*/cal.php on line 113

I can't seem to get this to work. Any suggestions?

[deezelpope]

I tried to find a mini-calendar for VB, too, without much luck, so, I use one from here... http://www.carrielynnesworld.com/