====== dtable Plugin ======

---- plugin ----
description: Simplify managing DokuWiki tables by adding intuitive GUI
author     : Szymon Olewniczak
email      : solewniczak@rid.pl
type       : syntax
lastupdate : 2021-03-28
compatible : Ponder Stibbons, Binky, Weatherwax, Angua, Adora Belle, Hrun, Detritus, Elenor Of Tsort, Frusterick Manners, Greebo, Hogfather, Igor, Jack Jackrum, !Kaos
depends    : 
conflicts  : sortablejs
similar    : data
tags       : database, tables

downloadurl: https://github.com/gkrid/dokuwiki-plugin-dtable/zipball/master
bugtracker : https://github.com/gkrid/dokuwiki-plugin-dtable/issues
sourcerepo : https://github.com/gkrid/dokuwiki-plugin-dtable

----

===== Description =====

This plugin allows you to easily edit dokuwiki tables by right-clicking on any row. Edits take place using simple ajax GUI rather than going into DW's edit mode. Every table change is saved in dokuwiki as the new page revision so now you don't need to worry when you accidentally change or remove some table rows.(as it was in old dtable). The plugin additionally manages page locks so you don't need to worry that someone can damage your work by using the same page pararelly with you. I've also decided to change all new line chars that appears in textareas to "\\" so now you won't destroy your table when you accidentally insert some new lines to it. 

To add, edit or remove records just click with the right mouse button on the table. To send the form in the table just **doubleclick** somwhere in the page.

Only logged in users can modify the table.

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Syntax and Usage =====

Just put your dokuwiki table between ''%%<dtable></dtable>%%'' tags. Ex.:
  <dtable>
  ^Header 1^Header 2^
  |test|table|
  </dtable>

===== Known issues =====

  * Remember to always insert an empty line after the ''</dtable>'' tag.
> why? What happens otherwise?


  * When used in combination with [[plugin:sortablejs|SortableJS]], the editable row is not the one that was highlighted but rather another one. See [[https://github.com/gkrid/dokuwiki-plugin-dtable/issues/15|this]] and [[https://github.com/FyiurAmron/sortablejs/issues/41|this]].

===== Config =====

  * all_tables - **EXPERIMENTAL** turn all tables into dtables. I recommend not to use this option now because sometimes it can behaves very strange. But I think that I know how to repair this, so please be patient ;-)

===== Development =====

=== Change Log ===

{{rss>https://github.com/gkrid/dokuwiki-plugin-dtable/commits/develop.atom date}}

**Releases:**
{{rss>https://github.com/gkrid/dokuwiki-plugin-dtable/releases.atom description author}}

===== Discussion =====

[[https://github.com/gkrid/dokuwiki-plugin-dtable/issues]]