Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

NewsCloud's open source Facebook application based on Ruby on Rails and Facebooker

This branch is 0 commits ahead and 657 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

Welcome to the Newscloud framework

NewsCloud is an open-source Facebook Connect Website and Facebook Application that brings the power of community to news organizations. It is powered in part by technology funded by the John S. and James L. Knight Foundation.Funding for our open source development will continue through April 30, 2012.

For a complete feature list of the platform, visit http://newscloud.net/idLbRa. Follow @newscloud on Twitter for updates.

View the Ubuntu Server 10.04 lts install guide

We now have a full guide for bootstrapping and install newscloud on a minimal Ubuntu Server 10.04 LTS system.

See the guide at INSTALL-ubuntu.md

Getting Started

Clone this application to your machine and checkout release 3

    git clone git://github.com/newscloud/n2.git
    git checkout --track -b release3_1 origin/release3_1

Alternatively, download release 3 directly http://github.com/newscloud/n2/archives/v3.1_stable

Register a facebook application

Install required software

  • MySQL
  • Redis 2.x

We have switched over to using Redis completely, so memcached is no longer required.

Redis is used in production for caching, the development environment does not do any caching.

However, Redis/Resque are required to be installed for development mode as there isn't a pluggable job system in rails like the caching system.

You do not need to run a resque worker in development, but things will error out if you do not have an open redis connection.

We currently require MySQL. We are working on removing the dependency on MySQL, but for now its required. Additional database targets are PostgreSQL and SQLite.

Setup your config files

The primary(required) config files are:

  • database.yml
  • facebooker.yml -- remember to set callback_url to your base site, ie http://my.site.com

The optional config files for advanced settings are:

  • application_settings.yml -- misc config options
  • resque.yml -- where to find your redis server, defaults to localhost:6379
  • newrelic.yml for use with the New Relic monitoring (Note: we are not affiliated, we just like their application)
  • smtp.yml for outgoing mail
  • menu.yml -- configure what menu items you want to appear in your application
  • application.god for use with the God monitoring system
  • unicorn.conf.rb
  • locales.yml -- select the languagues you will be using
  • There are a number of other advanced files in the config directory

We provide .sample files for the majority of these config files to facilitate easy setup.

As mentioned above, when you set your config options, remember to use http://my.site.com and not http://my.site.com/iframe/

Install dependencies and setup the framework

Now that we got the hard part out of the way, there are just a few commands left to run.

    # Install [Bundler](http://gembundler.com/)
    sudo gem install bundler
    # Install the required gems
    bundle install
    # Run the newscloud setup process, this will create your database along with configuring your application
    rake n2:setup

Post Installation

You can now run your application in the typical rails fashion by doing:

   ruby script/server

or by whatever means you normally use.

You must set up an administrator. First, visit your Facebook application or website and register as a user. Then, visit the administration site e.g. http://my.site.com/admin and make yourself an administrator e.g. goto the Members -> Users tab and edit your user account to make you an admin.

Next Steps

Now that you are an admin user, you can configure your home page by going to the tab Front Page -> Build Layout -> Choose Widgets For more information about configuring you home page, read our Widget Builder Guide

We have a wide array of documentation and articles located at http://support.newscloud.com/

Some useful starting points are:

Developers

There is always more to do in the software world, and we need your help. Grab a fork and hack away! If you're interested in discussing the application further, please get in touch with us.

Something went wrong with that request. Please try again.