contributed-plugins

Free to use but unsupported plugins for FGPV/RAMP2

Under construction 🔧🔨

This is a repository containing plugins for the FGPV-VGPF RAMP2 Viewer that have been submitted by users of the library. None of the plugins are officially maintained or supported by the RAMP2 development team; however we hope they are useful or provide learning opportunities.

Many of the plugins listed below deal with the visualization of time series data. For more detailed information on the appropriate application of a specific plugin and using the FGP Authoring Tool Web application to enable and configure plugins, please consult A Guide for Time Series Visualization for the Federal Geospatial Platform (FGP).

List of Plugins

Submission Guidelines

New Plugins

Create a pull request with the new plugin. The following things are advised for the content of the PR.

Create a folder at the root of the repo that has a clear, consise name. Use dashes between words. E.g. feature-graphing-tool

Consider looking at the My First Plugin sample template and copying or emulating the content there.

At the root of the folder there should be a README.md file. The file should contain

A good description of what the plugin does
Instructions on how to use the plugin, or a link to another doc file/site. E.g. if there is code that needs to be in the host page.
Optional Recommended: Github account ids of authors/maintainers
Optional Recommended: Version of RAMP the plugin was developed against / tested with
Optional Recommended: Level of support. I.e. will the author entertain issue submissions? Will they respond to questions (if yes, indicate preferred means of contact)? Do they plan to update code with RAMP releases? Is future development on the plugin planned?
Optional: Release status and/or release history
Optional: Contact email of authors/maintainers
Optional: Links to any active websites using the plugin

TODO put recommended subdirectory structure here

If the submitter wishes to be in the Authors user group (will allow them to pull their own PRs), make the request in the body of your first PR.

Update the primary repo README, adding the new plugin to the list of plugins.

Updates to Existing Plugins

Authors are free to update their plugins at whim. Please attempt to keep the plugin's README file in synch with the content

General Principles

Well commented code is not enforced, but is encouraged.
Commit messages should be clear and concise.
No extreme vulgarity / hateful content / X-Rated content / general evil
The branch being PR'd should be rebased from the master branch of this repo.

List of Plugins

Chart - Create a chart from feature attributes on identify (click)
Draw - Provides tools for drawing and measuring on the map
My First Plugin - A basic sample and starter template for plugins
Range Slider - Adds a range slider to the map
Swiper - Adds a LayerSwipe to the map
Thematic Slider - Adds a thematic slider to the map

Core Plugins

These plugins come bundled with the RAMP core library. Links are provided here to serve as more sources of plugin examples.

Areas Of Interest - Displays a list of items that will zoom to a specified area when clicked.
Back To Cart - A mechanism to preserve state and send layer info to another page containing a layers shopping cart
Coordinate Info - Displays details about the co-ordinates of a clicked point
Custom Export - Allows custom export templates to be constructed
Enhanced Table - A data table for attributes with filtering capabilities

Dependabot PR

We regularly have Dependapot PR to solve dependencies issues with some, if not all the plugins. To make it easier to solve them all at once, do the following:

Create an issue.
Create a new branch.
Run buildAll bash file
Add the files (git add *), then check with git status if package-lock.json files have been updated.
Commit the modifications.
Push your branch and do a PR.

This will solve all the issues and prepare a new version of js and css to use.

codey-codes / contributed-plugins Goto Github PK