/* * Copyright 2005 by Aaron Seigo * Copyright 2007 by Riccardo Iaconelli * Copyright 2008 by Ménard Alexis * Copyright (c) 2009 Chani Armitage * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU Library General Public License as * published by the Free Software Foundation; either version 2, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details * * You should have received a copy of the GNU Library General Public * License along with this program; if not, write to the * Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ #include "applet.h" #include "private/applet_p.h" #include "config-plasma.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #if !PLASMA_NO_KUTILS #include #include #else #include #endif #if !PLASMA_NO_SOLID #include #endif #include "authorizationrule.h" #include "configloader.h" #include "containment.h" #include "corona.h" #include "dialog.h" #include "package.h" #include "plasma.h" #include "scripting/appletscript.h" #include "svg.h" #include "framesvg.h" #include "private/framesvg_p.h" #include "remote/authorizationmanager.h" #include "remote/authorizationmanager_p.h" #include "theme.h" #include "wallpaper.h" #include "paintutils.h" #include "abstractdialogmanager.h" #include "pluginloader.h" #include "private/associatedapplicationmanager_p.h" #include "private/containment_p.h" #include "private/package_p.h" #include "private/packages_p.h" #include "private/plasmoidservice_p.h" #include "private/remotedataengine_p.h" #include "private/service_p.h" #include "ui_publish.h" namespace Plasma { Applet::Applet(const KPluginInfo &info, QObject *parent, uint appletId) : QObject(parent), d(new AppletPrivate(KService::Ptr(), &info, appletId, this)) { // WARNING: do not access config() OR globalConfig() in this method! // that requires a scene, which is not available at this point d->init(); } Applet::Applet(QObject *parent, const QString &serviceID, uint appletId) : QObject(parent), d(new AppletPrivate(KService::serviceByStorageId(serviceID), 0, appletId, this)) { // WARNING: do not access config() OR globalConfig() in this method! // that requires a scene, which is not available at this point d->init(); } Applet::Applet(QObject *parent, const QString &serviceID, uint appletId, const QVariantList &args) : QObject(parent), d(new AppletPrivate(KService::serviceByStorageId(serviceID), 0, appletId, this)) { // WARNING: do not access config() OR globalConfig() in this method! // that requires a scene, which is not available at this point QVariantList &mutableArgs = const_cast(args); if (!mutableArgs.isEmpty()) { mutableArgs.removeFirst(); if (!mutableArgs.isEmpty()) { mutableArgs.removeFirst(); } } d->args = mutableArgs; d->init(); } Applet::Applet(QObject *parentObject, const QVariantList &args) : QObject(0), d(new AppletPrivate( KService::serviceByStorageId(args.count() > 0 ? args[0].toString() : QString()), 0, args.count() > 1 ? args[1].toInt() : 0, this)) { // now remove those first two items since those are managed by Applet and subclasses shouldn't // need to worry about them. yes, it violates the constness of this var, but it lets us add // or remove items later while applets can just pretend that their args always start at 0 QVariantList &mutableArgs = const_cast(args); if (!mutableArgs.isEmpty()) { mutableArgs.removeFirst(); if (!mutableArgs.isEmpty()) { mutableArgs.removeFirst(); } } d->args = mutableArgs; setParent(parentObject); // WARNING: do not access config() OR globalConfig() in this method! // that requires a scene, which is not available at this point d->init(); // the brain damage seen in the initialization list is due to the // inflexibility of KService::createInstance } Applet::Applet(const QString &packagePath, uint appletId, const QVariantList &args) : QObject(0), d(new AppletPrivate(KService::Ptr(new KService(packagePath + "/metadata.desktop")), 0, appletId, this)) { Q_UNUSED(args) // FIXME? d->init(packagePath); } Applet::~Applet() { //let people know that i will die emit appletDeleted(this); // clean up our config dialog, if any delete KConfigDialog::exists(d->configDialogId()); delete d; } void Applet::init() { if (d->script) { d->setupScriptSupport(); if (!d->script->init() && !d->failed) { setFailedToLaunch(true, i18n("Script initialization failed")); } } } uint Applet::id() const { return d->appletId; } void Applet::save(KConfigGroup &g) const { if (d->transient) { return; } KConfigGroup group = g; if (!group.isValid()) { group = *d->mainConfigGroup(); } //kDebug() << "saving" << pluginName() << "to" << group.name(); // we call the dptr member directly for locked since isImmutable() // also checks kiosk and parent containers group.writeEntry("immutability", (int)d->immutability); group.writeEntry("plugin", pluginName()); if (!d->started) { return; } KConfigGroup appletConfigGroup(&group, "Configuration"); saveState(appletConfigGroup); if (d->configLoader) { // we're saving so we know its changed, we don't need or want the configChanged // signal bubbling up at this point due to that disconnect(d->configLoader, SIGNAL(configChanged()), this, SLOT(propagateConfigChanged())); d->configLoader->writeConfig(); connect(d->configLoader, SIGNAL(configChanged()), this, SLOT(propagateConfigChanged())); } } void Applet::restore(KConfigGroup &group) { setImmutability((ImmutabilityType)group.readEntry("immutability", (int)Mutable)); KConfigGroup shortcutConfig(&group, "Shortcuts"); QString shortcutText = shortcutConfig.readEntryUntranslated("global", QString()); if (!shortcutText.isEmpty()) { setGlobalShortcut(KShortcut(shortcutText)); /* #ifndef NDEBUG kDebug() << "got global shortcut for" << name() << "of" << QKeySequence(shortcutText); #endif #ifndef NDEBUG kDebug() << "set to" << d->activationAction->objectName() #endif << d->activationAction->globalShortcut().primary(); */ } // local shortcut, if any //TODO: implement; the shortcut will need to be registered with the containment /* #include "accessmanager.h" #include "private/plasmoidservice_p.h" #include "authorizationmanager.h" #include "authorizationmanager.h" shortcutText = shortcutConfig.readEntryUntranslated("local", QString()); if (!shortcutText.isEmpty()) { //TODO: implement; the shortcut } */ } void Applet::setFailedToLaunch(bool failed, const QString &reason) { d->failed = failed; d->updateFailedToLaunch(reason); } void Applet::saveState(KConfigGroup &group) const { if (d->script) { emit d->script->saveState(group); } if (group.config()->name() != config().config()->name()) { // we're being saved to a different file! // let's just copy the current values in our configuration over KConfigGroup c = config(); c.copyTo(&group); } } KConfigGroup Applet::config() const { if (d->transient) { return KConfigGroup(KSharedConfig::openConfig(), "PlasmaTransientsConfig"); } if (d->isContainment) { return *(d->mainConfigGroup()); } return KConfigGroup(d->mainConfigGroup(), "Configuration"); } KConfigGroup Applet::globalConfig() const { KConfigGroup globalAppletConfig; QString group = isContainment() ? "ContainmentGlobals" : "AppletGlobals"; Containment *cont = containment(); Corona *corona = 0; if (cont) { corona = cont->corona(); } if (corona) { KSharedConfig::Ptr coronaConfig = corona->config(); globalAppletConfig = KConfigGroup(coronaConfig, group); } else { globalAppletConfig = KConfigGroup(KSharedConfig::openConfig(), group); } return KConfigGroup(&globalAppletConfig, d->globalName()); } bool Applet::hasFocus() const { return false; } void Applet::setFocus(Qt::FocusReason) { } void Applet::destroy() { if (immutability() != Mutable || d->transient || !d->started) { return; //don't double delete } d->transient = true; //FIXME: an animation on leave if !isContainment() would be good again .. which should be handled by the containment class d->cleanUpAndDelete(); } bool Applet::destroyed() const { return d->transient; } ConfigLoader *Applet::configScheme() const { return d->configLoader; } DataEngine *Applet::dataEngine(const QString &name) const { return d->dataEngine(name, d->remoteLocation); } Package Applet::package() const { return d->package ? *d->package : Package(); } QPoint Applet::popupPosition(const QSize &s) const { return popupPosition(s, Qt::AlignLeft); } QPoint Applet::popupPosition(const QSize &s, Qt::AlignmentFlag alignment) const { Containment *cont = containment(); Corona *corona = 0; if (cont) { corona = cont->corona(); } Q_ASSERT(corona); return QPoint(); //FIXME: port away from QGV //return corona->popupPosition(this, s, alignment); } void Applet::updateConstraints(Plasma::Constraints constraints) { d->scheduleConstraintsUpdate(constraints); } void Applet::constraintsEvent(Plasma::Constraints constraints) { //NOTE: do NOT put any code in here that reacts to constraints updates // as it will not get called for any applet that reimplements constraintsEvent // without calling the Applet:: version as well, which it shouldn't need to. // INSTEAD put such code into flushPendingConstraintsEvents Q_UNUSED(constraints) //kDebug() << constraints << "constraints are FormFactor: " << formFactor() // << ", Location: " << location(); if (d->script) { d->script->constraintsEvent(constraints); } } void Applet::setBusy(bool busy) { d->setBusy(busy); } bool Applet::isBusy() const { return d->isBusy(); } QString Applet::name() const { if (!d->customName.isEmpty()) { return d->customName; } if (d->isContainment) { const Containment *c = qobject_cast(this); if (c && c->d->isPanelContainment()) { return i18n("Panel"); } else if (!d->appletDescription.isValid()) { return i18n("Unknown"); } else { return d->appletDescription.name(); } } else if (!d->appletDescription.isValid()) { return i18n("Unknown Widget"); } return d->appletDescription.name(); } void Applet::setName(const QString &name) const { d->customName = name; } QFont Applet::font() const { return QApplication::font(); } QString Applet::icon() const { if (!d->appletDescription.isValid()) { return QString(); } return d->appletDescription.icon(); } QString Applet::pluginName() const { if (!d->appletDescription.isValid()) { return d->mainConfigGroup()->readEntry("plugin", QString()); } return d->appletDescription.pluginName(); } bool Applet::shouldConserveResources() const { #if !PLASMA_NO_SOLID return Solid::PowerManagement::appShouldConserveResources(); #else return true; #endif } QString Applet::category() const { if (!d->appletDescription.isValid()) { return i18nc("misc category", "Miscellaneous"); } return d->appletDescription.category(); } QString Applet::category(const KPluginInfo &applet) { return applet.property("X-KDE-PluginInfo-Category").toString(); } QString Applet::category(const QString &appletName) { if (appletName.isEmpty()) { return QString(); } const QString constraint = QString("[X-KDE-PluginInfo-Name] == '%1'").arg(appletName); KService::List offers = KServiceTypeTrader::self()->query("Plasma/Applet", constraint); if (offers.isEmpty()) { return QString(); } return offers.first()->property("X-KDE-PluginInfo-Category").toString(); } ImmutabilityType Applet::immutability() const { // if this object is itself system immutable, then just return that; it's the most // restrictive setting possible and will override anything that might be happening above it // in the Corona->Containment->Applet hierarchy if (d->transient || (d->mainConfig && d->mainConfig->isImmutable())) { return SystemImmutable; } //Returning the more strict immutability between the applet immutability, Containment and Corona ImmutabilityType upperImmutability = Mutable; Containment *cont = d->isContainment ? 0 : containment(); if (cont) { upperImmutability = cont->immutability(); } if (upperImmutability != Mutable) { // it's either system or user immutable, and we already check for local system immutability, // so upperImmutability is guaranteed to be as or more severe as this object's immutability return upperImmutability; } else { return d->immutability; } } void Applet::setImmutability(const ImmutabilityType immutable) { if (d->immutability == immutable || immutable == Plasma::SystemImmutable) { // we do not store system immutability in d->immutability since that gets saved // out to the config file; instead, we check with // the config group itself for this information at all times. this differs from // corona, where SystemImmutability is stored in d->immutability. return; } d->immutability = immutable; updateConstraints(ImmutableConstraint); } BackgroundHints Applet::backgroundHints() const { return d->backgroundHints; } void Applet::setBackgroundHints(const Plasma::BackgroundHints hints) { if (d->backgroundHints == hints) { return; } d->backgroundHints = hints; } bool Applet::hasFailedToLaunch() const { return d->failed; } bool Applet::configurationRequired() const { return d->needsConfig; } void Applet::setConfigurationRequired(bool needsConfig, const QString &reason) { if (d->needsConfig == needsConfig) { return; } d->needsConfig = needsConfig; d->showConfigurationRequiredMessage(needsConfig, reason); } void Applet::showMessage(const QIcon &icon, const QString &message, const MessageButtons buttons) { d->showMessage(icon, message, buttons); } QVariantList Applet::startupArguments() const { return d->args; } ItemStatus Applet::status() const { return d->itemStatus; } void Applet::setStatus(const ItemStatus status) { d->itemStatus = status; emit newStatus(status); } void Applet::flushPendingConstraintsEvents() { if (d->pendingConstraints == NoConstraint) { return; } if (d->constraintsTimer.isActive()) { d->constraintsTimer.stop(); } //kDebug() << "fushing constraints: " << d->pendingConstraints << "!!!!!!!!!!!!!!!!!!!!!!!!!!!"; Plasma::Constraints c = d->pendingConstraints; d->pendingConstraints = NoConstraint; if (c & Plasma::StartupCompletedConstraint) { //common actions bool unlocked = immutability() == Mutable; QAction *closeApplet = d->actions->action("remove"); if (closeApplet) { closeApplet->setEnabled(unlocked); closeApplet->setVisible(unlocked); connect(closeApplet, SIGNAL(triggered(bool)), this, SLOT(destroy()), Qt::UniqueConnection); } QAction *configAction = d->actions->action("configure"); if (configAction) { if (d->isContainment) { connect(configAction, SIGNAL(triggered(bool)), this, SLOT(requestConfiguration()), Qt::UniqueConnection); } else { connect(configAction, SIGNAL(triggered(bool)), this, SLOT(showConfigurationInterface()), Qt::UniqueConnection); } if (d->hasConfigurationInterface) { bool canConfig = unlocked || KAuthorized::authorize("plasma/allow_configure_when_locked"); configAction->setVisible(canConfig); configAction->setEnabled(canConfig); } } QAction *runAssociatedApplication = d->actions->action("run associated application"); if (runAssociatedApplication) { connect(runAssociatedApplication, SIGNAL(triggered(bool)), this, SLOT(runAssociatedApplication()), Qt::UniqueConnection); } d->updateShortcuts(); Containment *cont = containment(); Corona *corona = 0; if (cont) { corona = cont->corona(); } if (corona) { connect(corona, SIGNAL(shortcutsChanged()), this, SLOT(updateShortcuts()), Qt::UniqueConnection); } } if (c & Plasma::ImmutableConstraint) { bool unlocked = immutability() == Mutable; QAction *action = d->actions->action("remove"); if (action) { action->setVisible(unlocked); action->setEnabled(unlocked); } action = d->actions->action("configure"); if (action && d->hasConfigurationInterface) { bool canConfig = unlocked || KAuthorized::authorize("plasma/allow_configure_when_locked"); action->setVisible(canConfig); action->setEnabled(canConfig); } emit immutabilityChanged(immutability()); } if (c & Plasma::SizeConstraint) { d->positionMessageOverlay(); } if (c & Plasma::FormFactorConstraint) { FormFactor f = formFactor(); } // now take care of constraints in special subclasses: Contaiment and PopupApplet Containment* containment = qobject_cast(this); if (d->isContainment && containment) { containment->d->containmentConstraintsEvent(c); } //FIXME: port away from popupapplet /* PopupApplet* popup = qobject_cast(this); if (popup) { popup->d->popupConstraintsEvent(c); }*/ // pass the constraint on to the actual subclass constraintsEvent(c); if (c & StartupCompletedConstraint) { // start up is done, we can now go do a mod timer if (d->modificationsTimer) { if (d->modificationsTimer->isActive()) { d->modificationsTimer->stop(); } } else { d->modificationsTimer = new QBasicTimer; } } } QList Applet::contextualActions() { //kDebug() << "empty context actions"; return d->script ? d->script->contextualActions() : QList(); } QAction *Applet::action(QString name) const { return d->actions->action(name); } void Applet::addAction(QString name, QAction *action) { d->actions->addAction(name, action); } FormFactor Applet::formFactor() const { Containment *c = containment(); QObject *pw = qobject_cast(parent()); Plasma::Applet *parentApplet = qobject_cast(pw); //assumption: this loop is usually is -really- short or doesn't run at all while (!parentApplet && pw && pw->parent()) { pw = pw->parent(); parentApplet = qobject_cast(pw); } return c ? c->d->formFactor : Plasma::Planar; } Containment *Applet::containment() const { if (d->isContainment) { Containment *c = qobject_cast(const_cast(this)); if (c) { return c; } } QObject *parent = this->parent(); Containment *c = 0; while (parent) { Containment *possibleC = dynamic_cast(parent); if (possibleC && possibleC->Applet::d->isContainment) { c = possibleC; break; } parent = parent->parent(); } if (!c) { //if the applet is an offscreen widget its parentItem will be 0, while its parent //will be its parentWidget, so here we check the QObject hierarchy. QObject *objParent = this->parent(); while (objParent) { Containment *possibleC = qobject_cast(objParent); if (possibleC && possibleC->Applet::d->isContainment) { c = possibleC; break; } objParent = objParent->parent(); } } return c; } void Applet::setGlobalShortcut(const KShortcut &shortcut) { if (!d->activationAction) { d->activationAction = new KAction(this); d->activationAction->setText(i18n("Activate %1 Widget", name())); d->activationAction->setObjectName(QString("activate widget %1").arg(id())); // NO I18N connect(d->activationAction, SIGNAL(triggered()), this, SIGNAL(activate())); connect(d->activationAction, SIGNAL(globalShortcutChanged(QKeySequence)), this, SLOT(globalShortcutChanged())); QList widgets = d->actions->associatedWidgets(); foreach (QWidget *w, widgets) { w->addAction(d->activationAction); } } else if (d->activationAction->globalShortcut() == shortcut) { return; } //kDebug() << "before" << shortcut.primary() << d->activationAction->globalShortcut().primary(); d->activationAction->setGlobalShortcut( shortcut, KAction::ShortcutTypes(KAction::ActiveShortcut | KAction::DefaultShortcut), KAction::NoAutoloading); d->globalShortcutChanged(); } KShortcut Applet::globalShortcut() const { if (d->activationAction) { return d->activationAction->globalShortcut(); } return KShortcut(); } bool Applet::isPopupShowing() const { return false; } void Applet::addAssociatedWidget(QWidget *widget) { d->actions->addAssociatedWidget(widget); } void Applet::removeAssociatedWidget(QWidget *widget) { d->actions->removeAssociatedWidget(widget); } Location Applet::location() const { Containment *c = containment(); return c ? c->d->location : Plasma::Desktop; } Plasma::AspectRatioMode Applet::aspectRatioMode() const { return d->aspectRatioMode; } void Applet::setAspectRatioMode(Plasma::AspectRatioMode mode) { //FIXME: port away from popupapplet /* PopupApplet *popup = qobject_cast(this); if (popup && popup->d->dialogPtr) { popup->d->dialogPtr.data()->setAspectRatioMode(mode); popup->d->savedAspectRatio = mode; }*/ d->aspectRatioMode = mode; } bool Applet::hasConfigurationInterface() const { return d->hasConfigurationInterface; } void Applet::publish(AnnouncementMethods methods, const QString &resourceName) { if (!d->remotingService) { d->remotingService = new PlasmoidService(this); } const QString resName = resourceName.isEmpty() ? i18nc("%1 is the name of a plasmoid, %2 the name of the machine that plasmoid is published on", "%1 on %2", name(), QHostInfo::localHostName()) : resourceName; #ifndef NDEBUG kDebug() << "publishing package under name " << resName; #endif if (d->package && d->package->isValid()) { d->remotingService->d->publish(methods, resName, d->package->metadata()); } else if (!d->package && d->appletDescription.isValid()) { d->remotingService->d->publish(methods, resName, d->appletDescription); } else { delete d->remotingService; d->remotingService = 0; #ifndef NDEBUG kDebug() << "Can not publish invalid applets."; #endif } } void Applet::unpublish() { if (d->remotingService) { d->remotingService->d->unpublish(); } } bool Applet::isPublished() const { return d->remotingService && d->remotingService->d->isPublished(); } void Applet::setHasConfigurationInterface(bool hasInterface) { if (hasInterface == d->hasConfigurationInterface) { return; } QAction *configAction = d->actions->action("configure"); if (configAction) { bool enable = hasInterface; if (enable) { const bool unlocked = immutability() == Mutable; enable = unlocked || KAuthorized::authorize("plasma/allow_configure_when_locked"); } configAction->setEnabled(enable); } d->hasConfigurationInterface = hasInterface; } bool Applet::isUserConfiguring() const { return KConfigDialog::exists(d->configDialogId()); } void Applet::showConfigurationInterface() { if (!hasConfigurationInterface()) { return; } if (immutability() != Mutable && !KAuthorized::authorize("plasma/allow_configure_when_locked")) { return; } KConfigDialog *dlg = KConfigDialog::exists(d->configDialogId()); if (dlg) { KWindowSystem::setOnDesktop(dlg->winId(), KWindowSystem::currentDesktop()); dlg->show(); KWindowSystem::activateWindow(dlg->winId()); return; } d->publishUI.publishCheckbox = 0; if (d->package) { KConfigDialog *dialog = 0; const QString uiFile = d->package->filePath("mainconfigui"); KDesktopFile df(d->package->path() + "/metadata.desktop"); const QStringList kcmPlugins = df.desktopGroup().readEntry("X-Plasma-ConfigPlugins", QStringList()); if (!uiFile.isEmpty() || !kcmPlugins.isEmpty()) { KConfigSkeleton *configLoader = d->configLoader ? d->configLoader : new KConfigSkeleton(0); dialog = new AppletConfigDialog(0, d->configDialogId(), configLoader); if (!d->configLoader) { // delete the temporary when this dialog is done configLoader->setParent(dialog); } dialog->setWindowTitle(d->configWindowTitle()); dialog->setAttribute(Qt::WA_DeleteOnClose, true); bool hasPages = false; QFile f(uiFile); QUiLoader loader; QWidget *w = loader.load(&f); if (w) { dialog->addPage(w, i18n("Settings"), icon(), i18n("%1 Settings", name())); hasPages = true; } foreach (const QString &kcm, kcmPlugins) { #if !PLASMA_NO_KUTILS KCModuleProxy *module = new KCModuleProxy(kcm); if (module->realModule()) { //preemptively load modules to prevent save() crashing on some kcms, like powerdevil ones module->load(); connect(module, SIGNAL(changed(bool)), dialog, SLOT(settingsModified(bool))); connect(dialog, SIGNAL(okClicked()), module->realModule(), SLOT(save())); connect(dialog, SIGNAL(applyClicked()), module->realModule(), SLOT(save())); dialog->addPage(module, module->moduleInfo().moduleName(), module->moduleInfo().icon()); hasPages = true; } else { delete module; } #else KService::Ptr service = KService::serviceByStorageId(kcm); if (service) { QString error; KCModule *module = service->createInstance(dialog, QVariantList(), &error); if (module) { module->load(); connect(module, SIGNAL(changed(bool)), dialog, SLOT(settingsModified(bool))); connect(dialog, SIGNAL(okClicked()), module, SLOT(save())); connect(dialog, SIGNAL(applyClicked()), module, SLOT(save())); dialog->addPage(module, service->name(), service->icon()); hasPages = true; } else { #ifndef NDEBUG kDebug() << "failed to load kcm" << kcm << "for" << name(); #endif } } #endif } if (hasPages) { d->addGlobalShortcutsPage(dialog); d->addPublishPage(dialog); dialog->show(); } else { delete dialog; dialog = 0; } } if (!dialog && d->script) { d->script->showConfigurationInterface(); } } else if (d->script) { d->script->showConfigurationInterface(); } else { KConfigDialog *dialog = d->generateGenericConfigDialog(); d->addStandardConfigurationPages(dialog); showConfigurationInterface(dialog); } emit releaseVisualFocus(); } void Applet::showConfigurationInterface(QWidget *widget) { if (!containment() || !containment()->corona() || !containment()->corona()->dialogManager()) { widget->show(); return; } QMetaObject::invokeMethod(containment()->corona()->dialogManager(), "showDialog", Q_ARG(QWidget *, widget), Q_ARG(Plasma::Applet *, this)); } void Applet::configChanged() { if (d->script) { if (d->configLoader) { d->configLoader->readConfig(); } d->script->configChanged(); } } void Applet::createConfigurationInterface(KConfigDialog *parent) { Q_UNUSED(parent) // virtual method reimplemented by subclasses. // do not put anything here ... } bool Applet::hasAuthorization(const QString &constraint) const { KConfigGroup constraintGroup(KSharedConfig::openConfig(), "Constraints"); return constraintGroup.readEntry(constraint, true); } void Applet::setAssociatedApplication(const QString &string) { AssociatedApplicationManager::self()->setApplication(this, string); QAction *runAssociatedApplication = d->actions->action("run associated application"); if (runAssociatedApplication) { bool valid = AssociatedApplicationManager::self()->appletHasValidAssociatedApplication(this); valid = valid && hasAuthorization("LaunchApp"); //obey security! runAssociatedApplication->setVisible(valid); runAssociatedApplication->setEnabled(valid); } } void Applet::setAssociatedApplicationUrls(const QList &urls) { AssociatedApplicationManager::self()->setUrls(this, urls); QAction *runAssociatedApplication = d->actions->action("run associated application"); if (runAssociatedApplication) { bool valid = AssociatedApplicationManager::self()->appletHasValidAssociatedApplication(this); valid = valid && hasAuthorization("LaunchApp"); //obey security! runAssociatedApplication->setVisible(valid); runAssociatedApplication->setEnabled(valid); } } QString Applet::associatedApplication() const { return AssociatedApplicationManager::self()->application(this); } QList Applet::associatedApplicationUrls() const { return AssociatedApplicationManager::self()->urls(this); } void Applet::runAssociatedApplication() { if (hasAuthorization("LaunchApp")) { AssociatedApplicationManager::self()->run(this); } } bool Applet::hasValidAssociatedApplication() const { return AssociatedApplicationManager::self()->appletHasValidAssociatedApplication(this); } KPluginInfo::List Applet::listAppletInfo(const QString &category, const QString &parentApp) { return PluginLoader::self()->listAppletInfo(category, parentApp); } KPluginInfo::List Applet::listAppletInfoForMimeType(const QString &mimeType) { QString constraint = AppletPrivate::parentAppConstraint(); constraint.append(QString(" and '%1' in [X-Plasma-DropMimeTypes]").arg(mimeType)); //kDebug() << "listAppletInfoForMimetype with" << mimeType << constraint; KService::List offers = KServiceTypeTrader::self()->query("Plasma/Applet", constraint); AppletPrivate::filterOffers(offers); return KPluginInfo::fromServices(offers); } KPluginInfo::List Applet::listAppletInfoForUrl(const QUrl &url) { QString constraint = AppletPrivate::parentAppConstraint(); constraint.append(" and exist [X-Plasma-DropUrlPatterns]"); KService::List offers = KServiceTypeTrader::self()->query("Plasma/Applet", constraint); AppletPrivate::filterOffers(offers); KPluginInfo::List allApplets = KPluginInfo::fromServices(offers); KPluginInfo::List filtered; foreach (const KPluginInfo &info, allApplets) { QStringList urlPatterns = info.property("X-Plasma-DropUrlPatterns").toStringList(); foreach (const QString &glob, urlPatterns) { QRegExp rx(glob); rx.setPatternSyntax(QRegExp::Wildcard); if (rx.exactMatch(url.toString())) { #ifndef NDEBUG kDebug() << info.name() << "matches" << glob << url; #endif filtered << info; } } } return filtered; } QStringList Applet::listCategories(const QString &parentApp, bool visibleOnly) { QString constraint = AppletPrivate::parentAppConstraint(parentApp); constraint.append(" and exist [X-KDE-PluginInfo-Category]"); KConfigGroup group(KSharedConfig::openConfig(), "General"); const QStringList excluded = group.readEntry("ExcludeCategories", QStringList()); foreach (const QString &category, excluded) { constraint.append(" and [X-KDE-PluginInfo-Category] != '").append(category).append("'"); } KService::List offers = KServiceTypeTrader::self()->query("Plasma/Applet", constraint); AppletPrivate::filterOffers(offers); QStringList categories; QSet known = AppletPrivate::knownCategories(); foreach (const KService::Ptr &applet, offers) { QString appletCategory = applet->property("X-KDE-PluginInfo-Category").toString(); if (visibleOnly && applet->noDisplay()) { // we don't want to show the hidden category continue; } //kDebug() << " and we have " << appletCategory; if (!appletCategory.isEmpty() && !known.contains(appletCategory.toLower())) { #ifndef NDEBUG kDebug() << "Unknown category: " << applet->name() << "says it is in the" << appletCategory << "category which is unknown to us"; #endif appletCategory.clear(); } if (appletCategory.isEmpty()) { if (!categories.contains(i18nc("misc category", "Miscellaneous"))) { categories << i18nc("misc category", "Miscellaneous"); } } else if (!categories.contains(appletCategory)) { categories << appletCategory; } } categories.sort(); return categories; } void Applet::setCustomCategories(const QStringList &categories) { AppletPrivate::s_customCategories = QSet::fromList(categories); } QStringList Applet::customCategories() { return AppletPrivate::s_customCategories.toList(); } Applet *Applet::loadPlasmoid(const QString &path, uint appletId, const QVariantList &args) { if (QFile::exists(path + "/metadata.desktop")) { KService service(path + "/metadata.desktop"); const QStringList &types = service.serviceTypes(); if (types.contains("Plasma/Containment")) { return new Containment(path, appletId, args); }//FIXME: port away popupapplet /* else if (types.contains("Plasma/PopupApplet")) { return new PopupApplet(path, appletId, args); }*/ else { return new Applet(path, appletId, args); } } return 0; } void Applet::timerEvent(QTimerEvent *event) { if (d->transient) { d->constraintsTimer.stop(); if (d->modificationsTimer) { d->modificationsTimer->stop(); } return; } if (event->timerId() == d->constraintsTimer.timerId()) { d->constraintsTimer.stop(); // Don't flushPendingConstraints if we're just starting up // flushPendingConstraints will be called by Corona if(!(d->pendingConstraints & Plasma::StartupCompletedConstraint)) { flushPendingConstraintsEvents(); } } else if (d->modificationsTimer && event->timerId() == d->modificationsTimer->timerId()) { d->modificationsTimer->stop(); // invalid group, will result in save using the default group KConfigGroup cg; save(cg); emit configNeedsSaving(); } } bool Applet::isContainment() const { return d->isContainment; } // PRIVATE CLASS IMPLEMENTATION void ContainmentPrivate::checkRemoveAction() { q->enableAction("remove", q->immutability() == Mutable); } } // Plasma namespace #include "moc_applet.cpp" #include "private/moc_applet_p.cpp"