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
7 8 9 10 11 12 13 14 15 16 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 7 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
139 140 141 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 139 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
168 169 170 171 172 173 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 168 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
177 178 179 180 181 182 183 184 185 186 187 188 189 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 177 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
143 144 145 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 143 def cached_tag_list_on(context) self["cached_#{context.to_s.singularize}_list"] end |
#custom_contexts ⇒ Object
131 132 133 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 131 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
127 128 129 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 127 def grouped_column_names_for(object) self.class.grouped_column_names_for(object) end |
#is_taggable? ⇒ Boolean
135 136 137 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 135 def is_taggable? self.class.is_taggable? end |
#load_tags(tag_list) ⇒ Object
Find existing tags or create non-existing tags
226 227 228 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 226 def (tag_list) ActsAsTaggableOn::Tag.find_or_create_all_with_like_by_name(tag_list) end |
#reload(*args) ⇒ Object
215 216 217 218 219 220 221 222 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 215 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
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 275 276 277 278 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 230 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
201 202 203 204 205 206 207 208 209 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 201 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
152 153 154 155 156 157 158 159 160 161 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 152 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
147 148 149 150 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 147 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
163 164 165 166 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 163 def tag_list_on(context) add_custom_context(context) tag_list_cache_on(context) end |
#tagging_contexts ⇒ Object
211 212 213 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 211 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
193 194 195 196 197 198 199 |
# File 'lib/acts_as_taggable_on/taggable/core.rb', line 193 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 |