Документация (в разработке)

Распаковка движка

В конце блока с текстовым описанием раздела Распаковка движка есть Видео инструкция. Если вы лучше воспринимаете видео, можете сразу открыть её! 

Для своих агрегаторов мы используем хостер Beget и виртуальный сервер VPS (CPU: 4 ядра, Память: 6Гб) 

Наше решение можно распаковывать и на любом другом хостинге, но уже могут возникнуть проблемы, которые вам придётся решать силами своего сис админа. Так как все хостеры имеют разные конфигурации и настройки. Если вы выберете beget и будете делать всё по инструкции ниже, то всё получится точно и без сис админа. 

Шаг 1. Перейти на хостинг Beget ссылка 

Шаг 2. Выбрать плашку Облако 

Шаг 3. Выбрать плашку VPS/VDS    

Шаг 4. Выбрать в ручную конфигурацию: 4 ядра, 6 ГБ / Память, 10 ГБ / NVMe 

   Цена может отличаться от той, что на скрине, так как цены со временем меняются.

   Все 3 величины можно будет поменять уже позже. Т.е. это начальные минимальные показатели, которые мы бы рекомендовали. Чем больше будет посетителей на сайте, тем больше нужно будет 1го и 2го показателя (4 ядра, 6 ГБ / Память), а вот 3й показатель отвечает за то сколько у вас будет загружено данных на сайт и сколько будет вообще сайтов. 

Шаг 5. Выбрать панель управления Hestia CP в разделе Готовые решения. 

Эта опция устанавливает вам операционную систему Ubuntu 22 PHP 8 панель управления Hestia CP 

Шаг 6. Нажать кнопку Создать

Шаг 7. Зарегистрироваться                                                                                                                                                                                  

После регистрации вам будет прислан доступ для входа в Личный кабинет на хостинге

В этот личный кабинет также можно зайти с сайта beget

Зайдя в Личный кабинет, вы увидите вот такой экран

Если сразу вы не видите созданный сервер, значит надо ещё подождать. Он может ещё устанавливаться. 

Шаг 8. Приобрести и/или подключить доменное имя

Для того, чтобы подключить доменное имя, нам понадобиться IP адрес сервера. На скрине выше указан IP адрес 62.113.98.216 У вас будет свой адрес и вы копируете его. Он копируется по нажатию.

Если у вас ещё нет доменного имени, вы заходите в раздел Домены/поддомены

Далее - Регистрация доменов

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

Выбираете купленный домен и нажимаете на 3 точки справа от имени домена. В появившемся попапе выбираете - Редактирование DNS

Теперь мы должны отредактироваться DNS записи для нашего домена. Большинство из них выставляются автоматически. Поэтому всё, что нам нужно сделать, это поменять IP адрес. 

Выбираем домен, который мы приобрели и нажимаем иконку ручки.

Вставляем IP адрес (Выше показывал где его скопировать.) своего сервера в первый инпут напротив буквы A (это так называемая A запись). 

И тоже самое проделываем с другим именем домена, которое через www

Через какое-то время изменения вступят в силу, и домен будет вести на ваш сервер. Чтобы удостовериться, что это так. Вам нужно открыть свой домен через браузер и вы должны увидеть такую страницу: 

Если вы видите не такую страницу, то возможно нужно ещё подождать. Изменения не сразу вступают в силу. Но если на протяжении долгого времени такого не происходит, то возможно вы что-то сделали не так. Перепроверьте ещё раз все пункты выше либо напишите в саппорт хостинга.

Если у вас уже был домен и он зарегистрирован у другого регистратора доменных имён, то вам нужно Нужно в админке домена где у вас домен куплен прописать в днс адресах ваши - ns1.beget.com
ns2.beget.com
ns1.beget.pro
ns2.beget.pro

На примере Reg.ru

При этом уточню, что если у вас домен уже куплен и находится у другого регистратора, после того, как вы поменяете днс, вам также как и в описании выше для покупки нового домена, нужно создать домен на beget и прописать для него IP вашего сервера.

Вот пример одного из моих агрегаторов, у которого домен куплен на reg ru но сайт лежит на beget

Шаг 9. Настроить место, куда можно будет положить файлы инсталятор и архив сайта, чтобы начать установку.

Первым делом нужно в Личном кабинете Beget перейти в панель управления Hestia CP 

Откроется попап, где будут все данные для входа в панель. Вы можете нажать по ссылке, либо нажать на кнопку Перейти к ПО и далее вам предложат ввести как раз имя пользователя, которое вы только что получили и пароль, который вы тоже только что получили на попапе. Чтобы вы не запутались, аккаунт - это как раз имя пользователя.

Войдя вы увидите вот такой экран

На нём вы сможете управлять различными функциями сервера, включая во-первых размещённые на нём веб сайты, во-вторых базы данных, а также такие вещи как специфичные днс записи, почтовые ящики, бэкапы сайта и задания по cron

Для установки нам понадобится 2 из перечисленных раздела

Итак нам нужен раздел WEB, в котором мы создаём папку, в которую мы будем копировать (закидывать) 2 файла, которые вы получили при покупке. Инсталлер и архив движка. Далее мы привяжем эту папку к домену. Также мы добавил SSL сертификат для этого домена.

Сначала нажимаем на кнопку - Добавить домен 

Далее вписываем название нашего домена и сохраняем

Нажимаем кнопку Назад и мы видим наш созданный домен в Списке

Если после этого вы введёте в браузере свой домен, то содержание страницы изменится, и будет такая картинка

Теперь нужно добавить SSL сертификат для нашего домена

Нажимаем на домен и в открывшихся настройках ставим 3 галочки как на скрине ниже, далее сохраняем.

У вас должно появится сообщение, что всё сохранено и должен появится зелёный индикатор под SSL

Теперь мы можем закинуть файлы установщики в наш домен, для этого нажимаем на значок папки

На следующем экране нужно нажать на папку web

Далее вы увидите имя своего домена и нужно нажать на эту папку

Далее нажимаем на папку public_html

В этой папке будет 2 файла заглушки, которые мы удаляем

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

Не закрывайте страницу до тех пор, пока всё не загрузилось!

Далее переходим в браузер и к домену дописываем /installer.php

Так мы открываем файл инсталятора

Шаг 10. Проходим все шаги установки инсталятора

Перед началом установки нам понадобятся данные для доступа в базу данных. Это имя базы данных, имя пользователя БД, а также пароль этого пользователя. Нам нужно их создать. Для этого вернёмся в панель Hestia нажав на странице, на которой мы добавляли файлы инсталлятора на кнопку - Exit to Control Panel

В панели Hestia нажимаем на раздел DB

Нажимаем кнопку Добавить БД

При заполнении полей первым делом меняем кодировку на utf8mb4 (ВАЖНО - ИМЕННО С MB4)

Далее называем базу данных любым названием, но ОЧЕНЬ ВАЖНО ТО, что копируем мы не слово, как назвали, а сочитание, которое вы увидите чуть ниже. Система сама добавляет слово user_ 

Именно это значение далее мы вводим в инсталляторе

Далее мы создаём имя пользователя и так же копируем появившееся ниже сочетание с user и вставляем его в инсталлятор

И последним шагом мы генерируем пароль и также вставляем его в инсталлятор 

Не забудьте в панели Hestia сохранить все созданные данные

Далее в инсталяторе после вставки всех созданных для БД данных мы нажимаем кнопку Validate

Далее в низу экрана инсталлятора наставим галочку и нажимаем кнопку NEXT

Когда установка завершилась, мы нажимаем Admin Login

И у нас открывается новый экран, где нам нужно будет создать доступы для админки нашего нового агрегатора

В первую строку вводите свою почту, она станет почтой админа агрегатора. Логин и пароль, которые нужно создать - это ваши доступы к админке агрегатора. Последним шагом вводим ключ, который вам должны были выдать при покупке движка. Нажимаем кнопку зарегистрироваться. 

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

Далее вы можете ввести в браузере уже своё доменное имя и вы должны увидеть распакованный агрегатор на фронте (ниже скрин главной страниц, на момент создания документации) 

Т.е. теперь вы работаете в админке, а изменения смотрите на своём сайте. 

Настройки

Настройки - это базовый пункт меню WordPress. Это значит, что вы можете встретить данный пункт в любом сайте WordPress и отвечает данный раздел за различные базовые настройки вашего сайта. Этот раздел не относится к написанному нами коду, т.е. теме готового решения, но его всё равно надо настроить и лучше это сделать первым делом, поэтому я разместил данный раздел в самом начали документации. Т.е. после распаковки движка начинайте именно с этого раздела.

Настройки / Общие

Первый подраздел НАСТРОЕК - Общие. На скрине выше я обозначил цифрами каждый пункт ( не считая 12 и 13, они не влезли в скрин, их я просто опишу словами).

1. 1. Название сайта - в рамках движка это название используется как часть метаданных, если они не заполнены. Т.е. если вы создадите страницу, на которой не прописаны метаданные, например title, то туда вставится это называние. Вы можете как в моём скрине назвать только используя своё доменное имя.
2. 2. Краткое описание - это то слово, которое будет прописано возле логотипа. Вы можете кстати его и не использовать, если у вас будет просто логотип, но можно использовать как текст.
3. 3. Иконка сайта - это фавикон. Фавикон - это картинка, которая отображается во вкладке браузера.
4.  4. Просто вводится урл сайта. Если у вас пусто, можете ввести урл своего агрегатора, в админке которого вы находитесь. То, что они с http ни на что не влияет, так как приоритет у нас имеет флажок, который мы выставляем в гестии при установке сайта по инструкции. 
5.  5. Просто вводится урл сайта. Если у вас пусто, можете ввести урл своего агрегатора, в админке которого вы находитесь. То, что они с http ни на что не влияет, так как приоритет у нас имеет флажок, который мы выставляем в гестии при установке сайта по инструкции. 
6. 6. Административный Email. В данное поле попадает введённый на этапе инсталляции адрес почты
   На него приходят сообщения об ошибках на сайте и другие административные уведомления подобного характера
   Его можно сменить при помощи плагина Change Admin Email, который мы не ставим, так как обычно распаковывающим движок людям его менять никогда не приходится. Но если вы когда-то захотите изменить данный email просто установите плагин Change Admin Email
7. 7. Членство. Ставим галочку, как на скрине.
8. 8. Роль нового пользователя. Выбираем менеджер объекта, как на скрине. 
9. 9. Язык сайта. Язык, на котором будет отображаться админка.
10. 10. Часовой пояс
11. 11. Дата
12. 12. Время
13. 13. Первый день недели.

Настройки / Написание

Базовый функционал WordPress. В работе готового решения не участвует. Можете оставить те же настройки, которые установлены после получения вами движка.

Настройки / Чтение

В блоке Настройки / Чтение есть 3 важных настройки, которые вам важно проверить на самом начальном этапе работы с готовым решением

 1. Убедитесь, что для Главной страницы из списка выбрана главная страница. Что это значит? В разделе страницы уже создана так называемая Главная страница. Уже - имеется ввиду с переданным вами движком. Но если бы вы вдруг удалили случайно все страницы, вы можете создать новую страницу в разделе Страницы, назвать её Главная страница и как раз в разделе Настройки / Чтение выбрать её как Главная.

2. Так же удостоверьтесь, что для страницы Записи выбрана страница Записи.

3.  Настройка Видимость для поисковых систем. По дефолту (т.е. когда вы получили движок, тут стоит галочка). Это значит, что все страницы вашего сайта закрыты от поисковых систем. Это нужно для того, что пока вы заполняете и настраиваете сайт, вы не хотите, чтобы поисковые машины индексировали его. Если вы сразу хотите начать работать с SEO, эту галочку нужно убрать. Обычно эта галочка убирается, когда мы хотим, чтобы поисковые машины начали индексировать наш сайт.

Настройки / Обсуждение

Базовый функционал WordPress. В работе готового решения не участвует. Можете оставить те же настройки, которые установлены после получения вами движка.

Настройки / Медиафайлы

Базовый функционал WordPress. В работе готового решения не участвует. Можете оставить те же настройки, которые установлены после получения вами движка.

Настройки / Постоянные ссылки

Рекомендуем оставить те же настройки, которые вы получили с купленным готовым решением. 

Если вы хотите, чтобы урл статей был другой, вы можете поменять его под себя

Мы выбрали именно такой вариант, чтобы в Яндекс Метрике отдельно изучать  страницы  статей  за  счёт  промежуточной  части  урла  blog

Настройки / Приватность

Рекомендуем оставить те же настройки, которые вы получили с купленным готовым решением. 

Настройки / User role editor

Рекомендуем оставить те же настройки, которые вы получили с купленным готовым решением. 

Настройки / Robots.txt

В данном пункте вы можете менять ваш файл robots.txt Этот технический файл указывает поисковым системам правила работы с вашим сайтом. 

Если вы не знаете, что такое файл robots.txt и как его прописывать рекомендую ознакомиться с одним из вариантов статей на эту тему https://timeweb.com/ru/community/articles/chto-takoe-robots-txt

По дефолту в движке прописаны правила, которые запрещают поисковым системам изучать ваш сайт.

Когда вы решите запускать сайт в поисковые системы, вам нужно прописать сюда уже ваши правила. Для каждого сайта эти правила индивидуальные. Лучше согласовать их с SEO специалистом. Но как минимум для начала вы можете взять за пример правила с одного из наших агрегаторов https://psy-mk.ru/robots.txt 

Главное не забудьте поменять в них название нашего url на ваш url

Также пропишу эти правила текстом, на случай, если на момент прочтения документации ссылка не будет работать 

User-agent: Yandex
Disallow: /comments/
Disallow: /my-account/
Disallow: /my-account-2/
Disallow: /my-objects/
Disallow: /compare/
Disallow: /sales/
Disallow: /goto/
Disallow: */script.js
Disallow: /wp-admin/
Disallow: /author/
Disallow: /href/
Disallow:/category/
Disallow: /tag/
Disallow: /*?*
Disallow: /*=*
Disallow: /wp-json/
Clean-param: post_type&moderation-hash&unapproved&preview&search&or&or[]&and&sort&table&pricing
Clean-param: utm_source&utm_medium&utm_campaign&utm_term&utm_type
Clean-param: _openstat&gclid&yclid&ymclid&from&cid&frommarket
Sitemap: https://psy-mk.ru/wp-sitemap.xml

User-agent:*
Disallow: /comments/
Disallow: /my-account/
Disallow: /my-account-2/
Disallow: /my-objects/
Disallow: /compare/
Disallow: /sales/
Disallow: /goto/
Disallow: */script.js
Disallow: /wp-admin/
Disallow: /author/
Disallow: /href/
Disallow:/category/
Disallow: /tag/
Disallow: /*?*
Disallow: /*=*
Disallow: /wp-json/
Sitemap: https://psy-mk.ru/wp-sitemap.xml

Настройки / Сайтмап

Оставлю 2 полезные ссылки для ознакомления с тем, что вообще такое карта сайта или Sitemap

https://yandex.ru/support/webmaster/controlling-robot/sitemap.html

https://www.unisender.com/ru/glossary/chto-takoe-karta-sajta/

Наше готовое решение автоматически генерирует карту сайта. Всё что вам нужно сделать сверить настройки. Если вы хотите, чтобы в карту сайта попадали все страницы листинга + страниц объектов (компании или специалисты) + страницы статей (записи), то у вас должны быть проставлены настройки как на скрине ниже

После сохранения настроек вы должны увидеть свою карту сайта по адресу ВАШУРЛ//wp-sitemap.xml

Пример

Как вы видите на скрине, у карты сайта есть структура. Т.е. фактически это несколько карт сайта. В одной хранятся все страницы листинга, в другой страницы объектов, а в третей страницы блога (статьи).

Агрегатор / Личный кабинет

Раздел Агрегатор / Личный кабинет содержит в себе настройки личного кабинета контрагентов (партнёров). Через данные настройки в данном пункте я полноценно покажу как устроен личный кабинет партнёров, какие настройки можно применять и на что они влияют.

Личный кабинет партнёра - это личный кабинет, в котором компании или специалисты вашего агрегатора могут зарегистрироваться, создать карточку компании (или специалиста) и отправить её на модерацию. Вы как владелец агрегатора уже решите, добавлять ли данную компанию (специалиста) на свой агрегатор или нет. Если вы допустите компанию (специалиста) на свой агрегатор, то данная компания сможет редактировать информацию о себе, сможет создать телеграмм бота, через которого будет получать заявки с вашего агрегатора, сможет оплачивать в личном кабинете эти заявки. Но обо всём по порядку.

Личный кабинет партнёра всегда находится по ссылке ВАШСАЙТ/my-objects/

Чтобы новому партнёру создать свою карточку компании или специалиста, ему нужно изначально Зарегистрироваться у вас на агрегаторе, т.е. создать свой аккаунт 

Письмо с логином и паролем будет отправлено на email 

В вашей системе такой зарегистрированный пользователь появится в разделе пользователи с ролью Менеджер объекта.

Если вы захотите поменять роль, с которой такой зарегистрировавший будет появляться на вашем агрегаторе, это можно сделать в разделе Настройки / User Role Editor / Роли по умолчанию

Итак, пользователь стал менеджером объекта, но он пока не создал именно объект (карточку компании или специалиста). Пока он может изменить свои данные пользователя в разделе Мой аккаунт

Чтобы создать карточку компании или объекта нужно перейти в раздел Мои объекты. Именно в этом пункте можно создавать карточки компаний и специалистов. Но если новый менеджер объекта нажмёт на раздел Мои объекты (с неизменёнными после покупки движка настройками), то система попросит человека поставить галочку, чтобы принять условия договора.

Как вы наверное заметили, эту же галочку можно поставить в разделе Мой аккаунт

На этом месте переместимся в админку, в раздел Агрегатор / Личный кабинет 

В данном разделе вы можете выключить (ну и потом соответственно при желании включить) вывод данного блока в Личный кабинет. Так же тут же можно задать тексты для данного блока и главное ссылку на сам правовой документ.

Ещё раз визуально напомню, куда вам нужно перейти 

Скролите ниже, вам нужны вот 4 следующих пункта

    1. Включить использование правовых документов

    2. Ссылка на договор возмездного оказания услуг

    3. Название ссылка на договор возмездного оказания услуг

    4. Описание договора возмездного оказания услуг.

Мы на агрегаторе психологов http://psy-mk.ru используем этот раздел. Т.е. каждый психолог должен нажать галочку, чтобы создать свою карточку. Рекомендую вам составить такой договор с юристом под вашу конкретную нишу. Не пользуйтесь типовыми договорами. Важно понимать как вы сами видите ваше сотрудничество с компаниями или специалистами. 

До того как вернуться в Личный кабинет партнёра и посмотреть как создаётся карточка компании (специалиста), давайте пройдёмся по порядку по всем настройкам, которые вы можете применять в админке в разделе Агрегатор/Личный кабинет.

Название пункта меню "Мои объекты" отвечает за название, которое будет выводится в пункте меню после Мой аккаунт. Смысл в том, что на моём агрегаторе психологов - это психологи, у вас это могут быть какие-то мастерские. Т.е. данный пункт каждому надо назвать под себя.

Следующий пункт меню стал рудиментом. Мы его уберём в одном из обновлений.

Название поля "Название объекта"

Отвечает за наименование, которое появляется после того, как пользователь начал заполнять свою карточку. Опять же у вас это может быть ФИО или название компании.

Текст подсказки поля "Название объекта"

Выводит подсказку 

Разрешить добавлять логотип. 

Напомню, что у каждого объекта может быть Логотип и Изображение. Т.е. у вас структура будет такая, которую вы захотите. Например у карточки есть и логотип и большое изображение, либо только большое изображение, либо вообще без логотипа и изображения. 

Вот пример и с логотипом и с изображением и сразу скрин, где в вашей админке задаются эти данные для каждого объекта.

Так вот в настройках личного кабинета вы можете либо разрешить либо запретить менеджерам добавлять как Логотип так и Изображение. И также если разрешили назвать это поле как-то понятно для вашего партнёра. 

Следующие 3 пункта настраивают возможность для партнёра выводить (или нет, если выключить разрешение) Описание, которое выводится в самой карточке объекта.

Данное разрешение или запрет мы создали так как иногда владельцы агрегатора хотят какие-то данные выводить сами, не давая на это разрешение компаниями или специалистам. И такой блок как раз относится к этим блоками информации. 

Разрешить добавить URL кнопки "Сайт" 

Если вы на своём агрегаторе используете не кнопку для формы обратной связи, а кнопку Сайт, то вы можете либо сами в админке заполнить реферальные ссылки для партнёров, либо дать им такую возможность через личный кабинет. 

Пример агрегатор, который использует кнопку сайт на карточке объекта 

 Разрешить добавлять геопозицию - даёт возможность партнёрам добавлять координаты своего объекта

Разрешить добавлять услуги. Даёт возможность добавить CSV файл с услугами компании. Этот пункт скорее рудимент. Мы использовали его тогда, когда ещё не был написан текущий функционал, в рамках которого компании и специалисты могут добавлять услуги полноценно, не через файл. Т.е. просто оставьте данную плашку выключенной, как у нас.

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