@@ -1,3 +1,26 @@ = Page Attachments -Description goes here \ No newline at end of file +The Page Attachments extension allows Radiant administrators to attach files +to pages. It can also generate and display thumbnails of uploaded images if +image_science, mini-magick, or rmagick are installed on the server. + +Install the extension and run + + rake production db:migrate:extensions + rake production radiant:extensions:page_attachments:update + +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. + + + <r:attachment name="file.txt">...</r:attachment> + <r:attachment:url name="file.jpg" [size="icon"]/> + <r:attachment:#{key} name="file.jpg" [size="icon"]/> + <r:attachment:image name="file.jpg" [size="icon"]/> + + <r:attachment:link name="file.jpg" [size="thumbnail"]/> + + <r:attachment:each [order="asc|desc"] [by="filename|size|created_at|..."]> README @@ -4,6 +4,7 @@ module PageAttachmentAssociations has_many :attachments, :class_name => "PageAttachment", :dependent => :destroy attr_accessor :add_attachments + attr_accessor :describe_attachments attr_accessor :delete_attachments after_save :save_attachments after_save :destroy_attachments @@ -29,11 +30,11 @@ module PageAttachmentAssociations def save_attachments if @add_attachments - @add_attachments.each do |attachment| - attachments << PageAttachment.new(:uploaded_data => attachment) + @add_attachments.zip(@describe_attachments).each do |attachment, description| + attachments << PageAttachment.new(:uploaded_data => attachment, :description => description) end end @add_attachments = nil end end -end \ No newline at end of file +end app/models/page_attachment_associations.rb @@ -35,7 +35,7 @@ module PageAttachmentTags attachment.public_filename(size) end - [:content_type, :size, :width, :height].each do |key| + [:content_type, :size, :width, :height, :description].each do |key| desc %{ Renders the `#{key}' attribute of the attachment. The 'name' attribute is required on this tag or the parent tag. The optional 'size' app/models/page_attachment_tags.rb @@ -4,6 +4,7 @@ image_tag(attachment.thumbnails.find(:first, :conditions => "thumbnail = 'icon'").public_filename, :class => "thumbnail")%></td> <td> <%= File.basename(attachment.public_filename) %></td> + <td> <%= attachment.description %></td> <td><%= link_to_function image("minus", :title => "Remove attachment"), "remove_attachment(#{attachment.id})" %></td> </tr> -</table> \ No newline at end of file +</table> app/views/admin/page/_attachment.rhtml @@ -13,10 +13,11 @@ class CreatePageAttachmentsExtensionSchema < ActiveRecord::Migration t.column "updated_at", :datetime t.column "updated_by", :integer t.column "page_id", :integer + t.column "description", :string end end def self.down drop_table "page_attachments" end -end \ No newline at end of file +end db/migrate/001_create_page_attachments_extension_schema.rb @@ -1,6 +1,6 @@ function add_attachment() { var attachments_box = $('attachments'); - var template = new Template('<p class="attachment" id="file_#{id}"><label>Upload file: </label><input type="file" name="page[add_attachments][]" /> <a href="#" onclick="Element.remove(\'file_#{id}\')">Cancel</a></p>'); + var template = new Template('<p class="attachment" id="file_#{id}"><label>Upload file: </label><input type="file" name="page[add_attachments][]" /> <label>Description:</label><input type="text" name="page[describe_attachments][]" /><a href="#" onclick="Element.remove(\'file_#{id}\')">Cancel</a></p>'); new Insertion.Bottom(attachments_box, template.evaluate({id: Math.round(Math.random() * 100000)})); } function remove_attachment(id){ @@ -15,4 +15,4 @@ function remove_attachment(id){ } new Effect.Highlight('attachments-deleted'); } -} \ No newline at end of file +} public/javascripts/page_attachments.js 2bfd3ca5d44f39057bf796b65a1368a50ba76cd8 Joel Williams joel@badger.lan http://github.com/joelw/page_attachments/commit/454eb88bac9a3d31342f6f506091b71216f129ba 454eb88bac9a3d31342f6f506091b71216f129ba 2008-06-01T02:18:20-07:00 2008-06-01T02:18:20-07:00 Basic support for adding descriptions to file attachments. 9d86fa1ebbc7088e6e2d3faced65cb9ba800fd0e Joel Williams joel@badger.lan