Differences

This shows you the differences between two versions of the page.

--- plugin:discussion [2022-07-09 09:56] – [Threads syntax] johng
+++ plugin:discussion [2024-02-06 08:11] (current) – [When I add a ~~DISCUSSION~~ to a page the toolbar for the editor for the main page text changes to the one for the discussion submission box with buttons like that for media removed. Is this expected behaviour?] Aleksandr
@@ Line 6: / Line 6: @@
 email      : michael@content-space.de
 type       : syntax, action, admin, helper
-lastupdate : 2020-09-24
+lastupdate : 2021-12-31
 compatible : Detritus, Hrun, Ponder Stibbons, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
 depends    : pagelist
@@ Line 41: / Line 41: @@
   * Edit: Registered users can edit their comments; admins can edit all comments. To remove a comment, just edit it, clear the text and save the empty comment -- like you would do with a wiki page.
   * Delete: Registered users and admin all comments.\\ //Attention: If there are replies to a comment, removing it will also remove all replies!//
-  * Hide / Show: Admins can deactivate and reactivate comments easily by this button. Hidden comments aren't shown to normal users and are displayed dimmed to admins. Registered users can only hide their own comments.
+  * Hide / Show: Admins can deactivate and reactivate comments easily by this button. Hidden comments aren't shown to normal users and are displayed dimmed to admins. Registered users can only hide their own comments. //Hiding a comment, is hiding its replies as well.//
 Of course, the whole DokuWiki [[:wiki:syntax|syntax]] can be used in comments as well. But there are problems with headers and footnotes as they may produce conflicting IDs and thus invalid XHTML. I'm looking for a way to either allow only a subset of the wiki syntax or automatically create unique IDs.
@@ Line 64: / Line 64: @@
 ^ ''automatic'' | automatically enables discussions on all pages |
-^ ''excluded_ns'' | list of namespaces for which to revert the ''automatic'' config setting (a regular expression e.g. ''%%/(playground|wiki)/%%'' )|
+^ ''excluded_ns'' | list of namespaces for which to revert the ''automatic'' config setting (a regular expression e.g. ''%%/(playground|wiki)/%%'', delimiter should be included e.g. '/' at start and end )|
-^ ''visibilityButton'' | Enable button for toggling the visibility of the discussion section |
+^ ''visibilityButton'' | Enable button for toggling the visibility of the entire discussion section |
 ^ ''allowguests'' | allow/disallow unregistered users to leave comments|
 ^ ''showguests'' | show/hide comments to unregistered users |
@@ Line 75: / Line 75: @@
 ^ ''wikisyntaxok'' | allow [[wiki:syntax|wiki syntax]] in comments((Uncheck this parameter to avoid problems with the [[plugin:struct|Struct plugin]] )) |
 ^ ''threads_formposition'' | position of the new thread form shown with the %%{{threads> }}%% syntax (before or below the thread listing) |
-^ ''subscribe'' | allow comment subscription (uses double opt-in) |
+^ ''subscribe'' | allow comment subscription (uses double opt-in), if [[config:subscribers|page-subscriptions]] are used it is only used for not-logged users. |
 ^ ''newestfirst'' | Invert the comments display order |
 ^ ''usethreading'' | enable/disable threaded comments |
@@ Line 114: / Line 114: @@
 The plugin has built-in support for the [[plugin:CAPTCHA]] plugin. Additionally, one might also consider to use the [[plugin:badbehaviour|Bad Behavior plugin]].
-==== My dates are shown wrong. What can I do? ====
-You're probably not running the latest version of the plugin. Try to update to the latest version first.
 ==== Is it possible to show the newest entry on top? ====
@@ Line 126: / Line 123: @@
 If you enable the [[config:notify]] option admins are notified for all comments.
+==== How can I subscribe to a RSS feed of all discussions or threads ====
+This is possible using the [[feed]] plugin, please see there how it works.
+==== No subscribe/unsubscribe to comments for logged-in users ====
+The plugin disables subscription for logged-in users when the option "subscribers" is activated in the configuration, which enables subscriptions for changes per page and/or namespace.
+==== Howto rename all Discussion section titles? ====
+You can overwrite translated strings such as the default title with your own text.
+<code php conf/plugin_lang/discussion/en/lang.php>
+<?php
+/**
+ * Customization of the english language file
+ * Copy only the strings that needs to be modified
+ */
+$lang['discussion'] = 'Discussion';
+</code>
 ==== Where are discussions saved? ====
@@ Line 144: / Line 163: @@
 Alternative: use the pagelist plugin to make an overview of "latest discussion" by using the **%%{{threads>...}}%%** syntax.
-==== When I use the sidebar plugin the discussions disappear =====
-This is a know problem with the sidebar plugin which needs to be fixed by it's author. If you're looking for working alternatives in the meanwhile I suggest to have a look at the [[plugin:sidebarng|SidebarNG plugin]].
 ==== Is it somehow possible to show all discussions on one page (like in the admin area)? ====
@@ Line 152: / Line 169: @@
 You can list all discussions with:
   {{threads>*}}
+Beware that hidden comments are not shown. Not even to administrators.
+This example
+  {{threads>:namespace_abc&nouser&header&skipempty&nonewthreadform}}
+shows a list of pages inside __namespace_abc__ with
+  * all pages which have comments, skipping the empty ones caused by e.g. deletion.
+  * columns __Page__ including a link to the page, __Date__ and __Number of comments__ which is also a link to the comments section of the page. The usual __User__ column is omitted as indicated by //nouser//.
+  * headers for each column.
+  * no new thread form below the list.
 ==== I can add tags to a discussion, but they don't seem to end up in the tag cloud, or being noticed by the tag plugin ====
@@ Line 157: / Line 184: @@
 Discussions aren't stored like regular wiki pages. This will not work.
-==== How can I subscribe to a RSS feed of all discussions or threads ====
-This is possible using the [[feed]] plugin, please see there how it works.
-==== No subscribe/unsubscribe to comments for logged-in users ====
-The plugin disables subscription for logged-in users when the option "subscribers" ($conf['subscribers']) is activated in the configuration.
 ==== Removing the shown IP of a guest comment and replacing it with 'Guest: name' ====
@@ Line 174: / Line 194: @@
   $comment['user']['id'] = 'GUEST: '.hsc($_REQUEST['name']);
-==== Is it possible to disable the email box for guest comments? ====
-I'm not a developer of the plugin but I believe you can do this if you comment out the following lines 283-287 and 291:
-<code>
-	// if(empty($_REQUEST['name']) or empty($_REQUEST['mail'])) return;
-	// if(!mail_isvalid($_REQUEST['mail'])) {
-		// msg($lang['regbadmail'], -1);
-		// return;
-	// } else {
-		$comment['user']['id'] = 'test'.hsc($_REQUEST['user']);
-		$comment['user']['name'] = hsc($_REQUEST['name']);
-		$comment['user']['mail'] = hsc($_REQUEST['mail']);
-	// }
-</code>
-and lines 983 - 988:
-<code>
-              <!--<div class="comment_mail">
-                <label class="block" for="discussion__comment_mail">
-                   <span><?php echo $lang['email'] ?>:</span>
-                      <input type="text" class="edit<?php if($_REQUEST['comment'] == 'add' && empty($_REQUEST['mail'])) echo ' error'?>" name="mail" id="discussion__comment_mail" size="50" tabindex="2" value="<?php echo hsc($_REQUEST['mail'])?>" />
-                </label>
-              </div>-->
-</code>
-in action.php inside the plugins directory. Anonymous users won't be able to subscribe tho. Please correct me if I'm breaking some other function with this. Until now there hasn't been a problem tho. Andy
 ==== When I add a ~~DISCUSSION~~ to a page the toolbar for the editor for the main page text changes to the one for the discussion submission box with buttons like that for media removed.  Is this expected behaviour? ====