libkdepim/kconfigwizard.cpp

   1 /*
   2   This file is part of libkdepim.
   3
   4   Copyright (c) 2003 Cornelius Schumacher <schumacher@kde.org>
   5
   6   This library is free software; you can redistribute it and/or
   7   modify it under the terms of the GNU Library General Public
   8   License as published by the Free Software Foundation; either
   9   version 2 of the License, or (at your option) any later version.
  10
  11   This library is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14   Library General Public License for more details.
  15
  16   You should have received a copy of the GNU Library General Public License
  17   along with this library; see the file COPYING.LIB.  If not, write to
  18   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  19   Boston, MA 02110-1301, USA.
  20 */
  21
  22 #include "kconfigwizard.h"
  23 #include "kconfigpropagator.h"
  24
  25 #include <KAboutData>
  26 #include <KComponentData>
  27 #include <KConfigSkeleton>
  28 #include <KDebug>
  29 #include <KLocale>
  30 #include <KMessageBox>
  31 #include <KPageDialog>
  32
  33 #include <QApplication>
  34 #include <QLayout>
  35 #include <QTimer>
  36 #include <QVBoxLayout>
  37 #include <Q3ListView>
  38
  39 using namespace KPIM;
  40
  41 KConfigWizard::KConfigWizard( QWidget *parent, bool modal )
  42   : KPageDialog( parent ), mPropagator( 0 ), mChangesPage( 0 )
  43 {
  44   setModal( modal );
  45   init();
  46 }
  47
  48 KConfigWizard::KConfigWizard( KConfigPropagator *propagator, QWidget *parent,
  49                               bool modal )
  50   : KPageDialog( parent ), mPropagator( propagator ), mChangesPage( 0 )
  51 {
  52   setModal( modal );
  53   init();
  54 }
  55
  56 KConfigWizard::~KConfigWizard()
  57 {
  58   delete mPropagator;
  59 }
  60
  61 void KConfigWizard::init()
  62 {
  63   setFaceType( KPageDialog::Tree );
  64   setWindowTitle(
  65     KGlobal::mainComponent().aboutData()->programName().isEmpty()
  66     ? i18nc( "@title:window", "Configuration Wizard" )
  67     : KGlobal::mainComponent().aboutData()->programName() );
  68   setWindowIcon( KIcon("tools-wizard") );
  69   setButtons( Ok|Cancel );
  70   setDefaultButton( Ok );
  71
  72   connect( this, SIGNAL( currentPageChanged(KPageWidgetItem *, KPageWidgetItem * )),
  73            SLOT( slotAboutToShowPage(KPageWidgetItem *, KPageWidgetItem *) ) );
  74   connect( this, SIGNAL(okClicked()),
  75            SLOT( slotOk()));
  76   QTimer::singleShot( 0, this, SLOT( readConfig() ) );
  77 }
  78
  79 void KConfigWizard::setPropagator( KConfigPropagator *p )
  80 {
  81   mPropagator = p;
  82 }
  83
  84 void KConfigWizard::slotAboutToShowPage( KPageWidgetItem *page, KPageWidgetItem * )
  85 {
  86   if ( page == mChangesPage ) {
  87     updateChanges();
  88   }
  89 }
  90
  91 QWidget *KConfigWizard::createWizardPage( const QString &title )
  92 {
  93   QFrame *page = new QFrame(this);
  94   addPage( page, title );
  95   return page;
  96 }
  97
  98 void KConfigWizard::setupRulesPage()
  99 {
 100   QFrame *page = new QFrame(this);
 101   KPageWidgetItem *item = addPage( page, i18nc( "@title:tab", "Rules" ) );
 102   item->setHeader( i18nc( "@title:window", "Set Up Rules" ) );
 103   //TODO: set item icon
 104   //rame *topFrame = new QFrame( this );
 105   QVBoxLayout *topLayout = new QVBoxLayout;
 106   page->setLayout(topLayout);
 107   mRuleView = new Q3ListView;
 108   topLayout->addWidget( mRuleView );
 109
 110   mRuleView->addColumn( i18nc( "@title:column source file,group,entry", "Source" ) );
 111   mRuleView->addColumn( i18nc( "@title:column target file,group,entry", "Target" ) );
 112   mRuleView->addColumn( i18nc( "@title:column file,group,key,value", "Condition" ) );
 113
 114   updateRules();
 115 }
 116
 117 void KConfigWizard::updateRules()
 118 {
 119   if ( !mPropagator ) {
 120     kError() << "KConfigWizard: No KConfigPropagator set.";
 121     return;
 122   }
 123
 124   mRuleView->clear();
 125
 126   const KConfigPropagator::Rule::List rules = mPropagator->rules();
 127   KConfigPropagator::Rule::List::ConstIterator it;
 128   for ( it = rules.constBegin(); it != rules.constEnd(); ++it ) {
 129     KConfigPropagator::Rule r = *it;
 130     QString source = r.sourceFile + '/' + r.sourceGroup + '/' +
 131                      r.sourceEntry;
 132     QString target = r.targetFile + '/' + r.targetGroup + '/' +
 133                      r.targetEntry;
 134     QString condition;
 135     KConfigPropagator::Condition c = r.condition;
 136     if ( c.isValid ) {
 137       condition = c.file + '/' + c.group + '/' + c.key + " = " + c.value;
 138     }
 139     new Q3ListViewItem( mRuleView, source, target, condition );
 140   }
 141 }
 142
 143 void KConfigWizard::setupChangesPage()
 144 {
 145   QFrame *page = new QFrame( this );
 146   KPageWidgetItem *item = addPage( page, i18nc( "@title:tab", "Changes" ) );
 147   item->setHeader( i18nc( "@title:window", "Set Up Changes" ) );
 148   //TODO: set item icon
 149   QVBoxLayout *topLayout = new QVBoxLayout;
 150   page->setLayout(topLayout);
 151   mChangeView = new Q3ListView;
 152   topLayout->addWidget( mChangeView );
 153
 154   mChangeView->addColumn( i18nc( "@title:column change action", "Action" ) );
 155   mChangeView->addColumn( i18nc( "@title:column option to change", "Option" ) );
 156   mChangeView->addColumn( i18nc( "@title:column value for option", "Value" ) );
 157   mChangeView->setSorting( -1 );
 158
 159   mChangesPage = item;
 160 }
 161
 162 void KConfigWizard::updateChanges()
 163 {
 164   kDebug() << "KConfigWizard::updateChanges()";
 165
 166   if ( !mPropagator ) {
 167     kError() << "KConfigWizard: No KConfigPropagator set.";
 168     return;
 169   }
 170
 171   usrWriteConfig();
 172
 173   mPropagator->updateChanges();
 174
 175   mChangeView->clear();
 176
 177   KConfigPropagator::Change::List changes = mPropagator->changes();
 178   KConfigPropagator::Change *c;
 179   for ( c = changes.first(); c; c = changes.next() ) {
 180     new Q3ListViewItem( mChangeView, mChangeView->lastItem(), c->title(), c->arg1(), c->arg2() );
 181   }
 182 }
 183
 184 void KConfigWizard::readConfig()
 185 {
 186   kDebug() << "KConfigWizard::readConfig()";
 187
 188   setEnabled( false );
 189   int result = KMessageBox::warningContinueCancel(
 190     0,
 191     i18nc( "@info", "Please make sure that the programs which are "
 192           "configured by the wizard do not run in parallel to the wizard; "
 193           "otherwise, changes done by the wizard could be lost." ),
 194     i18nc( "@title:window warn about running instances", "Warning" ),
 195     KGuiItem( i18nc( "@action:button", "Run Wizard Now" ) ),
 196     KStandardGuiItem::cancel(), "warning_running_instances" );
 197   if ( result != KMessageBox::Continue ) {
 198     qApp->quit();
 199   }
 200   setEnabled( true );
 201
 202   usrReadConfig();
 203 }
 204
 205 void KConfigWizard::slotOk()
 206 {
 207   QString error = validate();
 208   if ( error.isNull() ) {
 209     usrWriteConfig();
 210
 211     if ( !mPropagator ) {
 212       kError() << "KConfigWizard: No KConfigPropagator set.";
 213       return;
 214     } else {
 215       if ( mPropagator->skeleton() ) {
 216         mPropagator->skeleton()->writeConfig();
 217       }
 218       mPropagator->commit();
 219     }
 220
 221     accept();
 222   } else {
 223     KMessageBox::sorry( this, error );
 224   }
 225 }
 226
 227 #include "kconfigwizard.moc"