InPost Gallery

O servidor imprime uma regex construída a partir das chaves de shortcode registadas. Em BeforeSetContent, cada correspondência recebe um sc_id, o seu texto original vai para um mapa e é substituída por uma imagem marcadora com o ícone do shortcode e um resumo dos atributos no título. Em PostProcess, os marcadores são substituídos de volta a partir do mapa, pelo que o artigo guardado contém shortcodes simples e nada específico do editor.

Em modo de edição, get_shortcode_template() define uma flag shortcode_mode_edit, mantém apenas o primeiro shortcode registado do texto enviado através de get_shortcode_regex() e executa do_shortcode(). O handler de shortcode do plugin vê a flag e guarda os atributos analisados em vez de renderizar HTML. Os campos do formulário leem depois os seus valores por omissão através de set_default_value(), que os sanitiza.

Isto evita um segundo analisador de atributos: aspas, escape e espaçamento são tratados pelo mesmo código que renderiza o shortcode no front-end.

changer() percorre todos os elementos do formulário marcados com data-shortcode-field. As aspas duplas dentro dos valores são substituídas por aspas simples, para não poderem fechar o atributo. Um campo chamado content passa a ser o conteúdo envolvido. Os campos repetidos marcados com save_as_one são reunidos e juntos com ^ num só atributo, já que os atributos de shortcode não podem conter arrays.

O TinyMCE 4 no WordPress 3.9 substituiu handlers como onBeforeSetContent.add() por ed.on('BeforeSetContent'). O plugin mantém a versão antiga em js/wp38/ e a nova em js/, e escolhe entre elas tanto para o script de administração como para o plugin do TinyMCE registado.

get_shortcodes_array() analisa views/shortcodes/popups/ e regista um shortcode por nome de ficheiro. Cada chave tem um template de front-end e um template de formulário do editor. get_shortcode_key_folder() devolve a pasta apenas para chaves conhecidas, pelo que chamadores AJAX não podem apontar o include para outro ficheiro, e get_shortcode_template() recorre a inpost_gallery para nomes desconhecidos.

get_image() recebe um alias de tamanho como 200x150 e chama um redimensionador adaptado do Aqua Resizer 1.1.7. Calcula o tamanho de destino com image_resize_dimensions(), procura um ficheiro name-WxH.ext existente junto ao original e devolve o seu URL, ou redimensiona e guarda-o no primeiro pedido. A classe foi renomeada (Inpg_Aq_ResizePN) e envolvida em class_exists, para não colidir com temas que incluem a biblioteca original.

O plugin abre o modal de multimédia padrão e substitui temporariamente window.send_to_editor. O HTML inserido é analisado num buffer oculto para obter destinos de ligação ou origens de imagem. add_meta_slide_items() pede um slide renderizado de cada vez e inicia o pedido seguinte no callback, para que os slides mantenham a ordem da seleção. A lista é ordenável e renumerada após cada alteração.

inpost_gallery_data é um array de slides com imgurl, title e group (1 a max_thumb_groups, 30 por omissão). Os templates de front-end filtram-no por grupo, ou por uma lista separada por vírgulas de posições a partir de 1, e random=N embaralha e mantém N slides (-1 embaralha todos).

Um post_id que começa por { é tratado como expressão. Os parênteses passam a retos e as aspas simples a aspas duplas, e depois json_decode() analisa-o. takebyid obtém blocos post:count:first|last|rand de artigos listados. take seleciona os N artigos publicados mais recentes de um tipo de conteúdo; a direção da ordenação limita-se a ASC ou DESC e o tipo de conteúdo e o limite são ligados com prepare().

draw_html() copia os atributos com show_in_popup a 0 para uma chave attributes e depois liga a flag para a capa. O template da capa imprime o instantâneo como JSON em base64. front.js envia-o com a chave do shortcode, e get_gallery_by_shortcode() descodifica-o, força de novo show_in_popup a 0 para que a resposta seja sempre a galeria e nunca outra capa, e renderiza o mesmo template. Uma flag no cliente bloqueia cliques duplos enquanto o pedido decorre.

get_gallery_by_shortcode() está registado para utilizadores anónimos e recebe a chave do shortcode do cliente. Só inclui um template quando get_shortcode_key_folder() encontra a chave entre os shortcodes descobertos no init; qualquer outro valor não renderiza nada.

As colocações em fila de scripts e estilos ficam no topo de cada template de shortcode, pelo que uma página carrega apenas as bibliotecas das galerias que realmente mostra, impressas no rodapé. Cada instância recebe um ID de contentor uniqid(), pelo que várias galerias, incluindo as de scripts diferentes, podem correr numa mesma página.