trusty-clipped-extension 1.0.0

data/LICENSE

@@ -0,0 +1,22 @@
+== MIT License
+
+Copyright (c) 2011 Keith Bingman, Benny Degezelle, William Ross, and John W. Long
+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,191 @@
+# TrustyCms Clipped Extension
+
+[![Build Status](https://secure.travis-ci.org/radiant/radiant-clipped-extension.png)](http://travis-ci.org/radiant/radiant-clipped-extension)
+
+Asset management for TrustyCms CMS.
+
+The Clipped extension comes bundled with the TrustyCms gem but may be updated separately. Only TrustyCms versions 1.0 or newer are supported.
+
+Please file bugs and feature requests on [Github][issues]. If you have questions regarding usage ask on the [mailing list][mailing-list].
+
+[issues]: https://github.com/pgharts/trusty-clipped-extension/issues
+
+## Features
+
+* Concurrent uploads
+* Automatic thumbnail generation
+  * requires ImageMagick for images
+  * requires FFmpeg for videos
+  * requires Ghostscript for PDFs
+* In-page and dedicated management interfaces
+* Easily to extended with new asset types and processors
+
+## Installation
+
+If you installed the TrustyCms gem then you already have Clipped installed. You can upgrade to a newer version using `bundle update trusty-clipped-extension`.
+
+Installation of the optional post-processors varies by system but are likely available through your package manager.
+
+### Mac OSX
+
+    brew install ghostscript imagemagick ffmpeg
+    # or
+    port install ghostscript imagemagick ffmpeg
+
+### Debian
+
+    apt-get install ghostscript imagemagick ffmpeg
+
+### Windows
+
+[Ghostscript][ghostscript], [ImageMagick][imagemagick] and [FFmpeg][ffmpeg] all
+offer Windows installers that you can install in the usual way.
+
+[ghostscript]: http://sourceforge.net/projects/ghostscript/
+[imagemagick]: http://www.imagemagick.org/script/binary-releases.php
+[ffmpeg]: http://ffmpeg.zeranoe.com/builds/
+
+If the post-processors are not in your `PATH` or you're running Passenger you might need to set `Paperclip.options[:command_path]` to the location where the binaries are installed.
+
+## Configuration
+
+The clipped extension is configured in the usual way, but only its minor settings are exposed in the admin interface. The more architectural settings shouldn't be changed at runtime and some of them will require a lot of sorting out if they're changed at all, so those are only accessible through the console or by editing the database. Eventually they will be made part of the initial trusty-cms installation process.
+
+### Structural settings
+
+* `paperclip.url` sets the url scheme for attached files. Paperclip interpolations are applied. You probably don't want to change this.
+* `paperclip.path` sets the path scheme for attached files. Paperclip interpolations are applied. You might conceivably want to change this.
+* `paperclip.storage` can be 'filesystem' (the default) or 'fog' for cloud storage (such as s3).
+* `paperclip.skip_filetype_validation` is true by default and allows uploads of any mime type.
+
+### Cloud Storage
+
+Set `paperclip.storage` to 'fog' and add the following line to your `Gemfile`
+
+`gem "fog", "~> 1.0"`
+
+You also have to provide the following settings:
+
+* `paperclip.fog.provider` # set to one of "AWS", "Google" or "Rackspace"
+
+If set to AWS, provide the following:
+
+* `paperclip.s3.bucket`
+* `paperclip.s3.key`
+* `paperclip.s3.secret`
+* `paperclip.s3.region`
+
+If set to "Google", provide the following:
+
+* `paperclip.fog.directory`
+* `paperclip.google_storage.access_key_id`
+* `paperclip.google_storage.secret_access_key`
+
+If set to "Rackspace", provide the following:
+
+* `paperclip.fog.directory`
+* `paperclip.rackspace.username`
+* `paperclip.rackspace.api_key`
+
+And optionally:
+
+* `paperclip.fog.host`
+* `paperclip.fog.public?`
+
+### Configurable settings
+
+If you want to disable a whole category of post-processing, set one of these options to false:
+
+* `assets.create_image_thumbnails?`
+* `assets.create_video_thumbnails?`
+* `assets.create_pdf_thumbnails?`
+
+If we can't find ffmpeg on initialization, video thumbnailing will be disabled automatically by setting `assets.create_video_thumbnails?` to false.
+
+To set a threshold for the size of uploads permitted:
+
+* `assets.max_asset_size` which should be an integer number of MB
+
+And you can set some defaults:
+
+* `assets.insertion_size` is the name of the style that's used when you click on 'insert' to add a radius asset tag to your text. You can edit it after insertion, of course.
+* `assets.display_size` is the name of the style that's shows when you edit a single asset in the admin interface.
+
+
+### Asset Thumbnail Sizes
+
+To configure different thumbnail sizes, set `assets.thumbnails.image`. Here is an example of setting two custom thumbnail sizes:
+
+    TrustyCms::Config['assets.thumbnails.image'] = "custom:geometry=200x300>,format=jpg|bigger:geometry=600x700>,format=jpg"
+
+## Usage
+
+For most purposes you will probably work with assets while you're working on pages. Click on one of the 'assets' links and a panel will pop up allowing you to find, insert and attach existing assets or upload new ones.
+
+For tidying up, replacing files and other admin, click on the 'assets' tab to get a larger version of the same list. Here again you can search for assets and filter the results by type, but the options are 'edit' and 'remove' and on editing you can change name, file and caption while keeping page associations intact.
+
+## Radius Tags
+
+The asset manager has its own family of radius tags. The basic tag is `<r:asset/>`, which can be used either alone or as a double tag. This tag requires a `name` or `id` attribute, which references the asset. The `<r:asset/>` tag can be combined with other tags for a variety of uses:
+
+    <r:asset:image name="image.png"/>  #=>  <img src="/path/to/image.png" />
+    <r:asset:link name="image.png"/>   #=>  <a href="/path/to/image.png">image.png</a>
+
+You could also use:
+
+    <r:asset:link name="bar.pdf">Download PDF</r:asset:link>
+
+Asset links are also available, such as content_type, file_size, and url.
+
+Another important tag is the `<r:assets:each>...</r:assets:each>` (note the plural namespace tag "assets"). If a page has attached assets, the `<r:assets:each>` tag will cycle through each asset. You can then use an image, `link` or `url` tag to display and connect your assets. Usage:
+
+    <r:assets:each [limit=0] [offset=0] [order="asc|desc"] [by="position|title|..."]>
+      ...
+    </r:assets:each>
+
+This tag uses the following parameters:
+
+* `limit` and `offset` let you specify a range of assets
+* `order` and `by` lets you control sorting
+
+The conditional tags `<r:if_assets [min_count="0"]>` and `<r:unless_assets [min_count="0"]>` allow you to optionally render content based on the existence 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 100px square.
+
+You can access sizes of image assets for various versions with tags like `<r:asset:width [size="original"]/>` and `<r:asset:height [size="original"]/>`.
+
+Also, for vertical centering of images, you have the handy `<r:asset: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:caption/>">
+        </li>
+      </r:assets:each>
+    </ul>
+
+## Contributions
+
+If you would like to contribute, please [fork the project][fork] and submit a [pull request][pull-request].
+
+[fork]: http://help.github.com/fork-a-repo/
+[pull-request]: http://help.github.com/send-pull-requests/
+
+Pull requests with working tests are preferred and have a greater chance of being merged.
+
+## TODO
+
+* Progress bars while uploading assets
+* Warning if you try and save a page while assets are still uploading
+* Radius tags for the HTML video and audio elements
+* Auxiliary extension to add video transcoding support
+
+## Authors
+
+* Keith Bingman
+* John Long
+* William Ross
+* Eric Sipple
+
+
+Copyright 2011 the TrustyCms team. Released under the same terms as TrustyCms.

data/Rakefile

@@ -0,0 +1,109 @@
+# Determine where the RSpec plugin is by loading the boot
+unless defined? RADIANT_ROOT
+  ENV["RAILS_ENV"] = "test"
+  case
+  when ENV["RADIANT_ENV_FILE"]
+    require File.dirname(ENV["RADIANT_ENV_FILE"]) + "/boot"
+  when File.dirname(__FILE__) =~ %r{vendor/radiant/vendor/extensions}
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../../")}/config/boot"
+  else
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../")}/config/boot"
+  end
+end
+
+require 'rake'
+require 'rdoc/task'
+require 'rake/testtask'
+
+rspec_base = File.expand_path(RADIANT_ROOT + '/vendor/plugins/rspec/lib')
+$LOAD_PATH.unshift(rspec_base) if File.exist?(rspec_base)
+require 'spec/rake/spectask'
+require 'cucumber'
+require 'cucumber/rake/task'
+
+# Cleanup the RADIANT_ROOT constant so specs will load the environment
+Object.send(:remove_const, :RADIANT_ROOT)
+
+extension_root = File.expand_path(File.dirname(__FILE__))
+
+task :default => [:spec, :features]
+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
+
+task :features => 'spec:integration'
+
+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
+  
+  desc "Run the Cucumber features"
+  Cucumber::Rake::Task.new(:integration) do |t|
+    t.fork = true
+    t.cucumber_opts = ['--format', (ENV['CUCUMBER_FORMAT'] || 'pretty')]
+    # t.feature_pattern = "#{extension_root}/features/**/*.feature"
+    t.profile = "default"
+  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 clipped extension.'
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ClippedExtension'
+  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/app/assets/javascripts/admin/assets.js

@@ -0,0 +1,261 @@
+Assets = {
+  attachEvents: function() {
+    $('a.attach_asset').click(function(e){
+      e.preventDefault();
+      var link = $(this);
+      var container = link.parents('li.asset');
+      var title = link.parents('div.title').html();
+      var image = link.parents('img');
+      container.addClass('waiting');
+      $.ajax({
+        url: link.attr('href'),
+        success: function(data, textStatus, jqXHR) {
+          container.removeClass('waiting');
+          Assets.addToList(data);
+        }
+      });
+    });
+
+    $('a.detach_asset').click(function(e){
+      e.preventDefault();
+      var link = $(this);
+      Assets.removeFromList(link.parents('li.asset'));
+    });
+
+    $('a.insert_asset').click(function(e){
+      e.preventDefault();
+      var part_name = $("a.tab.here").children('span').html();
+      if (part_name.indexOf(' ')) part_name = part_name.replace(' ', '-');
+      var part_id = 'part_' + part_name + '_content';
+      var tag_parts = $(this).attr('rel').split('_');
+      var tag_name = tag_parts[0];
+      var asset_size = tag_parts[1];
+      var asset_id = tag_parts[2];
+      var radius_tag = '<r:asset:' + tag_name;
+      if (asset_size != '') radius_tag = radius_tag + ' size="' + asset_size + '"';
+      radius_tag =  radius_tag +' id="' + asset_id + '" />';
+      Assets.insertAtCursor(part_id, radius_tag);
+
+    });
+
+    $(".pagination a").click(function(e){
+      e.preventDefault();
+      $.ajax({
+        method: 'get',
+        url: $(this).attr('href') + Assets.assetFilterParameters(),
+        complete: function(data, textStatus, jqXHR) {
+          Assets.updateTable(data.responseText);
+          Assets.attachEvents();
+        }
+      });
+    });
+
+  },
+
+  assetFilterParameters: function() {
+    var parameters = [];
+    if ($('#filesearchforminput').val() !== '') {
+      parameters.push(['search', $('#filesearchforminput').val()]);
+    }
+    var filters = [];
+    var url_params = "";
+    $('a.selective.pressed').each(function(){
+      filters.push($(this).attr('rel'));
+    });
+
+    if (filters.length > 0) {parameters.push(['filter', filters.toString()])}
+
+    for(var i = 0; i < parameters.length; i++) {
+      if (i > 0) {url_params = url_params + '&'}
+      url_params = url_params + parameters[i][0] + '=' + parameters[i][1];
+    }
+    return url_params + '&pp=20';
+  },
+
+  activateUpload: function(){
+    $('#upload-controls').hide();
+    $('#update-controls').show();
+    $('#asset_title').prop( "disabled", false );
+    $('#new_asset input[name="commit"]').prop( "disabled", false );
+  },
+  activateUpdate: function() {
+    $('#upload-controls').show();
+    $('#update-controls').hide();
+    $('#asset_title').prop( "disabled", true );
+    $('#new_asset input[name="commit"]').prop( "disabled", true );
+  },
+
+  insertAtCursor: function(part_id, insertion) {
+    if (CKEDITOR.instances[part_id].mode == 'wysiwyg') {
+      CKEDITOR.instances[part_id].insertText( insertion );
+    } else {
+      var textbox = $("textarea.cke_source[title~=" + part_id +"]");
+      var caretPos = textbox[0].selectionStart;
+      var textAreaTxt = textbox.val();
+      textbox.val(textAreaTxt.substring(0, caretPos) + insertion + textAreaTxt.substring(caretPos) );
+    }
+  },
+  filterAssets: function() {
+    var url = $("#filesearchform").attr('action');
+    var parameters = Assets.assetFilterParameters();
+
+    url = url + "?" + parameters;
+    $.ajax({
+      url: url,
+      complete: function(data, textStatus, jqXHR) {
+        Assets.updateTable(data.responseText);
+      }
+    });
+  },
+  updateTable: function(html) {
+    $("#assets_table").html(html);
+    Assets.attachEvents();
+  },
+  addToList: function(html){
+    var list = $('#attachment_fields');
+    list.append(html);
+    Assets.showListIfHidden();
+    Assets.notify('Save page to commit changes');
+    Assets.attachEvents();
+    // I'm not sure what Sortable does and can't find any example of
+    // its use in current Radiant, so I'm going to comment it out for now.
+
+    //Assets.makeSortable(list);
+
+  },
+  removeFromList: function(container) {
+    container.children('input.attacher').remove();
+    container.children('input.pos').remove();
+    container.children('input.destroyer').val(1);
+    container.fadeOut();
+    container.addClass('detached');
+  },
+  showListIfHidden: function() {
+    var list = $('#attachment_fields');
+    if (list.hasClass('empty')) {
+      list.removeClass('empty');
+    }
+  },
+  notify: function(message){
+    $('#attachment_list span.message').html(message).addClass('important');
+  }
+
+};
+
+
+$(function() {
+
+  $('a.selective').click(function(e){
+    e.preventDefault();
+    var element = $(this);
+    var type_id = element.attr('rel');
+    var type_check = $('#' + type_id + '-check');
+
+    if(element.hasClass('pressed')) {
+      element.removeClass('pressed');
+      $(type_check).prop('checked', false);
+      if ($('a.selective.pressed').length == 0) $('#select_all').addClass('pressed');
+    }
+    else {
+      element.addClass('pressed');
+      $('a.deselective').each(function() { $(this).removeClass('pressed'); });
+      $(type_check).prop('checked', true);
+    }
+    Assets.filterAssets();
+    Assets.attachEvents();
+
+  });
+
+  $('a.deselective').click(function(e){
+    e.preventDefault();
+    var element = $(this);
+    if(!element.hasClass('pressed')) {
+      $('a.selective').each(function() { $(this).removeClass('pressed'); });
+      $('input.selective').each(function() { $(this).prop('checked', false); });
+      element.addClass('pressed');
+      Assets.filterAssets();
+      Assets.attachEvents();
+    }
+  });
+
+  $('#filesearchforminput').keyup(function(){
+    Assets.filterAssets();
+    Assets.attachEvents();
+  });
+
+  $("#attach_assets").click(function(e) {
+    e.preventDefault();
+    Popup.show('attach_asset');
+    $('.close_popup').click(function(e){
+      e.preventDefault();
+      Popup.close();
+      $('#attach_asset').hide();
+    });
+  });
+
+  $('#filesearchforminput').keyup(function(){
+    Assets.filterAssets();
+  });
+
+  $("#upload_asset_link").click(function(e) {
+    e.preventDefault();
+    Popup.close();
+    $('#attach_asset').hide();
+    Assets.activateUpdate();
+    Popup.show('upload_asset');
+
+    $("#attach-popup").click(function(e) {
+      e.preventDefault();
+      Popup.close();
+      $('#upload_asset').hide();
+      Popup.show('attach_asset');
+      $('.close_popup').click(function(e){
+        e.preventDefault();
+        Popup.close();
+        $('#attach_asset').hide();
+      });
+    });
+
+  $('.close_popup').click(function(e){
+    e.preventDefault();
+    Popup.close();
+    $('#upload_asset').hide();
+    });
+  });
+
+  $('#update_asset').submit(function(e){
+    e.preventDefault();
+    $("#update-asset").attr("disabled", true);
+    $('#update-status').show();
+    $.ajax({
+      method: 'put',
+      url: $(this).attr('action') + $("#asset_id").val(),
+      data: $(this).serialize(),
+      complete: function(data, textStatus, jqXHR) {
+        Popup.close();
+        $('#upload_asset').hide();
+        $('#update-status').hide();
+        $("#update-asset").attr("disabled", false);
+        $('#update_asset').trigger("reset");
+      }
+    });
+  });
+
+  $('#asset_asset').fileupload({
+    add: function(e, data) {
+      $("#asset_asset").attr("disabled", true);
+      $('#upload-status').show();
+      data.submit();
+    },
+    done: function (e, data) {
+      $("#asset_id").val($(data.result).find(".attacher").val());
+      Assets.addToList($(data.result));
+      Assets.activateUpload();
+      $("#asset_asset").attr("disabled", false);
+      $('#upload-status').hide();
+    }
+  });
+
+  Assets.attachEvents();
+
+});