plugin:discussion
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:discussion [2017-04-22 07:42] – [Configuration] 2a01:e35:2e29:c0c0:8ea9:82ff:fe85:2626 | 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 | email : michael@content-space.de | ||
type : syntax, action, admin, helper | type : syntax, action, admin, helper | ||
- | lastupdate : 2016-09-18 | + | lastupdate : 2021-12-31 |
- | compatible : Detritus, Hrun, Ponder Stibbons, Elenor of Tsort | + | compatible : Detritus, Hrun, Ponder Stibbons, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather |
depends | depends | ||
conflicts | conflicts | ||
Line 19: | Line 19: | ||
===== Description ===== | ===== Description ===== | ||
- | The Discussion | + | The Discussion Plugin adds a discussion section after your wiki page for user comments. This is useful to separate page content and the discussion thereof and also, if you don't want to give normal users the right to edit the page but still want user contributed notes. |
A second component of this plugin shows a list of all pages in a namespace with a discussion section (called discussion threads) ordered by most recent comments. This allows you to create a very simple discussion forum in your wiki. | A second component of this plugin shows a list of all pages in a namespace with a discussion section (called discussion threads) ordered by most recent comments. This allows you to create a very simple discussion forum in your wiki. | ||
Line 26: | Line 26: | ||
==== Comments-section ==== | ==== Comments-section ==== | ||
+ | |||
This is the main part of the plugin. By including the '' | This is the main part of the plugin. By including the '' | ||
~~DISCUSSION~~ | ~~DISCUSSION~~ | ||
Line 34: | Line 35: | ||
~~DISCUSSION|Custom Title String~~ | ~~DISCUSSION|Custom Title String~~ | ||
~~DISCUSSION: | ~~DISCUSSION: | ||
- | |||
- | |||
After each comment in the discussion section there may be up to three buttons (depending on your rights): | After each comment in the discussion section there may be up to three buttons (depending on your rights): | ||
Line 41: | Line 40: | ||
* Reply: To reply to a comment (vs. commenting on the wiki page content), click the '' | * Reply: To reply to a comment (vs. commenting on the wiki page content), click the '' | ||
* 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. | * 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. \\ // | + | * Delete: Registered users and admin all 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. | + | * 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. |
Of course, the whole DokuWiki [[: | Of course, the whole DokuWiki [[: | ||
- | ==== Threads syntax==== | + | ==== Threads syntax ==== |
This displays a list of all pages of the given namespace with a discussion section. The list is sorted by the most recent comment. | This displays a list of all pages of the given namespace with a discussion section. The list is sorted by the most recent comment. | ||
Line 56: | Line 55: | ||
^ [flags] | pagelist flags delimited by ''&'', | ^ [flags] | pagelist flags delimited by ''&'', | ||
^ skipempty | Do not print discussions with no comments | optional | | ^ skipempty | Do not print discussions with no comments | optional | | ||
+ | ^ nonewthreadform | Do not show the //new thread form// form below the table | optional | | ||
Default a //new thread form// is shown below the list. See '' | Default a //new thread form// is shown below the list. See '' | ||
===== Configuration ===== | ===== Configuration ===== | ||
+ | |||
The plugin can be configured using DokuWiki' | The plugin can be configured using DokuWiki' | ||
^ '' | ^ '' | ||
- | ^ '' | + | ^ '' |
- | ^ '' | + | ^ '' |
^ '' | ^ '' | ||
^ '' | ^ '' | ||
^ '' | ^ '' | ||
- | ^ '' | + | ^ '' |
^ '' | ^ '' | ||
^ '' | ^ '' | ||
^ '' | ^ '' | ||
- | ^ '' | + | ^ '' |
^ '' | ^ '' | ||
- | ^ '' | + | ^ '' |
^ '' | ^ '' | ||
^ '' | ^ '' | ||
Line 89: | Line 89: | ||
===== Changes ===== | ===== Changes ===== | ||
+ | |||
{{rss> | {{rss> | ||
Line 98: | Line 99: | ||
* **2013-07-01**: | * **2013-07-01**: | ||
* **2013-06-18**: | * **2013-06-18**: | ||
- | * Make the discussion plugin compatible with current versions of the [[captcha]] plugin | + | * Make the discussion plugin compatible with current versions of the [[Captcha]] plugin |
* Add the option to specify separate moderator groups for comments | * Add the option to specify separate moderator groups for comments | ||
* Use jQuery instead of the old JavaScript library, this makes the plugin compatible with DokuWiki version Weatherwax | * Use jQuery instead of the old JavaScript library, this makes the plugin compatible with DokuWiki version Weatherwax | ||
Line 104: | Line 105: | ||
===== FAQ ===== | ===== FAQ ===== | ||
- | |||
==== How do I allow plugin formatting within discussions? | ==== How do I allow plugin formatting within discussions? | ||
- | I have DokuWiki formatting allowed in comments. | + | |
+ | I have DokuWiki formatting allowed in comments. I also have a [[LaTeX]] plugin. | ||
==== How do I prevent SPAM? ==== | ==== How do I prevent SPAM? ==== | ||
+ | |||
The plugin has built-in support for the [[plugin: | The plugin has built-in support for the [[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? ==== | ==== Is it possible to show the newest entry on top? ==== | ||
+ | |||
Yes, use the '' | Yes, use the '' | ||
==== Can admins subscribe to all discussions? | ==== Can admins subscribe to all discussions? | ||
+ | |||
If you enable the [[config: | If you enable the [[config: | ||
+ | ==== 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/ | ||
+ | |||
+ | The plugin disables subscription for logged-in users when the option " | ||
+ | |||
+ | |||
+ | ==== Howto rename all Discussion section titles? ==== | ||
+ | |||
+ | You can overwrite translated strings such as the default title with your own text. | ||
+ | <code php conf/ | ||
+ | |||
+ | <?php | ||
+ | /** | ||
+ | * Customization of the english language file | ||
+ | * Copy only the strings that needs to be modified | ||
+ | */ | ||
+ | |||
+ | $lang[' | ||
+ | </ | ||
==== Where are discussions saved? ==== | ==== Where are discussions saved? ==== | ||
+ | |||
The comments are saved in special meta files inside the ''< | The comments are saved in special meta files inside the ''< | ||
==== How can I change the discussion box size? ==== | ==== How can I change the discussion box size? ==== | ||
+ | |||
You can change the size of the box by using the following CSS class: | You can change the size of the box by using the following CSS class: | ||
Line 132: | Line 158: | ||
==== Why do comments not appear in the latest changes list? ==== | ==== Why do comments not appear in the latest changes list? ==== | ||
+ | |||
Because it would break DokuWiki' | Because it would break DokuWiki' | ||
Alternative: | Alternative: | ||
- | ==== 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: | + | |
==== Is it somehow possible to show all discussions on one page (like in the admin area)? ==== | ==== Is it somehow possible to show all discussions on one page (like in the admin area)? ==== | ||
+ | |||
You can list all discussions with: | You can list all discussions with: | ||
{{threads> | {{threads> | ||
+ | |||
+ | Beware that hidden comments are not shown. Not even to administrators. | ||
+ | |||
+ | This example | ||
+ | {{threads>: | ||
+ | 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 ==== | ==== 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 147: | Line 184: | ||
Discussions aren't stored like regular wiki pages. This will not work. | 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. | + | ==== Removing |
- | ==== No subscribe/ | ||
- | |||
- | The plugin disables subscription for logged-in users when the option " | ||
- | |||
- | ==== Removing the shown IP of a guest comment and replacing it with ' | ||
You will need to edit a line in the ' | You will need to edit a line in the ' | ||
- | $comment[' | + | |
and replace it with | and replace it with | ||
- | $comment[' | + | |
+ | |||
- | ==== Is ist possible | + | ==== When I add a ~~DISCUSSION~~ |
+ | I've [[https:// | ||
+ | | ||
- | 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: | ||
- | |||
- | < | ||
- | // if(empty($_REQUEST[' | ||
- | // if(!mail_isvalid($_REQUEST[' | ||
- | // msg($lang[' | ||
- | // return; | ||
- | // } else { | ||
- | $comment[' | ||
- | $comment[' | ||
- | $comment[' | ||
- | // } | ||
- | </ | ||
- | |||
- | and lines 983 - 988: | ||
- | | ||
- | < | ||
- | < | ||
- | <label class=" | ||
- | < | ||
- | <input type=" | ||
- | </ | ||
- | </ | ||
- | | ||
- | </ | ||
- | | ||
- | 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 | ||
- | ==== Hello, how to increase the size of the input form of the comments? I mean the white rectangle is only one row. How can i make it do be two or more lines? ==== | ||
===== Issues and feature requests ===== | ===== Issues and feature requests ===== | ||
Line 201: | Line 207: | ||
* You can add and improve translations at http:// | * You can add and improve translations at http:// | ||
- | =====Discussion==== | + | ===== Discussion ===== |
For the discussion refer to the [[plugin: | For the discussion refer to the [[plugin: |
plugin/discussion.1492839752.txt.gz · Last modified: 2017-04-22 07:42 by 2a01:e35:2e29:c0c0:8ea9:82ff:fe85:2626