... !logo-mxCalendar.png|border=1!
h5. Working on finishing documentation, please visit [http://charlesmx.com/software/mxcalendar-revo.html] in the meantime, or if you have access feel free to help update.
h2. About mxCalendar
mxCalendar is a extra created for both Evolution and Revolution to allow for full calendar editing using the native Manager of ModX. The calendar supports various views including calendar, list, and detail of which all views support the ModX template standards for fully customizing your themes. In addition mxCalendar supports feature rich calendar functions such as repeating events, Google Maps, cateogries, context, and unique calendars.
h2. Installation
h3. ModX Revolution:
It can be downloaded from within the MODx Revolution manager via [Package Management|revolution20:Package Management], or from the MODx Extras Repository, here: [http://modx.com/extras/package/mxcalendar2]. When using the Package Management for direct download you can simply click on the "Install" button after download completes. If you choose to download from the extras site you will then need to FTP, or otherwise move, the transport package zip file to your "/core/packages/" folder first. After you have copied the transport zip file to your packages folder you will then need to launch Package Management from inside the Manager (ver 2.2.x) and then select the down arrow next to "Download Extras" and select the last option "Search Locally for Packages" and then find "mxcalendars" in the list of packages and choose "install".
h3. ModX Evolution:
You will need to download from the ModX Extras Repository, here [http://modx.com/extras/package/mxcalendar]. After you have downloaded you will need to follow these steps.
# Unzip folder to your favorite place
# Upload mxCalendar folder to your sites root /assets/modules/ folder
# Copy contents of "snippets/mxCalendar.module.txt" file from the unzipped folder
# Log into your Manager interface and goto the Modules > Manage Modules section
# Select the New Module button
# In the Module name field place mxcalendar
# Past the content of "snippets/mxCalendar.module.txt" into the Module code (php) section
# Select Save
# Click the gear icon next to the new entry "mxcalendar" and select Run Module
# You should see a screen saying the installation was successful, so click the Start button
# Now you are in the new manager
h2. Creating New Events
h2. Creating Categories
h2. Creating Calendars
{color:#ff6600}*\*Note{*}{color}{color:#ff6600}: Calendars are only supported in the Revo version of mxCalendar{color}
h2. Using mxCalendar
Now to the best part, using mxCalendar to manage and display events.
h2. Settings
| {color:#5c5c5c}{*}Parameters{*}{color} | {color:#5c5c5c}{*}Type{*}{color} | {color:#5c5c5c}{*}Default{*}{color} | {color:#5c5c5c}{*}Scope{*}{color} | {color:#5c5c5c}{*}Description{*}{color} |
| {color:#5c5c5c}theme{color} | {color:#5c5c5c}string{color} | {color:#5c5c5c}default{color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}Set the theme to use; looks for theme files in the “/assets/components/mxcalendars/theme/” folder. You can create a new one by simply copying the default or traditional folder and modify then update the parater to your folder name.{color} |
| {color:#5c5c5c}resourceId{color} | {color:#5c5c5c}int{color} | {color:#5c5c5c}(current resource){color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}This sets the resource ID to use when creating links that use the non-ajax parameter{color} |
| {color:#5c5c5c}isLocked{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}(FALSE, 0){color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}When set to true the display type for this snippet call will not be changed regardless of any passed parameters or query string values; used when you have multiple snippet calls on a single page{color} |
|
... | {color:#5c5c5c}tplListWrap{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}el.wrap{color} | {color:#5c5c5c}list{color} | {color:#5c5c5c}The chunk that is the outer most wrapper for the list view, often contains the global heading “Upcoming Events”{color} |
| {color:#5c5c5c}eventListlimit{color} | {color:#5c5c5c}int{color} | {color:#5c5c5c}5{color} | {color:#5c5c5c}list{color} | {color:#5c5c5c}Set the max number of event items to display in the events list this includes the repeating events for a given event{color} |
| {color:#5c5c5c}sort{color} | {color:#5c5c5c}string (column name){color} | {color:#5c5c5c}startdate{color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}Set the default sorting order, often this is not modified and helps performance when dealing with the limits{color} |
| {color:#5c5c5c}dir{color} | {color:#5c5c5c}string (ASC, DESC){color} | {color:#5c5c5c}ASC{color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}Set the sort direction to use{color} |
| {color:#5c5c5c}limit{color} | {color:#5c5c5c}int{color} | {color:#5c5c5c}99{color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}Sets the max number of items to return from the data base query{color} |
| {color:#5c5c5c} contextFilter{color} | {color:#5c5c5c} string (comma seperated){color} | {color:#5c5c5c}empty; ?all + current context{color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}Sets which context to filter out events for, by defaullt it list global events where no context has been set plus the current context. In order to disable the global events from display you have to set the contextFilter value to the current context, thus over writing the default value.{color} |
| calendarFilter | string (comma seperated list of category id) | null | calendar, mini | Sets a calendar filter based on the events associated calendar. By default all events are displayed regardless of the calendar they are associated to. You must set this to the value of a category id or multiple category id's separated by a comma (,). |
| | | | | |
| {color:#5c5c5c}{*}Text and Date Formatting{*}{color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}dateFormat{color} | {color:#5c5c5c}strftime{color} | {color:#5c5c5c}%{color}{color:#5c5c5c}{-}Y{-}{color}{color:#5c5c5c}%m-%d{color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}Uses the PHP strftime to return a pre-formatted date stamp; Extended value of %O to replace the date(S) type. English ordinal suffix for the day of the month, 2 characters ({color}{color:#5c5c5c}{_}st{_}{color}{color:#5c5c5c}, {color}{color:#5c5c5c}{_}nd{_}{color}{color:#5c5c5c}, {color}{color:#5c5c5c}{_}rd{_}{color}{color:#5c5c5c} or {color}{color:#5c5c5c}{_}th{_}{color}{color:#5c5c5c}). Use this to help speed up render time.{color} |
| {color:#5c5c5c}timeFormat{color} | {color:#5c5c5c}strftime{color} | {color:#5c5c5c}%H:%M %p{color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}Uses the PHP strftime to return a pre-formatted time stamp; Extended value of %O to replace the date(S) type. English ordinal suffix for the day of the month, 2 characters ({color}{color:#5c5c5c}{_}st{_}{color}{color:#5c5c5c}, {color}{color:#5c5c5c}{_}nd{_}{color}{color:#5c5c5c}, {color}{color:#5c5c5c}{_}rd{_}{color}{color:#5c5c5c} or {color}{color:#5c5c5c}{_}th{_}{color}{color:#5c5c5c}). Use this to help speed up render time.{color} |
| {color:#5c5c5c}dateSeperator{color} | {color:#5c5c5c}string{color} | {color:#5c5c5c}/{color} | {color:#5c5c5c}calendar, mini, list, detail{color} | {color:#5c5c5c}Set the date seperator string to use in date stamps{color} |
| {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}{*}Calendar view{*}{color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}activeMonthOnlyEvents{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}FALSE{color} | {color:#5c5c5c}calendar{color} | {color:#5c5c5c}Display only events in the days of the current month{color} |
| {color:#5c5c5c}highlightToday{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}TRUE{color} | {color:#5c5c5c}calendar{color} | {color:#5c5c5c}Adds the value of @todayClass to the current date{color} |
| {color:#5c5c5c}todayClass{color} | {color:#5c5c5c}String{color} | {color:#5c5c5c}today{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the CSS class name to use for the current date{color} |
| {color:#5c5c5c}noEventsClass{color} | {color:#5c5c5c}String{color} | {color:#5c5c5c}mxcDayNoEvents{color} | {color:#5c5c5c}calendar,mini{color} | {color:#5c5c5c}Set the CSS class name to apply to date containers where no events are found{color} |
| {color:#5c5c5c}hasEventsClass{color} | {color:#5c5c5c}String{color} | {color:#5c5c5c}mxcEvents{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the CSS class name to apply to date containers where events are found{color} |
| {color:#5c5c5c}tplEvent{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplEvent{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the template chunk name to use for each event{color} |
| {color:#5c5c5c}tplDay{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplDay{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the template chunk name to use for each day of the month, wrapper chunk for the tplEvent{color} |
| {color:#5c5c5c}tplWeek{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplWeek{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the template chunk name to use for each week of the month, outer wrapper for the tplDay{color} |
| {color:#5c5c5c}tplMonth{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplMonth{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the template chunk name to use for the month, outer wrapper for the tplWeek{color} |
| {color:#5c5c5c}tplHeading{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplHeading{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the template chunk name to use for the calendar heading, this chunk contains the calendar navigation controls{color} |
| {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}{*}Detail view{*}{color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}tplDetail{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplDetail{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Set the template chunk to display the event details{color} |
| {color:#5c5c5c}tplDetailModal{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplDetailModal{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Set the template chunk to display the event details in a modal view only{color} |
| {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}{*}Categories list{*}{color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}showCategories{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}TRUE{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set to true to enable the listing of categories to filter events by; set to false to disable listing of categories{color} |
| {color:#5c5c5c}tplCategoryWrap{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplCategoryWrap{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the chunk to wrap all the category listing output in{color} |
| {color:#5c5c5c}tplCategoryItem{color} | {color:#5c5c5c}String (chunk){color} | {color:#5c5c5c}tplCategoryItem{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the template chunk to use for the category listing items{color} |
| {color:#5c5c5c}labelCategoryHeading{color} | {color:#5c5c5c}String{color} | {color:#5c5c5c}lexicon: mxcalendars.label_category_heading{color} | {color:#5c5c5c}calendar, mini{color} | {color:#5c5c5c}Set the category listing heading label text{color} |
| {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}{*}Aux Parameters/Properties (global)*{color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}addJQ{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}TRUE{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Add the jQuery library source JS file as defined in the @jqLibSrc property{color} |
| {color:#5c5c5c}jqLibSrc{color} | {color:#5c5c5c}String{color} | {color:#5c5c5c}[https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js]{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Set the URL to the jQuery library you would like mxCalendar to load{color} |
| {color:#5c5c5c}usemxcLib{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}TRUE{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Use the stand-a-lone modal windows JS library packaged with mxCalendar{color} |
| {color:#5c5c5c}ajaxResourceId{color} | {color:#5c5c5c}int{color} | {color:#5c5c5c}null{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Set the document resource id that you has the base mxcalendars snippet call and {color}{color:#5c5c5c}{*}{_}blank template{_}{*}{color}{color:#5c5c5c} defined for use with the modal display{color} |
| {color:#5c5c5c}modalView{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}FALSE{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Enable or disable the modal view of events{color} |
| {color:#5c5c5c}modalSetWidth{color} | {color:#5c5c5c}String/Int{color} | {color:#5c5c5c}80.00%{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Set the value for the modal windows display width, supports percents (%) and fixed width (500px){color} |
| {color:#5c5c5c}modalSetHeight{color} | {color:#5c5c5c}String/Int{color} | {color:#5c5c5c}70.00%{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Set the value for the modal windows display height, supports percents (%) and fixed width (500px){color} |
| {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}{*}Google Map{*}{color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}gmapLib{color} | {color:#5c5c5c}String{color} | {color:#5c5c5c}[http://maps.google.com/maps/api/js?sensor=false]{color} | {color:#5c5c5c}detail{color} | {color:#5c5c5c}Set the Google Map API URL to use for your site{color} |
| {color:#5c5c5c}gmapId{color} | {color:#5c5c5c}String{color} | {color:#5c5c5c}map{color} | {color:#5c5c5c}detail{color} | {color:#5c5c5c}Set the node id where the Google Map object should be displayed{color} |
| {color:#5c5c5c}gmapDefaultZoom{color} | {color:#5c5c5c}Int{color} | {color:#5c5c5c}13{color} | {color:#5c5c5c}detail{color} | {color:#5c5c5c}Set the Google Map display default zoom level{color} |
| {color:#5c5c5c}gmapAPIKey{color} | {color:#5c5c5c}String{color} | {color:#5c5c5c}null{color} | {color:#5c5c5c}detail{color} | {color:#5c5c5c}Set the Google Map API key to your registered API for additional tracking and increased request (higher limits){color} |
| {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}{*}Holiday (coming soon)*{color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}holidays{color} | {color:#5c5c5c}Struct{color} | {color:#5c5c5c}null{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}coming soon{color} |
| {color:#5c5c5c}holidayDisplayEvents{color} | {color:#5c5c5c}Boolean{color} | {color:#5c5c5c}TRUE{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}coming soon{color} |
| {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c}{*}Debugging{*}{color} | {color:#5c5c5c} {color} |
| {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c} {color} | {color:#5c5c5c}use with caution, so not listed and not recommended to use{color} |
| {color:#5c5c5c}debugTimezone{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}FALSE{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Set to true to see how your dates are being processed for your server settings{color} |
| {color:#5c5c5c}debug{color} | {color:#5c5c5c}boolean{color} | {color:#5c5c5c}FALSE{color} | {color:#5c5c5c}all{color} | {color:#5c5c5c}Set to true to enable all kids of fun output of the calendar processing, helps to trouble shoot any issues with the calendar{color}\\
\\ |
h2. Demo
|
E-mail