Module: GeoblacklightHelper

Defined in:
app/helpers/geoblacklight_helper.rb

Instance Method Summary collapse

Instance Method Details

Deprecated.

Use #carto_link instead.

Creates a Carto OneClick link link, using the configuration link

Parameters:

  • file_link (String)

Returns:

  • (String) 


172
173
174
 
# File 'app/helpers/geoblacklight_helper.rb', line 172

def cartodb_link(file_link)
  carto_link(file_link)
end

#document_available? ⇒ Boolean

Returns:

  • (Boolean) 


2
3
4
 
# File 'app/helpers/geoblacklight_helper.rb', line 2

def document_available?
  @document.public? || (@document.same_institution? && user_signed_in?)
end

#document_downloadable? ⇒ Boolean

Returns:

  • (Boolean) 


6
7
8
 
# File 'app/helpers/geoblacklight_helper.rb', line 6

def document_downloadable?
  document_available? && @document.downloadable?
end

#download_generated_body(format) ⇒ Object 



126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'app/helpers/geoblacklight_helper.rb', line 126

def download_generated_body(format)
  value = proper_case_format(format)
  value = case value
          when t('geoblacklight.formats.shapefile')
            t('geoblacklight.download.export_shapefile_link')
          when t('geoblacklight.formats.kmz')
            t('geoblacklight.download.export_kmz_link')
          when t('geoblacklight.formats.geojson')
            t('geoblacklight.download.export_geojson_link')
          else
            value
          end

  value.html_safe
end

#download_link_direct(text, document) ⇒ Object 



14
15
16
17
18
19
20
21
22
23
24
25
26
 
# File 'app/helpers/geoblacklight_helper.rb', line 14

def download_link_direct(text, document)
  link_to(
    text,
    document.direct_download[:download],
    'contentUrl' => document.direct_download[:download],
    class: ['btn', 'btn-default', 'download', 'download-original'],
    data: {
      download: 'trigger',
      download_type: 'direct',
      download_id: document.id
    }
  )
end

#download_link_generated(download_type, document) ⇒ Object 



56
57
58
59
60
61
62
63
64
65
66
67
68
 
# File 'app/helpers/geoblacklight_helper.rb', line 56

def download_link_generated(download_type, document)
  link_to(
    t('geoblacklight.download.export_link', download_format: proper_case_format(download_type)),
    '',
    class: ['btn', 'btn-default', 'download', 'download-generated'],
    data: {
      download_path: download_path(document.id, type: download_type),
      download: 'trigger',
      download_type: download_type,
      download_id: document.id
    }
  )
end

#download_link_hgl(text, document) ⇒ Object 



28
29
30
31
32
33
34
35
36
37
38
39
40
 
# File 'app/helpers/geoblacklight_helper.rb', line 28

def download_link_hgl(text, document)
  link_to(
    text,
    download_hgl_path(id: document),
    class: ['btn', 'btn-default', 'download', 'download-original'],
    data: {
      blacklight_modal: 'trigger',
      download: 'trigger',
      download_type: 'harvard-hgl',
      download_id: document.id
    }
  )
end

#download_link_iiif ⇒ String

Generates the link markup for the IIIF JPEG download

Returns:

  • (String) 


44
45
46
47
48
49
50
51
52
53
54
 
# File 'app/helpers/geoblacklight_helper.rb', line 44

def download_link_iiif
  link_to(
    download_text('JPG'),
    iiif_jpg_url,
    'contentUrl' => iiif_jpg_url,
    class: ['btn', 'btn-default', 'download', 'download-generated'],
    data: {
      download: 'trigger'
    }
  )
end

#download_text(format) ⇒ Object

Wraps download text with proper_case_format



120
121
122
123
124
 
# File 'app/helpers/geoblacklight_helper.rb', line 120

def download_text(format)
  download_format = proper_case_format(format)
  value = t('geoblacklight.download.download_link', download_format: download_format)
  value.html_safe
end

#first_metadata?(document, metadata) ⇒ Boolean

Determines whether or not the metadata is the first within the array of References

Parameters:

Returns:

  • (Boolean) 


229
230
231
 
# File 'app/helpers/geoblacklight_helper.rb', line 229

def first_metadata?(document, metadata)
  document.references.shown_metadata.first.type == metadata.type
end

#formatted_name_reference(reference) ⇒ String

Looks up formatted names for references

Parameters:

  • reference (String, Symbol)

Returns:

  • (String) 


113
114
115
 
# File 'app/helpers/geoblacklight_helper.rb', line 113

def formatted_name_reference(reference)
  t "geoblacklight.references.#{reference}"
end

#geoblacklight_basemap ⇒ String

Selects the basemap used for map displays

Returns:

  • (String) 


163
164
165
 
# File 'app/helpers/geoblacklight_helper.rb', line 163

def geoblacklight_basemap
  blacklight_config.basemap_provider || 'positron'
end

#geoblacklight_icon(name) ⇒ Object 



84
85
86
87
88
89
90
 
# File 'app/helpers/geoblacklight_helper.rb', line 84

def geoblacklight_icon(name)
  icon_name = name ? name.parameterize : 'none'
  content_tag :span,
              '',
              class: "geoblacklight-icon geoblacklight-#{icon_name}",
              title: name
end

#iiif_jpg_url ⇒ Object 



10
11
12
 
# File 'app/helpers/geoblacklight_helper.rb', line 10

def iiif_jpg_url
  @document.references.iiif.endpoint.sub! 'info.json', 'full/full/0/default.jpg'
end

#leaflet_options ⇒ Object

Returns a hash of the leaflet plugin settings to pass to the viewer. @return



193
194
195
 
# File 'app/helpers/geoblacklight_helper.rb', line 193

def leaflet_options
  Settings.LEAFLET
end

#proper_case_format(format) ⇒ Object

Looks up properly formatted names for formats



105
106
107
 
# File 'app/helpers/geoblacklight_helper.rb', line 105

def proper_case_format(format)
  t("geoblacklight.formats.#{format.to_s.parameterize(separator: '_')}")
end

#render_facet_item_with_icon(field_name, item) ⇒ Object

Renders a facet item with an icon placed as the first child of ‘.facet-label`. This works with `render_facet_value` and `render_selected_facet_value`

Returns:

  • String



202
203
204
205
206
207
 
# File 'app/helpers/geoblacklight_helper.rb', line 202

def render_facet_item_with_icon(field_name, item)
  doc = Nokogiri::HTML.fragment(render_facet_item(field_name, item))
  doc.at_css('.facet-label').children.first
     .add_previous_sibling(geoblacklight_icon(item.value))
  doc.to_html.html_safe
end

#render_facet_links(facet, items) ⇒ Object

Renders an unique array of search links based off of terms passed in using the facet parameter



96
97
98
99
100
 
# File 'app/helpers/geoblacklight_helper.rb', line 96

def render_facet_links(facet, items)
  items.uniq.map do |item|
    link_to item, search_catalog_path(f: { facet => [item] })
  end.join(', ').html_safe
end

#render_facet_tags(facet) ⇒ Object 



78
79
80
81
82
 
# File 'app/helpers/geoblacklight_helper.rb', line 78

def render_facet_tags(facet)
  render_facet_limit(facets_from_request(facet).first,
                     partial: 'facet_tag_item',
                     layout: 'facet_tag_layout')
end

#render_references_url(args) ⇒ Object

Renders a reference url for a document

Parameters:

  • document, (Hash) —

    field_name



236
237
238
239
240
241
 
# File 'app/helpers/geoblacklight_helper.rb', line 236

def render_references_url(args)
  link_to(
    args[:document].references.url.endpoint,
    args[:document].references.url.endpoint
  ) if args[:document]&.references&.url
end

#render_transformed_metadata(metadata) ⇒ String

Renders the transformed metadata (Renders a partial when the metadata isn’t available)

Parameters:

Returns:

  • (String) 


214
215
216
217
218
219
220
221
222
 
# File 'app/helpers/geoblacklight_helper.rb', line 214

def render_transformed_metadata(metadata)
  render partial: 'catalog/metadata/content', locals: { content: metadata.transform.html_safe }
rescue Geoblacklight::MetadataTransformer::TransformError => transform_err
  Geoblacklight.logger.warn transform_err.message
  render partial: 'catalog/metadata/markup', locals: { content: metadata.to_xml }
rescue => err
  Geoblacklight.logger.warn err.message
  render partial: 'catalog/metadata/missing'
end

#render_value_as_truncate_abstract(args) ⇒ Object

Render value for a document’s field as a truncate abstract div. Arguments come from Blacklight::DocumentPresenter’s get_field_values method

Parameters:

  • args (Hash) —

    from get_field_values



154
155
156
157
158
 
# File 'app/helpers/geoblacklight_helper.rb', line 154

def render_value_as_truncate_abstract(args)
  content_tag :div, class: 'truncate-abstract' do
    Array(args[:value]).flatten.join(' ')
  end
end

#render_web_services(reference) ⇒ Object

Renders the partials for a Geoblacklight::Reference in the web services modal

Parameters:



181
182
183
184
185
186
187
188
 
# File 'app/helpers/geoblacklight_helper.rb', line 181

def render_web_services(reference)
  render(
    partial: "web_services_#{reference.type}",
    locals: { reference: reference }
  )
rescue ActionView::MissingTemplate
  render partial: 'web_services_default', locals: { reference: reference }
end

#show_attribute_table? ⇒ Boolean

Deteremines if item view should include attribute table

Returns:

  • (Boolean) 


145
146
147
 
# File 'app/helpers/geoblacklight_helper.rb', line 145

def show_attribute_table?
  document_available? && @document.inspectable?
end

#snippit(args) ⇒ String

Blacklight catalog controller helper method to truncate field value to 150 chars

Parameters:

  • args (SolrDocument)

Returns:

  • (String) 


74
75
76
 
# File 'app/helpers/geoblacklight_helper.rb', line 74

def snippit(args)
  truncate(Array(args[:value]).flatten.join(' '), length: 150)
end