Read Carefully:
====================================================================================================================
This file details the structure of any new case statements to be added to the index.php (Controller) page template.
Only the code in this file may be copied used for either new outlooks, or new bulletins. This includes comments
enclosed in /* */ and <!-- -->.

Please note the following:
- page title: the official title that would be displayed on finished product webpage (lowercase).
- keyword: the standard identifier for the product. This will be used when naming the
  update/summary textfile as well as sitewide, in all supporting functions.
- type: this should be equivalent to the keyword. 

- The term 'case' refers to the block of code bearing the structure:

	case 'keyword':
	  ...
	break;

- The term 'switch' refers to the block of code encasing one or more cases and bearing the structure:
	switch( variable ):
	  ...
	endswitch;



Below are examples of the structure of each case statement. These may be copied into the index.php file and modified
as needed.






If a new bulletin is being added:
====================================================================================================================
case 'page title':

/* Run the loop to output the posts.
* If you want to overload this in a child theme then include a file
* called loop-page.php and that will be used instead.
*/

$avia_config['size'] = avia_layout_class( 'main' , false) == 'entry_without_sidebar' ? '' : 'entry_with_sidebar';
get_template_part( 'includes/loop', 'page' );
?>
	<section class="av_textblock_section" itemscope="itemscope" itemtype="https://schema.org/CreativeWork">
		<div class="avia_textblock " itemprop="text">
			<p><strong>Update:</strong> <?= get_climate_bulletin_update('keyword'); ?></p>
		</div>
	</section>
<?php
	$year = date('Y');
	$month = date('m');
	$type = 'keyword';
	$found = false;

	while( $found === false ):
		get_latest_bulletin( $year, $month, $type, true, false );
		if( $month > 10 ):
			$month = ($month -1);
		else:
			if( $month > 0 ):
				$month = "0".($month -1);
			else:
				$month = 12;
				$year = ($year -1);
			endif;
		endif;
	endwhile;

break;



====================================================================================================================
The following functions must be modified in the functions.php file to recognize the new keyword being passed to: 
get_latest_bulletin( $year, $month, $type, true, false ). 
This can be done by duplicating any 'case' statement and modifying it for the intended purpose by replacing the 
keywords and regular expressions.
====================================================================================================================

FUNCTIONS:
 - bulletin_exists( $year, $month, $type )
 - get_climate_bulletin_update( $type )
 - get_latest_bulletin( $year, $month, $type, $image = true, $redirect )
 - get_recent_bulletin( $year, $month, $type, $redirect )

WIDGETS:
 - Recent_Bulletins_Widget









If a new outlook is being added:
====================================================================================================================
case 'page title':

/* Run the loop to output the posts.
* If you want to overload this in a child theme then include a file
* called loop-page.php and that will be used instead.
*/

$avia_config['size'] = avia_layout_class( 'main' , false) == 'entry_without_sidebar' ? '' : 'entry_with_sidebar';
get_template_part( 'includes/loop', 'page' );
?>
	<section class="av_textblock_section" itemscope="itemscope" itemtype="https://schema.org/CreativeWork">
		<div class="avia_textblock " itemprop="text">
		  <p><strong>Update:</strong> <?= get_caricof_outlook_summary('keyword'); ?></p>
		</div>
	</section>
<?php 
get_latest_caricof_outlook( 'keyword' );
break;



====================================================================================================================
The following functions must be modified in the functions.php file to recognize the new keyword being passed to: 
get_latest_caricof_outlook( 'keyword' ). 
This can be done by duplicating any 'case' statement and modifying it for the intended purpose by replacing the 
keywords and regular expressions.
====================================================================================================================

FUNCTIONS:
 - exists_latest_outlook( $type )
 - get_caricof_outlook_summary( $type )
 - get_latest_caricof_outlook( $type )
 - get_recent_caricof_outlook( $year, $month, $type, false )
 - outlook_exists( $year, $month, $type )

WIDGETS
 - CariCOF_Outlooks_Widget








Likewise, the following widget classes must also be modified in the functions.php file to adjust the links in the 
sidebar.
====================================================================================================================
- Related_Pages_Widget
- Product_Sheets_Widget





***************************************************************************************************
* In some cases, there may be a need to build a regular expression for the proccess of locating a *
* particular file that matches a naming convention. If havinf no prior knowledge or experience	  *
* with these expressions, a suitable regex builder, with reference guide, may be found at		  *
* https://regex101.com																			  *
***************************************************************************************************




====================================================================================================================
====================================================================================================================
Remember:
The process of adding a new case is simply the action of duplicating an existing one.