Thunbolt – modulární cms s balíčky z composer (Doctrine, AdminLte…)

imo: Nejedná se o cms, ale spíše o takový sandbox, který lze rozšířit o různé moduly.

Upozornění

Obsah v tomto příspěvku nemusí (ani asi už nebude) být aktuální.

Moduly

Základní hiearchie:

app:
	modules:
		NazevModulu:
			- config.neon
			Components:
				- Filters
				- Forms
				- Grids
				- Other
			Data:
				Entities
				Repositories
				Translations (Kdyby translator)
			Listeners:
				- Tasks
				- Events (Kdyby events v základu není použitp)
			Modules:
				Front:
					- *Presenter.php (možnost rozšířit presenter)
					templates:
						- ... (možnost přepsat šablony modulu)
				Admin:
					...

Obrázek více řekne:

Zrychlení vývoje

Použitím konzolové aplikace

Obsahuje generování:

• Modulu a jejich podsložek
• Gridu
• Formulářové továrničky
• Formulářového wizarda
• Entity a jeho repositáře
• Datafiltru
• Emailové továrničky
• FrontPresenteru a jeho default.latte
• AdminPresenteru a jeho default.latte

Všechno to kontroluje zda daný soubor neexistuje a doplní správný namespace.
Také bude dostupné live templates pro PHPStorm.

Rozšíření presenteru

App\Presenter*Module*ExpandPresenter rozšíříme o App\Presenters*Module*Presenter.
Volání *ExpandPresenter přes http request zabezpečeno.

Šablony a jejich přepsání

Každý modul má šablony ve struktuře

templates:
	nazevSablony:
		- *.latte

Nastavení výchozího názvu šablony pro všechny presentery (mimo administraci) v neonu.
Nastavení názvu šablony v presenteru

class MyPresenter extends BasePresenter {

	/** @var string */
	protected $theme = 'myTheme';

}

Přepsání šablony:
Vložení latte souboru do (možná jiná složka?):

templates:
	- *.latte

Routování

Pořadí rout probíhá na nastavené prioritě 0–10 (10 může použít jen hlavní router) a daném modulu (pořadí modulu určuje hlavní router). Kdybychom chtěli použít routy z hlavního routeru stačí zavolat $routeManager->finish() (může jen hlavní router).

Ukázka hlavní routeru:

class Router implements IRouter {

	/**
	 * @param RouteManager $routeManager
	 */
	public function createRouter(RouteManager $routeManager) {
		// Admin
		$admin = $routeManager->getModule('Admin');
		$admin[] = new Route('admin[/<id [0-9]+>[-<name [0-9a-zA-Z\-]+>]]', [
			'presenter' => 'Homepage',
			'action' => 'default'
		]);
		$admin[] = new Route('admin/<presenter>[/<action>][/<id [0-9]+>[-<name [0-9a-zA-Z\-]+>]]', [
			'presenter' => 'Homepage',
			'action' => 'default'
		]);

		// Console
		$console = $routeManager->getModule('Console');
		$console[] = new Route('console[/<presenter>][/<action>][/<id [0-9a-zA-Z]+>]', [
			'presenter' => 'Homepage',
			'action' => 'default'
		]);

		// Front
		$front = $routeManager->getModule('Front');
		$front[] = new Route('<presenter>[/<action>][/<id [0-9]+>[-<name [0-9a-zA-Z\-]+>]]', [
			'presenter' => 'Homepage',
			'action' => 'default'
		]);
	}

}

Otázky:

• Možnost zakázaní specifických rout?
• Když jiný router definuje jiný modul než hlavní router, tak přeskočit?

Komponenty

Vytvoříme doplněk s metodou render (pro renderování v šabloně) a zaregistrujeme:

widgets:
	controlName: MyControl

# multiplier
widgets:
	controlName:
		class: MyControl
		multiplier: yes

V šabloně:

{widget controlName}
<!-- Pro vykreslení vnořené komponenty -->
{widget controlName-form}

Administrace

Obsahuje:

• Šablonu AdminLTE (možnost zvolit barevnou kombinaci)
• Notifikace

Menu v configu:

admin:
	menu:
		-
			parent:
				need: 'user|role' ## Zobrazí se jen když uživatel splňuje práva user nebo role
				name: 'user.menu.title'
				icon: 'fa-users'
				url: 'User:'
			children:
				-
					name: 'user.menu.children.user'
					need: 'user'
					url: 'User:'
				-
					name: 'user.menu.children.role'
					need: 'role'
					url: 'User:role'

Potom je ještě extraMenu, ale to není teď důležité.

Vlastní informační boxy, dropdown labely, uživatelské taby a obsah na domovské stránce:

class Settings implements IBox, ILabel, ITab {

	private $helper;

	public function __construct(WebChemistry\Administration\Helper $helper) {
		$this->helper = $helper;
	}

	/**
	 * @return string
	 */
	public function getBox() {
		return $this->helper->createBox('user.box.users', $this->em->getRepository(User::class)->countBy(), self::ICON);
	}

	/**
	 * @return string
	 */
	public function getLabel() {
		return $this->helper->createLabel('fa-user', 'My html or template', 5);
	}

	public function getTab() {
		return 'html template or latte template';
	}

	public function getTabTitle() {
		return 'Title';
	}

}

services:
	settings:
		class: Settings
		tags: [admin.userTab, admin.box, admin.label]

Práva

Obsahuje:

• Dědičnost
• Uživatelskou administraci práv
• Makro isAllowed

Definice v config.neon:

authorizator:
	user:
		translated: 'user.authorizator.translated'
		privileges:
			add: 'user.authorizator.add'
			remove: 'user.authorizator.remove'
			list: 'user.authorizator.list'
			edit: 'user.authorizator.edit'
	role:
		translated: 'role.authorizator.translated'
		privileges:
			add: 'role.authorizator.add'
			edit: 'role.authorizator.edit'
			assign: 'role.authorizator.assign'
			remove: 'role.authorizator.remove'
			list: 'role.authorizator.list'

V základu obsahuje správu práv, takže už jenom stačí:

$user->isAllowed('user', 'add');
$user->isAllowed('user:add');

Prvotní instalace na remote serveru přes installer.php

Zabalit celý projekt do project.zip a s installer nahrát.

Umí:

• Extrahovat project.zip do složky kde se project.zip nachází
• Vyprazdit celou složku kde se nachází installer.php (včetně podsložek a installeru.php)
• Odstranit project.zip
• Odstranit installer.php
• Instalace tabulek
• Vložení všech hodnot
• Init mode (odstraní .tmp, node_modules, vyprazdní cache, assets apod.)
• Vytvořit .htaccess pro psaní bez www

Insertování vlastních počátečních hodnot

Stačí implementnout WebChemistry\Console\IInsert, potom stačí zavolat command v kdyby/console nebo debug bar na produkčním.

Vytváření, aktualizace, odstranění, vyprázdnění tabulek

Development: kdyby/console
Production: debug bar

Používá

Všechno nejnovější verze

• Nette
• Kdyby: Doctrine, Console, Annotations, DoctrinCache, Validator, Translator, Events
• WebChemistry: Forms*, Configuration, Filter, Images, Bin, Parameters
• Nextras: StaticRouter, MailPanel
• o5/Grido
• rixxi/gedmo
• aleskafka/component-macro
• grunt pro minimalizace css a js

Debug bar

Development:
MailPanel, Translations, Emails, Parameters,
Produkční:
Emails, Parameters, Logs and Cache, Tables

Jaké moduly obsahuje?

Vše dobrovolné

• Správa uživatelů a jejich rolí
• Zapomenuté heslo
• Správa emailů uživateli
• Notifikace
• Nastavení webové stránky

Závěrečné otázky

• Instalace modulů přes composer?
• Udělat verzi kde jsou složené závorky na novém řádku?
• Udělat verzi kde není nutné použít Kdyby\Translator a cesta k překladům bude nahrazena překlady?
• Nějaké nápady co udělat lépe nebo přidat?

A tím bych skončil, protože bych všechno a mnohem více napsal do dokumentace. Otázky nebo návrhy jsou vítány.

Editoval Antik (10. 9. 2016 20:58)