This week we have some updates for the ProFields table field (FieldtypeTable). These updates are primarily focused on adding new tools for the editor to facilitate input and management of content in a table field.
Please see the video above (no audio) for an overview of what's new in this version of ProFields Table.
Sorting rows as a group
Previously you could only sort rows one at a time. Now you can select multiple rows and move them as a group. You can select multiple rows by clicking the icon in the row’s first column (the sort icon). And you can select a range of rows by selecting the row that stars the range and then shift-click select the row that ends the range. Once multiple rows are selected, click and hold the sort icon for any of the selected rows and drag the group of rows to the target location. Note that when dragging a group of rows, only the row being dragged is visible — the other rows will become visible once the operation is complete.
Row actions
Once you have one or more selected rows, you can apply actions to them. Below are some of the actions included in this latest version of ProFields Table:
Add rows above or below current selection
Add a given number of rows above (or below) the current selected row(s). If no rows are selected then they will be added to the top (or bottom). When selecting one of the "Add rows" actions, it will prompt you for a quantity of rows to add.
Copy selected rows
Copy all selected rows to paste somewhere else, whether on the same page or another. You can copy rows, then switch to another tab and paste them to another page, without reloading it. Note that rows copied from a particular field can only be pasted into the same field, though it doesn't matter which page they are pasted to, so long as the user has access to edit both the page the rows were copied from and the one they are pasted to. Another thing to note is that only rows that have been previously saved to the page may be copied and pasted.
Paste rows above or below selection
Paste copied rows above (or below) current selected row(s). If there are no selected rows then they will be pasted to the top if pasting "above", or bottom if pasting "below".
Clear copy/paste buffer
This clears any rows currently present in the copy/paste buffer.
Select all and Unselect all
This selects all rows currently in the field. The Unselect all action remove all currently selected rows from the selection, leaving no rows selected. You can also select or unselect rows by clicking the sort arrows for the row.
Select all above or below
This selects all rows above (or below) the currently selected row(s), adding them to the current selection.
Move selected rows to top or bottom
This moves the currently selected row(s) to the top (or bottom) of the field. In some cases this may be more handy than manually dragging the group of rows to the top or bottom, especially on pages having lots of rows in the field.
Delete or undelete selected rows
This deletes (or undeletes) all currently selected rows. If you delete a newly added row (i.e. not yet saved row), it is removed immediately. But if you delete a row that was already present, then it is marked for deletion and not actually deleted until you save the page. Rows marked for deletion can be undeleted by clicking the Trash icon in their row, or by selecting them and then choosing the Undelete action.
How to enable row actions
By default row actions are not enabled but enabling them is a matter of checking one box. Go to Setup > Fields > your_table_field > Details, then scroll to the bottom "Settings & Actions" fieldset. Click to open and check the box for the "Enable row actions?" setting.
If you find the "Enable row actions" setting is disabled, this means that your table has either automatic sorting or pagination enabled. Row actions are not supported when automatic sorting or pagination is enabled.
Small inputs option
If you are using AdminThemeUikit (ProcessWire's current default) you can specify that Table should use smaller inputs. This is particularly useful on large table fields where you have many rows, as it enables you to fit significantly more information in the page editor before you have to scroll. This setting is also disabled by default, but can be enabled via a checkbox immediately below the Row Actions setting.
Required columns
This new version of the Table field also supports required values for many column types. To make a column required, specify required=1 in the column's Settings when editing your table field. While not new to this version, it's also worth pointing out that for "Select" types, you can specify noblank=1 in the column's Settings to prevent it from showing a blank (unselected) option, which is another way of forcing a column to be required.
Download
This version of ProFields table is available for download now as a beta version in the ProFields support board download thread (login required). ProFields Table is part of the ProFields package of Pro modules available for ProcessWire. Because this version (v28) has a lot of new features, it is initially released as a beta version and I recommend testing thoroughly in a development or testing environment before using in a production environment. For the current main/stable version use ProFields Table v26.
The new invoices site profile is a free invoicing application developed in ProcessWire. It enables you to create invoices, record payments to them, email invoices to clients, print invoices, and more. This post covers all the details. More
This simple module gives you the ability to customize the parent/child relationship as it appears in the admin page list, enabling child pages to appear under more than one parent. More
ProcessWire Weekly #554 In the 554th issue of ProcessWire Weekly we'll check out the latest core updates, introduce a couple of new third party modules, and more. Read on!
Weekly.pw / 21 December 2024
Custom Fields Module This week we look at a new ProFields module named Custom Fields. This module provides a way to rapidly build out ProcessWire fields that contain any number of subfields/properties within them.
Blog / 30 August 2024
Subscribe to weekly ProcessWire news
“ProcessWire is like a breath of fresh air. So powerful yet simple to build with and customise, and web editors love it too.” —Margaret Chatwin, Web developer
HMCB
- 8 months ago
- 105
★★★★★Amazing addition to PW. Wow. Thank you, Ryan.
Reply
Mats
Very nice enhancements, thank you Ryan!
Reply