SM2Gen/Templates/controller.pm.tem

package SrvMngr::Controller::${PackageName};
#
# Generated by ${version} 
#
#----------------------------------------------------------------------
# heading     : ${MenuHeading}
# description : ${MenuDescription}
# navigation  : ${MenuNavigation}
#
# name : ${lcPackageName},    method : get,   url : /${lcPackageName},   ctlact : ${PackageName}#main
# name : ${lcPackageName}u,   method : post,  url : /${lcPackageName}u,  ctlact : ${PackageName}#do_update
# name : ${lcPackageName}d,   method : get,   url : /${lcPackageName}d,  ctlact : ${PackageName}#do_display
#
# routes : end
#
# Documentation: https://wiki.contribs.org/${PackageName}
#----------------------------------------------------------------------

#
# Scheme of things:
#
# TBA!!

use strict;
use warnings;
use Mojo::Base 'Mojolicious::Controller';

use constant FALSE => 0;
use constant TRUE  => 1;

use Locale::gettext;
use SrvMngr::I18N;
use SrvMngr qw(theme_list init_session);

use Data::Dumper;

use esmith::util;
use esmith::util::network;
use esmith::ConfigDB;
use esmith::AccountsDB;
use esmith::NetworksDB;
use esmith::HostsDB;
use esmith::DomainsDB;



require '/usr/share/smanager/lib/SrvMngr/Controller/${PackageName}-Custom.pm';  #The code that is to be added by the developer

sub main {
#
# Initial entry - route is "/<whatever>"
#
#set initial panel
#for initial panel:
	#Specifiy panel to enter
	#load up _data hash with DB fields
	#load up stash with pointer(s) to control fields hash(= get-))
		#and a pointer to the prefix_data hash
#render initial panel

    my $c = shift;
    $c->app->log->info( $c->log_req );

	#The most common ones
	my $cdb = esmith::ConfigDB->open()   || die("Couldn't open config db");
	my $adb = esmith::AccountsDB->open() || die("Couldn't open Accounts db");
	my $ndb = esmith::NetworksDB->open() || die("Couldn't open Network db");
	my $hdb = esmith::HostsDB->open() 	  || die("Couldn't open Hosts db");
	my $ddb = esmith::DomainsDB->open()  || die("Couldn't open Domains db");

    my %${prefix}_data = ();
    my $title = $c->l('${prefix}_${MenuDescription}');
    my $modul = '';

    $$${prefix}_data{'trt'} = '${firstPanel}';
    
    #Load any DB entries into the <prefix>_data area so as they are preset in the form
    # which DB - this only really works if the initial panel is a PARAMS type panel and not a TABLE
    my $db = $$${controldb | db | 'cdb'}; #pickup local or global db or Default to config
    <tal:block tal:repeat="dbfield dbfields">
		$$${prefix}_data{'${dbfield}'} = $db->prop('${dbfield}') || ${dbdefault | ""} || "";
	</tal:block>
	
	$c->do_display($$${prefix}_data{'trt'});
	
}

# Post request with params - submit from the form 
sub do_update {
#
# Return after submit pushed on panel (this is a post) - route is "/<whatever>u"
# parameters in the params hash.
#
#load up all params into prefix_data hash:
#By panel (series of if statements - only one executed):
		#call validate-PANEL() - return ret = ok or error message
			
#if validation not ok:
	#render back to current panel with error message in stash
#otherwise:
	#By panel (series of if statements - only one executed):
		#do whatever is required: call perform-PANEL() - return "ok" or Error Message
			#call signal-event for any global actions specified (check it exists - error and continue?)
			#if action smeserver-<whatever>-update exists
				#signal_event smeserver-<whatever>-update
			#call signal-event for any specific actions for thids panel (check it exists first - error and continue)
		#set success in stash
		#if no "nextpanel" entry:
			#set firstpanel
		#else 
			#set nextpanel
		#call render
	
    my $c = shift;
    $c->app->log->info($c->log_req);
	my $modul = '';

	#The most common ones - you might want to comment out any not used.
	my $cdb = esmith::ConfigDB->open()   || die("Couldn't open config db");
	my $adb = esmith::AccountsDB->open() || die("Couldn't open Accounts db");
	my $ndb = esmith::NetworksDB->open() || die("Couldn't open Network db");
	my $hdb = esmith::HostsDB->open() 	  || die("Couldn't open Hosts db");
	my $ddb = esmith::DomainsDB->open()  || die("Couldn't open Domains db");

    my %${prefix}_data = ();
    my $title = $c->l('${prefix}_${MenuDescription}');

	# Accessing all POST parameters
    my %params = $c->req->params->to_hash;

    # Get number of POST parameters
    my $num_params = keys %params;
    
    #Params are available in the hash "params" - copy to the prefix_data hash
    #while (my ($key, $value) = each %{$c->req->params->to_hash}) {
    #    $$${prefix}_data{$key} = $value;
    #}

    # the value of trt will tell you which panel has returned    
    my $trt = $c->param('trt') || '${firstPanel}'; #hidden control on every form.
    my $ret = 'ok';

    #Validate the parameters in a custom sub one for each panel (although only one of these will be executed)
    my $thispanel;
    <tal:block tal:repeat="panel panels">
		if ($trt eq '${panel}'){
			#Validate form parameters for panel ${panel}
			$ret = $c->validate_${panel}(\%${prefix}_data);
			$thispanel = '${panel}';
		}
	</tal:block>
	if ($ret ne "ok"){
		$c->do_display($thispanel);
	} else {
		#Do whatever is needed, including writing values to the DB
		
		<tal:block tal:repeat="panel panels">
			if ($trt eq '${panel}'){
				#do whatever is required ...
				$ret = $c->perform_${panel}(\%${prefix}_data);
				if ($ret ne "ok") {
					# return to the panel with error message
					$c->stash(error => $c->l($ret));
					$c->stash( 
						title => $title, 
						modul => $modul,
						${prefix}_data  => \%${prefix}_data
					);
					$c->render(template => "${lcPackageName}");	
				} else {
					$c->stash( success => $c->l('${panel} panel action was successful')); #A bit bland - edit it in the lex file
				}
			}
		</tal:block>
		# and call any signal-events needed
		#TBD
		# Setup shared data and call panel
		if ('${nextpanel | "none"}' eq 'none') {
			$$${prefix}_data{'trt'} = '${firstPanel}';
		} else {
			$$${prefix}_data{'trt'} = '${NextPanel | "none"}';
		}	
		$c->do_display($$${prefix}_data{'trt'});
	} 
}

sub do_display {
#
# Return after link clicked in table (this is a get) - route is "/<whatever>d"
# Expects ?trt=PANEL&selected="TableRowName" plus any other required
#
# OR it maybe a post from the main panel to add a new record 
#
#load up all supplied params into prefix_data hash
#call get-selected-PANEL() - returns hash of all relevent parameters
#load up returned hash into prefix_data
#render - to called panel

    my ($c,$trt) = @_;
    $c->app->log->info($c->log_req);

	#The most common ones - you might want to comment out any not used.
	my $cdb = esmith::ConfigDB->open()   || die("Couldn't open config db");
	my $adb = esmith::AccountsDB->open() || die("Couldn't open Accounts db");
	my $ndb = esmith::NetworksDB->open() || die("Couldn't open Network db");
	my $hdb = esmith::HostsDB->open() 	  || die("Couldn't open Hosts db");
	my $ddb = esmith::DomainsDB->open()  || die("Couldn't open Domains db");
    
    my %${prefix}_data = ();
    my $title = $c->l('${prefix}_${MenuDescription}');
    my $modul = "";

	# Accessing all parameters
    my %params = $c->req->params->to_hash;

    # Get number of parameters
    my $num_params = keys %params;
    
    #Tag as Post or Get (ie. create new entry or edit existing one
    my $is_new_record = ($c->req->method() eq 'POST');
    
    #Params are available in the hash "params" - copy to the prefix_data hash
    #while (my ($key, $value) = each %{$c->req->params->to_hash}) {
    #    $$${prefix}_data{$key} = $value;
    #}

    # the value of trt will tell you which panel has returned   
    if (! $trt){ 
		$trt = $c->param('trt') || '${firstPanel}'; #Indicates where to go now
	}
 
    # Now add in the params from the selected row from the table
		
    my %selectedrow;
    <tal:block tal:repeat="panel panels">
		if ($trt eq '${panel}'){
			#Validate Get selected row (if applicable)  ${panel}
				%selectedrow = $c->get_selected_${panel}($$${prefix}_data{'Selected'},$is_new_record);
		}
	</tal:block>
 
	#Copy in the selected row params to the prefix_data hash to pass to the panel
	while (my ($key, $value) = each %selectedrow){
        $$${prefix}_data{$key} = $value;
    }
	# Where to go now
	$$${prefix}_data{'trt'} = $trt;
	
	# Set up other shared data according to the panel to go to
    <tal:block tal:repeat="panel panels">
		if ($trt eq '${panel}'){
			# pickup any other contents needed and load them into hash shared with panel
			my %returned_hash;
			# subroutine returns a hash directly
			%returned_hash = $c->get_data_for_panel_${panel}();
			# Copy each key-value pair from the returned hash to the prefix data hash
			while (my ($key, $value) = each %returned_hash) {
				$$${prefix}_data{$key} = $value;
			}
		}
	</tal:block>
	
	# and table control fields
     <tal:block tal:repeat="tablecontrol tablecontrols">$c->stash(${tablecontrol[0]}=>$c->get_${tablecontrol[0]}());
     </tal:block>
	
	# Data for panel
	$c->stash( 
		title 			=> $title, 
		modul => $modul,
		${prefix}_data  => \%${prefix}_data
	);
	$c->render(template => "${lcPackageName}");
}    
1;