Differences

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

--- plugin:dtable [2016-01-22 23:28] – 77.252.177.208
+++ plugin:dtable [2024-04-15 16:04] (current) – [Description] asheenlevrai
@@ Line 1: / Line 1: @@
-====== DTable Plugin ======
+====== dtable Plugin ======
 ---- plugin ----
 description: Simplify managing DokuWiki tables by adding intuitive GUI
 author     : Szymon Olewniczak
-email      : dokuwiki@imz.re
+email      : solewniczak@rid.pl
 type       : syntax
-lastupdate : 2016-01-22
+lastupdate : 2021-03-28
-compatible : "Binky" "Weatherwax" "Angua" "Adora Belle"
+compatible : Ponder Stibbons, Binky, Weatherwax, Angua, Adora Belle, Hrun, Detritus, Elenor Of Tsort, Frusterick Manners, Greebo, Hogfather, Igor, Jack Jackrum, !Kaos
 depends    :
-conflicts  :
+conflicts  : sortablejs
 similar    : data
 tags       : database, tables
-downloadurl: https://github.com/hafron/dtable/zipball/master
+downloadurl: https://github.com/gkrid/dokuwiki-plugin-dtable/zipball/master
-bugtracker : https://github.com/hafron/dtable/issues
+bugtracker : https://github.com/gkrid/dokuwiki-plugin-dtable/issues
-sourcerepo : https://github.com/hafron/dtable
+sourcerepo : https://github.com/gkrid/dokuwiki-plugin-dtable
-donationurl: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=F2VQWA9PCK6LQ&lc=US&item_name=dtable%20%2d%20dokuwiki%20plugin&item_number=dtable&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted
 ----
-===== Attention! =====
-Recent version of plugin completly change the way how the plugin works. If you used the plugin formerly, you should read this page before upgrading.
-===== Donate =====
-I'm a young student working on this plugin in my free time. So if you like this plugin you can [[https://github.com/hafron/dtable/|Flattr it on its github page]] or send me money via [[https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=F2VQWA9PCK6LQ&lc=US&item_name=dtable%20%2d%20dokuwiki%20plugin&item_number=dtable&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted|PayPal]]. There is a lot to do in this plugin and a small donation would convince me that you need my work and motivate me to keep developing this plugin. Thank you in advance. ;-)
 ===== Description =====
-This plugin allows you to use dokuwiki tables using simple ajax GUI. 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.
+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 see what the plugin can do visit [[http://193.17.184.23/dtable-test/doku.php?id=newdtable|this demo page]]. Login using the user "demo" and the password "demo". FIXME
 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.
-===== Known errors =====
-  * <del>Dynamic rowspan doesn't work ideally.</del> Fixed since 2013-09-07
-  * <del>There is one bug in dtable when you insert a link or file into the row using form and then try to edit it(it will split your data because currently dtable doesn't distinguish between "|" char being in table context or not). I know about it and it will be fixed in a couple of days. So if you want to edit your data please do it in a standard dokuwiki way but don't forget about my plugin and update immediately when I remove this warning.  ;-) 2013-09-20</del> Fixed since 2013-06-27
-  * <del>There is not any validation but I will add this soon.</del> I've decided that it isn't necessary :-)
-  * <del>You cannot add more than one table per dokuwiki page.</del> Fixed since 2013-05-25
-===== Future ideas =====
-  * <del>Add dtables to wiki search results.</del> Depraced since dtable uses standard dokuwiki tables
-  * <del>Do something to prevent two users from overwriting data when their working with the table at the same time.</del>Achieved since 2013-09-16
-  * Add possibility to use normal buttons to manage table instead of popup menu.
-  * Add add a mechanism that will prevent the user from breaking the table for ex by mixing colspans and rowspans in prohibited way.
 ===== Download and Installation =====
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the URL given above. Refer to [[:Plugins]] on how to install plugins manually.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
 ===== Syntax and Usage =====
@@ Line 57: / Line 36: @@
   </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 ;-)
-===== Migrating from old dtable =====
+===== Development =====
-To migrate from old dtable to the new one, you need to use dtableremote export feature. Read the next section for more information.
-===== I want to use dtable in the old way! =====
+=== Change Log ===
-<del>Don't worry. I've decided to keep backwards compability. If you want to use dtable in the old way install dtableremote plugin(remember that this plugin needs standard dtable plugin): [[https://github.com/hafron/dokuwiki-plugin-dtableremote/archive/master.zip]].</del>
-It's time to break it ;-) . I highly recomended to upgrade your tables to the new stardard but if you want to still use dtable in the old way, you must use it's older version instead of the current one. You can download this older version from [[https://github.com/hafron/dtable/archive/dtableremote-compatibility.zip|here]]. Of course you would also need [[https://github.com/hafron/dokuwiki-plugin-dtableremote/archive/master.zip|dtableremote]].
+{{rss>https://github.com/gkrid/dokuwiki-plugin-dtable/commits/develop.atom date}}
-===== dtableremote =====
+**Releases:**
+{{rss>https://github.com/gkrid/dokuwiki-plugin-dtable/releases.atom description author}}
-==== Download and Installation of dtableremote ====
-**WARNING!** It is important to put:
-<code>
-~~NOCACHE~~
-</code>
-at the top of the page where you want to add dtable. \\
-**It is also important to allow embedded HTML in dokuwiki config manager.**
-==== Syntax and Usage of dtableremote ====
-<code>[dtable table_name "row_type(Header name) row_type(Header name)"]</code>
-table_name is the name of text file where base will be storage
-For now there are three row types:
-  * text - simple text format
-  * file - near the <input> there is a button which allows you to open an "upload file" window **This is now depraced since you can use wiki formatting and toolbox in ordinary text file but if you need such a funcionality please let me know.**
-  * data - at the moment this do nothing but in the futhure this type of filed will allows you to pick a date form js callendar
-Header name - name of header can contains all unicode charters
-Examples:
-<code>[dtable foo "text(Name) text(Last Name) file(Picture) date(Birthday)"]</code>
-**Added in** [[https://github.com/hafron/dtable/commit/7f1fa4705fcafda78944428711ff83f033d71283|7f1fa4705f]]:\\
-If you want to return from dtable to the standard dokuwiki table(or even [[:plugin:exttab2|exttab2]] if you used lists, tables etc. in dtable and you want to preserve them(note: that standard dokuwiki table doesn't support those)). Simply change your dtable syntax to(for standard dokuwiki table):
-<code>[export dtable foo "text(Name) text(Last Name) file(Picture) date(Birthday)"]</code>
-or(for exttab2(note that you must to install [[:plugin:exttab2|exttab2]] plugin and [[https://github.com/hafron/dokuwiki-plugin-dtableremoteexttabexporter/archive/master.zip]] first):
-<code>[export exttab2 dtable foo "text(Name) text(Last Name) file(Picture) date(Birthday)"]</code>
-and save the page. This will cause creation of table at the bottom of the orginal code. Orginal code will also be preserved in the place where it was but will be preceded by two spaces. Just like this:
-  [dtable foo "text(Name) text(Last Name) file(Picture) date(Birthday)"]
-==== Config of dtableremote ====
-There two config options at the moment:
-  * bases_dir - directory where databases files will be storage
-  * max_table_width - the max width of the form row
-----
-===== Changelog =====
-**2016-01-22:**
-  * Ready for PHP 7
-**2015-04-29:**
-  * Closed: https://github.com/hafron/dtable/issues/6
-**2013-11-28 Version 1.3.1:**
-  * Some bug fixed.
-  * Performance improvements.
-**2013-11-28 Version 1.3:**
-  * Huge rebuild of backend. Now plugin should work more reliable and bug #5 is fixed.
-**2013-11-05 Version 1.2.1:**
-  * Integration with [[tablefilterjs]] plugin.
-**2013-09-07 Version 1.2:**
-  * Fused cells should now work correctly
-  * Now plugin doesn't let you add an empty row into the table
-  * When you remove all data form row during edition it's removed
-**2013-06-16 Version 1.1:**
-   * The plugin works on normal dokuwiki tables
-   * Page lock is now supported by the plugin.
-**2013-03-24 Version 1.0beta:**
-   * Now you can use wiki formatting toolbox in the table
-   * Several bugs fixed
-**2013-02-24 Version 1.0alpha:**
-  * In this version I completly rebuild the UI. Now it uses jQuery and is fully ajax. I also added the "Insert before" and "Insert after" that allows you to add new records in any place in the table. I've also rebuild the code and make it more clear and easier to read and develop.
-**2012-05-09 Version 0.1:**
-  * Initial release.
-===== Licence =====
-This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; version 3 of the License
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
 ===== Discussion =====
-beautiful plugins! Great!
+[[https://github.com/gkrid/dokuwiki-plugin-dtable/issues]]
-I would love to see this plugin developed further. There is no fit table-editing tool anymore since Adora-Belle broke edit table. This plugin could help a lot. I do have a suggestion for the interface: instead of a general popup menu simply have the action buttons available per row, or at least a visible button in each row to summon the menu. It would improve usability greatly. Thank you for your commitment! Harald Ronge //2013-04-02//
-Hi,
-I tried using your plugin, I have the following in source
-  ~~NOCACHE~~
-  [dtable foo "text(Name) Max(num1) text(num2) text(num3) text(num4) "]
-I get to see </table> on the top and then the dtable appears right at the bottom of the page. Do you know what I might be missing. - Ritam
-Do you remember about allowing embeded html in dokuwiki opitons? I am working currently on the new version of plugin which will be ready in a couple of days where you can use normal dokuwiki tables instead of remote cvs used by the current dtable relase. This will simplify things a little bit. - Szymon Olewniczak (hafron)
-<del>Is bug! When editing table,where is many files in cell, form splits this files to many cells.(rolew)//2013-06-18//</del> Fixed since 2013-06-27
-<del>Bug: when there is no headers line, the Edit menu opens the previous row instead of the row i clicked. And when there is more than one dtable, Edit menu opens a completely different row</del> I believe it's fixed now. Plese check it if you can. //2013-07-23//
-==== Trouble with sneaky linebreaks in tables in v2013-09-07 ====
-<del>Thanks for your great plugin!  Unfortunately, some of my users are managing to break it :-( by inserting links with linebreaks in them.  DokuWiki still recognizes the table but dtable gets confused and erases or replaces data.  Here's a test case:
-<code>
-<dtable>
-^ Hi ^ mom ^
-| [[This link
-has a linebreak]] | Column 2  |
-|Line 2|and more|
-</dtable>
-</code>
-I hope you can find a way to outsmart my users?  It seems to occur on both Adora Belle and Weatherwax.
-Thanks,
- --- [[user>rikblok|Rik Blok]] //2013/09/11 06:36//</del>
-**Fixed since: 1.3**
-Thanks for working on it, Szymon!  I'm still seeing some bad behaviour in the test case above.  For example, if I right click on the link and choose "Insert after" I'm presented with three columns instead of two.  Entering anything in the third column causes problems.
-Let me know if I can be of any help.
- --- [[user>rikblok|Rik Blok]] //2013/11/30 21:17//
-Try it now. I think that now it should work correctly. --- [[user>ghi|Szymon Olewniczak]] //2013/12/11 09:53//
-====Incompatibility with plugin tabinclude====
-I just updated to version Weatherwax.
-The plugin TabInclude goes wrong.
-Debugging the js I find the following exception.
-SCRIPT5: Type mismatch. The code that goes in error is the following:
-{new Image ('lib / plugins / dtable / images / unmerge.png');
-I've updated the plugin dtable and tabInclude to the latest version.
-Any advice?
+Has anyone tested this plugin with Dokuwiki "Kaos" (2024-02-06)?
-Thanks,
- --- [[user>lanzale]] //2013/09/26 13:47//