lucms

lucms

lucms означает «разработка CMS».

Более мощная версия lucmsee доступна по адресу https://gitee.com/zhjaa/lucmsee

Версия и лицензия

Лицензия следует за MIT открытым исходным кодом, ниже приведено описание лицензии на основе lucms.

1. Вы можете использовать lucms в коммерческих целях, полностью соблюдая условия данной лицензии, без необходимости оплаты использования; однако мы также не гарантируем предоставление какой-либо формы технической поддержки неподдерживаемым пользователям;
2. При использовании lucms вам не обязательно указывать информацию о правах авторства программы на явных страницах, но конечные права остаются за первоначальным автором; чтобы программа могла развиваться дальше, рекомендуется указать "powered by lucms" в нижней части сайта, кроме того, мы можем не предоставлять бесплатной технической помощи пользователям, которые не сохранили информацию о правах авторства;
3. Для нелицензионных пользователей информация о правах авторства в панели управления и внутри программы не должна быть удалена, это наш единственный способ защиты своих интересов;
4. Вы можете бесплатно использовать lucms, модифицировать исходный код или стиль интерфейса для удовлетёжения ваших реальных требований, но запрещается переименование программного обеспечения и создание конкурентных продуктов любыми другими способами;
5. Вы можете осуществлять вторичное развитие lucms, но запрещается распространение любого производного продукта, модификационного продукта или третьего стороннего продукта, созданного на основе всего или любой части lucms; вы можете самостоятельно распределять права использования, обратитесь к пункту OnClickListener();
6. Если ваша программа использует функции или дизайн lucms, укажите это явно, например, на официальном сайте;
7. С момента начала использования lucms данная лицензия автоматически вступает в силу;
8. В случае невыполнения условий 3, 4, 5, 6 данной лицензии, право бесплатного использования будет аннулировано, и вы будете нести ответственность согласно законодательству.

Цели

Целью является быстрое создание системы администрирования и API.

Мы стремимся достичь следующих целей:

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

Участие

Сила одного человека ограничена. Все приветствуют участие!

Благодарности

Благодарим команду разработчиков фреймворка Laravel.

Благодарим команду разработчиков iview, lucms использует iview для создания интерфейсов.

В процессе разработки были использованы множество библиотек третьих сторон, благодарим всех команд разработчиков.

Обзор проекта

• Название продукта: lucms

Lucms представляет собой систему администрирования с использованием фреймворка Laravel 5.5 и библиотеки iview.

Основные функции

• Аутентификация пользователя — вход, выход
• Аутентификация пользователя — многотабличная аутентификация
• Управление пользователями — загрузка аватара, изменение данных профиля
• Система прав — управление множеством ролей и прав
• Управление приложениями — управление файлами сервера
• Система новостей — базовое управление новостями
• Безопасность системы — логирование, фильтрация IP
• Импорт и экспорт данных в Excel
• Поддержка редактора Markdown
• Поддержка редактора Wangeditor

Установка и настройка среды разработки

Код данного проекта был разработан с использованием PHP-фреймворка Laravel 5.5. Локальная среда разработки была установлена с помощью Laravel Homestead.

Далее будут рассмотрены шаги установки, предполагая, что Homestead уже установлен. Если Homestead еще не установлен, можно воспользоваться руководством по его установке и настройке.

Базовая установка

• Клонирование исходного кода

Клонируйте исходный код lucms на локальный компьютер:

git@gitee.com:zhjaa/lucms.git

• Настройка php

1. Настройте локальную среду разработки, корневой каталог должен указывать на public.

2. Установите composer

composer install

3. Создайте конфигурационные файлы

cp .env.example .env
Вы можете изменить содержимое файла .env, например, данные подключения к базе данных, кэширование, настройки электронной почты и т.д.

4. Настройте права доступа к директориям

  $ chmod -R 777 storage

5. Настройте .env, измените данные подключения к базе данных...

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:IKlBaIonliiolP7yK0QWP8Ixwgc1Z5R2ylxEA6CD3nA=
APP_DEBUG=true
APP_LOG_LEVEL=debug
APP_URL=http://lucms.test

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=lucms
DB_USERNAME=root
DB_PASSWORD=route
.

.

.
QUEUE_DRIVER=sync «синхронный режим, без использования очередей» => redis

.

.

.

6. Создайте таблицы базы данных и тестовые данные

$ art migrate
$ art db:seed

7. Установите клиент Passport, необходимый для аутентификации через Vue API запросы

 $ art passport:install
 
 # Скопируйте следующую информацию в .env
 Client ID: 2
 Client Secret: qtbbnoYSKM1QkAfbcs614iCiWmMvBWNdRloJNbDi

8. Настройте .env, измените данные подключения к базе данных...

.

.

.
OAUTH_GRANT_TYPE=password
OAUTH_CLIENT_ID=2
OAUTH_CLIENT_SECRET=p7XaeU3D9RASxQ18eiF5CT1uL9xUJRYjT6O8BJFt
OAUTH_SCOPE=*

.

.

.

9. Генерация ключа

art key:generate

10. Установите мягкую ссылку для загрузки изображений storage/app/public/* до public/storage/images

$ cd public
$ mkdir storage
$ ln -s /srv/wwwroot/homestead-code/lucms/storage/app/public/* ./storage/

• Изменение конфигураций js

1. Глобальное изменение базового доменного имени http://lucms.test => https://xxxxx

cp  lu/example.vue.config.js lu/vue.config.js
cp  lu/config/example.env.js lu/config/env.js
cp  lu/config/example.url.js lu/config/url.js

lucms/lu/vue.config.js

const BASE_URL = env === 'development'
  ? '/iview-admin/'
  : 'https://lucms.com/lu/dist/'

lucms/lu/config/url.js

const DEV_URL = 'http://lucms.test/'
const PRO_URL = 'https://lucms.com/'

Установка и запуск vuejs

1. Разработка

$ cd lu
$ cnpm install
$ npm run dev
```2. Процесс сборки

$ cd lu $ npm run build

## Используемые пакеты

| Пакет | Описание | Применение в данном проекте |
| --- | --- | --- |
| [laravel/passport](https://github.com/laravel/passport) | JWT аутентификация пользователя | аутентификация API |
| [Intervention/image](https://github.com/Intervention/image) | Пакет обработки изображений | загрузка и обрезка изображений |
| [laravel-permission:~2.7](https://github.com/spatie/laravel-permission) | Пакет управления правами | управление правами |
| [mews/purifier](https://github.com/mewebstudio/Purifier) | Пакет фильтрации XSS | фильтрация XSS |
| [overtrue/pinyin](https://github.com/overtrue/pinyin) | Инструмент преобразования китайских слов в пиньинь на основе словаря CC-CEDICT | создание SEO-дружественных URL для статей |
| [nrk/predis](https://github.com/nrk/predis) | Драйвер очередей Redis | управление очередями |
| [laravel/horizon](https://laravel-china.org/docs/laravel/5.5/horizon/1345) | Мониторинг очередей | мониторинг очередей |
| [rap2hpoutre/laravel-log-viewer](https://github.com/rap2hpoutre/laravel-log-viewer) | Просмотр логов Laravel | просмотр логов |
| [aliyuncs/oss-sdk-php](https://help.aliyun.com/document_detail/32099.html?spm=5176.87240.400427.47.CtLkv4) | SDK OSS Aliyun | объектное хранилище |
| [overtrue/easy-sms](https://github.com/overtrue/easy-sms) | Отправка SMS | восстановление пароля |
| [barryvdh/laravel-cors](https://github.com/barryvdh/laravel-cors) | Решение проблем CORS | удобство тестирования в среде разработки |
| [league/html-to-markdown](https://github.com/thephpleague/html-to-markdown) | Преобразование HTML в Markdown | поддержка Markdown в редакторе |
| [Maatwebsite/Laravel-Excel](https://github.com/Maatwebsite/Laravel-Excel) | Обработка Excel | импорт и экспорт данных Excel |


## Очередь задач

| Задачи | Описание |
|--- | --- |
| TranslateSlug | Перевод заголовков статей |