Инструкция для администраторов. Здесь собраны основные правила и советы по наполнению сайта контентом.

Инструкция по управлению контентом сайта Family House

🧭 Где и что редактировать?

Что редактируем	Ссылка на панель	Раздел в инструкции
Отели и Номера (Цены, Галерея, Удобства)	Django Admin	📸 Галерея
Карты (Точки и Координаты)	Django Admin	🗺️ Координаты
Контакты сайта (Телефон, Соцсети)	Django Admin	📞 Контакты
Тексты страниц (Заголовки, Описания)	Wagtail CMS	📝 Редактирование

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

Ссылки на админ-панели:

Основная админка Django: https://familyvacation.me/django-admin/
Админка Wagtail CMS: https://familyvacation.me/admin/ (CMS панель)
Главная страница сайта: https://familyvacation.me/
Список гостиниц: https://familyvacation.me/hotels/
Страница контактов: https://familyvacation.me/contacts/

Учетные данные для входа:

Логин: admin
Пароль: admin123

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

1. Управление главной страницей (Лендинг)

Как редактировать главную страницу:

В админ-панели перейдите в раздел "Страницы" (Pages)
Найдите страницу "Family House - Семейный отель в Герцег-Нови"
Нажмите на название страницы для редактирования

Что можно добавить/изменить:

Текстовые блоки:

Нажмите "+ Добавить блок" → выберите "Заголовок" (Heading)
Или выберите "Параграф" (Paragraph) для обычного текста
В параграфах используйте Rich Text редактор (полужирный, курсив, списки)

Изображения:

Нажмите "+ Добавить блок" → выберите "Изображение" (Image)
Загрузите изображение с компьютера
Добавьте подпись при необходимости

Видео с YouTube:

Нажмите "+ Добавить блок" → выберите "Видео YouTube" (YouTube Video)
Вставьте URL видео YouTube (например: https://www.youtube.com/watch?v=dQw4w9WgXcQ)
Система автоматически встроит видео на страницу

Сохранение изменений:

После редактирования нажмите "Опубликовать" (Publish) внизу страницы
Или "Сохранить черновик" (Save draft) для предварительного просмотра

2. Управление гостиницами и домами

2.1. Добавление новой гостиницы:

Перейдите в раздел "Гостиницы" (Hotels) в левом меню админ-панели
Нажмите "Добавить гостиницу" (Add Hotel) в правом верхнем углу
Заполните основные поля:
Название: Например, "Villa Montenegro" или "Семейный дом у моря"
Описание: Подробное описание гостиницы/дома (можно использовать несколько абзацев)
Адрес: Полный адрес в Герцег-Нови или другом городе
⚠️ Важно: Старые поля "Широта" и "Долгота" считаются устаревшими. Вместо них используйте "Точки на карте" (см. раздел 2.2)

2.2. Добавление точек на карте (Map Points):

После основной информации прокрутите вниз до раздела "Точки на карте" (Hotel map points).

Зачем нужны точки на карте?

Отметить саму гостиницу (основная точка)
Добавить важные места рядом: пляж, магазин, ресторан, автобусная остановка, достопримечательности
Помочь гостям лучше ориентироваться в окрестностях

Как добавить точки:

В разделе "Точки на карте" нажмите на пустую строку или "Добавить ещё один Точка на карте"
Заполните поля для каждой точки:
Широта (Latitude): Например, 42.451847
Долгота (Longitude): Например, 18.537674
Подпись (Caption): Название точки, например:
- "Гостиница Family House" (для основной точки)
- "Пляж Жанице - 5 мин пешком"
- "Супермаркет IDEA"
- "Автобусная остановка"
Основная точка (Is main): ✅ Отметьте ТОЛЬКО для точки самой гостиницы
Порядок сортировки (Order): 0, 1, 2... (для сортировки кнопок на странице)

Как найти координаты:

Способ 1 - Google Maps:
1. Откройте Google Maps
2. Найдите нужное место
3. Щелкните правой кнопкой мыши на точке
4. Выберите координаты в появившемся меню (они скопируются)
5. Формат будет: 42.451847, 18.537674
- Первое число - Широта (Latitude)
- Второе число - Долгота (Longitude)

Способ 2 - Яндекс.Карты:
1. Откройте Яндекс.Карты
2. Найдите место и щелкните правой кнопкой
3. Выберите "Что здесь?"
4. Координаты появятся внизу

Пример заполнения:

Точка 1:
  Широта: 42.451847
  Долгота: 18.537674
  Подпись: Гостиница Family House
  ✅ Основная точка
  Порядок: 0

Точка 2:
  Широта: 42.450123
  Долгота: 18.536789
  Подпись: Пляж - 200 метров
  ☐ Основная точка
  Порядок: 1

Точка 3:
  Широта: 42.451234
  Долгота: 18.538901
  Подпись: Ресторан "Konoba"
  ☐ Основная точка
  Порядок: 2

⚠️ Важно:
- Должна быть ТОЛЬКО ОДНА основная точка (сама гостиница)
- Можете добавить сколько угодно дополнительных точек
- Все точки будут видны на карте Google Maps на странице гостиницы

2.3. Добавление галереи изображений:

В разделе "Фото гостиницы" (Hotel images) вы можете загрузить множество фотографий.

Как добавить фото:

Прокрутите до раздела "Фото гостиницы"
Нажмите "Добавить ещё одно Фото гостиницы"
Для каждого фото заполните:
Фото (Image): Нажмите "Выберите файл" и загрузите изображение
Подпись (Caption): Описание фото, например:
- "Вид с террасы на море"
- "Гостиная с камином"
- "Бассейн и зона отдыха"
Порядок сортировки (Order): 0, 1, 2... (порядок отображения в галерее)

2.4. Добавление видео (YouTube):

В разделе "Видео гостиницы" (Hotel videos) можете добавить видеообзоры с YouTube.

Как добавить видео:

Прокрутите до раздела "Видео гостиницы"
Нажмите "Добавить ещё одно Видео гостиницы"
Заполните поля:
URL видео YouTube (Youtube url): Вставьте полную ссылку на видео
Подпись (Caption): Название видео, например "Видеообзор гостиницы"
Порядок сортировки (Order): 0, 1, 2...

Форматы YouTube URL (все работают):

https://www.youtube.com/watch?v=dQw4w9WgXcQ
https://youtu.be/dQw4w9WgXcQ
https://www.youtube.com/embed/dQw4w9WgXcQ

📌 Совет: Видео будут отображаться в галерее вместе с фото, с иконкой воспроизведения

2.5. Сохранение гостиницы:

После заполнения всех разделов:
1. Нажмите "Сохранить и продолжить редактирование" (Save and continue editing) - для проверки
2. Или "Сохранить" (Save) - чтобы вернуться к списку гостиниц

2.6. Добавление номеров в гостиницу:

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

Как создать номер:

Перейдите в раздел "Номера" (Rooms)
Нажмите "Добавить номер" (Add Room)
Заполните основную информацию:
Гостиница (Hotel): Выберите из выпадающего списка
Название (Name): Например:
- "Студия с видом на море"
- "Двухместный номер Люкс"
- "Семейный номер (4 человека)"
Описание (Description): Подробное описание номера
Площадь (Area): В квадратных метрах, например 35.00
Цена за ночь (Price per night): В евро, например 75.00
Фото (главное) (Photo): Основное фото номера

2.7. Добавление удобств (Amenities) к номеру:

В разделе "Удобства" можете выбрать, что есть в номере.

Стандартные удобства (примеры):

Wi-Fi
Кондиционер
Балкон с видом на море
Телевизор
Мини-бар
Сейф
Ванная с душем
Фен
Кухонный уголок
Парковка

Как добавить удобства:

В разделе "Удобства" найдите нужные в списке
Перетащите их из левого списка в правый
Или используйте двойной клик

💡 Совет: Если нужного удобства нет, создайте его:
1. Откройте в новой вкладке раздел "Удобства" (Amenities)
2. Нажмите "Добавить удобство"
3. Укажите название и CSS-класс иконки (опционально)
4. Сохраните и вернитесь к редактированию номера

2.8. Галерея фотографий номера:

В разделе "Фото номеров" (Room images) добавьте фото конкретного номера.

Как добавить:

Прокрутите до раздела "Фото номеров"
Нажмите "Добавить ещё одно Фото номера"
Для каждого фото:
Фото (Image): Загрузите файл
Подпись (Caption): Например:
- "Спальня с двуспальной кроватью"
- "Вид с балкона"
- "Ванная комната"
- "Кухонная зона"
Порядок сортировки (Order): 0, 1, 2...

2.9. Видео номера (YouTube):

В разделе "Видео номеров" (Room videos) можете добавить видеообзор номера.

Как добавить:

Прокрутите до раздела "Видео номеров"
Нажмите "Добавить ещё одно Видео номера"
Заполните:
URL видео YouTube: Полная ссылка на видео
Подпись: Например "Видеообзор номера Люкс"
Порядок сортировки: 0, 1, 2...

2.10. Редактирование цен:

Изменить цену номера:

Найдите нужный номер в разделе "Номера"
Откройте его для редактирования
Измените поле "Цена за ночь"
Нажмите "Сохранить"

💡 Совет: Можете использовать фильтры для быстрого поиска:
- По гостинице
- По названию номера

3. Управление бронированиями

Просмотр новых броней:

Перейдите в раздел "Бронирования" (Bookings)
Здесь отображаются все заявки на бронирование
Фильтры:
По статусу: Free (Свободно), Pending (Ожидает), Confirmed (Подтверждено)
По датам: Дата заезда/выезда
По гостинице/номеру

Подтверждение брони:

Важно: Когда пользователь нажимает "Забронировать", вы получаете уведомление в Telegram!

Откройте бронирование из списка
Проверьте детали:
Имя и контакты клиента
Даты проживания
Выбранный номер
Измените статус:
"Pending" → "Confirmed" для подтверждения
После подтверждения номер становится недоступен для бронирования другими на эти даты
Нажмите "Сохранить" (Save)

Отправка уведомления вручную:

Выберите одно или несколько бронирований
В выпадающем меню действий выберите "Отправить уведомление в Telegram"
Нажмите "Выполнить" (Go)

4. Управление страницей контактов

В разделе "Страницы" (Pages) найдите "Контакты"
Нажмите для редактирования
Здесь можно изменить:
Адрес: Адрес гостиницы в Герцег-Нови
Телефон: Контактный номер (с кодом Черногории +382)
Email: Электронная почта
Гостиница: Привязать к конкретной гостинице (для отображения карты)

Добавление контентных блоков:

Аналогично главной странице, можете добавить:
- Заголовки
- Текстовые блоки
- Изображения
- YouTube видео
- Форму обратной связи (если требуется)

Нажмите "Опубликовать" (Publish)

5. Управление страницей гостиницы (Hotel Page)

В разделе "Страницы" найдите нужную страницу гостиницы
Редактируйте контент так же, как главную страницу:
Добавляйте блоки с описанием
Загружайте фотографии
Встраивайте видео

6. Работа с медиа-файлами

Управление изображениями:

Перейдите в "Изображения" (Images) в главном меню
Здесь все загруженные изображения
Можете:
Удалять неиспользуемые
Редактировать подписи
Искать по тегам

Оптимальные размеры:

Фото гостиниц: 1920x1080px (пейзажная ориентация)
Фото номеров: 1200x800px
Логотипы: 500x500px (квадрат)
Формат: JPG, PNG (до 5 МБ)

7. Статусы номеров и их логика

Три статуса:

Free (Свободно):
Номер доступен для всех
Отображается в списке доступных
Можно забронировать
Pending (Ожидает подтверждения):
После нажатия "Забронировать" пользователем
Номер ВСЕ ЕЩЕ виден другим пользователям
Другие тоже могут забронировать (создастся несколько заявок)
Вы получаете уведомление в Telegram
Нужно вручную подтвердить
Confirmed (Подтверждено):
Вы подтвердили бронь
Номер СКРЫТ из поиска на эти даты
Никто другой не может забронировать

8. Telegram уведомления

Настройка:

Уведомления настроены и приходят в два бота:
- Бот 1: Chat ID 1233569367384948230
- Бот 2: Chat ID 8383694256

Что приходит в уведомлении:

🔔 Новое бронирование!

Гостиница: [Название]
Номер: [Название номера]
Цена: [€X за ночь]

Даты:
Заезд: [дд.мм.гггг]
Выезд: [дд.мм.гггг]

Гость:
Имя: [Имя]
Email: [email]
Телефон: [телефон]

Статус: В ожидании подтверждения

9. Полезные советы

Резервное копирование:

Регулярно делайте резервные копии через раздел Settings → Database backup (если доступно)

SEO оптимизация:

Для каждой страницы в разделе "Продвижение" (Promote) можно задать:
Meta описание
Ключевые слова
Изображение для социальных сетей

Предпросмотр:

Перед публикацией используйте кнопку "Просмотр" (Preview)
Откроется новая вкладка с предпросмотром страницы

Отмена публикации:

Чтобы скрыть страницу, нажмите "Снять с публикации" (Unpublish)

10. Частые вопросы

Q: Как изменить логотип/название сайта?
A: В админке → Settings → Sites → отредактируйте название сайта

Q: Как добавить новый город/регион?
A: Создайте новую гостиницу с адресом в нужном городе

Q: Как удалить бронирование?
A: Откройте бронирование → внизу кнопка "Удалить" (Delete)

Q: Видео не отображается?
A: Убедитесь, что используете полный URL YouTube в формате:
https://www.youtube.com/watch?v=VIDEO_ID или https://youtu.be/VIDEO_ID

Q: Карта не показывается?
A: Проверьте, что у гостиницы заполнены поля Широта и Долгота

11. Редактирование текста (Layout & Text)

Так как для сайта был создан уникальный «дизайнерский» макет, некоторые тексты редактируются через файлы шаблонов. Вот где их найти:

1. Как редактировать Футер (Черный блок внизу всех страниц)

Файл: hotels/templates/hotels/base.html
- Описание отеля: Ищите текст Family House — ваш уютный уголок... (примерно 430 строка).
- Контакты: Ищите блок <div class="col-lg-4"> со словом Контакты (примерно 444 строка). Там можно заменить адрес, телефон и email.
- Соцсети: Ищите блок social-links (455 строка). Можно заменить ссылки на Facebook, Instagram и WhatsApp.

2. Как редактировать Главную страницу (home_simple.html)

Файл: pages/templates/pages/home_simple.html
- Главный заголовок: Ищите тег <h1> со словами Family House (примерно 14 строка).
- Подзаголовок: Текст Эстетика отдыха в Герцег-Нови... (примерно 17 строка).
- Блоки преимуществ: Ищите блок feature-card (45-75 строки). Там можно изменить заголовки «Локация», «Вид», «Комфорт» и их описания.
- Текст "Магия Герцег-Нови": Находится в блоке about (примерно 85-110 строки).

3. Как редактировать страницу Инструкции

Файл: pages/templates/pages/instruction_simple.html
- Верхний инфо-блок: Текст Инструкция для администраторов... в блоке alert-info (примерно 10 строка).

12. Техническая поддержка

При возникновении технических проблем:
- Проверьте логи контейнера: docker compose logs web
- Перезапустите сервисы: docker compose restart
- Обновите статику: /opt/hotel-booking/update_static.sh

Версия инструкции: 1.1 (точки на карте, информация про добавление номеров и гтиниц)
Дата: Декабрь 2025
Сайт: https://familyvacation.me

Перейти в админ-панель Вернуться на главную

Инструкция по управлению контентом сайта Family House

🧭 Где и что редактировать?

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

Ссылки на админ-панели:

Учетные данные для входа:

1. Управление главной страницей (Лендинг)

Как редактировать главную страницу:

Что можно добавить/изменить:

Текстовые блоки:

Изображения:

Видео с YouTube:

Сохранение изменений:

2. Управление гостиницами и домами

2.1. Добавление новой гостиницы:

2.2. Добавление точек на карте (Map Points):

Зачем нужны точки на карте?

Как добавить точки:

Как найти координаты:

Пример заполнения:

2.3. Добавление галереи изображений:

Как добавить фото:

Рекомендации по фото:

2.4. Добавление видео (YouTube):

Как добавить видео:

Форматы YouTube URL (все работают):

2.5. Сохранение гостиницы:

2.6. Добавление номеров в гостиницу:

Как создать номер:

2.7. Добавление удобств (Amenities) к номеру:

Стандартные удобства (примеры):

Как добавить удобства:

2.8. Галерея фотографий номера:

Как добавить:

Рекомендуемые фото номера:

2.9. Видео номера (YouTube):

Как добавить:

2.10. Редактирование цен:

Изменить цену номера:

3. Управление бронированиями

Просмотр новых броней:

Подтверждение брони:

Отправка уведомления вручную:

4. Управление страницей контактов

Добавление контентных блоков:

5. Управление страницей гостиницы (Hotel Page)

6. Работа с медиа-файлами

Управление изображениями:

Оптимальные размеры:

7. Статусы номеров и их логика

Три статуса:

8. Telegram уведомления

Настройка:

Что приходит в уведомлении:

9. Полезные советы

Резервное копирование:

SEO оптимизация:

Предпросмотр:

Отмена публикации:

10. Частые вопросы

11. Редактирование текста (Layout & Text)

1. Как редактировать Футер (Черный блок внизу всех страниц)

2. Как редактировать Главную страницу (home_simple.html)

3. Как редактировать страницу Инструкции

12. Техническая поддержка