Module: ActsAsTaggableOn::Taggable::Core
- Defined in:
- lib/acts_as_taggable_on/taggable/core.rb
Defined Under Namespace
Modules: ClassMethods
Class Method Summary collapse
Instance Method Summary collapse
- #add_custom_context(value) ⇒ Object
- #all_tags_list_on(context) ⇒ Object
-
#all_tags_on(context) ⇒ Object
Returns all tags of a given context.
- #cached_tag_list_on(context) ⇒ Object
- #custom_contexts ⇒ Object
-
#grouped_column_names_for(object) ⇒ Object
all column names are necessary for PostgreSQL group clause.
- #is_taggable? ⇒ Boolean
-
#load_tags(tag_list) ⇒ Object
Find existing tags or create non-existing tags.
- #reload(*args) ⇒ Object
- #save_tags ⇒ Object
- #set_tag_list_on(context, new_list) ⇒ Object
- #tag_list_cache_on(context) ⇒ Object
- #tag_list_cache_set_on(context) ⇒ Object
- #tag_list_on(context) ⇒ Object
- #tagging_contexts ⇒ Object
-
#tags_on(context) ⇒ Object
Returns all tags that are not owned of a given context.
Class Method Details
.included(base) ⇒ Object
6 7 8 9 10 11 12 13 14 15 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 6 def self.included(base) base.extend ActsAsTaggableOn::Taggable::Core::ClassMethods base.class_eval do attr_writer :custom_contexts after_save :save_tags end base.initialize_acts_as_taggable_on_core end |
Instance Method Details
#add_custom_context(value) ⇒ Object
135 136 137 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 135 def add_custom_context(value) custom_contexts << value.to_s unless custom_contexts.include?(value.to_s) or self.class.tag_types.map(&:to_s).include?(value.to_s) end |
#all_tags_list_on(context) ⇒ Object
164 165 166 167 168 169 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 164 def (context) variable_name = "@all_#{context.to_s.singularize}_list" return instance_variable_get(variable_name) if instance_variable_defined?(variable_name) && instance_variable_get(variable_name) instance_variable_set(variable_name, ActsAsTaggableOn::TagList.new((context).map(&:name)).freeze) end |
#all_tags_on(context) ⇒ Object
Returns all tags of a given context
173 174 175 176 177 178 179 180 181 182 183 184 185 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 173 def (context) tagging_table_name = ActsAsTaggableOn::Tagging.table_name opts = ["#{tagging_table_name}.context = ?", context.to_s] scope = .where(opts) if ActsAsTaggableOn::Utils.using_postgresql? group_columns = grouped_column_names_for(ActsAsTaggableOn::Tag) scope.order(Arel.sql("max(#{tagging_table_name}.created_at)")).group(group_columns) else scope.group("#{ActsAsTaggableOn::Tag.table_name}.#{ActsAsTaggableOn::Tag.primary_key}") end.to_a end |
#cached_tag_list_on(context) ⇒ Object
139 140 141 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 139 def cached_tag_list_on(context) self["cached_#{context.to_s.singularize}_list"] end |
#custom_contexts ⇒ Object
127 128 129 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 127 def custom_contexts @custom_contexts ||= taggings.map(&:context).uniq end |
#grouped_column_names_for(object) ⇒ Object
all column names are necessary for PostgreSQL group clause
123 124 125 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 123 def grouped_column_names_for(object) self.class.grouped_column_names_for(object) end |
#is_taggable? ⇒ Boolean
131 132 133 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 131 def is_taggable? self.class.is_taggable? end |
#load_tags(tag_list) ⇒ Object
Find existing tags or create non-existing tags
222 223 224 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 222 def (tag_list) ActsAsTaggableOn::Tag.find_or_create_all_with_like_by_name(tag_list) end |
#reload(*args) ⇒ Object
211 212 213 214 215 216 217 218 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 211 def reload(*args) self.class.tag_types.each do |context| instance_variable_set("@#{context.to_s.singularize}_list", nil) instance_variable_set("@all_#{context.to_s.singularize}_list", nil) end super(*args) end |
#save_tags ⇒ Object
226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 226 def tagging_contexts.each do |context| next unless tag_list_cache_set_on(context) # List of currently assigned tag names tag_list = tag_list_cache_on(context).uniq # Find existing tags or create non-existing tags: = (tag_list, context) # Tag objects for currently assigned tags = (context) # Tag maintenance based on whether preserving the created order of tags if self.class.preserve_tag_order? , = - , - = & if .any? && [0....size] != index = .each_with_index { |_, i| break i unless [i] == [i] } # Update arrays of tag objects |= [index....size] |= [index....size] & # Order the array of tag objects to match the tag list = .map do |t| .find { |n| n.name.downcase == t.name.downcase } end.compact end else # Delete discarded tags and create new tags = - = - end # Destroy old taggings: if .present? taggings.not_owned.by_context(context).where(tag_id: ).destroy_all end # Create new taggings: .each do |tag| taggings.create!(tag_id: tag.id, context: context.to_s, taggable: self) end end true end |
#set_tag_list_on(context, new_list) ⇒ Object
197 198 199 200 201 202 203 204 205 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 197 def set_tag_list_on(context, new_list) add_custom_context(context) variable_name = "@#{context.to_s.singularize}_list" parsed_new_list = ActsAsTaggableOn.default_parser.new(new_list).parse instance_variable_set(variable_name, parsed_new_list) end |
#tag_list_cache_on(context) ⇒ Object
148 149 150 151 152 153 154 155 156 157 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 148 def tag_list_cache_on(context) variable_name = "@#{context.to_s.singularize}_list" if instance_variable_get(variable_name) instance_variable_get(variable_name) elsif cached_tag_list_on(context) && ensure_included_cache_methods! && self.class.caching_tag_list_on?(context) instance_variable_set(variable_name, ActsAsTaggableOn.default_parser.new(cached_tag_list_on(context)).parse) else instance_variable_set(variable_name, ActsAsTaggableOn::TagList.new((context).map(&:name))) end end |
#tag_list_cache_set_on(context) ⇒ Object
143 144 145 146 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 143 def tag_list_cache_set_on(context) variable_name = "@#{context.to_s.singularize}_list" instance_variable_defined?(variable_name) && instance_variable_get(variable_name) end |
#tag_list_on(context) ⇒ Object
159 160 161 162 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 159 def tag_list_on(context) add_custom_context(context) tag_list_cache_on(context) end |
#tagging_contexts ⇒ Object
207 208 209 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 207 def tagging_contexts self.class.tag_types.map(&:to_s) + custom_contexts end |
#tags_on(context) ⇒ Object
Returns all tags that are not owned of a given context
189 190 191 192 193 194 195 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 189 def (context) scope = .where(["#{ActsAsTaggableOn::Tagging.table_name}.context = ? AND #{ActsAsTaggableOn::Tagging.table_name}.tagger_id IS NULL", context.to_s]) # when preserving tag order, return tags in created order # if we added the order to the association this would always apply scope = scope.order("#{ActsAsTaggableOn::Tagging.table_name}.id") if self.class.preserve_tag_order? scope end |