Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Opal is a powerful Item & Content Management System powered by Ruby on Rails. You can use Opal for blogging, listing items, storing files/images/videos, or for powering any awesome website.
tag: v0.8.1

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
config
db
lib
public
script
spec
test
tmp
vendor
.gitignore
Gemfile
Gemfile.lock
LICENSE
README.textile
Rakefile
config.ru

README.textile

Opal

Opal is a powerful item directory application powered by Ruby on Rails. It allows you to list any kind of item, from houses to video games to classifieds.

Features

  • Powered by Ruby on Rails 3.1
  • List Any Type of Item(Products, Video Games, Locations, Events, Classifieds, etc.)
  • Add extra stuff to your Items like Images, Videos, Reviews, Comments, Files, Discussions, Custom Fields, and more.
  • State-of-the-Art Interface powered by HTML5, CSS3, jQuery, Uploadify, and jQuery TOOLS
  • Multiple-user login system with secure administration area
  • Login from other websites(facebook, twitter, google, etc.) with OpenID/OAuth Support – (Guide)
  • Mass file & image uploader
  • Store uploaded files locally or in the cloud using Amazon S3, Rackspace Cloud Files, etc. – (Guide)
  • Apply special effects to Images(Rotate, Resize, Watermark, Stamp, Monochrome, Sepia, etc.)
  • Infinite-depth category organization & customizable advanced item searching
  • I18n(Internationalization) support for multiple languages & locales
  • CMS-style Pages & Integrated Blog
  • TinyMCE content editor with security filtering and image uploader
  • Customizable Themes & Plugins with easy uploader & installer
  • User Activity Logging
  • Gravatar Support
  • Much More

Uses

Since Opal is highly customizable, you can use it for many different things:

  • Directory Website
  • Content Management System(CMS)
  • Blog
  • Image/Video Gallery
  • File Download System
  • Forum/Discussion Board
  • Review/Classifieds Website
  • E-Commerce Website/Web Store

Opal's Default Theme - Fracture

How To Install Opal

Get Opal

Opal is available at the following places:

If you have git installed on your server, you can install it directly from Github. This is highly recommended and makes updating Opal a breeze.

git clone git://github.com/hulihanapplications/Opal.git

Install Gems

Install all of Opal’s required gems using bundler:

cd Opal
bundle install 

You may get an error here regarding rmagick if you don’t have it already installed. Check out this Wiki Guide for help.

Install Opal

Next, Run these commands (while in the Opal directory) to install Opal’s required stuff (database structure, assets, etc.) in production mode:

bundle exec rake db:migrate RAILS_ENV=production LOCALE=en
bundle exec rake db:seed RAILS_ENV=production LOCALE=en
bundle exec rake assets:precompile RAILS_ENV=production 

These commands will create the database structure of Opal in production mode. If you leave out RAILS_ENV=PRODUCTION, everything will be installed into your development database instead. This will also set up the default admin account, some sample items(you’ll be asked if you want to install sample data), and other stuff to help you get started with Opal. You can also specify the LOCALE parameter to install Opal in a language other than english.

  • If you want to automate an Opal installation, or if you just want to bypass prompts(that ask you if you want to install sample data and other stuff: run this command: bundle exec rake db:seed PROMPTS=FALSE)

That’s it!

You can now start Opal using the built-in Rails webserver, WEBrick…

bundle exec rails s -e production

…or any of your other favorite webservers: thin, nginx, apache, mongrel, etc.

  • To log in to Opal for the first time, the default Admin username and password is: admin.

Updating Opal

If you installed Opal with git, updating is a piece of cake. Go to your Opal directory and run these commands:

git pull origin master # pull the latest stable version of Opal
rake db:migrate RAILS_ENV=production

That’s it!

Extra Stuff

Guides & Tutorials

Here’s just a few of the many things you can do with Opal:

Check out the Opal Wiki for more.

Plugins & Themes

You can easily extend and customize Opal with new plugins and themes. Plugins extend Opal’s core functionality and Themes change the appearance of your Opal application.

Opal has a small but dedicated community of designers and coders that create plugins and themes for public use. You can find them on the official Opal website. Check out the guides below to make your own.

Community & Additional Help

If you need any more help, check out these resources:

Development & Contribution

If you’re interested in developing Opal or contributing a theme, plugin, or translation, check out the following:

License

Opal is Licensed under the Creative Commons Attribution 3.0 United States License .

Kudos

Special Thanks goes to following:

Something went wrong with that request. Please try again.