A Radiant Extension by Sean Cribbs that adds page-attachment-style asset management. Page Attachments adds support for file uploads realized as attachments to individual pages. Attachments can have an order via acts_as_list, a title, a description and various metadata fields as provided by AttachmentFu.
If you want page_attachments to generate and display thumbnails of your uploaded
images you'll first need to install one of, image_science, mini-magick
or rmagick on your server. This is completely optional, page_attachments
will still function in every other way without any of these packages installed.
Now you're ready to install page_attachments.
cd /path/to/radiant
git clone git://github.com/radiant/radiant-page-attachments-extension.git vendor/extensions/page_attachments
rake radiant:extensions:page_attachments:migrate
rake radiant:extensions:page_attachments:update
If you don't have git you can download a tarball.
Attachment thumbnails for images default to :icon => '50x50>'. You can customize that by setting
PAGE_ATTACHMENT_SIZES to whatever you need in your config/environment.rb file
PAGE_ATTACHMENT_SIZES = {:thumb => '120x120>', :normal => '640x480>'}
Restart your server and refresh the admin interface.
The Cucumber features use Webrat and Selenium. You'll need the webrat 0.5.1 and selenium-client 1.2.16 gems installed and you'll need to change the version of webrat specified in environments/test.rb.
Now when you login and edit a page, you'll find the "Attachments" interface below the text editing area. To add a new attachment to the page click the + icon. If you need to you can upload multiple attachments at once by clicking the + icon once for each attachment you'll be adding. Attachments are not added or deleted until the page is saved. Therefore, if you accidentally deleted something you meant to keep, simply cancel the page edit.
- See the "available tags" documentation built into the Radiant page admin for more details.
- Reference an attachment by name
<r:attachment name="file.txt">...</r:attachment> - Display an attachment's URL
<r:attachment:url name="file.jpg"/> - Display an attachment's
#{key}attribute<r:attachment:#{key} name="file.jpg"/> - Display the date an attachment was added
<r:attachment:date name="file.txt"/> - Display an attached image
<r:attachment:image name="file.jpg"/> - Display a link to an attachment
<r:attachment:link name="file.jpg"/>or<r:attachment:link name="file.jpg">Click Here</r:attachment:link> - Display name of the user who added the attachment
<r:attachment:author name="file.jpg"/> - Iterate through all the attachments on a page
<r:attachment:each><r:link/></r:attachment:each> - Display the extension of an attachement inside iterations with <r:attachment:extension/>
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 with
gem uninstall image_science
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')
If you have trouble attaching files to Page Types other than the normal type, try editing
the following line in your config/environment.rb file
config.extensions = [ :all ]
to look like
config.extensions = [ :page_attachments, :all ]
Since page_attachments uses attachment_fu for the handling of attachments it's just as
easy to use S3 as it is to use your hard drive. Before you get started with this there
are a few things to keep in mind:
- If you've already started storing attachments on your hard drive this will break
any
<r:attachment...>tags pointing to those files. You'll need to remove all existing attachments and re-add them to Amazon S3. - You have to install the
AWS::S3gem. In some shared hosting environments this might not be possible. - The
AWS::S3gem does not (currently) support EU buckets, so if that's all you have you'll need to create a bucket in the US.
Before you start make sure you have page_attachments working using your hard drive. Once
you've tested an upload or two to the hard drive and feel confident the basic setup is
working, dive right in.
gem install aws-s3cd /path/to/radiantcp vendor/plugins/attachment_fu/amazon_s3.yml.tpl config/amazon_s3.yml- edit
config/amazon_s3.ymlwith your S3 credentials cp vendor/extensions/page_attachments/app/models/page_attachment.rb vendor/extensions/page_attachments/app/models/page_attachment.rb.bak- edit line 2 of
vendor/extensions/page_attachments/app/models/page_attachment.rbchanging:file_systemto:s3 - restart your server
Add an attachment and make sure the link it gives back is on S3. You should see all your
attachments start showing up at http://s3.amazonaws.com/bucket-name/page_attachments/.
While it is possible to customize the URL to Amazon (i.e. http://attachments.your-domain.com/)
but it's beyond the scope of this document and a task best left for those that really
need custom URLs.
These people have contributed patches that have been added to the extension: