wakers/cms-sandbox

Sandbox for Wakers CMS 5

1.0.0-alpha 2019-02-14 23:54 UTC

Requires

• php: >=7.3.1
• nette/forms: v2.4.x-dev
• nette/nette: ^2.4.0
• propel/propel: dev-master#8dc9f567e77d7e2ae7f6d9878dbb435f7fd7feed
• symfony/dotenv: ^4.2
• wakers/cms-base-module: ~1.0.0-alpha
• wakers/cms-category-module: ~1.0.0-alpha
• wakers/cms-lang-module: ~1.0.0-alpha
• wakers/cms-onpage-module: ~1.0.0-alpha
• wakers/cms-page-module: ~1.0.0-alpha
• wakers/cms-structure-module: ~1.0.0-alpha
• wakers/cms-user-module: ~1.0.0-alpha
• wakers/nette-propel2: v0.9.2

Requires (Dev)

• kdyby/console: ^2.7
• kdyby/nette-session-panel: ^3.4

MIT

• Jiří Zapletal

README

CMS založený na Nette 2.5 a PHP 7.3 | https://www.wakers.cz/cms

O Projektu

Systém byl vyvinut za účelem zrychlení implementace a následné udržitelnosti projektů. Vše bylo rozděleno do vendor modulů - ty jsou verzovány samostatně. Výsledný webový projekt tedy neobsahuje žádné zbytečné kódy a je přehlednější. Dev-stack nového projektu lze připravit během pár minut.

7 základních modulů nahrazuje jiné open-source CMS. Výhoda Wakers CMS spočívá v možnosti využití Nette. Systém lze rozšiřovat o další (vlastní) moduly či komponenty. Lze kompletně upravovat, nahrazovat a konfigurovat jednotlivé části CMS.

Druhou obrovskou výhodou je UI pro správu webu - administrátoři stránku editují téměř tak, jak ji vidí. Nemají k dispozici zbytečné funkce a jsou omezeni, aby zcela nenarušili vizuální podobu a celý smysl webu.

Jako freelanceři se vývojem tohoto CMS snažíme posouvat vpřed.

Seznam výchozích modulů

1. Base Module
2. User Module
3. Lang Module
4. Page Module
5. On-Page Module
6. Category Module
7. Structure Module

Instalace systému

0. Závislosti pro spuštění

• Unix nebo Windows 10 PRO s WSL v1
• Docker desktop >= 18.09.1
• GIT >= 2.20.1
• NodeJS: v8.12.2 - nejlépe přes NVM
• NPM: 6.7.0 npm i -g npm@6.7.0

1. Konfigurace

1. Vytvoření souboru cp ./docker-compose.example.yml ./docker-compose.override.yml
2. Vytvoření souboru cp ./docker/nginx/nginx.example.conf ./docker/nginx/nginx.conf
3. Vytvoření souboru cp .env.example .env

2. Spuštění

1. Zastavení všech Docker containerů docker stop $(docker ps -a -q)
2. Sestavení a spuštění Docker containeru docker-compose up --build --d
3. Instalace závislostí ./sc composer i a ./sc npm i
4. Vygenerování assets ./sc npm run gulp-dev
5. Vygenerování DB active-record tříd./sc propel model:build
6. Vytvoření databázových tabulek ./sc propel migration:migrate
7. Vytvoření jazyku ./sc console wakers:lang-create <lang>
8. Vytvoření (všech) úvodních stránek ./sc console wakers:homepage-create <defaultLang> [layoutName=home.latte]
9. Vytvoření admina ./sc console wakers:admin-create <email> <password>

Užitečné příkazy

• Přehled hl. příkazů: ./sc
• Dump databáze: ./sc-dump.sh
• Přepnutí se do Docker containeru: docker exec -it <container_name> bash
• Spuštění příkazu v containeru: docker-compose exec <service_name> <commands>
• Kompletní vyčištění dockeru docker system prune --all -f
• Adminer: localhost:9876

Deploy

Po zprovoznění aplikace na serveru je potřeba:

1. Přepsat, případně přidat názvy domén (wakers.cz) v souborech:
   • ./sc-ssl.sh
   • ./docker/nginx/servers/production.conf
2. Spustit script ./sc-ssl.sh
3. V souboru ./docker/nginx/nginx.conf změnit include servers/development.conf; na include servers/production.conf;
4. Restartovat nginx / docker docker-compose restart