Title: Panoramic Image Block Author: Donncha O Caoimh (a11n) Published: 2 آگوست 2025 Last modified: 2 آگوست 2025 --- جستجوی افزونه‌ها ![](https://s.w.org/plugins/geopattern-icon/panoramic-image-block.svg) # Panoramic Image Block توسط [Donncha O Caoimh (a11n)](https://profiles.wordpress.org/donncha/) [دانلود](https://downloads.wordpress.org/plugin/panoramic-image-block.zip) * [جزئیات](https://fa.wordpress.org/plugins/panoramic-image-block/#description) * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/panoramic-image-block/#reviews) * [نصب](https://fa.wordpress.org/plugins/panoramic-image-block/#installation) * [توسعه](https://fa.wordpress.org/plugins/panoramic-image-block/#developers) [پشتیبانی](https://wordpress.org/support/plugin/panoramic-image-block/) ## توضیحات **Panoramic Image Block** 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. ### Two Block Types #### 1. Panoramic Image Block (3 Images) Creates panoramic images by automatically stitching together 3 uploaded images. #### 2. Single Panoramic Image Block (1 Image) Displays a single large panoramic image with full interactive viewer capabilities. ### Key Features * **Dual Block Support** – Choose between 3-image stitching or single image display * **Easy Image Selection** – Upload images directly from your WordPress media library * **Automatic Stitching** – 3 images are seamlessly combined into a single panoramic view * **Interactive Viewer** – Click thumbnails to open full-screen panoramic viewers * **Touch & Mouse Support** – Drag to pan on both desktop and mobile devices * **Zoom Functionality** – Zoom in/out with mouse wheel, buttons, or keyboard shortcuts * **Keyboard Navigation** – Full keyboard support for accessibility (arrow keys, +/-, 0 to reset) * **Responsive Design** – Works perfectly on all screen sizes and devices * **Accessibility Ready** – ARIA labels, screen reader support, and keyboard navigation * **No External Dependencies** – Works entirely within WordPress, no third-party services ### How It Works #### Panoramic Image Block (3 Images) 1. Add the “Panoramic Image Block” to your post or page 2. Select 3 images from your media library 3. Add alt text for accessibility 4. Publish your content 5. Visitors can click the thumbnail to explore the panoramic view #### Single Panoramic Image Block (1 Image) 1. Add the “Single Panoramic Image Block” to your post or page 2. Select 1 large panoramic image from your media library 3. Add alt text for accessibility 4. Publish your content 5. Visitors can click the thumbnail to explore the panoramic view ### Perfect For * **Real Estate** – Showcase property interiors and exteriors * **Travel & Tourism** – Display scenic landscapes and cityscapes * **Architecture** – Present building designs and spaces * **Events** – Capture wide venue shots and group photos * **Art & Photography** – Create immersive visual experiences The plugin requires no configuration – simply install, activate, and start creating panoramic content! ### Development This plugin is actively developed on GitHub. Contributions, bug reports, and feature requests are welcome! **GitHub Repository:** https://github.com/donnchawp/panoramic-image-block ### Browser Support * Chrome 60+ * Firefox 55+ * Safari 12+ * Edge 79+ * Mobile browsers with Canvas support ### WordPress Compatibility * WordPress 6.0+ * PHP 7.4+ * Gutenberg block editor ### Privacy 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. ## بلوک‌ها این افزونه 1 بلوک ارائه می‌دهد. * Panoramic Image Block Display a panoramic image created from 3 stitched images. ## نصب ### Automatic Installation 1. Go to your WordPress admin dashboard 2. Navigate to Plugins Add New 3. Search for “Panoramic Image Block” 4. Click “Install Now” and then “Activate” ### Manual Installation 1. Download the plugin ZIP file 2. Go to Plugins Add New Upload Plugin 3. Choose the ZIP file and click “Install Now” 4. Activate the plugin ### Using the Blocks #### Panoramic Image Block (3 Images) 1. Edit a post or page in the block editor 2. Click the “+” button to add a new block 3. Search for “Panoramic Image Block” or find it in the Media category 4. Click to add the block 5. Select 3 images from your media library 6. Add alt text in the block settings panel 7. Publish your content #### Single Panoramic Image Block (1 Image) 1. Edit a post or page in the block editor 2. Click the “+” button to add a new block 3. Search for “Single Panoramic Image Block” or find it in the Media category 4. Click to add the block 5. Select 1 large panoramic image from your media library 6. Add alt text in the block settings panel 7. Publish your content ## سوالات متداول ### What image formats are supported? The plugin supports all image formats that WordPress supports by default: JPEG, PNG, GIF, and WebP. ### How many images do I need for each block type? * **Panoramic Image Block**: Exactly 3 images are required to create a panoramic view. The plugin will automatically stitch them together horizontally. * **Single Panoramic Image Block**: Exactly 1 large panoramic image is required. ### What’s the recommended image size? * **Panoramic Image Block**: For best results, use images that have been split into 3 even parts. Images between 800-2000 pixels wide work well. * **Single Panoramic Image Block**: Use large panoramic images, typically 2000- 8000 pixels wide for best viewing experience. ### Can I use images of different sizes? * **Panoramic Image Block**: Yes! The plugin automatically handles images of different dimensions by aligning them vertically and scaling appropriately. * **Single Panoramic Image Block**: The image will be displayed at its original aspect ratio and can be any size. ### How do I split a panorama into 3 parts for the Panoramic Image Block? Use ImageMagick like this: `magick input.jpg -crop 33.33%x100% "output_split_%d. jpg"` ### Does it work on mobile devices? Absolutely! Both blocks provide panoramic viewers that are fully responsive and support touch gestures for panning and zooming on mobile devices. ### Is it accessible? Yes, both blocks follow WordPress accessibility guidelines with proper ARIA labels, keyboard navigation, and screen reader support. ### Can I customize the appearance? The plugin uses semantic CSS classes that can be styled with custom CSS. The viewers respect your theme’s content width constraints. ### Does it affect page loading speed? The plugin only loads its JavaScript and CSS when the blocks are actually used on a page, minimizing performance impact. ### Can I use it with page builders? The plugin is designed for the WordPress block editor (Gutenberg). Compatibility with other page builders may vary. ### Is translation support available? Yes, the plugin is translation-ready with proper text domain implementation for all user-facing strings. ### Which block should I use? * Use the **Panoramic Image Block** when you have 3 separate images that need to be stitched together * Use the **Single Panoramic Image Block** when you already have a complete panoramic image file ## نقد و بررسی‌ها نقد و بررسی‌ای برای این افزونه یافت نشد. ## توسعه دهندگان و همکاران “Panoramic Image Block” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند. مشارکت کنندگان * [ Donncha O Caoimh (a11n) ](https://profiles.wordpress.org/donncha/) [ترجمه “Panoramic Image Block” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/panoramic-image-block) ### علاقه‌ مند به توسعه هستید؟ [Browse the code](https://plugins.trac.wordpress.org/browser/panoramic-image-block/), check out the [SVN repository](https://plugins.svn.wordpress.org/panoramic-image-block/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/panoramic-image-block/) by [RSS](https://plugins.trac.wordpress.org/log/panoramic-image-block/?limit=100&mode=stop_on_copy&format=rss). ## گزارش تغییرات #### 1.0.0 * Initial release * Gutenberg block for panoramic image creation from 3 images * Single panoramic image block for displaying large panoramic images * Automatic 3-image stitching functionality * Interactive panoramic viewers with drag/zoom support * Full keyboard and touch navigation * Responsive design for all devices * Accessibility features with ARIA labels * WordPress coding standards compliance * Translation ready with text domain support ## اطلاعات * نگارش **1.0.0** * Last updated **8 ماه پیش** * نصب‌های فعال **کمتر از 10** * نگارش وردپرس ** 6.0 یا بالاتر ** * Tested up to **6.8.5** * نگارش PHP ** 7.4 یا بالاتر ** * زبان * [English (US)](https://wordpress.org/plugins/panoramic-image-block/) * Tags * [block](https://fa.wordpress.org/plugins/tags/block/)[gallery](https://fa.wordpress.org/plugins/tags/gallery/) [images](https://fa.wordpress.org/plugins/tags/images/)[panorama](https://fa.wordpress.org/plugins/tags/panorama/) [panoramic](https://fa.wordpress.org/plugins/tags/panoramic/) * [نمایش پیشرفته](https://fa.wordpress.org/plugins/panoramic-image-block/advanced/) ## امتیازها هنوز هیچ نقدی ارسال نشده است. [افزودن ارزیابی من](https://wordpress.org/support/plugin/panoramic-image-block/reviews/#new-post) [مشاهده همه بررسی‌ها](https://wordpress.org/support/plugin/panoramic-image-block/reviews/) ## مشارکت کنندگان * [ Donncha O Caoimh (a11n) ](https://profiles.wordpress.org/donncha/) ## پشتیبانی چیزی برای گفتن دارید؟ نیاز به کمک دارید؟ [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/panoramic-image-block/)