Пользовательский плагин с динамическим списком дочерних страниц, отображающих записи базы данных.

Содержание

Вопрос или проблема
Ответ или решение
Теория
Пример
Применение

Вопрос или проблема

Я немного новичок в кодировании на WP (и php) – в основном я разработчик на C#.

Этот вопрос напрямую связан с этим, так как я реализую аналогичный сценарий, используя базу из примера. Мой реальный случай для другой настройки, но аналогия работает хорошо.

У меня есть страница teams.php в шаблоне реализации WP, которая перечисляет мои так называемые команды из кастомной таблицы базы данных. Все работает отлично. Допустим, URL – [base]/teams/.

Аналогично приведенному примеру я хочу показывать членов команды, когда кликаю на команду. Я хочу вызывать URL [base]/teams/{teamid}/ – и члены команды будут ссылаться на [base]/teams/{teamid}/member/{memberid}.

Все компоненты, похоже, есть в приведенном примере вопроса. Но я в растерянности, в какие (в какие файлы) я должен вставить что.

add_filter
add_action
add_shortcode

Должны ли эти функции и правила переписывания быть добавлены в код teams.php или в общие файлы функций где-то в WP? Если да, то в какие именно?

Сейчас у меня есть обзор “команд”, и если я нажимаю на один из элементов [base]/teams/1 (1 – это id), то страница возвращается на [base]/teams без id. Очевидно, переписывание здесь идет неправильно. В моем сценарии использование teams.php для деталей команды подошло бы, но для участников я хотел бы реализовать отдельную страницу member.php.

Спасибо за чтение. Надеюсь, кто-то сможет указать мне путь. Я предполагаю, что это не очень сложно, но я просто не могу разобраться с этим.

Ответ или решение

Создание пользовательского плагина в WordPress, который будет динамически отображать дочерние страницы с записями из базы данных — это задача, которая требует определенного уровня понимания как WordPress API, так и языка программирования PHP. Давайте рассмотрим, как можно реализовать данное требование.

Теория

На высоком уровне, WordPress предоставляет несколько механизмов для взаимодействия с его ядром и расширения его функциональности:

Фильтры и действия (Hooks): Фильтры (add_filter) позволяют изменять поведение функций или данных до вывода, а действия (add_action) используются для вызова ваших собственных функций в конкретные моменты выполнения кода WordPress.
Краткие коды (Shortcodes): Используются для быстрого добавления динамического контента в посты, страницы или виджеты.
Правила переписывания (Rewrite Rules): Это способ создания пользовательских URL-структур, которые затем сопоставляются с внутренними обработчиками WordPress. В вашем случае, вы хотите обрабатывать URL вида [base]/teams/{teamid} и [base]/teams/{teamid}/member/{memberid}.

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

Пример

Настройка правил переписывания:

Определите пользовательскую структуру URL с помощью правила переписывания. Используйте хук add_action('init', 'ваша_функция_переписывания'), чтобы зарегистрировать новые URL-маршруты.
```
function мои_переписывания() {
   add_rewrite_rule('teams/([^/]+)/?$', 'index.php?pagename=teams&teamid=$matches[1]', 'top');
   add_rewrite_rule('teams/([^/]+)/member/([^/]+)/?$', 'index.php?pagename=member&teamid=$matches[1]&memberid=$matches[2]', 'top');
}
add_action('init', 'мои_переписывания');
```
Не забудьте обновить правила переписывания после их добавления, используя flush_rewrite_rules().
Получение параметров из URL:

Вам нужно будет получить teamid и memberid из URL и использовать их для получения данных из вашей базы данных.
```
function мои_переменные_query_vars($vars) {
   $vars[] = 'teamid';
   $vars[] = 'memberid';
   return $vars;
}
add_filter('query_vars', 'мои_переменные_query_vars');
```
Создание шаблонов страниц:

WordPress будет использовать шаблоны страниц teams.php и member.php, чтобы отобразить соответствующую информацию. Ваш код в этих файлах должен использовать PHP для обращения к базе данных и отображения информации по teamid или memberid.
```
if (is_page('teams')) {
   $team_id = get_query_var('teamid');
   // Получите данные о команде по $team_id из базы данных
}

if (is_page('member')) {
   $team_id = get_query_var('teamid');
   $member_id = get_query_var('memberid');
   // Получите данные об участнике команды по $team_id и $member_id из базы данных
}
```

Применение

Для реализации этого решения вы можете следовать следующим шагам:

Добавьте правила переписывания и фильтры в файл functions.php вашей темы или в основной файл вашего пользовательского плагина. Это позволит WordPress принимать и обрабатывать новые URL.
Создайте или измените шаблоны teams.php и member.php в вашей теме, чтобы они могли обрабатывать запросы с переменными teamid и memberid.
Используйте при необходимости короткие коды для вставки динамического контента на страницы.

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

Сочетание этих техник и подходов обеспечит вам структуру, которая будет достаточно гибкой для дальнейшего расширения и интеграции новых функций.