InPost Gallery

El servidor imprime una expresión regular construida a partir de las claves de shortcode registradas. En BeforeSetContent, cada coincidencia recibe un sc_id, su texto original pasa a un mapa y se sustituye por una imagen de marcador de posición con el icono del shortcode y un resumen de atributos en el título. En PostProcess, los marcadores se sustituyen de nuevo desde el mapa, así que la entrada guardada contiene shortcodes simples y nada específico del editor.

En modo de edición, get_shortcode_template() establece una marca shortcode_mode_edit, conserva solo el primer shortcode registrado del texto enviado mediante get_shortcode_regex() y ejecuta do_shortcode(). El manejador de shortcode del plugin ve la marca y almacena los atributos analizados en lugar de renderizar HTML. Los campos del formulario leen después sus valores por defecto mediante set_default_value(), que los sanea.

Esto evita un segundo analizador de atributos: las comillas, el escapado y los espacios los gestiona el mismo código que renderiza el shortcode en el front-end.

changer() recorre cada elemento del formulario marcado con data-shortcode-field. Las comillas dobles dentro de los valores se sustituyen por comillas simples para que no puedan cerrar el atributo. Un campo llamado content pasa a ser el contenido encerrado. Los campos repetidos marcados como save_as_one se recogen y se unen con ^ en un solo atributo, ya que los atributos de shortcode no pueden contener arrays.

TinyMCE 4 en WordPress 3.9 sustituyó manejadores como onBeforeSetContent.add() por ed.on('BeforeSetContent'). El plugin mantiene la compilación antigua en js/wp38/ y la nueva en js/, y elige entre ellas tanto para el script de administración como para el plugin de TinyMCE registrado.

get_shortcodes_array() escanea views/shortcodes/popups/ y registra un shortcode por nombre de archivo. Cada clave tiene una plantilla de front-end y una plantilla de formulario de editor. get_shortcode_key_folder() devuelve la carpeta solo para claves conocidas, así que los llamantes de AJAX no pueden apuntar el include a otro archivo, y get_shortcode_template() recurre a inpost_gallery para nombres desconocidos.

get_image() recibe un alias de tamaño como 200x150 y llama a un redimensionador adaptado de Aqua Resizer 1.1.7. Calcula el tamaño de destino con image_resize_dimensions(), busca un archivo name-WxH.ext existente junto al original y devuelve su URL, o lo redimensiona y lo guarda en la primera petición. La clase está renombrada (Inpg_Aq_ResizePN) y envuelta en class_exists para que no pueda chocar con temas que incluyen la biblioteca original.

El plugin abre el modal de medios estándar y sustituye temporalmente window.send_to_editor. El HTML insertado se analiza en un búfer oculto para obtener destinos de enlace u orígenes de imagen. add_meta_slide_items() solicita una diapositiva renderizada cada vez e inicia la siguiente petición en el callback, de modo que las diapositivas conservan el orden de la selección. La lista es ordenable y se renumera tras cada cambio.

inpost_gallery_data es un array de diapositivas con imgurl, title y group (de 1 a max_thumb_groups, 30 por defecto). Las plantillas de front-end lo filtran por grupo, o por una lista separada por comas de posiciones basadas en 1, y random=N mezcla y conserva N diapositivas (-1 mezcla todas).

Un post_id que empieza por { se trata como una expresión. Los paréntesis pasan a ser corchetes y las comillas simples pasan a ser comillas dobles, y después json_decode() la analiza. takebyid toma bloques post:count:first|last|rand de las entradas indicadas. take selecciona las N últimas entradas publicadas de un tipo de contenido; el sentido de ordenación se limita a ASC o DESC y el tipo de contenido y el límite se enlazan con prepare().

draw_html() copia los atributos con show_in_popup a 0 en una clave attributes y después activa la marca para la portada. La plantilla de portada imprime la instantánea como JSON en base64. front.js la envía con la clave del shortcode, y get_gallery_by_shortcode() la decodifica, vuelve a forzar show_in_popup a 0 para que la respuesta sea siempre la galería y nunca otra portada, y renderiza la misma plantilla. Una marca en el cliente bloquea los dobles clics mientras la petición está en curso.

get_gallery_by_shortcode() está registrado para usuarios anónimos y recibe la clave del shortcode desde el cliente. Solo incluye una plantilla cuando get_shortcode_key_folder() encuentra la clave entre los shortcodes descubiertos en init; cualquier otro valor no renderiza nada.

Los encolados de scripts y estilos están al principio de cada plantilla de shortcode, así que una página carga solo las bibliotecas de las galerías que realmente muestra, impresas en el pie de página. Cada instancia recibe un ID de contenedor uniqid(), de modo que varias galerías, incluidas las que usan scripts distintos, pueden funcionar en una misma página.