[FEATURE] Not sure how we coped without this till now...we now have a…

… tip presented at startup. You can en/disable tips in the options panel. To contribute more tips, please add them to src/app/qgstipfactory.cpp git-svn-id: http://svn.osgeo.org/qgis/trunk@15199 c8812cc2-4d05-0410-92ff-de0c093fc19c
qgis · Feb 18, 2011 · ea1ebcd · ea1ebcd
1 parent 0e6fe39
commit ea1ebcd
Show file tree

Hide file tree

Showing 7 changed files with 152 additions and 138 deletions.
diff --git a/src/app/CMakeLists.txt b/src/app/CMakeLists.txt
@@ -87,6 +87,8 @@ SET(QGIS_APP_SRCS
   qgssnappingdialog.cpp
   qgsundowidget.cpp
   qgstilescalewidget.cpp
+  qgstipgui.cpp
+  qgstipfactory.cpp
   qgsuniquevaluedialog.cpp
   qgsvectorlayerproperties.cpp
   qgsquerybuilder.cpp
@@ -144,77 +146,80 @@ SET (QGIS_APP_MOC_HDRS
   qgisapp.h
   qgisappinterface.h
   qgsabout.h
-  qgssponsors.h
   qgsaddattrdialog.h
-  qgsdisplayangle.h
   qgsaddjoindialog.h
   qgsannotationwidget.h
   qgsattributeactiondialog.h
   qgsattributedialog.h
   qgsattributetypedialog.h
   qgsattributetypeloaddialog.h
   qgsbookmarks.h
-  qgscontinuouscolordialog.h
   qgsconfigureshortcutsdialog.h
+  qgscontinuouscolordialog.h
   qgscustomprojectiondialog.h
+  qgsdbtablemodel.h
   qgsdelattrdialog.h
+  qgsdisplayangle.h
+  qgsfeatureaction.h
   qgsfieldcalculator.h
   qgsformannotationdialog.h
-  qgslabelinggui.h
-  qgslabelengineconfigdialog.h
-  qgsmaptoolmeasureangle.h
-  qgsnewvectorlayerdialog.h
   qgsgraduatedsymboldialog.h
   qgshelpviewer.h
   qgsidentifyresults.h
-  qgsfeatureaction.h
   qgslabeldialog.h
+  qgslabelengineconfigdialog.h
+  qgslabelinggui.h
   qgslabelpropertydialog.h
   qgsmanageconnectionsdialog.h
-  qgsmaptoolidentify.h
-  qgsmaptoolsplitfeatures.h
-  qgsmaptoolvertexedit.h
   qgsmaptooladdfeature.h
   qgsmaptooladdisland.h
   qgsmaptooladdring.h
+  qgsmaptooladdvertex.h
+  qgsmaptoolchangelabelproperties.h
+  qgsmaptooldeletepart.h
+  qgsmaptooldeletering.h
+  qgsmaptooldeletevertex.h
+  qgsmaptoolidentify.h
+  qgsmaptoolmeasureangle.h
   qgsmaptoolmovefeature.h
   qgsmaptoolmovelabel.h
+  qgsmaptoolmovevertex.h
   qgsmaptoolnodetool.h
   qgsmaptoolreshape.h
   qgsmaptoolrotatelabel.h
   qgsmaptoolrotatepointsymbols.h
-  qgsmaptoolselect.h
-  qgsmaptoolselectrectangle.h
   qgsmaptoolselectfreehand.h
+  qgsmaptoolselect.h
   qgsmaptoolselectpolygon.h
   qgsmaptoolselectradius.h
-  qgsmaptooladdvertex.h
-  qgsmaptoolchangelabelproperties.h
-  qgsmaptooldeletering.h
-  qgsmaptooldeletepart.h
-  qgsmaptooldeletevertex.h
-  qgsmaptoolmovevertex.h
+  qgsmaptoolselectrectangle.h
   qgsmaptoolsimplify.h
-  qgsmeasuretool.h
+  qgsmaptoolsplitfeatures.h
+  qgsmaptoolvertexedit.h
   qgsmeasuredialog.h
+  qgsmeasuretool.h
   qgsmergeattributesdialog.h
   qgsnewhttpconnection.h
+  qgsnewvectorlayerdialog.h
   qgsoptions.h
   qgspastetransformations.h
   qgspluginmanager.h
   qgsprojectproperties.h
+  qgsquerybuilder.h
   qgsrastercalcdialog.h
   qgsrasterlayerproperties.h
-  qgstextannotationdialog.h
-  qgswmssourceselect.h
   qgssinglesymboldialog.h
   qgssnappingdialog.h
+  qgssponsors.h
+  qgstextannotationdialog.h
+  qgstilescalewidget.h
+  qgstip.h
+  qgstipgui.h
+  qgstipfactory.h
+  qgsundowidget.h
   qgsuniquevaluedialog.h
   qgsvectorlayerproperties.h
-  qgsdbtablemodel.h
-  qgsundowidget.h
-  qgstilescalewidget.h
-  qgsquerybuilder.h
+  qgswmssourceselect.h
 
   composer/qgsattributeselectiondialog.h
   composer/qgscomposer.h

diff --git a/src/app/qgisapp.cpp b/src/app/qgisapp.cpp
@@ -156,6 +156,7 @@
 #include "qgssponsors.h"
 #include "qgstextannotationitem.h"
 #include "qgstilescalewidget.h"
+#include "qgstipgui.h"
 #include "qgsundowidget.h"
 #include "qgsvectordataprovider.h"
 #include "qgsvectorfilewriter.h"
@@ -532,16 +533,31 @@ QgisApp::QgisApp( QSplashScreen *splash, bool restorePlugins, QWidget * parent,
   mPrevScreenModeMaximized = false;
   show();
   qApp->processEvents();
-  //finally show all the application settings as initialised above
 
-  QgsDebugMsg( "\n\n\nApplication Settings:\n--------------------------\n" );
-  QgsDebugMsg( QgsApplication::showSettings() );
-  QgsDebugMsg( "\n--------------------------\n\n\n" );
   mMapCanvas->freeze( false );
   mMapCanvas->clearExtentHistory(); // reset zoomnext/zoomlast
   mLastComposerId = 0;
   mLBL = new QgsPalLabeling();
   mMapCanvas->mapRenderer()->setLabelingEngine( mLBL );
+
+  // Show a nice tip of the day
+  QSettings settings;
+  if ( settings.value( "/qgis/showTips", 1 ).toBool() )
+  {
+    mSplash->hide();
+    QgsTipGui myTip;
+    myTip.exec();
+  }
+  else
+  {
+    QgsDebugMsg( "Tips are disabled");
+  }
+
+  //finally show all the application settings as initialised above
+  QgsDebugMsg( "\n\n\nApplication Settings:\n--------------------------\n" );
+  QgsDebugMsg( QgsApplication::showSettings() );
+  QgsDebugMsg( "\n--------------------------\n\n\n" );
+
 } // QgisApp ctor
 
 

diff --git a/src/app/qgsoptions.cpp b/src/app/qgsoptions.cpp
@@ -257,6 +257,7 @@ QgsOptions::QgsOptions( QWidget *parent, Qt::WFlags fl ) :
   chkAddedVisibility->setChecked( settings.value( "/qgis/new_layers_visible", true ).toBool() );
   cbxLegendClassifiers->setChecked( settings.value( "/qgis/showLegendClassifiers", false ).toBool() );
   cbxHideSplash->setChecked( settings.value( "/qgis/hideSplash", false ).toBool() );
+  cbxShowTips->setChecked( settings.value( "/qgis/showTips", true ).toBool() );
   cbxAttributeTableDocked->setChecked( settings.value( "/qgis/dockAttributeTable", false ).toBool() );
   cbxIdentifyResultsDocked->setChecked( settings.value( "/qgis/dockIdentifyResults", false ).toBool() );
   cbxSnappingOptionsDocked->setChecked( settings.value( "/qgis/dockSnapping", false ).toBool() );
@@ -527,6 +528,7 @@ void QgsOptions::saveOptions()
   settings.setValue( "/Map/identifyRadius", spinBoxIdentifyValue->value() );
   settings.setValue( "/qgis/showLegendClassifiers", cbxLegendClassifiers->isChecked() );
   settings.setValue( "/qgis/hideSplash", cbxHideSplash->isChecked() );
+  settings.setValue( "/qgis/showTips", cbxShowTips->isChecked() );
   settings.setValue( "/qgis/dockAttributeTable", cbxAttributeTableDocked->isChecked() );
   settings.setValue( "/qgis/attributeTableBehaviour", cmbAttrTableBehaviour->currentIndex() );
   settings.setValue( "/qgis/dockIdentifyResults", cbxIdentifyResultsDocked->isChecked() );

diff --git a/src/app/qgstipfactory.cpp b/src/app/qgstipfactory.cpp
@@ -19,103 +19,74 @@
  ***************************************************************************/
 
 
-#include "omgtipfactory.h"
+#include "qgstipfactory.h"
 #include <QTime>
 //for rand & srand
 #include <cstdlib> 
 
 
-OmgTipFactory::OmgTipFactory() : QObject()
+QgsTipFactory::QgsTipFactory() : QObject()
 {
   // Im just doing this in a simple way so 
   // its easy for translators...later
   // it its worth the time Ill move this data
   // into a sqlite database...
-  OmgTip myTip;
-  myTip.setTitle(tr("openModeller is open source"));
-  myTip.setContent(tr("openModeller is open source software."
+  QgsTip myTip;
+  myTip.setTitle(tr("Quantum GIS is open source"));
+  myTip.setContent(tr("Quantum GIS is open source software."
         " This means that the software source code can be freely viewed "
         " and modified. The GPL places a restriction that any modifications "
         " you make must be made available to the openModeller project, and "
         " that you can not create a new version of openModeller under a "
-        " 'closed source' license. Visit <a href=\"http://openModeller.sf.net\">"
-        " the openModeller home page (http://openModeller.sf.net)</a> for more"
+        " 'closed source' license. Visit <a href=\"http://qgis.org\">"
+        " the QGIS home page (http://qgis.org)</a> for more"
         " information."));
   addGenericTip(myTip);
   //
-  myTip.setTitle(tr("openModeller Publications"));
+  myTip.setTitle(tr("QGIS Publications"));
   myTip.setContent(tr("If you write a scientific paper or any other article"
-        " that refers to openModeller we would love to include your work"
-        " in the references section of "
-        " the openModeller home page (http://openModeller.sf.net).</a>"
+        " that refers to QGIS we would love to include your work"
+        " in the <a href=\"http://www.qgis.org/en/community/qgis-case-studies.html\">case studies section</a> of"
+        " the Quantum GIS home page (http://http://www.qgis.org/en/community/qgis-case-studies.html)."
         ));
   addGenericTip(myTip);
-  myTip.setTitle(tr("Become an openModeller Desktop translator"));
-  myTip.setContent(tr("Would you like to see openModeller Desktop"
+  myTip.setTitle(tr("Become an QGIS translator"));
+  myTip.setContent(tr("Would you like to see QGIS"
         " in your native language? We are looking for more translators"
         " and would appreciate your help! The translation process is "
         " fairly straight forward - instructions are available in the "
-        " resources section of "
-        " the openModeller home page (http://openModeller.sf.net).</a>"
+        " QGIS wiki"
+        " <a href=\"http://www.qgis.org/wiki/GUI_Translation\">translator's page (http://www.qgis.org/wiki/GUI_Translation).</a>"
         ));
   addGuiTip(myTip);
-  myTip.setTitle(tr("openModeller Mailing lists"));
-  myTip.setContent(tr("If you need help using openModeller Desktop"
-        " we have a mailing list where users help each other with issues"
-        " related to niche modelling and using openModeller Desktop."
-        " Details on how to subscribe are in the resources section of"
-        " the openModeller home page (http://openModeller.sf.net).</a>"
+  myTip.setTitle(tr("QGIS Mailing lists"));
+  myTip.setContent(tr("If you need help using QGIS"
+        " we have a 'users'  mailing list where users help each other with issues"
+        " related to using our sofware. We also have a 'developers' mailing list."
+        " for those wanting help and to discuss things relating the the QGIS code base."
+        " Details on how to subscribe are in the <a href=\"http://www.qgis.org/en/community/mailing-lists.html\">community section</a> of"
+        " the QGIS home page (http://www.qgis.org/en/community/mailing-lists.html)."
         ));
   addGuiTip(myTip);
-  myTip.setTitle(tr("Is it 'modelling' or 'modeling'?"));
-  myTip.setContent(tr("Both spellings are correct. For openModeller"
-        " we use the former spelling."
+  myTip.setTitle(tr("Is it 'QGIS' or 'Quantum GIS'?"));
+  myTip.setContent(tr("Both are correct. For articles we suggest you write 'Quantum GIS (QGIS) is ....'"
+        " and then refer to it as QGIS thereafter."
         ));
   addGenericTip(myTip);
-  myTip.setTitle(tr("How do I refer to openModeller?"));
-  myTip.setContent(tr("openModeller is spelled with a lower case"
-        " 'o' at the start of the word - even if its the beginning"
-        " of a sentance. We have various subprojects of the openModeller "
+  myTip.setTitle(tr("How do I refer to Quantum GIS?"));
+  myTip.setContent(tr("QGIS is spelled in all caps."
+        " We have various subprojects of the QGIS project "
         " project and it will help to avoid confusion if you refer to each by"
         " its name:"
         "<ul>"
-        "<li>openModeller Library - this is the C++ library that contains"
-        " the core logic for carrying out niche modelling"
-        "<li>openModeller Console - these are a collection of command"
-        " line tools that allow you to run niche models from a unix or"
-        " DOS shell, or from a scripting environment."
-        "<li>openModeller Web Service - The openModeller Web Service"
-        " allows for remote execution of niche models."
-        "<li>openModeller Desktop - the openModeller Desktop provides"
-        " a graphical user interface for the openModeller Library. It"
-        " also includes the capability to run models using the"
-        " openModeller Web Service (though this is still considered"
-        " experimental)."
+        "<li>QGIS Library - this is the C++ library that contains"
+        " the core logic that is used to build the QGIS user interface and other applications.</li>"
+        "<li>QGIS Application - this is the desktop application that you know and love so much :-).</li>"
+        "<li>QGIS Mapserver - this is a server-side application based on the QGIS Library"
+        " that will serve up your .qgs projects using the WMS protocol.</li>"
         "</ul>"
         ));
   addGenericTip(myTip);
-  myTip.setTitle(tr("How can I improve model execution times?"));
-  myTip.setContent(tr("Model processing time is typically determined by"
-        "<ul>"
-        "<li>the algorithm you select,</li>"
-        "<li>the number, extents and spatial resolution of your format and environmental layers,</li>" 
-        "<li>the number of cells excluded by your mask (if any),</li>"
-        "<li>in some cases the number of presence and absence points (e.g. distance algs),</li>"
-        "<li>the speed of the computer the model is running on (CPU, disk access etc).</li>"
-        "</ul>"
-        "So if you want to improve model processing times you need to adjust "
-        "one of these variables. One thing noticed quite commonly is that people "
-        "use extremely high resolution datasets that often carry little "
-        "additional information over lower resolution equivalents. For example "
-        "interpolating widely dispersed weather station data to produce a 50cm "
-        "raster probably carries little additional value over for example using "
-        "10m2 pixels.<br>"
-        "Another area of performance improvement you can look at is "
-        "preselecting environmental variables using techniques such as Chi "
-        "Square test. Future versions of openModeller will integrate the ability "
-        "to do this type of preselection."
-        ));
-  addGenericTip(myTip);
   /* Template for adding more tips
   myTip.setTitle(tr(""));
   myTip.setContent(tr(""
@@ -124,52 +95,52 @@ OmgTipFactory::OmgTipFactory() : QObject()
   */
 }
 
-OmgTipFactory::~OmgTipFactory()
+QgsTipFactory::~QgsTipFactory()
 {
 
 }
 //private helper method
-void OmgTipFactory::addGuiTip(OmgTip theTip)
+void QgsTipFactory::addGuiTip(QgsTip theTip)
 {
   mGuiTips << theTip;
   mAllTips << theTip;
 }
 //private helper method
-void OmgTipFactory::addGenericTip(OmgTip theTip)
+void QgsTipFactory::addGenericTip(QgsTip theTip)
 {
   mGenericTips << theTip;
   mAllTips << theTip;
 }
-OmgTip OmgTipFactory::getTip()
+QgsTip QgsTipFactory::getTip()
 {
   srand(QTime::currentTime().msec());
   int myRand = rand();
   int myValue = static_cast<int> (myRand % mAllTips.count()); //range [0,(count-1)]
-  OmgTip myTip = mAllTips.at(myValue);
+  QgsTip myTip = mAllTips.at(myValue);
   return myTip;
 }
-OmgTip OmgTipFactory::getTip(int thePosition)
+QgsTip QgsTipFactory::getTip(int thePosition)
 {
-  OmgTip myTip = mAllTips.at(thePosition);
+  QgsTip myTip = mAllTips.at(thePosition);
   return myTip;
 }
-OmgTip OmgTipFactory::getGenericTip()
+QgsTip QgsTipFactory::getGenericTip()
 {
   srand(QTime::currentTime().msec());
   int myRand = rand();
   int myValue = static_cast<int> (myRand % mGenericTips.count()); //range [0,(count-1)]
-  OmgTip myTip = mGenericTips.at(myValue);
+  QgsTip myTip = mGenericTips.at(myValue);
   return myTip;
 }
-OmgTip OmgTipFactory::getGuiTip()
+QgsTip QgsTipFactory::getGuiTip()
 {
   srand(QTime::currentTime().msec());
   int myRand = rand();
   int myValue = static_cast<int> (myRand % mGuiTips.count()); //range [0,(count-1)]
-  OmgTip myTip = mGuiTips.at(myValue);
+  QgsTip myTip = mGuiTips.at(myValue);
   return myTip;
 }
-int OmgTipFactory::randomNumber(int theMax)
+int QgsTipFactory::randomNumber(int theMax)
 {
   return 0;
 }