#perch-fieldtype-tabular
A custom field type for Perch CMS that allows input and rendering of tabular data.
##Limitations
- Only supports
type="text"fields. - Table dimensions are not dynamic. The number of rows and columns are specified in the Perch template file and there is no way to change them from the admin.
##Installation
- Download the perch-fieldtype-tabular zip file.
- Extract the tabular folder to perch/addons/fieldtypes.
##Usage
Add the following to your Perch template:
<perch:content id="table_test" type="tabular" rows="10" cols="Header 1, Header 2, Header 3" label="Test Table" />
###Required attributes
type- must be tabular.rows- number of rows to display in the Perch admin. Note that empty trailing rows will not appear in the final output.cols- a comma-separated list of column headers to display in the Perch admin and (optionally) in the final output.
###Optional attributes
limitrows- maximum number of rows to display in the final output. By default all populated rows are displayed.limitcols- maximum number of columns to display in the final output. By default all columns are displayed.noheaders- set to "true" to remove the opening and closing<table>tags and the<thead>section from the final output (leaving just the<tbody>section). You are responsible for providing the remaining table markup. By default the full table is output.
##To Do
- Make compatible with PHP 5.2 (the minimum required PHP version for Perch). PHP syntax errors have been reported with PHP 5.2.17.
- Add support for row headers.
- Do something sensible with mandatory fields. Currently saving always fails on tabular fields that have
required="true"set. - Recover table data after form validation errors. If an error occurs when saving a region (let's say you forget to fill in a required textarea field), the page reloads with all of your entered data intact. But tabular fields revert back to their previously-saved state.
##Feedback Contact me @deepilla.