summaryrefslogtreecommitdiffstats
path: root/core/isocialnetworkintegration.h
diff options
context:
space:
mode:
authorGravatar Dirk Hohndel <dirk@hohndel.org>2016-04-04 22:02:03 -0700
committerGravatar Dirk Hohndel <dirk@hohndel.org>2016-04-04 22:33:58 -0700
commit7be962bfc2879a72c32ff67518731347dcdff6de (patch)
treed05bf7ab234a448ee37a15b608e2b939f2285d07 /core/isocialnetworkintegration.h
parent2d760a7bff71c46c5aeba37c40d236ea16eefea2 (diff)
downloadsubsurface-7be962bfc2879a72c32ff67518731347dcdff6de.tar.gz
Move subsurface-core to core and qt-mobile to mobile-widgets
Having subsurface-core as a directory name really messes with autocomplete and is obviously redundant. Simmilarly, qt-mobile caused an autocomplete conflict and also was inconsistent with the desktop-widget name for the directory containing the "other" UI. And while cleaning up the resulting change in the path name for include files, I decided to clean up those even more to make them consistent overall. This could have been handled in more commits, but since this requires a make clean before the build, it seemed more sensible to do it all in one. Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
Diffstat (limited to 'core/isocialnetworkintegration.h')
-rw-r--r--core/isocialnetworkintegration.h73
1 files changed, 73 insertions, 0 deletions
diff --git a/core/isocialnetworkintegration.h b/core/isocialnetworkintegration.h
new file mode 100644
index 000000000..70ea3d9ab
--- /dev/null
+++ b/core/isocialnetworkintegration.h
@@ -0,0 +1,73 @@
+#ifndef ISOCIALNETWORKINTEGRATION_H
+#define ISOCIALNETWORKINTEGRATION_H
+
+#include <QtPlugin>
+
+/* This Interface represents a Plugin for Social Network integration,
+ * with it you may be able to create plugins for facebook, instagram,
+ * twitpic, google plus and any other thing you may imagine.
+ *
+ * We bundle facebook integration as an example.
+ */
+
+class ISocialNetworkIntegration : public QObject {
+ Q_OBJECT
+public:
+ ISocialNetworkIntegration(QObject* parent = 0);
+
+ /*!
+ * @name socialNetworkName
+ * @brief The name of this social network
+ * @return The name of this social network
+ *
+ * The name of this social network will be used to populate the Menu to toggle states
+ * between connected/disconnected, and also submit stuff to it.
+ */
+ virtual QString socialNetworkName() const = 0;
+
+ /*!
+ * @name socialNetworkIcon
+ * @brief The icon of this social network
+ * @return The icon of this social network
+ *
+ * The icon of this social network will be used to populate the menu, and can also be
+ * used on a toolbar if requested.
+ */
+ virtual QString socialNetworkIcon() const = 0;
+
+ /*!
+ * @name isConnected
+ * @brief returns true if connected to this social network, false otherwise
+ * @return true if connected to this social network, false otherwise
+ */
+ virtual bool isConnected() = 0;
+
+ /*!
+ * @name requestLogin
+ * @brief try to login on this social network.
+ *
+ * Try to login on this social network. All widget implementation that
+ * manages login should be done inside this function.
+ */
+ virtual void requestLogin() = 0;
+
+ /*!
+ * @name requestLogoff
+ * @brief tries to logoff from this social network
+ *
+ * Try to logoff from this social network.
+ */
+ virtual void requestLogoff() = 0;
+
+ /*!
+ * @name uploadCurrentDive
+ * @brief send the current dive info to the Social Network
+ *
+ * Should format all the options and pixmaps from the current dive
+ * to update to the social network. All widget stuff related to sendint
+ * dive information should be executed inside this function.
+ */
+ virtual void requestUpload() = 0;
+};
+
+#endif \ No newline at end of file