[e107 readme]

Az e107 használatához a webszerveren PHP 4.1.0 (vagy újabb) és mySQL 3.22 (vagy újabb) verzió kell, kérdezd meg a szolgáltatódat, ha nem vagy biztos benne, hogy ezek telepítve vannak.
Ha az oldalad a te saját szervereden van, letöltheted a PHP-t és a mySQL-t, és magad is telepítheted, mindkettő szabadon használható.
A tartalom tárolásához szükséged lesz egy mySQL adatbázisra, ennek használatához pedig egy felhasználónévre és jelszóra. Ha nem saját szervered van, a szolgáltatódtól fogod megkapni ezeket. Nem számít, ha csak egy adatbázisod van, az e107 ettől függetlenül használható: vígan megfér más alkalmazások mellett :)
Az e107 kb. 3.5 MB helyet foglal el, de ez szükség esetén kb. 1 - 1.5 MB-al csökkenthető a nem használt theme-k, a htmlarea stb. törlésével.

Telepítés

Az e107 csomag letöltése és kicsomagolása után (a tar.gz csomagot Windows alatt a Windows/Total Commander és a ZipGenius biztosan kezeli) egy FTP kliens programmal fel kell töltened mindent a szerverre. Az e107 vígan futni fog, akár a főkönyvtárba, akár egy alkönyvtárba teszed...
- Indítsd el az FTP kliens programot és kapcsolódj a webszerveredhez
- A webszervereden lépj abba a könyvtárba, ahol a weboldalakat tárolja, ez általában 'public_html', 'www' vagy 'html' - előfordulhat, hogy nem látsz ilyen könyvtárakat, ez esetben már eleve ezek egyikébe léptet be a szerver, csak nem jelzi neked.
- A kibontott e107 csomagból tölts fel minden fájlt - ez eltarthat egy ideig - addig igyál egy kávét :)
Ha van shell elérésed a szerverhez -ez free szolgáltatóknál nincs!- használhatsz egy másik (és sokkal gyorsabb) módot is a feltöltéshez...
(Ha nincs shell elérésed, vagy nem tudod, mi az, ugord át ezt a részt)
- Töltsd le az e107-et tar.gz formában az e107.hu címről
- Az FTP klienssel töltsd fel a tar.gz fájlt a webszerverre kicsomagolás nélkül
- Ezután nyiss egy shell prompt-ot, és lépj be abba a könyvtárba, ahova a tar.gz-t feltöltötted
- add ki a 'tar xvzf file.tar.gz' parancsot a csomag kibontásához
- ha kész, törölheted a tar.gz fájlt

Most be kell állítanod néhány fájl és könyvtár jogosultságát az e107 korrekt működéséhez...
megjegyzés: az e107.hu oldalról letöltött tar.gz csomag esetében erre nincs szükség, abban a szükséges jogosultságok már be vannak állítva, amelyeket a tar.gz formátum megőriz.
Így tudod beállítani a jogosultságokat:
- Az FTP kliens programmal lépj az adott fájlra, vagy könyvtárra, és jelöld ki (természetesen többet is kijelölhetsz)
- Programtól függően jobb egérkattintással, vagy a menüből hívd elő a jogosultságok (CHMOD) vagy attribútumok (Windows/Total commander esetén) beállítása menüpontot
- Állítsd a jogosultságokat 777-re (vagy 0777-re, ha a program így kezeli), ha nem számokat látsz, hanem 3*3 jelölőnégyzetet, jelöld be mindet (Windows-os programok esetében nem valószínű, de előfordulhat, hogy UID, GID és Sticky nevű jelölőnégyzeteket is látsz, ezeket ne jelöld be)
Ezeket a fájlokat és könyvtárakat kell beállítani 777-re (ezeket a telepítő ellenőrzi is):
- e107_config.php
- /e107_files/
- /e107_files/backend/
- /e107_files/backend/news.xml
- /e107_files/backend/news.txt
- /e107_files/cache/
- /e107_files/public/
- /e107_files/public/avatars/
- /e107_plugins/
- /e107_plugins/custom/
- /e107_plugins/custompages/
Nem kötelező, de célszerű beállítani 777-re az /e107_files/ könyvtár többi alkönyvtárát, valamint az /e107_images/ és az /e107_images/newspost_images/ könyvtárakat is, így később nem lesz írási jogosultságprobléma a rendszerben.

Most nyisd meg a böngésződben az install.php-t, például http://webhelyedcime.hu/install.php vagy http://webhelyedcime.hu/e107/install.php
(Megjegyzés: a rendszer mindenképpen ellenőrzi, hogy telepítve lett-e, ezért az install.php-t nem kötelező bírni a cím végére, elég a http://webhelyedcime.hu/ vagy a http://webhelyedcime.hu/e107/ megadása)

Ha minden fájlt sikeresen feltöltöttél, látni fogod a telepítő script első oldalát. Válaszd ki a telepítési folyamat nyelvét (az alapértelmezett a magyar) és kattints a gombra a folytatáshoz.
A következő lépésben az e107 ellenőrizni fogja az írási jogosultságok beállításait (ld. az előző bekezdés listáját), illetve a PHP és a MySQL verzióját. Ha a telepítő azt jelzi, hogy nem tudta azonosítani a mySQL verzióját, az még nem jelenti azt, hogy nem fog feltelepülni az e107: a mySQL néhány verziója nem, vagy rosszul adja vissza a verziószámot. Kattints a gombra a folytatáshoz, ha minden rendben van, vagy javítsd a hibát és ellenőriztesd újra a beállításokat.
Ezután kell magadnod a MySQL adatokat. Írd be a MySQL szerver nevét (ez általában 'localhost'), a felhasználónevet és a jelszót, valamint az adatbázis nevét. Ha nem tudod ezeket az adatokat, kérdezd meg a szolgáltatódat. Ha van hozzá jogosultságod, az adatbázist a telepítő script is el tudja készíteni.
Miután megadtad a szükséges adatokat, az e107 megpróbál csatlakozni a mySQL adatbázishoz, ha hibát jelez, lépj vissza az előző oldalra és ellenőrizd a beírt adatokat.
Az e107 elkészíti a mySQL adatbázis táblákat, és rögzít bennük néhány alapadatot.
Ha minden rendben, az utolsó gombbal az új weboldaladra lépsz. A telepítés itt lényegében véget ért - nehéz volt? :)

Most állítsd a fő konfigurációs fájl jogosultságait 644-re:

Az FTP kliens programmal jelöld ki az e107_config.php fájlt
A korábban leírt módon állítsd a fájl jogosultságait 644-re

Végül, töröld az install.php fájlt a szerverről, ha nem teszed meg, elveszhet az oldalad (valaki újratelepítheti...)

Az oldal tetejére

Frissítés

Bármilyen frissítést csinálsz, előtte nem árt, ha lemented az adatbázisodat, a következő részben leírtak szerint. (A frissítésekkel nagyon ritkán van gond, de biztos, ami biztos)

Ha az előző verzióról frissítesz (pl. 0.614-ről 0.615-re)

Töltsd le, és bontsd ki a frissítő csomagot
Az FTP kliens programmal lépj az e107 főkönyvtárába a szerveren
A frissítő csomag összes fájlját töltsd fel, írd felül az eredeti fájlokat
Lépj be az oldalad adminterületére, ha bármilyen változás van az e107 adatbázisának szerkezetében, erről látni fogsz egy tájékoztatást - kattints a gombra az adatbázis módosítás elvégzéséhez. (Ha valamiért nem tudsz belépni a főoldalról, használd az http://webhelyedcime.hu/e107_admin/admin.php címet a belépéshez)

Ha nem az előző, hanem régebbi verzióról frissítesz (pl. 0.610-ről 0.615-re). A 0.615 és újabb verziók minden frissítést tartalmaznak a 0.600-tól kezdve.
Ezt a módszert bármelyik 0.6xx verzió frissítésére használhatod.

Töltsd le, és bontsd ki a teljes telepítő csomagot
Töröld az e107_config.php és az install.php fájlokat
Az FTP kliens programmal lépj az e107 főkönyvtárába a szerveren
A telepítő csomag összes fájlját töltsd fel, írd felül az eredeti fájlokat
Minden alkalommal, amikor így frissítesz, figyelj arra, hogy NE töltsd fel az e107_config.php-t, mert törlődnek a rendszer működéséhez szükséges beállítások!
Lépj be az oldalad adminterületére, ha bármilyen változás van az e107 adatbázisának szerkezetében, erről látni fogsz egy tájékoztatást - kattints a gombra az adatbázis módosítás elvégzéséhez. (Ha valamiért nem tudsz belépni a főoldalról, használd az http://webhelyedcime.hu/e107_admin/admin.php címet a belépéshez)

Az oldal tetejére

Adatbázis mentése, visszaállítása phpMyAdmin-nal

Első lépésben hívd be a böngészőbe a phpMyAdmin oldalát, és lépj be
A baloldali lenyíló listából válaszd ki az adatbázist (vagy kattints a nevére a lenyíló lista alatt, ha látható)
A főoldalon kattints az 'Export' fülre
A jobb oldali részben (SQL opciók), jelöld be a 'Struktúra', 'Tábla eldobás hozzáadása', 'AUTO_INCREMENT értékének hozzáadása', 'Idézőjelek használata a tábla- és mezőneveknél', és az 'Adat' jelölőnégyzeteket
Ha angol nyelvű a phpMyAdmin, az opciók nevei: 'Structure', 'Add drop table', 'Add AUTO_INCREMENT value', 'Enclose table and field names with backquotes', 'Data'
Jelöld be a 'Fájlnév megadása' ('Save as file') jelölőnégyzetet
Ha tömörített fájlba kéred a mentést, jelöld be a 'zippel tömörítve', 'gzip-pel tömörítve', 'bzip-pel tömörítve' ('zipped', 'gzipped', 'bzipped') opciók egyikét.
Kattints a 'Végrehajt' ('Go') gombra

Mentés visszatöltéséhez a főoldalon kattints az 'SQL' fülre, add meg a mentett sql fájl helyét, és kattints a 'Végrehajt' gombra. Figyelj arra, hogy az adatbázisban nem szerepelhetnek az e107 táblái, kivéve, ha a mentéskor bejelölted a 'Tábla eldobás hozzáadása' opciót.

Néhány tipp az adatbázis mentéséhez:

az adatbázis mentését ne az e107 saját adatbázismentő rutinjával végezd - sokszor üres fájlt készít, aminek nem tisztázott az oka; illetve a tábla- és mezőneveket nem teszi idézőjelbe, így később a mentést nem lehet visszaállítani (e hibának a phpMyAdminból mentéskor az 'Idézőjelek használata a tábla- és mezőneveknél' opció kihagyása felel meg), és a PRIMARY KEY, UNIQUE értékeket sem adja hozzá a tábla adatokhoz. A 0.617-ben emiatt ez a funkció az adminterületen nem is érhető el.
a mentés előtt célszerű rendbetenni az adatbázist: törölni a felesleges bejegyzéseket (ezt csak óvatosan, összedöntheted az adatbázist, ha nem figyelsz!), kiüríteni a tmp táblát, majd kijelölni az összes táblát, és optimalizálni őket - így jelentős méretcsökkenés érhető el, a fontos adatok viszont megmaradnak,
a mentés előtt ellenőrizd, hogy a tábla eldobás hozzáadása opció bejelölt-e. (Ennek elhagyása problémákat okozhat a mentett adatok betöltésénél, kivéve, ha a mentés visszatöltése előtt te törlöd az e107 összes tábláját.)

Az oldal tetejére

Biztonság

A biztonság a kezdetek óta elsődleges szempont, ezért van néhány nagyon egyszerű lépés, amivel te is még bizonságosabbá teheted az oldalad...

Nevezd át az e107_admin könyvtárat: így csak te fogod tudni, hol vannak az adminfelület fájljai

A 0.615 verzióban változott a könyvtárak elérési útjának tárolási helye: átkerült az e107_config.php fájlba

Ha FRISSÍTESZ egy 0.615 előtti verzióról, nyisd meg a class2.php-t, és keresd meg ezeket a sorokat:

// If you need to change the names of any of your directories, change the value here then rename the respective folder on your server ...
$ADMIN_DIRECTORY = "e107_admin/";
$FILES_DIRECTORY = "e107_files/";
$IMAGES_DIRECTORY = "e107_images/";
$THEMES_DIRECTORY = "e107_themes/";
$PLUGINS_DIRECTORY = "e107_plugins/";
$HANDLERS_DIRECTORY = "e107_handlers/";
$LANGUAGES_DIRECTORY = "e107_languages/";
$HELP_DIRECTORY = "e107_docs/help/";
$DOWNLOADS_DIRECTORY = "e107_files/downloads/";
// $DOWNLOADS_DIRECTORY = "<fullpath>/downloads/";
// eg. $DOWNLOADS_DIRECTORY = "/home/downloads/";

Másold ki ezeket a sorokat a class2.php fájlból (vagy innen, ez még jobb), és másold be az e107_config.php fájlba. Ezután írd át a könyvtárak nevét ott.

ÚJ TELEPÍTÉS ESETÉN (0.616 és felette) a könyvtárak nevei már az e107_config.php fájlban vannak, csak kompatibilitási okokból maradt benn a class2.php-ben, de a jövőben el lesz távolítva belőle.

Az e107_admin könyvtár (vagy bármely más főkönyvtár) átnevezése után nyisd meg az e107_config.php-t egy szövegszerkesztővel, keresd meg a könyvtár nevét tartalmazó sort ...
$ADMIN_DIRECTORY = "e107_admin/";
... és írd át az e107_admin/ -t arra, amire átnevezted a könyvtárt
A többi könyvtár átnevezése esetén is ugyanígy kell eljárnod
Találsz még néhány biztonságot növelő beállítást az adminterületen is. Lépj a Beállítások oldalra, ott találsz egy Biztonság nevű részt

Az oldal tetejére

Gyakori problémák

Ha valamilyen okból 'critical error' üzenetet kapsz a 'core' beállításokra, könnyen visszaállíthatod az alapértelmezésre a 'resetcore' script-tel. Ezt az e107_files könyvtár tartalmazza, a böngésződdel hívd meg a http://webhelyedcime.hu/resetcore.php címet, és kövesd az utasításokat. Az eljárás nem érinti a weboldalad tartalmát, kizárólag a 'core' beállításokat írja felül (e107_core tábla az adatbázisban). Az adminterület Adatbázis részében a 'Core beállítások mentése' opcióval bármikor készíthetsz mentést ezekről a beállításokról, ez esetben ezt a mentést fogja visszaállítani a script. A resetcore.php-n kívül még két script van az e107_files könyvtárban:

rtheme.php - Bazzer scriptje, csak a theme-t állítja vissza,
reset.php - saját készítésű script, egyetlen funkciója a core/theme visszaállítás kiválasztása, és a megfelelő script meghívása.

Ha az e107 telepítése után csak egy fehér lapot látsz, ellenőrizd az error_reporting szintet a php.ini fájlban. Általában az a gond, hogy egy 'parse error' van az oldalon, de a php ezt nem jelzi, mert az error_reporting szint túl alacsony, vagy ki lett kapcsolva. Ha nincs hozzáférésed a php.ini fájlhoz, lépj kapcsolatba a szolgáltatóddal
Ha az e107 használata közben bármikor csak egy fehér lapot kapsz, az szintén 'parse error' -ra utaló jel. Sok oka lehet, ezért nagyon fontos, hogy pontosan írd le, mit csináltál, mielőtt megjelent a fehér lap
Ha megjelenik az oldal, de tele van LAN_xxx feliratokkal... : ilyenkor ellenőrizni kell a nyelvi fájlok meglétét, és az e107_languages könyvtár alatt lévő könyvtár nevét, ennek "Hungarian"-nak kell lennie, nagy kezdőbetűvel! Ez a könyvtár tartalmaz egy Hungarian.php-t is, e fájl nevének is nagybetűvel kell kezdődnie! Plugin-ek esetén az e107_plugins/pluginneve/language, vagy languages könyvtárban lévő php fájlok nevét kell ellenőrizni
Ha oldal 'megkergül', azaz állandóan újratöltődik, ugrál a címsorban lévő webcím, de semmi nem jelenik meg: ez olyan free tárhelyeken fordul elő, ahol a szolgáltató bannert tesz az oldal fölé. Ilyenkor a szolgáltató frame-ket használ, és azokat úgy állítja be, hogy a bannert tartalmazó frame mindig az adott oldal felett legyen. Ugyanakkor az e107 is 'legfelülre' teszi magát, ezért a két kód 'összeveszik az elsőbbségen' :) A hiba javítása: az e107_files/e107.js elejéről törölni kell ezeket a sorokat:

if(parent.frames[0])
{
parent.location.href = self.location.href;
}
Ha Undefined Variable vagy Notice hibajelzéseket látsz az oldalon, az error_reporting szint túl magas. Ellenőrizd, hogy az E_ERROR | E_WARNING | E_PARSE van-e beállítva a php.ini-ben, ez esetben is ha nincs hozzáférésed a php.ini fájlhoz, lépj kapcsolatba a szolgáltatóddal

További, gyakran előforduló problémákra, kérdésekre a következő, 'Támogatás' részben szereplő címeken kaphatsz választ.

Az oldal tetejére

Támogatás

A feltett kérdésekre igyekszünk mielőbb válaszolni, de mivel ezt mi hobbiból, szabadidőnkben csináljuk, nem minden esetben tudunk azonnal válaszolni.

fórum
http://e107.hu/forum.php
faq
http://faq.e107.hu/
IRC
#e107.hu csati az IRCNet hálózaton (irc.extra.hu, irc.elte.hu, irc.sote.hu)

e-mail
3 fő e-mail cím van. Az info@e107.hu címre küldött levelek továbbítódnak a tomcat@e107.hu és a rezso@e107.hu címekre.
Infó, segítség kérése e-mailben:
- az e107-tel, és kiegészítőivel /pluginek, menük/ kapcsolatos problémákat mindig a beküldőjének célszerű küldeni, mivel ő foglalkozott vele, nyilván ő tud leginkább segíteni. A beküldő mindig szerepel a letöltéseknél.
- a weboldalakkal kapcsolatos kérdéseket, kéréseket, észrevételeket az oldal fő adminjának kell küldeni, azaz e107.hu esetén a tomcat@e107.hu, a segédoldal és a theme oldal esetén a rezso@e107.hu címre. (a themes.e107.hu oldal esetén a shaark@e107.hu cím is használható)

Az e107 magyar főoldalai:
- http://e107.hu/ - itt célszerű először körülnézni
- http://faq.e107.hu/ - ha valami nem megy... gyakori kérdések, és válaszok
- http://themes.e107.hu/ - ha theme kell...
- http://rezso.e107.hu/ - plugin-ek, illetve az alaprendszer egyes részei 'megpiszkált', nem eredeti formái. Ha innen szedsz le valamit, és nem működik, vagy gondod van vele, azt lehetőleg ne az e107.hu fórumába, hanem a rezso@e107.hu címre írd meg. (Ne keverjük össze az alapcsomagot és a módosított részeket, mert problémát okozhat a kevésbé hozzáértőknek)

Angolul tudók használhatják még az e107 nemzetközi oldalait is. Mindegyik hely nagyon barátságos, a legkisebb gond sem marad válasz nélkül - de mielőtt ott kérdeznél, nézz körül, hogy volt-e már valakinek hasonló problémája, a sokadszor feltett kérdéseket nem szeretik.

e107 fórumok
http://e107.org/forum.php
e107 faq
http://e107faq.bkwon.net
IRC
#e107 az irc.freenode.net szerveren

Külső (az alapcsomagban nem lévő) plugin-ek: e107coders
http://e107coders.org/

Külső (az alapcsomagban nem lévő) theme-k: e107themes
http://e107themes.org/

Az oldal tetejére

Fejlesztés

Az e107-et a nemzetközi fejlesztőcsapat (McFly, Cameron, Lolo, Chavo and Vilhelm) Apache 1.x és 2.x, valamint IIS webszervereken is tesztelte.
A magyar fordítás Linux alatt készül, a tesztelés Apache 2.0.48, PHP 4.3.4 és mySQL 4.0.17 környezetben történik.

Köszönetnyilvánítások

elsősorban VaM-nak, aki felfedezte, és lefordította az e107 0.553-as verzióját, kedvet adva e rendszer kipróbálásához (és bár ő időközben váltott, a személyes kapcsolat megmaradt vele) ,
Tomcat-nak, aki a 0.601 rev10-nek ugrott neki a nulláról - az ugyanis jelentősen eltér a 0.5xx sorozattól,
a shopbox.hu-nak, akik nem csak szolgáltatják a tárhelyet, hanem segítenek is - pl. Dr-agon javításai az smtp-ben -, immár két bot-tal is fenntartják az irc csatit, és úgy általában nem egyszerű szolgáltatóként viselkednek :) ,
fizi-nek, a faq oldal létrehozásáért, működtetéséért,
valamint mindenkinek, aki bármikor, bármilyen módon segített.

Az eredeti fejlesztőcsapat köszönetnyilvánításai:

Thanks first to jalist for starting this whole thing out and sticking with it for so long.
Thanks mainly to Terrence, Damon, que, nalenb, Dawn, HeX0R, JuhaH, bkwon, Knight, Aldrin for their unstinting support.
Also to everyone else who has assisted and submitted translations/fixes etc
Thanks to CraHan, NeXTer, Kuhndog, wols, [steev], rootrider, Claymore, demigod, maaneeack, Schmots, dreamer, galois and the others in [#ls.g] for their friendship.
Thanks to Jérôme C. Meijers and Craig Bramscher
e107.net for donated hosting
Thanks to all of you who have taken the time to create plugins/themes/hacks, answer questions in the forums and IRC channel etc. We have a wonderful community here and it's because of people like you.
And thanks to you for trying e107, I hope you like it and it fits your website needs. If it doesn't try OpenSourceCMS for a full list of alternative systems.
A couple of third-party scripts have been integrated into e107 to make your life easier, so thankyou to ...
- InteractiveTools (http://interactivetools.com) for HTMLArea
- Mihai Bazon (http://dynarch.com/mishoo/home.epl) for the calendar widget
Both these scripts are released under the GPL license and as stated the copyright information has been left intact in the scripts themselves, if you want to use these scripts in your own code you must abide by the GPL license.

Jogi nyilatkozat

Ez szabad szoftver, a GNU GPL2 licensz érvényes rá (ez a csomag tartalmazza) : garancia nélküli, a szoftver hiányosságából bekövetkező bármely probléma miatt a szerző nem vonható felelősségre.
További információ:
angolul: http://www.gnu.org címen, vagy az e107_docs/gpl.txt-ben.
magyarul: http://doc.e107.hu/ címen.
Ezt a szoftvert módosíthatod, terjesztheted, de kérlek hagyd meg az eredeti szerző adatait, a copyright-ot, és biztosítsd a forráskód letölthetőségét.

Az oldal tetejére