InPost Gallery

Der Server gibt einen regulären Ausdruck aus, der aus den registrierten Shortcode-Schlüsseln gebaut ist. Bei BeforeSetContent erhält jeder Treffer eine sc_id, sein Originaltext kommt in eine Map, und er wird durch einen Bildplatzhalter mit dem Icon des Shortcodes und einer Attributzusammenfassung im Titel ersetzt. Bei PostProcess werden die Platzhalter aus der Map zurückersetzt, sodass der gespeicherte Beitrag reine Shortcodes enthält und nichts Editor-Spezifisches.

Im Bearbeitungsmodus setzt get_shortcode_template() ein Flag shortcode_mode_edit, behält über get_shortcode_regex() nur den ersten registrierten Shortcode aus dem gesendeten Text und führt do_shortcode() aus. Der Shortcode-Handler des Plugins sieht das Flag und speichert die geparsten Attribute, statt HTML zu rendern. Die Formularfelder lesen ihre Vorgaben dann über set_default_value(), das sie bereinigt.

Das vermeidet einen zweiten Attribut-Parser: Anführungszeichen, Escaping und Leerraum werden vom selben Code behandelt, der den Shortcode im Frontend rendert.

changer() geht jedes mit data-shortcode-field markierte Formularelement durch. Doppelte Anführungszeichen in Werten werden durch einfache ersetzt, damit sie das Attribut nicht schließen können. Ein Feld namens content wird zum eingeschlossenen Inhalt. Wiederholte Felder, die mit save_as_one markiert sind, werden gesammelt und mit ^ zu einem Attribut verbunden, da Shortcode-Attribute keine Arrays aufnehmen können.

TinyMCE 4 in WordPress 3.9 ersetzte Handler wie onBeforeSetContent.add() durch ed.on('BeforeSetContent'). Das Plugin behält den alten Build in js/wp38/ und den neuen in js/ und wählt zwischen ihnen sowohl für das Admin-Skript als auch für das registrierte TinyMCE-Plugin.

get_shortcodes_array() durchsucht views/shortcodes/popups/ und registriert pro Dateiname einen Shortcode. Jeder Schlüssel hat ein Frontend-Template und ein Template für das Editor-Formular. get_shortcode_key_folder() gibt den Ordner nur für bekannte Schlüssel zurück, sodass AJAX-Aufrufer das Include nicht auf eine andere Datei richten können, und get_shortcode_template() weicht bei unbekannten Namen auf inpost_gallery aus.

get_image() nimmt einen Größen-Alias wie 200x150 und ruft einen aus Aqua Resizer 1.1.7 angepassten Resizer auf. Er berechnet die Zielgröße mit image_resize_dimensions(), sucht neben dem Original nach einer vorhandenen Datei name-WxH.ext und gibt deren URL zurück oder skaliert und speichert sie bei der ersten Anfrage. Die Klasse ist umbenannt (Inpg_Aq_ResizePN) und in class_exists gekapselt, damit sie nicht mit Themes kollidiert, die die Originalbibliothek mitliefern.

Das Plugin öffnet das Standard-Medien-Modal und ersetzt vorübergehend window.send_to_editor. Das eingefügte HTML wird in einem verborgenen Puffer auf Link-Ziele oder Bildquellen geparst. add_meta_slide_items() fordert jeweils einen gerenderten Slide an und startet die nächste Anfrage im Callback, sodass die Slides die Reihenfolge der Auswahl behalten. Die Liste ist sortierbar und wird nach jeder Änderung neu nummeriert.

inpost_gallery_data ist ein Array von Slides mit imgurl, title und group (1 bis max_thumb_groups, standardmäßig 30). Die Frontend-Templates filtern es nach Gruppe oder nach einer kommagetrennten Liste von Positionen (ab 1), und random=N mischt und behält N Slides (-1 mischt alle).

Eine post_id, die mit { beginnt, wird als Ausdruck behandelt. Runde Klammern werden zu eckigen und einfache Anführungszeichen zu doppelten, dann parst json_decode() ihn. takebyid nimmt Blöcke der Form post:count:first|last|rand aus aufgelisteten Beiträgen. take wählt die N neuesten veröffentlichten Beiträge eines Post Types; die Sortierrichtung ist auf ASC oder DESC beschränkt, und der Post Type und das Limit werden mit prepare() gebunden.

draw_html() kopiert die Attribute mit show_in_popup auf 0 in einen Schlüssel attributes und schaltet dann das Flag für das Titelbild ein. Das Titelbild-Template gibt den Snapshot als Base64-JSON aus. front.js sendet ihn mit dem Shortcode-Schlüssel per POST, und get_gallery_by_shortcode() dekodiert ihn, setzt show_in_popup erneut auf 0, damit die Antwort immer die Galerie und nie ein weiteres Titelbild ist, und rendert dasselbe Template. Ein Flag auf dem Client blockiert Doppelklicks, solange die Anfrage läuft.

get_gallery_by_shortcode() ist für anonyme Nutzer registriert und erhält den Shortcode-Schlüssel vom Client. Es bindet ein Template nur ein, wenn get_shortcode_key_folder() den Schlüssel unter den beim init erkannten Shortcodes findet; jeder andere Wert rendert nichts.

Die Einreihung von Skripten und Styles steht am Anfang jedes Shortcode-Templates, sodass eine Seite nur die Bibliotheken der Galerien lädt, die sie tatsächlich zeigt, ausgegeben im Footer. Jede Instanz erhält eine uniqid()-Container-ID, sodass mehrere Galerien, auch solche mit unterschiedlichen Skripten, auf einer Seite laufen können.