Class: Www::CatalogController

Inherits:
BasePortalController show all
Includes:
Controllers::Paginateable, Controllers::ReviewsIoSkuOptimizer, Controllers::TrackingDetection
Defined in:
app/controllers/www/catalog_controller.rb

Overview

Unified controller for hierarchical catalog URLs.

Handles all product/support/review/FAQ pages under category-rooted paths:
/floor-heating/tempzone/flex-roll -> product line page
/floor-heating/tempzone/flex-roll/TZ-123 -> product page
/floor-heating/tempzone/flex-roll/TZ-123/support -> support page
/floor-heating/tempzone/flex-roll/TZ-123/reviews -> reviews page
/floor-heating/tempzone/flex-roll/TZ-123/faqs -> FAQs page

CMS templates living under a catalog-root slug (e.g.
app/views/pages/floor-heating/heated-floor-mat.html.erb) are NOT served
from here — they're routed directly to PagesController by explicit routes
built from PagesController.catalog_rooted_page_ids ahead of this
controller's :root/*path wildcard. A cms_fallback result here is always
a 404 (no catalog entity, no CMS template).

Constant Summary

Constants included from Controllers::MasqueradeGuarded

Controllers::MasqueradeGuarded::DEFAULT_BLOCK_MESSAGE

Constants included from Controllers::AnalyticsEvents

Controllers::AnalyticsEvents::MAX_QUEUED_EVENTS, Controllers::AnalyticsEvents::SESSION_KEY

Constants included from Controllers::ErrorRendering

Controllers::ErrorRendering::NON_CONTENT_PATH_PREFIXES

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Controllers::TrackingDetection

#bot_request?, #gdpr_country?, #gdpr_country_data, #prevent_bots, #set_tracking_cookie, #track_visitor?

Methods inherited from BasePortalController

#current_ability, #portal_party, #set_webpack

Methods included from Controllers::MasqueradeGuarded

block_while_masquerading, #masquerade_blocks?

Methods inherited from ApplicationController

#account_impersonated?, #add_to_flash, #after_sign_in_path_for, #bypass_forgery_protection?, #chat_enabled?, #cloudflare_cleared?, #default_catalog, #default_url_options, #enable_turbo_frames, #find_publication, #fix_invalid_accept_header, #init_js_utils, #is_globals_call?, #layout_by_resource, #locale_store, #redirect_to, #require_employee_for_crm, #set_base_host, #set_real_ip, #set_report_errors_for, #should_render_layout?, #skip_layout_for_turbo_frame?, #stamp_impersonation_context, #tab_frame_breakout_request?, #warmlyyours_canada_ip?, #warmlyyours_ip?, #y

Methods included from Controllers::ReturnPathHandling

#check_for_return_path, #redirect_to_return_path_or_default

Methods included from Controllers::AnalyticsEvents

#consume_queued_analytics_events, #registration_lead_type, #track_event

Methods included from Controllers::DeviceDetection

#device_detector, #is_ie?

Methods included from Controllers::SubdomainDetection

#is_crm_request?, #is_www_request?, #json_request?

Methods included from Controllers::TurboSafeRedirect

#redirect_to

Methods included from Controllers::AcceleratedFileSending

#send_file_accelerated, #send_upload_accelerated

Methods included from Controllers::ErrorRendering

#excp_string, #mail_to_for_error_reporting, #render_400, #render_404, #render_406, #render_410, #render_500, #render_invalid_authenticity_token, #render_ip_spoof_error, #render_unpermitted_parameters, #safe_referer_or_fallback

Methods included from Controllers::TurnstileVerification

#load_turnstile_script_tag, #turnstile_lazy_widget, #turnstile_script_tag, #turnstile_widget, #validate_turnstile!

Methods included from Controllers::CloudflareCaching

edge_cached, #edge_cached_action?, #reset_cloudflare_cache, #set_cloudflare_cache, #skip_edge_cache!, #skip_session

Methods included from Controllers::Webpackable

#preload_webpack_fonts, #webpack_css_include, #webpack_css_url, #webpack_js_include, #wpd_is_running?

Methods included from Controllers::Localizable

#cloudflare_country_locale, #determine_request_locale, #geocoder_locale, #guest_user_locale_check, #locale_optional_www_auth_path?, #param_locale, #set_locale, #set_request_locale, #skip_localization?, #warmlyyours_ip_locale

Methods included from Controllers::Authenticable

#access_denied, #authenticate_account, #authenticate_account!, #authenticate_account_from_login_token!, #check_is_a_manager, #check_is_a_sales_manager, #check_is_an_admin, #check_is_an_employee, #check_party, #clear_mismatched_guest_user, #create_guest_user, #credentials?, #current_or_guest_user, #current_or_guest_user_id_read_only, #current_user, #devise_mapping, #fully_logged_in?, #generate_bot_id, #guest_user, #identifiable?, #init_current_user, #initialize_guest, #load_context_user, #logging_in, #resource, #resource_name, #restrict_access_for_non_employees, #scrubbed_request_path, #user_object, #warn_on_session_guest_id_leak

Methods included from UrlsHelper

#catalog_breadcrumb_links, #catalog_link_for_product_line, #catalog_link_for_sku, #cms_link, #delocalized_path, #path_to_sales_product_sku, #path_to_sales_product_sku_for_product_line, #path_to_sales_product_sku_for_product_line_slug, #product_line_from_catalog_link, #protocol_neutral_url, #sanitize_external_url, #valid_external_url?

Class Method Details

.local_prefixesArray<String>

View lookup prefixes: this controller renders product/support views that
live under www/products and www/support_portals, not just its own path.

Returns:

  • (Array<String>)

    view lookup prefixes



28
29
30
# File 'app/controllers/www/catalog_controller.rb', line 28

def self.local_prefixes
  [controller_path, "www/products", "www/support_portals"]
end

Instance Method Details

#resolvevoid

This method returns an undefined value.

Resolves the wildcard catalog path to a product, product line, support,
review, or FAQ page (or a redirect/404).



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
# File 'app/controllers/www/catalog_controller.rb', line 40

def resolve
  root_slug = params[:root]
  path_segments = params[:path]&.split('/') || []

  resolver = CatalogPathResolver.new
  @result = resolver.resolve(root_slug: root_slug, path_segments: path_segments)

  return redirect_to @result.redirect_to, status: :moved_permanently if @result.redirect?

  # Catalog-rooted CMS templates are routed directly to PagesController via
  # explicit routes built from PagesController.catalog_rooted_page_ids — see
  # config/routes/www.rb. So a cms_fallback result here means: path matched
  # the catalog wildcard, no catalog entity, and no CMS template existed at
  # boot. Always a 404. Use render_404 so the 404 page's search box is
  # populated from the URL path (see Controllers::ErrorRendering#render_404).
  return render_404 if @result.cms_fallback?

  return redirect_or_frame_break(cms_link('/products'), notice: @result.error_message) if @result.error?

  if @result.item?
    dispatch_item_page
  elsif @result.product_line?
    dispatch_product_line_page
  else
    redirect_or_frame_break cms_link('/products'), notice: 'Page not found.'
  end
end