Ахтунг, ёкарный бабай!

Закралось сомнение, что информация из этой заметки правдива. Мы когда-то делали заметку Добавляем поиск по метаполю в обычный поиск WordPress. Приходилось извращаться. Получается, благодаря новому хуку, теперь этот код в утиль? К сожалению, нет.

Проверили всё поглуже. На скриншоте код класса WP_Query{}, на нём видно, что кроме полей post_title, post_content и post_excerpt не может быть никаких других полей. Обсуждение об этом можете почитать в тикете #43867 (там говорят, что, возможно, список полей будет расширен).

В общем, описание и примеры отредактированы, невиновные наказаны, непричастные награждены! А нам урок, тщательнее проверять описания других ребят, за что им огромное спасибо, держите в тонусе! Одна голова хорошо, а две урод лучше! Приносим свои извинения 🕊

Функция wp_admin_notice() │ WP 6.4.0

Формирует и выводит на экран HTML код заметки (сообщение, ошибку) в верхней части страницы админ-панели.

Да-да, вы не ослышались! Наконец-то в 2023 году такую функцию добавили и теперь не нужно самостоятельно верстать и выводить такие заметки, как мы это делали на хуке admin_notices. Сконфигурировали функцию - получили результат. Также в функции есть хук-событие wp_admin_notice, пока мы не придумали кейс, где бы он понадобился. Может вы подскажете?

Ещё может пригодиться родительская функция wp_get_admin_notice(), например при проверках в foreach - собираете ошибки в массив, а потом в нужный момент выводите на экран всем скопом (такое поведение можно найти в участке кода формирования меню в админке). Другой кейс из движка - страница с опциями - идёт проверка на наличие той или иной опции (значения) и, если что-то не так, функция вызывается прямо рядом в таблице опций.

Возникает вопрос, ведь заметки призваны отображаться вверху страницы, а не как в предыдущих кейсах в таблице и пунктах меню, как так? А всё просто: специальный JS скрипт после рендринга страницы пробегает по DOM и все заметки перемещает в нужное место в порядке их вывода на экран. Это очень удобно!

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

https://wp-kama.ru/function/wp_admin_notice

Как мы ищем более детальную информацию о хуке или функции?

Если опустить изучение самого кода в движке, то можно сказать сразу идём в трекер и ищем среди тикетов, так как большая часть всякой всячины зарождается именно там. Находим тикет(ы), посвященный, например функции и там узнаём, что за потребность была в ней, какой кейс человек пытался решить внедрением такой функции и много другой не менее интересной информации попадается. Так рождаются более полные описания и добавляются примеры из жизни.

Если вы разрабатываете на WordPress, то крайне рекомендуем посматривать эти тикеты. Так же вы можете помочь другим (а по сути всем, кто пользуется WP), написав патч к описанной в тикете проблемы. Ну или написать свой тикет, если заметили ошибку в движке, или же у вас есть предложения по оптимизации или другое виденье как что-то должно работать по-другому. В этом отчасти сила WordPress - совместная работа и волонтёрство.

https://core.trac.wordpress.org/timeline

Последнее время, я лично, чаще всего пользуюсь специальным сервисом для быстрого поиска по тикетам. Это своего рода индексатор/зеркало/каталогизатор тикетов. Работает быстро, интерфейс приятный, ищет классно. Что ещё надо? :)

Это проект с открытым исходным кодом, можно скачать с github и развенуть у себя при надобности.

Сам проект https://tracsearch.wpteamhub.com/

Насчёт лично опыта.

Это пожалуй основополагающий способ появления описаний и примеров на сайте. Работая на реальных проектах, постоянно появляются примеры, которые 1 - могут пригодиться другим, 2 - 100% рабочие в контексте их использования, 3 - могут понадобиться нам же в будущем. В целом сайт, это наш блокнот: что-то сделали на работе/хобби, пошли добавили на сайт, чтобы потом заново не придумывать и воспользоваться при необходимости. Это касается и кода и вообще мыслей по тому или иному поводу, свои наблюдения, выводы.

И говоря слова "наш сайт" мы имеем в виду более широкий круг людей, чем его редакторы. То есть и вас тоже :) так, ваши вопросы помогают пополнять коллекцию решений, ваши замечания помогают уточнять/исправлять информацию и держать в актуальном состоянии, а также непосредственно ценны ваши наработки, которые вы скидываете в комментариях и в личку. Огромное вам спасибо за это! ❤️🤝

Напоминаем, что у каждого есть возможность добавить свой пример. Заходите на страницу функции, нажимаете кнопку "Добавить пример" и заполняете формочку (см. скриншот). А также вы можете голосовать там же за понравившиеся примеры.

Оказывается, появились настройки в ТГ, которые не доступны сразу. Только по согласию бояр.

Кому не жалко, подайте чуть голосов на развитие https://t.iss.one/wpkama?boost

Привет! Это Денис Янчевский. В былые времена, мы с Николаем Мироновым активно организовывали митапы💪

А сегодня, я представляю вам свою еженедельную рассылку про WordPress и с попугаем. Она бесплатная и выходит по пятницам.

Сегодня как раз вышел третий выпуск https://wphub.space/newsletter/wpletter-17-11-2023/

Отслеживать новые выпуски можно в соцсетях:
👉 Канал в Telegram
👉 Канал в Дзене
👉 Сообщество в ВК

Увидимся! 🤗

С версии 3.15, Query Monitor позволяет разработчикам выполнять проверки, которые создадут запись об ошибке в панели Query Monitor "Логи (Logs)", если проверка не пройдена.

Это удобная обертка для логирования ошибок, которая будет оповещать вас о проблемах в коде.

https://wp-kama.ru/plugin/query-monitor/assertions

Хук-фильтр pre_http_request │ WP 2.9.0

Позволяет оборвать выполнение HTTP запроса и вернуть указанное значение.

Может пригодиться для обрыва HTTP запросов, не грамотно сделанных плагинов, тестирования и других задач.

https://wp-kama.ru/hook/pre_http_request

Статистика вклада сообщества в ядро WordPress за 2023 год.

https://make.wordpress.org/core/2024/01/11/a-year-in-core-2023/

Полезный сайт, где отображены большинство стилей и вёрстка из админки WordPress, которые могут пригодиться при разработке.

https://wpadmin.bracketspace.com/

Шпаргалка по git

https://wp-kama.com/note/git-cheatsheet

Изучаем git

https://learngitbranching.js.org/