Class: Alchemy::Page
- Inherits:
-
BaseRecord
- Object
- ActiveRecord::Base
- BaseRecord
- Alchemy::Page
- Includes:
- Hints, Logger, PageElements, PageNaming, PageNatures, PageScopes, Taggable
- Defined in:
- app/models/alchemy/page.rb,
app/models/alchemy/page/url_path.rb
Defined Under Namespace
Modules: PageElements, PageNaming, PageNatures, PageScopes Classes: FixedAttributes, UrlPath
Constant Summary collapse
- DEFAULT_ATTRIBUTES_FOR_COPY =
{ autogenerate_elements: false, public_on: nil, public_until: nil, locked_at: nil, locked_by: nil, }
- SKIPPED_ATTRIBUTES_ON_COPY =
%w( id updated_at created_at creator_id updater_id lft rgt depth urlname cached_tag_list )
- PERMITTED_ATTRIBUTES =
[ :meta_description, :meta_keywords, :name, :page_layout, :public_on, :public_until, :restricted, :robot_index, :robot_follow, :sitemap, :tag_list, :title, :urlname, :layoutpage, :menu_id, ]
Constants included from PageNaming
Class Method Summary collapse
- .alchemy_resource_filters ⇒ Object
- .all_from_clipboard(clipboard) ⇒ Object
- .all_from_clipboard_for_select(clipboard, language_id, layoutpage = false) ⇒ Object
-
.copy(source, differences = {}) ⇒ Alchemy::Page
Creates a copy of given source.
- .copy_and_paste(source, new_parent, new_name) ⇒ Object
-
.current_preview ⇒ Object
Returns the current page previewed in the edit page template.
-
.current_preview=(page) ⇒ Object
Used to store the current page previewed in the edit page template.
-
.language_root_for(language_id) ⇒ Object
The language root page for given language id.
- .link_target_options ⇒ Object
- .searchable_alchemy_resource_attributes ⇒ Object
-
.url_path_class ⇒ Object
The url_path class.
-
.url_path_class=(klass) ⇒ Object
Set a custom url path class.
Instance Method Summary collapse
-
#attribute_fixed?(name) ⇒ Boolean
True if given attribute name is defined as fixed.
- #copy_children_to(new_parent) ⇒ Object
-
#creator_name ⇒ Object
Returns the name of the creator of this page.
-
#editable_by?(user) ⇒ Boolean
Checks the current page’s list of editors, if defined.
-
#find_elements(options = {}) ⇒ ActiveRecord::Relation
Returns elements from page.
-
#first_public_child ⇒ Object
Returns the first published child.
-
#fixed_attributes ⇒ Object
Holds an instance of
FixedAttributes
. - #fold!(user_id, status) ⇒ Object
-
#get_language_root ⇒ Object
Gets the language_root page for page.
- #inherit_restricted_status ⇒ Object
-
#lock_to!(user) ⇒ Object
Locks the page to given user.
-
#locker_name ⇒ Object
Returns the name of the user currently editing this page.
-
#menus ⇒ Object
Menus (aka. root nodes) this page is attached to.
-
#next(options = {}) ⇒ Object
(also: #next_page)
Returns the next page on the same level or nil.
-
#previous(options = {}) ⇒ Object
(also: #previous_page)
Returns the previous page on the same level or nil.
-
#public_on ⇒ Object
Returns the value of
public_on
attribute. -
#public_until ⇒ Object
Returns the value of
public_until
attribute. -
#publish! ⇒ Object
Publishes the page.
- #set_restrictions_to_child_pages ⇒ Object
-
#to_partial_path ⇒ Object
The page’s view partial is dependent from its page layout.
-
#unlock! ⇒ Object
Unlocks the page without updating the timestamps.
-
#update_node!(node) ⇒ Object
Updates an Alchemy::Page based on a new ordering to be applied to it.
-
#updater_name ⇒ Object
Returns the name of the last updater of this page.
-
#url_path ⇒ Object
The url_path for this page.
Methods included from PageElements
#available_element_definitions, #available_element_names, #available_elements_within_current_scope, #descendent_element_definitions, #element_definition_names, #element_definitions, #element_definitions_by_name, #feed_elements, #richtext_contents_ids
Methods included from PageNaming
#renamed?, #slug, #update_urlname!
Methods included from NameConversions
#convert_to_humanized_name, #convert_to_urlname
Methods included from PageNatures
#cache_key, #cache_page?, #contains_feed?, #definition, #editor_roles, #expiration_time, #folded?, #has_limited_editors?, #layout_display_name, #layout_partial_name, #locked?, #public?, #published_at, #rootpage?, #status, #status_title, #taggable?
Methods included from Taggable
Methods included from Logger
Methods included from Hints
Class Method Details
.alchemy_resource_filters ⇒ Object
167 168 169 |
# File 'app/models/alchemy/page.rb', line 167 def alchemy_resource_filters %w[published not_public restricted] end |
.all_from_clipboard(clipboard) ⇒ Object
231 232 233 234 235 |
# File 'app/models/alchemy/page.rb', line 231 def all_from_clipboard(clipboard) return [] if clipboard.blank? where(id: clipboard.collect { |p| p["id"] }) end |
.all_from_clipboard_for_select(clipboard, language_id, layoutpage = false) ⇒ Object
237 238 239 240 241 242 243 244 |
# File 'app/models/alchemy/page.rb', line 237 def all_from_clipboard_for_select(clipboard, language_id, layoutpage = false) return [] if clipboard.blank? clipboard_pages = all_from_clipboard(clipboard) allowed_page_layouts = Alchemy::PageLayout.selectable_layouts(language_id, layoutpage) allowed_page_layout_names = allowed_page_layouts.collect { |p| p["name"] } clipboard_pages.select { |cp| allowed_page_layout_names.include?(cp.page_layout) } end |
.copy(source, differences = {}) ⇒ Alchemy::Page
Creates a copy of given source.
Also copies all elements included in source.
Note:
It prevents the element auto generator from running.
209 210 211 212 213 214 215 216 |
# File 'app/models/alchemy/page.rb', line 209 def copy(source, differences = {}) page = Alchemy::Page.new(attributes_from_source_for_copy(source, differences)) page.tag_list = source.tag_list if page.save! copy_elements(source, page) page end end |
.copy_and_paste(source, new_parent, new_name) ⇒ Object
218 219 220 221 222 223 224 225 226 227 228 229 |
# File 'app/models/alchemy/page.rb', line 218 def copy_and_paste(source, new_parent, new_name) page = copy(source, { parent_id: new_parent.id, language: new_parent.language, name: new_name, title: new_name, }) if source.children.any? source.copy_children_to(page) end page end |
.current_preview ⇒ Object
Returns the current page previewed in the edit page template.
183 184 185 |
# File 'app/models/alchemy/page.rb', line 183 def current_preview RequestStore.store[:alchemy_current_preview] end |
.current_preview=(page) ⇒ Object
Used to store the current page previewed in the edit page template.
177 178 179 |
# File 'app/models/alchemy/page.rb', line 177 def current_preview=(page) RequestStore.store[:alchemy_current_preview] = page end |
.language_root_for(language_id) ⇒ Object
Returns the language root page for given language id.
190 191 192 |
# File 'app/models/alchemy/page.rb', line 190 def language_root_for(language_id) language_roots.find_by_language_id(language_id) end |
.link_target_options ⇒ Object
246 247 248 249 250 251 252 253 254 |
# File 'app/models/alchemy/page.rb', line 246 def = [[Alchemy.t(:default, scope: "link_target_options"), ""]] = Config.get(:link_target_options) .each do |option| << [Alchemy.t(option, scope: "link_target_options", default: option.to_s.humanize), option] end end |
.searchable_alchemy_resource_attributes ⇒ Object
171 172 173 |
# File 'app/models/alchemy/page.rb', line 171 def searchable_alchemy_resource_attributes %w[name urlname title] end |
.url_path_class ⇒ Object
The url_path class
154 155 156 |
# File 'app/models/alchemy/page.rb', line 154 def url_path_class @_url_path_class ||= Alchemy::Page::UrlPath end |
.url_path_class=(klass) ⇒ Object
Set a custom url path class
# config/initializers/alchemy.rb
Alchemy::Page.url_path_class = MyPageUrlPathClass
163 164 165 |
# File 'app/models/alchemy/page.rb', line 163 def url_path_class=(klass) @_url_path_class = klass end |
Instance Method Details
#attribute_fixed?(name) ⇒ Boolean
True if given attribute name is defined as fixed
467 468 469 |
# File 'app/models/alchemy/page.rb', line 467 def attribute_fixed?(name) fixed_attributes.fixed?(name) end |
#copy_children_to(new_parent) ⇒ Object
413 414 415 416 417 418 419 420 421 422 423 424 |
# File 'app/models/alchemy/page.rb', line 413 def copy_children_to(new_parent) children.each do |child| next if child == new_parent new_child = Page.copy(child, { language_id: new_parent.language_id, language_code: new_parent.language_code, }) new_child.move_to_child_of(new_parent) child.copy_children_to(new_child) unless child.children.blank? end end |
#creator_name ⇒ Object
Returns the name of the creator of this page.
If no creator could be found or associated user model does not respond to #name
it returns ‘unknown’
503 504 505 |
# File 'app/models/alchemy/page.rb', line 503 def creator_name creator.try(:name) || Alchemy.t("unknown") end |
#editable_by?(user) ⇒ Boolean
Checks the current page’s list of editors, if defined.
This allows us to pass in a user and see if any of their roles are enable them to make edits
476 477 478 479 480 |
# File 'app/models/alchemy/page.rb', line 476 def editable_by?(user) return true unless has_limited_editors? (editor_roles & user.alchemy_roles).any? end |
#find_elements(options = {}) ⇒ ActiveRecord::Relation
Returns elements from page.
315 316 317 318 |
# File 'app/models/alchemy/page.rb', line 315 def find_elements( = {}) finder = [:finder] || Alchemy::ElementsFinder.new() finder.elements(page: self) end |
#first_public_child ⇒ Object
Returns the first published child
404 405 406 |
# File 'app/models/alchemy/page.rb', line 404 def first_public_child children.published.first end |
#fixed_attributes ⇒ Object
Holds an instance of FixedAttributes
462 463 464 |
# File 'app/models/alchemy/page.rb', line 462 def fixed_attributes @_fixed_attributes ||= Alchemy::Page::FixedAttributes.new(self) end |
#fold!(user_id, status) ⇒ Object
387 388 389 390 391 |
# File 'app/models/alchemy/page.rb', line 387 def fold!(user_id, status) folded_page = folded_pages.find_or_create_by(user_id: user_id) folded_page.folded = status folded_page.save! end |
#get_language_root ⇒ Object
Gets the language_root page for page
409 410 411 |
# File 'app/models/alchemy/page.rb', line 409 def get_language_root self_and_ancestors.find_by(language_root: true) end |
#inherit_restricted_status ⇒ Object
399 400 401 |
# File 'app/models/alchemy/page.rb', line 399 def inherit_restricted_status self.restricted = parent.restricted? end |
#lock_to!(user) ⇒ Object
Locks the page to given user
375 376 377 |
# File 'app/models/alchemy/page.rb', line 375 def lock_to!(user) update_columns(locked_at: Time.current, locked_by: user.id) end |
#locker_name ⇒ Object
Returns the name of the user currently editing this page.
If no locker could be found or associated user model does not respond to #name
it returns ‘unknown’
521 522 523 |
# File 'app/models/alchemy/page.rb', line 521 def locker_name locker.try(:name) || Alchemy.t("unknown") end |
#menus ⇒ Object
Menus (aka. root nodes) this page is attached to
527 528 529 |
# File 'app/models/alchemy/page.rb', line 527 def @_menus ||= nodes.map(&:root) end |
#next(options = {}) ⇒ Object Also known as: next_page
Returns the next page on the same level or nil.
366 367 368 369 |
# File 'app/models/alchemy/page.rb', line 366 def next( = {}) pages = self_and_siblings.where("lft > ?", lft) select_page(pages, .merge(order: :asc)) end |
#previous(options = {}) ⇒ Object Also known as: previous_page
Returns the previous page on the same level or nil.
352 353 354 355 |
# File 'app/models/alchemy/page.rb', line 352 def previous( = {}) pages = self_and_siblings.where("lft < ?", lft) select_page(pages, .merge(order: :desc)) end |
#public_on ⇒ Object
Returns the value of public_on
attribute
If it’s a fixed attribute then the fixed value is returned instead
486 487 488 |
# File 'app/models/alchemy/page.rb', line 486 def public_on attribute_fixed?(:public_on) ? fixed_attributes[:public_on] : self[:public_on] end |
#public_until ⇒ Object
Returns the value of public_until
attribute
If it’s a fixed attribute then the fixed value is returned instead
494 495 496 |
# File 'app/models/alchemy/page.rb', line 494 def public_until attribute_fixed?(:public_until) ? fixed_attributes[:public_until] : self[:public_until] end |
#publish! ⇒ Object
Publishes the page.
Sets public_on
and the published_at
value to current time and resets public_until
to nil
The published_at
attribute is used as cache_key
.
433 434 435 436 437 438 439 440 |
# File 'app/models/alchemy/page.rb', line 433 def publish! current_time = Time.current update_columns( published_at: current_time, public_on: already_public_for?(current_time) ? public_on : current_time, public_until: still_public_for?(current_time) ? public_until : nil, ) end |
#set_restrictions_to_child_pages ⇒ Object
393 394 395 396 397 |
# File 'app/models/alchemy/page.rb', line 393 def set_restrictions_to_child_pages descendants.each do |child| child.update(restricted: restricted?) end end |
#to_partial_path ⇒ Object
The page’s view partial is dependent from its page layout
Define page layouts
Page layouts are defined in the config/alchemy/page_layouts.yml
file
- name: contact
elements: [contactform]
...
Override the view
Page layout partials live in app/views/alchemy/page_layouts
341 342 343 |
# File 'app/models/alchemy/page.rb', line 341 def to_partial_path "alchemy/page_layouts/#{layout_partial_name}" end |
#unlock! ⇒ Object
Unlocks the page without updating the timestamps
381 382 383 384 385 |
# File 'app/models/alchemy/page.rb', line 381 def unlock! if update_columns(locked_at: nil, locked_by: nil) Page.current_preview = nil end end |
#update_node!(node) ⇒ Object
Updates an Alchemy::Page based on a new ordering to be applied to it
Note: Page’s urls should not be updated (and a legacy URL created) if nesting is OFF or if the URL is the same
450 451 452 453 454 455 456 457 458 459 |
# File 'app/models/alchemy/page.rb', line 450 def update_node!(node) hash = { lft: node.left, rgt: node.right, parent_id: node.parent, depth: node.depth, restricted: node.restricted } if urlname != node.url LegacyPageUrl.create(page_id: id, urlname: urlname) hash[:urlname] = node.url end update_columns(hash) end |
#updater_name ⇒ Object
Returns the name of the last updater of this page.
If no updater could be found or associated user model does not respond to #name
it returns ‘unknown’
512 513 514 |
# File 'app/models/alchemy/page.rb', line 512 def updater_name updater.try(:name) || Alchemy.t("unknown") end |
#url_path ⇒ Object
The url_path for this page
323 324 325 |
# File 'app/models/alchemy/page.rb', line 323 def url_path self.class.url_path_class.new(self).call end |