breadcrumbs_on_rails 0.2.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/CHANGELOG.rdoc CHANGED
@@ -1,6 +1,18 @@
1
1
  = Changelog
2
2
 
3
3
 
4
+ == Release 1.0.1
5
+
6
+ * FIXED: Since the removal of rails/init.rb in 7278376ab77651e540e39552384ad9677e32ff7e, Rails fails to load the helpers.
7
+
8
+
9
+ == Release 1.0.0
10
+
11
+ * CHANGED: Removed empty install/uninstall hooks and tasks folder.
12
+
13
+ * CHANGED: Removed rails/init hook because deprecated in Rails 3.
14
+
15
+
4
16
  == Release 0.2.0
5
17
 
6
18
  * Releasing the library as open source project.
data/LICENSE.rdoc CHANGED
@@ -1,4 +1,4 @@
1
- Copyright (c) 2009 Simone Carletti
1
+ Copyright (c) 2009-2010 Simone Carletti
2
2
 
3
3
  Permission is hereby granted, free of charge, to any person obtaining
4
4
  a copy of this software and associated documentation files (the
data/Manifest CHANGED
@@ -1,19 +1,16 @@
1
1
  CHANGELOG.rdoc
2
+ LICENSE.rdoc
3
+ Manifest
4
+ README.rdoc
5
+ Rakefile
2
6
  init.rb
3
- install.rb
7
+ lib/breadcrumbs_on_rails.rb
4
8
  lib/breadcrumbs_on_rails/breadcrumbs.rb
5
9
  lib/breadcrumbs_on_rails/controller_mixin.rb
6
10
  lib/breadcrumbs_on_rails/version.rb
7
- lib/breadcrumbs_on_rails.rb
8
- LICENSE.rdoc
9
- Manifest
10
11
  rails/init.rb
11
- Rakefile
12
- README.rdoc
13
- tasks/tabs_on_rails_tasks.rake
14
12
  test/breadcrumbs_on_rails_test.rb
15
13
  test/builder_test.rb
16
14
  test/element_test.rb
17
15
  test/simple_builder_test.rb
18
16
  test/test_helper.rb
19
- uninstall.rb
data/README.rdoc CHANGED
@@ -7,7 +7,7 @@ It provides helpers for creating navigation elements with a flexible interface.
7
7
  == Requirements
8
8
 
9
9
  * Ruby >= 1.8.6
10
- * Rails >= 2.2
10
+ * Rails 2.2.x, 2.3.x or 3.0 (see section Rails 3 below)
11
11
 
12
12
 
13
13
  == Rails Installation
@@ -15,21 +15,30 @@ It provides helpers for creating navigation elements with a flexible interface.
15
15
  === As a Gem
16
16
 
17
17
  This is the preferred way to install BreadcrumbsOnRails and the best way if you want install a stable version.
18
- The GEM is hosted on {Gemcutter}[http://gemcutter.org/gems/tabs_on_rails].
18
+ The GEM is hosted on {RubyGems}[http://rubygems.org/gems/breadcrumbs_on_rails].
19
19
 
20
- $ gem install breadcrumbs_on_rails --source http://gemcutter.org
20
+ $ gem install breadcrumbs_on_rails
21
21
 
22
- With Rails >= 2.2, you can specify the GEM dependency in your environment.rb file so that Rails will automatically check the requirement on startup.
22
+ ==== Rails 2.2.x and 2.3.x
23
+
24
+ With Rails 2.2.x and 2.3.x, you need to specify the GEM dependency in your <tt>environment.rb</tt> file so that Rails will automatically include the library on startup.
23
25
 
24
26
  Rails::Initializer.run do |config|
25
27
 
26
28
  # other configurations
27
29
  # ...
28
30
 
29
- config.gem "breadcrumbs_on_rails", :source => "http://gemcutter.org"
31
+ config.gem "breadcrumbs_on_rails"
30
32
 
31
33
  end
32
34
 
35
+ ==== Rails 3
36
+
37
+ With Rails 3, you need to specify the GEM dependency in your <tt>Gemfile</tt> file so that Bundler can resolve, download and install the library.
38
+
39
+ gem "breadcrumbs_on_rails"
40
+
41
+
33
42
  === As a Plugin
34
43
 
35
44
  This is the preferred way if you want to live on the edge and install a development version.
@@ -39,7 +48,7 @@ This is the preferred way if you want to live on the edge and install a developm
39
48
 
40
49
  == Usage
41
50
 
42
- Having a breadcrumb navigation menu in your Rails app using BreadcrumbsOnRails is really straightforward.
51
+ Creating a breadcrumb navigation menu in your Rails app using BreadcrumbsOnRails is really straightforward.
43
52
 
44
53
  In your controller, call <tt>add_breadcrumb</tt> to push a new element on the breadcrumb stack. <tt>add_breadcrumb</tt> requires two arguments: the name of the breadcrumb and the target path.
45
54
 
@@ -65,7 +74,7 @@ In your view, you can render the breadcrumb menu with the <tt>render_breadcrumbs
65
74
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
66
75
  <title>untitled</title>
67
76
  </head>
68
-
77
+
69
78
  <body>
70
79
  <%= render_breadcrumbs %>
71
80
  </body>
@@ -85,18 +94,17 @@ A breadcrumbs menu is composed by a number of <tt>Element</tt> objects. Each obj
85
94
 
86
95
  When you call <tt>add_breadcrumb</tt>, the method automatically creates a new <tt>Element</tt> object for you and append it to the breadcrumbs stack. <tt>Element</tt> name and path can be one of the following Ruby types:
87
96
 
88
- <ul>
89
- <li>Symbol</li>
90
- <li>Proc</li>
91
- <li>String</li>
92
- </ul>
97
+ * Symbol
98
+ * Proc
99
+ * String
100
+
93
101
 
94
102
  ==== Symbol
95
103
 
96
104
  If the value is a Symbol, the library calls the corresponding method defined in the same context the and sets the <tt>Element</tt> attribute to the returned value.
97
105
 
98
106
  class MyController
99
-
107
+
100
108
  # The Name is set to the value returned by
101
109
  # the :root_name method.
102
110
  add_breadcrumb :root_name, root_path
@@ -113,29 +121,29 @@ If the value is a Symbol, the library calls the corresponding method defined in
113
121
 
114
122
  If the value is a Proc, the library calls the proc passing the current view context as argument and sets the <tt>Element</tt> attribute to the returned value. This is useful if you want to postpone the execution to get access to some special methods/variables created in your controller action.
115
123
 
116
- class MyController
124
+ class MyController
117
125
 
118
- # The Name is set to the value returned by
119
- # the :root_name method.
120
- add_breadcrumb Proc.new { |c| c.my_helper_method },
121
- root_path
126
+ # The Name is set to the value returned by
127
+ # the :root_name method.
128
+ add_breadcrumb Proc.new { |c| c.my_helper_method },
129
+ root_path
122
130
 
123
- end
131
+ end
124
132
 
125
133
  ==== String
126
134
 
127
135
  If the value is a Proc, the library sets the <tt>Element</tt> attribute to the string value.
128
136
 
129
137
  class MyController
130
-
138
+
131
139
  # The Name is set to the value returned by
132
140
  # the :root_name method.
133
141
  add_breadcrumb "homepage", "http://example.com/"
134
-
142
+
135
143
  end
136
144
 
137
145
 
138
- === Restricting set_tab scope
146
+ === Restricting breadcrumb scope
139
147
 
140
148
  The <tt>add_breadcrumb</tt> method understands all options you are used to pass to a Rails controller filter.
141
149
  In fact, behind the scenes this method uses a <tt>before_filter</tt> to store the tab in the <tt>@breadcrumbs</tt> variable.
@@ -146,10 +154,10 @@ Taking advantage of Rails filter options, you can restrict a tab to a selected g
146
154
  add_breadcrumb "admin", admin_path
147
155
  add_breadcrumb "posts, posts_path, :only => %w(index show)
148
156
  end
149
-
157
+
150
158
  class ApplicationController < ActionController::Base
151
159
  add_breadcrumb "admin", admin_path, :if => :admin_controller?
152
-
160
+
153
161
  def admin_controller?
154
162
  self.class.name =~ /^Admin(::|Controller)/
155
163
  end
@@ -168,7 +176,7 @@ For example, if you want to localize your menu, define a new breadcrumbs node in
168
176
  first: First
169
177
  second: Second
170
178
  third: Third
171
-
179
+
172
180
  # config/locales/it.yml
173
181
  it:
174
182
  breadcrumbs:
@@ -184,30 +192,41 @@ In your controller, use the <tt>I18n.t</tt> method.
184
192
  add_breadcrumb I18n.t("breadcrumbs.second"), second_path, :only => %w(second)
185
193
  add_breadcrumb I18n.t("breadcrumbs.third"), third_path, :only => %w(third)
186
194
  end
187
-
195
+
188
196
  class ApplicationController < ActionController::Base
189
197
  add_breadcrumb I18n.t("breadcrumbs.homepage"), root_path
190
198
  end
191
199
 
200
+ === Rails 3
201
+
202
+ This plugin is "partially" compatible with Rails 3.
203
+ The first attempt to create an unique release compatible with both Rails 2.x and Rails 3 failed
204
+ due to some Rails 3 internal changes
205
+ (see http://github.com/weppos/breadcrumbs_on_rails/commit/b25885ceb293193b6b264177769f003985df3bff).
192
206
 
193
- == Documentation
207
+ This version is specifically packaged and tested against Rails 2.3.x,
208
+ but you can use it in a Rails 3 application by manually including the
209
+ <tt>BreadcrumbsOnRails::ControllerMixin</tt> mixin in your <tt>ApplicationController</tt>.
210
+
211
+ class ApplicationController < ActionController::Base
212
+ include BreadcrumbsOnRails::ControllerMixin
213
+ end
194
214
 
195
- The library is still under development and this README file might not be contain the latest changes.
196
- For the full documentation, development roadmap and more information please visit the {project page}[http://code.simonecarletti.com/wiki/breadonrails].
215
+ A Rails 3 version will be available very soon.
197
216
 
198
217
 
199
- == Credits
218
+ == Author
200
219
 
201
- Author:: {Simone Carletti}[http://www.simonecarletti.com] <weppos@weppos.net>
220
+ * {Simone Carletti}[http://www.simonecarletti.com] <weppos@weppos.net>
202
221
 
203
222
 
204
223
  == Resources
205
224
 
206
- * {Homepage}[http://code.simonecarletti.com/breadonrails]
207
- * {GitHub}[http://github.com/weppos/breadcrumbs_on_rails]
225
+ * {Homepage}[http://github.com/weppos/breadcrumbs_on_rails]
226
+ * {Bugs & Features}[http://github.com/weppos/breadcrumbs_on_rails/issues]
208
227
 
209
228
 
210
229
  == License
211
230
 
212
- Copyright (c) 2009 Simone Carletti, BreadcrumbsOnRails is released under the MIT license.
231
+ Copyright (c) 2009-2010 Simone Carletti, BreadcrumbsOnRails is released under the MIT license.
213
232
 
@@ -2,20 +2,20 @@
2
2
 
3
3
  Gem::Specification.new do |s|
4
4
  s.name = %q{breadcrumbs_on_rails}
5
- s.version = "0.2.0"
5
+ s.version = "1.0.1"
6
6
 
7
7
  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
8
8
  s.authors = ["Simone Carletti"]
9
- s.date = %q{2009-11-27}
9
+ s.date = %q{2010-05-09}
10
10
  s.description = %q{ BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing a breadcrumb navigation for a Rails project. It provides helpers for creating navigation elements with a flexible interface.
11
11
  }
12
12
  s.email = %q{weppos@weppos.net}
13
- s.extra_rdoc_files = ["CHANGELOG.rdoc", "lib/breadcrumbs_on_rails/breadcrumbs.rb", "lib/breadcrumbs_on_rails/controller_mixin.rb", "lib/breadcrumbs_on_rails/version.rb", "lib/breadcrumbs_on_rails.rb", "LICENSE.rdoc", "README.rdoc", "tasks/tabs_on_rails_tasks.rake"]
14
- s.files = ["CHANGELOG.rdoc", "init.rb", "install.rb", "lib/breadcrumbs_on_rails/breadcrumbs.rb", "lib/breadcrumbs_on_rails/controller_mixin.rb", "lib/breadcrumbs_on_rails/version.rb", "lib/breadcrumbs_on_rails.rb", "LICENSE.rdoc", "Manifest", "rails/init.rb", "Rakefile", "README.rdoc", "tasks/tabs_on_rails_tasks.rake", "test/breadcrumbs_on_rails_test.rb", "test/builder_test.rb", "test/element_test.rb", "test/simple_builder_test.rb", "test/test_helper.rb", "uninstall.rb", "breadcrumbs_on_rails.gemspec"]
13
+ s.extra_rdoc_files = ["CHANGELOG.rdoc", "LICENSE.rdoc", "README.rdoc", "lib/breadcrumbs_on_rails.rb", "lib/breadcrumbs_on_rails/breadcrumbs.rb", "lib/breadcrumbs_on_rails/controller_mixin.rb", "lib/breadcrumbs_on_rails/version.rb"]
14
+ s.files = ["CHANGELOG.rdoc", "LICENSE.rdoc", "Manifest", "README.rdoc", "Rakefile", "init.rb", "lib/breadcrumbs_on_rails.rb", "lib/breadcrumbs_on_rails/breadcrumbs.rb", "lib/breadcrumbs_on_rails/controller_mixin.rb", "lib/breadcrumbs_on_rails/version.rb", "rails/init.rb", "test/breadcrumbs_on_rails_test.rb", "test/builder_test.rb", "test/element_test.rb", "test/simple_builder_test.rb", "test/test_helper.rb", "breadcrumbs_on_rails.gemspec"]
15
15
  s.homepage = %q{http://code.simonecarletti.com/breadonrails}
16
16
  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Breadcrumbs_on_rails", "--main", "README.rdoc"]
17
17
  s.require_paths = ["lib"]
18
- s.rubygems_version = %q{1.3.5}
18
+ s.rubygems_version = %q{1.3.6}
19
19
  s.summary = %q{A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.}
20
20
  s.test_files = ["test/breadcrumbs_on_rails_test.rb", "test/builder_test.rb", "test/element_test.rb", "test/simple_builder_test.rb", "test/test_helper.rb"]
21
21
 
@@ -20,9 +20,9 @@ require 'breadcrumbs_on_rails/version'
20
20
 
21
21
 
22
22
  module BreadcrumbsOnRails
23
-
23
+
24
24
  NAME = 'Breadcrumbs on Rails'
25
25
  GEM = 'breadcrumbs_on_rails'
26
26
  AUTHORS = ['Simone Carletti <weppos@weppos.net>']
27
-
28
- end
27
+
28
+ end
@@ -104,4 +104,4 @@ module BreadcrumbsOnRails
104
104
 
105
105
  end
106
106
 
107
- end
107
+ end
@@ -17,12 +17,12 @@
17
17
  module BreadcrumbsOnRails
18
18
 
19
19
  module Version
20
- MAJOR = 0
21
- MINOR = 2
22
- PATCH = 0
23
- ALPHA = nil
20
+ MAJOR = 1
21
+ MINOR = 0
22
+ PATCH = 1
23
+ BUILD = nil
24
24
 
25
- STRING = [MAJOR, MINOR, PATCH, ALPHA].compact.join('.')
25
+ STRING = [MAJOR, MINOR, PATCH, BUILD].compact.join('.')
26
26
  end
27
27
 
28
28
  VERSION = Version::STRING
metadata CHANGED
@@ -1,7 +1,12 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: breadcrumbs_on_rails
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ prerelease: false
5
+ segments:
6
+ - 1
7
+ - 0
8
+ - 1
9
+ version: 1.0.1
5
10
  platform: ruby
6
11
  authors:
7
12
  - Simone Carletti
@@ -9,29 +14,37 @@ autorequire:
9
14
  bindir: bin
10
15
  cert_chain: []
11
16
 
12
- date: 2009-11-27 00:00:00 +01:00
17
+ date: 2010-05-09 00:00:00 +02:00
13
18
  default_executable:
14
19
  dependencies:
15
20
  - !ruby/object:Gem::Dependency
16
21
  name: rake
17
- type: :development
18
- version_requirement:
19
- version_requirements: !ruby/object:Gem::Requirement
22
+ prerelease: false
23
+ requirement: &id001 !ruby/object:Gem::Requirement
20
24
  requirements:
21
25
  - - ~>
22
26
  - !ruby/object:Gem::Version
27
+ segments:
28
+ - 0
29
+ - 8
30
+ - 7
23
31
  version: 0.8.7
24
- version:
32
+ type: :development
33
+ version_requirements: *id001
25
34
  - !ruby/object:Gem::Dependency
26
35
  name: echoe
27
- type: :development
28
- version_requirement:
29
- version_requirements: !ruby/object:Gem::Requirement
36
+ prerelease: false
37
+ requirement: &id002 !ruby/object:Gem::Requirement
30
38
  requirements:
31
39
  - - ~>
32
40
  - !ruby/object:Gem::Version
41
+ segments:
42
+ - 3
43
+ - 2
44
+ - 0
33
45
  version: 3.2.0
34
- version:
46
+ type: :development
47
+ version_requirements: *id002
35
48
  description: " BreadcrumbsOnRails is a simple Ruby on Rails plugin for creating and managing a breadcrumb navigation for a Rails project. It provides helpers for creating navigation elements with a flexible interface.\n"
36
49
  email: weppos@weppos.net
37
50
  executables: []
@@ -40,33 +53,29 @@ extensions: []
40
53
 
41
54
  extra_rdoc_files:
42
55
  - CHANGELOG.rdoc
56
+ - LICENSE.rdoc
57
+ - README.rdoc
58
+ - lib/breadcrumbs_on_rails.rb
43
59
  - lib/breadcrumbs_on_rails/breadcrumbs.rb
44
60
  - lib/breadcrumbs_on_rails/controller_mixin.rb
45
61
  - lib/breadcrumbs_on_rails/version.rb
46
- - lib/breadcrumbs_on_rails.rb
47
- - LICENSE.rdoc
48
- - README.rdoc
49
- - tasks/tabs_on_rails_tasks.rake
50
62
  files:
51
63
  - CHANGELOG.rdoc
64
+ - LICENSE.rdoc
65
+ - Manifest
66
+ - README.rdoc
67
+ - Rakefile
52
68
  - init.rb
53
- - install.rb
69
+ - lib/breadcrumbs_on_rails.rb
54
70
  - lib/breadcrumbs_on_rails/breadcrumbs.rb
55
71
  - lib/breadcrumbs_on_rails/controller_mixin.rb
56
72
  - lib/breadcrumbs_on_rails/version.rb
57
- - lib/breadcrumbs_on_rails.rb
58
- - LICENSE.rdoc
59
- - Manifest
60
73
  - rails/init.rb
61
- - Rakefile
62
- - README.rdoc
63
- - tasks/tabs_on_rails_tasks.rake
64
74
  - test/breadcrumbs_on_rails_test.rb
65
75
  - test/builder_test.rb
66
76
  - test/element_test.rb
67
77
  - test/simple_builder_test.rb
68
78
  - test/test_helper.rb
69
- - uninstall.rb
70
79
  - breadcrumbs_on_rails.gemspec
71
80
  has_rdoc: true
72
81
  homepage: http://code.simonecarletti.com/breadonrails
@@ -86,18 +95,21 @@ required_ruby_version: !ruby/object:Gem::Requirement
86
95
  requirements:
87
96
  - - ">="
88
97
  - !ruby/object:Gem::Version
98
+ segments:
99
+ - 0
89
100
  version: "0"
90
- version:
91
101
  required_rubygems_version: !ruby/object:Gem::Requirement
92
102
  requirements:
93
103
  - - ">="
94
104
  - !ruby/object:Gem::Version
105
+ segments:
106
+ - 1
107
+ - 2
95
108
  version: "1.2"
96
- version:
97
109
  requirements: []
98
110
 
99
111
  rubyforge_project:
100
- rubygems_version: 1.3.5
112
+ rubygems_version: 1.3.6
101
113
  signing_key:
102
114
  specification_version: 3
103
115
  summary: A simple Ruby on Rails plugin for creating and managing a breadcrumb navigation.
data/install.rb DELETED
@@ -1 +0,0 @@
1
- # Install hook code here
@@ -1,4 +0,0 @@
1
- # desc "Explaining what the task does"
2
- # task :breadcrumbs_on_rails do
3
- # # Task goes here
4
- # end
data/uninstall.rb DELETED
@@ -1 +0,0 @@
1
- # Uninstall hook code here