public
Description: Liquid markup language. Save, customer facing template language for flexible web apps.
Homepage: http://www.liquidmarkup.org
Clone URL: git://github.com/tobi/liquid.git
Click here to lend your support to: liquid and make a donation at www.pledgie.com !
liquid / lib / liquid / standardfilters.rb
100644 210 lines (173 sloc) 6.074 kb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
require 'cgi'
 
module Liquid
  
  module StandardFilters
    
    # Return the size of an array or of an string
    def size(input)
      
      input.respond_to?(:size) ? input.size : 0
    end
    
    # convert a input string to DOWNCASE
    def downcase(input)
      input.to_s.downcase
    end
 
    # convert a input string to UPCASE
    def upcase(input)
      input.to_s.upcase
    end
    
    # capitalize words in the input centence
    def capitalize(input)
      input.to_s.capitalize
    end
        
    def escape(input)
      CGI.escapeHTML(input) rescue input
    end
    
    alias_method :h, :escape
    
    # Truncate a string down to x characters
    def truncate(input, length = 50, truncate_string = "...")
      if input.nil? then return end
      l = length.to_i - truncate_string.length
      l = 0 if l < 0
      input.length > length.to_i ? input[0...l] + truncate_string : input
    end
 
    def truncatewords(input, words = 15, truncate_string = "...")
      if input.nil? then return end
      wordlist = input.to_s.split
      l = words.to_i - 1
      l = 0 if l < 0
      wordlist.length > l ? wordlist[0..l].join(" ") + truncate_string : input
    end
    
    def strip_html(input)
      input.to_s.gsub(/<.*?>/, '')
    end
    
    # Remove all newlines from the string
    def strip_newlines(input)
      input.to_s.gsub(/\n/, '')
    end
    
    
    # Join elements of the array with certain character between them
    def join(input, glue = ' ')
      [input].flatten.join(glue)
    end
 
    # Sort elements of the array
    # provide optional property with which to sort an array of hashes or drops
    def sort(input, property = nil)
      ary = [input].flatten
      if property.nil?
        ary.sort
      elsif ary.first.respond_to?('[]') and !ary.first[property].nil?
        ary.sort {|a,b| a[property] <=> b[property] }
      elsif ary.first.respond_to?(property)
        ary.sort {|a,b| a.send(property) <=> b.send(property) }
      end
    end
    
    # map/collect on a given property
    def map(input, property)
      ary = [input].flatten
      if ary.first.respond_to?('[]') and !ary.first[property].nil?
        ary.map {|e| e[property] }
      elsif ary.first.respond_to?(property)
        ary.map {|e| e.send(property) }
      end
    end
            
    # Replace occurrences of a string with another
    def replace(input, string, replacement = '')
      input.to_s.gsub(string, replacement)
    end
                                                 
    # Replace the first occurrences of a string with another
    def replace_first(input, string, replacement = '')
      input.to_s.sub(string, replacement)
    end
                                                           
    # remove a substring
    def remove(input, string)
      input.to_s.gsub(string, '')
    end
                        
    # remove the first occurrences of a substring
    def remove_first(input, string)
      input.to_s.sub(string, '')
    end
                              
    # add one string to another
    def append(input, string)
      input.to_s + string.to_s
    end
                                
    # prepend a string to another
    def prepend(input, string)
      string.to_s + input.to_s
    end
                                             
    # Add <br /> tags in front of all newlines in input string
    def newline_to_br(input)
      input.to_s.gsub(/\n/, "<br />\n")
    end
    
    # Reformat a date
    #
    # %a - The abbreviated weekday name (``Sun'')
    # %A - The full weekday name (``Sunday'')
    # %b - The abbreviated month name (``Jan'')
    # %B - The full month name (``January'')
    # %c - The preferred local date and time representation
    # %d - Day of the month (01..31)
    # %H - Hour of the day, 24-hour clock (00..23)
    # %I - Hour of the day, 12-hour clock (01..12)
    # %j - Day of the year (001..366)
    # %m - Month of the year (01..12)
    # %M - Minute of the hour (00..59)
    # %p - Meridian indicator (``AM'' or ``PM'')
    # %S - Second of the minute (00..60)
    # %U - Week number of the current year,
    # starting with the first Sunday as the first
    # day of the first week (00..53)
    # %W - Week number of the current year,
    # starting with the first Monday as the first
    # day of the first week (00..53)
    # %w - Day of the week (Sunday is 0, 0..6)
    # %x - Preferred representation for the date alone, no time
    # %X - Preferred representation for the time alone, no date
    # %y - Year without a century (00..99)
    # %Y - Year with century
    # %Z - Time zone name
    # %% - Literal ``%'' character
    def date(input, format)
      
      if format.to_s.empty?
        return input.to_s
      end
      
      date = input.is_a?(String) ? Time.parse(input) : input
      
      if date.respond_to?(:strftime)
        date.strftime(format.to_s)
      else
        input
      end
    rescue => e
      input
    end
    
    # Get the first element of the passed in array
    #
    # Example:
    # {{ product.images | first | to_img }}
    #
    def first(array)
      array.first if array.respond_to?(:first)
    end
 
    # Get the last element of the passed in array
    #
    # Example:
    # {{ product.images | last | to_img }}
    #
    def last(array)
      array.last if array.respond_to?(:last)
    end
    
    # addition
    def plus(input, operand)
      input + operand if input.respond_to?('+')
    end
    
    # subtraction
    def minus(input, operand)
      input - operand if input.respond_to?('-')
    end
    
    # multiplication
    def times(input, operand)
      input * operand if input.respond_to?('*')
    end
    
    # division
    def divided_by(input, operand)
      input / operand if input.respond_to?('/')
    end
    
  end
   
  Template.register_filter(StandardFilters)
end