introduced new plugin metadata entry "category". Show hint based on

category in Plugin Manager and update all core plugins respectively

Author: alexbruy

python/plugins/GdalTools/__init__.py

@@ -21,6 +21,8 @@ def name():
   return "GdalTools"
 def description():
   return "Integrate gdal tools into qgis"
+def category():
+  return "Raster"
 def version():
   return "Version 1.2.29"
 def qgisMinimumVersion():

python/plugins/fTools/__init__.py

@@ -29,23 +29,26 @@
 #---------------------------------------------------------------------
 
 def name():
-	return "fTools"
+  return "fTools"
 
 def description():
-	return "Tools for vector data analysis and management"
+  return "Tools for vector data analysis and management"
+
+def category():
+  return "Vector"
 
 def version():
-	return "0.6.1"
-  
+  return "0.6.1"
+
 def qgisMinimumVersion():
-	return "1.4"
+  return "1.4"
 
 def icon():
-	return "icons/logo_small.png"
-	
+  return "icons/logo_small.png"
+
 def authorName():
-	return "Carson J. Q. Farmer"
+  return "Carson J. Q. Farmer"
 
 def classFactory( iface ):
-	from fTools import fToolsPlugin
-	return fToolsPlugin( iface )
+  from fTools import fToolsPlugin
+  return fToolsPlugin( iface )

python/plugins/mapserver_export/__init__.py

@@ -19,19 +19,21 @@
  This script initializes the plugin, making it known to QGIS.
 """
 
-def name(): 
-  return "MapServer Export" 
+def name():
+  return "MapServer Export"
 def description():
   return "Export a saved QGIS project file to a MapServer map file"
-def version(): 
-  return "Version 0.4.3" 
-def qgisMinimumVersion(): 
+def category():
+  return "Plugins"
+def version():
+  return "Version 0.4.3"
+def qgisMinimumVersion():
   return "1.0"
 def icon():
   return "mapserver_export.png"
 def authorName():
   return "Gary E. Sherman"
-def classFactory(iface): 
+def classFactory(iface):
   # load MapServerExport class from file mapserverexport.py
-  from mapserverexport import MapServerExport 
-  return MapServerExport(iface) 
+  from mapserverexport import MapServerExport
+  return MapServerExport(iface)

python/plugins/osm/__init__.py

@@ -33,6 +33,15 @@ def description():
     return "Viewer and editor for OpenStreetMap data"
 
 
+def category():
+    """Function returns category of this plugin.
+
+    @return category of this plugin.
+    """
+
+    return "Plugins"
+
+
 def version():
     """Function returns version of this plugin.
 
@@ -64,5 +73,5 @@ def classFactory(iface):
 
     from OsmPlugin import OsmPlugin
     # return object of our plugin with reference to QGIS interface as the only argument
-    return OsmPlugin(iface) 
+    return OsmPlugin(iface)
 

python/plugins/plugin_installer/__init__.py

@@ -20,6 +20,9 @@ def version():
 def description():
   return "Downloads and installs QGIS python plugins"
 
+def category():
+  return "Plugins"
+
 def qgisMinimumVersion():
   return "1.0"
 

src/app/qgspluginitem.cpp

@@ -32,6 +32,11 @@ QString QgsPluginItem::description()
   return m_description;
 }
 
+QString QgsPluginItem::category()
+{
+  return m_category;
+}
+
 QString QgsPluginItem::fullPath()
 {
   return m_fullPath;

src/app/qgspluginitem.h

@@ -28,13 +28,15 @@ class QgsPluginItem
     QgsPluginItem( QString name = 0, QString fullPath = 0, QString type = 0, bool python = false );
     QString name();
     QString description();
+    QString category();
     QString fullPath();
     QString type();
     bool isPython();
     ~QgsPluginItem();
   private:
     QString m_name;
     QString m_description;
+    QString m_category;
     QString m_fullPath;
     //! Plugin type (either ui or maplayer)
     QString m_type;

src/app/qgspluginmanager.cpp

@@ -171,12 +171,19 @@ void QgsPluginManager::getPythonPluginDescriptions()
     // get information from the plugin
     QString pluginName  = mPythonUtils->getPluginMetadata( packageName, "name" );
     QString description = mPythonUtils->getPluginMetadata( packageName, "description" );
+    QString category    = mPythonUtils->getPluginMetadata( packageName, "category" );
     QString version     = mPythonUtils->getPluginMetadata( packageName, "version" );
     QString iconName    = mPythonUtils->getPluginMetadata( packageName, "icon" );
 
     if ( pluginName == "__error__" || description == "__error__" || version == "__error__" )
       continue;
 
+    // if there is no category in Python plugin assume default 'Plugins' category
+    if ( category == "__error__" )
+    {
+      category = tr( "Plugins" );
+    }
+
     bool isCompatible = QgsPluginRegistry::instance()->isPythonPluginCompatible( packageName );
     QString compatibleString; // empty by default
     if ( !isCompatible )
@@ -196,6 +203,7 @@ void QgsPluginManager::getPythonPluginDescriptions()
     myData.setTitle( pluginName + " (" + version + ")" + compatibleString );
     myData.setEnabled( isCompatible );
     myData.setDetail( description );
+    myData.setCategory( tr( "Installed in %1 menu/toolbar" ).arg( category ) );
     //myData.setIcon(pixmap); //todo use a python logo here
     myData.setCheckable( true );
     myData.setRenderAsWidget( false );
@@ -308,6 +316,7 @@ void QgsPluginManager::getPluginDescriptions()
     // resolve the metadata from plugin
     name_t *pName = ( name_t * ) cast_to_fptr( myLib->resolve( "name" ) );
     description_t *pDesc = ( description_t * ) cast_to_fptr( myLib->resolve( "description" ) );
+    category_t *pCat = ( category_t * ) cast_to_fptr( myLib->resolve( "category" ) );
     version_t *pVersion = ( version_t * ) cast_to_fptr( myLib->resolve( "version" ) );
     icon_t* pIcon = ( icon_t * ) cast_to_fptr( myLib->resolve( "icon" ) );
 
@@ -328,6 +337,14 @@ void QgsPluginManager::getPluginDescriptions()
     {
       QgsDebugMsg( "Plugin description not returned when queried" );
     }
+    if ( pCat )
+    {
+      QgsDebugMsg( "Plugin category: " + pCat() );
+    }
+    else
+    {
+      QgsDebugMsg( "Plugin category not returned when queried" );
+    }
     if ( pVersion )
     {
       QgsDebugMsg( "Plugin version: " + pVersion() );
@@ -350,6 +367,8 @@ void QgsPluginManager::getPluginDescriptions()
 
     QString pluginName = pName();
     QString pluginDesc = pDesc();
+    // if no category defined - use default value
+    QString pluginCat = ( pCat ? pCat() : tr( "Plugins" ) );
     QString pluginVersion = pVersion();
     QString pluginIconFileName = ( pIcon ? pIcon() : QString() );
     QString baseName = QFileInfo( lib ).baseName();
@@ -363,6 +382,7 @@ void QgsPluginManager::getPluginDescriptions()
     QgsDetailedItemData myData;
     myData.setTitle( pluginName );
     myData.setDetail( pluginDesc );
+    myData.setCategory( tr( "Installed in %1 menu/toolbar" ).arg( pluginCat ) );
     myData.setRenderAsWidget( false );
     myData.setCheckable( true );
     myData.setChecked( false ); //start unchecked - we will check it later if needed

src/app/qgspluginregistry.cpp

@@ -36,6 +36,7 @@
 typedef QgisPlugin *create_ui( QgisInterface * qI );
 typedef QString name_t();
 typedef QString description_t();
+typedef QString category_t();
 typedef int type_t();
 
 
@@ -455,12 +456,13 @@ bool QgsPluginRegistry::checkCppPlugin( QString pluginFullPath )
 
   name_t * myName = ( name_t * ) cast_to_fptr( myLib.resolve( "name" ) );
   description_t *  myDescription = ( description_t * )  cast_to_fptr( myLib.resolve( "description" ) );
+  category_t *  myCategory = ( category_t * )  cast_to_fptr( myLib.resolve( "category" ) );
   version_t *  myVersion = ( version_t * ) cast_to_fptr( myLib.resolve( "version" ) );
 
-  if ( myName && myDescription  && myVersion )
+  if ( myName && myDescription && myVersion  && myCategory )
     return true;
 
-  QgsDebugMsg( "Failed to get name, description, or type for " + myLib.fileName() );
+  QgsDebugMsg( "Failed to get name, description, category or type for " + myLib.fileName() );
   return false;
 }
 
@@ -471,7 +473,7 @@ bool QgsPluginRegistry::checkPythonPlugin( QString packageName )
   if ( !mPythonUtils->loadPlugin( packageName ) )
     return false;
 
-  QString pluginName, description, version;
+  QString pluginName, description, category, version;
 
   // get information from the plugin
   // if there are some problems, don't continue with metadata retreival
@@ -481,6 +483,8 @@ bool QgsPluginRegistry::checkPythonPlugin( QString packageName )
     description = mPythonUtils->getPluginMetadata( packageName, "description" );
     if ( description != "__error__" )
       version = mPythonUtils->getPluginMetadata( packageName, "version" );
+    // for Python plugins category still optional, by default used "Plugins" category
+    //category = mPythonUtils->getPluginMetadata( packageName, "category" );
   }
 
   if ( pluginName == "__error__" || description == "__error__" || version == "__error__" )

src/gui/qgsdetaileditemdata.cpp

@@ -36,18 +36,26 @@ void QgsDetailedItemData::setDetail( const QString theDetail )
   mDetail = theDetail;
 }
 
+void QgsDetailedItemData::setCategory( const QString theCategory )
+{
+  mCategory = theCategory;
+}
+
 void QgsDetailedItemData::setIcon( const QPixmap theIcon )
 {
   mPixmap = theIcon;
 }
+
 void QgsDetailedItemData::setCheckable( const bool theFlag )
 {
   mCheckableFlag = theFlag;
 }
+
 void QgsDetailedItemData::setChecked( const bool theFlag )
 {
   mCheckedFlag = theFlag;
 }
+
 void QgsDetailedItemData::setRenderAsWidget( const bool theFlag )
 {
   mRenderAsWidgetFlag = theFlag;
@@ -63,6 +71,11 @@ QString QgsDetailedItemData::detail() const
   return mDetail;
 }
 
+QString QgsDetailedItemData::category() const
+{
+  return mCategory;
+}
+
 QPixmap QgsDetailedItemData::icon() const
 {
   return mPixmap;