ČASTO KLADENÉ OTÁZKY *** Frequently Asked Questions (FAQ) ========================================================= (Poslední aktualizace: 21. 10. 2001) Proč vznikl phpRS? ------------------ K založení tohoto - pro mnohé z vás doufám užitečného - sytému mě vedly následující pohnutky: - potřeboval jsem pro svůj internetový časopis Super Svět (http://www.supersvet.cz) vytvořit nějaký nový kvalitní, výkonný, ale ne příliš rozsáhlý a přetechnizovaný (dá-li se to tak říci) redakční systém, jenž by nahradil můj stávající jen tak "růčo-fůčů spíchnutý" systém. - dalším impulsem bylo také rozhodně mé setkání s projektem "PHP-Nuke: Web Portal System" (http://phpnuke.net), který si klade v podstatě stejné cíle jako phpRS (+ nabízí navíc některé portálové služby), ale na můj vkus to byl již příliš přerostlý systém, který obsahuje až příliš mnoho kódu, databázových tabulek a souborů, což z něj činí sice možná robustní, ale dle mého názoru málo výkonný a efektivní systém. Další vadou na jeho kráse byly také menší či větší problémy s češtinou (alespoň ve verzi 4.4 - verze 5.0 by měla být v tomto směru mnohem dokonalejší), což v konečném důsledku znamenalo, že jste museli vynaložit velké úsilí, aby jste tento systém počeštily a vůbec jej připravili na provoz v české odnoži Internetu. - a v neposlední řadě také výtečná možnost, jak začínajícím PHP programátorům ukázat, co vše a jak lze v tomto skvělém jazyce vytvořit. Kdo je autorem redakčního systému phpRS? ---------------------------------------- Jsem to já, ten průměrný človíček támhle vpravo od lampy, který na vás mává a směje se! - Jmenuji se Jiří Lukáš a můžete mě zastihnou na této e-mailové adrese: jirilukas@supersvet.cz . Již teď se těším na vaše připomínky, nápady a dotazy a mohu vám za sebe slíbit, že se pokusím na všechny odpovědět. Je k phpRS dostupná i podpora? ------------------------------ Ano a to jak ve formě elektronické respektive ve formě on-line (a off-line) manuálů, tak i ve formě "lidské", kterou v současné době poskytuje přímo sám autor tohoto projektu. On-line "manuál": http://www.supersvet.cz/faq_phprs.php On-line databanka phpRS layoutů: http://www.supersvet.cz/databanka.php Jak nakonfigurovat phpRS? ------------------------- K nejzákladnější konfiguraci phpRS slouží specifické proměnné v souboru "config.php", které vám např. umožní definovat adresu vašeho WWW a DB serveru včetně informace o přístupovém účtu, dále také základní e-mailovou adresu redakce a v neposlední řadě i jméno vašeho časopisu/novin. Novinkou od verze 1.1.0 je možnost volby layoutu stránek prostřednictvím speciální proměnné, která ukazuje na "Layout Engine" soubor (lengine.php), jenž je standardní součástí každého specifického layoutu vytvořeného pro systém phpRS. Další konfigurace již probíhá pouze prostřednictvím administračního modulu phpRS, který lze spustit skrze soubor "admin.html", jenž se nalézá v kořeném adresáři phpRS. - Pro první vstup do administračního systému musíte použít následující autorizaci: uživatel = admin, heslo = heslo. Ihned po prvním přihlášení vám doporučuji změnit přístupové heslo, aby nemohlo dojít k jeho zneužití! Jak upravit soubor "config.php" verze 1.0.2? -------------------------------------------- Hlavní konfigurační soubor "config.php" verze 1.0.2 je rozdělen do čtyř základních sekcí, přičemž první tři sekce obsahují konfigurovatelné proměnné a čtvrtá základní spojovací funkci dbcon(), která navazuje spojení s databázových serverem. 1. část (sekce): $dbserver = "mypc.home"; ... slovní označení nebo IP adresa počítače, kde je umístěn MySQL DB server $dbuser = "root"; ... uživatelské jméno (username) vašeho účtu na MySQL DB serveru $dbpass = ""; ... heslo u vašeho účtu na MySQL DB serveru $dbname = "phprs"; ... vaše označení pro phpRS databázi respektive databázi, kde jsou uloženy tabulky redakčního systému phpRS 2. část (sekce): $wwwname="Super Svět"; ... jméno vašeho informačního serveru $baseadr="http://www.supersvet.cz/"; ... základní URL adresa vašeho WWW serveru - např.: http://www.supersvet.cz/ $redakceadr="redakce@supersvet.cz"; ... základní e-mailová adresa vaší redakce $infoadr="supersvet@supersvet.cz"; ... sekundární informační adresa 3. část (sekce): $adrlayoutu="image/base/lengine.php"; ... cesta k "layout engine" souboru $adrobrlayoutu="image/base/"; ... cesta k adresáři, kde je uložen "layout engine" soubor Jak změnit layout (vzhled) u phpRS v1.0.5? ------------------------------------------ Jelikož phpRS verze 1.0.5 ještě neobsahuje možnost volby z několika různých layoutů, předpokládám, že si budete chtít vzhled vašich stránek generovaných prostřednictvím phpRS upravit sami a proto jsem také velkou část úkonů (funkcí) generujících grafický vzhled soustředil do jednoho souboru: "engine.php", který se nalézá v kořenovém adresáři phpRS. V tomto souboru například najdete funkce vytvářející vzhled všech bloků, které phpRS vygeneruje na základě záznamů ve své databázi. Dalším důležitým souborem je i "config.php", který obsahuje proměnnou "$zaklbarva", jenž je nositelkou specifikace základní barvy pozadí všech stránek vygenerovaných phpRS. Základní layout phpRS verze 1.0.5 jsem označil jako "Base" a všechny obrázky patřící k tomuto layoutu jsem soustředil do adresáře "image/base/". - V případě, že budete vytvářet svůj vlastní layout stránek, tak prosím postupujte stejným způsobem a uložte všechny obrázky související s vašim designem do jednoho adresáře dle mého vzoru. Jelikož také do budoucna plánuji zavedení možnosti výběru layoutu stránek z několika možných variant, tak bych rozhodně uvítal, kdy jste se o svůj layout podělili i s ostatními a zaslali jej na následující e-mailovou adresu: phprs@supersvet.cz - Děkuji Jak změnit layout (vzhled) u phpRS v1.1.0 a vyšší verze? -------------------------------------------------------- Od verze 1.1.0 je modifikace vzhledu stránek generovaných redakčním systémem phpRS zase o něco lehčí a to především díky důsledné separaci veškerých grafických funkcí do jednoho na phpRS systému nezávislém souboru, který nyní může být navíc díky své nezávislosti uložen přímo v daném "grafickém/obrázkovém" adresáři spolu s dalšími obrázky potřebnými ke korektnímu chodu příslušného layoutu. Celý tento nový layout vašich stránek generující systém nyní tedy umožňuje bezproblémovou tvorbu nezávislých a lehce distribuovatelných layoutů. Standardní součástí phpRS v1.1.0 jsou dva layouty: "Base" a "Black". Samotné přepínání mezi nainstalovanými layouty lze provádět prostřednictvím změny relativní adresy uložené v proměnné "$adrlayoutu", která je součástí souboru "config.php" a ukazuje na adresář, kde se nalézá soubor "lengine.php" spolu s dalšími obrázky potřebními ke korektnímu chodu daného layoutu. Jak je phpRS koncipován? ------------------------ phpRS verze 1.0.5 (a předpokládám že i u dalších budoucích verzí zachovám stejnou strukturu) je rozdělen na tři základní moduly: a) administrační, b) autorský a c) čtenářský (klientský). - Myslím, že význam prvního a) a posledního modulu c) je v celku jednoznačný a nežádá si dalšího zbytečného výkladu, avšak rád bych něco málo řekl o "autorském modulu", který celý systém dělá skutečně "pravým redakčním systémem"! Vím, že to možná zní trochu zmateně, ale doufám, že pochopíte, co jsem chtěl výše uvedenou větou říci. Dle mého soukromého názoru není redakční (či publikační) systém plnohodnotným redakčním systémem dokud není schopen nějakým způsobem zajistit, aby do systému měli možnost přidávat nové informace i jiní registrovaní (- čili autorizovaní) lidé, než-li administrátor systému a přitom měli samozřejmě pouze jistá omezená práva, která jim stačí ke splnění jejich úkolu - tedy psaní a vkládání nových článků (informací). No a právě tento problém řeší "autorský modul", který je speciálně sestrojen pro výše popsanou skupinu lidí, kteří mají pouze pravomoc psát a vkládat nové články. "Autorský modul" je tedy takový velmi odlehčený "administrační modul". S celým tímto problémem také souvisí i schvalování článků vložených skrze "autorský modul", které se provádí prostřednictvím "Vydavatelská sekce" respektive položky "Redaktor" v hlavním menu "administračního modulu". Jaké jsou vstupní stránky do jednotlivých modulů? ------------------------------------------------- a) administrační - admin.html b) autorský - writer.html c) čtenářský (klientský) - index.php Všechny tyto vstupní soubory jsou umístěny v kořenovém adresáři phpRS. Jakým způsobem jsou adresovány (číslovány) články v phpRS? ---------------------------------------------------------- Pokud se alespoň trochu vyznáte v SQL jazyce a prohlédnete si zákládací SQL kód tabulky "rs_clanky", tak zjistíte, že v této tabulce existují pouze dva sloupce (nepočítám-li ostatní sloupce s jiným jasně zřetelným významem), které lze rozumně využít k jednoznačné identifikaci vloženého článku. Jedná se o auto_increment(tačně) ošetřený sloupec "idc" a sloupec "link". Abych řekl pravdu, tak jsou k výše naznačené činnosti využívány oba dva sloupce, avšak každý úplně jiným způsobem. Sloupec "idc" díky své auto_increment(ační) vlastnosti zaručuje opravdu 100 % jedinečnost článku v phpRS systému a tak je využíván především administračním modulem. Oproti tomu sloupec "link" je generován uměle (tedy aplikací phpRS) a díky své specifické struktuře ("RRRRMMDDXX", kde R ... zastupuje číslo roku, M ... měsíc, D ... číslo dne a konečně X ... jedinečné číslo článku v daný den) je používán především v klientské (čtenářské) části redakčního systému. - Jedinou nevýhodou tohoto sloupce (způsobu číslování článků) je určitá malá možnost vzniku kolize v podobě přidělení jednoho stejného čísla dvěma různých článků, avšak tyto chyby lze snadno napravit jednoduchým zákrokem administrátora phpRS systému. - Do budoucna vám již nyní mohu slíbit, že chystám takové vylepšení stávajícího řídícího kódu, které opravdu značně zredukují možnost kolize na minimum (prakticky na 0)! Jak vložit do redakčního systému phpRS nový článek? --------------------------------------------------- Dlouho jsem přemýšlel o tom, zda-li tuto otázku vůbec zařadit do seznamu "Často kladených otázek", ale pak jsem si uvědomil, že každá aplikace je svým způsobem jedinečná a malý "referát" na téma: "Jak ta má aplikace funguje," nemůže rozhodně nikomu uškodit, ba naopak. I když se na první pohled může zdát, že celá věc - tedy vložení nového článku do databáze phpRS systému - začíná a končí vyplnění jednoho komplexního formuláře schovaného za položkou "Editace článků" v hlavním menu administračního (nebo autorského) modulu, tak vás musí upozornit na skutečnost, že tato akce má poněkud širší záběr a minimálně při prvním spuštění redakčního systému phpRS (a vložením svého prvního článku) si musíte dát pozor na jisté konfigurační záležitosti, které je nutné vyřídit. - Mám na mysli založení všech potřebných (a vymazání všech nepotřebných) rubrik/témat a vytvoření všech známých uživatelů (autorů) phpRS systému. I když tyto akce lze samozřejmě provádět kdykoliv jindy, tak vám může jejich včasné vyřízení ušetři některé následné starosti. Dále bych vás rád upozornil na dvě zajímavé položky, které se vyskytují v přidávacím formuláři a bylo by dobré, kdyby každý uživatel systému phpRS měl o jejich významu absolutně přesnou představu. Jedná se o položky: "Slovní spojení odpovídající danému článku" a "Vydat článek". Položka "Slovní spojení odpovídající danému článku" vám umožňuje přiřadit k danému článku slova nebo slovní spojení, která 100 % vystihují jeho obsah, čehož pak výtečně využívá vyhledávací systém, který čtenářům umožňuje vyhledávat klíčová slova i v této pomyslné databázi "tématických slov", čímž mu zaručuje řádově mnohem vyšší efektivitu vyhledávání! - Síla tohoto způsobu vyhledávání ovšem 100 % závisí na kvalitním vyplnění výše uvedené formulářové položky. Položka (- v tomto případě spíše přepínač) "Vydat článek" představuje poměrně silný nástroj, který dovoluje např. existenci podřízeného "autorského modulu", jehož prostřednictvím mohou do systému vkládat své články i lidé z vnějšího okolí bez rizika, že by došlo k vydání "nepřijatelného" článku, jelikož tento přepínač je v případě "autorského modulu" automaticky nastaven na hodnotu "NE" a toto nastavení lze změnit pouze v "administrační modulu", kde také v podstatě dojde ke kontrole vydatelnosti daného článku. Tato položka ovšem také umožňuje vložit do systému článek, u kterého není znám přesný datum vydaní a nelze tak použít "časovače"! Pokud se správně tážete, co je to "časovač", tak věřte, že se jedná o vnitřní mechanizmus, který klientské části phpRS systému nedovolí zobrazit (vydat pro veřejnost) články, který mají své datum vydání vyšší, než-li je aktuální datum serveru. Jedná se tedy o články, které mají své datum vydání na pomyslné časové ose v budoucnu. - Datum vydání lze ovlivnit např. při vkládání článku! Co vše nabízí v rámci personalizace redakční systém phpRS? ---------------------------------------------------------- Hlavním úkolem "personalizačního systému" v redakčním systému phpRS je umožnit vašim čtenářů částečné přizpůsobení chování vašeho informačního webu jejich představám a to prostřednictvím několika málo voleb, které se v blízké budoucnosti jistě dočkají svého dalšího rozšíření: Současné možnosti personalizačního systému jsou následující: a) registrovaní uživatelé: mají možnost stát se odběrateli "informačních e-mailů", které je budou informovat o nových článcích a vytvořit si své vlastní "navigační menu" (- zobrazuje se v levém blokovém sloupci úplně nahoře), které se pro ně stane nedílnou součástí vašeho webu. b) neregistrovaní uživatelé (+ registrovaní): při každé návštěvě vašeho webu bude provedena kontrola "aktuálnosti", která zjistí, zda-li došlo k nějaké aktualizaci od poslední návštěvy daného čtenáře na vašem webu a v kladném případě bude na tuto skutečnost čtenář informován prostřednictvím malého okénka (- tato funkce je standardně aktivována pouze na hlavní stránce "index.php" a funguje pouze v případě, že má čtenář povolené používání cookies technologie!). Co znamená pojem: "stránkový alias"? ------------------------------------ "Stránkový alias" je označení jedné z mnoha funkcí redakčního systému phpRS, která umožňuje vytvořit z obyčejného "textové" souboru (- může obsahovat HTML syntaxi) standardní phpRS systémem vytvořenou stránku s kompletními navigačními a informačními prvky. Protože takto vytvořená (virtuální) stránka je v systému identifikovatelná pouze prostřednictvím svého zástupného označení - tzv. aliasu -, je tato funkce označována jako "stránkový alias"! "Stránkový alias" lze vytvořit v administračním modulu a volání jednotlivých stránek je realizováno prostřednictvím souboru "showpage.php" a jeho speciálního atributu "name". - Ukázka volání aliasu "licence": showpage.php?name=licence Výhody "stránkového aliasu": a) Rychlá a efektivní tvorba "vlastních stránek" s možností zachování společného vzhledu pro celý informační web. b) Díky jednoduchosti celého systému můžete jeden a tentýž alias přidělovat v čase různým souborů, což v praxi znamená, že jednou může alias "redakce" ukazovat na soubor "red1.txt" a jindy zase na soubor "red2.txt", přičemž není nutné nic mazat ba ani přepisovat. Co je to "blok" a k čemu slouží? -------------------------------- "Blok" je malý informační obdélník, který se nalézá na levém nebo pravém okraji obrazovky a skládá se z nadpisu a hlavního textu. V případě, že je definováno větší množství bloků, tak společně vytváří dva ucelené informační sloupce, přičemž jeden je umístěn na levé a druhý na pravé straně obrazovky. Hlavní funkcí "bloku" je trvalé, ale i přesto velmi flexibilní, zobrazení určité informace (upozornění, odkazy, rozcestník, atd.) na každé WWW stránce vygenerované redakčním systémem phpRS! Definice samotných "bloků" probíhá v administračním modulu v rámci sekce "Úprava bloků". Od phpRS verze 1.3.0 je pořadí bloků v rámci jednoho ze dvou možných informačních sloupců řízeno tzv. "prioritou bloku", což v praxi znamená, že blok s nejvyšší prioritou (= nejvyšší číslo z intervalu od 1 do 255) je umístěn v rámci svého sloupce úplně na hoře a naopak blok s nejnižší prioritou úplně na spodu daného sloupce. - Pokud mají dva bloky v jednom sloupci stejnou prioritu, tak rozhoduje pořadí, ve kterém byly do systému vloženy. Poslední zajímavou volbou, se kterou se setkáte při definici nového bloku je "typ bloku", jenž vám umožní v rámci dvoubarevného layoutu specifikovat, který ze dvou barevných vzorů chcete aplikovat na daný blok. - V případě, že využíváte jednobarevné schéma, tak je takto volba pro vás v podstatě bezpředmětná, i když lze doporučit v rámci zlehčení případného pozdějšího přechodu na dvoubarevné schéma chovat se tak, jako by jste definovali blok pro dvoubarevný layout. ============================================================================================================================= phpRS - redakční systém, verze 1.4.0 Copyright (C) 2001, Jiří Lukáš http://www.supersvet.cz/phprs/ Tento program je volné programové vybavení; můžete jej šířit a modifikovat podle ustanovení Obecné veřejné licence GNU, vydávané Free Software Foundation; a to buď verze 2 této licence anebo (podle vašeho uvážení) kterékoli pozdější verze. Tento program je rozšiřován v naději, že bude užitečný, avšak BEZ JAKÉKOLI ZÁRUKY; neposkytují se ani odvozené záruky PRODEJNOSTI anebo VHODNOSTI PRO URČITÝ ÚČEL. Další podrobnosti hledejte v Obecné veřejné licenci GNU verze 2 a vyšší.