Class: ShopifyAPI::Asset

Inherits:
Base show all
Includes:
DisablePrefixCheck
Defined in:
lib/shopify_api/resources/asset.rb

Overview

Assets represent the files that comprise your theme. There are different buckets which hold different kinds of assets, each corresponding to one of the folders within a theme's zip file: "layout", "templates", "snippets", "assets", and "config". The full key of an asset always starts with the bucket name, and the path separator is a forward slash, like layout/theme.liquid or assets/bg-body.gif.

Initialize with a key:

asset = ShopifyAPI::Asset.new(:key => 'assets/special.css', :theme_id => 12345)

Find by key:

asset = ShopifyAPI::Asset.find('assets/image.png', :params => {:theme_id => 12345})

Get the text or binary value:

asset.value # decodes from attachment attribute if necessary

You can provide new data for assets in a few different ways:

* assign text data for the value directly:
    asset.value = "div.special {color:red;}"

* provide binary data for the value:
    asset.attach(File.read('image.png'))

* set a URL from which Shopify will fetch the value:
    asset.src = "http://mysite.com/image.png"

* set a source key of another of your assets from which
  the value will be copied:
    asset.source_key = "assets/another_image.png"

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Countable

#count

Methods inherited from ActiveResource::Base

#encode

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method_symbol, *arguments) ⇒ Object

:nodoc:



84
85
86
87
88
89
# File 'lib/shopify_api/resources/asset.rb', line 84

def method_missing(method_symbol, *arguments) #:nodoc:
  if %w{value= attachment= src= source_key=}.include?(method_symbol)
    wipe_value_attributes
  end
  super
end

Class Method Details

.element_path(id, prefix_options = {}, query_options = nil) ⇒ Object

:nodoc:



44
45
46
47
# File 'lib/shopify_api/resources/asset.rb', line 44

def self.element_path(id, prefix_options = {}, query_options = nil) #:nodoc:
  prefix_options, query_options = split_options(prefix_options) if query_options.nil?
  "#{prefix(prefix_options)}#{collection_name}.#{format.extension}#{query_string(query_options)}"
end

.find(*args) ⇒ Object

find an asset by key:

ShopifyAPI::Asset.find('layout/theme.liquid', :params => {:theme_id => 99})


51
52
53
54
55
56
57
58
59
60
61
62
# File 'lib/shopify_api/resources/asset.rb', line 51

def self.find(*args)
  if args[0].is_a?(Symbol)
    super
  else
    params = {:asset => {:key => args[0]}}
    params = params.merge(args[1][:params]) if args[1] && args[1][:params]
    path_prefix = params[:theme_id] ? "/admin/themes/#{params[:theme_id]}" : "/admin"
    resource = find(:one, :from => "#{path_prefix}/assets.#{format.extension}", :params => params)
    resource.prefix_options[:theme_id] = params[:theme_id] if resource && params[:theme_id]
    resource
  end
end

.prefix(options = {}) ⇒ Object



40
41
42
# File 'lib/shopify_api/resources/asset.rb', line 40

def self.prefix(options={})
  options[:theme_id].nil? ? "/admin/" : "/admin/themes/#{options[:theme_id]}/"
end

Instance Method Details

#attach(data) ⇒ Object



72
73
74
# File 'lib/shopify_api/resources/asset.rb', line 72

def attach(data)
  self.attachment = Base64.encode64(data)
end

#destroyObject



76
77
78
# File 'lib/shopify_api/resources/asset.rb', line 76

def destroy
  connection.delete(element_path(prefix_options.merge(:asset => {:key => key})), self.class.headers)
end

#new?Boolean



80
81
82
# File 'lib/shopify_api/resources/asset.rb', line 80

def new?
  false
end

#valueObject

For text assets, Shopify returns the data in the 'value' attribute. For binary assets, the data is base-64-encoded and returned in the 'attachment' attribute. This accessor returns the data in both cases.



67
68
69
70
# File 'lib/shopify_api/resources/asset.rb', line 67

def value
  attributes['value'] ||
  (attributes['attachment'] ? Base64.decode64(attributes['attachment']) : nil)
end