Module: Blacklight::UrlHelperBehavior

Included in:
BlacklightHelperBehavior
Defined in:
app/helpers/blacklight/url_helper_behavior.rb

Overview

URL helper methods

Instance Method Summary collapse

Instance Method Details

#controller_tracking_methodObject



71
72
73
74
75
# File 'app/helpers/blacklight/url_helper_behavior.rb', line 71

def controller_tracking_method
  return blacklight_config.track_search_session.url_helper if blacklight_config.track_search_session.url_helper

  "track_#{controller_name}_path"
end

Create a link back to the index screen, keeping the user’s facet, query and paging choices intact by using session.

Examples:

link_back_to_catalog(label: 'Back to Search')
link_back_to_catalog(label: 'Back to Search', route_set: my_engine)


85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
# File 'app/helpers/blacklight/url_helper_behavior.rb', line 85

def link_back_to_catalog(opts = { label: nil })
  scope = opts.delete(:route_set) || self
  query_params = search_state.reset(current_search_session.try(:query_params)).to_hash

  if search_session['counter']
    per_page = (search_session['per_page'] || blacklight_config.default_per_page).to_i
    counter = search_session['counter'].to_i

    query_params[:per_page] = per_page unless search_session['per_page'].to_i == blacklight_config.default_per_page
    query_params[:page] = ((counter - 1) / per_page) + 1
  end

  link_url = if query_params.empty?
               search_action_path(only_path: true)
             else
               scope.url_for(query_params)
             end
  label = opts.delete(:label)

  if link_url =~ /bookmarks/
    label ||= t('blacklight.back_to_bookmarks')
  end

  label ||= t('blacklight.back_to_search')

  link_to label, link_url, opts
end

Uses the catalog_path route to create a link to the show page for an item. catalog_path accepts a hash. The solr query params are stored in the session, so we only need the counter param here. We also need to know if we are viewing to document as part of search results. TODO: move this to the IndexPresenter

Examples:

Passing in an image

link_to_document(doc, '<img src="thumbnail.png">', counter: 3) #=> "<a href=\"catalog/123\" data-context-href=\"/catalog/123/track?counter=3&search_id=999\"><img src="thumbnail.png"></a>

With the default document link field

link_to_document(doc, counter: 3) #=> "<a href=\"catalog/123\" data-context-href=\"/catalog/123/track?counter=3&search_id=999\">My Title</a>

Parameters:

  • doc (SolrDocument)

    the document

  • field_or_opts (Hash, String) (defaults to: nil)

    either a string to render as the link text or options

  • opts (Hash) (defaults to: { counter: nil })

    the options to create the link with

Options Hash (opts):

  • :counter (Number) — default: nil

    the count to set in the session (for paging through a query result)



18
19
20
21
22
23
24
25
26
27
28
29
30
# File 'app/helpers/blacklight/url_helper_behavior.rb', line 18

def link_to_document(doc, field_or_opts = nil, opts = { counter: nil })
  label = case field_or_opts
          when NilClass
            document_presenter(doc).heading
          when Hash
            opts = field_or_opts
            document_presenter(doc).heading
          else # String
            field_or_opts
          end

  link_to label, search_state.url_for_document(doc), document_link_params(doc, opts)
end

Use in e.g. the search history display, where we want something more like text instead of the normal constraints



114
115
116
117
# File 'app/helpers/blacklight/url_helper_behavior.rb', line 114

def link_to_previous_search(params)
  search_state = controller.search_state_class.new(params, blacklight_config, self)
  link_to(render(Blacklight::ConstraintsComponent.for_search_history(search_state: search_state)), search_action_path(params))
end

#session_tracking_params(document, counter, per_page: search_session['per_page'], search_id: current_search_session&.id) ⇒ Object

Attributes for a link that gives a URL we can use to track clicks for the current search session

Examples:

session_tracking_params(SolrDocument.new(id: 123), 7)
=> { data: { context_href: '/catalog/123/track?counter=7&search_id=999' } }

Parameters:



45
46
47
48
49
50
51
52
53
54
55
56
# File 'app/helpers/blacklight/url_helper_behavior.rb', line 45

def session_tracking_params document, counter, per_page: search_session['per_page'], search_id: current_search_session&.id
  path_params = { per_page: params.fetch(:per_page, per_page), counter: counter, search_id: search_id }
  if blacklight_config.track_search_session.storage == 'server'
    path_params[:document_id] = document&.id
    path_params[:search_id] = search_id
  end
  path = session_tracking_path(document, path_params)
  return {} if path.nil?

  context_method = blacklight_config.track_search_session.storage == 'client' ? 'get' : 'post'
  { data: { context_href: path, context_method: context_method } }
end

#session_tracking_path(document, params = {}) ⇒ Object

Get the URL for tracking search sessions across pages using polymorphic routing



60
61
62
63
64
65
66
67
68
69
# File 'app/helpers/blacklight/url_helper_behavior.rb', line 60

def session_tracking_path document, params = {}
  return if document.nil? || !blacklight_config.track_search_session.storage

  if main_app.respond_to?(controller_tracking_method)
    return main_app.public_send(controller_tracking_method, params.merge(id: document))
  end

  raise "Unable to find #{controller_tracking_method} route helper. " \
        "Did you add `concerns :searchable` routing mixin to your `config/routes.rb`?"
end