Шорткоды Table Press
Управление выводом таблиц Table Press при помощи шорткодов
14.03.2015 | 
Автор: 
Обычно таблица TablePress выводится на странице или в записи путем вставки стандартного шорткода типа ⁅table id=N /⁆, где N -идентификатор нужной таблицы.
Но, оказывается, с помощью шорткода таблице можно передать и многие индивидуальные параметры вывода ее на экран именно в этом месте. При том, переданные ей в шорткоде команды будут иметь приоритет перед командами таблицы стилей и настройкой таблицы на странице ее редактирования.
Справку по использовании шорткодов для управления таблицами при их выводе в записях и на страницах можно посмотреть на этой странице автора TablePress.
Например, на конкретной странице только шорткодом, включающим в себя определенные команды можно включить работу 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" /].
Таким образом, с помощью шорткода таблице можно передать следующие индивидуальные параметры:
| Шорткод | Описание |
|---|---|
| [table id=N alternating_row_colors="false" /] | Команда определяет, будет ли таблица иметь стандартную расцветку с чередующимися цветами строк. Допустимые значения "true" и "false". |
| [table id=N cache_table_output="false" /] | Включает или отключает кэширование таблицы при выводе. Допустимые значения "true" и "false". |
| [table id=N column_widths="40px|50px|30px" /] | Команда устанавливает ширину столбцов. Может быть указана в пикселях или в процентах. Разделитель - символ "|" (pipe -труба). |
| [table id=N convert_line_breaks="false" /] | Включает или отключает автоматический перенос строки в ячейках таблицы. Допустимые значения "true" и "false". |
| [table id=N datatables_filter="false" /] | Команда включает и отключает возможность выборки данных пользователем в таблице. Допустимые значения "true" и "false". |
| [table id=N datatables_info="false" /] | Команда включает или отключает вывод пользователю информации о таблице: общее число строк в таблице и количестве строк выведенных на экран. Допустимые значения "true" и "false". |
| [table id=N datatables_lengthchange="false" /] | Команда определяет вывод горизонтальной полосы прокрутки для широких таблиц. Допустимые значения "true" и "false". |
| [table id=N datatables_locale=es_ES /] | Позволяет изменить язык вывода таблицы (использование другого языкового файла lang-*_*.json в папке tablepress/i18n/datatables). Допустимые значения "es_ES ", "ru_RU" и т.д. |
| [table id=N datatables_paginate="false" /] | Команда определяет, будет ли включена разбивка таблицы (просмотр только определенного количества строк на странице) пользователю. Допустимые значения "true" и "false". |
| [table id=N datatables_paginate_entries=20 /] | Параметр команды datatables_paginate. Устанавливает число выводимых на странице строк. Допустимое значение - число. (10, 20, 50 и т.д.) |
| [table id=N datatables_scrolly="500px" /] | Включает вывод таблицы с вертикальным скролл-баром. Параметр - высота выводимой на экран части таблицы: 300px, 500px и т.д. |
| [table id=N datatables_sort="false" /] | Команда включает и отключает возможность сортировки табличных данных пользователем. Допустимые значения "true" и "false". |
| [table id=N extra_css_classes="tp-no-br" /] | Позволяет подключить таблицу к групповому CSS классу. Параметр - название CSS класса. В данном случае: tp-no-br |
| [table id=N first_column_th="false" /] | Команда определяет, будет ли первый столбец определен как заглавный. Допустимые значения "true" и "false". Включение этого параметра в редакторе плагина отсутствует. |
| [table id=N hide_columns="2-4,6,8" /] | Команда скрыть определенные столбцы. Может иметь параметром разделенные запятыми номера строк, разделенные тире диапазоны столбцов, или “all” -все. |
| [table id=N hide_rows="2-4,6,8" /] | Команда скрыть определенные строки. Может иметь параметром разделенные запятыми номера строк, разделенные тире диапазоны строк, или “all” -все. |
| [table id=N print_description="false" /] | Команда включает или отключает вывод описания таблицы на странице или в записи. Допустимые значения "true" и "false". |
| [table id=N print_description_position="below" /] | Команда определяет место вывода описания относительно таблицы на странице или в записи. Допустимые значения “above” или “below” ("выше" или "ниже"). |
| [table id=N print_name="false" /] | Команда определяет вывод наименования таблицы на странице или в записи. Допустимые значения "true" и "false". |
| [table id=N print_name_position="above" /] | Команда определяет место вывода наименования относительно таблицы. Допустимые значения “above” или “below” ("выше" или "ниже"). |
| [table id=N row_hover="false" /] | Команда определяет, будет ли выделятся цветом строка при наведении на нее курсора мышки. Допустимые значения "true" и "false". |
| [table id=N show_columns="2-4,6,8" /] | Команда показать ранее скрытые столбцы. Может иметь параметром разделенные запятыми номера столбцов, разделенные тире диапазоны столбцов, или “all” -все. |
| [table id=N show_rows="2-4,6,8" /] | Команда показывать ранее скрытые строки. Может иметь параметром разделенные запятыми номера строк, разделенные тире диапазоны строк, или “all” -все. |
| [table id=N table_foot="false" /] | Команда определяет, будет ли последняя строка таблицы определена, как строка итога. Допустимые значения "true" и "false". |
| [table id=N table_head="false" /] | Команда определяет, будет ли первая строка определена, как строка заголовка. Допустимые значения "true" и "false". |
| [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.
Рубрика: Плагины WordPress
Что то datatables_info=»false» не работает и даже перестает работать все что после данного шорткода. Точно там синтаксис такой?
И еще с вашего позволения вопрос.
Можно ли с помощью шорткода убрать поиск по таблице? Получается его отсутствие необходимо на одной странице, а на другой отображающей ту же таблицу он нужен, поэтому глобальные правки не подходят.
Все прекрасно работает. Сейчас проверил, и с помощью шорткода
[[table id=a-1 datatables_filter="false" datatables_info="false" /]] убрал как поле выборки (поиска), так и строку с информацией. В вашем случае нужно в этом шорткоде только изменить идентификатор таблицы и заменить двойные квадратные скобки на одинарные.
Полагаю, что этот эффект в вашем случае имел место потому, что Вы набирали шорткод в визуальном редакторе, а он поменял кавычки вокруг false на другие знаки.
Все программные коды лучше набирать в HTML редакторе, в нем таких подмен не происходит.
Дело было в скопипащенных кавычках, прописал руками и все заработало. Сейчас задался другим вопросом, можно ли вывести несколько таблиц в одну и реально сделать ячейку таблицы как ссылку на ячейку другой таблицы, т.е. чтоб при изменении одной менялась и другая
ps
что у вас за временные лимиты на написание коммента стоят? третий раз заново переписываю
Сделать связь данных из ячеек разных таблиц в ТаблеПресс легко. Я уже писал об этом в комментарии на аналогичный вопрос пользователя под ником Аркаша.
Что касается лимита по времени — было по умолчанию установлено в капче 120 секунд. Выключил. Спасибо, что сказали. Посмотрел — эта капча еще и CSS формы ввода сбила в кучу. Надо разбираться.
А подскажите, пожалуйста, как вывести «поиск» на другой странице? К примеру на главной. Есть какой-то шорт-код или каким образом можно сделать?
Коротко можно ответить — нет. Но я, честно говоря, не понимаю смысла вашей задачи. Поиск (точнее выборка) TablePress работает с конкретной таблицей, которая представлена ниже или выше. При вводе данных в поле поиска скрипт сокращает эту таблицу, показывая только поля, содержащие искомый контент. Какой смысл располагать таблицу на одной, открытой в данное время странице, а поле поиска на другой, закрытой? Каким образом в этом случае Вы хотите увидеть результаты поиска?
Если объясните, в чем смысл идеи — может что и придумаем.