GIS Forum and Forum Training Updates

GIS Forum and Forum Training Updates

To create new training pages for a new GIS Forum year, follow these steps below which have been updated as of August 26, 2019:

Forum Training Classes - Updates within api.tnris.org

1. Navigate to https://api.tnris.org/admin/ and login using your credentials.
2. Click 'Website Content' then 'Tnris Forum Trainings'
3. Go into any training records from previous years and uncheck the 'Registration Open' box (boolean). This will deactivate the registration button for that training record.
4. When ready to create new records for the upcoming forum, go to the top right and click 'Add Tnris Forum Training'
5. Fill out the form to create a new Tnris Forum Training record. Bold fields are required to fill out.
   • Important - be sure and check the box for 'Public' if you DO want the training to show up on the website. If it is not checked, your training will not show up. You may wish to create records and leave 'Public' unchecked until a certain point when you make all the records public on the site
6. When you finish, your record is added to the database and you should see it in the full list of past and current forum trainings.
7. If you chose 'Public' in your newly created training record and all the necessary source code content has been created prior (Chris L. will be doing this), then you should see the new training located at https://tnris.org/texas-gis-forum/XXXX/training ('XXXX' will be the year of the forum)

Update Forum Dates within source code

1. copy templates, sass, markdown content, and any other source code from a previous forum year to start the new forum year.
2. within the forum-training.njk template file, change out any previous year reference and change it to current year. a list of the elements that need changing are below. change out the X's for new year or date.
   • <section id="forum-training-XXXX">
   • <h2>Day 1 - Monday, October XX</h2>
   • <h2>Day 2 - Tuesday, October XX</h2>
   • <div id="insert-day-one-XXXX"></div>
   • <div id="insert-day-two-XXXX"></div>

Forum (Training) Registration Link

Forum Registration and Forum Training Registration are handled through an external link. This link applies to all forum training courses available for the current forum year.

apply the new link to all training courses pulled from the api:

1. open '~tnris.org/generate-webpack-config.js'
2. scroll to the bottom and find the webpack DefinePlugin within the config object (around lines 143-152)
3. replace the value for key FORUM_REGISTRATION_LINK with the new registration url wrapped inside the JSON.stringify method.
   • empty example: "FORUM_REGISTRATION_LINK": JSON.stringify("<insert link here>"),
   • working exmpale: "FORUM_REGISTRATION_LINK": JSON.stringify("https://events.eply.com/2019GISForumRegistration"),
4. save the file
5. redeploy to apply

JS Stars Update

when creating/updating the agenda page for the next texas gis forum, personnel must also update the year and dates (day one & day two) of the event within the webpack config in order for the agenda "star" or "favorite" javascript functionality to operate.

to update the "star" javascript functionality:

1. open '~tnris.org/generate-webpack-config.js'
2. scroll to the bottom and find the webpack DefinePlugin within the config object (around lines 143-152)
3. replace the value for key FORUM_YEAR with the a 4 digit string of the numerical year of the event. this should match the event page URL (example: 2016 for event page http://tnris.org/texas-gis-forum/2016/agenda)
4. replace the value for key FORUM_DAY_ONE with the dash separated date of the first day of the forum, as a string, in format 4 digit year-2 digit month-2 digit day. Example: 2016-10-26 for October 26, 2016
5. replace the value for key FORUM_DAY_TWO with the dash separated date of the second day of the forum, as a string, in format 4 digit year-2 digit month-2 digit day. Example: 2016-10-27 for October 27, 2016
6. save the file
7. redeploy