{"id":244014,"date":"2025-08-02T19:43:05","date_gmt":"2025-08-02T19:43:05","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/panoramic-image-block\/"},"modified":"2025-08-02T19:42:37","modified_gmt":"2025-08-02T19:42:37","slug":"panoramic-image-block","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/panoramic-image-block\/","author":263,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"trunk","tested":"6.8.5","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Panoramic Image Block","header_author":"Donncha O Caoimh","header_description":"A WordPress block to display panoramic images created from 3 images.","assets_banners_color":"","last_updated":"2025-08-02 19:42:37","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/donnchawp\/panoramic-image-block","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":243,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.0.0":"

Initial release of Panoramic Image Block with dual block support. Start displaying stunning panoramic images today!<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":{"panoramic-image-block\/panoramic":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"panoramic-image-block\/panoramic","title":"Panoramic Image Block","category":"media","icon":"format-gallery","description":"Display a panoramic image created from 3 stitched images.","keywords":["panorama","panoramic","image","gallery","360"],"version":"1.0.0","textdomain":"panoramic-image-block","supports":{"html":false,"align":["wide","full"],"spacing":{"margin":true,"padding":true}},"attributes":{"images":{"type":"array","default":[],"items":{"type":"object","properties":{"id":{"type":"number"},"url":{"type":"string"},"alt":{"type":"string"}}}},"altText":{"type":"string","default":""}},"example":{"attributes":{"images":[],"altText":"Sample panoramic view"}},"editorScript":"file:.\/build\/index.js","editorStyle":"file:.\/build\/index.css","style":"file:.\/build\/style-index.css"}},"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1220,210,163,762,205945],"plugin_category":[50],"plugin_contributors":[77609],"plugin_business_model":[],"class_list":["post-244014","plugin","type-plugin","status-publish","hentry","plugin_tags-block","plugin_tags-gallery","plugin_tags-images","plugin_tags-panorama","plugin_tags-panoramic","plugin_category-media","plugin_contributors-donncha","plugin_committers-donncha"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/panoramic-image-block.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

Panoramic Image Block<\/strong> is a powerful WordPress Gutenberg plugin that provides two specialized blocks for displaying panoramic images with interactive viewers. Perfect for showcasing landscapes, architecture, events, or any wide-angle view.<\/p>\n\n

Two Block Types<\/h3>\n\n

1. Panoramic Image Block (3 Images)<\/h4>\n\n

Creates panoramic images by automatically stitching together 3 uploaded images.<\/p>\n\n

2. Single Panoramic Image Block (1 Image)<\/h4>\n\n

Displays a single large panoramic image with full interactive viewer capabilities.<\/p>\n\n

Key Features<\/h3>\n\n
    \n
  • Dual Block Support<\/strong> - Choose between 3-image stitching or single image display<\/li>\n
  • Easy Image Selection<\/strong> - Upload images directly from your WordPress media library<\/li>\n
  • Automatic Stitching<\/strong> - 3 images are seamlessly combined into a single panoramic view<\/li>\n
  • Interactive Viewer<\/strong> - Click thumbnails to open full-screen panoramic viewers<\/li>\n
  • Touch & Mouse Support<\/strong> - Drag to pan on both desktop and mobile devices<\/li>\n
  • Zoom Functionality<\/strong> - Zoom in\/out with mouse wheel, buttons, or keyboard shortcuts<\/li>\n
  • Keyboard Navigation<\/strong> - Full keyboard support for accessibility (arrow keys, +\/-, 0 to reset)<\/li>\n
  • Responsive Design<\/strong> - Works perfectly on all screen sizes and devices<\/li>\n
  • Accessibility Ready<\/strong> - ARIA labels, screen reader support, and keyboard navigation<\/li>\n
  • No External Dependencies<\/strong> - Works entirely within WordPress, no third-party services<\/li>\n<\/ul>\n\n

    How It Works<\/h3>\n\n

    Panoramic Image Block (3 Images)<\/h4>\n\n
      \n
    1. Add the \"Panoramic Image Block\" to your post or page<\/li>\n
    2. Select 3 images from your media library<\/li>\n
    3. Add alt text for accessibility<\/li>\n
    4. Publish your content<\/li>\n
    5. Visitors can click the thumbnail to explore the panoramic view<\/li>\n<\/ol>\n\n

      Single Panoramic Image Block (1 Image)<\/h4>\n\n
        \n
      1. Add the \"Single Panoramic Image Block\" to your post or page<\/li>\n
      2. Select 1 large panoramic image from your media library<\/li>\n
      3. Add alt text for accessibility<\/li>\n
      4. Publish your content<\/li>\n
      5. Visitors can click the thumbnail to explore the panoramic view<\/li>\n<\/ol>\n\n

        Perfect For<\/h3>\n\n
          \n
        • Real Estate<\/strong> - Showcase property interiors and exteriors<\/li>\n
        • Travel & Tourism<\/strong> - Display scenic landscapes and cityscapes<\/li>\n
        • Architecture<\/strong> - Present building designs and spaces<\/li>\n
        • Events<\/strong> - Capture wide venue shots and group photos<\/li>\n
        • Art & Photography<\/strong> - Create immersive visual experiences<\/li>\n<\/ul>\n\n

          The plugin requires no configuration - simply install, activate, and start creating panoramic content!<\/p>\n\n

          Development<\/h3>\n\n

          This plugin is actively developed on GitHub. Contributions, bug reports, and feature requests are welcome!<\/p>\n\n

          GitHub Repository:<\/strong> https:\/\/github.com\/donnchawp\/panoramic-image-block<\/p>\n\n

          Browser Support<\/h3>\n\n
            \n
          • Chrome 60+<\/li>\n
          • Firefox 55+ <\/li>\n
          • Safari 12+<\/li>\n
          • Edge 79+<\/li>\n
          • Mobile browsers with Canvas support<\/li>\n<\/ul>\n\n

            WordPress Compatibility<\/h3>\n\n
              \n
            • WordPress 6.0+<\/li>\n
            • PHP 7.4+<\/li>\n
            • Gutenberg block editor<\/li>\n<\/ul>\n\n

              Privacy<\/h3>\n\n

              This plugin does not collect any user data. All image processing happens locally in the user's browser using HTML5 Canvas. No images are sent to external services.<\/p>\n\n\n

              Automatic Installation<\/h3>\n\n
                \n
              1. Go to your WordPress admin dashboard<\/li>\n
              2. Navigate to Plugins \u2192 Add New<\/li>\n
              3. Search for \"Panoramic Image Block\"<\/li>\n
              4. Click \"Install Now\" and then \"Activate\"<\/li>\n<\/ol>\n\n

                Manual Installation<\/h3>\n\n
                  \n
                1. Download the plugin ZIP file<\/li>\n
                2. Go to Plugins \u2192 Add New \u2192 Upload Plugin<\/li>\n
                3. Choose the ZIP file and click \"Install Now\"<\/li>\n
                4. Activate the plugin<\/li>\n<\/ol>\n\n

                  Using the Blocks<\/h3>\n\n

                  Panoramic Image Block (3 Images)<\/h4>\n\n
                    \n
                  1. Edit a post or page in the block editor<\/li>\n
                  2. Click the \"+\" button to add a new block<\/li>\n
                  3. Search for \"Panoramic Image Block\" or find it in the Media category<\/li>\n
                  4. Click to add the block<\/li>\n
                  5. Select 3 images from your media library<\/li>\n
                  6. Add alt text in the block settings panel<\/li>\n
                  7. Publish your content<\/li>\n<\/ol>\n\n

                    Single Panoramic Image Block (1 Image)<\/h4>\n\n
                      \n
                    1. Edit a post or page in the block editor<\/li>\n
                    2. Click the \"+\" button to add a new block<\/li>\n
                    3. Search for \"Single Panoramic Image Block\" or find it in the Media category<\/li>\n
                    4. Click to add the block<\/li>\n
                    5. Select 1 large panoramic image from your media library<\/li>\n
                    6. Add alt text in the block settings panel<\/li>\n
                    7. Publish your content<\/li>\n<\/ol>\n\n\n
                      \n

                      What image formats are supported?<\/h3><\/dt>\n

                      The plugin supports all image formats that WordPress supports by default: JPEG, PNG, GIF, and WebP.<\/p><\/dd>\n

                      How many images do I need for each block type?<\/h3><\/dt>\n
                        \n
                      • Panoramic Image Block<\/strong>: Exactly 3 images are required to create a panoramic view. The plugin will automatically stitch them together horizontally.<\/li>\n
                      • Single Panoramic Image Block<\/strong>: Exactly 1 large panoramic image is required.<\/li>\n<\/ul><\/dd>\n

                        What's the recommended image size?<\/h3><\/dt>\n
                          \n
                        • Panoramic Image Block<\/strong>: For best results, use images that have been split into 3 even parts. Images between 800-2000 pixels wide work well.<\/li>\n
                        • Single Panoramic Image Block<\/strong>: Use large panoramic images, typically 2000-8000 pixels wide for best viewing experience.<\/li>\n<\/ul><\/dd>\n

                          Can I use images of different sizes?<\/h3><\/dt>\n
                            \n
                          • Panoramic Image Block<\/strong>: Yes! The plugin automatically handles images of different dimensions by aligning them vertically and scaling appropriately.<\/li>\n
                          • Single Panoramic Image Block<\/strong>: The image will be displayed at its original aspect ratio and can be any size.<\/li>\n<\/ul><\/dd>\n

                            How do I split a panorama into 3 parts for the Panoramic Image Block?<\/h3><\/dt>\n

                            Use ImageMagick like this:\n magick input.jpg -crop 33.33%x100% \"output_split_%d.jpg\"<\/code><\/p><\/dd>\n

                            Does it work on mobile devices?<\/h3><\/dt>\n

                            Absolutely! Both blocks provide panoramic viewers that are fully responsive and support touch gestures for panning and zooming on mobile devices.<\/p><\/dd>\n

                            Is it accessible?<\/h3><\/dt>\n

                            Yes, both blocks follow WordPress accessibility guidelines with proper ARIA labels, keyboard navigation, and screen reader support.<\/p><\/dd>\n

                            Can I customize the appearance?<\/h3><\/dt>\n

                            The plugin uses semantic CSS classes that can be styled with custom CSS. The viewers respect your theme's content width constraints.<\/p><\/dd>\n

                            Does it affect page loading speed?<\/h3><\/dt>\n

                            The plugin only loads its JavaScript and CSS when the blocks are actually used on a page, minimizing performance impact.<\/p><\/dd>\n

                            Can I use it with page builders?<\/h3><\/dt>\n

                            The plugin is designed for the WordPress block editor (Gutenberg). Compatibility with other page builders may vary.<\/p><\/dd>\n

                            Is translation support available?<\/h3><\/dt>\n

                            Yes, the plugin is translation-ready with proper text domain implementation for all user-facing strings.<\/p><\/dd>\n

                            Which block should I use?<\/h3><\/dt>\n
                              \n
                            • Use the Panoramic Image Block<\/strong> when you have 3 separate images that need to be stitched together<\/li>\n
                            • Use the Single Panoramic Image Block<\/strong> when you already have a complete panoramic image file<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n\n

                              1.0.0<\/h4>\n\n
                                \n
                              • Initial release<\/li>\n
                              • Gutenberg block for panoramic image creation from 3 images<\/li>\n
                              • Single panoramic image block for displaying large panoramic images<\/li>\n
                              • Automatic 3-image stitching functionality <\/li>\n
                              • Interactive panoramic viewers with drag\/zoom support<\/li>\n
                              • Full keyboard and touch navigation<\/li>\n
                              • Responsive design for all devices<\/li>\n
                              • Accessibility features with ARIA labels<\/li>\n
                              • WordPress coding standards compliance<\/li>\n
                              • Translation ready with text domain support<\/li>\n<\/ul>","raw_excerpt":"Display panoramic images with interactive viewers. Display panoramas from single or 3 stitched images with drag, zoom, and keyboard navigation.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/244014","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=244014"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/donncha"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=244014"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=244014"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=244014"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=244014"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=244014"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=244014"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}