Page Attachments Extension

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

This page exists because many people have had difficulty installing and using the page_attachments.

First things first

First, install Radiant and check it’s working. This includes making sure your web server will correctly run the dispatcher, etc. Please consult your hosting provider for information on how to run a Rails application like Radiant if necessary or check for more information about installing Radiant on your hosting provider.

If you want page_attachments to be able to display thumbnails of uploaded images, make sure that one of image_science, mini_magick, or rmagick is installed on the server. You can check this by running:

gem list

Installing Page Attachments

./script/extension install page_attachments

(If this fails see the manual installation instructions)

Restart your application and/or web server.

Using page_attachments

When you login to your Radiant admin and edit a page, you should see an area below the main interface that says “Attachments (0)”. Click the “+” icon to add an attachment. You can upload multiple attachments at once. Attachments will not be saved or removed until the whole page is saved. Therefore, if you accidentally deleted something you meant to keep, simply cancel the page-edit.

Referencing attachments in the page

Please see the Tag Reference in the page-editing interface for the latest documentation on how to use attachments in a page.

Troubleshooting

Migration problems

If you have a problem running the migrate task, and it fails with an error something like this.

ld: library not found for -lfreeimage
collect2: ld returned 1 exit status

It means you have installed the ImageScience gem but you don’t have FreeImage installed. So, either install FreeImage or uninstall the gem like so:

gem uninstall image_science

RubyInline problem

If you’re using ImageScience as a user without a home directory, you may see this error:

Define INLINEDIR or HOME in your environment and try again

This is caused by RubyInline not having a place to store its generated files and can be easily fixed by specifying a path in your environment file like so:

ENV['INLINEDIR'] = File.join(RAILS_ROOT,'tmp','ruby_inline')

Admin::PagesController undefined

If you are using radiant-0.6.9 and you get the latest page_attachements extension (as of 1/4/09) it will produce this error. This is because the 12/7/08 version of page_attachments is for a later version of radiant. You can download the 10/16/08 version of page_attachments, or just edit the file page_attachments_extension.rb and change PagesController to PageController.