|
> > | Edit Table Plugin |
| | |
|
< < | Edit Table Plugin |
> > |
Edit TWiki tables using edit fields, date pickers and drop down boxes
Introduction |
| |
Edit TWiki tables in place, using edit fields and drop down boxes, without having to edit the complete topic. |
| |
Multiple tables per topic are editable, but only one at a time can be edited. |
|
< < | |
| | Per Table Settings
Add a %EDITTABLE{...}% variable just before an existing table to make it editable, or add the variable anywhere in a topic to start a new table. |
|
< < |
- Supported attributes:
| Attribute | Comment | Default | header | Specify the header format of a new table like "|*Food*|*Drink*|". Useful to start a table with only a button | (no header) | format | The format of one column when editing the table. A cell can be a text input field, or any of these edit field types: • Text input field (1 line): | text, <size>, <initial value> | • Textarea input field: | textarea, <rows>x<columns>, <initial value> | • Drop down box: | select, <size>, <option 1>, <option 2>, etc* | * only one item can be selected • Radio buttons: | radio, <size*>, <option 1>, <option 2>, etc | * size indicates the number of buttons per line in edit mode • Checkboxes: | checkbox, <size*>, <option 1>, <option 2>, etc | * size indicates the number of checkboxes per line in edit mode • Fixed label: | label, 0, <label text> | • Row number: | row, <offset> | • Date: | date, <size>, <initial value>, <DHTML date format*> | * see Date Field Type | "text, 16" for all cells | changerows | Rows can be added and removed if "on" Rows can be added but not removed if "add" Rows cannot be added or removed if "off" | CHANGEROWS plugin setting | quietsave | Quiet Save button is shown if "on", hidden if "off" | QUIETSAVE plugin setting | include | Other topic defining the EDITTABLE parameters. The first %EDITTABLE% in the topic is used. This is useful if you have many topics with the same table format and you want to update the format in one place. | (none) | helptopic | Topic name containing help text shown below the table when editing a table. The %STARTINCLUDE% and %STOPINCLUDE% variables can be used in the topic to specify what is shown. | (no help text) | headerislabel | Table header cells are read-only (labels) if "on"; header cells can be edited if "off" or "0" | "on" | editbutton | Set edit button text, e.g. "Edit this table"; set button image with alt text, e.g. "Edit table, %PUBURL%/%SYSTEMWEB%/TWikiDocGraphics/edittopic.gif"; hide edit button at the end of the table with "hide" (Note: Button is automatically hidden if an edit button is present in a cell) | EDITBUTTON plugin setting | buttonrow | Set to top to put the edit buttons above the table. | bottom | javascriptinterface | Use javascript to directly move and delete row without page refresh. Enable with "on", disable with "off". | JAVASCRIPTINTERFACE plugin setting |
|
> > |
- Supported attributes:
| Attribute | Comment | Default | header | Specify the header format of a new table like "|*Food*|*Drink*|". Useful to start a table with only a button | (no header) | format | The format of one column when editing the table. A cell can be a text input field, or any of these edit field types: • Text input field (1 line): | text, <size>, <initial value> | • Textarea input field: | textarea, <rows>x<columns>, <initial value> | • Drop down box: | select, <size>, <option 1>, <option 2>, etc* | * only one item can be selected • Radio buttons: | radio, <size*>, <option 1>, <option 2>, etc | * size indicates the number of buttons per line in edit mode • Checkboxes: | checkbox, <size*>, <option 1>, <option 2>, etc | * size indicates the number of checkboxes per line in edit mode • Fixed label: | label, 0, <label text> | • Row number: | row, <offset> | • Date: | date, <size>, <initial value>, <DHTML date format*> | * see Date Field Type | "text, 16" for all cells | changerows | Rows can be added and removed if "on" Rows can be added but not removed if "add" Rows cannot be added or removed if "off" | CHANGEROWS plugin setting | quietsave | Quiet Save button is shown if "on", hidden if "off" | QUIETSAVE plugin setting | include | Other topic defining the EDITTABLE parameters. The first %EDITTABLE% in the topic is used. This is useful if you have many topics with the same table format and you want to update the format in one place. | (none) | helptopic | Topic name containing help text shown below the table when editing a table. The %STARTINCLUDE% and %STOPINCLUDE% variables can be used in the topic to specify what is shown. | (no help text) | headerislabel | Table header cells are read-only (labels) if "on"; header cells can be edited if "off" or "0" | "on" | editbutton | Set edit button text, e.g. "Edit this table"; set button image with alt text, e.g. "Edit table, %PUBURL%/%SYSTEMWEB%/TWikiDocGraphics/edittopic.gif"; hide edit button at the end of the table with "hide" (Note: Button is automatically hidden if an edit button is present in a cell) | EDITBUTTON plugin setting | buttonrow | Set to top to put the edit buttons above the table. | bottom | javascriptinterface | Use javascript to directly move and delete row without page refresh. Enable with "on", disable with "off". | JAVASCRIPTINTERFACE plugin setting |
|
| | |
|
< < | Using TWiki Variables in the Format Parameter |
> > | Using TWiki Variables in the Format Parameter |
| |
By default, variables in <initial value> (of text input field) and <label text> (of fixed label) get expanded when a new row is added. This can be used for example to add a timestamp to a label. You can escape characters with format tokens if you do not want that. |
| |
$percnt |
Percent sign (%) |
$dollar |
Dollar sign ($) |
|
|
< < | |
| |
Date Field Type |
|
< < |  |
> > | The date field type allows one to choose a date with a popup calendar. Popup calendar works with all modern browsers. The date picker button is inactive if the browser cannot support the popup calendar or if Javascript is disabled. |
| | |
|
< < | The date field type allows one to choose a date with a popup calendar. Popup calendar works with all modern browsers. The date picker button is inactive if the browser cannot support the popup calendar or if javascript is disabled. |
> > | The date format can be defined; the default is taken from the {JSCalendarContrib}{format} configure setting. Date specifiers are described in JSCalendarContrib. Example format for ISO date: format="| date, 10, , %Y-%m-%d |". |
| | |
|
> > |  |
| |
Per Cell Settings |
| | |
|
< < |
-
-
- Move a row by clicking this button next to the row to be moved, then at a destination.
|
> > |
-
-
- Move a row by clicking this button next to the row to be moved, then at a destination.
|
| |
-
-
- Deletes the row next to this button.
|
| |
Plugin Settings |
|
< < | Plugin settings are stored as preferences variables. To reference
a plugin setting write %<plugin>_<setting>%, for example, %EDITTABLEPLUGIN_SHORTDESCRIPTION% |
> > | Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, for example, %EDITTABLEPLUGIN_SHORTDESCRIPTION% |
| |
- One line description, shown in the TextFormattingRules topic:
- Set SHORTDESCRIPTION = Edit TWiki tables using edit fields, date pickers and drop down boxes
|
| |
- You can include %-vars now in select values, by quoting them with <nop>, as in %<nop>X% for %X%, say for instance:
select,1,%<nop>X%,%<nop>Y%
|
|
< < | |
| | Installation Instructions |
|
> > | Note: This is a pre-installed TWiki plugin. You should not need to install the plugin unless it is for an upgrade. |
| |
- Download the ZIP file from the Plugin web (see below)
- Unzip
EditTablePlugin.zip in your ($TWIKI_ROOT) directory.
- Alternatively,
- Manually resolve the dependencies listed below. None
- The Plugin depends on the
viewauth script to authenticate the user. As described in TWikiAccessControl, copy the view script to viewauth (or better, create a symbolic link) and add viewauth to the list of authenticated scripts in the .htaccess file.
|
|
< < |
- (Dakar) Visit
configure in your TWiki installation, and enable the plugin in the {Plugins} section.
|
> > |
- Visit
configure in your TWiki installation, and enable the plugin in the {Plugins} section.
|
| |
- Test if the Plugin is correctly installed:
- Check above example if there is an [ Edit table ] button below the table in above example
- Click on [ Edit table ], make changes and save the table
|
|
< < | License
- The Edit Table Plugin is released under the GPL
|
| | Plugin Info
|
|
< < |
|
> > |
|
| |
|
|
< < |
| Plugin Version: |
4.9.1 (17 Apr 2009) |
|
> > |
| Plugin Version: |
5.1 (2010-05-25) |
|
| |
| Change History: |
<-- specify latest version first --> |
|
|
> > |
|
| |
| 17 Apr 2009: |
4.9.1: Save of table can only be done with http POST method, not GET |
| 01 Nov 2008: |
4.9: Arthur Clemens: Fixed rendering of verbatim blocks when editing. Added parameter buttonrow="top" to allow the buttons to be positioned at the top of the table. |
| 26 Sep 2008: |
4.8.7: Arthur Clemens: Let empty table initialize more than one column from header parameter |
|
| |
| 01 Dec 2007: |
4.3: Arthur Clemens: added support for TablePlugin headerrows and footerrows; updated edit button |
| 16 Oct 2007: |
4.2: Arthur Clemens: refactoring, bug fixes. |
| 07 Oct 2007: |
15182: PTh: Added VarEDITTABLE to have it listed in TWikiVariables |
|
|
< < |
| 15 Mar 2007: |
Arthur Clemens: Fixed eating of double newlines; icons for javascript buttons and interface improvements. By default the javascript interface is turned off, set JAVASCRIPTINTERFACE to use it in edit mode. |
|
> > |
| 15 Mar 2007: |
Arthur Clemens: Fixed eating of double newlines; icons for Javascript buttons and interface improvements. By default the Javascript interface is turned off, set JAVASCRIPTINTERFACE to use it in edit mode. |
|
| |
| 05 Mar 2007: |
Byron Darrah: Added ability to dynamically move and delete rows. |
| 12 Oct 2006: |
Item2982 Use default date format from JSCalendarContrib |
| 02 Oct 2006: |
Item2884 Check also for access permission in meta data; proper fix to not warn if oneself has a lock on topic |
|
| |
| 20 Dec 2003: |
Fixed bug where calendar did not work after adding a row (TWiki:Main/PaulineCheung); added all language files of Mishoo DHTML calendar 0.9.5 |
| 13 Dec 2003: |
Added CHANGEROWS, JSCALENDARDATEFORMAT, JSCALENDARLANGUAGE, JSCALENDAROPTIONS settings |
| 16 Oct 2003: |
small typo fixed (garbled if ---+ header on top) |
|
|
< < |
| 15 Oct 2003: |
new date field type with javascript calendar - CN |
|
> > |
| 15 Oct 2003: |
new date field type with Javascript calendar - CN |
|
| |
| 14 Oct 2003: |
docfix: the documentation page was an old one - CN |
| 13 Oct 2003: |
bugfix: %-vars in select were resetted to first on add/del row - CN |
| 18 Sep 2003: |
incompatibility: changed default of changerows to on; support for %-vars, Quiet save for saving without notification; all other fixes in Dev topic integrated - CN |
|
| |
|
|
< < | Related Topics: VarEDITTABLE, TWikiPreferences, TWikiPlugins |
> > | Related Topics: VarEDITTABLE, TWikiPreferences, TWikiPlugins |
| | |
|
< < |
| META FILEATTACHMENT |
attr="h" comment="" date="1071283396" name="EditTablePluginCalendarExample.gif" path="EditTablePluginCalendarExample.gif" size="7823" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Screenshot" date="1077050633" name="ScreenshotEditCell1.gif" path="ScreenshotEditCell1.gif" size="2017" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Screenshot" date="1077050702" name="ScreenshotEditCell2.gif" path="ScreenshotEditCell2.gif" size="3199" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Component of Mishoo DHTML calendar" date="1077813483" name="img.gif" path="img.gif" size="145" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Component of Mishoo DHTML calendar" date="1077813470" name="menuarrow.gif" path="menuarrow.gif" size="68" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Edit table image button" date="1077933805" name="edittable.gif" path="edittable.gif" size="298" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript button: move row" date="1077933805" name="btn_move.gif" path="btn_move.gif" size="298" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript button: move target (animated)" date="1077933805" name="btn_target.gif" path="btn_target.gif" size="298" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript button: delete row" date="1077933805" name="btn_delete.gif" path="btn_delete.gif" size="298" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript button: delete (disabled)" date="1077933805" name="btn_delete_disabled.gif" path="btn_delete_disabled.gif" size="298" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Plugin Style Sheet" date="1077933805" name="edittable.css" path="edittable.css" size="298" user="TWikiContributor" version="1.1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript for table editing without page refresh" date="1077933805" name="edittable.js" path="edittable.js" size="298" user="TWikiContributor" version="1.1" |
|
> > |
| META FILEATTACHMENT |
attr="h" comment="" date="1071283396" name="EditTablePluginCalendarExample.gif" path="EditTablePluginCalendarExample.gif" size="7823" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Screenshot" date="1077050633" name="ScreenshotEditCell1.gif" path="ScreenshotEditCell1.gif" size="2017" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Screenshot" date="1077050702" name="ScreenshotEditCell2.gif" path="ScreenshotEditCell2.gif" size="3199" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Component of Mishoo DHTML calendar" date="1077813483" name="img.gif" path="img.gif" size="145" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Component of Mishoo DHTML calendar" date="1077813470" name="menuarrow.gif" path="menuarrow.gif" size="68" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Edit table image button" date="1077933805" name="edittable.gif" path="edittable.gif" size="298" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript button: move row" date="1077933805" name="btn_move.gif" path="btn_move.gif" size="298" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript button: move target (animated)" date="1077933805" name="btn_target.gif" path="btn_target.gif" size="298" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript button: delete row" date="1077933805" name="btn_delete.gif" path="btn_delete.gif" size="298" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript button: delete (disabled)" date="1077933805" name="btn_delete_disabled.gif" path="btn_delete_disabled.gif" size="298" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Plugin Style Sheet" date="1077933805" name="edittable.css" path="edittable.css" size="298" user="TWikiContributor" version="1" |
| META FILEATTACHMENT |
attr="h" comment="Javascript for table editing without page refresh" date="1077933805" name="edittable.js" path="edittable.js" size="298" user="TWikiContributor" version="1" |
|