Zobrazení citátu

Zobrazte si na vašich stránkách Citát

 

Křesťanský internetový portál www.pastorace.cz nabízí na svých stránkách citát k zamyšlení, vybraný z křesťanských knih.

O co jde?

Vložením krátkého kódu do vašich farních či osobních stránek si můžete nechat zobrazovat krátký citát se jménem autora a knihy, odkud citát pochází. Tento citát se automaticky aktualizuje. Můžete tak obohatit obsah svých webových stránek, aniž byste se museli starat o jeho aktualizaci.

Pro koho je služba určena?

Tato služba je určena především pro webmastery farních stránek a pro všechny, kdo spravují či provozují stránky s křesťanskou tématikou.

Jaké jsou podmínky využívání této služby?

Službu můžete využívat zdarma v libovolném rozsahu. Jediná podmínka je ta, že nezakážete zobrazení žádného prvku vygenerovaného kódu.

Je potřeba nějaká aktivace?

Není. Službu můžete začít využívat ihned. Budeme však rádi, když nám dáte vědět na adresu spravce@vira.cz, že tuto službu využíváte.

Co je k tomu potřeba?

Server, na kterém provozujete své stránky, musí podporovat vkládání skriptů na straně serveru. To znamená, že musí umět zpracovávat skriptovací jazyk, jako je např. PHP, ASP, JSP apod., což v současné době většina serverů umožňuje. Následující příklady budou v jazyce PHP, ale pokud používáte jiný jazyk, výsledek bude stejný, pouze použijete jinou syntaxi jazyka.

Dále je potřeba, aby soubor, do kterého budete vkládat krátký skript, měl příponu .php (případně.asp, .jsp apod.,) nikoliv .htm či .html (i když i to lze na serveru nastavit).

Jak to funguje?

1. Otevřete v textovém editoru stránku, do které chcete vkládat téma týdne (např. index.php) tak, abyste mohli editovat zdrojový kód stránky.

2. Vložte následující kód do místa, kam chcete náš text vkládat:
   <?php
readfile('http://www.pastorace.cz/denni-citat.php');
?>

   Případně pokud váš server podporuje ASP: 
   <!-- #include file="http://www.pastorace.cz/denni-citat.php" -->
   (Tuto možnost jsme netestovali. Budeme rádi, pokud nám dáte vědět, zda to funguje.)

3. Uložte soubor na server.

4. Po načtení stránky v prohlížeči se místo výše zmíněného skriptu ve zdrojovém kódu stránky objeví následující vygenerovaný kód:

   <div id="denni_citat"> <p id="denni_citat_nadpis"><b>Pavel byl nepohodlný,</b></p> <p id="denni_citat_podnadpis"><i>protože byl mužem pravdy.</i></p> <div id="denni_citat_text"> <p style="text-align: right">Se svolením převzato z knihy: <br /> J. Ratzinger, Boží světlo v naší době,<br /> kterou vydalo nakladatelství <a target="_blank" href="http://www.paulinky.cz">Paulínky</a>.</p></div><p id="denni_citat_pata" align="right"><a href="http://www.pastorace.cz/" title="Tuto službu poskytuje www.pastorace.cz">www.pastorace.cz</a></p> </div>
   
    V prohlížeči by měl výše uvedený kód vypadat zhruba takto:
   
   

Tipy pro pokročilé

 

1. Je vygenerovaný kód validní?

   Ano, kód je validní i pro nejpřísnější režim zobrazení XHTML 1.0 Strict.

2. Co mám dělat, když se mi špatně zobrazuje kódování češtiny?

   Protože většina českých stránek v současné době používá kódování windows-1250, nastavili jsme ho jako výchozí. Služba však podporuje ještě další dva druhy kódování:

   • utf-8: použijte kód
     <?php
readfile('http://www.pastorace.cz/denni-citat.php?utf-8');
?>

   • iso-8859-2: použijte kód
     <?php
readfile('http://www.pastorace.cz/denni-citat.php?iso-8859-2');
?>

   Pokud na svých stránkách používáte ještě jiné kódování a rádi byste tuto službu zprovoznili, dejte nám vědět.

3. Jak můžu změnit vzhled vygenerovaného textu?

   • Můžete použít námi předdefinovanou šablonu kaskádových stylů, a to tak, že do hlavičky stránky, nejlépe těsně před značku </head> vložíte následující kód:

     <div id="denni_citat"> <p id="denni_citat_nadpis"><b>Pavel byl nepohodlný,</b></p> <p id="denni_citat_podnadpis"><i>protože byl mužem pravdy.</i></p> <div id="denni_citat_text"><p style="text-align: right">Se svolením převzato z knihy: <br /> J. Ratzinger, Boží světlo v naší době,<br /> kterou vydalo nakladatelství <a target="_blank" href="http://www.paulinky.cz">Paulínky</a>.</p></div> <p id="denni_citat_pata" align="right"><a href="http://www.pastorace.cz/" title="Tuto službu poskytuje www.pastorace.cz">www.pastorace.cz</a></p> </div>

      

     Tím se do prohlížeče načte následující kód (tento kód nevkládejte, je tu pouze pro ukázku):

     #denni_citat {margin: 0;padding: 0;line-height: 1.3em;font-family: 'Verdana CE', Verdana, 'Arial CE', Arial, 'Lucida Grande CE', 'Helvetica CE', lucida, sans-serif;font-size: 13px;width: 250px;} #denni_citat-na-dnesni-den{font-weight: bold;} #denni_citat-text{font-style: normal;} #denni_citat-citace{font-style: italic;} a#denni_citat-odkaz:link, a#denni_citat-odkaz:visited{text-decoration: underline;} a#denni_citat-odkaz:hover{text-decoration: none;} a#denni_citat-odkaz:active, a#denni_citat-odkaz:focus{text-decoration: underline;} body.black{background-color: #000;color: #fff;} body.black a{color: #99f;}

      

     Pokud ovládáte jazyk kaskádových stylů (CSS), můžete si napsat vlastní styly. Použité identifikátory můžete vidět ve výše uvedeném příkladu zdrojového kódu.

4. Je vkládání vašeho skriptu bezpečné?

   Celý skript se spouští na serveru www.pastorace.cz a vašemu serveru je odeslán vygenerovaný kód HTML se čtením z dnešního dne. Váš server pouze vloží přijatý kód do příslušného místa vytvářené stránky, ale dále ho už nezpracovává a zachází s ním jako s textovým souborem, i kdyby obsahoval nějaký skript v PHP.

   Pokud tedy při vkládání použijete funkci readfile(), nehrozí vám žádné nebezpečí ve formě tajně spouštěných skriptů na vašem serveru (které bychom ovšem do našeho kódu museli případně vložit my).

5. Co mám dělat, když můj server nepodporuje skriptovací jazyk? (doplněno)

   Na základě podnětů našich uživatelů jsme rozšířili tuto službu o možnost vložení denního citátu i pomocí prvku <iframe>. Tuto možnost sice nedoporučujeme, ale je vhodná jako dočasné řešení.

   Místo výše uvedeného kódu v jazyce PHP vložte do vašich stránek následující kód HTML:

   <iframe src="http://www.pastorace.cz/denni-citat-html.php" width="260" height="260"
  title="Denní citát z www.pastorace.cz"
  longdesc="http://www.pastorace.cz/Servis/Sluzby-pro-webmastery/Zobrazeni-denniho-citatu/"
  frameborder="0" scrolling="no"><a href="http://www.pastorace.cz/denni-citat-html.php">Citát z www.pastorace.cz</a></iframe>

   Výsledek by měl vypadat zhruba takto:
   
   
   
   
   Proč tuto možnost nedoporučujeme? Je to proto, že prvek <iframe> už není součástí standardu XHTML 1.0 Strict, a tedy v budoucnosti přestane být v prohlížečích podporován. Pokud je vaše stránka v módu XHTML 1.0 Strict, pak s použitím prvku <iframe> nebude validní, a tedy nebudete mít záruku, že bude v budoucnosti čitelná.
   
   Upozornění: Délka citátu může být každý den jiná, proto je potřeba počítat s tím, že bude text potřebovat v některé dny více prostoru (prvek IFRAME se nemůže na stránce roztáhnout, ponechte tedy v jeho rozměrech dostatečnou rezervu; pokud se obsah do prvku nevejde, zobrazí se uvnitř prvku posuvníky).

6. Když použiju <iframe>, jak můžu změnit pozadí rámce?

   Na základě podnětů našich uživatelů jsme doplnili možnost změnit pozadí stránky v rámci <iframe>. Standardně se vygeneruje rámec s výchozím (bílým) pozadím. Pokud na svých stránkách máte černé pozadí a bílý rámec by příliš vyčníval, můžete si nechat vygenerovat rámec s jinou barvou. Zatím je k dispozici bílý text na černém pozadí. Požadavek na takovouto úpravu zadáte přidáním parametru ?bg=1 do URL adresy rámce:

   <iframe src="http://www.pastorace.cz/denni-citat-html.php?bg=1" ...

   Zbylý kód se nemění, resp. další URL adresy, které se v kódu vyskytují, není potřeba měnit.
   
   Výsledek by měl vypadat zhruba takto:
   
   

Související služby

Viz také:

• Zobrazení biblického citátu
• Zobrazení tématu týdne
• Zobrazení dnešního čtení

 

Podpora

V případě jakýchkoliv problémů či nejasností si pozorně přečtěte tyto instrukce. Pokud nenajdete odpověď, kontaktujte nás na adrese spravce@vira.cz. Odpovíme vám během několika pracovních dnů.