omeka / omeka/plugin-Geolocation
Testing: Basemap fixes and provider credentials
Open
@aviannamiller is already working on this.
Since Sep 4, 2026.
- Dominant language
- JavaScript
- Stars
- 12
- Forks
- 22
- PR merge metrics
- No merged PRs in 30d
Description
Branch: fix/basemap-providers. This covers #76, #80 and #81.
Most of our basemaps were broken. All six CARTO ones were watermarked without an API key, including Voyager, which was our default, so most sites have been showing a watermarked map. The six Stamen ones fail on any real domain, and Esri DeLorme was retired.
What changed:
- The default basemap is now OpenStreetMap Standard instead of CARTO Voyager. Existing sites on Voyager will see their maps change unless they add a CARTO key.
- There is a new CARTO API key setting.
- If a CARTO or Mapbox basemap is missing its key, the map falls back to the default instead of breaking.
- Stamen is the exception. It needs this site's domain registered with a Stadia account, there is no key to enter for it, and without the registration the map stays blank.
- Base Map settings are now their own section on the config page, and each basemap option names its provider.
- For #80, the Base Map description now recommends two basemaps with high contrast between map features. I explained the reasoning in a comment on that issue.
What to test:
- Each basemap, everywhere a map appears: the browse map, item pages, exhibit pages, the Map tab when editing an item, and the admin side.
- That the config settings still save. I moved fields around on that page, so it is worth checking a few unrelated to basemaps too.
- CARTO with a real API key, Mapbox with a real access token, and Stamen with this site's domain registered with Stadia. Those three need accounts.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.