support setting a custom name from applets (e.g. a timezone for a clock ;)

applet.cpp

@@ -487,6 +487,10 @@ bool Applet::isBusy() const
 
 QString Applet::name() const
 {
+    if (!d->customName.isEmpty()) {
+        return d->customName;
+    }
+
     if (d->isContainment) {
         const Containment *c = qobject_cast<const Containment*>(this);
         if (c && c->d->isPanelContainment()) {
@@ -503,6 +507,11 @@ QString Applet::name() const
     return d->appletDescription.name();
 }
 
+void Applet::setName(const QString &name) const
+{
+    d->customName = name;
+}
+
 QFont Applet::font() const
 {
     return QApplication::font();

applet.h

@@ -74,7 +74,7 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
 {
     Q_OBJECT
     Q_PROPERTY(bool hasConfigurationInterface READ hasConfigurationInterface)
-    Q_PROPERTY(QString name READ name)
+    Q_PROPERTY(QString name READ name WRITE setName)
     Q_PROPERTY(QString pluginName READ pluginName)
     Q_PROPERTY(QString category READ category)
     Q_PROPERTY(ImmutabilityType immutability READ immutability WRITE setImmutability)
@@ -354,12 +354,18 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
 
         /**
          * Returns the user-visible name for the applet, as specified in the
-         * .desktop file.
+         * .desktop file. Can be changed with @see setName
          *
          * @return the user-visible name for the applet.
          **/
         QString name() const;
 
+        /**
+         * Sets a custom name for this instance of the applet. E.g. a clock might
+         * use the timezone as its name rather than the .desktop file
+         */
+        void setName(const QString &name) const;
+
         /**
          * @return the font currently set for this widget
          **/

private/applet_p.h

@@ -148,6 +148,7 @@ public:
     // applet info we keep around in case its needed
     KPluginInfo appletDescription;
     QVariantList args;
+    QString name;
 
     // bookkeeping
     QSet<QGraphicsItem*> registeredAsDragHandle;