2. Posts Table Pro settings page
The plugin settings page (Settings → Posts Table Pro) includes a range of options for setting the defaults in your tables. These will apply to all the tables that you create. (You can override these using the shortcode options for each individual table.)
Enter your license key here. This is essential for the plugin to work.
Select the post type that you wish to display in your tables, e.g. ‘post’, ‘page’ or a custom post type.
Please note that the dropdown lists all the available post types on your website. Please note that some of these may be added automatically by other plugins and it may not be appropriate to list them in a table.
Add a comma separated list (without spaces) of the columns to appear in the table.
This option controls the size of the featured image in the image column. Enter the required image size in pixels, e.g. 50×70 will set the image to 50 pixels wide by 70 pixels high.
Ticking this option will make the featured image in the image column open in a lightbox/popup when someone clicks on it. If you untick this box then clicking on an image will take visitors to the single post page instead. If you wish to disable this behavior then you can do so using the links option, below.
If you are using the content column, then this option controls the number of words that will appear in the table. Enter a whole number.
If you are using the excerpt column, then this option controls the number of words that will appear in the table. Enter a whole number.
Choose whether items in the table are clickable. The following columns can be formatted as links:
image, and any
all to add links to all possible columns,
none to disable all links, or add a comma separated list (without spaces) of the specific columns that should be clickable.
If you have included a ‘button’ column then this option controls the text that appears on the button, for example ‘Read Post’ or ‘VIEW’.
Tick this box if you want to load the contents of the table one page at a time, or if you want the table to load after the rest of the content on your page. This option boosts performance for tables with lots of items, but there are some limitations, so please read the full article about lazy load.
Enter a whole number to specify the maximum number of items that can appear in the table.
Warning: If you are not using the lazy load option then increasing this number could cause performance issues or even server crashes. For big tables, we recommend activating lazy load so that only one page of posts are loaded at a time. If you do this then the post limit option is not applicable.
Posts per page
Enter a whole number to control how many posts appear on each page of the table. If there are more posts than the number of rows per page then pagination links will appear linking to the other pages.
Choose an option for how the table will be sorted when it first loads. (Customers can also sort the table by clicking on any column header.)
Choose whether the table will be ordered in ascending or descending order.
This option controls whether or not filter dropdowns will appear above your tables. You can add filters for categories, tags, author or any custom taxonomy.
- Disabled – no filters will be displayed.
- Enabled – shows all possible filters based on the contents of the table.
- Custom – add a comma separated list (without spaces) of which filters to add.
Positions, shows or hides the keyword search box.
Positions, shows or hides the reset button which lets customers reset the table after performing a search or filter.
Positions, shows or hides the ‘Show [x] posts’ dropdown.
Positions, shows or hides the (e.g. ‘Showing 1 to 10 of 50 posts’).
Positions, shows or hides the pagination buttons.
The table styles (e.g. font size and color) will automatically be inherited from your theme.
Enable this option to override the default styling. You can change the styling of the following elements of the tables:
- External, header and body borders – color and width
- Header background – color
- Header text – color and size
- Main background – color
- Alternating background – color
- Body text – color and size
- Spacing – controls the amount of padding to add around the contents of each cell in the table
To change the color, select from the color picker or add any hexadecimal color value (e.g. #757575). To change the size, use the up/down arrows or enter the size in pixels. Tip: If you want to add an RGB color then you can use a color convertor to get the right value.
You can add more styling using additional CSS.
Choose a style for the pagination buttons.
Tick this box if you want content added by other shortcodes to appear within the table. For example, you might be adding a button shortcode to add other types of button; embedded audio or media players; icon shortcodes; etc.
This option allows the contents of your posts tables to be cached to improve performance and speed up page load times.
If you tick the ‘Caching’ box then you can also set the ‘Cache Expires After’ time to control how often the cache is cleared. Enter a whole number of hours.
More posts table options
The plugin settings page lets you set defaults for the most widely used options. You can override these and use additional options directly in the posts table shortcode. Please see the complete list of shortcode options.
Start creating tables!
Once you have installed the plugin and chosen your default settings, you can start creating tables!