Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
= Page Event Created by Marty Haught, January 2008 Page Event is a simple page-based event calendar for associating time-based events with your Radiant pages. The original example was setting up meeting announcements in radiant where the meeting was a page. Having this meeting show up on a site-wide calendar and having exact information on when the meeting was taking place was important. INSTALLATION NOTE: This assumes you're on 0.8.1. It most likely will not be backwards compatible with older versions of Radiant. If you need to make this work with an older version then I'd suggest you look at an older version of the extension. 1) Install the Calendar Date Select plugin # install the gem sudo gem install calendar_date_select # add gem dependency to environment.rb config.gem "calendar_date_select" # though optional, I recommend unpacking the gem rake gems:unpack You can read more about it here: http://code.google.com/p/calendardateselect/ 2) Install the Page Event Extension script/extension install page_event --OR-- git clone git://github.com/mghaught/radiant-page-event.git vendor/extensions/page_event 3) run migration* rake production radiant:extensions:page_event:migrate 4) run rake update for extension* rake radiant:extensions:page_event:update * Both 3 and 4 are unnecessary if you used the script/extension install command 5) Start (or restart) your server USAGE The extension will create a new column on the pages table to store an optional event timestamp. The admin create/edit page interface will now have an Event Date field with pop-up calendar widget that will allow you to set a date and time that represents an event. This page will now be associated with that time. Additionally, there is a page event admin tab next to pages tab that will give you a month's view of events. It also have next and previous month navigation. The current UI is basic so look forward to it being enhanced. For displaying these events on your radiant pages you can choose from several tags. The main tag you'll use is the monthly calendar tag: <r:events:calendar /> It will produce the current month's view with any events during the time. The calendar also has previous and next month navigation. A default set of css styles are provided in the following file: <RADIANT_ROOT>/public/stylesheets/page_event/red/style.css In order to make use of this stylesheet you'll need to add it to the pages that will use the calendar tag. There are several tags that allow you to grab either the next event or a list of upcoming events. <r:events:next>...</r:events:next> <r:events:upcoming:each>...</r:events:upcoming:each> Events can also be pulled from the current pages children or a specified parent. <r:events:upcoming_children>...</r:events:upcoming_children> When it comes to accessing a specific page's event data you can use the following tags: <r:event> Date: <r:date /> Time: <r:time /> Duration: <r:duration /> </r:event> OR <r:event:date /> <r:event:time /> <r:event:duration /> They will simply output the date or time, respectively, in a human formatted version. The <r:date/> and <r:time/> tags accept a format attribute that specifies a strftime pattern for formatting the date or time.