Jó volt, szép volt.
5k netto -- freestyle compo
Leírás
Blog5k - blog engime Felhasználói kézikönyv 1. Bevezető: ============ Ki ne ismerne az Interneten olyan értelmes vagy értelmetlen észosztó helyeket, ahol a laptulajdonos nap, mint nap leírja örömét és bánatát. (Ha nem ismernél, lásd: blog.lap.hu) A Blog5k egy olyan blog engime, mely az önjelölt észosztóknak próbál segítséget nyújtani, mindezt persze 5+5k terjedelemben. A script a Második Magyar PHP Konferencia 5k Compo-ra készült. 2. GNU, GPL, meg mindenféle rövidítés: ====================================== Ha valóban szeretnéd használni, akkor nyugodtan. :) A Blog5k név stipistopi. Válasz majd magadnak más nevet! 3. Használat: ============= 3.1. Telepítés: --------------- - felmásolod, - chmod +w a data könyvtárra, és a benne lévő fájlokra - config fájlban beállítod a jelszót(P) (lásd php.net/md5), - végül örülsz neki. 3.2. Adminisztráció: -------------------- Admin menüpontban lehet új szöveget/linket bevinni. Már meglévő szöveget/linket átírni a szerkesztés gomb megnyomá- sával lehet. Nahát, nahát... :) 4. Program leírás: ================== 4.1. Szerver oldal: ------------------- 4.1.1. Template rendszer: ------------------------- Gondolom mondani, sem kell, hogy milyen hasznos, ha a forráskód és a html részek nem egy helyen vannak. Ha nem így érzed, akkor lásd a tavalyi konf. archívumát! Legelterjedtebb a Smarty template engime. A Blog5k template engime is hasonló szintaktikára épült fel. A legtöbb különbség abból áll, hogy Smarty-ban rengetek olyan funkció van, ami a Blog5k-ban nincs. Ezekre nem is térnék ki. :) Csupán a valódi különbségek: Smarty: //php: $smarty = new smarty(); $smarty->assign('valaki',array('név'=>'Béla','nem'=>'férfi'); //template: {$valaki.név} illetve {$valaki.nem} Blog5k: //php: $t = new s(); $t->a('valaki', array('név' => 'Béla', 'nem' => 'férfi'); //template: {valakinév} illetve {valakinem} A fetch() és a display() függvények is hasonlóan működnek: Smarty: $str = $smarty->fetch('index.tpl'); $smarty->display('index.tpl); Blog5k: $str = $t->f('index'); $t->d('index'); 4.1.2. Lapozás: --------------- Egy használatban lévő blogban több bejegyzése van, mint amennyi felhasználóbarát módban kitehetnénk egy oldalra, ezért lehető- ség van arra, hogy egyszerre csak N (lásd conf.php) darabot je- lenítsünk meg a képernyőn. Alul a két nyilacska jelzi az előre-hátra lépés lehetőségét. 4.1.3. Szűrés: -------------- Háromféleképpen szűrhetünk: dátum szerint, kategória szerint, illetve a keresési feltételnek megfelelően. Advenced felhasználóknak, akik speciális szűrésekre vágynak, figyelmükbe ajánlom az eregi és a date függvényeket! 4.1.3. Többnyelvűség: --------------------- A Blog5k blog engime magyar nyelven készült, de könnyedén át- alakítható tetszőleges nyelvűre. A data könyvtárban a lang_hu.txt -ben található az összes szó, amit a program hasz- nál. Ezek lefordítása esetén máris új nyelven szól hozzánk a rendszer. Szeretném kiemelni, hogy néhány helyen a szórendre is ügyelhet a fordító: "_ db hozzászólás" helyett az angol megfelelő lehet- ne akár: "Comments(_)" (Mielőtt valaki átírna a fent említett fájlt, másolja át új né- ven, majd a conf.php-be állítsa be a megfelelő változót.) 4.1.4. Formázások: ------------------ Mivel bárki szabadon hozzászólhat a bejegyzésekhez felelőtlen- ség lenne megengedni a HTML utasítások szabad használatát. Nem nehéz rossz indulatú JavaScript-eket írni. De a formázások fontosak, ezért is hasznos a bbCode-hoz hasonló: [b]vastag[/b], [i]dőlt[/i], [u]aláhúzott[/u], [del]áthúzott[/del] és végül a [url=hivatkozás]szöveg[/url] formázások. 4.1.5. Külső plugin-ek: ----------------------- Minden valamire való portálhoz lehet hozzátenni külső pluginokat. Nem kivétel ez alól a Blog5k sem. :) A data/p.txt -ben megadjuk, hogy melyik fájlt szeretnénk beincludolni, és hogy a kimenetét melyik template változóba szeretnénk tenni. (lásd 4.1.1. ill i.tpl) 4.1.5.1. Naptár: ---------------- Mivel sután nézett volna ki, ha nincs egy külső plugin sem, ezért készült így ez a naptár... 4.1.6. Statisztika: ------------------- Statisztika, mint olyan nincs, de nem is kell... :) (lásd apache log és webaliser illetve társaikat) 4.2. Kliens oldal: ================== 4.2.1. Tabless (xhtml+css): --------------------------- Tabless oldalaknak egyik nagy előnyük, hogy rendkívül kicsi a méretük. Egy ilyen compo-n ez nagyon hasznos. A kis méret elle- nére Mozilla alatt jól is néz ki, IE alatt már... :) De ugye mivel olyat senki nem használ, ez nem is akkora problé- ma... :) 4.2.2. Nyomtatható verzió: -------------------------- CSS másik nagy előnye, hogy nem kell külön elkészíteni a nyom- tatható verzióhoz az oldalt, hanem egy új stylesheet és már kész a nyomtatóbarát verzió. 4.3. Egyéb érdekességek: ======================== Miután egyszer hozzászóltál valamihez a rendszer megjegyzi a neved és email címed. A fejlécben található képen az index.php tartalma "olvasható". ------------------------ Blog5k blog engime. - 2004.1-2004.3 Túri Gábor - turi pont gabor kukac stack pont hu