InPost Gallery

Serwer drukuje wyrażenie regularne zbudowane z zarejestrowanych kluczy shortcodów. Przy BeforeSetContent każde dopasowanie dostaje sc_id, jego oryginalny tekst trafia do mapy, a samo jest zastępowane obrazem zastępczym z ikoną shortcode'u i podsumowaniem atrybutów w tytule. Przy PostProcess symbole zastępcze są przywracane z mapy, więc zapisany wpis zawiera zwykłe shortcody i nic specyficznego dla edytora.

W trybie edycji get_shortcode_template() ustawia flagę shortcode_mode_edit, zachowuje tylko pierwszy zarejestrowany shortcode z przesłanego tekstu przez get_shortcode_regex() i uruchamia do_shortcode(). Handler shortcode'u wtyczki widzi flagę i zapisuje sparsowane atrybuty zamiast renderować HTML. Pola formularza odczytują potem swoje wartości domyślne przez set_default_value(), które je sanityzuje.

Pozwala to uniknąć drugiego parsera atrybutów: cudzysłowy, escapowanie i odstępy obsługuje ten sam kod, który renderuje shortcode na front-endzie.

changer() przechodzi przez każdy element formularza oznaczony data-shortcode-field. Podwójne cudzysłowy wewnątrz wartości są zamieniane na pojedyncze, by nie mogły zamknąć atrybutu. Pole o nazwie content staje się zawartością ujętą w shortcode. Powtarzalne pola oznaczone save_as_one są zbierane i łączone znakiem ^ w jeden atrybut, ponieważ atrybuty shortcode'u nie mogą przechowywać tablic.

TinyMCE 4 w WordPress 3.9 zastąpił handlery takie jak onBeforeSetContent.add() przez ed.on('BeforeSetContent'). Wtyczka trzyma stary build w js/wp38/, a nowy w js/ i wybiera między nimi zarówno dla skryptu administracyjnego, jak i dla zarejestrowanej wtyczki TinyMCE.

get_shortcodes_array() skanuje views/shortcodes/popups/ i rejestruje jeden shortcode na nazwę pliku. Każdy klucz ma szablon front-endu i szablon formularza edytora. get_shortcode_key_folder() zwraca folder tylko dla znanych kluczy, więc wywołujący AJAX nie mogą skierować include na inny plik, a get_shortcode_template() wraca do inpost_gallery dla nieznanych nazw.

get_image() przyjmuje alias rozmiaru, taki jak 200x150, i wywołuje resizer zaadaptowany z Aqua Resizer 1.1.7. Oblicza rozmiar docelowy przez image_resize_dimensions(), szuka istniejącego pliku name-WxH.ext obok oryginału i zwraca jego URL albo zmienia rozmiar i zapisuje go przy pierwszym żądaniu. Klasa ma zmienioną nazwę (Inpg_Aq_ResizePN) i jest opakowana w class_exists, by nie kolidowała z motywami dołączającymi oryginalną bibliotekę.

Wtyczka otwiera standardowe okno modalne mediów i tymczasowo podmienia window.send_to_editor. Wstawiony HTML jest parsowany w ukrytym buforze pod kątem celów linków lub źródeł obrazów. add_meta_slide_items() prosi o jeden wyrenderowany slajd naraz i uruchamia następne żądanie w callbacku, dzięki czemu slajdy zachowują kolejność zaznaczenia. Lista jest sortowalna i renumerowana po każdej zmianie.

inpost_gallery_data to tablica slajdów z imgurl, title i group (od 1 do max_thumb_groups, domyślnie 30). Szablony front-endu filtrują ją według grupy lub według listy pozycji liczonych od 1, rozdzielonej przecinkami, a random=N tasuje i zachowuje N slajdów (-1 tasuje wszystkie).

post_id zaczynający się od { jest traktowany jako wyrażenie. Nawiasy okrągłe stają się kwadratowymi, a pojedyncze cudzysłowy podwójnymi, po czym json_decode() je parsuje. takebyid bierze bloki post:count:first|last|rand z wymienionych wpisów. take wybiera N najnowszych opublikowanych wpisów danego typu; kierunek sortowania jest ograniczony do ASC lub DESC, a typ wpisu i limit są wiązane przez prepare().

draw_html() kopiuje atrybuty z show_in_popup ustawionym na 0 do klucza attributes, po czym włącza flagę dla okładki. Szablon okładki drukuje migawkę jako JSON w base64. front.js wysyła ją razem z kluczem shortcode'u, a get_gallery_by_shortcode() ją dekoduje, ponownie wymusza show_in_popup na 0, by odpowiedzią zawsze była galeria, a nigdy kolejna okładka, i renderuje ten sam szablon. Flaga po stronie klienta blokuje podwójne kliknięcia, gdy żądanie trwa.

get_gallery_by_shortcode() jest zarejestrowany dla anonimowych użytkowników i dostaje klucz shortcode'u od klienta. Dołącza szablon tylko wtedy, gdy get_shortcode_key_folder() znajdzie klucz wśród shortcodów wykrytych przy init; każda inna wartość nie renderuje niczego.

Kolejkowanie skryptów i stylów znajduje się na górze każdego szablonu shortcode'u, więc strona ładuje tylko biblioteki galerii, które faktycznie pokazuje, drukowane w stopce. Każda instancja dostaje ID kontenera z uniqid(), dzięki czemu kilka galerii, także na różnych skryptach, może działać na jednej stronie.