block.rb
2.17 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
class Block < ActiveRecord::Base
# to be able to generate HTML
include ActionView::Helpers::UrlHelper
include ActionView::Helpers::TagHelper
# Block-specific stuff
include BlockHelper
acts_as_list :scope => :box
belongs_to :box
acts_as_having_settings
settings_items :visible, :type => :boolean, :default => true
def visible?
visible
end
# returns the description of the block, used when the user sees a list of
# blocks to choose one to include in the design.
#
# Must be redefined in subclasses to match the description of each block
# type.
def self.description
'(dummy)'
end
# Returns the content to be used for this block.
#
# This method can return several types of objects:
#
# * <tt>String</tt>: if the string starts with <tt>http://</tt> or <tt>https://</tt>, then it is assumed to be address of an IFRAME. Otherwise it's is used as regular HTML.
# * <tt>Hash</tt>: the hash is used to build an URL that is used as the address for a IFRAME.
# * <tt>Proc</tt>: the Proc is evaluated in the scope of BoxesHelper. The
# block can then use <tt>render</tt>, <tt>link_to</tt>, etc.
#
# The method can also return <tt>nil</tt>, which means "no content".
#
# See BoxesHelper#extract_block_content for implementation details.
def content
"This is block number %d" % self.id
end
# A footer to be appended to the end of the block. Returns <tt>nil</tt>.
#
# Override in your subclasses. You can return the same types supported by
# #content.
def footer
nil
end
# Is this block editable? (Default to <tt>false</tt>)
def editable?
true
end
# must always return false, except on MainBlock clas.
def main?
false
end
def owner
box ? box.owner : nil
end
def css_class_name
self.class.name.underscore.gsub('_', '-')
end
def css_classes
classes = css_class_name
classes += ' invisible-block' unless visible?
classes
end
def default_title
''
end
def title
if self[:title].blank?
self.default_title
else
self[:title]
end
end
def cacheable?
true
end
def cache_keys
"block-id-#{id}"
end
def timeout
4.hours
end
end