Plugin Notes Plus

Описание

Вам случалось возвращаться на созданный вами ранее сайт и задаваться вопросом: «Для чего я поставил тот или иной плагин?» Этот плагин добавит дополнительный столбец на странице «Плагины», что позволит вам добавлять, редактировать или удалять примечания о плагинах, которые вы установили на конкретном сайте. Эти примечания предназначены для обеспечения возможности документирования, почему был установлен конкретный плагин и как и где он используется.

Возможности

  • Добавление стольких примечаний, сколько требуется для каждого плагина.
  • Редактирование или удаление примечаний при желании.
  • Возможность выбора иконки к каждому примечанию, для быстрого отображения типа содержащейся информации (например, информационной, предупреждающей, ссылки и т.д.).
  • Форматирование примечаний с использованием основных тегов HTML, при желании.
  • Любые ссылки, включенные в примечания, будут автоматически преобразованы в target="_blank"
  • Примечания добавляются и обновляются через Ajax, что позволяет избежать медленных перезагрузок страницы.
  • Примечания также отображаются на странице обновлений WordPress для всех плагинов в списке обновлений.
  • Имеется фильтр, позволяющий, если вы хотите, отобразить примечание под описанием плагина, а не в отдельном столбце.
  • Доступен фильтр для выборочного скрытия или отображения заметок к плагинам в админке.

Скриншоты

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

Установка

  1. Вы можете установить плагин через раздел «Плагины» вашего WordPress, или загрузить файлы вручную на свой сервер, распаковав файл .zip и поместив его содержимое в каталог /wp-content/plugins/.
  2. Активируйте плагин на странице «Плагины» в панели управления WordPress.
  3. Добавляете, редактируйте или удаляйте примечания к плагинам в разделе «Плагины > Установленные» столбец «Примечание».

Часто задаваемые вопросы

Могу ли я отобразить примечание к плагинам под описанием плагина, а не в отдельном столбце?

С версии 1.2.4 вы можете использовать фильтр plugin-notes-plus_note_placement, чтобы переместить примечания под описание плагина.

Вот пример фрагмента кода, который помещает примечание к плагину под его описание. Он может быть добавлен в functions.php вашей дочерней темы. Без этого добавления, позиция примечания будет по умолчанию – в виде отдельного столбца на странице плагинов.

function pnp_change_note_placement( $note_placement ) {

    $note_placement = 'description';

    return $note_placement;

}
add_filter( 'plugin-notes-plus_note_placement', 'pnp_change_note_placement' );

Могу ли я изменить список иконок отображающихся рядом с примечаниями плагинов?

Да, вы можете использовать фильтр plugin-notes-plus_icon_options, чтобы изменить набор доступных значков. Иконки должны быть выбраны из списка доступных иконок панели управления WordPress.

Вот пример фрагмента, который удаляет одну иконку и добавляет другую, дополнительную иконку, в список. Добавляется в functions.php вашей дочерней темы:

function pnp_change_icon_options( $icon_options ) {

    // Remove key option
    unset( $icon_options['dashicons-admin-network'] );

    // Add smartphone option
    $icon_options['dashicons-smartphone'] = 'Smartphone';

    return $icon_options;
}
add_filter( 'plugin-notes-plus_icon_options', 'pnp_change_icon_options' );

Какие HTML-теги разрешены, и можно ли изменить этот список?

Вы можете использовать следующие HTML-теги: a, br, p, b, strong, i, em, u, hr.

Чтобы изменить список доступных тегов, используйте фильтр plugin-notes-plus_allowed_html. Однако будьте осторожны, чтобы не допустить появления тегов, которые могут сделать сайт уязвимым для XSS-атаки.

function pnp_change_allowed_html_tags( $allowed_tags ) {

    // Remove br from allowed tags
    unset( $allowed_tags['br'] );

    // Add img to allowed tags
    $allowed_tags['img'] = array();

    return $allowed_tags;
}
add_filter( 'plugin-notes-plus_allowed_html', 'pnp_change_allowed_html_tags' );

Где сохранены данные?

Примечания к плагинам и метаданные хранятся в отдельной таблице название которой заканчивается на plugin_notes_plus. В первоначальной версии (1.0.0), примечания сохранялись в таблице options. Версия 1.1.0 была выпущена для переноса существующих примечаний из таблицы options в таблицу plugin_notes_plus. Обновление до версии 1.1.1 выполнит очистку, удалив все примечания из таблицы options.

Как это работает в установленном режиме Multisite?

Каждый сайт multisite-установки поддерживает свои собственные примечания к плагинам. Кроме того, супер-админ может иметь свои собственные примечания к плагинам.

Могу ли я скрыть заметку о плагине от определенных пользователей?

Начиная с версии 1.2.6, вы можете использовать фильтр plugin-notes-plus_hide_notes, чтобы отобразить или скрыть заметку к плагину.

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

function pnp_hide_notes( $hide_notes ) {

    // logic to set $hide_notes to TRUE or FALSE

    return $hide_notes;

}
add_filter( 'plugin-notes-plus_hide_notes', 'pnp_hide_notes' );

Отзывы

28.06.2024
I currently manage 5 wordpress websites and after adding a snippet modification to push the note under the plugin description information, I can see this plugin is going to be a time saver moving forward, because now when I run across a plugin that is not compatible with the version of WP that must be run on the website, I can make a note to let me know NOT to update the plugin as long as the site is running on version X.Y of wordpress. Some type of plugin «freeze» feature should be REQUIRED FOR ALL PLUGINS!!! At least then constant site breakage from updates (or allowing autoupdates) to plugins could possibly be mitigated. (I use downgrade to freeze core updates as that too causes WP to be completely unreliable for self-hosted web sites.)
25.03.2024
Plugin Notes Plus is a great tool to help yourself (and any other administrators) remember why a particular plugin is installed, how or where it is used, or if there are any things you want to keep an eye on with a plugin. Of course, you could also create a spreadsheet of installed plugins and add notes to it there, but that is much more cumbersome to keep up to date. Because Plugin Notes Plus adds a column on the Plugins page itself, you can see all the relevant information at a glance. IMHO, this plugin is quite indispensable.
31.10.2023
Going back to sites after an absence I nearly always wonder why a plugin is installed. No longer! Brilliant in concept and so easy to use.
18.10.2023
Extremely helpful plugin! But guys, can you please update it so it can be compatible with latest Wordpress version? Love from France <3
21.02.2023
Este plugin es una maravilla para quienes trabajamos es varios proyectos, y tenemos que dejar de lado por un momento un, para continuar en otro.
Посмотреть все 58 отзывов

Участники и разработчики

«Plugin Notes Plus» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

«Plugin Notes Plus» переведён на 8 языков. Благодарим переводчиков за их работу.

Перевести «Plugin Notes Plus» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

1.2.8

  • Fixed: Checking for user permission on ajax requests.

1.2.7

  • Fixed: Cross site scripting (XSS) vulnerability related to icon rendering.

1.2.6

  • Добавлено: возможность выборочного отображения или скрытия заметок к плагинам. Спасибо @garconis за предложение.

1.2.5

  • Исправлено: предупреждение PHP (PHP warning), вызванное устаревшим использованием wp_localize_script. Спасибо @brianhenryie за выявление этого.

1.2.4

  • Добавлено: опция для отображения примечаний под описанием плагина. Спасибо @antipole за предложение.

1.2.3

  • Добавлено: Иконка «деньги» в списке вариантов. Спасибо @brianhenryie.

1.2.2

  • Добавлено: Обновления для совместимости с RTL. Спасибо @ramiy.
  • Удалено: ненужные po и mo файлы переводов.

1.2.1

  • Исправлено: ошибка JavaScript, которая иногда возникала в update-core.php, если в плагине не было примечаний. Спасибо @brianhenryie за то, что обратили на это моё внимание.
  • Добавлено: венгерский перевод. Спасибо @tomek00.

1.2.0

  • Добавлено: примечания к плагинам теперь отображаются в формате только для чтения на странице обновлений WordPress (update-core.php). Спасибо @douglsmith за предложение.
  • Исправлено: убран ненужный мультисайтовый хук. Спасибо @foomagoo за указание на это.

1.1.2

  • Исправлено: ошибка, которая мешала пользователю добавлять или обновлять заметки после ответа Ajax. Спасибо @anticosti за помощь в выявлении этой ошибки.
  • Добавлено: вращающаяся иконка, указывающая, что примечание в процессе удаления.

1.1.1

  • Добавлено: Процедура очистки для удаления примечаний из таблицы options. (При обновлении с 1.0.0 примечания сначала будут перенесены в собственную таблицу.)

1.1.0

  • Исправлено: ошибка приводившая к исчезновению примечаний к плагинам на серверах Windows из-за расхождений в файловому пути к плагину, связанному с прямой и обратной косой чертой. Это обновление восстановит отсутствующие примечания. Спасибо @gwalsh66 за помощь в выявлении этой ошибки.
  • Изменено: примечания к плагинам теперь будут храниться в отдельной таблице $wpdb->prefix . 'plugin_notes_plus'
  • Добавлено: процедура переноса примечаний из таблицы options в собственную таблицу при обновлении с версии 1.0.0
  • Добавлено: запись в таблице options под названием «plugin_notes_plus_db_version» для определения таблицы базы данных.

1.0.0

  • Релиз первой версии плагина.