|
> > | 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.
Simply add an [ Edit table ] button to an existing table by writing %EDITTABLE{}% directly above the table. This can be added to tables that are formatted with TablePlugin: add the EDITTABLE variable just above or below the TABLE tag. It can also be used without any TABLE tag. |
|
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 | redirectto | Set up a return page after saving changes. e.g By setting redirectto="%BASEPAGE%", you can return to base page if your editable table is included by another page. | (none) |
|
> > |
- 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 | redirectto | Set up a return page after saving changes. e.g By setting redirectto="%BASEPAGE%", you can return to base page if your editable table is included by another page. | (none) |
|
| |
|
< < | 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. |
|
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
|
|
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" |
|