{"id":312121,"date":"2026-05-14T08:03:30","date_gmt":"2026-05-14T08:03:30","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/image-hotspots-tool\/"},"modified":"2026-05-14T14:51:38","modified_gmt":"2026-05-14T14:51:38","slug":"pleaseup-hotspots","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/pleaseup-hotspots\/","author":23496860,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"3.1.0","stable_tag":"3.1.0","tested":"6.9.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Image Hotspots by Pleaseup \u2013 Interactive Image Map & Tooltips","header_author":"Pleaseup","header_description":"Add drag & drop hotspots to images from the Media Library, Gutenberg galleries, and ACF fields. Includes a back-office editor and frontend rendering with HTML layers. Use the shortcode to embed hotspot images anywhere.","assets_banners_color":"38c88e","last_updated":"2026-05-14 14:51:38","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/pleaseup-hotspots\/","header_author_uri":"https:\/\/by.pleaseup.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":38,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"3.0.3":{"tag":"3.0.3","author":"bypleaseup","date":"2026-05-14 09:32:00"},"3.1.0":{"tag":"3.1.0","author":"bypleaseup","date":"2026-05-14 14:51:38"}},"upgrade_notice":{"3.1.0":"

Rebrand to "Image Hotspots by Pleaseup" + admin menu label refresh. No data migration, all existing shortcodes ([wphs_image]<\/code>, [wphs_gallery]<\/code>) and settings continue to work.<\/p>","3.0.3":"

Distribution hygiene fix: hidden .gitkeep files excluded from the zip; readme tested-up-to bumped to 6.9. No data migration required.<\/p>","3.0.2":"

Admin UI strings catch-up rename ("WP Hotspots" \u2192 "Pleaseup Hotspots"). No data migration required.<\/p>","3.0.1":"

Rename + asset cleanup for WordPress.org Plugin Directory submission. No data migration required.<\/p>","3.0.0":"

Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3532106,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3532106,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3532106,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3532106,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["3.0.3","3.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3532145,"resolution":"1","location":"assets","locale":"","width":1920,"height":1603}},"screenshots":{"1":"Plugin admin overview \u2014 image hotspot collections listed in the WordPress back-office.","2":"Drag & drop editor<\/strong> \u2014 add, move, and delete hotspots visually in the WordPress back-office.","3":"HTML tooltip layers<\/strong> \u2014 each hotspot opens a fully customisable HTML layer (supports the built-in WP editor).","4":"Media Library integration<\/strong> \u2014 works with any image already uploaded to WordPress.","5":"Gutenberg gallery support<\/strong> \u2014 attach hotspots to images inside Gutenberg galleries.","6":"ACF support<\/strong> \u2014 compatible with ACF image, gallery, and repeater fields.","7":"Shortcode<\/strong> \u2014 embed any hotspot image anywhere with [wphs_image id=\"123\"]<\/code>.","8":"Gallery slider<\/strong> \u2014 group multiple hotspot images into a responsive carousel with [wphs_gallery id=\"X\"]<\/code>.","9":"Custom hotspot icon<\/strong> \u2014 replace the default dot with any image from the Media Library.","10":"Accessible by default<\/strong> \u2014 keyboard navigation, screen-reader labels, focus indicators, prefers-reduced-motion<\/code> support.","11":"Extensible<\/strong> \u2014 9 filters \/ actions for theme and plugin developers.","12":"Frontend rendering<\/strong> \u2014 physical CSS\/JS files, on-demand enqueue, no inline assets in the head.","13":"size<\/code> \u2014 image size (default: large<\/code>). Accepts any registered WordPress image size.","14":"

class<\/code> \u2014 additional CSS class added to the <img><\/code> tag.<\/p>\n\n

[wphs_gallery id=\"GALLERY_ID\" nav=\"dots+arrows\" cols_desktop=\"3\" cols_mobile=\"1\"]<\/p>","15":"WordPress 6.0 or later","16":"PHP 7.4 or later","17":"jQuery (included with WordPress)","18":"wphs_default_settings<\/code> (filter) \u2014 modify the default plugin options.","19":"wphs_hotspot_data<\/code> (filter) \u2014 modify the hotspot list before rendering.","20":"wphs_tooltip_html<\/code> (filter) \u2014 modify the per-hotspot tooltip HTML.","21":"wphs_allowed_iframe_attrs<\/code> (filter) \u2014 extend the iframe allowlist used by wp_kses<\/code>.","22":"wphs_allowed_iframe_hosts<\/code> (filter) \u2014 extend the host allowlist for iframe src<\/code> attributes.","23":"wphs_oembed_providers<\/code> (filter) \u2014 enable\/disable server-side oEmbed providers.","24":"wphs_hotspot_aria_label<\/code> (filter) \u2014 override the default screen-reader label.","25":"wphs_before_render_image<\/code> (action) \u2014 fire just before [wphs_image]<\/code> outputs HTML.","26":"wphs_after_save_hotspots<\/code> (action) \u2014 fire after hotspots are persisted.","27":"wphs_loaded<\/code> (action) \u2014 fire after the plugin has booted all subsystems."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[4317,146663,3538,127148,788],"plugin_category":[],"plugin_contributors":[262870],"plugin_business_model":[],"class_list":["post-312121","plugin","type-plugin","status-publish","hentry","plugin_tags-annotation","plugin_tags-image-hotspot","plugin_tags-image-map","plugin_tags-interactive-image","plugin_tags-tooltip","plugin_contributors-bypleaseup","plugin_committers-bypleaseup"],"banners":{"banner":"https:\/\/ps.w.org\/pleaseup-hotspots\/assets\/banner-772x250.png?rev=3532106","banner_2x":"https:\/\/ps.w.org\/pleaseup-hotspots\/assets\/banner-1544x500.png?rev=3532106","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/pleaseup-hotspots\/assets\/icon-128x128.png?rev=3532106","icon_2x":"https:\/\/ps.w.org\/pleaseup-hotspots\/assets\/icon-256x256.png?rev=3532106","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/pleaseup-hotspots\/assets\/screenshot-1.png?rev=3532145","caption":"Plugin admin overview \u2014 image hotspot collections listed in the WordPress back-office."}],"raw_content":"\n

Image Hotspots by Pleaseup<\/strong> is a responsive image hotspot<\/strong> plugin that lets you add interactive image maps<\/strong>, tooltips<\/strong>, and annotations<\/strong> to any image with a visual drag & drop editor.<\/p>\n\n

External services<\/h3>\n\n

This plugin contacts third-party services in two distinct flows. Both flows are triggered only by an authenticated editor (with edit_posts<\/code>) pasting a URL inside a tooltip; no data leaves the site automatically.<\/p>\n\n

Server-side oEmbed resolution<\/strong> (wp_oembed_get<\/code>)<\/p>\n\n

When the editor pastes a URL from one of the supported oEmbed providers into a tooltip, the plugin calls the provider's oEmbed endpoint server-side via WordPress core's wp_oembed_get()<\/code> to retrieve the embed HTML. The URL pasted by the editor is sent to the provider; no other data is sent. Supported providers:<\/p>\n\n

    \n
  • YouTube \u2014 Terms: https:\/\/www.youtube.com\/t\/terms \u2014 Privacy: https:\/\/policies.google.com\/privacy<\/li>\n
  • Vimeo \u2014 Terms: https:\/\/vimeo.com\/terms \u2014 Privacy: https:\/\/vimeo.com\/privacy<\/li>\n
  • Spotify \u2014 Terms: https:\/\/www.spotify.com\/legal\/end-user-agreement\/ \u2014 Privacy: https:\/\/www.spotify.com\/legal\/privacy-policy\/<\/li>\n<\/ul>\n\n

    Client-side iframe rendering<\/strong><\/p>\n\n

    When a tooltip containing an oEmbed iframe is opened on a public page, the visitor's browser loads the iframe directly from the provider's CDN (e.g. youtube.com<\/code>, player.vimeo.com<\/code>, open.spotify.com<\/code>). This is standard browser behavior for any embedded media; the plugin does not add any tracking on top.<\/p>\n\n

    The set of allowed iframe hosts is filterable via the wphs_allowed_iframe_hosts<\/code> filter. Hosts not in the allowlist are stripped from tooltip HTML on save.<\/p>\n\n\n

      \n
    1. Upload the pleaseup-hotspots<\/code> folder to the \/wp-content\/plugins\/<\/code> directory, or install the plugin directly from the WordPress plugin repository.<\/li>\n
    2. Activate the plugin through the Plugins<\/strong> menu in WordPress.<\/li>\n
    3. Navigate to Image Hotspots \u2192 Editor<\/strong> in the admin sidebar.<\/li>\n
    4. Select an image from the Media Library and start adding hotspots.<\/li>\n<\/ol>\n\n\n
      \n

      How do I add a hotspot to an image?<\/h3><\/dt>\n

      Go to Image Hotspots \u2192 Editor<\/strong>, select an image from the Media Library, then click anywhere on the image preview to create a hotspot. Drag it to reposition it, then click the hotspot to edit the HTML content of the popup layer.<\/p><\/dd>\n

      How do I display the image with hotspots on the front end?<\/h3><\/dt>\n

      Use the shortcode [wphs_image id=\"123\"]<\/code> where 123<\/code> is the attachment ID of the image. You can also use the shortcode in any post, page, or widget area that supports shortcodes.<\/p><\/dd>\n

      Does it work with Gutenberg image blocks?<\/h3><\/dt>\n

      Yes. Hotspots are stored against the attachment ID, so any block that references that attachment (image block, gallery block, ACF image fields) inherits the configured hotspots when rendered through the [wphs_image]<\/code> shortcode.<\/p><\/dd>\n

      Does it work with page builders (Elementor, Divi, Beaver Builder)?<\/h3><\/dt>\n

      Yes via the [wphs_image]<\/code> and [wphs_gallery]<\/code> shortcodes. CSS and JS are enqueued defensively for builders that render shortcodes after wp_head<\/code>.<\/p><\/dd>\n

      Are hotspot positions responsive?<\/h3><\/dt>\n

      Yes. Coordinates are stored as percentages of the natural image dimensions, so they scale with any rendered image size.<\/p><\/dd>\n

      Can I use a custom icon instead of the default dot?<\/h3><\/dt>\n

      Yes. In the per-image settings, switch the hotspot style to Image<\/em>, upload or choose your custom icon from the Media Library, and save.<\/p><\/dd>\n

      Does it work with ACF?<\/h3><\/dt>\n

      Yes. The plugin stores hotspot data as post meta on the attachment, so any image displayed via wp_get_attachment_image()<\/code> \u2014 including ACF image, gallery, and repeater fields \u2014 can use the shortcode to render with hotspots.<\/p><\/dd>\n

      Will uninstalling the plugin delete my data?<\/h3><\/dt>\n

      Yes. When you uninstall the plugin (not just deactivate it), all hotspot settings, attachment meta, and the plugin's custom post type contents (galleries and tooltips) are removed from the database.<\/p><\/dd>\n\n<\/dl>\n\n\n

      3.1.0<\/h4>\n\n
        \n
      • Rebranded plugin display name to \"Image Hotspots by Pleaseup\" for better discoverability on WordPress.org search.<\/li>\n
      • Updated readme tags and short description for clarity.<\/li>\n
      • Admin menu label updated to \"Image Hotspots\" (page title remains in the same location).<\/li>\n
      • No functional or breaking changes \u2014 existing shortcodes, settings, hooks, post types, and stored data remain fully compatible.<\/li>\n<\/ul>\n\n

        3.0.3<\/h4>\n\n
          \n
        • Build: excluded .gitkeep<\/code> placeholder files from the distribution zip (WordPress.org plugin scanner flags any hidden file).<\/li>\n
        • readme.txt: bumped \"Tested up to\" to 6.9.<\/li>\n<\/ul>\n\n

          3.0.2<\/h4>\n\n
            \n
          • Admin: renamed the admin sidebar menu label and the in-page hero <h1><\/code> from \"WP Hotspots\" \/ \"WP Image HotSpots\" to \"Pleaseup Hotspots\" to match the plugin name.<\/li>\n
          • readme.txt: updated installation and FAQ instructions to refer to the new menu label.<\/li>\n
          • Translations: POT regenerated for the renamed strings.<\/li>\n<\/ul>\n\n

            3.0.1<\/h4>\n\n
              \n
            • Renamed plugin to \"Pleaseup Hotspots\" (slug pleaseup-hotspots<\/code>) for the WordPress.org Plugin Directory.<\/li>\n
            • Frontend: extracted the gallery carousel JavaScript and dynamic CSS to enqueued assets (no more inline <script><\/code> or <style><\/code> blocks in the rendered shortcode HTML). The dynamic per-instance values are now passed as CSS custom properties on the wrapper.<\/li>\n
            • Admin: the gallery preview now reuses the same enqueued frontend assets so the in-editor preview matches the public render exactly.<\/li>\n<\/ul>\n\n

              3.0.0<\/h4>\n\n

              Initial release.<\/p>","raw_excerpt":"Interactive image hotspots with drag & drop editor. Add tooltips, annotations, and image maps. Works with Gutenberg, ACF, and galleries.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/312121","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=312121"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/bypleaseup"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=312121"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=312121"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=312121"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=312121"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=312121"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=312121"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}