Ubiquo multimedia management system (Store and categorize media assets)
Ruby JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
config
install
lib
test
.gitignore
AUTHORS
Gemfile
MIT-LICENSE
README
Rakefile
VERSION
ubiquo_media.gemspec

README

UbiquoMedia
===========

This plugin provides a media management system for Ubiquo. Once installed, you will be able to:

* Centralize and manage all the media files from the Ubiquo Media section
Create, edit or delete new assets that will be available throughout your app

* Easily enhance your models with a media selector
Add a single line to your model definition and it will be immediately able to store assets, without migrations

* Use an AJAX asset searcher on forms
That will find assets as you type them

* Organize your assets by type or visibility
Restrict a model attribute to just some types of assets (images, videos..) and decide if the asset is public or private

Basic example
=============

In your model, add:

  media_attachment :attrs

In your form, add:

   <%= media_selector form, :attrs %>

And that's all - now your model has a :attrs field that can store ubiquo media files, and you can fill it using the form

Detailed examples
=================

== Add media to your models

On this example we include a _media_attachment_ attribute called _images_, with a maximum of 2 elements and accepting only images.

  class ExampleModel
          media_attachment :images, :size => 2, :types => ["image"]
    ...
  end

Note: For convention, the attribute name should be always plural no matter if it contains a single element (_size_ option is 1). The _media_attachment_ accessor always returns an array.

_media_attachment_ creates some methods on the object which can be useful on validations:

  validates_length_of :images_ids, :minumum => 1, :message => t('should contain at least one image')

== Add media selectors to your views

In your views you only need to use the _media_selector_ helper:

  <% form_for ... do |form| %>
          ....
          <%= media_selector form, :images, :visibility => 'public' %>
          ....
  <% end %>

The visibility attribute allows you to filter which assets will be available in this selector

== Add media to your views

Get an url to your media with _url_for_media_attachment_:

  <%= link_to("a link to first image image", url_for_media_attachment(object.images.first)) %>



Copyright (c) 2009 International Product Design S.L. - gnuine (http://www.gnuine.com)