package wizards;
# $Id$

use strict;
use c;
use common;

=head1 NAME

wizards - a layer on top of interactive that ensure proper stepping

=head1 SYNOPSIS

    use wizards;
    use interactive;

    my $wiz = wizards->new({

               allow_user => "", # do we need root
               defaultimage => "", # wizard icon
               init => sub { },    # code run on wizard startup
               name => "logdrake", # wizard title
               needed_rpm => "packages list", # packages to install before running the wizard
               pages => {
                         {
                             name => "welcome", # first step
                             next => "step1",   # which step should be displayed after the current one
                             pre =>  sub { },   # code executing when stepping backward
                             post => sub { },   # code executing when stepping forward;
                                                # returned value is next step name (it overrides "next" field)
                             end => ,       # is it the last step ?
                             default => ,       # default answer for yes/no or when data does not conatains any fields
                             no_cancel => , # do not display the cancel button (eg for first step)
                             no_back => ,   # do not display the back button (eg for first step)
                             ignore => ,    # do not stack this step for back stepping (eg for warnings and the like steps)
                             interactive_help_id => , # help id  (for installer only)
                             data => [],    # the actual data passed to interactive
                         },
                         {
                          name => "step1",
                          data => [
                                   {
                                       # usual interactive fields:
                                       label => N("Banner:"),
                                       val => \$o->{var}{wiz_banner},
                                       list => [] ,
                                       # wizard layer variables:
                                       boolean_list => "", # provide default status for booleans list
                                   },
                                   ],
                      },
                     },
           });
    my $in = 'interactive'->vnew;
    $wiz->process($in);

=head1 DESCRIPTION

wizards is a layer built on top of the interactive layer that do proper
backward/forward stepping for us.

A step is made up of a name/description, a list of interactive fields (see
interactive documentation), a "complete", "pre" and "post" callbacks, an help
id, ...

The "pre" callback is run first. Its only argument is the actual step hash.

Then, if the "name" fiels is a code reference, that callback is run and its
actual result is used as the description of the step.

At this stage, the interactive layer is used to display the actual step.

The "post" callback is only run if the user has steped forward.


Alternatively, you can call safe_process() rather than process().
safe_process() will handle for you the "wizcancel" exception while running the
wizard.  Actually, it should be used everywhere but where the wizard is not the
main path (eg "mail alert wizard" in logdrake, ...), ie when you may need to do
extra exception managment such as destroying the wizard window and the like.

=cut


sub new {
    my ($class, $o) = @_;
    bless $o, $class;
}


sub check_rpm {
    my ($in, $rpms) = @_;
    foreach my $rpm (@$rpms) {
        next if $in->do_pkgs->is_installed($rpm);
        if ($in->ask_okcancel(N("Error"), N("%s is not installed\nClick \"Next\" to install or \"Cancel\" to quit", $rpm))) {
            $::testing and next;
            if (!$in->do_pkgs->install($rpm)) {
                local $::Wizard_finished = 1;
                $in->ask_okcancel(N("Error"), N("Installation failed"));
                $in->exit;
            }
        } else { $in->exit }
    }
}


# sync me with interactive::ask_from_normalize() if needed:
my %default_callback = (complete => sub { 0 });


sub process {
    my ($o, $in) = @_;
    local $::isWizard = 1;
    local $::Wizard_title = $o->{name} || $::Wizard_title;
    local $::Wizard_pix_up = $o->{defaultimage} || $::Wizard_pix_up;
    #require_root_capability() if $> && !$o->{allow_user} && !$::testing;
    check_rpm($in, $o->{needed_rpm}) if ref($o->{needed_rpm});
    if (defined $o->{init}) {
        my ($res, $msg) = &{$o->{init}};
        if (!$res) {
            $in->ask_okcancel(N("Error"), $msg);
            die "wizard failed" if !$::testing;
        }
    }
    
    my @steps;             # steps stack

    # initial step:
    my $next = 'welcome';  
    my $page = $o->{pages}{welcome};
    while ($next) {
        local $::Wizard_no_previous = $page->{no_back};
        local $::Wizard_no_cancel = $page->{no_cancel} || $page->{end};
        local $::Wizard_finished = $page->{end};
        defined $page->{pre} and $page->{pre}($page);
        die qq(inexistant "$next" wizard step) if is_empty_hash_ref($page);
        
        # FIXME or the displaying fails
        my $data = defined $page->{data} ? (ref($page->{data}) eq 'CODE' ? $page->{data}->() : $page->{data}) : [];
        my $data2;
        foreach my $d (@$data) {
            $d->{val} = ${$d->{val_ref}} if $d->{val_ref};
            $d->{list} = $d->{list_ref} if $d->{list_ref};
            #$d->{val} = ref($d->{val}) eq 'CODE' ? $d->{val}->() : $d->{val};
            if ($d->{boolean_list}) { 
                my $i;
                foreach (@{$d->{boolean_list}}) { 
                    push @$data2, { text => $_, type => 'bool', val => \${$d->{val}}->[$i], disabled => $d->{disabled} };
                    $i++;
                }
            } else {
                push @$data2, $d;
            }
        }
        my $name = ref($page->{name}) ? $page->{name}->() : $page->{name};
        my %yesno = (yes => N("Yes"), no => N("No"));
        my $yes = ref($page->{default}) eq 'CODE' ? $page->{default}->() : $page->{default};
        $data2 = [ { val => \$yes, type => 'list', list => [ keys %yesno ], format => sub { $yesno{$_[0]} }, 
                     gtk => { use_boxradio => 1 } } ] if $page->{type} eq "yesorno";
        my $a;
        if (ref $data2 eq 'ARRAY' && @$data2) {
            $a = $in->ask_from_({ title => $o->{name}, 
                                 messages => $name, 
                                 (map { $_ => $page->{$_} || $default_callback{$_} } qw(complete)),
                                 if_($page->{interactive_help_id}, interactive_help_id => $page->{interactive_help_id}),
                               }, $data2);
        } else {
            $a = $in->ask_okcancel($o->{name}, $name, $yes || 'ok');
        }
        # interactive->ask_yesorno does not support stepping forward or backward:
        $a = $yes if $a && $page->{type} eq "yesorno";
        if ($a) {
            # step forward:
            push @steps, $next if !$page->{ignore} && $steps[-1] ne $next;
            my $current = $next;
            $next = defined $page->{post} ? $page->{post}($page->{type} eq "yesorno" ? $yes eq 'yes' : $a) : 0;
            return if $page->{end};
            if (!$next) {
                if (!defined $o->{pages}{$next}) {
                    $next = $page->{next};
                } else {
                    die qq(the "$next" page (from previous wizard step) is undefined) if !$next;
                }
            }
            die qq(Step "$current": inexistant "$next" page) if !exists $o->{pages}{$next};
        } else {
            # step back:
            $next = pop @steps;
        }
        $page = $o->{pages}{$next};
    }
}


sub safe_process {
    my ($o, $in) = @_;
    eval { $o->process($in) };
    my $err = $@;
    if ($err =~ /wizcancel/) {
        $in->exit(0);
    } else { 
        die $err if $err;
    }
}

1;
iv><div class='ctx'> #</div><div class='del'>-# Copyright (C) 2002,2003, 2004, 2005, 2006 Free Software Foundation, Inc.</div><div class='add'>+# Copyright (C) 2002,2003, 2004, 2005, 2006, 2008 Free Software Foundation, Inc.</div><div class='ctx'> # Copyright (C) 2002 Mandriva</div><div class='ctx'> #</div><div class='ctx'> # Matias Griese &lt;mahagr@utu.fi&gt;, 2001, 2002.</div><div class='hunk'>@@ -8,14 +8,14 @@</div><div class='ctx'> # Taisto Kuikka &lt;69319@batman.jypoly.fi&gt;, 2003, 2004.</div><div class='ctx'> # Esa Linna &lt;denzo@mbnet.fi&gt;, 2004.</div><div class='ctx'> # Thomas Backlund &lt;tmb@mandrake.org&gt;, 2002, 2003, 2004, 2005.</div><div class='del'>-# Thomas Backlund &lt;tmb@mandriva.org&gt;, 2005, 2006.</div><div class='add'>+# Thomas Backlund &lt;tmb@mandriva.org&gt;, 2005, 2006, 2008.</div><div class='ctx'> # Anssi Hannula &lt;anssi@mandriva.org&gt;, 2007.</div><div class='ctx'> msgid ""</div><div class='ctx'> msgstr ""</div><div class='del'>-"Project-Id-Version: drakconf\n"</div><div class='add'>+"Project-Id-Version: control-center-fi\n"</div><div class='ctx'> "POT-Creation-Date: 2008-02-14 17:42+0100\n"</div><div class='del'>-"PO-Revision-Date: 2007-09-30 03:25+0300\n"</div><div class='del'>-"Last-Translator: Anssi Hannula &lt;anssi@mandriva.org&gt;\n"</div><div class='add'>+"PO-Revision-Date: 2008-02-29 18:24+0200\n"</div><div class='add'>+"Last-Translator: Thomas Backlund &lt;tmb@mandriva.org&gt;\n"</div><div class='ctx'> "Language-Team: Finnish &lt;fi@li.org&gt;\n"</div><div class='ctx'> "MIME-Version: 1.0\n"</div><div class='ctx'> "Content-Type: text/plain; charset=UTF-8\n"</div><div class='hunk'>@@ -306,8 +306,7 @@ msgstr "Emmanuel Blindauer"</div><div class='ctx'> #: ../contributors.pl:35</div><div class='ctx'> #, c-format</div><div class='ctx'> msgid "lm_sensors for 2.6 kernel, testing, some contrib packages."</div><div class='del'>-msgstr ""</div><div class='del'>-"lm_sensors  2.6 sarajn ytimelle, testausta, joitakin contrib paketteja."</div><div class='add'>+msgstr "lm_sensors  2.6 sarajn ytimelle, testausta, joitakin contrib paketteja."</div><div class='ctx'> </div><div class='ctx'> #: ../contributors.pl:36</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -570,10 +569,8 @@ msgstr "Tunnistustapa"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:153</div><div class='ctx'> #, c-format</div><div class='del'>-msgid ""</div><div class='del'>-"Select the authentication method (local, NIS, LDAP, Windows Domain, ...)"</div><div class='del'>-msgstr ""</div><div class='del'>-"Valitse tunnistustapa (paikallinen, NIS, LDAP, Windows Verkkoalue, ...)"</div><div class='add'>+msgid "Select the authentication method (local, NIS, LDAP, Windows Domain, ...)"</div><div class='add'>+msgstr "Valitse tunnistustapa (paikallinen, NIS, LDAP, Windows Verkkoalue, ...)"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:162</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -593,8 +590,7 @@ msgstr "Aseta automaattikirjautuminen"</div><div class='ctx'> #: ../control-center:173</div><div class='ctx'> #, c-format</div><div class='ctx'> msgid "Enable autologin and select the user to automatically log in"</div><div class='del'>-msgstr ""</div><div class='del'>-"Ota automaattikirjautuminen käyttöön ja valitse käyttäjä joka käytetään"</div><div class='add'>+msgstr "Ota automaattikirjautuminen käyttöön ja valitse käyttäjä joka käytetään"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:182</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -688,10 +684,8 @@ msgstr "Aseta henkilökohtainen palomuuri"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:295</div><div class='ctx'> #, c-format</div><div class='del'>-msgid ""</div><div class='del'>-"Set up a personal firewall in order to protect the computer and the network"</div><div class='del'>-msgstr ""</div><div class='del'>-"Asetä henkilökohtainen palomuuri suojaaksesi tietokonetta ja lähiverkkoa."</div><div class='add'>+msgid "Set up a personal firewall in order to protect the computer and the network"</div><div class='add'>+msgstr "Asetä henkilökohtainen palomuuri suojaaksesi tietokonetta ja lähiverkkoa."</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:304 ../control-center:305</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -729,9 +723,9 @@ msgid "Manage hosts definitions"</div><div class='ctx'> msgstr "Hallitse koneiden määritykset"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:355</div><div class='del'>-#, fuzzy, c-format</div><div class='add'>+#, c-format</div><div class='ctx'> msgid "Install &amp; Remove Software"</div><div class='del'>-msgstr "Asenna ohjelmia"</div><div class='add'>+msgstr "Asenna &amp; Poista Ohjelmia"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:356</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -877,9 +871,9 @@ msgid "Activate and manage network profiles"</div><div class='ctx'> msgstr "Aktivoi ja hallitse verkkoprofiileja"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:516</div><div class='del'>-#, fuzzy, c-format</div><div class='add'>+#, c-format</div><div class='ctx'> msgid "Access NFS shared drives and directories"</div><div class='del'>-msgstr "Windows-jakojen (Samba) asettaminen"</div><div class='add'>+msgstr "NFS-jakojen asettaminen"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:517</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -889,7 +883,7 @@ msgstr "Aseta NFS-liitospisteet"</div><div class='ctx'> #: ../control-center:526</div><div class='ctx'> #, c-format</div><div class='ctx'> msgid "Share drives and directories using NFS"</div><div class='del'>-msgstr ""</div><div class='add'>+msgstr "Jaa asemat ja hakemistot käyttäen NFS"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:527</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -929,8 +923,7 @@ msgstr "Ajoitetut tehtävät"</div><div class='ctx'> #: ../control-center:569</div><div class='ctx'> #, c-format</div><div class='ctx'> msgid "Schedule programs to run periodically or at given times"</div><div class='del'>-msgstr ""</div><div class='del'>-"Määritä ohjelmia joka suoritetaan määräaikaisesti tai märrittyihin aikoihin"</div><div class='add'>+msgstr "Määritä ohjelmia joka suoritetaan määräaikaisesti tai märrittyihin aikoihin"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:578</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -968,9 +961,9 @@ msgid "Wireless connection"</div><div class='ctx'> msgstr "Langaton yhteys"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:618</div><div class='del'>-#, fuzzy, c-format</div><div class='add'>+#, c-format</div><div class='ctx'> msgid "Access Windows (SMB) shared drives and directories"</div><div class='del'>-msgstr "Windows-jakojen (Samba) asettaminen"</div><div class='add'>+msgstr "Windows-jakojen (SMB) asettaminen"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:619</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -978,9 +971,9 @@ msgid "Configuration of Windows (Samba) shared drives and directories"</div><div class='ctx'> msgstr "Windows-jakojen (Samba) asettaminen"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:628</div><div class='del'>-#, fuzzy, c-format</div><div class='add'>+#, c-format</div><div class='ctx'> msgid "Share drives and directories with Windows (SMB) systems"</div><div class='del'>-msgstr "Jaa tietoja Windows-järjestelmän kanssa"</div><div class='add'>+msgstr "Jaa asemat ja hakemistot Windows (SMB) järjestelmien kanssa"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:629</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -1000,8 +993,7 @@ msgstr "Aseta turvallisuusaste ja -tarkistus"</div><div class='ctx'> #: ../control-center:649</div><div class='ctx'> #, c-format</div><div class='ctx'> msgid "Set the system security level and the periodic security audit"</div><div class='del'>-msgstr ""</div><div class='del'>-"Aseta järjestelmän turvallisuusaste ja määräaikainen turvallisuustarkistus"</div><div class='add'>+msgstr "Aseta järjestelmän turvallisuusaste ja määräaikainen turvallisuustarkistus"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:658</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -1061,9 +1053,9 @@ msgid "Configure VPN connection to secure network access"</div><div class='ctx'> msgstr "Aseta turvallinen VPN-etäyhteys"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:735</div><div class='del'>-#, fuzzy, c-format</div><div class='add'>+#, c-format</div><div class='ctx'> msgid "Access WebDAV shared drives and directories"</div><div class='del'>-msgstr "Windows-jakojen (Samba) asettaminen"</div><div class='add'>+msgstr "WebDAV-jakojen asettaminen"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:736</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -1187,8 +1179,7 @@ msgstr "Aseta aika"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:837</div><div class='ctx'> #, c-format</div><div class='del'>-msgid ""</div><div class='del'>-"Set the time of the server to be synchronized with an external time server"</div><div class='add'>+msgid "Set the time of the server to be synchronized with an external time server"</div><div class='ctx'> msgstr "Aseta palvelimen aika synkronoitavaksi ulkoisen aikapalvelimen kanssa"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:839 ../control-center:840</div><div class='hunk'>@@ -1269,8 +1260,7 @@ msgstr "Aseta paikalliskone webbiselaimen kautta"</div><div class='ctx'> #: ../control-center:915</div><div class='ctx'> #, c-format</div><div class='ctx'> msgid "You don't seem to have webmin intalled. Local config is disabled"</div><div class='del'>-msgstr ""</div><div class='del'>-"Sinulla ei ole webmin asennettuna. Paikallinen asetus on poistettu käytöstä"</div><div class='add'>+msgstr "Sinulla ei ole webmin asennettuna. Paikallinen asetus on poistettu käytöstä"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:917</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -1518,7 +1508,7 @@ msgstr "/_Julkaisutiedot"</div><div class='ctx'> #: ../control-center:1267</div><div class='ctx'> #, c-format</div><div class='ctx'> msgid "/What's _New?"</div><div class='del'>-msgstr ""</div><div class='add'>+msgstr "/Mitä Uutta?"</div><div class='ctx'> </div><div class='ctx'> #: ../control-center:1268</div><div class='ctx'> #, c-format</div><div class='hunk'>@@ -1920,41 +1910,3 @@ msgstr "Näyttö"</div><div class='ctx'> msgid "Screen Resolution"</div><div class='ctx'> msgstr "Näyttötila"</div><div class='ctx'> </div><div class='del'>-#~ msgid "/_Upload the hardware list"</div><div class='del'>-#~ msgstr "/Lähetä laitteistolista"</div><div class='del'>-</div><div class='del'>-#~ msgid "&lt;control&gt;U"</div><div class='del'>-#~ msgstr "&lt;control&gt;U"</div><div class='del'>-</div><div class='del'>-#~ msgid "Upload the hardware list"</div><div class='del'>-#~ msgstr "Lähetä laitteistolistaus"</div><div class='del'>-</div><div class='del'>-#~ msgid "Account:"</div><div class='del'>-#~ msgstr "Käyttäjätunnus:"</div><div class='del'>-</div><div class='del'>-#~ msgid "Password:"</div><div class='del'>-#~ msgstr "Salasana:"</div><div class='del'>-</div><div class='del'>-#~ msgid "Hostname:"</div><div class='del'>-#~ msgstr "Tietokoneen nimi:"</div><div class='del'>-</div><div class='del'>-#~ msgid "Please wait"</div><div class='del'>-#~ msgstr "Odota hetki"</div><div class='del'>-</div><div class='del'>-#~ msgid "Uploading in progress"</div><div class='del'>-#~ msgstr "Lähetys käynnissä"</div><div class='del'>-</div><div class='del'>-#~ msgid "Manage software"</div><div class='del'>-#~ msgstr "Ohjelmistonhallinta"</div><div class='del'>-</div><div class='del'>-#~ msgid "Use NFS shares"</div><div class='del'>-#~ msgstr "Käytä NFS-jakoja"</div><div class='del'>-</div><div class='del'>-#~ msgid "Share your data through NFS"</div><div class='del'>-#~ msgstr "Jaa tietoja NFS-jakamisen avulla"</div><div class='del'>-</div><div class='del'>-#~ msgid "Manage Samba configuration"</div><div class='del'>-#~ msgstr "Hallitse Samban asetuksia"</div><div class='del'>-</div><div class='del'>-#~ msgid "Use WebDAV shares"</div><div class='del'>-#~ msgstr "Käytä WebDAV-jakoja"</div></td></tr></table></div> <!-- class=content -->
<div class='footer'>generated by <a href='https://git.zx2c4.com/cgit/about/'>cgit v1.2.1</a> (<a href='https://git-scm.com/'>git 2.21.0</a>) at 2025-01-14 20:26:16 +0000</div>
</div> <!-- id=cgit -->
</body>
</html>