radiant-paperclipped-extension 0.8.1

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "vendor/plugins/imagespec"]
+	path = vendor/plugins/imagespec
+	url = git://github.com/andersonbrandon/ruby-imagespec.git

data/HELP_admin.markdown

@@ -0,0 +1,69 @@
+Paperclipped
+---
+
+Paperclip is a new file management plugin from Thoughtbot which has a  few advantages over attachment_fu: it doesn't use RMagick, which uses a lot of RAM and is a bit of overkill for just making thumbnails. Instead it directly uses ImageMagick, making it much easier to install. 
+
+
+###Installation
+
+To install paperclipped, just run 
+ 
+	rake production db:migrate:extensions
+	rake production radiant:extensions:paperclipped:update
+
+This runs the database migrations and installs the javascripts, images and css.
+
+###Configuration
+
+If you install the Setting Extension (highly recommended), you can also easily adjust both the sizes of any additional thumbnails and which thumbnails are displayed in the image edit view. The default is the original file, but any image size can be used by giving in the name of that size. 
+
+The configuration settings also enable a list of the allowed file types, maximum file size and should you need it, the path to your installation of Image Magick (this should not be needed, but I sometimes had a problem when using mod_rails).
+
+###Using Paperclipped
+
+Once installed, you get a new Tab with the entire assets library, a Bucket à la Mephisto (though only the concept is stolen) and a search. You can also easily attach assets to any page and directly upload them to a page.
+
+###Asset Tags
+
+There are a veriety of new tags. The basic tag is the <r:assets /> tag, which can be used either alone or as a double tag. This tag requires the "title" attribute, which references the asset. If you use the drag and drop from the asset bucket, this title will be added for you. 
+
+The *&lt;r:assets /&gt;* tag can be combined with other tags for a variety of uses: 
+
+    <r:assets:image title="foo" /> will return <img src="/path/to/foo" alt="foo" />
+    <r:assets:link title="foo" /> will return <a href="/path/to/foo">foo</a>
+
+You could also use: 
+
+    <r:assets:link title="foo" text="This is the link to foo" /> will return <a href="/path/to/foo">This is the link to foo</a>
+
+or 
+
+    <rassets:link title="foo">This is another link</r:link>
+
+Asset links are also available, such as content_type, file_size, and url. 
+
+Another important tag is the *&lt;r:assets:each&gt;...&lt;/r:assets:each&gt;*. If a page has attached assets, the assets:each tag will cycle through each asset. You can then use an image, link or url tag to display or connect your assets. 
+
+Thumbnails are automatically geneerated for images when the images are uploaded. By default, two sizes are made for use within the extension itself. These are "icon" 42px by 42px and "thumbnail" which is fit into 100px, maintaining its aspect ratio. 
+
+###Migrating from the page_attachments extension
+
+If you're moving from page_attachments to paperclipped, here's how to migrate smoothly;
+
+First, remove or disable the page_attachments extension, and install the paperclipped extension.
+For example:
+
+    rake ray:dis name=page_attachments
+    rake ray:assets
+
+or
+
+    rm -rf vendor/extensions/page_attachments
+    script/extension install paperclipped
+  
+The migration has now copied your original page_attachments table to old_page_attachments.
+
+    rake radiant:extensions:paperclipped:migrate_from_page_attachments
+  
+This rake task will create paperclipped-style attachments for all OldPageAttachments. It will also ask you if you want to clean up the old table and thumbnails in /public/page_attachments.
+Done!

data/LICENSE

@@ -0,0 +1,21 @@
+== MIT License
+ 
+Copyright (c) 2008-2010, Keith Bingman
+ 
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+ 
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,137 @@
+Paperclipped
+---
+
+## IMPORTANT!
+
+This version of Paperclipped now requires Radiant 0.9.0 or higher. Just in case, the previous version is still around, on a branch marked Radiant-0.8 
+
+Let me know if this works and if you run into any issues. 
+
+
+###Installation
+
+To install paperclipped, just run 
+ 
+	rake production db:migrate:extensions
+	rake production radiant:extensions:paperclipped:update
+
+This runs the database migrations and installs the javascripts, images and css.
+
+###Configuration
+
+If you install the Settings Extension (highly recommended), you can also easily adjust both the sizes of any additional thumbnails and which thumbnails are displayed in the image edit view. The default is the original file, but any image size can be used by giving in the name of that size. 
+
+If you do install the Settings Extension you should be sure to add a config.extensions line to your environment.rb file: 
+
+    config.extensions = [ :settings, :all ]
+   
+Also the Settings Extension migration should be run before Paperclipped's migration.
+
+The configuration settings also enable a list of the allowed file types, maximum file size and should you need it, the path to your installation of Image Magick (this should not be needed, but I sometimes had a problem when using mod_rails).
+
+Paperclipped will integrate with the Styles'n'Scripts extension. For that to work, you'll need to load that extension before paperclipped:
+
+    config.extensions = [ :sns, :all ]
+
+###Using Paperclipped
+
+Once installed, you get a new Tab with the entire assets library, a Bucket à la Mephisto (though only the concept is stolen) and a search. You can also easily attach assets to any page and directly upload them to a page.
+
+###Asset Tags
+
+There are a veriety of new tags. The basic tag is the <code><r:assets /></code> tag, which can be used either alone or as a double tag. This tag requires the "title" attribute, which references the asset. If you use the drag and drop from the asset bucket, this title will be added for you. 
+
+The <code><r:assets /></code> tag can be combined with other tags for a variety of uses: 
+
+    <r:assets:image title="foo" /> will return <img src="/path/to/foo" alt="foo" />
+
+    <r:assets:link title="foo" /> will return <a href="/path/to/foo">foo</a>
+
+You could also use: 
+
+    <r:assets:link title="foo" text="This is the link to foo" /> will return <a href="/path/to/foo">This is the link to foo</a>
+
+or 
+
+    <r:assets:link title="foo">This is another link</r:link>
+
+Asset links are also available, such as content_type, file_size, and url. 
+
+Another important tag is the <code><r:assets:each>...</r:assets:each></code>. If a page has attached assets, the assets:each tag will cycle through each asset. You can then use an image, link or url tag to display or connect your assets. Usage:
+
+    <r:assets:each [limit=0] [offset=0] [order="asc|desc"] [by="position|title|..."] [extensions="png|pdf|doc"]>
+      ...
+    </r:assets:each>
+
+`<r:assets:each>` parameters:
+
+* `limit` and `offset` let you specify a range of assets;
+* `order` and `by` lets you control sorting;
+* `extensions` allows you to filter assets by file extensions; you can specify multiple extensions separated by `|`.
+
+<code><pre>`<r:if_assets [min_count="0"]>` and `<r:unless_assets [min_count="0"]>` 
+</code></pre>
+  
+conditional tags let you optionally render content based on the existance of tags. They accept the same options as `<r:assets:each>`.
+
+Thumbnails are automatically generated for images when the images are uploaded. By default, two sizes are made for use within the extension itself. These are "icon" 42px by 42px and "thumbnail" which is fit into 100px, maintaining its aspect ratio.
+
+You can access sizes of image assets for various versions with the tags `<r:assets:width [size="original"]/>` and `<r:assets:height [size="original"]/>`.
+
+Also, for vertical centering of images, you have the handy `<r:assets:top_padding container="<container height>" [size="icon"]/>` tag. Working example:
+  
+
+    <ul>
+      <r:assets:each>
+        <li style="height:140px">
+          <img style="padding-top:<r:top_padding size='category' container='140' />px" 
+               src="<r:url />" alt="<r:title />" />
+        </li>
+      </r:assets:each>
+    </ul>
+   
+    
+###Using Amazon s3
+First, be sure you have the aws\-s3 gem installed. 
+
+<pre><code>gem install aws-s3</code></pre>
+
+Everything works as before, but now if you want to add S3 support, you simply set the storage setting to "s3". 
+
+<pre><code>Radiant::Config[assets.storage] = "s3"</code></pre>
+ 
+Then add 3 new settings with your Amazon credentials, either in the console or with the [Settings](http://github.com/Squeegy/radiant-settings/tree/master) extension:
+
+<pre><code>Radiant::Config[assets.s3.bucket] = "my_supercool_bucket"
+Radiant::Config[assets.s3.key] = "123456"
+Radiant::Config[assets.s3.secret] = "123456789ABCDEF"
+</code></pre>
+
+and finally the path you want to use within your bucket, which uses the same notation as the Paperclip plugin.
+
+<pre><code>Radiant::Config[assets.path] = :class/:id/:basename_:style.:extension 
+</code></pre>
+
+The path setting, along with a new <code>url</code> setting can be used with the file system to customize both the path and url of your assets.
+
+
+### Migrating from the page_attachments extension
+
+If you're moving from page_attachments to paperclipped, here's how to migrate smoothly:
+
+First, remove or disable the page_attachments extension, and install the paperclipped extension.
+For example:
+
+<pre><code>rake ray:dis name=page_attachments
+rake ray:assets
+</code></pre>
+    
+  
+The migration has now copied your original `page_attachments` table to `old_page_attachments`.
+
+<pre><code>rake radiant:extensions:paperclipped:migrate_from_page_attachments
+</code></pre>
+  
+This rake task will create paperclipped-style attachments for all `OldPageAttachments`. It will also ask you if you want to clean up the old table and thumbnails in `/public/page_attachments`.
+
+Done!

data/Rakefile

@@ -0,0 +1,110 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "radiant-paperclipped-extension"
+    gem.summary = %Q{Paperclipped extension for Radiant CMS}
+    gem.description = %Q{Assets extension based on the lightweight Paperclip plugin.}
+    gem.email = "benny@gorilla-webdesign.be"
+    gem.homepage = "https://github.com/jomz/paperclipped"
+    gem.authors = ["Keith Bingman"]
+    gem.add_dependency 'radiant', ">=0.9.1"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. This is only required if you plan to package copy_move as a gem."
+end
+# I think this is the one that should be moved to the extension Rakefile template
+
+# In rails 1.2, plugins aren't available in the path until they're loaded.
+# Check to see if the rspec plugin is installed first and require
+# it if it is.  If not, use the gem version.
+require File.join(File.dirname(__FILE__), '..', '..', '..', 'config', 'boot')
+require 'rake'
+require 'rake/rdoctask'
+
+rspec_base = File.expand_path(File.dirname(__FILE__) + '/../../radiant/vendor/plugins/rspec/lib')
+$LOAD_PATH.unshift(rspec_base) if File.exist?(rspec_base)
+require 'spec/rake/spectask'
+# require 'spec/translator'
+
+extension_root = File.expand_path(File.dirname(__FILE__))
+
+task :default => :spec
+task :stats => "spec:statsetup"
+
+desc "Run all specs in spec directory"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+namespace :spec do
+  desc "Run all specs in spec directory with RCov"
+  Spec::Rake::SpecTask.new(:rcov) do |t|
+    t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec', '--rails']
+  end
+  
+  desc "Print Specdoc for all specs"
+  Spec::Rake::SpecTask.new(:doc) do |t|
+    t.spec_opts = ["--format", "specdoc", "--dry-run"]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+  end
+
+  [:models, :controllers, :views, :helpers].each do |sub|
+    desc "Run the specs under spec/#{sub}"
+    Spec::Rake::SpecTask.new(sub) do |t|
+      t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+      t.spec_files = FileList["spec/#{sub}/**/*_spec.rb"]
+    end
+  end
+  
+  # Hopefully no one has written their extensions in pre-0.9 style
+  # desc "Translate specs from pre-0.9 to 0.9 style"
+  # task :translate do
+  #   translator = ::Spec::Translator.new
+  #   dir = RAILS_ROOT + '/spec'
+  #   translator.translate(dir, dir)
+  # end
+
+  # Setup specs for stats
+  task :statsetup do
+    require 'code_statistics'
+    ::STATS_DIRECTORIES << %w(Model\ specs spec/models)
+    ::STATS_DIRECTORIES << %w(View\ specs spec/views)
+    ::STATS_DIRECTORIES << %w(Controller\ specs spec/controllers)
+    ::STATS_DIRECTORIES << %w(Helper\ specs spec/views)
+    ::CodeStatistics::TEST_TYPES << "Model specs"
+    ::CodeStatistics::TEST_TYPES << "View specs"
+    ::CodeStatistics::TEST_TYPES << "Controller specs"
+    ::CodeStatistics::TEST_TYPES << "Helper specs"
+    ::STATS_DIRECTORIES.delete_if {|a| a[0] =~ /test/}
+  end
+
+  namespace :db do
+    namespace :fixtures do
+      desc "Load fixtures (from spec/fixtures) into the current environment's database.  Load specific fixtures using FIXTURES=x,y"
+      task :load => :environment do
+        require 'active_record/fixtures'
+        ActiveRecord::Base.establish_connection(RAILS_ENV.to_sym)
+        (ENV['FIXTURES'] ? ENV['FIXTURES'].split(/,/) : Dir.glob(File.join(RAILS_ROOT, 'spec', 'fixtures', '*.{yml,csv}'))).each do |fixture_file|
+          Fixtures.create_fixtures('spec/fixtures', File.basename(fixture_file, '.*'))
+        end
+      end
+    end
+  end
+end
+
+desc 'Generate documentation for the assets extension.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'PaperclippedExtension'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+# Load any custom rakefiles for extension
+Dir[File.dirname(__FILE__) + '/tasks/*.rake'].sort.each { |f| require f }

data/VERSION

@@ -0,0 +1 @@
+0.8.1

data/app/controllers/admin/assets_controller.rb

@@ -0,0 +1,124 @@
+class Admin::AssetsController < Admin::ResourceController
+  paginate_models
+  skip_before_filter :verify_authenticity_token, :only => :create
+
+  def index
+    @assets = Asset.search(params[:search], params[:filter], params[:p])
+    @page = Page.find(params[:asset_page]) if params[:asset_page]
+
+    respond_to do |format|
+      format.html { render }
+      format.js {
+        @template_name = 'index'
+        if !@page.nil?
+          render :partial => 'admin/assets/search_results.html.haml', :layout => false
+        else
+          render :partial => 'admin/assets/asset_table.html.haml', :locals => { :assets => @assets }, :layout => false
+        end
+      }
+    end
+  end
+
+  def create
+    @asset = Asset.new(params[:asset])
+    if @asset.save
+      if params[:page]
+        @page = Page.find(params[:page])
+        @asset.pages << @page
+      end
+
+      respond_to do |format|
+        format.html {
+          flash[:notice] = "Asset successfully uploaded."
+          redirect_to(@page ? edit_admin_page_path(@page) : (params[:continue] ? edit_admin_asset_path(@asset) : admin_assets_path))
+        }
+        format.js {
+          responds_to_parent do
+            render :update do |page|
+              @attachment = PageAttachment.find(:first, :conditions => { :page_id => @page.id, :asset_id => @asset.id })
+              page.call('Asset.ChooseTabByName', 'page-attachments')
+              page.insert_html :bottom, "attachments", :partial => 'admin/assets/asset', :locals => {:attachment => @attachment }
+              page.call('Asset.AddAsset', "attachment_#{@attachment.id}")  # we ought to reinitialise the sortable attachments too
+              page.visual_effect :highlight, "attachment_#{@attachment.id}"
+              page.call('Asset.ResetForm')
+            end
+          end
+        }
+      end
+    else
+      render :action => 'new'
+    end
+  end
+
+
+  # Refreshes the paperclip thumbnails
+  def refresh
+    unless params[:id]
+      @assets = Asset.find(:all)
+      @assets.each do |asset|
+        asset.asset.reprocess!
+      end
+      flash[:notice] = "Thumbnails successfully refreshed."
+      redirect_to admin_assets_path
+    else
+      @asset = Asset.find(params[:id])
+      @asset.asset.reprocess!
+      flash[:notice] = "Thumbnail successfully refreshed."
+      redirect_to edit_admin_asset_path(@asset)
+    end
+  end
+
+
+  # Bucket related actions. These may need to be spun out into a seperate controller
+  # update?
+  def add_bucket
+    @asset = Asset.find(params[:id])
+    if (session[:bucket] ||= {}).key?(@asset.asset.url)
+      render :nothing => true and return
+    end
+    asset_type = @asset.image? ? 'image' : 'link'
+    session[:bucket][@asset.asset.url] = { :thumbnail => @asset.thumbnail(:thumbnail), :id => @asset.id, :title => @asset.title, :type => asset_type }
+
+    render :update do |page|
+      page[:bucket_list].replace_html "#{render :partial => 'bucket'}"
+    end
+  end
+
+  def clear_bucket
+    session[:bucket] = nil
+    render :update do |page|
+      page[:bucket_list].replace_html '<li><p class="note"><em>Your bucket is empty.</em></p></li>'
+    end
+  end
+
+  # Attaches an asset to the current page
+  def attach_asset
+    @asset = Asset.find(params[:asset])
+    @page = Page.find(params[:page])
+    @page.assets << @asset unless @page.assets.include?(@asset)
+    clear_model_cache
+    render :partial => 'page_assets', :locals => { :page => @page }
+    # render :update do |page|
+    #   page[:attachments].replace_html "#{render :partial => 'page_assets', :locals => {:page => @page}}"
+    # end
+  end
+
+  # Removes asset from the current page
+  def remove_asset
+    @asset = Asset.find(params[:asset])
+    @page = Page.find(params[:page])
+    @page.assets.delete(@asset)
+    clear_model_cache
+    render :nothing => true
+  end
+
+  def reorder
+    params[:attachments].each_with_index do |id,idx|
+      page_attachment = PageAttachment.find(id)
+      page_attachment.position = idx+1
+      page_attachment.save
+    end
+    clear_model_cache
+    render :nothing => true
+  end
+end