Плагин «Драгметаллы в реле» — Инструкция пользователя

Версия 1.0.0 | WordPress 5.8+

Содержание

Требования
Установка
Активация
Размещение на странице (шорткод)
Поиск реле на сайте
Административная панель — список реле
Добавление нового реле
Редактирование реле
Удаление реле
Загрузка фото реле
Настройки плагина
Справка по металлам
Удаление плагина
Часто задаваемые вопросы

1. Требования

WordPress версии 5.8 или выше
PHP версии 7.4 или выше
База данных MySQL 5.6+ или MariaDB 10.1+
Права администратора на сайте

2. Установка

Способ 1 — через административную панель WordPress

Войдите в административную панель WordPress.
Перейдите в меню Плагины → Добавить новый.
Нажмите кнопку Загрузить плагин в верхней части страницы.
Нажмите Выберите файл и укажите файл relay-metals.zip.
Нажмите кнопку Установить.
Дождитесь завершения установки.

Способ 2 — через FTP

Распакуйте архив relay-metals.zip.
Загрузите папку relay-metals в директорию /wp-content/plugins/ на вашем сервере.
Перейдите в административную панель WordPress в меню Плагины.

3. Активация

Перейдите в меню Плагины → Установленные плагины.
Найдите плагин Драгметаллы в реле.
Нажмите ссылку Активировать.
После активации плагин автоматически создаёт таблицу в базе данных и заполняет её базовым набором из 20 типов реле.
В левом меню административной панели появится пункт Драгметаллы.

Примечание: предзаполненные данные основаны на паспортах изделий и нормативах Минфина СССР. При необходимости их можно редактировать или дополнять.

4. Размещение на странице (шорткод)

Для отображения виджета поиска на любой странице или посте используйте шорткод:

[relay_metals]

Параметры шорткода

Параметр	Значения	По умолчанию	Описание
`title`	любой текст	Содержание драгметаллов в реле	Заголовок виджета
`theme`	`dark`, `light`	`dark`	Тема оформления

Примеры использования

[relay_metals]

[relay_metals theme="light"]

[relay_metals title="Поиск по справочнику" theme="dark"]

Как добавить шорткод на страницу

Создайте новую страницу: Страницы → Добавить новую.
В редакторе Gutenberg добавьте блок Шорткод (или вставьте текстом в классическом редакторе).
Введите
```
[relay_metals]
```
.
Опубликуйте страницу.

5. Поиск реле на сайте

Виджет поиска содержит три поля ввода.

«Тип реле»

Основное поле поиска. Обязательное для заполнения.
При вводе появляется список подсказок с названиями реле из базы данных.
Поиск работает по частичному совпадению: ввод РЭС найдёт все реле серии РЭС.
Навигация по списку подсказок: клавиши ↑ и ↓, выбор — Enter, закрытие — Escape.

«Последние цифры паспорта»

Необязательное поле для уточнения поиска.
Введите последние цифры обозначения паспорта с корпуса или из документации.
Пример: для паспорта ФО.450.020 введите 020.
Если поле не заполнено — показываются все совпадения по типу реле.

«Год выпуска»

Необязательное поле.
Введите год выпуска реле, например 1982.
Фильтрует результаты по диапазону годов выпуска, указанному в паспорте.

Результаты поиска

По каждому найденному реле отображается:

Название, серия, паспорт и диапазон годов выпуска
Метка ◇ ВП для реле с военной приёмкой
Фото реле (если добавлено)
Содержание каждого металла в мг на одно изделие и в граммах
Описание и примечания

6. Административная панель — список реле

Перейдите в меню Драгметаллы → Список реле.
Отображается таблица всех реле. В верхней части страницы показано общее количество записей.

Поиск в административной панели

В строке поиска введите название реле или серию.
Нажмите кнопку Найти.
Для сброса фильтра нажмите ✕ Сбросить.

Столбцы таблицы

Столбец	Описание
Фото	Миниатюра фото реле (40×40 px)
Тип реле	Название и метка ◇ для военной приёмки
Серия	Серийное обозначение
Паспорт	Обозначение паспорта или диапазон
Годы	Диапазон годов выпуска
Au (мг)	Содержание золота
Ag (мг)	Содержание серебра
Pd (мг)	Содержание палладия
Pt (мг)	Содержание платины
Rh (мг)	Содержание родия
Ru (мг)	Содержание рутения
ВП	Отметка военной приёмки ◇
Действия	Кнопки «Изменить» и «Удалить»

7. Добавление нового реле

Перейдите в меню Драгметаллы → Добавить реле.
Заполните форму (описание полей ниже).
Нажмите кнопку 💾 Сохранить.
После сохранения страница обновится и новое реле появится в общем списке.

Основные данные

Поле	Обязательное	Описание
Тип реле	Да	Название реле, например `РЭС-6`
Серия	Нет	Серийное обозначение. Используется для группировки и поиска
Паспорт (от)	Нет	Начальное обозначение паспорта, например `ФО.450.020`
Паспорт (до)	Нет	Конечное обозначение, если реле выпускалось с диапазоном паспортов
Год выпуска (от)	Нет	Начальный год производства
Год выпуска (до)	Нет	Конечный год производства
Военная приёмка (◇)	Нет	Установите флажок, если реле имеет военную приёмку

Содержание металлов

Укажите содержание каждого металла в миллиграммах на одно изделие. Если металл отсутствует — оставьте значение 0.

Золото (Au), мг
Серебро (Ag), мг
Палладий (Pd), мг
Платина (Pt), мг
Родий (Rh), мг
Рутений (Ru), мг

Фото и описание

Фотография — загружается через медиа-библиотеку WordPress (подробнее в разделе 10).
Описание — краткое описание реле, область применения, конструктивные особенности.
Примечания — технические заметки, особенности исполнения, источник данных.

8. Редактирование реле

Перейдите в меню Драгметаллы → Список реле.
Найдите нужное реле в таблице.
Нажмите кнопку Изменить в столбце «Действия».
Откроется модальное окно с формой редактирования.
Внесите необходимые изменения.
Нажмите кнопку 💾 Сохранить.
После успешного сохранения появится сообщение ✓ Сохранено! и страница обновится.

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

9. Удаление реле

Перейдите в меню Драгметаллы → Список реле.
Найдите нужное реле в таблице.
Нажмите кнопку Удалить в столбце «Действия».
Появится диалог подтверждения с названием реле.
Нажмите ОК для подтверждения удаления.
Строка с реле исчезнет из таблицы.

Внимание: удаление необратимо. Восстановить удалённую запись невозможно.

10. Загрузка фото реле

Добавление фото

В форме добавления или редактирования реле найдите блок Фотография реле.
Нажмите кнопку 📷 Загрузить фото.
Откроется стандартная медиа-библиотека WordPress.
Выберите существующее изображение или загрузите новое через вкладку Загрузить файлы.
Выделите нужное изображение и нажмите кнопку Использовать это фото.
Предпросмотр фото появится в форме.
Нажмите 💾 Сохранить, чтобы применить изменения.

Замена фото

Нажмите кнопку 📷 Изменить фото.
Выберите новое изображение в медиатеке.
Сохраните форму.

Удаление фото

Нажмите кнопку ✕ Удалить рядом с предпросмотром.
Предпросмотр сменится на заглушку «Фото не выбрано».
Сохраните форму.

Примечание: удаление фото из формы реле не удаляет файл из медиа-библиотеки WordPress.

11. Настройки Плагин «Драгметаллы в реле»

Перейдите в меню Драгметаллы → Настройки.
Настройте нужные параметры (описание ниже).
Нажмите кнопку Сохранить настройки.

Параметры

Параметр	Описание
Заголовок блока	Текст заголовка виджета на сайте. Используется как значение по умолчанию для шорткода без параметра `title`.
Тема оформления	Тёмная или светлая тема виджета. Применяется ко всем шорткодам без явно указанного параметра `theme`.

Приоритет параметров: параметры, указанные непосредственно в шорткоде, имеют приоритет над настройками плагина.

12. Справка по металлам

Символ	Металл	Типичное расположение в реле
Au	Золото	Гальванические покрытия выводов и контактных групп, корпуса герметичных исполнений
Ag	Серебро	Контактные группы, припои, подвижные части
Pd	Палладий	Контакты из сплавов Ag-Pd, покрытия контактных поверхностей
Pt	Платина	Контакты из платино-иридиевых и других платиновых сплавов
Rh	Родий	Покрытия контактов герконов (магнитоуправляемых контактов)
Ru	Рутений	Покрытия контактов герконов, резистивные элементы

Военная приёмка (◇)

Реле с военной приёмкой (маркировка ◇ на корпусе) содержат драгоценных металлов существенно больше, чем гражданские аналоги того же типа. Это обусловлено более строгими требованиями к надёжности контактов и защите от коррозии. В результатах поиска такие реле отображаются с меткой ◇ ВП.

Единицы измерения

Все значения в базе данных хранятся в миллиграммах (мг) на одно изделие.
В результатах поиска на сайте дополнительно отображается перевод в граммы (г).
Источник данных: паспорта изделий, нормативы Минфина СССР.

13. Удаление Плагин «Драгметаллы в реле»

Внимание: при удалении плагина все данные из базы данных и все настройки будут удалены безвозвратно. Перед удалением рекомендуется сделать резервную копию или экспортировать данные.

Перейдите в меню Плагины → Установленные плагины.
Найдите плагин Драгметаллы в реле.
Нажмите ссылку Деактивировать.
После деактивации нажмите ссылку Удалить.
Подтвердите удаление.

Примечание: загруженные фотографии реле остаются в медиа-библиотеке WordPress и при деинсталляции плагина не удаляются.

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

Виджет не отображается на странице

Убедитесь, что плагин активирован, шорткод добавлен в текст страницы, и страница опубликована (не черновик).

Поиск не находит реле, которое есть в базе

Проверьте правильность написания. Попробуйте ввести только часть названия, например РЭС вместо РЭС-6. Если указан год — проверьте, входит ли он в диапазон годов выпуска для данного реле.

Как посмотреть или изменить предзаполненные данные

Перейдите в Драгметаллы → Список реле. Все предзаполненные реле доступны для редактирования и удаления.

Можно ли использовать несколько виджетов на одной странице

Да. Разместите несколько шорткодов с разными параметрами — каждый будет работать независимо.

Данные о содержании металлов неточные — как исправить

Перейдите в Драгметаллы → Список реле, нажмите Изменить нужного реле, внесите исправления и сохраните.

После обновления WordPress плагин перестал работать

Деактивируйте и повторно активируйте плагин — это пересоздаст таблицу в базе данных (существующие данные сохранятся). Убедитесь, что версия PHP на сервере не ниже 7.4.

Тип реле

Последние цифры паспорта

Год выпуска

💡 Данные основаны на паспортах изделий и нормативах Минфина СССР. Военная приёмка ◇ — повышенное содержание металлов.