intesys_asset_manager 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2a1cb98b922dade5b2ba917b8abd26d895c2c875
+  data.tar.gz: 17b3fcd866ff20117a30abb55d82e061846f043d
+SHA512:
+  metadata.gz: f70c5c69fa38af77c997f7c07c09c5718e3c5b9f4c6cff16c54a7055f17589bbe351a9ae8477020d0c972376d2020b3097246ec14af3f7921a0b464c1bcaffeb
+  data.tar.gz: 34350867b152064406b76d7d916e47c752e1f338ea0f51a7f93f19a82b7b59155c0dd0d2ad08bad35fa2b27790bff5d5399f571d06fe7658eb2e962ef27445b9

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2012-2014 Intesys S.r.l.
+
+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.rdoc

@@ -0,0 +1,127 @@
+= Asset Manager
+
+Asset Manager is a Ruby on Rails gem that allows you to:
+- Manage all your assets (images, pdf, zip, ecc.) in a central repository
+- Quickly connect instances of your models with this repository, through a nice graphical interface
+- Generate markup for your assets in your views with a series of helper methods
+To give you a practical example, you can upload an image through the Asset Manager and then associate it to a product and a news article without having to upload it twice. You just make your selection from the central repository.
+Asset Manager is generally included in an administration interface where the user manages all her assets and associates them with various application specific model instances. Then, on the frontend side, to present these assets to the end-user.
+
+Please note: Asset Manager doesn't have anything to do with Rails' asset pipeline!
+
+== Installation
+Add it to your Gemfile:
+  gem 'intesys_asset_manager'
+
+Install the migrations:
+  rake asset_manager:install:migrations
+  rake db:migrate
+
+== Usage
+Since Asset Manager is a Rails engine you need to mount it in your application:
+
+  in config/routes.rb:
+
+  Rails::Application.routes.draw do
+    mount AssetManager::Engine => '/asset_manager'
+  end
+
+Once mounted you can access the administration interface by visiting /asset_manager in a browser.
+
+{http://www.intesys.it/asset_manager/docs/am-repository.jpg}[http://www.intesys.it/asset_manager/docs/am-repository.jpg]
+
+From here you can manage all your application's assets: jpg, png, pdf, zip, etc.
+For the images that you upload a series of (customizable) versions will be created automatically.
+
+Next you need to specify which of your models will be connected to the Asset Manager.
+If, for example, we have a Product that has a main image and a series of pictures and downloads we add the following to our Product model:
+
+  class Product < ActiveRecord::Base
+    has_image :main_image
+    has_images :pictures, max: 10
+    has_files :downloads
+  end
+
+You have two methods to choose from: has_file when the association is singular and has_files when multiple files need to be associated. These methods accept a series of parameters to specify which file types are accepted, how many files can be associated (for has_files), etc.
+
+Once you have your models configured you can connect assets with your records. Asset Manager provides a Formtastic input type to make it easier for you to manage your forms (we will add support for Simpleform in the future):
+  = semantic_form_for @product do |f|
+    = f.inputs do
+      = f.input :title
+      = f.input :description
+    = f.inputs
+      = f.input :main_image, as: :asset_manager
+      = f.input :pictures, as: :asset_manager
+      = f.input :downloads, as: :asset_manager
+
+The Asset Manager will be opened in a modal window so you application needs to provide one. For example, if you're using Fancybox you need to add the following to your application.js:
+  //= require fancybox2
+  $ ->
+    $(".asset_manager_iframe").fancybox
+      type: 'iframe'
+      width: '100%'
+      height: '100%'
+      autoSize: false
+      helpers:
+        title:
+          type: 'outside'
+
+Then you will have something similar to:
+
+{http://www.intesys.it/asset_manager/docs/am-main_image-ass.jpg}[http://www.intesys.it/asset_manager/docs/am-main_image-ass.jpg]
+{http://www.intesys.it/asset_manager/docs/am-pictures-ass.jpg}[http://www.intesys.it/asset_manager/docs/am-pictures-ass.jpg]
+{http://www.intesys.it/asset_manager/docs/am-downloads-ass.jpg}[http://www.intesys.it/asset_manager/docs/am-downloads-ass.jpg]
+
+Now that we have associated assets with our records we can use one of the view helpers provided by Asset Manager to present them to the end-user:
+  = am_render(@product, :main_image)
+  = am_render(@product, :pictures)
+  = am_render(@product, :download)
+
+== Options
+
+Asset Manager can be configured through an initializer <b>config/initializers/asset_manager.rb</b>
+  AssetManager.configure do |config|
+    ...
+  end
+
+=== Private/Public Assets
+By default all your assets will be public. It's also possible to have private assets or a mix of both.
+  config.asset_types = [:public, :private]
+
+=== Categories and Tags
+Assets can be categoriezed and tagged to keep things organized.
+  config.with_categories = false
+  config.with_tags = false
+
+=== Image processing
+Asset Manager relies on ImageMagick to process images (for thumbnails etc.). To specify how the processing is done and which formats are created you can redefine <b>custom_versions</b>:
+  module AssetManager
+    module CustomVersions
+
+      # For a list of possible options, take a look at:
+      # http://carrierwave.rubyforge.org/rdoc/classes/CarrierWave/RMagick.html
+      def custom_versions
+        version :thumb, :if => :image? do
+          process :resize_and_pad => [50, 50]
+        end
+      end
+
+    end
+  end
+
+There is also a rake task to re-process already existing images when you add a new format:
+  rake asset_manager:recreate_versions
+
+== Project Roadmap
+
+- FCKEditor (Rich) integration
+- Input for SimpleForm
+- Evaluate dragonfly
+- Test :)
+
+== Project Info
+Asset Manager was created by {Federico Bonomi}[https://github.com/fbonomi] with contributions from {Nicola Prando}[https://github.com/pranik], {Daniel Jonasson}[https://github.com/djonasson] and {Umberto Gariggio}[https://github.com/gariggio]
+
+The project is hosted on Github: http://github.com/intesys/asset_manager, where your contributions, forkings, comments, issues and feedback are greatly welcomed.
+
+Copyright © 2012-2014 Intesys S.r.l., released under the MIT license.

data/Rakefile

@@ -0,0 +1,31 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'AssetManager'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path('../spec/dummy/Rakefile', __FILE__)
+load 'rails/tasks/engine.rake'
+
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec
+

data/app/assets/javascripts/asset_manager.js.coffee

@@ -0,0 +1,149 @@
+#= require jquery
+#= require jquery_ujs
+#= require jquery.ui.all
+#= require bootstrap2/bootstrap
+#= require chosen-jquery
+#= require ias/jquery.ias
+#= require fancybox
+#= require jquery-fileupload/basic
+#= require jquery-fileupload/vendor/tmpl
+#= require cocoon
+
+$ ->
+  $(window).load ->
+    if $('body').hasClass('assets select')
+      setTimeout ->
+        $('form#search').find('select').chosen()
+      , 100
+
+  $(document).ready ->
+
+    # Overlay gallery
+    $('a.overlay').fancybox
+      maxWidth: 800
+      maxHeight: 600
+      fitToView: false
+      width: '70%'
+      height: '70%'
+      autoSize: false
+      closeClick: false
+      openEffect: 'none'
+      closeEffect: 'none'
+      type: 'image'
+
+    # Fast upload
+    $quickUpload = $('#quick_upload')
+    if $quickUpload.length
+      $quickUpload.find('.link-upload').click ->
+        $quickUpload.toggleClass('open')
+      $quickUpload.find('form').fileupload
+        dataType: "script"
+        add: (e, data) ->
+          $('#quick_upload .progress').remove()
+          file = data.files[0]
+          data.context = $(tmpl("template-upload", file))
+          $('#quick_upload .well').append(data.context)
+          data.submit()
+        progress: (e, data) ->
+          if data.context
+            progress = parseInt(data.loaded / data.total * 100, 10)
+            data.context.find('.bar').css('width', progress + '%')
+
+    if $('body').hasClass('assets select')
+      # Ias - Infinite scroll
+      $.ias
+        container: "#sortable1.connectedSortable"
+        item: ".resource.asset"
+        pagination: ".assets-navigation"
+        next: "a[rel=next]"
+        loader: '<img src="/assets/ias/loader.gif" alt="Loading..." />'
+
+      # Params
+      param_max = parseInt($('.param-max').html())
+      param_multiple = $('.param-multiple').html()
+      param_field = $('.param-field').html()
+      param_field_name = $('.param-field-name').html()
+      param_save = $('.param-save').html() == 'true'
+      param_resource_id = $('.param-resource-id').html()
+      $form_search = $('form#search')
+      $dinamyc_assets_field = parent.$("#dinamyc_assets_" + param_field + (if param_save then param_resource_id else ''))
+      param_update_url = $dinamyc_assets_field.attr('data-update-url')
+
+      # Submit form
+      $form_search.submit ->
+        $(this).addClass('loading')
+        $("#sortable2 .resource.asset").each ->
+          $form_search.append('<input type="hidden" name="ids[]" value="' + $(this).attr('data-id') + '" />')
+
+      # Sortable - Drag and Drop
+      $("#sortable1, #sortable2").sortable
+        connectWith: ".connectedSortable"
+      .disableSelection()
+      $("#sortable2").bind "sortreceive", (event, ui)->
+        if $(this).find(".resource.asset").length > param_max
+          $(ui.sender).sortable('cancel')
+          alert "Limite massimo superato"
+
+      # Action Cancel
+      $('button.cancel').click ->
+        closeModal()
+
+      # Action Select
+      $('button.select').click ->
+        ids = []
+        $("#sortable2 .resource.asset:lt(" + param_max + ")").each ->
+          ids.push($(this).attr('data-id'))
+        if (ids.length == 0)
+          if param_save
+            saveSelection('', [])
+          else
+            endSelection('', [])
+        else
+          $.ajax
+            url: "/asset_manager/managed_assets/preview"
+            data: { ids: ids }
+            dataType: "html"
+            success: (result)->
+              if param_save
+                saveSelection(result, ids)
+              else
+                endSelection(result, ids)
+
+      # Save Selection
+      saveSelection = (xhtml, ids) ->
+        data = {}
+        if (param_multiple == 'true')
+          value = if (ids.length > 0) then ids else 'no'
+        else
+          value = if (ids.length > 0) then ids[0] else 'no'
+        #data[param_field_name] = if (param_multiple == true) then ids else ids[0]
+        data[param_field_name] = value
+        $.ajax
+          url: param_update_url
+          type: 'PUT'
+          data: data
+          dataType: "html"
+          #success: (result)->
+          #  alert result
+        $dinamyc_assets_field.html(xhtml)
+        closeModal()
+
+      # End Selection
+      endSelection = (xhtml, ids) ->
+        $link_select = $dinamyc_assets_field.siblings("a")
+        original_href = $link_select.attr('data-href')
+        if ids.length > 0
+          $.each ids, (key, value) ->
+            xhtml += '<input type="hidden" name="' + param_field_name + '" value="' + value + '" />'
+          $.each ids, (key, value) ->
+            original_href += '&ids[]=' + value
+        else
+          xhtml += '<input type="hidden" name="' + param_field_name + '" value="" />' + $dinamyc_assets_field.attr('no_items_label')
+          original_href += '&ids[]=no'
+        $dinamyc_assets_field.html(xhtml)
+        $link_select.attr('href', original_href)
+        closeModal()
+
+      # Close Modal
+      closeModal = ->
+        parent.$.fancybox.close()

data/app/assets/stylesheets/asset_manager.css.sass

@@ -0,0 +1,85 @@
+/* The plugins folder contains a plugins.css.sass file that we use to include
+ * all the plugins necessary for our application. In this folder we can also
+ * put configuration files for individual plugins.
+ *
+ * Structure example:
+ *   plugins/
+ *   |--plugins.css.sass
+ *   |--my_plugin.css.sass
+ *   |--my_complex_plugin/
+ *   |  |--fonts.css.sass
+ *   |  |--colors.css.sass
+ */
+@import "asset_manager/plugins/**/*"
+
+/* In base we keep things like CSS resets, element defaults (e.g. link colors),
+ * font settings etc. The category is largely dominated by element selectors.
+ * We try to be very careful about what we put in this folder in order not to
+ * not loose flexibility down the road.
+ *
+ * Structure example:
+ *   base/
+ *   |--fonts.css.sass
+ *   |--colors.css.sass
+ */
+@import "asset_manager/base/**/*"
+
+/* The files for layout elements such as "header", "footer", "sidebar", etc.
+ * are kept in the layout folder.
+ *
+ * Structure example:
+ *   layout/
+ *   |--header.css.sass
+ *   |--footer.css.sass
+ */
+@import "asset_manager/layout/**/*"
+
+/* This folder is made up of independent modules and submodules. Examples for
+ * modules could be things like: search-box, dialog, navigation, menu,
+ * content-box. While submodules are more specific versions of these modules
+ * such as: dialog-wide, navigation-tabbed, menu-dropdown.
+ *
+ * The ideal module is completely independent of its context and should work
+ * within any layout container or other module. If a specific context requires
+ * changes to a module you rather create a submodule that describes the
+ * context, instead changing styles based on the parent (e.g.
+ * .content-box-narrow instead of #sidebar .content-box).
+ *
+ * Structure example:
+ *   modules/
+ *   |--search-box.css.sass
+ *   |--dialog.css.sass
+ */
+@import "asset_manager/modules/**/*"
+
+/* The resources folder is an important one and should contain various
+ * representations of your resources. A blog post, for example, probably should
+ * look slightly different as a search result than in a "latest posts" list on
+ * the home page.
+ *
+ * In order to avoid duplication and to uniform presentation we try to define
+ * as much as possible of our resources' styling in the "resource" classes.
+ *
+ * Structure example:
+ *   resources/
+ *   |--resource/
+ *   |  |--resource.css.sass
+ *   |  |--excerpt_resource.css.sass
+ *   |--posts/
+ *   |  |--post.css.sass
+ *   |  |--excerpt_post.css.sass
+ *   |  |--link_post.css.sass
+ *
+ */
+@import "asset_manager/resources/**/*"
+
+/* Sometimes it can be useful to make a small customization to a particular
+ * controller/view. NOTE: Care should be taken to avoid putting styling in
+ * these files unless it really depends on the context.
+ *
+ * Structure example:
+ *   controllers/
+ *   |--news.css.sass
+ *   |--pages.css.sass
+ */
+@import "asset_manager/controllers/**/*"

data/app/assets/stylesheets/asset_manager/controllers/assets.css.sass

@@ -0,0 +1,104 @@
+$sx-width: 80%
+$dx-width: 100% - $sx-width
+
+body
+  &.assets, &.asset_categories
+    .filters
+      +box-shadow(0 0 0)
+      padding: 10px
+      .filters-title
+        margin-bottom: 15px
+        font:
+          size: 14px
+          weight: bold
+      form
+        label
+          font-size: 13px
+        input[type=text]
+          width: 100%
+          padding-left: 0
+          padding-right: 0
+        select
+          width: 100%
+    &.show
+      table
+        thead
+          tr
+            th
+              background: #e5e5e5
+              color: #333
+        tbody
+          tr
+            td
+              &:first-child
+                width: 20%
+                font-style: italic
+
+
+body.assets
+  &.index
+    .nav-pills
+      margin-bottom: 10px
+  &.select
+    padding: 0
+    .sx
+      $sx-internal-width: 95%
+      float: left
+      width: $sx-width
+      .search
+        z-index: 10
+        position: fixed
+        width: $sx-width
+        background: white
+        .top
+          width: $sx-internal-width
+          .well
+            margin-bottom: 0
+            form
+              margin: 0
+              select
+                width: 100%
+              .chzn-container
+                width: 100% !important
+              &.loading
+                background: url(/assets/loader.gif) no-repeat right center
+      .collection
+        padding-top: 107px
+        #quick_upload
+          width: $sx-internal-width
+          margin-bottom: 12px
+        .resources.assets
+          min-height: 200px
+      #infscr-loading
+        clear: both
+        padding: 1em 0
+        width: $sx-internal-width
+        text-align: center
+    .dx
+      float: right
+      width: $dx-width
+      .associations
+        position: fixed
+        top: 0
+        bottom: 0
+        width: $dx-width
+        .assets-container-drag
+          border: 1px dotted #ccc
+          padding: 10px
+          margin-bottom: 1em
+          height: 80%
+        #sortable2
+          height: 100%
+          overflow: auto
+  .form-horizontal
+    #asset_instances
+      .control-group
+        margin-bottom: 0
+      .item
+        margin: 2px 0 20px 180px
+        .resource.asset-instance
+          table
+            margin-bottom: 0
+            td
+              .controls
+                margin-left: 0