Timeline management in Drupal


Introduction

The Princeton Timeline is a software system developed by OIT that facilitates the distribution of time-critical information about activities, events and deadlines to the Princeton University community.

The Timeline system can "speak" to the Drupal Template system, which will then consume and display Timeline posts on your own Drupal website. You only need to enter information once into Timeline for it to be presented across multiple destinations. It allows for targeted posts based upon needs and interests as well as memberships and roles.

During Phase II, the Timeline Project will evolve and acquire new features. The Timeline system will soon be used for:

  • Personal Calendaring
     
  • Events at Princeton
     
  • Deseminating information

There are three ways Timeline consumes content:

  • Feeds (for example iCal)
     
  • Systems (for example Peoplesoft)
     
  • Direct entries into the Timeline system

Drupal as a Destination for Timeline Content

Destinations are external sites to which the Timeline publishes events, activities, deadlines, and announcements. As you enter content into the Timeline system, your Drupal website will consume the content as a feed and display the posts on your own website. Currently, Timeline destinations are limited to Drupal, but in the future will also include Facebook, Twitter, Instagram, WordPress, Roxen and other social media sites. As the Timeline Project evolves the functionality and presentation of Timeline content into Drupal will also continue to be enhanced.


Create your Timeline Account

Read the documentation regarding Timeline prior to proceeding.


Install and Enable Timeline in Drupal

  1. Log in to configure your Drupal website.
     
  2. From the Admin menu, select Apps.

    timeline image
     
  3. Click the Details button for the PWDS Timeline app.

    timeline details button
     
  4. On the left, click Enable App.

    Timeline enable button

Authenticate Your Drupal Account with Timeline

  1. From the Configuration pull-down menu, select Timeline Settings.
     
  2. In the Application Name text box, you can replace the default text and name your feed. Click the button to Go to Timeline to add an Authenticated account.

    Timeline enable button
     
  3. You will be taken to the Timeline application. Click the Add a new destination... button. Give the destination a name and click the Create button, or choose from an already available feed and click the Authorize button.
     
  4. Your Timeline account will now be authenticated within Drupal. You can click on the Feed tab to see your Timeline posts that are being consumed by your Drupal feed.

    Timeline feed tab image
     
  5. You can now add views from the Timeline Content type to existing or new pages.

More instructions are available here: timeline-info.princeton.edu/how/publishers/destinations/add-timeline-drupal-website


Considerations

  • If your Drupal website is using the Events module, you cannot combine and display together both Module events and Timeline events. Your template site will need to migrate from the Events module to Timeline.
     
  • If you are using the Timeline system, the categories assigned to your events cannot be configured uniquely; you must use the categorization schema defined within Timeline.