[ABD] Simple Calendar Mod

Any abandoned MODs will be moved to this forum.

WARNING: MODs in this forum are not currently being supported or maintained by the original MOD author. Proceed at your own risk.
Forum rules
IMPORTANT: MOD Development Forum rules

WARNING: MODs in this forum are not currently being supported nor updated by the original MOD author. Proceed at your own risk.
User avatar
keith10456
Registered User
Posts: 2315
Joined: Thu Feb 24, 2005 6:55 pm
Contact:

[ABD] Simple Calendar Mod

Post by keith10456 » Tue Jan 31, 2012 4:02 pm

Modification Name: Simple Calendar Mod
Author: keith10456


Modification Description: Adds a simple Calendar page to your phpBB website. Perfect for admins that need a simple display Calendar to highlight their events. The posted events can link to a post on your Board that will posses the details of the respective event. The mod utilizes phpBB Custom Pages and the Calendar Script By Adam Shaw. Events are added via a javascript file.

If you ever edited an xml file then you would have no problem adding your events to this mod.

Modification Version: 1.0.0


Features:
  • Easy to install. No database changes.
  • Clean user interface.
  • Utilizes phpBB Custom Pages.
  • Displays "Who's Online" info.
  • Subsilver2 support.
  • Multi-day event posting.
  • Repeat event posting.
  • Add url's to your posted events.
  • Colors, etc are configurable via Css.
Demo URL: Click here for the demo.


Modification Download: Click here to download the mod.



Notice: As with any mod, before you install this mod be sure to make a back-up of your phpBB files and database (this mod does not make database changes).
Last edited by keith10456 on Sat Feb 18, 2012 5:34 pm, edited 4 times in total.

User avatar
keith10456
Registered User
Posts: 2315
Joined: Thu Feb 24, 2005 6:55 pm
Contact:

Re: Simple Calendar Mod

Post by keith10456 » Tue Jan 31, 2012 4:02 pm

FREQUENTLY ASKED QUESTIONS


1 - Where are the upgrade instructions?
N/A

2 - Does this mod support subsilver?
Yes. The subsilver2 instructions are in the "contrib" folder of the download.


3 - How do I add events to the Calendar?
Add the event data to the events.js file (root/simple_calendar/events.js). The event data should be placed after this comment:

Code: Select all

YOUR EVENTS BEGIN HERE... DON'T ADD ABOVE THIS COMMENT...
				*/
Each event should have a "title", "start", and "url" (multi-day events require the "end" var).

Use the code below to post an event. Change the listed web address to the url of your choosing. "y" is the current year. "m" is the current month. "8" is the 8th day of the month.

To post an event for a future month, add the number of months to the "m". For example, to add an event that is two months after the current month use "m+2".

Code: Select all

				{
					title: 'Sample Event For Current Month',
					start: new Date(y, m, 8),
					url: 'http://urbanareas.net/'
				},

4 - I added my events but now my Calendar doesn't show (my events nor dates). What's the problem?
Double-check the edits that you made to the events.js file (root/simple_calendar/events.js). Ensure that you have a comma after each event - except for the last event. Sample:

Code: Select all

				{
					title: 'Sample Event For Current Month',
					start: new Date(y, m, 8),
					url: 'http://urbanareas.net/'
				},

5 - How do I add the time to an event?
Use the sample below. "13" is the day. "19" is the hour of the event. "45" is the minutes. Note that events with time use the "allDay" var.

Code: Select all

				{
					title: 'Sample Event With Time',
					start: new Date(y, m, 13, 19, 45),
					url: 'http://urbanareas.net/',
					allDay: false
				},

6 - How do I add a multi-date event?
Use the sample below. It's important to note that these events use the "end" var. The "end" is the last date of the event.

Code: Select all

				{
					title: 'Sample Multi-Day Event',
					start: new Date(y, m, 22),
					end: new Date(y, m, 24),
					url: 'http://urbanareas.net/'
				},


7 - How do I restrict access to the Calendar page to logged-in members only?
Open: root/calendar.php

Find:

Code: Select all

// Start session management
$user->session_begin();
$auth->acl($user->data);
$user->setup('mods/calendar_lang');
After Add:

Code: Select all

if ($user->data['user_id'] == ANONYMOUS)
{
    login_box('', $user->lang['LOGIN']);
} 

8 - How do I make the "Calendar" link in the overall_header viewable to logged-in members only?

Open: root/styles/prosilver/template/overall_header.html

Find:

Code: Select all

			<!-- SIMPLE CALENDAR MOD BEGIN -->
				<li class="icon-pages"><a href="{U_SIMPLE_CALENDAR_MOD_LINK}" title="{L_SIMPLE_CALENDAR_MOD_LINK_EXPLAIN}">{L_SIMPLE_CALENDAR_MOD_LINK}</a></li>
				<!-- SIMPLE CALENDAR MOD END -->
Replace With:

Code: Select all

				
				<!-- SIMPLE CALENDAR  MOD BEGIN -->
				<!-- IF S_USER_LOGGED_IN -->
				<li class="icon-pages"><a href="{U_SIMPLE_CALENDAR_MOD_LINK}" title="{L_SIMPLE_CALENDAR_MOD_LINK_EXPLAIN}">{L_SIMPLE_CALENDAR_MOD_LINK}</a></li>
				<!-- ENDIF -->
				<!-- SIMPLE CALENDAR  MOD END -->

9 - Can I remove the links that are applied to the Calendar page?
No. Removing the links will violate the terms of use and copyright.


10 - How do I make the links on the Calendar page open in a new window instead of the same window (so visitors won't leave my site?

Open: root/styles/prosilver/template/calendar.html

Find:

Code: Select all

<p class="scmcenter"><a href="{U_SIMPLE_CALENDAR_MOD_INFO}">{L_SIMPLE_CALENDAR_MOD_INFO} {L_SIMPLE_CALENDAR_MOD_VERSION}</a> | <a href="{U_SIMPLE_CALENDAR_MOD_SCRIPT_INFO}">{L_SIMPLE_CALENDAR_MOD_SCRIPT_INFO}</a></p>
Replace With:

Code: Select all

<p class="scmcenter"><a href="{U_SIMPLE_CALENDAR_MOD_INFO}" target="_blank">{L_SIMPLE_CALENDAR_MOD_INFO} {L_SIMPLE_CALENDAR_MOD_VERSION}</a> | <a href="{U_SIMPLE_CALENDAR_MOD_SCRIPT_INFO}" target="_blank">{L_SIMPLE_CALENDAR_MOD_SCRIPT_INFO}</a></p>
11 - How do I add this mod to a style other than prosilver?
Copy the "prosilver" folder in the download and rename it to the exact name of the style you're using.
  • Upload the copied folder to the following directory: yoursite.com/yourphpbb/styles/
  • In the install instructions, apply the edits for "overall_header.html" to the overall_header.html file of the style you're using.
  • In the install instructions, apply the edits for "stylesheet.css" to the file of the style you're using.
  • Upload the edited files. Go to the ACP, select the "Styles" tab. Refresh your "Templates", "Themes" and "Imagesets".

12 - How do I uninstall this mod?
Reverse the edits given in the install file. The edited files include:
  • /root/includes/functions.php,
  • /root/styles/prosilver/theme/bidi.css
  • /root/styles/prosilver/theme/buttons.css
  • /root/styles/prosilver/theme/colours.css
  • /root/styles/prosilver/template/overall_header.html
Delete from your server:
  • yoursite.com/yourphpbb/simple_calendar (delete entire "simple_calendar" folder)
  • yoursite.com/yourphpbb/calendar.php
  • /root/language/en/mods/calendar_lang.php
  • yoursite.com/yourphpbb/styles/prosilver/template/calendar.html
  • yoursite.com/yourphpbb/styles/prosilver/theme/simple_calendar (delete entire "simple_calendar" folder)

13 - What versions of phpBB is this mod compatible with?
You should have no problems using this with versions 3.0.8, 3.0.9. and 3.0.10


DESCRIPTIONS AND OTHER INFO:
title = Title of the event.
start = Start date of the event.
url = Link to event info.
end = Only use this for multi-day events. This is the last date of the event.
allDay = Only use this for events with a specific time.


KEY
y = Year (The Current Year)
m = Month (The Current Month)
d = Day (Use the respective number. So for the 4th you would use the number 4).
Last edited by keith10456 on Tue Jan 31, 2012 11:02 pm, edited 1 time in total.

User avatar
keith10456
Registered User
Posts: 2315
Joined: Thu Feb 24, 2005 6:55 pm
Contact:

Re: [BETA] Simple Calendar Mod

Post by keith10456 » Tue Jan 31, 2012 9:17 pm

Moderators Please Delete This Post
Last edited by keith10456 on Wed Feb 01, 2012 3:31 am, edited 1 time in total.

User avatar
Neo
Registered User
Posts: 113
Joined: Tue Jul 07, 2009 5:02 am
Location: Holland
Contact:

Re: [BETA] Simple Calendar Mod

Post by Neo » Tue Jan 31, 2012 9:21 pm

nice work!

User avatar
darkonia
Registered User
Posts: 1901
Joined: Tue May 13, 2008 1:10 pm
Location: Munich, Germany
Contact:

Re: [BETA] Simple Calendar Mod

Post by darkonia » Tue Jan 31, 2012 9:55 pm

great work again keith, thx :ugeek:
MMOG-Heaven - Das Gaming Portal
Community bedeutet Gleichgesinnte finden - MMOG-Heaven ist Deine Community! Von Spielern für Spieler bietet Dir dieses Portal genau das, was ein Spieler braucht. Bleibe ständig informiert, finde die neuesten MMORPGs, oder suche die frischesten News aus der Welt des Online Gamings - dieses und vieles mehr erwartet Dich auf MMOG-Heaven.

User avatar
keith10456
Registered User
Posts: 2315
Joined: Thu Feb 24, 2005 6:55 pm
Contact:

Re: [BETA] Simple Calendar Mod

Post by keith10456 » Tue Jan 31, 2012 11:01 pm

@ FDCP_NEO (NL) and Darkonia - Thanks ;)

User avatar
MichaelC
Consultant
Consultant
Posts: 3642
Joined: Mon Dec 21, 2009 3:36 pm
Location: Surrey, UK
Name: Michael Cullum
Contact:

Re: [BETA] Simple Calendar Mod

Post by MichaelC » Tue Jan 31, 2012 11:59 pm

Looks nice, out of interest are you planning on changing it in future to store events in the DB and therefore being able to add/edit them in the ACP. While this is fine for more advanced users, I think you will be losing a lot of people (that lack certian technical skills) that would use it but can't as they don't want to edit files?
:)
Formerly known as Unknown Bliss.
Formerly Website Team Lead/Manager & Development Team.
Please don't PM me for support (or stuff that belongs in the forums or tracker) but otherwise feel free

User avatar
Jessica
Former Team Member
Posts: 4342
Joined: Sun Jul 18, 2010 2:53 pm
Location: Pennsylvania, USA
Name: Jessica
Contact:

Re: [BETA] Simple Calendar Mod

Post by Jessica » Wed Feb 01, 2012 1:33 am

looks really nice. but I hope in the future we can add events in the ACP :S
Pro-choice, Atheist, Pro-LGBT rights
Everybody is a genius. But if you judge a fish by its ability to climb a tree, it will live its whole life believing that it is stupid. - Albert Einstein

User avatar
keith10456
Registered User
Posts: 2315
Joined: Thu Feb 24, 2005 6:55 pm
Contact:

Re: [BETA] Simple Calendar Mod

Post by keith10456 » Wed Feb 01, 2012 3:27 am

Unknown Bliss wrote:Looks nice, out of interest are you planning on changing it in future to store events in the DB and therefore being able to add/edit them in the ACP. While this is fine for more advanced users, I think you will be losing a lot of people (that lack certian technical skills) that would use it but can't as they don't want to edit files?
Yes... Not in the immediate future though.

User avatar
Mickroz
Registered User
Posts: 656
Joined: Thu Mar 06, 2003 11:20 pm
Location: Netherlands
Contact:

Re: [BETA] Simple Calendar Mod

Post by Mickroz » Wed Feb 01, 2012 9:25 am

bookmarking this topic, some things i would love to see:
  • ACP/Admin add events page (DB)
  • User Birthday's
  • Upcoming/today's events on index
  • Calendar Permissions(view/add)
  • View of calendar months and days in user language
maybe im going to take a look at this todo myself, shouldn't be that hard to implement.

edit:
i got the birthday's to show up in the calendar.
next up adding event.
I don't need to "get a life." I'm a Gamer, I have lots of lives!
Q: Whats a hash and a root password?
A: hash gets you high, root password gives you god powers, combine the 2 and you are invincible.

User avatar
keith10456
Registered User
Posts: 2315
Joined: Thu Feb 24, 2005 6:55 pm
Contact:

Re: [BETA] Simple Calendar Mod

Post by keith10456 » Wed Feb 01, 2012 2:55 pm

Mickroz wrote:bookmarking this topic, some things i would love to see:
  • ACP/Admin add events page (DB)
  • User Birthday's
  • Upcoming/today's events on index
  • Calendar Permissions(view/add)
  • View of calendar months and days in user language
maybe im going to take a look at this todo myself, shouldn't be that hard to implement.

edit:
i got the birthday's to show up in the calendar.
next up adding event.
Glad to hear it :D

User avatar
Mickroz
Registered User
Posts: 656
Joined: Thu Mar 06, 2003 11:20 pm
Location: Netherlands
Contact:

Re: [BETA] Simple Calendar Mod

Post by Mickroz » Wed Feb 01, 2012 3:18 pm

yeah it's going well, i got the permissions to work, and now im working on the adding page.
upcoming events shouldn't be that difficult as soon as i got the db tables ready.
I don't need to "get a life." I'm a Gamer, I have lots of lives!
Q: Whats a hash and a root password?
A: hash gets you high, root password gives you god powers, combine the 2 and you are invincible.

User avatar
darkonia
Registered User
Posts: 1901
Joined: Tue May 13, 2008 1:10 pm
Location: Munich, Germany
Contact:

Re: [BETA] Simple Calendar Mod

Post by darkonia » Wed Feb 01, 2012 3:22 pm

i wish me the option when i write a topic, there where a checkbox to click if the topic show on the calender.
MMOG-Heaven - Das Gaming Portal
Community bedeutet Gleichgesinnte finden - MMOG-Heaven ist Deine Community! Von Spielern für Spieler bietet Dir dieses Portal genau das, was ein Spieler braucht. Bleibe ständig informiert, finde die neuesten MMORPGs, oder suche die frischesten News aus der Welt des Online Gamings - dieses und vieles mehr erwartet Dich auf MMOG-Heaven.

User avatar
Mickroz
Registered User
Posts: 656
Joined: Thu Mar 06, 2003 11:20 pm
Location: Netherlands
Contact:

Re: [BETA] Simple Calendar Mod

Post by Mickroz » Wed Feb 01, 2012 7:18 pm

ive got it working to add events to the calendar, but since you cannot change much (im not familiar with json and such) i going to create a separate page for admins/moderators (kinda simple moderator panel) and a my events page, where you can see the events you added and can edit/delete them.
I don't need to "get a life." I'm a Gamer, I have lots of lives!
Q: Whats a hash and a root password?
A: hash gets you high, root password gives you god powers, combine the 2 and you are invincible.

User avatar
keith10456
Registered User
Posts: 2315
Joined: Thu Feb 24, 2005 6:55 pm
Contact:

Re: [BETA] Simple Calendar Mod

Post by keith10456 » Wed Feb 01, 2012 9:30 pm

Mickroz wrote:ive got it working to add events to the calendar, but since you cannot change much (im not familiar with json and such) i going to create a separate page for admins/moderators (kinda simple moderator panel) and a my events page, where you can see the events you added and can edit/delete them.
Cool... I look forward to seeing it 8-)

Thanks for adding these additional features.

Locked

Return to “[3.0.x] Abandoned MODs”