InPost Gallery

Сервер виводить регулярний вираз, побудований із ключів зареєстрованих шорткодів. На BeforeSetContent кожен збіг отримує sc_id, його початковий текст потрапляє в мапу, а сам він замінюється зображенням-заповнювачем з іконкою шорткоду та коротким описом атрибутів у title. На PostProcess заповнювачі замінюються назад із мапи, тож збережений запис містить звичайні шорткоди й нічого, специфічного для редактора.

У режимі редагування get_shortcode_template() встановлює прапорець shortcode_mode_edit, залишає з надісланого тексту лише перший зареєстрований шорткод через get_shortcode_regex() і запускає do_shortcode(). Обробник шорткоду плагіна бачить прапорець і зберігає розібрані атрибути замість рендерингу HTML. Поля форми потім читають свої типові значення через set_default_value(), яка їх санітизує.

Так уникають другого парсера атрибутів: лапки, екранування й пробіли обробляє той самий код, що рендерить шорткод на фронтенді.

changer() проходить усі елементи форми з позначкою data-shortcode-field. Подвійні лапки всередині значень замінюються одинарними, щоб вони не могли закрити атрибут. Поле з назвою content стає вмістом між тегами шорткоду. Повторювані поля з позначкою save_as_one збираються й з'єднуються через ^ в один атрибут, бо атрибути шорткодів не можуть містити масиви.

TinyMCE 4 у WordPress 3.9 замінив обробники на кшталт onBeforeSetContent.add() на ed.on('BeforeSetContent'). Плагін тримає стару збірку в js/wp38/, а нову в js/ і обирає між ними і для адмін-скрипта, і для зареєстрованого плагіна TinyMCE.

get_shortcodes_array() сканує views/shortcodes/popups/ і реєструє один шорткод на кожне ім'я файлу. Кожен ключ має шаблон фронтенду й шаблон форми редактора. get_shortcode_key_folder() повертає теку лише для відомих ключів, тож AJAX-виклики не можуть вказати include на інший файл, а get_shortcode_template() для невідомих імен використовує inpost_gallery.

get_image() приймає псевдонім розміру на кшталт 200x150 і викликає ресайзер, адаптований з Aqua Resizer 1.1.7. Він обчислює цільовий розмір через image_resize_dimensions(), шукає наявний файл name-WxH.ext поруч з оригіналом і повертає його URL, або змінює розмір і зберігає файл при першому запиті. Клас перейменовано (Inpg_Aq_ResizePN) і обгорнуто в class_exists, щоб він не конфліктував з темами, які постачають оригінальну бібліотеку.

Плагін відкриває стандартну медіа-модалку й тимчасово підміняє window.send_to_editor. Вставлений HTML розбирається в прихованому буфері для пошуку цілей посилань або джерел зображень. add_meta_slide_items() запитує по одному відрендереному слайду й запускає наступний запит у колбеку, тож слайди зберігають порядок вибору. Список можна сортувати, і він перенумеровується після кожної зміни.

inpost_gallery_data — це масив слайдів з imgurl, title і group (від 1 до max_thumb_groups, типово 30). Шаблони фронтенду фільтрують його за групою або за списком позицій через кому (з нумерацією від 1), а random=N перемішує й залишає N слайдів (-1 перемішує всі).

post_id, що починається з {, вважається виразом. Дужки стають квадратними дужками, а одинарні лапки — подвійними, після чого json_decode() його розбирає. takebyid бере блоки post:count:first|last|rand із зазначених записів. take вибирає N найновіших опублікованих записів типу запису; напрям сортування обмежено ASC або DESC, а тип запису й ліміт прив'язуються через prepare().

draw_html() копіює атрибути з show_in_popup, встановленим у 0, у ключ attributes, а потім вмикає прапорець для обкладинки. Шаблон обкладинки виводить знімок як base64 JSON. front.js надсилає його з ключем шорткоду, а get_gallery_by_shortcode() декодує його, знову примусово встановлює show_in_popup у 0, щоб відповіддю завжди була галерея, а не ще одна обкладинка, і рендерить той самий шаблон. Прапорець на клієнті блокує подвійні кліки, поки виконується запит.

get_gallery_by_shortcode() зареєстровано для анонімних користувачів, і він отримує ключ шорткоду від клієнта. Він підключає шаблон, лише коли get_shortcode_key_folder() знаходить ключ серед шорткодів, виявлених під час ініціалізації; будь-яке інше значення нічого не рендерить.

Підключення скриптів і стилів стоїть на початку кожного шаблону шорткоду, тож сторінка завантажує лише бібліотеки тих галерей, які справді показує, і виводить їх у футері. Кожен екземпляр отримує ID контейнера з uniqid(), тож кілька галерей, зокрема на різних скриптах, можуть працювати на одній сторінці.