Kiemelt támogatók
Interware Internet Szolgáltató Rt Senorg Hungary Rt. Colossal Rendezvénytechnikai Szolgáltató Kft. G'Roby Élelmiszerdiszkont-hálózat Kiskapu Pentaschool Oktatási Központ International PHP Magazine Sprint Computer Kft. Weblabor

Média támogatók
Fix.TV Hobby Rádió
LevitatorMedia phpHOST
Jó volt, szép volt.

5k netto -- freestyle compo kiírás barkochba galéria

elkövette:
tesztfok:
licenc:
ismeretlen

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