Ricardo's Blog

by Ricardo Morin

New HOWL feature - ability to update content

It is now possible to update HOWL selected content directly from the application

Up until now, the data behind HOWL ‘spotlights’ has been pre-processed off-line and loaded onto static files. This means that any data changes must be performed by a HOWL developer and deployed to the web site like a new application release.

This worked well for the ‘spotlights’ that were developed before the “A Sample of Threats to Oregon’s Wildlands, Wildlife and Waters,” because the data did not change very often. For example, the “History of Wildfire Severity” ‘spotlight’ has to be updated only once a year, and it does require a fair amount of data pre-processing. The other two ‘spotlights’ ("Potential Forest Wilderness Areas" and “The Journey of Wolf OR-7") are essentially static.

However, the latest ‘spotlight,’ Threats, can be much more dynamic. Threats need to be added, updated or removed by authorized Oregon Wild users any time, based on new information that may become available.

The latest HOWL release now includes the the capability of editing, deleting and adding new items presented on the Threats ‘spotlight’.

To make changes to the list, a user must have a Github account and be on the list of collaborators to the oregonhowl githubd repository. We are using Github credentials for authentication and the Github Collaborators feature as our authorization framework. This ensures that only authorized Oregon Wild users can edit the data that is being presented by the ‘spotlight.’

Activating update mode

Activating update mode is easy.

Simply right-click (or ctrl-click) on the Info icon (top right circled i)…


… and enter your Github credentials.

If successful, the (i) icon will turn orange, indicating that you are in update mode.

Update mode will be only active for the current HOWL session. If you navigate away from HOWL in the same browser tab, activation mode will be turned off. Also, if you want to manually deactivate update mode, simply right-click (or control-click) on the orange (i) icon again.

Your Github credentials are safe because they are not stored anywhere and are only used to communicate with Github.

Updating an existing entry

Right-click (or ctrl-click) on an item on the list shown on the info panel…

…and you will get an update dialog.

Make changes and click on the “Commit” button to post your changes onto the repository. Changes will be immediately available to users.

To discard changes, click on the close (X) icon on the top right corner of the dialog, or press the “esc” key, or simply click anywhere outside of the dialog box.

Adding a new item

Double click directly on a spot on the map where you want the item to appear. Don’t worry if it is not exactly on the place you want, you can update the positioning (latitude/long) directly on the dialog box.

Bonus functionality

One nice thing about using Github for this feature is the fact that you can trace every change, who made it, and when. And it is pretty easy to rollback changes to a specific commit point.

A note of caution for authorized users

While it is possible for an authorized user to update the data directly in the Github repository, it is strongly discouraged to avoid corrupting the data or simply entering invalid information without the help of the HOWL dialogs. Just use HOWL to update the data – it is easy and safe.

Ok, that’s it for now. Hasta la vista amigos!

comments powered by Disqus