Открыть меню
Toggle preferences menu
Открыть персональное меню
Вы не представились системе
Your IP address will be publicly visible if you make any edits.

Добавление кастомных шаблонов для любых устройств: различия между версиями

Материал из Sprut.hub Wiki
Нет описания правки
Нет описания правки
 
(не показано 5 промежуточных версий этого же участника)
Строка 2: Строка 2:


{{QuoteYellow|Все ваши кастомные шаблоны после обновления, автоматически будут интегрированы в новую структуру и появятся в списке доступных шаблонов в Каталоге. Эта операция производится однократно при первом обновлении до новой версии. После обновления и переноса шаблонов во внутреннее хранилище - эти шаблоны не будут считываться с флешки и их редактирование на ней не будет приводить к обновлению шаблонов}}
{{QuoteYellow|Все ваши кастомные шаблоны после обновления, автоматически будут интегрированы в новую структуру и появятся в списке доступных шаблонов в Каталоге. Эта операция производится однократно при первом обновлении до новой версии. После обновления и переноса шаблонов во внутреннее хранилище - эти шаблоны не будут считываться с флешки и их редактирование на ней не будет приводить к обновлению шаблонов}}
{{QuoteGreen|Для приведения старых версий кастомных шаблонов, вы можете воспользоваться [https://kirillashikhmin.github.io/Sprut.Hub_Tools/ валидатором с функцией автоматического исправления шаблона под новую структуру]}}
{{QuoteGreen|Для приведения старых версий кастомных шаблонов к новому формату, вы можете воспользоваться [https://kirillashikhmin.github.io/Sprut.Hub_Tools/ валидатором с функцией автоматического исправления шаблона под новую структуру] За валидатор, выражаем огромную благодарность Kirill Ashikhmin!!!}}


Пользователь может самостоятельно разработать шаблон для своего устройства и загрузить его в Sprut.hub.
Пользователь может самостоятельно разработать шаблон для своего устройства и загрузить его в Sprut.hub.
Строка 8: Строка 8:
Это позволяет не дожидаться, пока разработчики добавят поддержку устройства и пользоваться им до появления официальной поддержки.
Это позволяет не дожидаться, пока разработчики добавят поддержку устройства и пользоваться им до появления официальной поддержки.


== Добавление кастомного шаблона ==
Добавить кастомный шаблон очень просто. Достаточно воспользоваться разделом Каталог в вашем хабе  
Добавить кастомный шаблон очень просто. Достаточно воспользоваться разделом Каталог в вашем хабе  
[[Файл:Шаблоны 007 Добавление кастомного шаблона.png|центр|обрамить]]
[[Файл:Шаблоны 007 Добавление кастомного шаблона.png|центр|обрамить]]
Строка 18: Строка 19:
После сохранения - шаблон сразу доступен для работы с хабом и при поиске устройства для этого шаблона - он автоматически применится к найденному устройству.   
После сохранения - шаблон сразу доступен для работы с хабом и при поиске устройства для этого шаблона - он автоматически применится к найденному устройству.   


{{QuoteYellow|Если папок на флешке нет, их можно создать в соответствии с путем и перечнем протоколов, или настроить резервное копирование и создать первую резервную копию, которая автоматически создается при перезагрузке хаба. После перезагрузки, папки для шаблонов на флешке создадутся автоматически}}
== Редактирование шаблонов ==
Для редактирования доступны только те шаблоны, которые не входят в базовый набор шаблонов Sprut.hub. То есть вы сможете редактировать только те шаблоны, которые вы сами добавили.


== Владельцам Raspberry Pi и WirenBoard ==
Для редактирования, вам нужно выбрать хранилище, контроллер и другие необходимые параметры для фильтра шаблонов. После этого вам необходимо зайти в свойства шаблона (просто нажав на шаблон в списке), и после этого перейти в редактор шаблона
Для владельцев Raspberry Pi можно залить кастомный шаблон через SSH (SFTP) в папку /home/makesimple/.SprutHub/data/Templates
[[Файл:Шаблоны 011 редактирование кастомного шаблона.png|центр|обрамить]]
 
[[Файл:Шаблоны 012 открыть редактор.png|центр|обрамить]]
Для владельцев WirenBoard можно залить кастомный шаблон через SSH (SFTP) в папку /mnt/data/makesimple/.SprutHub/data/Templates
[[Файл:Шаблоны 013 шаблон в режиме редактирования.png|центр|обрамить]]
 
В качестве SFTP клиента можно использовать, например [https://filezilla.ru Filezilla] где необходимо добавить новый хост с IP адресом вашей Raspberry Pi или WirenBoard, на которой установлен Sprut.hub, выбрать протокол SFTP и ввести логин и пароль, который вы используете при подключение к "малине" или "вайрену" по SSH. {{color|red|Для Raspberry Pi - стандартный логин/пароль SSH: pi/raspberry}}
[[Файл:Шаблоны 003 Filezilla.png|центр|обрамить]]
 
== Загрузка кастомного шаблона ==
Ваш кастомный шаблон необходимо скопировать в соответствующую протоколу папку, подключить флешку к хабу и в разделе '''Настройки - Расширенные - Перезагрузить шаблоны'''
[[Файл:Шаблоны 001 Перезагрузить шаблоны.png|центр|обрамить]]Если шаблон некорректный - в логе вы увидите ошибку. Что именно в нем не так - вам придется выяснять самостоятельно.
 
== Обновление шаблонов ==
Обновление шаблонов происходит так же как и при обновлении системы. Появится уведомление о наличии обновлений.
{{QuoteYellow|Если у вас есть кастомные шаблоны и вы обновляете версию шаблонов, стоит внимательно отслеживать события в логе, так как может возникнуть их конфликт. Для всех шаблонов кроме MQTT - приоритетными являются кастомные}}


__ОБЯЗАТЕЛЬНОЕ_ОГЛАВЛЕНИЕ__
__ОБЯЗАТЕЛЬНОЕ_ОГЛАВЛЕНИЕ__

Текущая версия от 02:00, 29 июля 2025

Начиная с версии Sprut.hub release 14717 - WEB 1.5.48, кастомные шаблоны перестают храниться на флешке и меняется их структура. В старом формате - они работать не будут

Все ваши кастомные шаблоны после обновления, автоматически будут интегрированы в новую структуру и появятся в списке доступных шаблонов в Каталоге. Эта операция производится однократно при первом обновлении до новой версии. После обновления и переноса шаблонов во внутреннее хранилище - эти шаблоны не будут считываться с флешки и их редактирование на ней не будет приводить к обновлению шаблонов

Для приведения старых версий кастомных шаблонов к новому формату, вы можете воспользоваться валидатором с функцией автоматического исправления шаблона под новую структуру За валидатор, выражаем огромную благодарность Kirill Ashikhmin!!!

Пользователь может самостоятельно разработать шаблон для своего устройства и загрузить его в Sprut.hub.

Это позволяет не дожидаться, пока разработчики добавят поддержку устройства и пользоваться им до появления официальной поддержки.

Добавление кастомного шаблона

Добавить кастомный шаблон очень просто. Достаточно воспользоваться разделом Каталог в вашем хабе

Вы можете выбрать контроллер, для которого вы загружаете шаблон

И вам доступны варианты: загрузка из файла или вставка в редакторе кода

Вы можете вставить код шаблона в редактор и нажать кнопку сохранить

После сохранения - шаблон сразу доступен для работы с хабом и при поиске устройства для этого шаблона - он автоматически применится к найденному устройству.

Редактирование шаблонов

Для редактирования доступны только те шаблоны, которые не входят в базовый набор шаблонов Sprut.hub. То есть вы сможете редактировать только те шаблоны, которые вы сами добавили.

Для редактирования, вам нужно выбрать хранилище, контроллер и другие необходимые параметры для фильтра шаблонов. После этого вам необходимо зайти в свойства шаблона (просто нажав на шаблон в списке), и после этого перейти в редактор шаблона