JTAG Calendar (13)
Overview
JTAG Calendar is an elegant, feature-rich and easy to use calendar with 100% Joomla complaint code that provides services such as SMS alerts, Facebook, Twitter, Google+ and LinkedIn social bookmarking, event comments integrated with Gravitar and Google powered maps and more.
The basic features allow events to be easily added, modified or deleted in JTAG Calendar's both back and front ends, depending on the permissions granted by the administrator, also allowing any non-staff registered users to publish events from the front-end.
Basic event properties include public or registered listing, title, description, start and end time of the event, location (that links directly to Google maps), etc. The calendar features include ability to turn on and off notifications, attendance, comments and comment moderation, the time format, first day of the week and more.
It allows import of events from .ical files directly into the calendar with just a few clicks. It also exports the Calendar with all its events to Google Calendar and iCal compatible formats (.ics) and to even a pdf format.
For complete list of features and changes continue to the specific sections of this manual.
Thank you for using JTAG Calendar!
Features
Adding events is a breeze
- Create one-time or repeating events
- Set user permissions [add, edit, view only or delete events]
- Add locations to your events
- Invite registered and non-registered users during event creation [Coming soon]
- Stay organized with multiple calendars
- Assign custom colors to each calendar to identify departs/resource/etc.
- Add detail notes to each event
Customizable event reminders
- View and confirm attendees manually or automatically
- Set event reminders for attendees [mins, hours, or days before event]
- Alert attendees via SMS messaging, email or both
Elegantly designed with multiple Views
- 4 unique event views – daily, weekly time sheets, list and monthly
- Full screen Mode allows calendar to stretch to full screen without affecting design layout
- Ajax-based interactive slider to navigate days, months, years
- Google map integration in an interactive tool tip
- Filter events by calendar with one-click via calendar icon
- Export calendar events via iCal, pdf, RSS
Seamless Integration with major Social Networks
- Edit events or view event details on mouse-over
- Social widget bar allows one click posting of events to social networks and/or sharing with friends /co-workers etc
- View all invited users to each event from main calendar
- Allows users to comment on events
- Facebook-like buttons on all events
Customizable to the look and feel of your website
- Match calendar with your website look and feel with our robust theme engine.
- Comes with 4 pre-made professional themes
- Assign Colors to each calendar to represent different departments/resources/ equipment etc
- Complete MVC convention that separate CSS from programming logic.
- Compatible with all major Browsers
Upcoming events widget Slider
- Elegant upcoming events slider that streams events from main calendar
- Fully Customizable to show [date, calendar, description, etc]
- Display events from one or multiple calendars
- Display events on multiple pages for specific calendars
- Customize widgets icons to match with calendar colors to distinguish departments
Native Ajax Event Search
- Intuitive search that aggregates present, past and upcoming events for easier search results
- Search results in interactive tool-tip for faster navigation
- Native events search from anywhere on your joomla website
Imports .ics files (Google Calendar, iCal)
- Imports .ics files into the calendar resulting in importing of events directly on the calendar
- Easy to import with just 3 clicks
Event Notifications via Email
- It allows event notifications to be sent out via SMS or email
- The Administrator can send out event invites through Email from the backend and frontend (by keying in the email ids of the invitees)
- A logged in user with the privileges can send out event invites through email (by keying in the email ids of the invitees)
- The Administrator can customise the description of the event invite email that is being sent out
- Invitees will receive a Event Notification containting the Event Name, Event Location, Event Start Time and the Event Description (as set up by the Administrator)
Version 2.0.7 13 March 2012
==============================================
Bug fixes
All-day events showed up with start/end time in week / month views
Undefined NaN showed up for certain scenarios in the event popup
Version 2.0.2
General
- Modified the back-end UI to display user permissions in a separate menu and added Component Parameters link on all management pages
- Adjusted the heights of the calendar to be the same when changing between different views
- Adjusted the calendar CSS, so that the mini-calendar in Day view won’t stretch when table width is modified by the template
- Removed pre-loader for Internet Explorer prior to version 9, as it takes too long to preload images
Bug fixes
- Fixed an issue that causes sometimes events to not be listed properly in Monthly view
- Fixed an issue that would cause the event notes to not be displayed properly in the Edit Event form in the back-end
- Fixed an issue that caused the date-time picker in the back-end to disallow users from editing the time of the event
- Fixed an issue that caused the bottom timeline navigation to be skewed on some templates
- Fixed an issue that causes calendars with longer names to skew the layout in Calendar Picker and Event Form in the front-end
- Fixed an issue that would sometimes causes a lack of scroll bar on the Event Form, when selecting a Calendar for the event
- Fixed an issue in the front-end that could cause sometimes that invalid dates are generated in the front-end when a translation is applied
- Fixed an issue where the top navigation would not translate properly
- Fixed an issue cause by a MooTools/jQuery conflict that would prevent the Calendar from loading on some templates
- Fixed an issue in the en-GB language file that caused one of the error messages to not be displayed properly
- Fixed an issue that causes the navigation to be rendered improperly when loading the calendar for the first time, if loaded in Week view
New features
- Upcoming events widget
- Search filters has been added for Event and Comment management
- 3 new themes - black, blue & wood texture
- A search plug-in has been added that now enhances the Joomla search results with entries from the JTAG Calendar
Version 2.0.1
Bug fixes
- Fixed an issue that caused the Manage Calendars Page to show error sometimes, when loaded
- Fixed an issue on Joomla 1.5 that would cause the calendar front-end to crash sometimes
- Fixed an issue that was causing time format property to not take effect on Joomla 1.5
- Fixed an issue that would cause the calendars in the back-end to sometimes disappear
- Fixed an issue that was causing drop-down menus to sometimes display underneath the calendar
- Fixed an issue that would cause sometimes that the Calendar would render improperly and not display all days of the month
- Fixed an issue where calendar would not display proper time in 24 hour format
- Fixed an issue where yearly repeating events would create false data and cause the script to create invalid events until the script timeouts or has been halted explicitly by the user
- Fixed an issue where multiple jQuery instances would cause the calendar to crash and not load at all
- Fixed an issue where sometimes users were unable to select start/end date from the front-end
- Fixed an issue where the mini-calendar in Daily view would render improperly when the month is spread throughout a 6 weeks period
New Features
- Users can now toggle on/off the display of the following features: Full screen button, Calendar picker and Attend button in both event tool-tip and List view
To install the JTAG Calendar, first thing you need to do is to download it from your profile, along with the rest of the files: ‘mod jtag calendar’ and ‘plugin jtag calendar search’. After that, please follow the steps below, depending on which version of Joomla you are using.
ATTENTION Be sure to install com_jtagcalendar first. After that you continue with installing mod_jtagcalendar and plugin_jtagcalendar_search
For Joomla 1.5
- Go to the Joomla admin and click on the menu option Extensions. In the menu bar, rollover your mouse to the Install/Uninstall option.
- Click on browse button and give the path of the file in your computer for installation of ‘JTAG Calendar’ source file.
- After providing the path, click on the 'Upload & Install' button to complete the installation of ‘JTAG Calendar’ source file.
- If the installation goes successful, you will find the following message of ‘Installation Component Success’.
- Installation is complete
For Joomla 1.6, 1.7 and 2.5
- Go to the Joomla admin and click on the menu option Extensions. In the menu bar, rollover your mouse to the Extension Manager option.
- Click on browse button and give the path of the file in your computer for installation of ‘JTAG Calendar’ source file.
- After providing the path, click on Upload & Install Button to complete the installation of ‘JTAG Calendar’ source file.
- If the installation goes successful, you will find the following message of ‘Installation Component Success’.
- Installation is complete
Troubleshooting
The most common issue when install fails is the configured value of max_upload_filesize in PHP.INI. The default value is 2M, which is insufficient for the Calendar's installation to complete properly. Please contact your technical/hosting support and ask them to increase the allowed upload filesize to at least 8M.
To make the JTAG Calendar show in the front end menu of your website, after you have installed it, please follow the steps below:
- Log in to your website admin
- Click on the menu option 'Menus'. In the menu bar, rollover your mouse to the 'Main Menu' option
- Click on the 'New' button
- Click on 'Select' next to the 'Menu Item Type' box and select the 'JTAG Event Calendar'
- Fill out the 'Menu Title' box
- Choose a 'Menu Location' for the JTAG Calendar
- Set the other options, the way you prefer
- Click Save
After completing Installation of ‘JTAG Calendar’ now move to the setting interface, click on the Components link in the menu bar, and rollover your mouse to ‘JTAG Calendar’ option
Click on ‘Parameters’ button if you are using Joomla 1.5, or ‘Options’ button in case you are using Joomla 1.6 or 1.7, for basic configuration of the software.
The menu contains the following options
- Layout theme – Choose between different color layout themes of ‘JTAG Calendar’: black, blue, dark green, default (grey) and wood texture.
- Auto-approve Comments – You can choose between three options:
- Never – All comments must be approved by the administrator, before being published
- Only for users with event-publish permissions – Only the comments of users with event-publish permissions are published without approval
- All Comments – When someone leaves a comment, it gets published automatically, without being approved by the administrator.
- Time format – You can choose between the 12 and 24 hour time format
- Start of the Week – You can choose between Sunday or Monday
- Send SMS Reminders – Choose if you want SMS Reminders to be sent to the people who are attending an event
- Continuous Events in Month View – Choose if you want Continuous Events to be shown in Month View
- Continuous Events in List View – Choose if you want Continuous Events to be shown in List View
- Hide Full Screen Button – Choose if you want the JTAG Calendar to be shown in Full Screen
- Hide Calendar Picker – Choose if you want this option shown. The Calendar Picker option allows people to decide if they want the calendar events shown or not.
- Hide Attend Button – Choose if you want to allow people to notify if they are attending an event
- Hide Day View – Choose if you want to allow the calendar to be shown in day view
- Hide Month View – Choose if you want to allow the calendar to be shown in month view
- Hide Week View – Choose if you want to allow the calendar to be shown in week view
- Hide List View – Choose if you want to allow the calendar to be shown in list view
After you’re done making configuration changes, click Save. Note : If you would like to remove the footer "Powered by..." you can look for it in /components/com_jtagcalendar/views/main/tmpl/main.php and do the needful.
Adding a new calendar - basically from here you can change the color scheme that the events appear in your calendar. Please follow the steps below:
- Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option
- Click on the ‘Calendars’ tab
- Click on the ‘New’ button
- Add a Title of the new calendar
- Choose a color. When you’ve chosen a color, click on the little button with a color circle in it and the color name appears in the ‘Color’ box
- Check the ‘Default’ box if you want this calendar to be set as default
- Choose a position that you want it to appear as an option
- When ready click ‘Save’
From the JTAG Calendar’s front end button ‘Calendars’ (upper left corner), you can select which calendar you’d like to be shown in the front end (different calendars are usually shown in different colors).
Comments can be added by users in the JTAG Calendar’s list view. The creator of an event sets if comments are allowed or not. From the calendars options, the Auto-approval of Comments can be set, allowing 3 options: All comments, Only for users with event publish permissions or Never.
To moderate comments:
- Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option
- Click on the ‘Comments’ tab
- Find the comment you’d like to moderate
- Select its check box
- You can approve the comment if needed and you want it to appear in the front-end or delete it
- Confirm your action
Events can be managed from JTAG Calendar's both back- and front-ends. To be able to manage events from the front-end, first you need to grant yourself privileges from the back-end. (For more details, please see 8. User permissions)
Adding Events
Adding Events from the back-end
Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option, click on the Manage Events option. From here you can add, modify or delete events.
To add an event, please follow the steps below:
- Click on the 'New' button
- The 'Calendar' field remains to 'Default'
- From the 'User' field choose the user, who publishes the event
- Choose a title for the event and add it to the 'Title' field
- Add the event's location in the Location field. If you add the exact address, the location will appear on a map on the event’s description in the front-end
- If you want to add notes, fill out the Notes field
- In the Alert period you enter how many hours/days before the event, you'd like the event's guests to receive a reminder
- In the Start time field you enter the time and date the event starts
- In the End time field you enter the time and date the event ends
- All Day - Choose this option if you want your event to be during the whole day
- With the 'Repeat' option you choose if you want the event to be repeated and how often after it first occurs
- In Public – Choose wether you'd like the event to be public or not
- Allow Comments - Choose whether you'd like to allow people to leave comments for the event or not
- Click Save
Adding Events from the front-end
To add an event, please follow the steps below:
- Open the JTAG Calendar
- Click on the '+' button in the bottom right end of the Calendar. Fill out the fields below:
- Choose a title for the event and add it to the 'Title' field
- Add the event's location in the Location field. If you add the exact address, the location will appear on a map at the event’s description
- In the Start time field you enter the time and date the event starts
- In the End time field you enter the time and date the event ends
- All Day - Choose this option if you want your event to be during the whole day
- With the 'Repeat' option you choose if you want the event to be repeated and how often after it first occurs
- In Alert you enter how many hours/days before the event, you'd like the event's guests to receive a reminder
- The 'Calendar' option remains to 'Default'
- Allow Comments - Check this box, depending on whether you'd like to allow people to leave comments for the event or not
- Public Event – Check this box, depending on whether you'd like the event to be public or not
- If you want to add notes, fill out the Notes field
- Click Done - The event is created
Editing an event
An event can be edited from both back and front end
Editing an event from the back-end
- Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option
- Scroll down to the list of events to find the event you want to edit, or use the Search filters to find it.
- Click on the event’s title to open the event
- Make the necessary changes
- When ready, click Save - a message appears, saying ‘Event saved’.
Editing an event from the front-end
To edit an event, please follow the steps below:
- Open the JTAG Calendar
- Browse through the list of events to find the one you’d like to edit or use the Search option
- Click on the event to open it
- Click on the ‘Edit’ button
- Make the necessary changes
- When ready click ‘Done’ - a message should appear, saying ‘Event Saved. The event data was successfully saved in the database’
Deleting an event
Deleting an event from the back-end
- Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option
- Scroll down to the list of events to find the event you want to delete, or use the Search filters to find it.
- Check the box on the left of the event’s title.
- Click on the ‘Delete’ button, a message appears, saying: Are you sure you want to delete the selected events?’
- After you confirm, a message appears, saying ‘Events deleted’.
Deleting an event from the front-end:
- Open the JTAG Calendar and click on the event you want to delete.
- An event box opens, click on the ‘Edit’ button.
- Scroll down and click on the ‘Delete Event’ button
- After you confirm, a message shows, saying ‘Event Delete. The event data was successfully deleted.’
Select the users that you want to be able to publish events from the front-end
- Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option
- Go to the ‘Permissions’ tab.
- Select the users that you want to be able to publish events from the front-end:
- Click on the user, then click the ‘Add’ button, the user is added to the box on the right.
- Click save - A message appears saying: Permissions saved. Now the user, you have selected is able to publish events from the front-end.
If you want to remove a user from the permissions list:
- Click on the user
- Click on the ‘Remove’ button.
- Click ‘Save’.
Email notifications
When adding an event to the JTAG Calendar, there is an option to notify the people, attending the event. In the back-end you can choose how many hours or days before the event, the people attending will be notified. In the front-end you can choose between the following options: 1/2/3/6/12 hours, 1/2/3 days or 1 week before the event.
Setting the E-mail reminder
Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option. Go to the ‘E-mail Template’ tab. There are 2 fields you have to fill out: ‘Subject’ and ‘Text-only message’. You can edit the text of the message, as you prefer, leaving the following elements unchanged:
- [TITLE] - Will be replaced with the event's title
- [DESCRIPTION] - Will be replaced with the event's description
- [LOCATION] - Will be replaced with the event's location
- [TIME] - Will be replaced with the event' start time
SMS notification
Setting the SMS reminder
When someone clicks the ‘Attend’ button on an event at the front-end, a pop-up window shows, saying Attend Event. You have been successfully added to the attendee list for this event. When clicking OK, the system offers the option for SMS notification. You have to select Country code from the list, enter Area code and Number and click on the ‘YES, send me SMS’ button if you want to receive a notification, or ‘No, thank you!’ if you don’t want to.
- Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option
- Go to the ‘SMS Template’ tab.
- Fill out the ‘SMS Message Text’ box, leaving the following elements unchanged:
- [TITLE] - Will be replaced with the event's title
- [DESCRIPTION] - Will be replaced with the event's description
- [LOCATION] - Will be replaced with the event's location
- [TIME] - Will be replaced with the event' start time
SMS Gateway Settings
Go to the Joomla admin and click on the menu option Components. In the menu bar, rollover your mouse to the JTAG Calendar option. Go to the ‘SMS Gateway Settings’ tab and enter the information provided from Click-a-tell (the SMS service that JTAG Calendar supports).
