InPost Gallery

Il server stampa una regex costruita sulle chiavi degli shortcode registrati. Su BeforeSetContent ogni corrispondenza riceve un sc_id, il suo testo originale va in una mappa e viene sostituita da un'immagine segnaposto con l'icona dello shortcode e un riepilogo degli attributi nel titolo. Su PostProcess i segnaposto vengono ripristinati dalla mappa, quindi il post salvato contiene shortcode semplici e nulla di specifico dell'editor.

In modalità di modifica get_shortcode_template() imposta un flag shortcode_mode_edit, mantiene solo il primo shortcode registrato dal testo inviato tramite get_shortcode_regex() ed esegue do_shortcode(). Il gestore dello shortcode del plugin vede il flag e memorizza gli attributi analizzati invece di generare HTML. I campi del modulo leggono poi i loro valori predefiniti tramite set_default_value(), che li sanifica.

Questo evita un secondo parser di attributi: virgolette, escape e spaziatura sono gestiti dallo stesso codice che genera lo shortcode sul front end.

changer() percorre ogni elemento del modulo contrassegnato con data-shortcode-field. Le virgolette doppie nei valori vengono sostituite con apici singoli in modo che non possano chiudere l'attributo. Un campo chiamato content diventa il contenuto racchiuso. I campi ripetuti contrassegnati save_as_one vengono raccolti e uniti con ^ in un unico attributo, poiché gli attributi degli shortcode non possono contenere array.

TinyMCE 4 in WordPress 3.9 ha sostituito gestori come onBeforeSetContent.add() con ed.on('BeforeSetContent'). Il plugin conserva la vecchia build in js/wp38/ e la nuova in js/, e sceglie tra le due sia per lo script di amministrazione sia per il plugin TinyMCE registrato.

get_shortcodes_array() analizza views/shortcodes/popups/ e registra uno shortcode per ogni nome di file. Ogni chiave ha un template front end e un template del modulo per l'editor. get_shortcode_key_folder() restituisce la cartella solo per le chiavi note, quindi i chiamanti AJAX non possono puntare l'include a un altro file, e get_shortcode_template() ripiega su inpost_gallery per i nomi sconosciuti.

get_image() accetta un alias di dimensione come 200x150 e chiama un ridimensionatore adattato da Aqua Resizer 1.1.7. Calcola la dimensione di destinazione con image_resize_dimensions(), cerca un file name-WxH.ext esistente accanto all'originale e ne restituisce l'URL, oppure lo ridimensiona e lo salva alla prima richiesta. La classe è rinominata (Inpg_Aq_ResizePN) e avvolta in class_exists in modo che non possa entrare in conflitto con i temi che includono la libreria originale.

Il plugin apre il modale dei media standard e sostituisce temporaneamente window.send_to_editor. L'HTML inserito viene analizzato in un buffer nascosto per cercare destinazioni di link o sorgenti di immagini. add_meta_slide_items() richiede una slide generata alla volta e avvia la richiesta successiva nella callback, così le slide mantengono l'ordine della selezione. L'elenco è ordinabile e rinumerato dopo ogni modifica.

inpost_gallery_data è un array di slide con imgurl, title e group (da 1 a max_thumb_groups, 30 per impostazione predefinita). I template front end lo filtrano per gruppo, o per un elenco di posizioni in base 1 separate da virgola, e random=N mescola e mantiene N slide (-1 le mescola tutte).

Un post_id che inizia con { viene trattato come espressione. Le parentesi diventano parentesi quadre e gli apici singoli diventano virgolette doppie, poi json_decode() la analizza. takebyid prende blocchi post:count:first|last|rand dai post elencati. take seleziona gli N ultimi post pubblicati di un post type; la direzione di ordinamento è limitata a ASC o DESC e il post type e il limite sono associati con prepare().

draw_html() copia gli attributi con show_in_popup impostato a 0 in una chiave attributes, poi attiva il flag per la copertina. Il template della copertina stampa l'istantanea come JSON in base64. front.js la invia con la chiave dello shortcode, e get_gallery_by_shortcode() la decodifica, forza di nuovo show_in_popup a 0 in modo che la risposta sia sempre la galleria e mai un'altra copertina, e genera lo stesso template. Un flag sul client blocca i doppi clic mentre la richiesta è in corso.

get_gallery_by_shortcode() è registrato per gli utenti anonimi e riceve la chiave dello shortcode dal client. Include un template solo quando get_shortcode_key_folder() trova la chiave tra gli shortcode individuati all'init; qualsiasi altro valore non genera nulla.

Gli accodamenti di script e stili si trovano in cima a ogni template di shortcode, così una pagina carica solo le librerie delle gallerie che mostra davvero, stampate nel footer. Ogni istanza riceve un ID di contenitore uniqid(), quindi più gallerie, comprese quelle con script diversi, possono girare nella stessa pagina.