Intereting Posts
как «manage_posts_custom_column» action hook относится к «manage _ $ {post_type} _columns» hook hook? Как я могу повторно использовать код для захвата параметра в URL-адрес и поместить его в значение в скрытой форме? Добавить комментарий в поле для каждого опубликованного комментария с помощью SQL Создание настраиваемого поля с раскрывающимся списком на новой почтовой странице Сохранение страницы параметров плагина Заполнение настраиваемых полей при сохранении пользовательских типов сообщений Убедитесь, что в настоящее время на странице статических сообщений Список вывода из каждой строки обмена (короткого кода) Получать сообщения, по крайней мере, с одной категорией с текущим сообщением? WordPress -> If Is Role Subscriber Показать изображение? Диалоговое окно категории диаграммы диаграммы на странице редактирования сообщений Загрузить .doc в блог Автоматически созданное меню Какой фильтр или действие нужно использовать для загрузки кода до того, как шаблон начнет печатать в BuddyPress? Комментарии Disqus требуют много времени для обновления

Почему использование тега @uses в докблоках не рекомендуется?

Стандартные стандарты документации

Примечание. Этот тег использовался в прошлом, но больше не должен использоваться.

Что дает?

Я создаю плагин для создания кода из источника плагина / темы, и я думаю, что тег @uses был бы идеальным для связывания функций с крючками и крючками для функций.

Я не уверен на 100%, но я предполагаю, что это связано с тем, что использование @uses может быть покрыто @see

Из документов phpDocumentor

@uses очень похож на @see, см. документацию для @see для получения подробной информации о формате и структуре. Тег @uses отличается от @see двумя способами. @see является односторонней ссылкой, то есть документация, содержащая тег @see, содержит ссылку на другую документацию. Тег @uses автоматически создает виртуальный тег @usedby в другой документации, которая ссылается на документацию, содержащую тег @uses. Другими словами, это точно так же, как @see, за исключением того, что ссылка возврата добавляется автоматически.

Другое отличие состоит в том, что @uses принимает только один элемент для ссылки и описание этого элемента.

Вероятно, представители WP решили, что нет двух одинаковых тегов, но только поддерживать их.

BTW, @uses – это прекрасный тег. Если вы хотите поддержать его, просто сделайте это и задокументируйте его поддержку в документации.