Free registration

My profile

Information

Services

Add

Mail us

	How to search ? How to competition ? Monitoring order My Pravě dnes Games and ringtones

Další informace

Použití služby MonitorBOX

Můj profil: generování HTML kódu pro MonitorBOX

Fungování služby MonitorBOX již bylo stručně popsáno na stránce o službách. V tomto dokumentu se dozvíte více o praktickém použití této služby. Bylo zmíněno, že se nalezené odkazy ukládají do speciální schránky, kterou si může majitel služby pravidelně stahovat. V tuto chvíli existují čtyři podporované způsoby stahování. Pokud si však myslíte, že ani jeden není vyhovující pro Vaše potřeby nebo máte námět na vylepšení, kontaktujte nás a my se Vám pokusíme vyhovět.

1. Generovaný kód pro Vaši HTML stránku

V okamžiku, kdy si aktivujete službu typu MonitorBOX, máte možnost si nechat vygenerovat speciální HTML kód. Ten pouze vložíte do stránky na Vašem WWW serveru a všechno bude fungovat jak má. Je to nejrychlejší způsob jak využít MonitorBOX.

Věnovali jsme značnou dobu vývoje tohoto způsobu přenášení faktu, že vkládané kódy často zpomalují zobrazení stránky, ve kterém jsou umístěny. To ovšem není náš případ. Kód, který pro Vás vygenerujeme funguje v prohlížečích IE 4.0 a vyšších zcela asynchronně.

Kód si můžete nechat vygenerovat na stránce Vašeho profilu. (viz. obrázek vpravo)

Pokud máte zkušenosti s tvorbou WWW stránek a rozumíte CSS stylům a JavaScriptu, můžete si upravit vygenerovaný kód tak, aby ještě více vyhovoval Vašim potřebám.

2. Přenášení schránky jako textového souboru

Pokud Vám nevyhoví generovaný HTML kód (způsob 1), můžete využít stahování textového souboru pomocí protokolu http. Na adrese http://www.pravednes.cz/exportbox.jsp je k dispozici dynamická stránka, která slouží ke stahování schránky. Data, která můžete z této adresy stáhnout jsou ve tvaru textového souboru s kódováním češtiny windows-1250 a každý řádek souboru přitom obsahuje informace o jednom nalezeném odkazu. Soubor může vypadat např. takto:

Klaus byl zvolen prezidentem|http://www.mynews.cz/clanek1.php|Dnes odpoledne byl novým prezidentem...
Další případ BSE|http://www.noviny.cz/dnes/1204.jsp?id=23|Na soukromé farmě blízko Prahy byl objeven...
Ceny pozemků rostou|http://www.idnes.cz/clanek.phtml?n=842|S blížícím se vstupem do EU se ceny...
...

Uvedený tvar je opravdu jenom příklad, protože stránka exportbox.jsp může mít parametry, kterými formát ovlivníte. Těmto parametrům se teď budeme blíže věnovat.

Paramtetry se do dynamické stránky exportbox.jsp předávají standardně podle způsobu zápisu URL adres, tj. ve tvaru: http://www.pravednes.cz/exportbox.jsp?par1=hodnota1&&par2=hodnota2&par3=... Význam na jména podporovaných parametrů jsou uvedena v násl. tabulce:

Parametr Význam Příklad

serv Kód služby, která vytváří požadovaný MonitorBOX. Kód služby zjistíte na stránce Vašeho profilu. Tento parametr je povinný. serv=872

format Určuje pořadí údajů o odkazu jak se vyskytnou na řádku v souboru. Hodnota parametru musí být ve tvaru slova složeného z předesaných písmen. Každé písmeno je označením údaje podle násl. významu:
T - titulek odkazuU - url stránky neboli link
D - krátký popis (abstrakt)
P - datum publikování
S - název internetového zdroje, který publikoval článek
L - odkaz na homepage internetového zdroje
V parametru se nemusí vyskytnout všechna písmena. Pokud chcete, aby řádek s odkazem obsahoval pouze název článku a link na tento článek, můžete použít hodnotu TU. format=PUTSLD

separator Hodnotou je znak, kterým budou odděleny jednotlivé údaje na řádcích. Výchozí hodnota je znak | (svislá čára). separator=*

limit Pokud chcete stáhnout méně odkazů (řádků) než kolik je v boxu, použijte tento parametr a jako hodnotu uveďte celé kladné číslo (1-velikost boxu). limit=5

cut Omezí délku popisu na určitý počet znaků. Pokud je popis delší, odřízne jeho konec a doplní 3 tečky (...). cut=150

notime "Datum publikování" nebude obsahovat čas, ale pouze datum. Na obsahu parametru nezáleží. notime=true

Parametr	Význam	Příklad
serv	Kód služby, která vytváří požadovaný MonitorBOX. Kód služby zjistíte na stránce Vašeho profilu. Tento parametr je povinný.	serv=872
format	Určuje pořadí údajů o odkazu jak se vyskytnou na řádku v souboru. Hodnota parametru musí být ve tvaru slova složeného z předesaných písmen. Každé písmeno je označením údaje podle násl. významu: T - titulek odkazuU - url stránky neboli link D - krátký popis (abstrakt) P - datum publikování S - název internetového zdroje, který publikoval článek L - odkaz na homepage internetového zdroje V parametru se nemusí vyskytnout všechna písmena. Pokud chcete, aby řádek s odkazem obsahoval pouze název článku a link na tento článek, můžete použít hodnotu TU.	format=PUTSLD
separator	Hodnotou je znak, kterým budou odděleny jednotlivé údaje na řádcích. Výchozí hodnota je znak \| (svislá čára).	separator=*
limit	Pokud chcete stáhnout méně odkazů (řádků) než kolik je v boxu, použijte tento parametr a jako hodnotu uveďte celé kladné číslo (1-velikost boxu).	limit=5
cut	Omezí délku popisu na určitý počet znaků. Pokud je popis delší, odřízne jeho konec a doplní 3 tečky (...).	cut=150
notime	"Datum publikování" nebude obsahovat čas, ale pouze datum. Na obsahu parametru nezáleží.	notime=true

Tento způsob předávání schránky je sice maximálně flexibilní, ale vyžaduje trochu programování na Vaší straně. Ideální řešení je, když na Vašem serveru necháte v pravidelných intervalech (nemá význam kratší interval než 1 hodina) stahovat obsah souboru pomocí jednoduchého skriptu. Skript projde jednotlivé řádky a uloží jejich obsah do databáze nebo vygeneruje HTML kód, který si vložíte do vybrané stránky. Pokud Váš server běží na operačním systému Unix/Linux, můžete si takový skript nechat spouštět pomocí cronu.

3. Přenášení schránky jako HTML

Výše uvedený postup přenášení Vám poskytne maximální volnost. Pokud ale chcete získávat obsah schránky za účelem jeho zobrazení na Vašem webu (nebo intranetu), můžete si data stahovat přímo jako předpřipravený blok ve formátu HTML a ten už si jen vložíte do dané stránky. Pro tento způsob použijete jinou dynamickou stránku, která je na adrese http://www.pravednes.cz/exportbox-html.jsp. I tato stránka má doplňující parametry, které ovlivňují tvar generovaného HTML kódu. Tyto parametry jsou:

Parametr Význam Příklad

serv Kód služby, která vytváří požadovaný MonitorBOX. Kód služby zjistíte na stránce Vašeho profilu. Tento parametr je povinný. serv=872

format Určuje pořadí v jakém se jednotlivé údaje vyskytnou v generovaném HTML kódu. Hodnota parametru je libovolný řetězec, který by měl obsahovat níže uvedené kódy (včetně složených závorek):
{T} - titulek odkazu uzavřený do značky (odkazuje se na daný článek)
{D} - krátký popis (abstrakt)
{P} - datum publikování
{S} - název internetového zdroje, který publikoval článek uzavřený do značky (odkazuje se na homepage zdroje)
V parametru se nemusí vyskytnout všechny kódy. Pokud chcete, aby řádek s odkazem obsahoval pouze název článku, můžete použít hodnotu {T}.Pokud mezi kódy uvedete nějaký text, bude kopírován do výstupního HTML bloku. format={P}{T}{S}{D}

limit Pokud chcete do HTML kódu zařadit méně odkazů než kolik je v boxu, použijte tento parametr a jako hodnotu uveďte celé kladné číslo (1-velikost boxu). limit=5

cut Omezí délku popisu na určitý počet znaků. Pokud je popis delší, odřízne jeho konec a doplní 3 tečky (...). cut=150

target Do odkazu na titulku zprávy přidá atribut target s hodnotou podle tohoto parametru. Vhodné, pokud chcete, aby se zprávy otevíraly v novém okně. target=_blank

Parametr	Význam	Příklad
serv	Kód služby, která vytváří požadovaný MonitorBOX. Kód služby zjistíte na stránce Vašeho profilu. Tento parametr je povinný.	serv=872
format	Určuje pořadí v jakém se jednotlivé údaje vyskytnou v generovaném HTML kódu. Hodnota parametru je libovolný řetězec, který by měl obsahovat níže uvedené kódy (včetně složených závorek): {T} - titulek odkazu uzavřený do značky (odkazuje se na daný článek) {D} - krátký popis (abstrakt) {P} - datum publikování {S} - název internetového zdroje, který publikoval článek uzavřený do značky (odkazuje se na homepage zdroje) V parametru se nemusí vyskytnout všechny kódy. Pokud chcete, aby řádek s odkazem obsahoval pouze název článku, můžete použít hodnotu {T}.Pokud mezi kódy uvedete nějaký text, bude kopírován do výstupního HTML bloku.	format={P}{T}{S}{D}
limit	Pokud chcete do HTML kódu zařadit méně odkazů než kolik je v boxu, použijte tento parametr a jako hodnotu uveďte celé kladné číslo (1-velikost boxu).	limit=5
cut	Omezí délku popisu na určitý počet znaků. Pokud je popis delší, odřízne jeho konec a doplní 3 tečky (...).	cut=150
target	Do odkazu na titulku zprávy přidá atribut target s hodnotou podle tohoto parametru. Vhodné, pokud chcete, aby se zprávy otevíraly v novém okně.	target=_blank

Výstup ze stránky exportbox-html.jsp vypadá přibližně takto:

<table border="0" class="mbtable">
<tr><td>
<a href="http://www.mynews.cz/clanek1.php">Klaus byl zvolen prezidentem</a>
<span class="mbabs">Dnes odpoledne byl novým prezidentem...</span>
<a href=" http://www.noviny.cz/dnes/1204.jsp?id=23">Další případ BSE</a>
<span class="mbabs">Na soukromé farmě blízko Prahy byl objeven... </span>
<a href=" http://www.idnes.cz/clanek.phtml?n=842">Ceny pozemků rostou</a>
<span class="mbabs">S blížícím se vstupem do EU se ceny... </span>
...
</td></tr>
</table>

Jak vidíte na uvedeném příkladu, výstup ze stránky exportbox-html.jsp neobsahuje žádné formátování, ale jednotlivé prvky výstupu jsou označeny třídami stylů CSS. Nadefinováním stylů obsažených ve výstupu můžete dosáhnout požadovaného vzhledu. Zde uvádíme příklad definice stylů:

<style>
	.mbtable td { background-color: transparent; }
	.mblink /* vzhled odkazu s názvem článku */
	{
		color: #666633;
		display: inline;
		font-size: 8pt;
	}
	.mbabstr /* vzhled popisu */
	{
		font-size: 7pt;
		margin-left: 16px;
	}
	.mbdate /* vzhled datumu */
	{
		font-size: 7pt;
		display: inline;
		color: #999966;
		margin-left: 16px;
	}
	.mbsrc /* vzhled odkazu na zdroj */
	{
		font-size: 7pt;
		margin-left: 16px;
	}
	.mbodd { border-bottom: 1px solid #BBBB88; } /* lichý řádek tabulky */
	.mbeven { border-bottom: 1px solid #BBBB88; } /* sudý řádek tabulky */
</style>

4. Přenášení pomocí RSS souboru

RSS je formát postavený nad XML. Pravděpodobně by pro Vás bylo zbytečně složité implementovat tento způsob načítání. Důvod, proč RSS podporujeme je ten, že existují hotové systémy pro publikování na Internetu (např. PHP Nuke), u kterých je použití RSS otázkou jednoduchého nastavení odkazu na data. Adresa odkazu je http://www.pravednes.cz/exportbox-rss.jsp a další parametry shrnuje následující tabulka:

Parametr Význam Příklad

serv Kód služby, která vytváří požadovaný MonitorBOX. Kód služby zjistíte na stránce Vašeho profilu. Tento parametr je povinný. serv=872

limit Pokud chcete stáhnout méně odkazů (řádků) než kolik je v boxu, použijte tento parametr a jako hodnotu uveďte celé kladné číslo (1-velikost boxu). limit=5

Parametr	Význam	Příklad
serv	Kód služby, která vytváří požadovaný MonitorBOX. Kód služby zjistíte na stránce Vašeho profilu. Tento parametr je povinný.	serv=872
limit	Pokud chcete stáhnout méně odkazů (řádků) než kolik je v boxu, použijte tento parametr a jako hodnotu uveďte celé kladné číslo (1-velikost boxu).	limit=5

Praktické informace pro způsob 2 a 3

Obsah exportních stránek nestahujte přímo v okamžiku, kdy chcete zobrazit data na Vaší stránce (tj. například přímo ve skriptu Vaší dynamické stránky). Zbytečně byste zatěžovali linku a v případě, že by bylo přerušeno spojení mezi Vaším serverem a naším (s tím se musí na Internetu počítat) mohla by se Vám na stránce objevit chybová hláška místo odkazů na články.

Doporučený způsob je stahování informací jednou za 1-4 hodiny (méně než 1 hodina nemá význam) zvláštním automatickým skriptem, který data převezme, naformátuje z nich HTML kód a ten uloží na lokální disk Vašeho serveru. Pokud používáte UNIX, můžete vložit záznam pro démona cron (viz. soubor /etc/crontab).

Náš vlastní server je na MonitorBOX napojen následujícím způsobem:

Server www.anneca.cz běží na FreeBSD, takže můžeme využít cron. V jeho definiční tabulce máme záznam, který spouští jednou za hodinu skript shellu.
Ve skriptu voláme program curl (součástí distribucí, ale lze použít i jiný, třeba wget), který umí stáhnout libovolnou HTML stránku v Internetu a uložit ji na disk. Jako parametr programu curl je předávána cesta na soubor, do kterého se má obsah stránky uložit a odkaz na stránku exportbox-html.jsp (viz. výše) s příslušnými parametry.
Ve stránce, která zobrazuje odkazy do Internetu jsou nadefinovány potřebné CSS styly a je tam příkaz pro include souboru do stránky. To se dá například zařídít pomocí SSI (Server Side Includes) příkazu:

Důležité: Pokud budete mít jakékoliv problémy, neváhejte nás kontaktovat na tel. čísle (047) 5602073 nebo emailu info@pravednes.cz a nebo můžete použít ICQ# 13248356.

Partneři: Dovolená CRM Systém Vyber si dům Architekt - projekty Poptávky Jižní Morava