added help strings to posted, channels, forums

git-svn-id: http://svn.code.sf.net/p/retroshare/code/trunk@7525 b45a01b8-16f6-495d-af2f-9b41ad6348cc

retroshare-gui/src/gui/Posted/PostedDialog.cpp

@@ -46,6 +46,18 @@ UserNotify *PostedDialog::getUserNotify(QObject *parent)
 	return new PostedUserNotify(rsPosted, parent);
 }
 
+QString PostedDialog::getHelpString() const
+{
+	QString hlp_str = tr("<h1><img width=\"32\" src=\":/images/64px_help.png\">&nbsp;&nbsp;Posted</h1>    \
+    <p>The posted service allows you to share internet links, that spread among Retroshare nodes like forums and \
+	 channels</p> \
+	 <p>Links can be commented by subscribed users. A promotion system also gives the opportunity to  \
+	 enlight important links.</p> \
+	 <p>There is no restriction on which links are shared. Be careful when clicking on them.</p>") ;
+
+	return hlp_str ;
+}
+
 QString PostedDialog::text(TextType type)
 {
 	switch (type) {

retroshare-gui/src/gui/Posted/PostedDialog.h

@@ -45,6 +45,7 @@ public:
 	virtual UserNotify *getUserNotify(QObject *parent);
 
 protected:
+	virtual QString getHelpString() const ;
 	virtual RetroShareLink::enumType getLinkType() { return RetroShareLink::TYPE_UNKNOWN; }
 	virtual GroupFrameSettings::Type groupFrameSettingsType() { return GroupFrameSettings::Posted; }
 

retroshare-gui/src/gui/gxs/GxsGroupFrameDialog.cpp

@@ -102,6 +102,10 @@ GxsGroupFrameDialog::GxsGroupFrameDialog(RsGxsIfaceHelper *ifaceImpl, QWidget *p
 	QList<int> sizes;
 	sizes << 300 << width(); // Qt calculates the right sizes
 	ui->splitter->setSizes(sizes);
+
+#ifndef UNFINISHED
+	ui->todoPushButton->hide();
+#endif
 }
 
 GxsGroupFrameDialog::~GxsGroupFrameDialog()
@@ -115,6 +119,8 @@ GxsGroupFrameDialog::~GxsGroupFrameDialog()
 
 void GxsGroupFrameDialog::initUi()
 {
+	registerHelpButton(ui->helpButton, getHelpString()) ;
+
 	ui->titleBarPixmap->setPixmap(QPixmap(icon(ICON_NAME)));
 	ui->titleBarLabel->setText(text(TEXT_NAME));
 

retroshare-gui/src/gui/gxs/GxsGroupFrameDialog.h

@@ -71,13 +71,15 @@ public:
 
 public:
 	GxsGroupFrameDialog(RsGxsIfaceHelper *ifaceImpl, QWidget *parent = 0);
-	~GxsGroupFrameDialog();
+	virtual ~GxsGroupFrameDialog();
 
 	bool navigate(const RsGxsGroupId groupId, const RsGxsMessageId& msgId);
 
 	// Callback for all Loads.
 	virtual void loadRequest(const TokenQueue *queue, const TokenRequest &req);
 
+	virtual QString getHelpString() const =0;
+
 protected:
 	virtual void showEvent(QShowEvent *event);
 	virtual void updateDisplay(bool complete);

retroshare-gui/src/gui/gxs/GxsGroupFrameDialog.ui

@@ -6,50 +6,19 @@
    <rect>
     <x>0</x>
     <y>0</y>
-    <width>732</width>
+    <width>619</width>
     <height>420</height>
    </rect>
   </property>
-  <layout class="QGridLayout">
+  <layout class="QVBoxLayout" name="verticalLayout">
-   <property name="leftMargin">
+   <item>
-    <number>9</number>
-   </property>
-   <property name="rightMargin">
-    <number>9</number>
-   </property>
-   <item row="0" column="0">
-    <widget class="QSplitter" name="splitter">
-     <property name="orientation">
-      <enum>Qt::Horizontal</enum>
-     </property>
-     <widget class="QFrame" name="frame">
-      <property name="baseSize">
-       <size>
-        <width>300</width>
-        <height>300</height>
-       </size>
-      </property>
-      <property name="frameShape">
-       <enum>QFrame::NoFrame</enum>
-      </property>
-      <layout class="QGridLayout">
-       <property name="leftMargin">
-        <number>0</number>
-       </property>
-       <property name="topMargin">
-        <number>0</number>
-       </property>
-       <property name="rightMargin">
-        <number>0</number>
-       </property>
-       <property name="bottomMargin">
-        <number>0</number>
-       </property>
-       <property name="spacing">
-        <number>0</number>
-       </property>
-       <item row="0" column="0">
     <widget class="QFrame" name="titleBarFrame">
+     <property name="sizePolicy">
+      <sizepolicy hsizetype="Preferred" vsizetype="Maximum">
+       <horstretch>0</horstretch>
+       <verstretch>0</verstretch>
+      </sizepolicy>
+     </property>
      <property name="frameShape">
       <enum>QFrame::Box</enum>
      </property>
@@ -57,16 +26,7 @@
       <enum>QFrame::Sunken</enum>
      </property>
      <layout class="QHBoxLayout" name="horizontalLayout_2">
-          <property name="leftMargin">
+      <property name="margin">
-           <number>2</number>
-          </property>
-          <property name="topMargin">
-           <number>2</number>
-          </property>
-          <property name="rightMargin">
-           <number>2</number>
-          </property>
-          <property name="bottomMargin">
        <number>2</number>
       </property>
       <item>
@@ -129,10 +89,31 @@
         </property>
        </widget>
       </item>
+      <item>
+       <widget class="QToolButton" name="helpButton">
+        <property name="focusPolicy">
+         <enum>Qt::NoFocus</enum>
+        </property>
+        <property name="icon">
+         <iconset resource="../images.qrc">
+          <normaloff>:/images/64px_help.png</normaloff>:/images/64px_help.png</iconset>
+        </property>
+        <property name="checkable">
+         <bool>true</bool>
+        </property>
+        <property name="autoRaise">
+         <bool>true</bool>
+        </property>
+       </widget>
+      </item>
      </layout>
     </widget>
    </item>
-       <item row="1" column="0">
+   <item>
+    <widget class="QSplitter" name="splitter">
+     <property name="orientation">
+      <enum>Qt::Horizontal</enum>
+     </property>
      <widget class="GroupTreeWidget" name="groupTreeWidget" native="true">
       <property name="sizePolicy">
        <sizepolicy hsizetype="Preferred" vsizetype="Expanding">
@@ -141,9 +122,6 @@
        </sizepolicy>
       </property>
      </widget>
-       </item>
-      </layout>
-     </widget>
      <widget class="RSTabWidget" name="messageTabWidget">
       <property name="currentIndex">
        <number>-1</number>

retroshare-gui/src/gui/gxschannels/GxsChannelDialog.cpp

@@ -38,6 +38,22 @@ GxsChannelDialog::~GxsChannelDialog()
 {
 }
 
+QString GxsChannelDialog::getHelpString() const
+{
+	QString hlp_str = tr("<h1><img width=\"32\" src=\":/images/64px_help.png\">&nbsp;&nbsp;Channels</h1>    \
+    <p>Channels allow you to post data (e.g. movies, music) that will spread in the network</p>            \
+    <p>You can see the channels your friends are subscribed to, and you automatically forward subscribed channels to \
+    your friends. This promotes good channels in the network.</p>\
+    <p>Only the channel's creator can post on that channel. Other peers                       \
+    in the network can only read from it, unless the channel is private. You can however share \
+	 the posting rights or the reading rights with friend Retroshare nodes.</p>\
+	 <p>Channels can be made anonymous, or attached to a Retroshare identity so that readers can contact you if needed.\
+	 Enable \"Allow Comments\" if you want to let users comment on your posts.</p>\
+    ") ;
+				
+	return hlp_str ;
+}
+
 UserNotify *GxsChannelDialog::getUserNotify(QObject *parent)
 {
 	return new GxsChannelUserNotify(rsGxsChannels, parent);

retroshare-gui/src/gui/gxschannels/GxsChannelDialog.h

@@ -45,6 +45,7 @@ public:
 protected:
 	virtual RetroShareLink::enumType getLinkType() { return RetroShareLink::TYPE_CHANNEL; }
 	virtual GroupFrameSettings::Type groupFrameSettingsType() { return GroupFrameSettings::Channel; }
+	virtual QString getHelpString() const ;
 
 private slots:
 	void toggleAutoDownload();

retroshare-gui/src/gui/gxsforums/GxsForumsDialog.cpp

@@ -36,6 +36,21 @@ GxsForumsDialog::~GxsForumsDialog()
 {
 }
 
+QString GxsForumsDialog::getHelpString() const
+{
+	QString hlp_str = tr(
+			"<h1><img width=\"32\" src=\":/images/64px_help.png\">&nbsp;&nbsp;Forums</h1>               \
+			<p>Retroshare Forums look like internet forums, but they work in a decentralized way</p>    \
+			<p>You see forums your friends are subscribed to, and you forward subscribed forums to      \
+			your friends. This automatically promotes interesting forums in the network.</p>            \
+			<p>Forums are either Authenticated (<img src=\":/images/konv_message2.png\" width=\"12\"/>) \
+			or anonymous (<img src=\":/images/konversation.png\" width=\"12\"/>). The former            \
+			class is more resistant to spamming because posts are                                       \
+			cryptographically signed using a Retroshare pseudo-identity.</p>") ;
+
+	return hlp_str ;	
+}
+
 UserNotify *GxsForumsDialog::getUserNotify(QObject *parent)
 {
 	return new GxsForumUserNotify(rsGxsForums, parent);

retroshare-gui/src/gui/gxsforums/GxsForumsDialog.h

@@ -41,6 +41,7 @@ public:
 	virtual UserNotify *getUserNotify(QObject *parent);
 
 protected:
+	virtual QString getHelpString() const ;
 	virtual RetroShareLink::enumType getLinkType() { return RetroShareLink::TYPE_FORUM; }
 	virtual GroupFrameSettings::Type groupFrameSettingsType() { return GroupFrameSettings::Forum; }