release
) → https://demo.grocy.infomaster
ветка) → https://demo-prerelease.grocy.info Посмотрите сайт. → https://grocy.info
Пожалуйста, не пишите мне личные сообщения и не звоните мне по поводу чего-либо, Гроси. Я почти ежедневно проверяю систему отслеживания проблем и сабреддит, но не предоставляю никакой поддержки, кроме этого.
См. на веб-сайте список дополнений/инструментов, предоставленных сообществом. → https://grocy.info/addons
Оформите заказ Grocy Desktop, если вы хотите запускать Grocy без необходимости управлять веб-сервером, как обычное настольное приложение (Windows).
Скачивайте напрямую последнюю версию - установка не что иное, как простое нажатие 2 раз "Далее".
Технически Grocy — довольно простое PHP-приложение, поэтому основные моменты, необходимые для его запуска, следующие:
config-dist.php
в data/config.php
+ отредактируйте в соответствии с вашими потребностями.data
доступен для записиpublic
каталог.try_files $uri /index.php$is_args$query_string;
в вашем блоке местоположения, если вы используете nginxDISABLE_URL_REWRITING
в data/config.php
).admin
с паролем admin
. Немедленно измените пароль (меню пользователя в правом верхнем углу). Альтернативно клонируйте этот репозиторий (ветвь release
всегда ссылается на последнюю выпущенную версию) и установите зависимости Composer и Yarn вручную.
Посетите веб-сайт для получения дополнительных руководств по установке и помощи по устранению неполадок. → https://grocy.info/links
fileinfo
, pdo_sqlite
, gd
, ctype
, intl
, zlib
, mbstring
Инструкции см. в grocy/grocy-docker или linuxserver/docker-grocy.
data
.config-dist.php
на наличие новых параметров конфигурации и добавьте их в свой data/config.php
, где это необходимо (значения по умолчанию из config-dist.php
будут использоваться для настроек, не определенных в data/config.php
)data/viewcache
. Если вы запускаете Grocy в Linux, есть также update.sh
(не забудьте сделать скрипт исполняемым ( chmod +x update.sh
) и убедиться, что у вас установлен unzip
), который делает именно это и дополнительно создает резервную копию (архив .tgz
). текущей установки в data/backups
(резервные копии старше 60 дней будут удалены во время обновления).
Grocy полностью локализуем: языком по умолчанию является английский (интегрирован в код), немецкая локализация всегда поддерживается мной.
Вы можете легко помочь с переводом Grocy на Transifex, если ваш язык неполный или еще недоступен.
Язык по умолчанию можно установить в data/config.php
, например Setting('DEFAULT_LOCALE', 'it');
а также есть пользовательская настройка (см. страницу пользовательских настроек), позволяющая установить разные языки для каждого пользователя.
Предварительная демо-версия доступна для любого перевода, завершенного как минимум на 70 %, и переводы из Transifex будут извлекаться каждые 10 минут каждого часа, так что вы можете иметь своего рода мгновенный предварительный просмотр добавленных вами переводов. Спасибо!
Также в выпуски будут включены любые переводы, уровень завершения которых достиг 70 % (ресурс strings
).
К сожалению, языки RTL пока не поддерживаются.
Домохозяйством нужно управлять. До Grocy я делал это (почти 10 лет), используя свое первое самописное программное обеспечение (приложение форм C# для Windows) и кучу листов Excel. В конце концов, пользоваться программным обеспечением было сложно, а Excel есть Excel. Итак, я искал и пробовал разные вещи в течение (очень) долгого времени, но ничего не подошло на 100%, так что это моя цель - «полное ведение домашнего хозяйства». ERP вашего холодильника!
См. встроенный экземпляр пользовательского интерфейса Swagger в /api.
Веб-интерфейс использует именно этот API практически для всего. Так что все, что вы можете там делать, также возможно через API.
Некоторые поля (со значком штрих-кода выше) также позволяют выбрать значение путем сканирования штрих-кода. Лучше всего это работает, когда ваш считыватель штрих-кодов добавляет к каждому штрих-коду букву, которая обычно не является частью имени элемента (я использую $
), и отправляет TAB
после сканирования.
Кроме того, также можно использовать камеру вашего устройства для сканирования штрих-кода, используя кнопку камеры в правой части соответствующего поля (на базе Quagga2, полностью автономная / обработка потока камеры на стороне клиента; обратите внимание, что из-за ограничений безопасности браузера это работает только при обслуживании Grocy через безопасное соединение ( https://
)). Краткая демонстрация видео: https://www.youtube.com/watch?v=Y5YH6IJFnfc
Моя личная рекомендация: используйте лазерный USB-сканер штрих-кода. Они дешевы и работают на 1000% лучше, быстрее, при любом освещении и под любым углом.
По причинам (производительности) все поля ввода (и отображения) даты (и времени) используют формат ISO-8601 независимо от локализации. Доступны следующие сокращения:
MMDD
расширяется до данного дня текущего года, если > сегодня, или до данного дня следующего года, если < сегодня, в правильных обозначениях.0517
будет преобразовано в 2024-05-17
YYYYMMDD
расширяется до правильной нотации ISO-8601.20240417
будет преобразовано в 2024-04-17
YYYYMMe
или YYYYMM+
расширяется до конца данного месяца в данном году в правильных обозначениях.202407e
будет преобразовано в 2024-07-31
[+/-]n[d/m/y]
расширяется до даты относительно сегодняшнего дня при добавлении ( + ) или вычитании ( - ) количества дней / месяцев / годов в правильных обозначениях.+1m
будет конвертирован в тот же день следующего месяца.x
расширяется до 2999-12-31
(это псевдоним слова «никогда не просрочено») Если кнопка содержит жирную выделенную букву, это клавиша быстрого доступа. Пример: Кнопку « P Добавить как новый продукт» можно «нажать» с помощью клавиши P
на клавиатуре.
Продукты можно напрямую добавлять в базу данных, сопоставляя их с внешними услугами по штрих-коду.
Это можно сделать на месте, используя рабочий процесс выбора продукта «Внешний поиск по штрих-коду (через плагин)» (диалоговое окно рабочего процесса отображается при вводе чего-то неизвестного в любое поле ввода продукта).
Ни для одной службы не включен плагин, см. справочную реализацию в data/plugins/DemoBarcodeLookupPlugin.php
.
Миграция схемы базы данных выполняется автоматически при посещении корневого маршрута ( /
) (нажмите на логотип в левом верхнем краю).
Обратите внимание: миграция базы данных должна работать между выпусками, а не между каждым коммитом. Если вы хотите запустить текущую master
ветку (которая является версией для разработки), вам нужно сделать это (и многое другое) самостоятельно.
Если вы не используете определенные наборы функций Grocy (например, если вам не нужны «Работы»), для каждого основного набора функций есть флаги функций, позволяющие скрыть/отключить соответствующие элементы пользовательского интерфейса (см. config-dist.php
).
data/custom_js.html
существует, содержимое файла будет добавлено непосредственно перед </body>
(конец тела) на каждой странице.data/custom_css.html
существует, его содержимое будет добавлено непосредственно перед </head>
(конец заголовка) на каждой странице. Если для параметра MODE
установлено значение dev
, demo
или prerelease
, приложение будет работать в демонстрационном режиме, что означает, что аутентификация отключена, и некоторые демонстрационные данные будут сгенерированы во время миграции схемы базы данных (передайте параметр запроса nodemodata
, например https://grocy.example.com/?nodemodata
чтобы пропустить это).
Если файл embedded.txt
существует, он должен содержать действительный и доступный для записи путь, который будет использоваться в качестве каталога данных вместо data
, а аутентификация будет отключена (используется в Grocy Desktop).
Во встроенном режиме настройки могут быть переопределены текстовыми файлами в data/settingoverrides
, имя файла должно быть <SettingName>.txt
(например, BASE_URL.txt
), а содержимое должно быть значением параметра (обычно одна строка).
Любая помощь приветствуется, не стесняйтесь высказывать все, что приходит вам на ум, или посетите https://grocy.info/#say-thanks, если вы просто хотите сказать спасибо.
Его нет. Прогресс конкретной ошибки/улучшения всегда отслеживается в соответствующей проблеме, по крайней мере, по ссылкам на комментарии к коммитам.
Вехи используются для указания, в какой версии был выполнен соответствующий запрос ( vNEXT
означает, что в настоящее время это планируется сделать в следующем выпуске).
Лицензия MIT (MIT)