Yandex Maps for Gutenberg

Yandex Maps for Gutenberg adds interactive maps to WordPress without shortcodes or custom code. Insert the Yandex Map block, set its location and appearance in the inspector, and watch the live preview. This is an independent community plugin, not affiliated with, endorsed by, or sponsored by Yandex. It uses the Yandex Maps JavaScript API under Yandex's API terms. Made for WordPress editors

• Configure maps visually in Gutenberg.
• Add multiple independent maps to posts and pages.
• Use custom markers, popups, links and bundled SVG icons, with optional clustering.
• Choose responsive dimensions, aspect ratio and wide or full-width alignment.
• Adjust camera, zoom, theme, behaviors and controls.
• Work with classic and block themes without theme-specific CSS.

Performance, privacy and accessibility Map assets load only where the block is used; maps initialize near the viewport or after a visitor clicks Activate map. Each map uses a Web Component with keyboard controls, reduced-motion handling, accessible errors and a Yandex Maps fallback. Map customization Create structured markers with coordinates, titles, descriptions, categories, addresses, safe links, colors, image icons, sizes and stacking order. Advanced users can apply validated Yandex customization JSON. Inline maps support up to 1,000 markers with client-side clustering; large store-locator datasets are not included. A Yandex Maps JavaScript API v3 browser key is required. Browser keys are public by design: restrict yours by HTTP Referer in the Yandex developer dashboard. How it works

1. Add the Yandex Map block in Gutenberg.
2. Configure the map in the block inspector while the preview updates.
3. Publish. The frontend loads the shared Yandex SDK only when needed, with an independent controller per map.

2.0.1

• Renamed the plugin to Yandex Maps for Gutenberg without changing its block or stored-data identifiers.
• Rewrote the developer and WordPress.org documentation.
• Standardized source audits, quality checks, deterministic packaging and GitHub release infrastructure.
• Improved clean-install release testing and WordPress.org SVN staging.

2.0.0

• Rebuilt the plugin with block.json, Block API version 3 and server-side rendering.
• Migrated the map runtime from Yandex Maps JavaScript API 2.1 to v3.
• Added multiple structured markers, marker editing and client-side clustering.
• Added responsive layout, camera, behavior, control, appearance and loading settings.
• Added Web Component and Shadow DOM isolation for frontend and editor maps.
• Added a non-interactive Gutenberg preview with live inspector updates.
• Added customizable optional preloaders and removed the frontend activation message when click-to-activate is disabled.
• Fixed full-width rendering so it spans the viewport without horizontal overflow.
• Added conditional assets, shared SDK loading and viewport-based initialization.
• Added an API-key and locale settings screen.
• Added English and Russian translations, automated unit tests, coding standards and Chromium smoke tests.
• Added backward-compatible rendering and editor migration for legacy blocks.
• Added failure diagnostics: administrators see why a map could not load, and the settings screen verifies the API key with Yandex for the current site.
• Added marker hint tooltips on hover and keyboard focus, a visitor location marker and visible geolocation messages.
• Added clustering to the editor preview.
• Added a searchable marker icon catalog in place of the free-text icon name.
• Fixed the editor error notice and its retry button being clipped and unreachable.
• Fixed invisible click-blocking areas next to markers and clusters, and marker placement on right-to-left sites.
• Fixed marker popups being cut off at the map edge, hidden behind other markers and left open after clicking elsewhere.
• Fixed a zoom range with equal minimum and maximum preventing the map from rendering.
• Fixed clearing a numeric editor field storing zero, and editor fields accepting values the server discards.
• Fixed uneven zoom steps on repeated presses, lost keyboard focus after map activation and the aspect ratio being overridden by the minimum height.
• Fixed marker pins being cut off when the viewport is fitted to markers.
• Fixed "Restrict map area" holding the map outside the selected area as soon as the camera moved.
• Fixed customization rules the map cannot process breaking the map tiles; the editor lists the problems instead of applying such a style, and applies a valid style while it is typed.
• Fixed the zoom buttons overlapping the fullscreen button on short maps.
• Fixed the editor preview turning almost a full circle when the camera azimuth crossed zero.
• Added Firefox and WebKit (Safari) to the browser tests and a suite for classic themes.
• Added a checksum-verified workflow for updating the bundled marker artwork from its upstream package.
• Removed the per-marker "Draggable marker" and "Map follows while dragging" options. Markers saved as draggable stay in place and visitors can no longer move them.

1.0.1

• Added compatibility and translation fixes.

1.0.0

• Initial release.