InPost Gallery

Le serveur imprime une regex construite à partir des clés de shortcodes enregistrées. Sur BeforeSetContent, chaque correspondance reçoit un sc_id, son texte d'origine va dans une table, et elle est remplacée par une image d'espace réservé avec l'icône du shortcode et un résumé des attributs dans le title. Sur PostProcess, les espaces réservés sont remplacés à partir de la table, de sorte que l'article enregistré contient des shortcodes ordinaires et rien de spécifique à l'éditeur.

En mode édition, get_shortcode_template() définit un drapeau shortcode_mode_edit, ne garde que le premier shortcode enregistré du texte posté via get_shortcode_regex(), et exécute do_shortcode(). Le gestionnaire de shortcode de l'extension voit le drapeau et stocke les attributs analysés au lieu de produire du HTML. Les champs du formulaire lisent ensuite leurs valeurs par défaut via set_default_value(), qui les assainit.

Cela évite un second analyseur d'attributs : les guillemets, l'échappement et les espaces sont gérés par le même code qui restitue le shortcode côté front-end.

changer() parcourt chaque élément de formulaire marqué avec data-shortcode-field. Les guillemets doubles à l'intérieur des valeurs sont remplacés par des guillemets simples pour qu'ils ne puissent pas fermer l'attribut. Un champ nommé content devient le contenu encadré. Les champs répétés marqués save_as_one sont collectés et joints avec ^ en un seul attribut, puisque les attributs de shortcode ne peuvent pas contenir de tableaux.

TinyMCE 4 dans WordPress 3.9 a remplacé les gestionnaires comme onBeforeSetContent.add() par ed.on('BeforeSetContent'). L'extension garde l'ancienne build dans js/wp38/ et la nouvelle dans js/, et choisit entre elles à la fois pour le script d'administration et pour le plugin TinyMCE enregistré.

get_shortcodes_array() analyse views/shortcodes/popups/ et enregistre un shortcode par nom de fichier. Chaque clé a un modèle front et un modèle de formulaire d'éditeur. get_shortcode_key_folder() ne retourne le dossier que pour les clés connues, de sorte que les appelants AJAX ne peuvent pas orienter l'include vers un autre fichier, et get_shortcode_template() se rabat sur inpost_gallery pour les noms inconnus.

get_image() prend un alias de taille comme 200x150 et appelle un redimensionneur adapté d'Aqua Resizer 1.1.7. Il calcule la taille cible avec image_resize_dimensions(), cherche un fichier nom-LxH.ext existant à côté de l'original et retourne son URL, ou redimensionne et l'enregistre à la première requête. La classe est renommée (Inpg_Aq_ResizePN) et enveloppée dans class_exists pour ne pas entrer en conflit avec les thèmes qui embarquent la bibliothèque d'origine.

L'extension ouvre la fenêtre modale standard des médias et remplace temporairement window.send_to_editor. Le HTML inséré est analysé dans un tampon masqué pour y trouver les cibles de liens ou les sources d'images. add_meta_slide_items() demande une diapositive rendue à la fois et lance la requête suivante dans le callback, de sorte que les diapositives gardent l'ordre de la sélection. La liste est triable et renumérotée après chaque changement.

inpost_gallery_data est un tableau de diapositives avec imgurl, title et group (de 1 à max_thumb_groups, 30 par défaut). Les modèles front le filtrent par groupe, ou par une liste de positions séparées par des virgules en base 1, et random=N mélange et conserve N diapositives (-1 mélange tout).

Un post_id qui commence par { est traité comme une expression. Les parenthèses deviennent des crochets et les guillemets simples deviennent des guillemets doubles, puis json_decode() l'analyse. takebyid prend des blocs post:count:first|last|rand parmi les articles listés. take sélectionne les N derniers articles publiés d'un type de contenu ; le sens du tri est limité à ASC ou DESC et le type de contenu et la limite sont liés avec prepare().

draw_html() copie les attributs avec show_in_popup à 0 dans une clé attributes, puis active le drapeau pour la couverture. Le modèle de couverture imprime l'instantané en JSON base64. front.js le poste avec la clé du shortcode, et get_gallery_by_shortcode() le décode, force de nouveau show_in_popup à 0 pour que la réponse soit toujours la galerie et jamais une autre couverture, et restitue le même modèle. Un drapeau côté client bloque les doubles clics pendant l'exécution de la requête.

get_gallery_by_shortcode() est enregistré pour les utilisateurs anonymes et reçoit la clé du shortcode depuis le client. Il n'inclut un modèle que si get_shortcode_key_folder() trouve la clé parmi les shortcodes découverts à l'init ; toute autre valeur ne restitue rien.

Les mises en file des scripts et des styles se trouvent en haut de chaque modèle de shortcode, de sorte qu'une page ne charge que les bibliothèques des galeries qu'elle affiche réellement, imprimées dans le pied de page. Chaque instance reçoit un identifiant de conteneur uniqid(), si bien que plusieurs galeries, y compris sur des scripts différents, peuvent fonctionner sur une même page.