Jump to main content Jump to doc navigation

Customizing your calendar

Church Events Calendar uses Chunks for all output from the Snippets. You should see all chunks in Elements -> Chunks -> ChurchEvents

It is recommended to Duplicate the Chunk that you wish to change and rename it. Then you will not lose your changes when a new update is out. For organization it would be also recommend that you create a new folder to put you custom Chunks into.

Since Church Events has a custom caching component after you make changes to your Chunk you will need have this param: clearCache in the URI of the view that you have changed. For example if you made a new Chunk for the Day view for the dayEventTpl, then you would need to put on the end of the URL a ?clearCache=Y or &clearCache=Y.

Available Properties

Version 1.0

The calendar grid (day/week/month/year) views share the following Chunks

Name Description Default Value
headTpl This is the JS/CSS for the calendar goes in the <head> and can use the results from looping categoryHeadTpl like [[+categoryHeadTpl]] ChurchEvents_HeadTpl
categoryHeadTpl Category CSS or JS that will go through loop and be placed in <head> ChurchEvents_CategoryHeadTpl
calFilterTpl Calendar Filter ChurchEvents_CalFilterTpl
calAdminFilterTpl Calendar Filter (added in 1.1) ChurchEvents_CalFilterTpl
calNavTpl Calendar navigation, next and previous months ChurchEvents_CalNavTpl
calendarID The default calender that is displayed (added in 1.1) 0
categoryID The default category that is displayed (added in 1.1) 0

The calendar day view chunks

The day view shows all events in a selected day that meet the selected filters.

Name Description Default Value
dayEventTpl Calendar Event ChurchEvents_DayEventTpl
dayHolderTpl Calendar day holder - default shares Tpl with month view ChurchEvents_DayHolderTpl

The calendar week view chunks

The week view shows days Sunday to Monday and all events that meet the selected filters.

Name Description Default Value
weekTableTpl Calendar table - default shares Tpl with month view ChurchEvents_CalTableTpl
weekRowTpl Calendar row - default shares Tpl with month view ChurchEvents_CalRowTpl
weekEventTpl Calendar Event - default shares Tpl with month view ChurchEvents_CalEventTpl
weekDayHolderTpl Calendar day holder - default shares Tpl with month view ChurchEvents_CalDayHolderTpl
weekColumnHeadTpl Calendar column header - default shares Tpl with month view ChurchEvents_CalColumnHeadTpl
weekColumnTpl Calendar column - default shares Tpl with month view ChurchEvents_CalColumnTpl

The calendar month view Chunks

The month view shows a complete month in a grid(table) format and all events that meet the selected filters.

Name Description Default Value
calTableTpl Calendar table ChurchEvents_CalTableTpl
calRowTpl Calendar row ChurchEvents_CalRowTpl
calEventTpl Calendar Event ChurchEvents_CalEventTpl
calDayHolderTpl Calendar day holder ChurchEvents_CalDayHolderTpl
calColumnHeadTpl Calendar column header ChurchEvents_CalColumnHeadTpl
calColumnTpl Calendar column ChurchEvents_CalColumnTpl

The calendar year view Chunks

The year view shows the 12 months each as a grid(table) and then give a sum of the events for each day that meet the selected filters.

Name Description Default Value
yearTableTpl Calendar table ChurchEvents_YearTableTpl
yearRowTpl Calendar row - default shares Tpl with month view ChurchEvents_CalRowTpl
yearColumnHeadTpl Calendar column header - default shares Tpl with month view ChurchEvents_CalColumnHeadTpl
yearColumnTpl Calendar column ChurchEvents_YearColumnTpl

The calendar location view chunks

This view is only see if you have the useLocations System Setting set to Yes. It will show all info of a single location.

Name Description Default Value
locationDescriptionTpl Shows all info for a single location ChurchEvents_LocationDescriptionTpl

The event description view Chunks

Name Description Default Value
eventDescriptionTpl Shows event description information of a single event (event description page). ChurchEvents_EventDescriptionTpl
eventDescriptionBasicLocationTpl Basic location information on the event description page. Only used if the Use Locations System Setting is No. ChurchEvents_EventDescriptionBasicLocationTpl
eventDescriptionLocationTypeTpl Loops through each location type(building) and shows all locations(rooms) in it on the event description page. Only used if the Use Locations System Setting is Yes. ChurchEvents_EventDescriptionLocationTypeTpl
eventDescriptionLocationTpl Loops through each location(room) and shows information on the event description page. Only used if the Use Locations System Setting is Yes. ChurchEvents_EventDescriptionLocationTpl

The event add/edit view Chunks

Name Description Default Value
eventFormHeadTpl The <head> JS/CSS for the add/edit/request event form. ChurchEvents_EventFormHeadTpl
eventFormTpl The add/edit event form, uses FormIt ChurchEvents_EventFormTpl
eventFormConflictTpl Shows error message list of events that are conflicting, only used if the Use Locations System Setting is Yes. ChurchEvents_EventFormConflictTpl
eventFormAdminTpl Event form admin section, only shows if user has permission to be admin ChurchEvents_EventFormAdminTpl
eventFormRepeatTpl Option for repeating events on the edit form, all or single instance ChurchEvents_EventFormRepeatTpl
eventFormBasicLocationTpl Basic location information, only used if the Use Locations System Setting is No. ChurchEvents_EventFormBasicLocationTpl
eventFormLocationTypeTpl Loops through each location type(building) and shows all locations(rooms) in it on the event form page. Only used if the Use Locations System Setting is Yes. ChurchEvents_EventFormLocationTypeTpl
eventFormLocationTpl Loops through each location(room) and shows information on the event form page. Only used if the Use Locations System Setting is Yes. ChurchEvents_EventFormLocationTpl

The delete event view Chunks

Name Description Default Value
deleteFormHeadTpl Any JS/CSS for the delete form ChurchEvents_DeleteFormHeadTpl
deleteFormTpl The delete event form, uses FormIt ChurchEvents_DeleteFormTpl
deleteFormRepeatTpl Option for repeating events on the delete form, all or single instance ChurchEvents_DeleteFormRepeatTpl

Skins

Name Description Default Value
skin The concept is that you can copy and rename all tpls with the prefix ChurchEvents and give them your own prefix like MyCustomSkin. Now rather then declare each property change in the snippet call you can just declare the Skin you want to use. If you assign a value to a tpl property it will override the skin name for that one property. ChurchEvents

Generated Email Chunks

An email is generated for requested events

Name Description Default Value
emailRequestNoticeTpl The is the email that will be send if a user requests an event. emailRequestNoticeTpl
emailBasicLocationTpl Basic location information, only used if the Use Locations System Setting is No. emailBasicLocationTpl
emailLocationTypeTpl Loops through each location type(building) and shows all locations(rooms) in it on the event request email. Only used if the Use Locations System Setting is Yes. emailLocationTypeTpl
emailLocationTpl Loops through each location(room) and shows information on the event request email. Only used if the Use Locations System Setting is Yes. emailLocationTpl

Examples

Basic this will show a complete calendar grid

[[!ChurchEventsCalendar]]

Show a complete calendar grid with your own custom tpl for the calEventTpl

[[!ChurchEventsCalendar?
  &calEventTpl=`MyCustomCalEventTpl`
]]

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

  • modmore
  • STERC
  • Jens Wittmann – Gestaltung & Entwicklung
  • Fabian Christen
  • Digital Penguin
  • Dannevang Digital
  • Sepia River Studios
  • CrewMark
  • Chris Fickling
  • deJaya
  • Following Sea
  • Anton Tarasov
  • eydolan
  • Raffy
  • Lefthandmedia
  • Murray Wood
  • Snow Creative
  • Nick Clark
  • Helen
  • JT Skaggs
  • krisznet
  • YJ
  • Yanni
  • Richard

Budget

$366 per month—let's make that $500!

Learn more