Differences

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

--- plugin:csv [2017-07-11 18:15] – [Enhancement Considerations] Aleksandr
+++ plugin:csv [2024-02-10 21:12] (current) – Aleksandr
@@ Line 6: / Line 6: @@
 email      : dokuwiki@cosmocode.de
 type       : syntax
-lastupdate : 2017-04-12
+lastupdate : 2022-01-03
-compatible : Frusterick Manners, Hrun, Ponder Stibbons, Binky, Weatherwax, Adora Belle, Angua, Detritus
+compatible : Hrun, Ponder Stibbons, Binky, Weatherwax, Adora Belle, Angua, Detritus, Greebo, Hogfather, Igor, Jack Jackrum
 depends    :
 conflicts  :
 similar    :
 tags       : csv, tables, file
 downloadurl: https://github.com/cosmocode/csv/zipball/master
@@ Line 23: / Line 22: @@
 ===== Description =====
-[[http://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]
+[[http://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ https://www.cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]
-This is a simple [[plugins|plugin]] that will display CSV data in table form.  The data can either be inline between ''%%<csv>%%'' and ''%%</csv>%%''
+This is a simple plugin that will display CSV data in table form.  The data can either be inline between ''%%<csv>%%'' and ''%%</csv>%%''
 <code>
@@ Line 34: / Line 33: @@
 </csv>
 </code>
 or be read from a file in the media area using
 <code>
 <csv namespace:test.csv></csv>
@@ Line 42: / Line 43: @@
 If you are planning to use csv files in the media area, you will most likely need to include the .csv file extension in [[:mime|mime.local.conf]] so you can upload .csv files. Something like this should get you started:
+<code - mime.local.conf>
-  csv     text/csv
+csv     text/csv
+</code>
 The ''%%<csv>%%'' tag allows for additional options to be specified as well as a file reference.
-^ Option                                   ^ Description                                                                                                                                                                                                        ^ Default value  ^
+^ Option                                           ^ Description                                                                                                                                                                                                                               ^ Default value  ^
-| ''file=<filename>''                      | where ''<filename>'' can be any ''<namespace:file.csv>'' or ''<http url>''. The ''file='' prefix is optional. Any option without a name is assumed to be the file name                                             |  ''''          |
+| ''file=<filename>''                              | where ''<filename>'' can be any ''<namespace:file.csv>'' or ''<http url>''. The ''file='' prefix is optional. Any option without a name is assumed to be the file name                                                                    |  ''''          |
-| ''hdr_rows=//<n>//''                     | Format the first //<n>// rows of data from the CSV as column headers                                                                                                                                               |  ''1''         |
+| ''hdr_rows=//<n>//''                             | Format the first //<n>// rows of data from the CSV as column headers                                                                                                                                                                      |  ''1''         |
-| ''hdr_cols=//<n>//''                     | Format the first //<n>// columns of each row as column headers                                                                                                                                                     |  ''0''         |
+| ''hdr_cols=//<n>//''                             | Format the first //<n>// columns of each row as column headers                                                                                                                                                                            |  ''0''         |
-| ''span_empty_cols=//[01]//''             | Create colspans for each empty (two adjacent commas) cell following a cell with content                                                                                                                            |  ''0''         |
+| ''span_empty_cols=//[01]//''                     | Create colspans for each empty (two adjacent commas) cell following a cell with content                                                                                                                                                   |  ''0''         |
-| ''delim=//<char>//''                     | The delimiter used between cells. Specify ''tab'' for a tab separated file.                                                                                                                                        |  '',''         |
+| ''delim=//<char>//''                             | The delimiter used between cells. Specify ''tab'' for a tab separated file.                                                                                                                                                               |  '',''         |
-| ''maxlines=//<n>//''                     | limiting the result set to a certain number of rows                                                                                                                                                                |  ''0''         |
+| ''maxlines=//<n>//''                             | limiting the result set to a certain number of rows                                                                                                                                                                                       |  ''0''         |
-| ''offset=//<n>//''                       | skipping the given number of rows before output                                                                                                                                                                    |  ''0''         |
+| ''offset=//<n>//''                               | skipping the given number of rows before output                                                                                                                                                                                           |  ''0''         |
-| ''filter[//<n>//][//t//]="//<text>//"''  | Allows you to filter the rows. //<n>// is the column number you want to filter on. //t// can either be an ''g'' for globbing or an ''r'' for regexp. Use simple ''*'' in the globbing mode to find partial texts.  |                |
+| ''filter[//<n>//][//t//]=%%"%%//<text>//%%"%%''  | Allows you to filter the rows.\\ \\ //<n>// is the column number you want to filter on. The first column is 1.\\ \\ //t// can either be an ''g'' for globbing or an ''r'' for regexp. Use simple ''*'' in the globbing mode to find partial texts.  |                |
 Cells that include a comma as part of the data are expected to be contained between double quotes, which is the typical behaviour of most systems when exporting .csv files.
 Empty lines in the csv file or data are displayed as horizontal separators in the table.
+Example for a table using a filter. This will look for values beginning with "P" in the third column. It will show the second line.
+<code>
+<csv hdr_rows=0 filter[3][g]="P*">
+ABC,DEF,GHI
+JKL,MNO,PQR
+</csv>
+</code>
 There is a second syntax mode to grab a **single value** from a CSV. This mode does not support inline CSV data!
@@ Line 68: / Line 78: @@
 In addition to all the options supported in the ''<csv>'' syntax, you have to specify which column and (optionally) which row you want to output.
 ===== Download =====
-To install this plugin manually or through the [[plugin]] manager use the following URL:
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
   * https://github.com/cosmocode/csv/archive/master.zip
@@ Line 79: / Line 90: @@
 ==== Enhancement Considerations ====
   * is it possible to add a download-button so that the csv-file could be directly downloaded (especially for inline-data)
   * might be nice to be able to have gridlines
@@ Line 90: / Line 102: @@
   * <del>Use of smileys (for example traffic light based on values)</del> see [[https://github.com/cosmocode/csv/issues/10|Issue #10]]
   * read data from a csv-file stored at Windows Shares like [[wiki:syntax#windows_shares]]
+  * Add row/column header via parameter
+  * Make table sortable by different columns
 ==== Use with a Google Docs Spreadsheet ====