Частые Вопросы-Ответы
Как установить?
1. Скачайте установочный пакет фреймворка с его официального сайта. Ищите версию не ниже 7.3. Пакет выглядит как обычный файл ZIP-архива.
2. Распакуйте архив к себе на компьютер, если будете запускать его на локальном веб-сервере. Или сразу в корневую папку своего сайта, если хотите установить приложение туда.
3. Откройте в браузере страницу сайта, куда вы только что распаковали архив. Например, для локального веб-сервера это будет страница http://localhost/ - в результате автоматически запустится установщик фреймворка.
4. Пройдите по шагам установки, выбрав, что желаете установить приложение по имени repost.vacancies. А на странице выбора устанавливаемых модулей отметьте только два: Sqlite, Telegram.
5. Приложение после первой установки запустится в демонстрационном режиме. В нём задан администратор с паролём по умолчанию demo и суперадминистратор с паролём по умолчанию test.
Сначала авторизуйтесь как суперадминистратор и сразу смените его пароль на какой-нибудь ваш. Затем на странице настроек приложения отключите демо режим, пропишите API-ключ вашего бота в мессенджерах и нажмите там кнопку "Сохранить". После этого опять авторизуйтесь, но уже как обычный администратор, и смените его дефолтный пароль тоже на какой-нибудь ваш.
Теперь останется создать желаемые вами задания для парсера вакансий. Парсер можно запускать прямым переходом на его страницу. Или прописать адрес этой страницы в CRON-е вашего веб-сервера, чтобы вызов парсера происходил по некоторому расписанию.
Как получить API-ключ бота?
Покажу на примере Телеграма. Сначала зайдите в мастер создания ботов и добавьте нового бота, указав как минимум его @имя и название. Описание и аватар - заполняйте это по желанию.
На странице мастера появится API-ключ бота. Скопируйте и вставьте его в соответствующее поле на страницу настройки приложения.
Теперь откройте интересующий канал и добавьте бота в роли администратора с правом публиковать сообщения.
Можно ли добавить вакансию от себя?
Нет. Данная версия приложения создана для парсинга вакансий из внешнего источника.
Если же Вас интересует функция "Добавить вакансию", следует провести следующие изменения в файлах:
- 1. Немного дополнить метод routeFor() главного модуля приложения - это файл Application.php, чтобы маршрутизатор распознавал URL страницы редактирования вакансии и маршрутизировал его на субконтроллер "Dashboard -> Vacancies".
- 2. Дополнить метод run() субконтроллера repost.vacancies/Controllers/Dashboard/Vacancies/Vacancies.php, чтобы тоже распознавал URL страницы редактирования вакансии.
- 2. Изменить метод onUpdate() того же субконтроллера, чтобы обслуживал поля, разрешённые для редактирования. Ведь в текущей версии приложения этот метод обслуживает только поле active.
- 4. Дополнить метод getStructure() модели repost.vacancies/Models/Vacancies/Vacancies.php, чтобы там были перечислены все поля, разрешённые для редактирования.
Можно ли отредактировать вакансию?
Нет. Данная версия приложения создана только для показа вакансий, полученных из внешнего источника, без возможности чтобы-либо там изменить.
Но если Вас интересует функция "Редактировать вакансию", следует провести такие же изменения, как описаны в ответе выше.
Как делать бекап?
Вообще говоря, при разработке приложения я даже не подумал о такой функции, чтобы сделать двусторонний процесс Бекап/Восстановление удобным: щелкнул - и база данных скачалась на компьютер, щёлкнул - и база выгрузилась обратно на сайт.
Поэтому бекап придётся делать иначе, например через FTP-доступ к сайту. Открываете там директорию repost.vacancies/Models и копируете к себе на компьютер файл базы данных. Он назван наподобие database_СЛУЧАЙНЫЙ_ХЕШ.sqlite.
Восстановление происходит похожим образом: открываете через FTP указанную директорию, копируете туда файл базы данных, который скачали в прошлый бекап.
Кстати, если удалить файл базы на сайте, приложение запустится словно бы Вы установили его в первый раз. Будет создан новый файл базы, только уже с другим случайным хешем в имени.
Ещё один вопрос был вынесен на отдельную страницу. Он касается истории разработки данного приложения. Прочтите её, если захотите самостоятельно доработать его под себя.