Nette – Quick Start

Jen takový postřeh – nemělo by v tom diagramu o MVP© být i datová šipka z modelu na view? Mám pocit, že i David na zdrojaku to tak má. Oba – View i Presenter – vědí o modelu, resp. si mohou tahat jeho data. Není-liž pravda?

Soubor, jehož název začíná zavináčem, nejde vložit do jiného. Právě pomocí zavináče Nette Frameworku jasně sdělíme, která šablony jsou ty „základní“, které nelze nikam vložit.

Tohle se zakládá na pravdě?

Počkejte, vždyť to je jedno a to samé ne?:-)

Jestli jsem to nějak povoral tak se omlouvám – já QS píšu, faktické a jiné bugy opravujete vy:-)

Operavíš to Honzo pls?:-) Nebo to mám změnit já?:-)

Oki – a ono to takhle nejde includnout?:-)

Jak to tedy funguje? Zavináč neříká tedy že to nejde includnout do jiné, ale že to nejde použít jako „šablona akce“ ?

Několikrát denně sleduji Quick start (jestli se náhodou neobjeví něco nového) a zatím bohužel marně. :-( Vím, dá to zcela jistě mnoho práce, ale když ono je to opravdu super a těším se na pokračování.

A ozývám se také z toho důvodu, že toto vlákno se začíná pomalu, ale jistě, posouvat do hlubin historie.

Už jen necelých 52 hodin.

Mimojiné, opakuje se už několikrát zažité:

Inza 1. 3. 2010 napsal:

Peklíčko, Inza jde dokončit QS. Celý a tento týden. Templaty dnes.

Holt asi chápeme slovo „dnes“ jinak. Musím ale uznat, že škola s tak dlouhými přednáškami je asi zajímavá.

Lkor napsal(a):

bojím se, když se díla ujme někdo jiný, aby QS neztratil na kvalitě.

Abych pravdu řekl, lepší o něco nižší kvalita než nic.

Takže, jak jste si jistě všimli, deadline opět uplynula a QS hotový není.

Bohužel mi do toho vlezlo několik urgentních věcí.

Každopádně, vím že na QS všichni urputně a zuřivě čekáte a že je to nejdůležitější věc dokumentace atd. Ale já jsem na tom s časem bohužel takto bídně.

QS bych dokončil velice rád, ale skutečnost je bohužel taková že nemám reálně čas se tomu věnovat více než jeden večer v týdnu.

Tudíž máme dvě možnosti. Pokud na QS tak moc spěcháte a je zde někdo, kdo by se chtěl prací ujmout, nechť tak učiní. Pokud se zatím nikdo takový nenajde a nebo pokud budete chtít, budu v tom pokračovat – ale nejsem schopen vám reálně dát nějaký termín. Prostě mám málo času.

A nechci být pro Nette komunitu překážkou.

Jak jsem řekl, rád bych QS dokončil, ale nemám tolik času abych ho mohl dokončit tak rychle jak potřebujete. Tudíž, třeba bude někdo úspěšnější a rychlejší než já.

Pokud by se někdo takový našel, rád mu předám svou ideu ohledně zbývajících částí QS.

Šablony ještě dodělám, už z nich chybí jen kousek.

Co se týče dodělání zbytku, je to na vás, nechte si to projít hlavou a pokud chcete aby to dělal někdo jiný, předám mu žezlo, pokud ne, budu pokračovat. Je to na vás.

Klidně:-) – hlavně ať to nemá deadline… – Ne, jasně, až něco bude, klidně to ASAP zreviduji.

Jinak tady je pro potenciální zájemce sada mých myšlenek:

• Co budeme potřebovat? – done
• Adresářová struktura – done
• Vytvoření databáze – done
• Vytvoření presenteru – done
• Vytvoření šablony – skoro done, dodělám já
• Vytvoření modelu – zde najde čtenář odpovědi na: Co je to Model, Co je to model v Nette Frameworku, Vytváříme model → na konci této části čtenář ví co je to model, ví proč je model důležitý a ví základní pravidla pro tvorbu modelů (eg. že model má být zvenku blackbox, atd), po přečtení má čtenář napsaný model našeho todolistu (což je v mém pojetí třída Todo a třída TodoManager)
• Hezčí šablony – zde najde čtenář odpovědi na: že šablonovací systém nette frameworku má filtry, že tím nejdůležitějším filtrem je Lathe filtr, popis lathe filtru: že má lathe filtr tzv „makra“ a „modifikátory“, jak se zapisují, jak lathe filtr funguje (stručně). Jak upravit naši šablonu tak, aby zobrazila data z modelu (vypsala seznam todoček). Po přečtení má čtenář upravenou šablonu akce tak, aby dovedla vypsat data z modelu. šablona layoutu je vytuněna tak, aby byla lepší. Dále jsou vysvětlena všechna použitá makra lathe filtru.
• Zobrazení tabulky – zde se čtenář dozví jak má upravit akci show presenteru Todolist tak, aby načetla data z modelu a předala je pohledu. Poté se čtenář dozví jak presenteru přidat akci add a edit a delete. Po přečtení této části má čtenář funkční aplikaci, která umí vypsat todolist, přidávat, upravovat a mazat todočka. A chápe jak toho dosáhl.
• Stránkování a řazení – V této části čtenář aplikaci upraví tak, aby uměla stránkovat když vypisuje moc todoček (s tímhletím pak od vás budu potřebovat pomoct i když bych to psal já sám, páč nevím jaký je optimální způsob jak to udělat). A poté naučíme naši aplikaci výpis todoček řadit (resp. měnit pořadí todoček pomocí tlačítek UP a DOWN – neajaxově). Po přečtení této části má čtenář funkční aplikaci která umí stránkovat a řadit todočka.
• Přidáváme AJAX – Do aplikace přidáme AJAX a ukážeme čtenáři jak je to v Nette snadné. Co nejvíce to budem ožné využijeme stávající funkčnost na serveru. Když nám bude fungovat AJAX na přidávání, editaci a mazání (editace bude přes jQuery jeditable), tak pomocí draggable přidáme schopnost přetahování todoček pomocí myší (za účelem přerovnání), podobně jako to davídek udělal na webexpu. Po přečtení má čtenář opět funkční aplikaci, která umí výše popsané a chápe jak toho dosáhl. A připadá mu to hrozně cool a easy.
• Tvoříme komponentu – celou dosavadní aplikaci přetvoříme do znovu použitelné komponenty TodolistControl. Čtenář chápe jak se to dělá a ví zásadní věci ohledně tvorby komponent – továrničky, šablony komponenty, atd.
• Kudy dále? – zde se se čtenářem rozloučíme a říkáme mu, kde má pokračovat ve svém studiu Nette Frameworku. Něco ve stylu: Jako další si přečti …, potom … a když ti to ještě nebude stačit tak existuje … a … A pak je tu samo fórum tak se koukni i tam, máme super coo addony, atd.

Každá část, kromě kudy dále, má na konci „Co bychom si měli zapamatovat?“

Když tohleto celé bude done, tak se to celé znovu projde a zjednoduší se to (ale se zachováním informačního obsahu).

Až i to bude done, tak se to projde znovu a co půjde se vyhodí jinam, do jiné části dokumentace a sem se dá jen link typu: „pokud tě zajímá jak to a to funguje, tak se podívej na XXX“ a to XXX je link do dokumentace. Tyhlety prolinky se dají to [.tip] a [.note]

Při psaní QS nezapomeňte na hlavní úkoly, které při tom máte:

1. čtenář ještě neví jestli je Nette way, vy mu musíte vysvětlit že ANO!
2. čtenář vůbec netuší k čemu by mu mohlo Nette být dobré, říká si „co to ten framework vlastně je?“ „proč bych to měl používat?“ a vy mu to musíte vysvětlit.
3. čtenář chce skrze QS získat informace, ale nechce být jimi zahlcen. Takže chce málo informací, ale zase se chce něco dozvědět a nechce aby QS byl je o tom „Nette je super, používej ho!“, chce vědět proč ho má používat → uspokojit ho vůbec není jednoduché.
4. je velmi pravděpodobné, že po přečtení QS se čtenář hned do něčeho pustí a že bude mít nechuť číst něco dalšího dokud nenarazí na problém. Řada čtenářů přečte jen QS a potom při jekémkoliv dalším problému jde hned prudit do fóra. Takže čím víc věcí čtenáři prostřednictvím QS vysvětlíte takříkajíc bez jeho vědomí, tím lépe pro nás (bude méně prudit) a lépe pro něj (pokud mu to půjde, bude si o Nette Frameworku říkat jak je super cool).
5. Nezapomeňte že ty různé .[note] a .[tip] mají úžasnou moc a využívejte je.
6. .[caution] používejte málo, jen když je to fakt důležité (ta hláška vypadá pak trošku jako error, možná by stálo za to zvážit upgrade jejího vzhledu)

Tak, ještě jeden OT: u stránky o šablonách mám bug, kdy mi Texy nahrazuje za email cestu k šabloně layoutu, což je bug, jak to vyřeším a opravím? Nebo to opravíte někdo jiný?

Tak toliko asi mé myšlenky ohledně QS, pokud někdo máte zájem převzít po mě žezlo, ozvěte se, pokud se nikdo takový nenajde, budu pokračovat – ale berte ne vědomí že rychlost růztu QS nebude nijak valná a rozhodně se nic nestane zítra… Prostě bohužel nemám tolik času kolik bych si přál na věci, které mě baví…

Edit: Jo ještě vlastně jeden potřeh: pro ukázky kódu používejte pro modely a presentery /--code php a pro šablony /--code html

Tak jsem se pokusil o něco k modelu, mohl by ses na to kouknout a upravit to? https://doc.nette.org/cs/quickstart

Díky

Co jiného bys do tohoto konkrétního příkladu dal? Nějakou validaci?

Editoval Ola (8. 3. 2010 20:00)

Díky, pročtu si to.

Tu honzovu diplomku prosím neberte opět jako dogma, stejně jako to co jsem napsal výše (to mé už vůbec protože je noc a je tam plno překlepů a vět, které by ve dne šlo určitě přeformulovat).

Na tyhlety věci okolo modelu (jak toho z MVC tak i toho „modelu systému“) existuje spousta názorů a spousta učených lidí se na detailech nemůže shodnout Martinem Fowlerem počínaje a borci okolo GOF a problematikou SW architektur konče.

Honzova diplomka je hezky zpracovaná bohužel je velmi silně zaměřená apriori na web. Např spousta lidí právě z komunity JEE, ze které i on často čerpá by ve všem nesouhlasila. U velkých SW projektů se řeší jiné problémy, a torchu jinak a tak, ale to je OT…

BTW je tu ještě někdo, kdo tu hozovu diplomku jako já četl celou?

Konkrétněji: v TODO listu může mít úkol metody isDone, markAsDone, atd… Metoda markAsDone může

• nastavit nějaký atribut na TRUE,
• zaznamenat datum dokončení,
• změnu stavu rovnou uložit.

A po označení úkolu jako splněného už třeba nepůjde změnit jeho název a zadání.

P.S. Na základní rozlišovací úrovni Model-View-Controller je úplně jedno, jestli se model dělí na vrstvy či nikoliv. V praxi je asi výhodné to používat, ale ikdyby jsem v modelu volal rovnou SQL dotazy, tak to pořád může být model z pohledu MVC.

Inza napsal(a):

BTW je tu ještě někdo, kdo tu hozovu diplomku jako já četl celou?

Zatím jen části, ale mám to v plánu ;)

P.S. Co myslíš tím „neplést si s modelem z MVC“?

Editoval _Martin_ (9. 3. 2010 8:10)

Je to prima, imho je to z toho dobře pochopitelné, ale zvážil bych změnu příkladu u dědičnosti. Je to možná malinkej rozdíl, ale vadí mi v title bloky, chceme tam spíš text, tedy {$title} radši než {include #title}. V QS bych spíš jako příklad zvolil něco na způsob

<ul>
{block menu}
	<li>o nás</li>
	<li>produkty</li>
{/block}
</ul>

<ul>
{block menu}
	<li class="selected">o nás</li>
	<li>produkty</li>
{/block}
</ul>

případně lepší příklad.

\\Edit: .. a zavináčová magie? Doufáme, že se jí zbavíme než bude QS hotové? :-)

\\Edit: ještě u zmínky o escapování by bylo vhodné to formulovat tak, že to funguje u všech stringů, tedy i {!=‚<b>boldem</b>‘}, což je něco jiného než stačí znak $ prefixovat znakem !.

Editoval Mikulas Dite (13. 3. 2010 16:27)

Rozhodl jsem se předepsat si aplikaci,

http://nette-quickstart.hys.cz

zatím bez stránkování a bez mazání s vypnutým javascriptem. Stay tuned.

A další: https://doc.nette.org/…tion/routing

.. Příští díl je možná i poslední (protože todolist zrovna není znovupoužitelná komponenta) :)

Inza napsal(a):

Todolist rozhodně je znovupoužitelná komponenta. Ta poslední část je IMHO důležitá.

Za další, všechno co jsi napsal vyžadaduje refaktorovat a tak – je to kus skvělé práce ale přeci jenom to ještě není ta finální podoba, prosím uveď to tam – podobně jako je to udělaná u toho dílu s modely.

Jinak aplikace super, skoro takto jsme to měl na mysli i já.

Až budu mít čas tak se na to mrknu a zrefaktoruju pár věcí.

EDIT: Ale jinak jako úplně SUPER:-) – jsi borec:-), máš pochvalu:-)

Ad) znovupoužitelnost: máš pravdu, bylo brzo ráno když sem to psal, zamyslel jsem se na blbou situací ;)

Ad) refaktoring – s tím počítám, dal jsem tam upozornění, ale note (ne caution)

Jinak díky :) pokud něco poupravíš budu jedině rád.

Editoval Ola (14. 3. 2010 9:07)

Supr práce Ola. Prošel jsem pár částí QS a fixl nějaké problémky v typu a coding standardech. Konečně se to pořádně pohlo! :) Do praktického testování jsem se nepouštěl – to si nechám na středu pro své studentíky (které učím Nette). Muaha.

Quickstart se sice bude předělávat, viz Aplikace pro Quickstart – brainstorming, ale určitě to popiš. Pokud nebudeš psát elaboráty, tak můžeš i sem, jinak by bylo asi vhodnější založit samostatné téma a případně o tom rozvinout nějakou diskuzi. Budu rád za jakýkoliv návrh/nápad/podnět, který mi pak pomůže při psaní nového quickstartu. Koneckonců, quickstart má být především pro Vás…