Nový Quickstart – diskuze

Projdu to a budu opravovat překlepy a i vytvářet současně tu aplikaci na Nette 2.0 Beta verzi, která je teď v Download.

Až to bude odladěný a přepsaný bylo by dobrý začít dělat na překladu do angličtiny, ale na to já si asi netroufnu :-)

Ne, na github není nutné posílat, jednou za čas si to sesynchronizuji sám. Dokumentace v repository tam teď bude hlavně kvůli překladu Texy! → TeX → PDF.

Což mi připomíná, že bych mohl do úvodního postu hodit odkaz na zdrojáky…

Nejsem zastáncem n:maker ve smyslu používat tam, kde jde. Používat, tam, kde to něco zpřehlední. Což se u foreache nejedná určitě, n:href imo taky ne, protože to editory nezvýrazní. (smarty je naopak často podporováno).

Trochu na rychlo, ale zkusil jsem vytvořit Úkolníček. Při tom jsem narazil na drobnosti – předpokládám že se často jedná o rozdíly vývojových verzí ale přeci:

Začínáme > Složka app
- v sandboxu chybí soubor Model.php v adresáři models
- config.neon je v adresáři config

Vytvoření databáze a modelu > Nastavení připojení k databázi
- použita jiná struktura config.neon než je v sandboxu

Vytvoření presenteru > Šablona (1)
- píše se „V šabloně default.latte máme nyní k dispozici proměnnou $list“ ale v sekci „Spojení s modelem“ je $this->template->tasks

Tady se možná jedná o mou neznalost/chybu, ale jel jsem podle postupu a začátečníka může zmást. V šabloně:

• $task->created vyvolává error: htmlspecialchars() expects parameter 1 to be string, object given
• $task->created|date:‚j. n. Y.‘ už je ok

Vytvoření presenteru > Šablona (2)
překlep „Ve složce templates vytvoříme podložku Task“

Po dokončení „Navigace“ error:
Nette\MemberAccessException > Cannot write to an undeclared property TaskPresenter::$taskList

a tady jsem se zasekl a už není čas takže pokračovat budu zítra :)

Ještě drobnost při vytváření TaskPresenter se popisuje:
$this->template->tasks = $this->taskList->related(‚task‘)->order(‚created‘);

později v laděnce je ale vidět, že řadíš dle id, to možná může být taky matoucí když bych hledal kde podle id řadím.

edit: btw klidně i opravím co vím ale ted už musím fakt letět :)

Editoval RiskyNet (23. 12. 2011 15:06)

Taky jsem malinko přispěl tuhle a táhle opravičkou :P

Zkuste místo vypisování co je špatně, to jít rovnou opravit. Když to opravíte a bude to pořád špatně, tak vám to milerád smažu, takže se není čeho bát :) :P

Editoval HosipLan (23. 12. 2011 15:57)

RiskyNet napsal(a):

Po dokončení „Navigace“ error:
Nette\MemberAccessException > Cannot write to an undeclared property TaskPresenter::$taskList

Do jakého souboru jsi psal uvedenou actionDefault? Do QS jsem doplnil, že se změna týká TaskPresenteru…

Mimochodem, tutoriál by nyní měl adresářovou strukturou sedět i na aktuální sandbox. Snad jsem na nic nezapomněl…

Ježiš to je super. Díky moc za nový quickstart.

Díky! Opravil jsem to i na githubu.

Taky by to šlo. Tady to chápu jako , a) méně důraznou informaci o tom, že stránka (nebo spíš to nazvat „záznam“) neexistuje, b) třeba (generická) hláška z errorpresenteru by se tady nehodila, tak ji nahradím vlastní.

Jinak návod je pěkný, akorát jediné co mě napadlo, je v části o komponentách upozornit na nutnost psát malé mpísmeno v v šabloně.

Ještě jeden poznatek: stránka se mi načítala přes sekundu, frusrovalo mě to, tak jsem se pomocí wincachegrind( který se hodí spíš pro rychlou konkrétní analýzu než kcachegrind) doklikal k PDO::connect, a vzpomněl si na starý problém, že host:localhost zpomaluje. Tak jsem to nahradil 127.0.0.1 a jede to OK. Pravá příčina ale byla v chybějícím řádku 127.0.0.1 localhost v c:\Windows\System32\drivers\etc

Pro začátečníky by bylo dobré doplnit do textu, že při editaci confing.neon je třeba dát pozor na mezery a tabulátory. Když tam budou připisovat registraci služby model, tak se u toho dá celkem na dlouho seknout.

Dokončení? V jakém smyslu? Chybí Ti poslední dvě kapitoly? Ty budu dopisovat někdy během následujících 14 dnů. Jádro tutoriálu by ale nyní mělo být hotové a mělo by se podle něj jít v pohodě řídit. Pokud ne, tak prosím sepiš konkrétní místa, která Ti přijdou nedokončená a nejasná a něco s tím uděláme.

Co se aktuálnosti týče, tak to bylo také myšleno na QS? Ten by měl reflektovat poslední nightly buildy, pro jistotu jsem dneska upravil poznámku o revizi, byly tam 2 commity navíc, které QS ale nijak neovlivňovaly.

Předem díky za jakoukoliv zpětnou vazbu!

Radimorous napsal(a):
… Pár známých bohužel nemělo nervy na bordel v tutorialech a šlo na Zend …

Právě pro „slabinu“ v dokumentaci vznikla kolem Nette taková silná a kvalitní komunita. Kdo „vydržel“, tak tomu většinou propadl a má hlubší znalosti díky nutnosti jít více do hloubky, poprat se s tím sám – prostě vydržet a nevzdát to.

Především: díky moc za hromadu odvedené práce na Quick startu! Takový čin zůstane nezapomenut a v budoucnu za něj sklidíš ještě spoustu neoprávněné kritiky :-))

K třídě Model: její existence je poněkud nešťastná, protože málokdo si umí pod slovem model představit cokoliv konkrétního, takže ani netuší, k čemu takové třída slouží. Dříve v sandboxu sloužila jako vstupní a inicializační bod modelu, což je věc, kterou plně nahradilo DI. Bylo by tedy vhodné DI naplno využít i v QS.

Samozřejmě je otázka, jak takové DI lidem podat. Sám s tím ze školení zatím moc zkušeností nemám, ale snažím se k tomu přistupovat stejně jak třeba k MVC, tj. žádné MVC nevysvětlovat, neplést tím zbytečně lidem hlavu, a jít přímo k věci. Nechci, aby lidé používali určité postupy proto, že to někdo říkal na školení, nebo proto, že „tak je to přece správné“, ale aby věděli, že to má konkrétní smysl. Na školeních k DI „přijdu“ až po sérii nešikovným pokusů, kdy se potřebujeme v autorizátoru dostat k databázi.

S tím trošku souvisí i používání Table\Selection v presenteru a komponentách. Spousta lidí tady na fóru bude hlasitě namítat proti volání SQL dotazů přímo v kódu presenteru, ale jen málokdo z nich to bude schopen i obhájit (třeba před Jakubem Vránou). Chytře navržený kód totiž používá odpovídající míru abstrakce. U triviálních aplikací může být skutečně pragmatické SQL v presenteru použít.

Framework se ale spíš využívá pro netriviální aplikace, kde se už nějaká další vrstva vyloženě hodí. Univerzální vrstvou mezi databází a vlastním kódem je právě Table\Selection. V případě jednodušších aplikací se dá velmi výhodně používat v presenteru a šablonách. V případě složitějších aplikací v modelu.

Nicméně, samotný QS a značná část aplikací tvořených v Nette bude patřit právě do ranku těch „jednodušších“, proto bych se jeho použití nebál, naopak předvedl všechny výhody. Teprve nakonec mohou být naznačeny metody vhodné pro vyšší level aplikací.

mrataja napsal(a):

<ul n:inner-foreach="$taskLists as $list">
	<li {ifCurrent Task: $list->id}class="current"{/ifCurrent}>
		<a href="{link Task: $list->id}">{$list->title}</a>
	</li>
</ul>

Lépe:

<ul n:inner-foreach="$taskLists as $list">
	<li n:class="item, $presenter->linkCurrent ? current"> <!-- umožňuje další třídy -->
		<a href="{link Task: $list->id}">{$list->title}</a>
	</li>
</ul>

Do handlemarkdone vložit $this->presenter->flashMessage("Změna stavu byla úspěšná."); pro potvrzení odškrtnutí.
Dál bych refactrotoval
$this->model->getTasks()->where(array('id' => $taskId))->update(array('done' => 1));
na $task->update(array('done' => 1))

Myslím, že by bylo i vhodné dát do tutoriálu jakési cvičení.

Mohla by to být další kapitola a v ní tyto drobé úkoly – jak ostatně vyplynulo odsud

• zvýraznění akutálního projektu. (n:class=islinkcurr...)
• zprávička pro potvrzení odškrnutí tasku
• možnost smazat task
• možnost smazat task, byl li dokončen.

Někde dál by mohlo být řešení. Případně by toto mohlo být jako další kapitola „drobné úpravy“.

Zkusím to napsat a přidat.

Editoval bojovyletoun (28. 12. 2011 19:02)

Patrik Votoček napsal(a):

Pravda, bral jsem to jako položky v menu, přehlédl jsem ta id. Díky za opravu.

Pro vynucení debug módu si v bootstrap.php uprav řádek s Debugger::enable takto:

Debugger::enable(FALSE);

(FALSE – vývojový režim, TRUE – produkční prostředí, neuvedeno – autodetekce podle IP adresy, současné Nette považuje za vývojové jen localhost, je také možné zadat seznam IP adres jako pole)

Od pohledu v uvedeném kódu žádnou chybu nevidím, takže by výstup z laděnky moc pomohl. Díky!

Doplněno 16:57:

err napsal(a):

Take by nebylo spatne projekt vystavit, cimz by vetsina dotazu odpadla. stacilo by se jen podivat.

On vystavený je, viz první příspěvek tématu. Po odladění chyb bude pod každou kapitolou ke stažení aplikace ve stavu, v jakém by měla být na konci dané kapitoly. Tutoriál by ale měl být srozumitelný i bez toho, aby člověk musel koukat do zdrojáků, proto jsem teď záměrně odkaz na github hodil jen sem.

Editoval Panda (30. 12. 2011 16:58)

Panda napsal(a):

(FALSE – vývojový režim, TRUE – produkční prostředí, neuvedeno – autodetekce podle IP adresy, současné Nette považuje za vývojové jen localhost, je také možné zadat seznam IP adres jako pole)

..nevím, jak jinde, ale poslední dev verze pole nežere, akorát string oddělenný čárkami…

Oboji je funkcni v tom smyslu, ze se mi ukaze debug bar. Nicmene to stale hazi chybu 500 a ladenka nevyskakuje. Cache ?. V /log/error.log mam :[2011–12–30 20–21–38] Nette\DI\MissingServiceException: Service ‚model‘ not found. in /muj_web_adresar/libs/Nette/DI/Container.php:159 @ http://muj_web/www/ @@ exception-2011–12–30–17–07–12–70048f45eb99cc80b12dc7a58aa280dc.html

V souboru /app/config/config.neon dle navodu mam:
model: Model( @database )
authenticator: Authenticator( @model::getUsers() )

v /app/models jsem vytvoril Model.php s tridou class Model extends Nette\Object a jejimi funkcemi dle navodu

/app/presenters/HomepagePresenter.php viz. vyse

bootstrap.php :
// Enable Nette Debugger for error visualisation & logging
Debugger::$logDirectory = __DIR__ . ‚/../log‘;
Debugger::$strictMode = TRUE;
Debugger::enable(Debugger::DEVELOPMENT);

Checker mi dava vse OK. Pouzivam Apache / mod_php

Takze vse otazka cache. Dekuji za rady. Abych pokracoval v pripominkach, hned bych tento stav zminil :-) pro zacatecnika to neni samostatne resitelne. Take bych se primlouval o pridani zakomentovanych radku pro spusteni debugeru do sandboxu. Tohle je myslim zcela zasadni funkce, ktera by mohla mit vyjimku.

Jeste jednou diky za pomoc, jdu prochazet navod dal. Napisu vysledek.

Dokonceni navodu

TaskPresenter – zalozeni a napln pochopitelne bez potizi, kvituji odkaz na adresar kam patri

po manualnim doplneni Projekt A a Projekt B do databaze, link u Projekt A odkazuje na /www/%EF%BB%BF/www/task/default/1 a Projekt B na /www/task/default/2 (to je asi jiz spravne), nicmene zadny z odkazu neni v teto fazi funkcni . Ani u jednoho, ani u default/3 nevyskakuje ladenka, ale objevi se standardni hlaseni apache Not Found – The requested URL /www//www/task/default/1 was not found on this server.

Vyzkousel jsem vsechny zapisy <ul><li n:foreach …

Je to tak. Doplnil jsem do virualu a je to OK. Omlouvam se tedy. pro poradek: doplnil jsem do rootu Virtual serveru RewriteEngine On a do Directory AllowOverride All . Struktura tedy vypada :

<VirtualHost *:80>
…
RewriteEngine On
<Directory />
AllowOverride All
</Directory>
</VirtualHost>

---
Odkaz: /www/%EF%BB%BF Zpusoboval BOM (chyba take na me strane)
 ---

Editoval err (31. 12. 2011 0:00)

Pozoruji, ze znehodnocuji tema fora, takze me prispevky pak prosim klidne smazte. Diky!

Formulare

– Formular pro zadani ukolu je OK
 – Formular pro vytvoreni seznamu ukolu hlasi chybu. Resp BasePresenter, radek 29 . Vyreseno pridanim use Nette\Application\UI\Form; na zacatek souboru BasePresenteru . Mozna by mohlo byt zmineno.

Signaly

• TaskPresenter / Funkce createComponentTaskList() – chybi druhy argument konstruktoru . Chyba nevyvola ladenku, ale server error 500.

Oprava:

protected function createComponentTaskList()
{
    return new TaskList($this->taskList->related('task')->order('done, created'), $this->model);
}