🐹 WordPress: Управление выводом таблиц TablePress при помощи шорткодов.

Содержание:

1. Шорткоды.
2. Оригиналы источников информации.


1. Шорткоды.

Внимание! Так как разметка TablePress сразу видит символы «[» и «]«, то разместить их на этой странице не удалось. Плагин думает, что это разметка для него. Поэтому эти символы я заменил на похожие «» и ««. Когда будете использовать строки из примеров, просто замените символы «» и «» на символы «[» и «]» и TablePress пересчитает вашу разметку исправно.

Обычно таблица TablePress выводится на странице или в записи путем вставки стандартного шорткода типа:

⁅table id=N /⁆

где N — идентификатор нужной таблицы.

Но, оказывается, с помощью шорткода таблице можно передать и многие индивидуальные параметры вывода ее на экран именно в этом месте. При этом, переданные ей в шорткоде команды, будут иметь приоритет перед командами таблицы стилей и настройкой таблицы на странице ее редактирования.

Справку по использовании шорткодов для управления таблицами при их выводе в записях и на страницах можно посмотреть на странице автора TablePress.

Ссылка на страницу автора: tablepress.org.

Например, на конкретной странице только шорткодом, включающим в себя определенные команды можно включить работу DataTables, JavaScript и сортировку таблицы пользователем:

⁅table id=N use_datatables=true datatables_sort=true /⁆

Таким образом можно вывести таблицу в окне высотой 500рх с вертикальным скролл-баром:

⁅table id=N datatables_scrolly="500px" /⁆

Можно определить новую ширину столбцов:

⁅table id=N column_widths="40px|50px|30px|40px" /⁆

или так:

⁅table id=N column_widths="20%|20%|20%|40%" /⁆

Можно скрыть строки с 1-й по 4-ю, а так же 6-ю и 8-ю:

⁅table id=N hide_rows="2-4,6,8" /⁆

Таким образом, с помощью шорткода таблице можно передать следующие индивидуальные параметры:

Номер про порядкуШорткодОписание
1
⁅table id=N alternating_row_colors="false" /⁆
Команда определяет, будет ли таблица иметь стандартную расцветку с чередующимися цветами строк. Допустимые значения "true" и "false".
2
⁅table id=N cache_table_output="false" /⁆
Включает или отключает кэширование таблицы при выводе. Допустимые значения "true" и "false".
3

⁅table id=N column_widths="40px|50px|30px" /⁆

Команда устанавливает ширину столбцов. Может быть указана в пикселях или в процентах. Разделитель - символ "|" (pipe -труба).

4

⁅table id=N convert_line_breaks="false" /⁆

Включает или отключает автоматический перенос строки в ячейках таблицы. Допустимые значения "true" и "false".

5

⁅table id=N datatables_filter="false" /⁆

Команда включает и отключает возможность выборки данных пользователем в таблице. Допустимые значения "true" и "false".

6

⁅table id=N datatables_info="false" /⁆

Команда включает или отключает вывод пользователю информации о таблице: общее число строк в таблице и о количестве строк, которые выведенны на экран. Допустимые значения "true" и "false".

7

⁅table id=N datatables_lengthchange="false" /⁆

Команда определяет вывод горизонтальной полосы прокрутки для широких таблиц. Допустимые значения "true" и "false".

8

⁅table id=N datatables_locale=es_ES /⁆

Позволяет изменить язык вывода таблицы (использование другого языкового файла lang-*_*.json в папке tablepress/i18n/datatables). Допустимые значения "es_ES ", "ru_RU" и так далее.

9

⁅table id=N datatables_paginate="false" /⁆

Команда определяет, будет ли включена разбивка таблицы (просмотр только определенного количества строк на странице) пользователю. Допустимые значения "true" и "false".

10

⁅table id=N datatables_paginate_entries=20 /⁆

Параметр команды datatables_paginate. Устанавливает число выводимых на странице строк. Допустимое значение - число. (10, 20, 50 и так далее.)

11

⁅table id=N datatables_scrolly="500px" /⁆

Включает вывод таблицы с вертикальным скролл-баром. Параметр - высота выводимой на экран части таблицы: 300px, 500px и так далее.

12

⁅table id=N datatables_sort="false" /⁆

Команда включает и отключает возможность сортировки табличных данных пользователем. Допустимые значения "true" и "false".

13

⁅table id=N extra_css_classes="tp-no-br" /⁆

Позволяет подключить таблицу к групповому CSS классу. Параметр - название CSS класса. В данном случае: tp-no-br.

14

⁅table id=N first_column_th="false" /⁆

Команда определяет, будет ли первый столбец определен как заглавный. Допустимые значения "true" и "false". Включение этого параметра в редакторе плагина отсутствует.

15

⁅table id=N hide_columns="2-4,6,8" /⁆

Команда скрыть определенные столбцы. Может иметь параметром разделенные запятыми номера строк, разделенные тире диапазоны столбцов, или “all” -все.

16

⁅table id=N hide_rows="2-4,6,8" /⁆

Команда скрыть определенные строки. Может иметь параметром разделенные запятыми номера строк, разделенные тире диапазоны строк, или “all” -все.

17

⁅table id=N print_description="false" /⁆

Команда включает или отключает вывод описания таблицы на странице или в записи. Допустимые значения "true" и "false".

18

⁅table id=N print_description_position="below" /⁆

Команда определяет место вывода описания относительно таблицы на странице или в записи. Допустимые значения “above” или “below” ("выше" или "ниже").

19

⁅table id=N print_name="false" /⁆

Команда определяет вывод наименования таблицы на странице или в записи. Допустимые значения "true" и "false".

20

⁅table id=N print_name_position="above" /⁆

Команда определяет место вывода наименования относительно таблицы. Допустимые значения “above” или “below” ("выше" или "ниже").

21

⁅table id=N row_hover="false" /⁆

Команда определяет, будет ли выделятся цветом строка при наведении на нее курсора мышки. Допустимые значения "true" и "false".

22

⁅table id=N show_columns="2-4,6,8" /⁆

Команда показать ранее скрытые столбцы. Может иметь параметром разделенные запятыми номера столбцов, разделенные тире диапазоны столбцов, или “all” -все.

23

⁅table id=N show_rows="2-4,6,8" /⁆

Команда показывать ранее скрытые строки. Может иметь параметром разделенные запятыми номера строк, разделенные тире диапазоны строк, или “all” -все.

24

⁅table id=N table_foot="false" /⁆

Команда определяет, будет ли последняя строка таблицы определена, как строка итога. Допустимые значения "true" и "false".

25

⁅table id=N table_head="false" /⁆

Команда определяет, будет ли первая строка определена, как строка заголовка. Допустимые значения "true" и "false".

26

⁅table id=N use_datatables="false" /⁆

Команда определяет, будут ли включены функции DataTables JavaScript. Допустимые значения "true" и "false". Для этого первая строка тем или иным способом должна быть определена как заголовок.

Все команды в шорткоде исполняются последовательно.

Например, таким образом можно вывести на странице только 2-ю и 4-ю строку таблицы N:

⁅table id=N hide_rows="all" show_rows="2,4" /⁆

таким — только 2-й и 4-й столбцы:

⁅table id=N hide_columns="all" show_columns="2,4" /⁆

а так и вовсе вывести на страницу всего одну ячейку из таблицы N:

⁅table id=N hide_columns="all" show_columns="2" hide_rows="all" show_rows="2" /⁆

Существует еще одна возможность использования шорткода. Это вывод таблицы на конкретной странице с особым дизайном.

Например — с невидимыми границами. Для этого вы можете подсоединить эту таблицу с помощью шорткода к уже имеющемуся у вас групповому CSS классу типа «tablepress-no-border», или к вновь созданному. Никто не мешает создать групповой CSS класс и для единственной таблицы. Потом пригодится.

Подсоединить таблицу к групповому CSS классу с помощью следующего шорткода:

⁅table id=N extra_css_classes="tablepress-no-border" /⁆

Таким образом использование команд в шорткодах, которыми мы можем управлять выводом таблиц на конкретных страницах, значительно расширяет наши возможности при использовании TablePress.

3. Оригиналы источников информации.

  1. 1arkona.ru «Управление выводом таблиц Table Press при помощи шорткодов».