Configure the GeoDiscovery Application

./app/controllers/catalog_controller.rb

Probably the file we would use the most for simple configurations.

configure_blacklight block is where we make most configuration settings such as critical Solr settings and paramters.

Default rows returned from Solr.

  • Default Facets (e.g. config.add_facet_field Settings.Fields.INDEX_YEAR, label: "Year", limit: 10)
    • See settings.yml to see where these are coming from.
    • Decide if facets are collapsed by default
    • What component will render component?
    • The order they appear is the order they will render on the UI
  • Item Relationships
  • Search Results Field
  • Item Show page/View page display
    • Most Aardvark fields shown by default, we may decide we want to add/remove
  • Sort values
  • Show tools (SMS, Email)
    • Shared-record emails now include title, provider, access rights, description, and a permalink
  • Basemap for the map

These things might be rendered through a helper method. Examples including truncating abstracts or the helper that renders HTML in the rights field (the link to our Copyright and Digital Collections policy page).

Mailer configuration is now standardized around ACTION_MAILER_FROM and ACTION_MAILER_HOST so record-sharing emails and Devise-generated URLs use the same environment-driven settings.

./config/settings.yml

  • Set the metadata schmea version, currently Aardvark
  • solr field mappings
  • Institutional text
  • Relationship field management
  • Leaflet Settings

./config/schedule.rb

Redis and Sidekiq use this file to run scheduled tasks.

and Whenever to write the crontab entries

  • Harvest thumbnail images for search results
  • Build the sitemap
  • Clean up anonymous user accounts created by search sessions
  • Clean up recent anonymous search records
  • Run the weekly combined GeoCombine/DCAT harvest, normalization, indexing, and stale-record pruning pipeline
  • Harvest and index Allmaps sidecar data
# Clear the current crontab for the geoblacklight user
sudo crontab -r -u geoblacklight

# List the crontab for the current user (geoblacklight)
crontab -l

> no crontab for geoblacklight

# See the schedule.rb file in the crontab format
whenever

# Write the crontab based on schedule.rb
whenever -w

> [geoblacklight@liblamp-dev8 current]$ crontab -l
> */2 * * * * /usr/local/bin/check_solr.sh
>
> # Begin Whenever generated tasks for: geodiscovery_production at: 2026-04-01 12:27:02 -0500
> 5 0 * * 0 /bin/bash -l -c 'cd /var/www/rubyapps/uwm-geoblacklight/current && RAILS_ENV=production bundle exec rake gblsci:images:harvest_retry --silent'
>
> 30 2 * * 0 /bin/bash -l -c 'cd /var/www/rubyapps/uwm-geoblacklight/current && RAILS_ENV=production bundle exec rake blacklight_allmaps:sidecars:harvest:allmaps --silent'
>
> 30 2 * * 0 /bin/bash -l -c 'cd /var/www/rubyapps/uwm-geoblacklight/current && RAILS_ENV=production bundle exec rake blacklight_allmaps:index:georeferenced_facet --silent'
>
> 30 0 * * * /bin/bash -l -c 'cd /var/www/rubyapps/uwm-geoblacklight/current && RAILS_ENV=production bundle exec rake sitemap:refresh --silent'
>
> 30 1 * * * /bin/bash -l -c 'cd /var/www/rubyapps/uwm-geoblacklight/current && RAILS_ENV=production bundle exec rake devise_guests:delete_old_guest_users[2] --silent'
>
> 0 2 * * * /bin/bash -l -c 'cd /var/www/rubyapps/uwm-geoblacklight/current && RAILS_ENV=production bundle exec rake blacklight:delete_old_searches[7] --silent'
>
> 0 3 * * 3 /bin/bash -l -c 'cd /var/www/rubyapps/uwm-geoblacklight/current && RAILS_ENV=production bundle exec rake uwm:geocombine_pull_and_index --silent'

> # End Whenever generated tasks for: geodiscovery_production at: 2026-04-01 12:27:02 -0500

./app/assets/images

Storage for images used in the app:

  • favicons
  • UWM Logos
  • UWM SVG

./app/assets/javascripts

  • Initial bounds of map is set in application.js
  • uwm.js contains some UWM customizations like the scrolltop feature

./app/assets/stylesheets

Various stylesheets to set color defaults, link colors, etc.