Gallery Extension

hairballopolis edited this page Aug 24, 2010 · 4 revisions
Clone this wiki locally

Check the Gallery GitHub page for the most up-to-date information concerning the Gallery extension. There are more wiki pages for the gallery on the Gallery Github Wiki

Installation

From the root of your Radiant project run:

./script/extension install gallery

(If this fails see the manual installation instructions)

From the root of your Radiant project run:

rake production radiant:extensions:gallery:install

Get Your First Gallery Set Up

  1. Open your Radiant admin panel
  2. Click on the “Galleries” tab
  3. Create a new gallery by clicking “New Gallery”
  4. Enter a name and description for your gallery
  5. FTP or copy your images to [radiant directory]/public/galleries/import
  6. On the index page for your gallery in the Radiant admin panel, click “Import Files” and follow the prompts
  7. Note: with the most recent versions, it is necessary to edit the items and import controllers located in /vendor/extensions/gallery/app/controllers in order for uploads or imports to function. For example the file gallery_importings_controller.rb needs to have the line protect_from_forgery :except => [ :import ] added to it. The item or items controller needs an exception added for the :create action. (I apologize I don’t remember the details – but you can look in the log file for the correct controller and action if upload or import is not working for you)

Install Your Gallery As a Page

During installation, you are prompted to install a gallery layout. Doing so is the easiest way to get your new gallery displaying on your site. (Note: it appears that it is safe to repeat the “rake” command after having already set up images in your gallery in order to install a layout if you chose not to the first time, or to install multiple layouts).

With one of these layouts created for you, simply select it from the drop-down on your gallery page. Note that neither of these layouts use the <r:content/> tag, so the actual content on the page will be ignored unless you change this.

From here, it is up to you to experiment, move the relevant code snippets around to meet your needs, and alter these layouts to fit into the style of your site.

if you’d like to contribute, go for it!