Articles

WordPress.org

Více informací #Více informací

Zobrazí výpis aktuálního příspěvku po použití několika filtrů, včetně automatického formátování, které změní dvojité řádkové zlomy na odstavce HTML. Používá funkci get_the_excerpt(), která nejprve vygeneruje ořezanou verzi celého obsahu příspěvku, pokud pro něj neexistuje explicitní výtah.

Ořezaná verze obsahuje na konci značku ‚more‘, což je ve výchozím nastavení symbol nebo „hellip“. Uživatelem zadaný výňatek NENÍ ve výchozím nastavení opatřen takovým symbolem. Chcete-li jej přidat, musíte buď ručně upravit surový $post->post_excerpt ve své šabloně před voláním funkce the_excerpt(), přidat filtr pro ‚get_the_excerpt‘ s prioritou nižší než 10, nebo přidat filtr pro ‚wp_trim_excerpt‘ (porovnáním prvního a druhého parametru, protože uživatelem dodaný výpis se touto funkcí nijak nemění).

Pro více informací viz get_the_excerpt().

Automatický výpis bude mít také odstraněny všechny zkrácené kódy a značky. Je ořezán na hranici slov a jeho výchozí délka je 55 slov. U jazyků, ve kterých jsou (nebo mohou být) slova popsána jednotlivými znaky (tj. východoasijské jazyky), je slovní hranice skutečně znakem.

Poznámka: Pokud je aktuální příspěvek přílohou, například ve smyčkách šablon attachment.php a image.php, zobrazí se titulek přílohy. Popisky neobsahují text „“.

Srovnání s quicktagem <!-more-> #Srovnání s quicktagem <!-more->

Výpisky poskytují alternativu k použití quicktagu <!–more–>. Zatímco tento tag more vyžaduje, aby autor příspěvku ručně vytvořil „rozdělení“ obsahu příspěvku, které je pak použito pro vygenerování odkazu „číst více“ na indexových stránkách, výňatky vyžadují, ale nemusí nutně vyžadovat, aby autor příspěvku dodal „upoutávku“ na celý obsah příspěvku.

Výňatky <!–more–> quicktag vyžaduje, aby šablony používaly funkci the_content(), zatímco použití výňatků vyžaduje a umožňuje autorům šablon explicitně zvolit, zda se má zobrazit celý příspěvek (pomocí funkce the_content()), nebo výňatek (pomocí funkce the_excerpt()).

Volba, zda se má zobrazit celý příspěvek, nebo výňatek, pak může vycházet z faktorů, jako je použitá šablona, typ stránky, kategorie příspěvku atd. Jinými slovy, u <!–more–> quicktag rozhoduje o tom, co se stane, autor příspěvku, zatímco u výňatků má kontrolu autor šablony. Navíc, ačkoli <!–more–> lze použít k vytvoření skutečného rozdělení pomocí parametru $stripteaser, bylo by těžké a složité pak rozlišovat na základě vlastností, což by způsobilo, že by se z toho stala v podstatě volba pro celý web.