Select plugin version:
Since version: v1.0.0
Cell content type
The content type decides how a cell is edited: with a simple text field, with the classic WordPress editor, or not at all. You can set it for the whole table and change it for single columns, rows and cells.
Content types
| Type | When you click the cell | Use it for |
|---|---|---|
| None | Nothing opens, the cell can’t be edited. Its content stays visible, and the Tab key skips the cell. | Content that editors should not change. |
| Simple Text | A plain text field opens directly in the cell. This is the default of a table. HTML code also works here. It is protected by sanitizing, so scripts and other unsafe code won’t run. | Short text and numbers without formatting. |
| Editor | The classic WordPress editor (WYSIWYG) opens in a window. | Formatted text, links, lists and images. |
| Inherit | The cell takes its type from the next higher level: Cell → Row → Column → Table. | The default of columns, rows and cells. |
Set the content type
- Open the settings of the level you want to change: the Settings for the table button, or the menu icon of a column, row or cell.
- Open the Content Type tab.
- Select a type under Type of Content.
- Click Apply Changes.
The tab is available for the table, columns, body rows and body cells. If the table has a header or footer, its rows and cells have the tab as well.
How Inherit works
With Inherit, a level uses the type of the next higher level. The levels are checked in this order, and the first one with its own type wins:
Cell → Row → Column → Table
The table is the top level, so it has no Inherit option. It uses Simple Text by default.
An example, as shown in the video:
- The table is set to Simple Text, so every cell starts as Simple Text.
- A column set to Editor makes all cells in that column Editor cells.
- A row set to None locks its cells, also those in the Editor column, because the row comes before the column.
- A single cell in that row set to Simple Text can be edited again, because the cell comes first.
Editor options
When Type of Content is set to Editor, two more options appear:
- Editor Toolbar sets the buttons of the editor. You can choose the ACF toolbars such as Full and Basic, or Inherit to use the toolbar of the next higher level. You can also add your own toolbars.
- Enable Media Insertion shows or hides the Add Media button in the editor. The options are only shown on a level that is set to Editor itself, not on a level set to Inherit. To change them for a single cell in an Editor column, set that cell to Editor as well.
Field settings
In the settings of the table field in your field group, you decide which content type options editors get. Each level has its own group of checkboxes, for example Settings for the table, Settings for the table columns or Settings for cells in the table body. Two of them belong to the content type, and both are checked by default:
- Contenttype shows the Content Type tab on that level. Without it, editors can’t change the content type there. The level keeps the type it already has.
- Editor, nested under Contenttype, offers the Editor type in the dropdown on that level. Without it, editors can only choose None, Inherit and Simple Text there.
The checkboxes apply per level. To rule out the Editor completely, uncheck Editor in every group. Cells that are already set to Editor remain Editor cells. To give editors a table with fixed parts, set up a default table and set those cells, rows or columns to None. More about the checkboxes in Setup editing options.
Output on the website
When the table is output with get_table() or the shortcode, the content type has this effect:
- Editor: the cell outputs the HTML created in the editor.
- Simple Text: each line break becomes a
brelement. - None: the content is output as it is stored, without
brelements.