My Timeline

A social-media aggregation/display plugin

This is a Rails Engine to help pull in content from any number of social media sites, services, or websites. The aggregated information is displayed in a unified timeline.

It is being developed with extensibility in mind - each service will have it's own plugin.

What it looks like:

Requirements:

• Ruby 1.9.3 or 2.x
• Rails 3.1.x or 3.2.x or 4.x
• Bootstrap (or bootstrap-named classes) - For the markup. Just stuff like table.table-striped, no stuctural markup from Bootstrap is needed
• Any standard ActiveRecord-compatible database should work

Supported services:

• Runkeeper
• Twitter
• Github
• If you develop another, let me know and I'll add it here!

Demonstration

There is a small demo app available to show how it looks inside a fresh Rails application with a Devise User system.

Usage:

1. Add the gem to your Gemfile: gem 'my_timeline' and bundle install
2. Install the config file: rails g my_timeline:install
3. Edit config/initializers/my_timeline.rb to taste
4. Mount the engine in your routes:

# A timeline belongs_to User
resources :users do
  mount MyTimeline::Engine => '/timeline', as: :my_timeline
end

or

# No Users, just a dedicated timeline route
  mount MyTimeline::Engine => '/timeline', as: :my_timeline

5. Add a gem for any service you'd like to add on.

Credits

Original author: Justin Aiken

Links

• Source
• Bug Tracker
• Rubygem

Note on Patches/Pull Requests

• Fork the project.
• Make your feature addition or bug fix.
• Add tests for it. This is important so I don't break it in a future version unintentionally.
• Commit, do not mess with rakefile, version, or history.
  • If you want to have your own version, that is fine but bump version in a commit by itself so I can ignore when I pull
• Send me a pull request. Bonus points for topic branches.

Copyright

Copyright (c) 2013 Justin Aiken Inc. MIT license (see LICENSE for details).