No description, website, or topics provided.
Ruby JavaScript CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
config
db/migrate better sqlite index support and cache expiration fixes Dec 11, 2012
lib
script
spec Setup rspec Jun 15, 2012
.gitignore
.rspec
Gemfile
Gemfile.lock
MIT-LICENSE
Rakefile
Readme.markdown
roadmap.md
spud_photos.gemspec

Readme.markdown

NOTICE

This project is not actively maintained. I will do my best to provide fixes in so far as supporting existing users on Rails 3.x. For Rails 4 and beyond, please either:

Thanks!


Spud Photos

Spud Photos is an engine for creating and managing photo galleries, designed for use with Spud.

Installation/Usage

  1. In your Gemfile add the following

     gem 'spud_photos'
    
  2. Run bundle install

  3. Copy in database migrations to your new rails project

     bundle exec rake railties:install:migrations
     rake db:migrate
    
  4. Run a rails server instance and point your browser to /spud/admin

Configuration

Spud Photos accepts the following configuration options. Place them in application.rb or in an initializer.

Spud::Photos.configure do |config|
  config.base_layout = 'application'
  config.galleries_enabled = false
  config.base_path = 'photos'
  config.photo_styles = {
    :small => '50x50#',
    :medium => '200x200#',
    :large => '400x400#',
    :huge => '600x600'
  }
  config.paperclip_storage = :filesystem #use :s3 to use s3 storage (aws gem required)
	  config.s3_credentials = "#{Rails.root}/config/s3.yml"
	  config.storage_path = ":rails_root/public/system/spud_photos/:id/:style/:basename.:extension"
	  config.storage_url = "/system/spud_photos/:id/:style/:basename.:extension"
	  config.s3_host_name = "s3.amazonaws.com" #Defaults to us east zone, change for other regions.
end

The photo_styles option will be passed to Paperclip, so any valid paperclip styles can be added here.

Galleries

A Gallery is just an additional layer of organization above the Album layer. For example, a Gallery called "Vacations" might include Albums titled "Europe", "Hawaii", and "Florida". Galleries are turned off by default.

Customizing Views

A number of built-in views have been provided to help you get started with the frontend display. Customizing these views will require you to copy them into your local application, which can be accomplished by using the views generator.

rails generate spud:photos:views

NOTE: The built-in views are likely to undergo changes as features are added to the photos engine. If a new version of Spud Photos does not play nicely with your customized views, try backing up your views to an alternate location and running the views generator again to see what has changed.

Testing

Spud uses RSpec for testing. Get the tests running with a few short commands:

  1. Create and migrate the databases:

     rake db:create
     rake db:migrate
    
  2. Load the schema in to the test database:

     rake app:db:test:prepare
    
  3. Run the tests with RSpec

     rspec spec
    

After the tests have completed the current code coverage stats is available by opening /coverage/index.html in a browser.