E107 kézikönyv Kezdőtől a haladó szintig Szerkesztőség, könyv: A kézikönyv az e107 Magyarország kiadásában készült. A kézikönyv engedélynélküli terjesztése, felhasználása nem megengedett. A kézikönyvet shaark készítette, a tartalom összeállításában valamint a kézikönyv lektorálásában segédkezett fizi, lac, M an o, zsigi valamint Tomcat. Elérhetőségek: http://e107hungary.org info@e107hungary.org Jelmagyarázat: Megjegyzések, ötletek Figyelmeztetések, tipikus hibalehetőségek Hibák, elírások: Ha bármilyen hibát vagy elírást találnál a kézikönyvben azt jelezd a szerkesztők felé az info@e107hungary.org címen! 1. Bevezetés Az e107 napjaink egyik legkönnyebben kezelhető valamint a legdinamikusabb cms rendszere. Ez annak köszönhető, hogy PHP, AJAX, JavaScript valamint CSS nyelven íródott melyhez bármilyen SQL adatbázis társulhat. Az e107 nyíltforráskódú rendszer, használata ingyenes. Az e107 használatához MySQL adatbázis használata ajánlott, mivel a legtöbb szerveren az SQL ezen típusa fut és erre lett fejlesztve.
2. PHP, AJAX, SQL, CSS PHP azaz, Hypertext Preprocessor, széles körben használt általános célú szkriptnyelv, amely kifejezetten alkalmas - akár HTML-be ágyazott - webalkalmazások fejlesztésére. A PHP a C valamint a PERL nyelvekre épül, ennek köszönhetően igen gyorsan és könnyen elsajátítható használata. Bővebb információ: http://php.net AJAX napjaink egyik legújabb technológiája illetve programozási nyelve. A java valamint az XML keveréke, ezáltal igen dinamikus. A legnagyobb újdonság ebbe, hogy lehetőségünk van az oldalunk egy bizonyos részének frissítésére, nem kell az egészet újratölteni. (My)SQL Az SQL egy igen elterjedt adatbázis-szerkezet, rendszer. Használata minimális szaktudást igényel. A svéd fejlesztésű MySQL a legelterjedtebb fajtája, mivel azt a legkönnyebb használni és gyorsaságilag is igen előkelő helyen áll. Bővebb információ: http://www.mysql.com/ CSS azaz, Cascading Style Sheets, a webprogramozók nagy szeretettel használják. Segítségévél különböző dizájn-sablonokat készíthetünk, ezáltal szebb megjelenést kapunk és egy átláthatóbb rendszert. Bővebb információ: http://www.w3.org/ 3. CMS CMS azaz, Contant Management System, ami magyarul annyit jelent, hogy tartalomkezelő rendszer. Ezeknek a rendszereknek az a specialitásuk, hogy a kommunikáció kétirányú, tehát a vendég/felhasználó is tud kommunikálni mindenkivel, nem csak az adminisztrátor tud elhelyezni tartalmat az oldalon. Továbbá arról sem szabad megfelejtkezni, hogy ezeket a rendszereket lehet internetes felületről is szerkeszteni. 4. Nyílt forráskód Manapság a számítástechnika világában ez egy igen közkedvelt téma. Az olyan szoftvereket nevezzük nyílt forráskódú szoftvereknek, amelyeknek a
forráskódját mindenki szabadon megtekintheti, felhasználhatja egy licenszen belül. Az e107-re a GNU/GPL licensz vonatkozik. Bővebb információ: http://fsf.hu 5. Segítség Ha bármilyen problémád lenne az e107-tel, először nézz körül a http://faq.e107hungary.org címen ahol, sok magyar nyelvű leírást találsz a különböző hibákról. Ha azonban itt nem találnál választ rá keress rá a fórumban, hogy nem vetette-e már fel valaki a te hibádat és, hogy nem-e érkezett rá válasz. Ha a hibajelenségre nincs válasz nyithatsz egy új témát a hibával kapcsolatban vagy chaten is kaphatsz segítséget. A chatet a következő címen tudod elérni: Szerver: irc.elte.hu Szoba: #e107hungary.org Ha egyéb észrevételed lenne azt az info@e107hungary.org címen jelezd. 6. Kiegészítők Az e107-ben, pluginek, menük valamint themek találhatóak. Ezeket a kiegészítőket magyarul az e107 Magyarország Team weboldaláról tudod letölteni. Az összes kiegészítő kikerül idővel magyarul is ide, amely a nemzetközi oldalon megjelent angolul. 7. Pluginek, menük, themek Pluginek A pluginek segítségével újabb funkciókat léptethetünk életbe az oldalunkon, tehát az weblapunk szerves részévé válik. A pluginek továbbá tartalmazhatnak menüket is. A pluginek telepítéséről, konfigurálásáról később teszünk említést. Menük A menük jelentős része csak információközlésre szolgálnak. Az oldalunk két oldalán (legtöbbször) található menüblokkokban tudjuk őket elhelyezni. Ezek telepítéséről, beállításáról később teszünk említést.
Themek A themek felelnek az oldal kinézettéért. Themek készítése valamint beállítása igen egyszerű az e107-tel. Azonban nem kell megijedni, kész themeket is le lehet tölteni az internetről. 8. e107 letöltése és telepítése Letöltés Az e107 telepítése roppant egyszerű, néhány perc alatt elvégezhető. Azonban, ha az ember ingyenes tárhelyen telepíti a rendszert, felléphetnek különböző hibák a korlátozások miatt. Először is látogasd meg az e107 Magyarország Team weblapját, a http://e107hungary.org címen. Itt a letöltések közt keresd meg a core vagy a motor kategóriát, majd a kategórián belül megtalálod a legfrissebb e107-es rendszer motorját. Tehát kattints a letöltésre. Feltöltés Miután letöltötted, ki kell csomagolnod, majd a kicsomagolt fájlokat fel kell töltened tárhelyedre egy FTP kliens segítségével. A feltöltés során figyelj arra, hogy ne legyen bekapcsolva a fájlnevek kisbetűssé alakítása, mivel a nyelvi fájlokat a rendszer nem tudja betölteni minden esetben. Ha rendelkezel shell eléréssel (ez ingyenes tárhelyek esetében nem érhető el) akkor a becsomagolt fájlt töltsd fel FTP kliens segítségével, majd nyiss meg egy shell prompt -ot és irányítsd a mappához, ahová feltöltötted az archívumot, végül add meg neki, hogy csomagolja ki a tömörített fájlt. Telepítés megkezdése Ha feltöltéssel végeztél, nyisd meg a böngésződ és írd be a weblapod címét egy /install.php-val megtoldva (pl: http://teoldalad.hu/install.php). Ekkor betöltődik az e107 telepítőjének első oldal, ahol a nyelvet kell kiválasztani egy legördülő menü segítségével. Ha kiválasztottad a neked megfelelő nyelvet kattints a továbbra.
Fájlok/mappák ellenőrzése Ezek után a telepítő ellenőrzi, hogy a szerver, ahova feltöltötted az e107-t megfelel-e a kritériumoknak. Előfordulhat, hogy a MySQL szerver ellenőrzésekor hibát jelez, mivel a verzió pontos lekérése nem biztos, hogy sikerült, ilyenkor kattints a tovább gombra, ha a többi kritérium megfelel. A rendszer ebben a szekcióban elvégzi a mappákra/fájlokra való jogosultságok ellenőrzését is, tehát a CHMOD-ot. CHMOD: A CHMOD-nak a magyar megfelelője a fájl attribútum, ez a fájlok írási, olvasási valamint szerkesztési jogait jelenti. A maximum érték a 777, amikor a rendszernek joga van az összes művelethez. Ha az e107 nem tudja átírni saját maga, mert a rendszergazda által tiltva van, akkor az ott felsoroltaknak állíts be 777-es jogosultságot. A CHMOD-ot FTP kliens segítségével lehet beállítani, minden FTP kliensben ez máshol található meg. Mindenesetre windows, linux és MacOS rendszereken jelöld ki a fájlt, majd keress a menüben CHMOD vagy attribútum funkciót. MacOS rendszereknél egy másik lehetőség is van, jelöld ki a fájlt/mappát majd nyomd le az apple+i gombot és a felugró képernyőn állítsd be a 777-es jogosultságot. Ha ezzel is végeztél a rendszer újból leellenőrzi a jogosultságokat, ha minden megfelelő kattints a tovább gombra! Adatbázis beállítása A telepítés következő részénél a MySQL-hez szükséges jelszót, felhasználónevet illetve a szervercímet, valamint a prefixet (tábla előtag) kell megadni. A MySQL szerver címe a legtöbb esetben localhost. A felhasználónév és a jelszó általában megegyezik az FTP felhasználónevével és jelszavával, továbbá az adatbázis neve is megegyezik az FTP felhasználónévvel.
Az adatbázis létrehozása funkciót csak akkor jelöljük be, ha egy új adatbázisban szeretnénk tárolni az adatokat és van jogunk az adatbázis létrehozásához (ingyenes tárhelyek esetében ez a funkció le van tiltva). A tábla előtag bármi lehet. Ennek az a szerepe, ha például két e107-es rendszert szeretnénk használni egy tárhelyen, de csak egy adatbázisunk van. Ilyenkor a két rendszer a tábla előtagok segítségével különül el egymástól. Ha mindennel megvagyunk és az adatok is megfelelőek, kattintsunk a továbbra. Főadminisztrátor létrehozása Végül az utolsó lépésben egy főadminisztrátort kell létrehoznunk. Értelemszerűen adjuk meg az adatokat. Nagyon fontos, hogy helyes e-mail címet adjunk meg, mert, ha elfelejtenénk a jelszavunk és az adatbázisok terén se vagyunk nagyon ismertek, akkor az alábbi e-mail címre küldi el a rendszer a jelszavadat. Lehetőség van arra, hogy több főadminisztrátor is legyen az oldalon, ehhez hozzunk létre egy felhasználót ( vagy válasszunk ki egy már létezőt) majd lépjünk be a mysql adatbázisunkba, válasszuk ki az e107_user táblát, majd itt azt a felhasználónevet akinek szeretnénk adni a főadminisztrátori jogot és végül a user_admin mezőt írjuk át 1- re. A főadminisztrátornak nincs különösebb joga, mint egy olyan tagnak, akinek az összes létező jogot odaadtuk. A telepítés után célszerű az install.php-t törölni tárhelyünkről, valamint az e107_config.php jogosultságát 644-re átállítani. Ezeket csak biztonsági okokból javasolt megtenni, 9. e107 frissítése Az e107 frissítése nem igényel különösebb szaktudást, csak töltsük le a legfrissebb motort, csomagoljuk ki a gépünkre, majd töröljük az install.php-t valamint az e107_config.php-t, ha léteznek. Ezután egy FTP kliens segítségével töltsük fel a fájlokat.
A feltöltés után menjünk lapunkra, jelentkezzünk be adminisztrátorként, majd nézzük meg az adminterületen, hogy szükség van-e az adatbázis frissítésére. Ha szükség van, kattintsunk a frissítésre és a szükséges műveleteket elvégzi az e107. A frissítés előtt célszerű biztonsági másolatot készíteni a fájlokról és az adatbázisról, hogy véletlenül se vesszen el adat a frissítés során. Nem ajánlatos régebbi verziót a legújabbra frissíteni (pl.: 0.616-ot 0.7- re) mivel az újabb verziók mindig az előtte lévő verziókhoz szükséges frissítéseket tartalmazzák. Tehát ajánlatos a réteges frissítés, vagyis ahogy a példánk mutatja, először 0.617-es verzióra frissíteni, majd 0.618-ra és végül 0.7-re (0.619-es verzió nincs). 10. e107 költöztetése A költöztetés legalább olyan egyszerű, mint a frissítés, ha nem egyszerűbb A fájlokat valamint az adatbázisod másold át a régi tárhelyedről az újra. Célszerű mentést készíteni a fájlokról és az adatbázisról is. Ha azonban a lapunk nem működne megfelelően a telepítés után az e107_config.php-ban az elérési utat csekkoljuk és, ha ezek után se működne a rendszer fordulj hozzánk segítségért. 11. Adminterület Bejelentkezés Amikor betöltődik az oldalad, a lapodon az egyik menüblokkban találsz egy Bejelentkezés menüt, olyat amilyen a képen látható (természetesen a kinézette eltérhet, ha más themet használsz). Ügyelj a kisbetűk és nagybetűk használatára, mivel a rendszer azokat is megkülönbözteti. Ha nem találnád ezt a menüt a http://teoldalad.hu/e107_admin/admin.php címen be tudsz jelentkezni az adminterületre. Adminisztrációs-felület Amikor bejelentkezünk az adminterületre egy ehhez hasonló felület jelen meg előttünk. Az adminterület dizájnát is ugyanúgy lehet váltani, mint az oldalét, sőt
még a csoportosítást is lehet. De erről csak a Themek kezelő pontnál fogunk bővebben beszélni. Ennek a menüsornak a segítségével az adminterület bármely részéről könnyen átugorhatunk egy másikra. Itt az összes adminfunkció fel van sorolva ABC sorrendben. Ezen a területen található meg az összes plugin hivatkozása valamint a plugin kezelőé is, más nevén Plugin Manager. Ez egy összesítés a lapunkra, hány újdonság van valamint egy rövid statisztika a tagokról. Jogi rész az e107-ről, valamint ha a Credits -re kattintasz az e107 cms
fejlesztők jelennek meg. Ez egy rövid összefoglaló az oldalról. Itt jelennek meg a technikai információk, tehát melyik e107 van telepítve, melyik theme aktív, mikor, milyen platformon lett telepítve stb Adatbázis Ennél a funkciónál az adatbázissal kapcsolatos műveleteket tudjuk elvégezni. Ezt az ember nem túl sűrűn használja, de azért célszerű néha ide is tekinteni. Most vegyük sorra, hogy itt mi, mit jelent. Adatbázis frissítésének keresése Ha az e107-ből egy újabb rendszert töltünk fel, akkor lehet, hogy az új rendszernek más az adatbázis-felépítése. Ilyenkor a szinkronizálást az e107 elvégzi, neked csupán a Frissítések keresése gombra kell kattintani. Adatbázis lementése A lapunk adatbázisát célszerű minimum havonta lementeni, hogyha valamilyen technikai probléma lenne, ne vesszen el minden adat, tehát havonta minimum egyszer kattints az Adatbázis -re. Adatbázis érvényességének ellenőrzése Ez a funkció hasonlít az elsőhöz, minden frissítés után ajánlott megtenni ezt a műveletet, hogy ne legyen véletlenül se fennakadás a későbbiekben. Adatbázis optimalizálása Ez is hasonlít az első funkcióhoz. Ezt akkor használjuk, ha például belenyúlkáltunk az adatbázisba és valamit sikerült elrontani. Alapbeállítások lementése A név magáért beszél. Az alapbeállításokat menthetjük itt le, ez annyiban különbözik a teljes adatbázis mentésétől, hogy itt csak az alapfunkciók kerülnek mentésre. Admin jelszó módosítása Itt a saját jelszavunkat tudjuk megváltoztatni. Különösebb magyarázatra itt nincs szükség.
Adminisztrátorok Ez már egy összetettebb dolog valamivel. Az adminisztrátorok jogosultságait tudjuk változtatni (kivéve a főadminisztrátorét). ID Ez a felhasználónévhez tartozó szám, amelynek segítségével könnyen lehet bárkit azonosítani. Felhasználónév Ez az adminisztrátor felhasználóneve. Jogosultságok Két csoportra lehet bontani a jogosultságokat, a fő adminisztrátorra és az egyéni jogosultságokra. A fő adminisztrátor az, akinek minden joga megvan, az egyéni jogosultaknak pedig csak néhány, amelyet a fő adminisztrátor jelölt ki a számára. Minden egyes ilyen jogosultsági funkciót egy szám vagy egy betű jelöl. Egy táblázat a jogosultságokról: Funkció neve Szám vagy betűjele Oldal beállításainak módosítása 1 Menük módosítása 2 Admin hozzáadása 3 Felhasználó moderálása/kitiltása stb. 4 Fórumok létrehozása/szerkesztése 5 Letöltés kategóriák kezelése Q Fájlok feltöltése/kezelése 6 Vizsgálat a file ellenőrzővel Y Email értesítés beállítása O Hírkategóriák kezelése 7 Link kategóriák kezelése 8 Rendszer cache betöltése Fő adminisztrátor Karbantartás bekapcsolása 9 E-mail beállítások és levélküldés W Bannerek kezelése D Hírforrások beállítása E Emotikonok beállítása F Főoldal tartalmának beállítása G Naplózás/statisztika beállítása S Meta tag-ek beállítása T Publikus feltöltés beállítása V Keresés beállítása X
Hozzászólások moderálása Új hír közzététele Új link közzététele Új tartalmi oldal közzététele Új letöltés közzététele Új szavazás közzététele Üdvözlő üzenet Beküldött hírek moderálása Plugin Manager B H I L R U M N Z Ezentúl minden pluginek van egy száma, amelyhez hozzátársul a P betű, tehát, ha csak egy plugin van telepítve, akkor annak a pluginnak a jogosultsági jele P1. Opciók Itt két hivatkozás található, ha az elsőre kattintunk a felhasználó jogosultságait tudjuk módosítani, ha az x-re, vagyis a másodikra akkor töröljük a felhasználó összes jogosultságát.