Extension:DataMaps
Appearance
(Redirected from Extension:Interactive Data Maps)
DataMaps Release status: beta |
|
---|---|
Implementation | ContentHandler , Parser function |
Author(s) | alex4401 (Alex44019talk) |
Latest version | 0.17.6 |
MediaWiki | v0.14+: 1.39 v0.1-v0.13: 1.37 |
PHP | 7.4+ |
Database changes | No |
License | GNU General Public License 2.0 or later |
Download | GitHub: |
Example | ARK: Survival Evolved Wiki Temtem Wiki |
The DataMaps extension lets you display interactive maps using Leaflet without additional services.
The maps can feature:
- circular markers, pin markers, or markers with custom icons;
- rich marker details panes with Wikitext titles, descriptions, an article link button and an image;
- an optional coordinate display;
- multiple switchable backgrounds;
- "collectibles", with a checklist the user can tick things off on;
- a search function for markers;
- custom JS integrations.
A visual editor is in the works and will be eventually released in phases as core enablement refactorings are done.
See usage documentation on Wiki.gg.
Installation
[edit]- Download and place the file(s) in a directory called
DataMaps
in yourextensions/
folder. - Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'DataMaps' );
- Optionally, if you do not want to use the built-in namespace create one and set
$wgDataMapsNamespaceId
to its ID. - Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Wikis on wiki.gg can request this extension to be enabled via the platform's representatives.
MediaWiki support plan
[edit]Main development and testing is done on the same version of MediaWiki that wiki.gg (1.39 as of December 2022) is running or planning to switch to (1-3 months ahead). Older versions may receive limited supported when requested.
Configuration parameters
[edit]- $wgDataMapsNamespaceId
- Identifier of the namespace that all maps will live in.
- Default:
managed
(uses built-in namespace) - $wgDataMapsApiCaching
- Since version 0.14.0.
- Associative array of settings controlling API output caching.
- type
- Type of cache to use.
- Default:
CACHE_ANYTHING
- ttl
- Expiry time (in seconds) of cached API responses.
- Default:
86400
(1 day) - ttlExtensionThreshold
- Remaining time-to-live (in seconds) of cached API responses needed for the time to be extended.
- Default:
43200
(12 hours) - ttlExtensionValue
- Number of seconds to extend a soon-to-be-expired cached API response's life.
- Default:
57600
(16 hours)
- $wgDataMapsDefaultApiMarkerBatch
- Number of markers the API will return by default in a single response.
- Default:
2500
- $wgDataMapsMaxApiMarkerBatch
- Maximum number of markers an API client can request.
- Default:
5000
- $wgDataMapsMarkerParserExpansionLimit
- Parser expansion limit used when parsing marker labels and descriptions.
- Default:
800
- $wgDataMapsUseInProcessParserCache
- If set to true, API will use a least recently used cache (in memory of the process handling the request) when processing markers (when uncached).
- Default:
true
- $wgDataMapsFullLinksUpdateBudget
- Since version 0.14.0.
- Controls total time (in seconds) that can be spent on parsing marker wikitext to perform complete links table updates.
- Set to `0` to disable.
- Default:
0.5
- $wgDataMapsEnableCreateMap
- Enables visual map creation dialog to streamline the process for users.
- This will be eventually merged into the visual editor.
- Since version 0.13.2.
- Default:
true
- $wgDataMapsEnableVisualEditor
- Enables visual map editor to streamline the process for users.
- This does not use the VisualEditor extension.
- Since version 0.14.0. Prior to v0.17.0, requires experimental features to be enabled.
- Default:
true
- $wgDataMapsReportTimingInfo
- Includes timing information in API output for profiling purposes.
- Default:
false
- $wgDataMapsAllowExperimentalFeatures
- Enables any experimental features bundled in the release but disabled by default.
- Default:
false
See also
[edit]This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |
Categories:
- Beta status extensions
- ContentHandler extensions
- Parser function extensions
- GPL licensed extensions
- Extensions in GitHub version control
- ParserFirstCallInit extensions
- ContentHandlerDefaultModelFor extensions
- CodeEditorGetPageLanguage extensions
- CanonicalNamespaces extensions
- GetPreferences extensions
- SkinTemplateNavigation::Universal extensions
- CustomEditor extensions
- ParserOptionsRegister extensions
- ChangeTagsListActive extensions
- ListDefinedTags extensions
- All extensions
- Extensions included in wiki.gg
- Map extensions
- Leaflet extensions
- Mapping