1 /***************************************************************************
2 * This file is part of KWorship. *
3 * Copyright 2008 James Hogan <james@albanarts.com> *
5 * KWorship is free software: you can redistribute it and/or modify *
6 * it under the terms of the GNU General Public License as published by *
7 * the Free Software Foundation, either version 2 of the License, or *
8 * (at your option) any later version. *
10 * KWorship is distributed in the hope that it will be useful, *
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
13 * GNU General Public License for more details. *
15 * You should have received a copy of the GNU General Public License *
16 * along with KWorship. If not, write to the Free Software Foundation, *
17 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
18 ***************************************************************************/
25 * @brief An abstract KWorship plugin.
26 * @author James Hogan <james@albanarts.com>
32 class KwPluginManager
;
36 /// An abstract KWorship plugin.
37 class KwPlugin
: public QObject
44 * Constructors + destructor
47 /** Primary constructor.
48 * @param id Short unique untranslated id.
49 * @param name Translated name of plugin.
50 * @param description Translated description of plugin.
52 KwPlugin(const QString
& id
, const QString
& name
, const QString
& description
);
58 * Basic information accessors
62 const QString
& id() const;
65 const QString
& name() const;
67 /// Get the description.
68 const QString
& description() const;
70 /// Get whether the plugin is loaded.
71 bool isLoaded() const;
74 * Loading and unloading
78 * This should only be called by the manager class itself.
79 * @pre Manager must not have already been set.
80 * @param manager New manager object.
82 void setManager(KwPluginManager
* manager
);
85 * @pre Manager must have been set.
89 /// Unload the plugin.
95 * Loading and unloading virtual interface
101 virtual void _load() = 0;
103 /** Unload the plugin.
106 virtual void _unload() = 0;
114 /// Short unique untranslated id.
120 /// Translated description.
121 QString m_description
;
127 /// The current plugin manager.
128 KwPluginManager
* m_manager
;
130 /// Whether the plugin is loaded.
135 #endif // _KwPlugin_h_