https://github.com/refinerycms-contrib/refinerycms-image-slideshows

Image Slideshows engine for Refinery CMS
https://github.com/refinerycms-contrib/refinerycms-image-slideshows

Last synced: 3 months ago
JSON representation

Image Slideshows engine for Refinery CMS

• Host: GitHub
• URL: https://github.com/refinerycms-contrib/refinerycms-image-slideshows
• Owner: refinerycms-contrib
• Fork: true (jpruetting/refinerycms-image-slideshows)
• Created: 2014-11-06T15:57:38.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2021-04-29T20:39:50.000Z (over 3 years ago)
• Last Synced: 2024-05-18T21:41:33.520Z (6 months ago)
• Language: Ruby
• Homepage: http://refinerycms.com
• Size: 74.2 KB
• Stars: 8
• Watchers: 4
• Forks: 15
• Open Issues: 4
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

• awesome-refinerycms - refinerycms-image-slideshows - Display slideshows (Frontoffice extensions)

README

        
# Refinery CMS Image Slideshows

[![Build Status](https://travis-ci.org/bisscomm/refinerycms-image-slideshows.svg?branch=master)](https://travis-ci.org/bisscomm/refinerycms-image-slideshows) [![Code Climate](https://codeclimate.com/github/bisscomm/refinerycms-image-slideshows/badges/gpa.svg)](https://codeclimate.com/github/bisscomm/refinerycms-image-slideshows) [![Test Coverage](https://codeclimate.com/github/bisscomm/refinerycms-image-slideshows/badges/coverage.svg)](https://codeclimate.com/github/bisscomm/refinerycms-image-slideshows/coverage)

Image Slideshows engine for [Refinery CMS](http://refinerycms.com) allows you to display multiple slideshows.

![Refinery Image Slideshows](https://dl.dropbox.com/u/80562357/Upload/gem_refinerycms_image_slideshows.png)

![Refinery Image Slideshows](https://dl.dropbox.com/u/80562357/Upload/gem_refinerycms_image_slideshows_2.png)

### In summary you can:

* Manage slideshows (title, height, width, js config)

* Manage i18n slides in every slideshow (title, image, caption, body, link_url)

## Requirements

This version of `refinerycms-image_slideshows` supports Refinery 3.x and Rails 4.1+.

To use Rails 3.x / Refinery 2.0.x use the [refinerycms-image_slideshows "Refinery CMS 2-0 stable branch"](https://github.com/bisscomm/refinerycms-image-slideshows/tree/2-0-stable).

* [Refinery CMS](http://refinerycms.com) version 3.0.0 or above.

## Install

Open up your ``Gemfile`` and add at the bottom this line:

```ruby

gem 'refinerycms-image_slideshows', github: 'bisscomm/refinerycms-image-slideshows', branch: 'master'

```

Now, run ``bundle install``

Next, to install the products plugin run:

    rails generate refinery:image_slideshows

Run database migrations:

    rake db:migrate

Finally seed your database and you're done.

    rake db:seed

## Usage

Add this code in your HTML) :

```html+erb

  

    <% main_slideshow = Refinery::ImageSlideshows::ImageSlideshow.includes(:image_slides).find_by_title('Your Awesome Slideshow Title') %>

    


      


        


          <% main_slideshow.image_slides.each do |image_slide| %>

            <%= link_to image_slide.link_url do %>

              <%= image_tag image_slide.image.url, :alt => image_slide.title, :title => image_slide.caption %>

            <% end %>

          <% end %>

        

      

    


    

      $(window).load(function() {

          $('#slider').nivoSlider({

            <%= raw main_slideshow.js_config %>

          });

      });

    

  

```

## Developing & Contributing

The version of Refinery to develop this engine against is defined in the gemspec. To override the version of refinery to develop against, edit the project Gemfile to point to a local path containing a clone of refinerycms.

### Testing

Generate the dummy application to test against

    $ bundle exec rake refinery:testing:dummy_app

Run the test suite with [Guard](https://github.com/guard/guard)

    $ bundle exec guard start

Or just with rake spec

    $ bundle exec rake spec

## More Information

* Check out our [Website](http://refinerycms.com/)

* Documentation is available in the [guides](http://refinerycms.com/guides)

* Questions can be asked on our [Google Group](http://group.refinerycms.org)