Rajce embed

Description

For English, see below.

Czech: Tento plug-in umo?ňuje snadno vlo?it obrázky nebo celá alba hostovaná na (v ?esku) populárním serveru rajce.net (rajce.idnes.cz) do va?ich p?íspěvk? ve WordPressu. Vlo?ená galerie pak vypadá jako nativní galerie WordPressu, pou?ívá stejny vizuální styl.

Vkládání obrázk? nebo celych alb se provádí stejně jako standardní oEmbed vkládání: vlo?te jako samostatny odstavec ve va?em p?íspěvku URL adresu obrázku nebo celého alba hostovaného na rajce.net. P?i zobrazení se pak namísto této adresy objeví p?íslu?ny obrázek nebo celé album. Podívejte se do sekce FAQ pro více detail?.

Upozornění: vzhled galerie (jak je zobrazena) je ur?en ?ablonou, kterou va?e konkrétní instalace WordPressu pou?ívá. Podívejte se do sekce FAQ pro více detail?.

Tento plugin pro vkládání alb z rajce.net spolupracuje s jinym mym pluginem Gallery Slice pro zobrazování náhledu alba na domovské stránce a archivech, doporu?uji vyzkou?et.

English: rajce.net is a popular Czech image hosting and sharing web service. This plug-in serves for embedding of images or whole albums hosted on rajce.net into WordPress posts.

License

WTFPL License 2.0 applies

           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
                   Version 2, December 2004

Copyright (C) 2004 Sam Hocevar <[email protected]>

Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.

           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
  TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

 0. You just DO WHAT THE FUCK YOU WANT TO.

Screenshots

Installation

1. Nahrajte tento plugin do adresá?e wp-content/plugins
2. Aktivujte plugin Rajce embed ve správě plugin?
3. Pro zobrazení obrázku nebo alba, vlo?te jeho URL adresu jako samostatny odstavec v p?íspěvku.

FAQ

Základní pou?ívání pluginu funguje tak, ?e vlo?íte do p?íspěvku jako samostatny odstavec URL adresu obrázku nebo celého alba a p?i zobrazení se pak zobrazí tento obrázek nebo celé album. Nap?íklad

https://ukazka.rajce.net/Brno_v_noci_-_ukazka_velkeho_rozliseni

zobrazí celou galerii ulo?enou na této adrese. Naproti tomu

https://ukazka.rajce.net/Brno_v_noci_-_ukazka_velkeho_rozliseni#DSC_2804.jpg

vlo?í do p?íspěvku jeden obrázek z této galerie.

Zobrazení vlo?eného obrázku je jednoduché — pokud je obrázek vět?í ne? ?írka obsahu (p?íspěvku), pak se obrázek “zmá?kne” na tuto ?í?ku, p?i kliknutí na něj se zobrazí v plné velikosti. Pokud na webu pou?íváte některy z mnoha r?znych LightBox?, měl by se automaticky ten vyu?ít pro zobrazení plné velikosti.

Slo?itěj?í je to se zobrazením galerie: vlo?ené album je toti? naformátováno stejně jako vychozí galerie WordPressu, měl by se tedy na něj aplikovat styl, ktery pou?ívá vámi pou?ívaná ?ablona. To je záměr — album vlo?ené z Raj?ete má vypadat stejně jako ostatní alba ve va?em WordPressu. Jen?e ono to není a? tak úplně jednoduché. Vysledek jsem vyzkou?el na ?esti vychozích ?ablonách WordPressu twentyten a? twentyfifteen, zde jsou vysledky (vezměme to odzadu, tedy od nejnověj?í ?ablony twentyfifteen):

• twentyfifteen — v?e funguje nejlépe, jak je mo?né; náhledy na obrázky jsou zobrazeny ve velikosti, jakou máte zadánu v Nastavení → Média → Velikost náhledu; pokud máte zapnutu volbu O?íznout náhled podle p?esnych rozměr?, pak je náhled naformátován tak, ?e zabere celou tuto velikost (obrázek není deformován, proporce jsou zachovány, ale to, co se nevejde, je o?íznuto).
• twentyfourteen — situace je stejná jako u twentyfifteen, v?e funguje tak, jak má
• twentythirteen — situace je stejná jako u twentyfifteen, v?e funguje tak, jak má
• twentytwelve — ?ablona pou?ívá star?í verzi HTML kódu pro zobrazování galerie, proto není podporována varianta, aby v p?ípadě zapnuté volby Nastavení → Média → O?íznout náhled podle p?esnych rozměr? obrázky zabíraly celou velikost nastavení pro náhledy. Jinak se galerie zobrazuje v po?ádku
• twentyeleven — zatímco p?i zobrazení samostatného p?íspěvku je galerie zobrazena v po?ádku (by? tak jako v ?abloně twentytwelve), p?i zobrazení homepage nebo archivu, pokud je formát p?íspěveku nastaven na “Galerie”, pak se vlo?ená galerie v?bec neuká?e. Pokud je ov?em ponechán vychozí formát “Standard”, galerie je zobrazena i na homepage a archivech. Je to z toho d?vodu, ?e ?ablona pou?ívá pro zobrazení formátu “Galerie” na homepagi a v archivech sv?j vlastní specificky kód, ktery o galeriích vkládanych z raj?ete nic neví (a ani tento specificky kód galerie nelze napíchnout vlastním hookem, abych to o?et?il). Aby galerie byla zobrazována i zde, bylo by zapot?ebí upravit ?ablonu
• twentyten — situace úplně stejná jako u ?ablony twentyeleven

Jak vidíte, zobrazování galerie je velmi závislé na pou?ité ?abloně. Bohu?el to je něco, co nelze obecně v pluginu o?et?it. Pokud se galerie vkládané tímto pluginem nezobrazují na va?em webu dle va?ich p?edstav, je zapot?ebí upravit vámi pou?ívanou ?ablonu. Prosím, ne?ádejte mě, abych vám já upravoval va?e ?ablony, na to nemám prostor. Jen několik rad pro toho, kdo to bude dělat (a? u? vy osobně nebo někdo, kdo vám s va?ím webem pomáhá): nejprve doporu?uji doplnit do va?í ?ablony podporu pro html5 galerie (inspirujte se prosím v ?abloně twentyfourteen; bude zapot?ebí aktualizovat va?e CSS soubory); dále je mo?né zobrazování galerií vytvá?enych tímto pluginem stylizovat skrz t?ídu .gallery-embed-rajce, kterou div obalující galerii obsahuje navíc ke v?em standardním t?ídám pro galerie.

Vkládání tímto pluginem podporuje také standardní atributy (pro galerie i obrázky), nap?íklad u galerií po?et sloupc? (standardní po?et sloupc? je 3). Pokud pot?ebujete toto vyu?ít, pak je zapot?ebí vlo?ení obalit shortcodem embed a do něj uvést p?íslu?né atributy. Nap?íklad:

[embed columns="4"]https://ukazka.rajce.net/Brno_v_noci_-_ukazka_velkeho_rozliseni[/embed]

Stejnym zp?sobem je mo?né pou?ívat atributy podporované mym pluginem Gallery Slice, budou se aplikovat i na galerie vkládané tímto pluginem.

Vlo?ené obrázky i galerie mohou také zobrazovat popisky fotek z rajce.net. Tato volba je ve vychozím stavu vypnutá, zapnout je mo?né ji bu? v Nastavení → Média, nebo individuálně v ka?dém vlo?eném objektu, pou?itím atributu v shortcodu embed. Pro obrázek je pou?it atribut caption, pro galerii je pou?it atribut captions (mno?né ?íslo). Ten m??e nabyvat následujících hodnot:

• bu? bez hodnoty nebo caption=”on” — zapne zobrazování popisku(?) pro tento vlo?eny objekt; jako popisek je pou?it název fotky z rajce.net, pokud není vyplněny, pak popis fotky z rajce.net, pokud není vyplněny, pak jméno souboru s fotkou
• caption=”off” — vypne zobrazování popisku(?) pro tento vlo?eny objekt a to i v takovém p?ípadě, kdy je zobrazování popisk? zapnuto v Nastavení → Média
• caption=”name” — zapne zobrazování popisku(?) pro tento vlo?eny objekt; jako popisek je pou?it název fotky z rajce.net, pokud není vyplněn, pak se nezobrazí ?ádny popisek.
• caption=”desc” — zapne zobrazování popisku(?) pro tento vlo?eny objekt; jako popisek je pou?it popis fotky z rajce.net, pokud není vyplněn, pak se nezobrazí ?ádny popisek.
• caption=”vlastní text” — zapne zobrazování popisku pro tento vlo?eny objekt; jako popisek je pou?it vlastní text z tohoto atributu. Tato volba funguje pouze pro vkládané obrázky, nefunguje pro vkládané galerie

P?íklad:

[embed captions]https://ukazka.rajce.net/Brno_v_noci_-_ukazka_velkeho_rozliseni[/embed]

Popisky jsou zobrazeny tak, jak je zobrazuje ?ablona, kterou pou?íváte na Va?í instalaci WordPressu.

Vkládání galerie také umo?ňuje vypustit obrázek, ktery je zvoleny jako náhled (hlavní obrázek) celého alba. Toto je mo?né bu? nastavit globálně v Nastavení → Média, pak to je platné ve v?ech vkládanych galerií z Raj?ete; p?ípadně, pokud je mo?nost globálně vypnutá, lze to specifikovat atributem omitalbumcover u jednotlivych galerií, pro které to chcete pou?ít.

P?íklad:

[embed omitalbumcover]https://ukazka.rajce.net/Brno_v_noci_-_ukazka_velkeho_rozliseni[/embed]

P?i vlo?ení galerie plugin vkládá do kódu je?tě mini-náhled (jeden obrázek reprezentující celou galerii, popis, po?et fotek, rozbalení na plnou galerii). Tento mini-náhled je standardně skryty a v?bec se nezobrazuje. Pokro?ilí tv?rci ?ablon/web? ho mohou vyu?ít nap?íklad p?i tvorbě responsivních web?, mobilních verzí nebo vkládání galerie do chatu. Pro jeho vyu?ití pou?ijte detailněj?í specifikaci CSS selectoru ne? je vychozí, div s mini-náhledem pou?ívá t?ídu gallery-embed-rajce-mini-preview. Pokud dáte div.gallery-embed-rajce-mini-preview display: block, umístí se popisky zarovnané nahoru k obrázku, pokud pou?ijete display: table, umístí se popisky vertikálně vycentrované.

Plugin Rajce embed nabízí také zpětnou kompatibilitu se star?ím pluginem Raj?e WP, to znamená, ?e pokud jste dosavad pou?ívali plugin Raj?e WP, m??ete ho nahradit pluginem Rajce embed a plugin Raj?e WP deaktivovat. Nicméně, aby zpětná kompatibilita fungovala, musíte je?tě aktivovat maly plugin Zpětná kompatibilita Rajce embed s WP Raj?e, ktery je sou?ástí tohoto pluginu. Tato zpětná kompatibilita je oddělena do samostatného pluginu, aby nezatě?ovala u?ivatele, kte?í ji nevyu?ijí (nezatě?ováním mám na mysli zpracovávání p?íspěvku na straně serveru).

Pokud jste tedy dosavad pou?ívali plugin WP Raj?e, deaktivujte ho a aktivujte pluginy Rajce embed a Zpětná kompatibilita Rajce embed s WP Raj?e — poté se Va?e star?í p?íspěvky s vlo?enymi galeriemi pomocí pluginu WP Raj?e budou nyní zobrazovat i s tímto novym pluginem.

Reviews

Contributors & Developers

Changelog

1.5.1

• fix — wrong variable name

1.5

• enhancement — gallery thumbnails can use the full source pictures, for higher quality
• fix — error in omitting album cover

1.4

• enhancement — possibility to omit album cover image from the displayed gallery
• fix — default values for custom thumbnail size

1.3

• enhancement — new option to specify custom thumbnail size

1.2.2

• fix — rajce html source now may ommit tag with id “albumCategories”

1.2.1

• improved compatibility with TwentyFifteen theme (WordPress 4.1); one universal css to cover twentythirteen, twentyfourteen and twentyfifteen
• better css styling of gallery (gallery was not on exact center in content)
• bugfix: if embedding single picture, which is also thumbnail of whole album, it did not work

1.2

• compatibility with TwentyFifteen theme (WordPress 4.1)

1.1.1

• embed handler registered even in admin mode, necessary for use via ajax (standard WordPress ajax is running with is_admin() == true, even on frontend)

1.1

• Bug-fixes and warning-fixes

1.0

• Initial release