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-установки поддерживает свои собственные примечания к плагинам. Кроме того, супер-админ может иметь свои собственные примечания к плагинам.

Отзывы

17.10.2021
Very useful plugin to note why a certain plugin was installed on the site and any additional context around it, for other admins. Helps in housekeeping especially when there are more than one admins that try different plugins and forget to remove anything that is not wanted.
28.09.2021
So many times I went to go update a plugin and forgot I didn't because the update was broken. This plugin allows me to add notes to remind me of why! Perfect
14.05.2021
This plugin is simple, lightweight, and effective. And it is highly needed functionality. Whether you are writing notes to yourself so you do not forget or leaving notes for a client, this is the answer.
07.05.2021
I was just thinking - wouldn't it be great to add notes to plugins, then i'd know why I or other admins added plugins. Next thought; if that doesn't already exist we are making it. I rarely leave reviews as I'm too busy, but this is an essential plugin, especially for agencies, designers/devs & admins. The problem with unused plugins is ubiquitous - this is a simple and elegant solution. Once I've tested it thoroughly I'll be adding to our base build.
26.03.2021
So simple, but brilliant. I make note of every plugin in use (and where). That makes it easier in the long run to decide if something is being used. Worked great on a multi-developer sight so we knew who was adding what, and why.
Посмотреть все 45 отзывов

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

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

Участники

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

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

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

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

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

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

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