File indexing completed on 2023-09-24 04:14:57

 /*
     SPDX-FileCopyrightText: 2010 Ryan Rix <ry@n.rix.si>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #ifndef PLUGIN_LOADER_H
 #define PLUGIN_LOADER_H
 
 #include <plasma/plasma_export.h>
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 94)
 #include <KPluginInfo>
 #include <plasma/package.h>
 #else
 class KPluginInfo;
 #endif
 
 #include <plasma/plasma.h>
 
 #include <QVariant>
 
 class KPluginMetaData;
 namespace Plasma
 {
 class Applet;
 class Containment;
 class ContainmentActions;
 class DataEngine;
 class Service;
 
 #if PLASMA_BUILD_DEPRECATED_SINCE(5, 86)
 class Package; // FWD class so that excluding deprecated API does not cause an unknown type
 #endif
 
 class PluginLoaderPrivate;
 
 // TODO:
 // * add loadWallpaper
 // * add KPluginInfo listing support for Containments (already loaded via the applet loading code)
 
 /**
  * @class PluginLoader plasma/pluginloader.h <Plasma/PluginLoader>
  *
  * This is an abstract base class which defines an interface to which Plasma's
  * Applet Loading logic can communicate with a parent application. The plugin loader
  * must be set before any plugins are loaded, otherwise (for safety reasons), the
  * default PluginLoader implementation will be used. The reimplemented version should
  * not do more than simply returning a loaded plugin. It should not init() it, and it should not
  * hang on to it. The associated methods will be called only when a component of Plasma
  * needs to load a _new_ plugin. (e.g. DataEngine does its own caching).
  *
  * @author Ryan Rix <ry@n.rix.si>
  * @since 4.6
  **/
 class PLASMA_EXPORT PluginLoader
 {
 public:
     /**
      * Load an Applet plugin.
      *
      * @param name the plugin name, as returned by KPluginInfo::pluginName()
      * @param appletId unique ID to assign the applet, or zero to have one
      *        assigned automatically.
      * @param args to send the applet extra arguments
      * @return a pointer to the loaded applet, or 0 on load failure
      **/
     Applet *loadApplet(const QString &name, uint appletId = 0, const QVariantList &args = QVariantList());
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 94)
     /**
      * Load a dataengine plugin.
      *
      * @param name the name of the engine
      * @return the dataengine that was loaded, or the NullEngine on failure.
      * @deprecated Since 5.94, Dataengines are being phased out, please port away from them if possible
      * or load the plugin from the "plasma/dataengine" namespace manually using KPluginMetaData/KPluginFactory
      */
     PLASMA_DEPRECATED_VERSION(
         5,
         94,
         "Dataengines are being phased out, please port away from them if possible or load the plugin from the \"plasma/dataengine\" namespace manually")
     DataEngine *loadDataEngine(const QString &name);
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 94)
     /**
      * @return a listing of all known dataengines by name
      *
      * @param parentApp the application to filter dataengines on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all dataengines.
      * @deprecated Since 5.94, Dataengines are being phased out, please port away from them if possible
      * or query the plugins in the "plasma/dataengine" namespace manually using KPluginMetaData
      */
     PLASMA_DEPRECATED_VERSION(
         5,
         94,
         "Dataengines are being phased out, please port away from them if possible or query the plugins in the \"plasma/dataengine\" namespace manually")
     static QStringList listAllEngines(const QString &parentApp = QString());
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 77)
     /**
      * Returns a list of all known dataengines.
      *
      * @param parentApp the application to filter dataengines on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all dataengines.
      * @return list of dataengines
      * @deprecated since 5.77, use listDataEngineMetaData instead.
      **/
     PLASMA_DEPRECATED_VERSION(5, 77, "Use listDataEngineMetaData instead")
     static KPluginInfo::List listEngineInfo(const QString &parentApp = QString());
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 81)
     /**
      * Returns a list of all known dataengines filtering by category.
      *
      * @param category the category to filter dataengines on. Uses the
      *                  X-KDE-PluginInfo-Category entry (if any) in the
      *                  plugin info. The value of QString() will
      *                  result in a list of dataengines with an empty category.
      *
      * @param parentApp the application to filter dataengines on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all dataengines in specified categories.
      * @return list of dataengines
      * @deprecated since 5.81, use listDataEngineMetaData() instead.
      * @since 4.3
      **/
     PLASMA_DEPRECATED_VERSION(5, 81, "Use listDataEngineMetaData instead")
     static KPluginInfo::List listEngineInfoByCategory(const QString &category, const QString &parentApp = QString());
 #endif
 
     /**
      * Load a Service plugin.
      *
      * @param name the plugin name of the service to load
      * @param args a list of arguments to supply to the service plugin when loading it
      * @param parent the parent object, if any, for the service
      *
      * @return a Service object, unlike Plasma::Service::loadService, this can return null.
      **/
     Service *loadService(const QString &name, const QVariantList &args, QObject *parent = nullptr);
 
     /**
      * Load a ContainmentActions plugin.
      *
      * Returns a pointer to the containmentactions if successful.
      * The caller takes responsibility for the containmentactions, including
      * deleting it when no longer needed.
      *
      * @param parent the parent containment. @since 4.6 null is allowed.
      * @param name the plugin name, as returned by KPluginInfo::pluginName()
      * @param args to send the containmentactions extra arguments
      * @return a ContainmentActions object
      **/
     ContainmentActions *loadContainmentActions(Containment *parent, const QString &containmentActionsName, const QVariantList &args = QVariantList());
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 30)
     /**
      * Load a Package plugin.
      *
      * @param name the plugin name of the package to load
      * @param specialization used to find script extensions for the given format, e.g. "QML" for "Plasma/Applet"
      *
      * @return a Package object matching name, or an invalid package on failure
      * @deprecated Since 5.30, use KPackage::PackageLoader::loadPackage(const QString& packageFormat, const QString& packagePath) instead.
      **/
     PLASMA_DEPRECATED_VERSION(5, 30, "Use KPackage::PackageLoader::loadPackage(const QString&, const QString&")
     Package loadPackage(const QString &packageFormat, const QString &specialization = QString());
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 28)
     /**
      * Returns a list of all known applets.
      * This may skip applets based on security settings and ExcludeCategories in the application's config.
      *
      * @param category Only applets matching this category will be returned.
      *                 If "Misc" is passed in, then applets without a
      *                 Categories= entry are also returned.
      *                 If an empty string is passed in, all applets are
      *                 returned.
      * @param parentApp the application to filter applets on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all applets in specified category.
      * @return list of applets
      *
      * @deprecated Since 5.28. Doesn't support metadata.json packages.
      * Use listAppletMetaData(const QString &category, const QString &parentApp) instead.
      **/
     PLASMA_DEPRECATED_VERSION(5, 28, "Use PluginLoader::listAppletMetaData(const QString &, const QString &)")
     KPluginInfo::List listAppletInfo(const QString &category, const QString &parentApp = QString());
 #endif
 
     /**
      * Returns a list of all known applets.
      * This may skip applets based on security settings and ExcludeCategories in the application's config.
      *
      * @param category Only applets matching this category will be returned.
      *                 If "Misc" is passed in, then applets without a
      *                 Categories= entry are also returned.
      *                 If an empty string is passed in, all applets are
      *                 returned.
      * @return list of applets
      *
      * @since 5.28
      **/
     QList<KPluginMetaData> listAppletMetaData(const QString &category);
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 88)
     /**
      * @overload
      * @param parentApp the application to filter applets on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all applets in specified categories.
      * @deprecated Since 5.88, use PluginLoader::listAppletMetaData(const QString &category)
      * @since 5.28
      */
     PLASMA_DEPRECATED_VERSION(5, 88, "Use PluginLoader::listAppletMetaData(const QString &category)")
     QList<KPluginMetaData> listAppletMetaData(const QString &category, const QString &parentApp);
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 36)
     /**
      * Returns a list of all known applets associated with a certain mimetype.
      *
      * @return list of applets
      *
      * @deprecated Since 5.36, use listAppletMetaDataForMimeType(const QString &mimetype) instead.
      **/
     PLASMA_DEPRECATED_VERSION(5, 36, "Use PluginLoader::listAppletMetaDataForMimeType(const QString &)")
     KPluginInfo::List listAppletInfoForMimeType(const QString &mimetype);
 #endif
 
     /**
      * Returns a list of all known applets associated with a certain mimetype.
      *
      * @return list of applets
      * @since 5.36
      **/
     QList<KPluginMetaData> listAppletMetaDataForMimeType(const QString &mimetype);
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 36)
     /**
      * Returns a list of all known applets associated with a certain URL.
      *
      * @return list of applets
      *
      * @deprecated Since 5.36, use listAppletMetaDataForUrl(const QUrl &url) instead.
      **/
     PLASMA_DEPRECATED_VERSION(5, 36, "Use PluginLoader::listAppletMetaDataForUrl(const QUrl &)")
     KPluginInfo::List listAppletInfoForUrl(const QUrl &url);
 #endif
 
     /**
      * Returns a list of all known applets associated with a certain URL.
      *
      * @return list of applets
      * @since 5.36
      **/
     QList<KPluginMetaData> listAppletMetaDataForUrl(const QUrl &url);
 
     /**
      * Returns a list of all the categories used by installed applets.
      *
      * @param parentApp the application to filter applets on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all Applets.
      * @return list of categories
      * @param visibleOnly true if it should only return applets that are marked as visible
      */
     QStringList listAppletCategories(const QString &parentApp = QString(), bool visibleOnly = true);
 
     /**
      * Sets the list of custom categories that are used in addition to the default
      * set of categories known to libplasma for applets.
      * @param categories a list of categories
      * @since 4.3
      */
     void setCustomAppletCategories(const QStringList &categories);
 
     /**
      * @return the list of custom categories known to libplasma
      * @since 4.3
      */
     QStringList customAppletCategories() const;
 
     /**
      * Get the category of the given applet
      *
      * @param appletName the name of the applet
      */
     QString appletCategory(const QString &appletName);
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 83)
     /**
      * Returns a list of all known containments.
      *
      * @param category Only containments matching this category will be returned.
      *                 If "Miscellaneous" is passed in, then containments without a
      *                 Categories= entry are also returned.
      *                 If an empty string is passed in, all containments are
      *                 returned.
      * @param parentApp the application to filter containments on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all containments.
      * @deprecated since 5.83, use PluginLoader::listContainmentsMetaData
      * @return list of containments
      **/
     PLASMA_DEPRECATED_VERSION(5, 83, "Use PluginLoader::listContainmentsMetaData")
     static KPluginInfo::List listContainments(const QString &category = QString(), const QString &parentApp = QString());
 #endif
 
     /**
      * Returns a list of all known containments.
      *
      * @param filter An optional predicate that can be used for filtering.
      *
      * @return list of containments
      */
     static QList<KPluginMetaData> listContainmentsMetaData(std::function<bool(const KPluginMetaData &)> filter = {});
 
     /**
      * Returns a list of containments of the specified type.
      *
      * @param type The target containment type
      *
      * @return list of containments
      */
     static QList<KPluginMetaData> listContainmentsMetaDataOfType(const QString &type);
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 83)
     /**
      * Returns a list of all known containments that match the parameters.
      *
      * @param type Only containments with this string in X-Plasma-ContainmentType
      *             in their .desktop files will be returned. Common values are panel and
      *             desktop
      * @param category Only containments matching this category will be returned.
      *                 If "Miscellaneous" is passed in, then containments without a
      *                 Categories= entry are also returned.
      *                 If an empty string is passed in, all containments are
      *                 returned.
      * @param parentApp the application to filter containments on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all containments, matching categories/type.
      * @deprecated since 5.83, use PluginLoader::listContainmentsMetaDataOfType
      * @return list of containments
      **/
     PLASMA_DEPRECATED_VERSION(5, 83, "Use PluginLoader::listContainmentsMetaDataOfType")
     static KPluginInfo::List listContainmentsOfType(const QString &type, const QString &category = QString(), const QString &parentApp = QString());
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 83)
     /**
      * @return a list of all known types of containments on this system
      */
     PLASMA_DEPRECATED_VERSION(5,
                               83,
                               "Use PluginLoader::listContainmentsMetaDataOfType and aggregate the values of the X-Plasma-ContainmentType property instead")
     static QStringList listContainmentTypes();
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 83)
     /**
      * Returns a list of all known containments associated with a certain MimeType
      *
      * @return list of containments
      * @deprecated since 5.83, use listAppletMetaData() with custom filtering instead.
      **/
     PLASMA_DEPRECATED_VERSION(5, 83, "Use listAppletMetaData() with custom filtering")
     static KPluginInfo::List listContainmentsForMimeType(const QString &mimeType);
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 77)
     /**
      * Returns a list of all known dataengines.
      *
      * @param parentApp the application to filter dataengines on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all dataengines
      * @return list of dataengines
      * @deprecated since 5.77, use listDataEngineMetaData()
      **/
     PLASMA_DEPRECATED_VERSION(5, 77, "Use listDataEngineMetaData()")
     KPluginInfo::List listDataEngineInfo(const QString &parentApp = QString());
 #endif
 
     /**
      * Returns a list of all known dataengines.
      *
      * @param parentApp the application to filter dataengines on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all dataengines
      * @return list of dataengines
      * @since 5.77
      **/
     QVector<KPluginMetaData> listDataEngineMetaData(const QString &parentApp = QString());
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 77)
     /**
      * Returns a list of all known ContainmentActions.
      *
      * @param parentApp the application to filter ContainmentActions on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin info.
      *                  The default value of QString() will result in a
      *                  list of all ContainmentActions.
      * @return list of ContainmentActions
      * @deprecated since 5.77, use listContainmentActionsMetaData()
      **/
     PLASMA_DEPRECATED_VERSION(5, 77, "Use listContainmentActionsMetaData()")
     KPluginInfo::List listContainmentActionsInfo(const QString &parentApp);
 #endif
 
     /**
      * Returns a list of all known ContainmentActions.
      *
      * @param parentApp the application to filter ContainmentActions on. Uses the
      *                  X-KDE-ParentApp entry (if any) in the plugin metadata.
      *                  The default value of QString() will result in a
      *                  list of all ContainmentActions.
      * @return list of ContainmentActions
      * @since 5.77
      **/
     QVector<KPluginMetaData> listContainmentActionsMetaData(const QString &parentApp);
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 86)
     /**
      * Set the plugin loader which will be queried for all loads.
      *
      * @param loader A subclass of PluginLoader which will be supplied
      * by the application
      * @deprecated Since 5.86, method is obsolete with the deprecation of the virtual methods
      **/
     PLASMA_DEPRECATED_VERSION(5, 86, "Method is obsolete with the deprecation of the virtual methods")
     static void setPluginLoader(PluginLoader *loader);
 #endif
 
     /**
      * Return the active plugin loader
      **/
     static PluginLoader *self();
 
 #if PLASMA_BUILD_DEPRECATED_SINCE(5, 86)
 protected:
     /**
      * A re-implementable method that allows subclasses to override
      * the default behaviour of loadApplet. If the applet requested is not recognized,
      * then the implementation should return a NULL pointer. This method is called
      * by loadApplet prior to attempting to load an applet using the standard Plasma
      * plugin mechanisms.
      *
      * @param name the plugin name, as returned by KPluginInfo::pluginName()
      * @param appletId unique ID to assign the applet, or zero to have one
      *        assigned automatically.
      * @param args to send the applet extra arguments
      * @return a pointer to the loaded applet, or 0 on load failure
      * @deprecated Since 5.86, deprecated for lack of usage, use default behaviour instead
      **/
     PLASMA_DEPRECATED_VERSION(5, 86, "Deprecated for lack of usage, use default behaviour instead")
     virtual Applet *internalLoadApplet(const QString &name, uint appletId = 0, const QVariantList &args = QVariantList());
 
     /**
      * A re-implementable method that allows subclasses to override
      * the default behaviour of loadDataEngine. If the engine requested is not recognized,
      * then the implementation should return a NULL pointer. This method is called
      * by loadDataEngine prior to attempting to load a DataEgine using the standard Plasma
      * plugin mechanisms.
      *
      * @param name the name of the engine
      * @return the data engine that was loaded, or the NullEngine on failure.
      * @deprecated Since 5.86, deprecated for lack of usage, use default behaviour instead
      **/
     PLASMA_DEPRECATED_VERSION(5, 86, "Deprecated for lack of usage, use default behaviour instead")
     virtual DataEngine *internalLoadDataEngine(const QString &name);
 
     /**
      * A re-implementable method that allows subclasses to override
      * the default behaviour of loadService. If the service requested is not recognized,
      * then the implementation should return a NULL pointer. This method is called
      * by loadService prior to attempting to load a Service using the standard Plasma
      * plugin mechanisms.
      *
      * @param name the plugin name of the service to load
      * @param args a list of arguments to supply to the service plugin when loading it
      * @param parent the parent object, if any, for the service
      *
      * @return a Service object, unlike Plasma::Service::loadService, this can return null.
      * @deprecated Since 5.86, deprecated for lack of usage, use default behaviour instead
      **/
     PLASMA_DEPRECATED_VERSION(5, 86, "Deprecated for lack of usage, use default behaviour instead")
     virtual Service *internalLoadService(const QString &name, const QVariantList &args, QObject *parent = nullptr);
 
     /**
      * A re-implementable method that allows subclasses to override
      * the default behaviour of loadContainmentActions. If the ContainmentActions requested is not recognized,
      * then the implementation should return a NULL pointer. This method is called
      * by loadService prior to attempting to load a Service using the standard Plasma
      * plugin mechanisms.
      *
      * Returns a pointer to the containmentactions if successful.
      * The caller takes responsibility for the containmentactions, including
      * deleting it when no longer needed.
      *
      * @param parent the parent containment. @since 4.6 null is allowed.
      * @param name the plugin name, as returned by KPluginInfo::pluginName()
      * @param args to send the containmentactions extra arguments
      * @return a ContainmentActions object
      * @deprecated Since 5.86, deprecated for lack of usage, use default behaviour instead
      **/
     PLASMA_DEPRECATED_VERSION(5, 86, "Deprecated for lack of usage, use default behaviour instead")
     virtual ContainmentActions *internalLoadContainmentActions(Containment *parent, const QString &containmentActionsName, const QVariantList &args);
 
 #if PLASMA_BUILD_DEPRECATED_SINCE(5, 86)
     /**
      * A re-implementable method that allows subclasses to override
      * the default behaviour of loadPackage. If the service requested is not recognized,
      * then the implementation should return a NULL pointer. This method is called
      * by loadService prior to attempting to load a Service using the standard Plasma
      * plugin mechanisms.
      *
      * @param name the plugin name of the service to load
      * @param args a list of arguments to supply to the service plugin when loading it
      * @param parent the parent object, if any, for the service
      *
      * @return a Service object, unlike Plasma::Service::loadService, this can return null.
      * @deprecated since 5.30, use KPackage API
      **/
     PLASMA_DEPRECATED_VERSION(5, 30, "Use KPackage API")
     virtual Package internalLoadPackage(const QString &name, const QString &specialization);
 #endif
     /**
      * A re-implementable method that allows subclasses to provide additional applets
      * for listAppletInfo. If the application has no applets to give to the application,
      * then the implementation should return an empty list.
      *
      * This method is called by listAppletInfo prior to generating the list of applets installed
      * on the system using the standard Plasma plugin mechanisms, and will try to find .desktop
      * files for your applets.
      *
      * @param category Only applets matching this category will be returned.
      *                 If "Misc" is passed in, then applets without a
      *                 Categories= entry are also returned.
      *                 If an empty string is passed in, all applets are
      *                 returned.
      * @return list of applets
      * @deprecated Since 5.86, deprecated for lack of usage, use default behaviour instead
      **/
     PLASMA_DEPRECATED_VERSION(5, 86, "Deprecated for lack of usage, use default behaviour instead")
     virtual QList<KPluginInfo> internalAppletInfo(const QString &category) const;
 
     /**
      * A re-implementable method that allows subclasses to provide additional dataengines
      * for DataEngine::listDataEngines.
      *
      * @return list of dataengine info, or an empty list if none
      * @deprecated Since 5.86, deprecated for lack of usage, use default behaviour instead
      **/
     PLASMA_DEPRECATED_VERSION(5, 86, "Deprecated for lack of usage, use default behaviour instead")
     virtual QList<KPluginInfo> internalDataEngineInfo() const;
 
     /**
      * Returns a list of all known Service implementations
      *
      * @return list of Service info, or an empty list if none
      * @deprecated Since 5.86, deprecated for lack of usage, use default behaviour instead
      */
     PLASMA_DEPRECATED_VERSION(5, 86, "Deprecated for lack of usage, use default behaviour instead")
     virtual QList<KPluginInfo> internalServiceInfo() const;
 
     /**
      * Returns a list of all known ContainmentActions implementations
      *
      * @return list of ContainmentActions info, or an empty list if none
      * @deprecated Since 5.86, deprecated for lack of usage, use default behaviour instead
      */
     PLASMA_DEPRECATED_VERSION(5, 86, "Deprecated for lack of usage, use default behaviour instead")
     virtual QList<KPluginInfo> internalContainmentActionsInfo() const;
 #endif
 
 #if PLASMA_ENABLE_DEPRECATED_SINCE(5, 88)
     /**
      * Standardized mechanism for providing internal applets by install .desktop files
      * in $APPPDATA/plasma/internal/applets/
      *
      * For applications that do this, internalAppletInfo can be implemented as a one-liner
      * call to this method.
      *
      * @param category Only applets matching this category will be returned.
      *                 If "Misc" is passed in, then applets without a
      *                 Categories= entry are also returned.
      *                 If an empty string is passed in, all applets are
      *                 returned.
      * @return list of applets, or an empty list if none
      * @deprecated Since 5.88, deprecated for lack of usage & obsolete with json metadata
      */
     PLASMA_DEPRECATED_VERSION(5, 88, "deprecated for lack of usage & obsolete with json metadata")
     KPluginInfo::List standardInternalAppletInfo(const QString &category) const;
 
     /**
      * Standardized mechanism for providing internal dataengines by install .desktop files
      * in $APPPDATA/plasma/internal/dataengines/
      *
      * For applications that do this, internalDataEngineInfo can be implemented as a one-liner
      * call to this method.
      *
      * @return list of dataengines
      * @deprecated Since 5.88, deprecated for lack of usage & obsolete with json metadata
      */
     PLASMA_DEPRECATED_VERSION(5, 88, "deprecated for lack of usage & obsolete with json metadata")
     KPluginInfo::List standardInternalDataEngineInfo() const;
 
     /**
      * Standardized mechanism for providing internal services by install .desktop files
      * in $APPPDATA/plasma/internal/services/
      *
      * For applications that do this, internalServiceInfo can be implemented as a one-liner
      * call to this method.
      *
      * @return list of services
      * @deprecated Since 5.88, deprecated for lack of usage & obsolete with json metadata
      */
     PLASMA_DEPRECATED_VERSION(5, 88, "deprecated for lack of usage & obsolete with json metadata")
     KPluginInfo::List standardInternalServiceInfo() const;
 #endif
 
     PluginLoader();
     virtual ~PluginLoader();
 
 private:
     PluginLoaderPrivate *const d;
 };
 
 }
 
 Q_DECLARE_METATYPE(Plasma::PluginLoader *)
 
 #endif