Media-Image-List v1.6.2

Release Notes - AP Media Image List v1.6.2

Release Date: October 13, 2025
Type: Feature Enhancement & Bug Fixes
Compatibility: WordPress 5.9+ | PHP 7.4+

🎉 What's New

📖 Inline Post Preview

The biggest addition in v1.6.2 is the new post preview feature that lets you read full post content without leaving the media list:

• Click any post title → Opens a beautiful modal overlay with the complete post
• Full content rendering → Shortcodes, formatting, and all WordPress filters applied
• Scrollable interface → Handle long posts with comfortable vertical scrolling
• Post metadata → See publish date, author, and draft status at the top
• Multiple close options → ×button, click overlay, or press Escape key

🔧 Enhanced EXIF Popup Interaction

We've completely fixed and improved the EXIF popup click-to-pin functionality:

• Proper toggle behavior → Click once to pin, click again to unpin
• Visual consistency → Reliable switching between hover and locked modes
• Smart switching → Click different images to move the pin automatically
• Improved event handling → No more conflicts or unexpected behavior

✨ Key Benefits

🚀 Improved Workflow

• Stay in context → Preview posts without losing your place in the media list
• Faster content review → No page navigation or browser back/forward needed
• Better organization → Quickly check post content while managing media

📱 Better Mobile Experience

• Touch-friendly → Proper touch interactions for mobile devices
• Responsive design → Modal adapts perfectly to phone and tablet screens
• Keyboard support → Escape key works on all devices with keyboards

🔒 Secure & Reliable

• Permission-aware → Respects WordPress user capabilities and post visibility
• Draft support → Works with draft and private posts (when you have access)
• Error handling → Graceful fallbacks when content can't be loaded

🐛 Critical Bug Fixes

EXIF Popup Locking (Major Fix)

• Issue: Clicking images didn't properly lock/unlock EXIF popups
• Cause: Event handler conflicts and improper state management
• Fix: Completely rewrote click event logic with proper toggle mechanism
• Result: Reliable click-to-pin/unpin behavior that works every time

Post Title Click Behavior

• Issue: Clicking post titles either did nothing or caused unwanted page scrolling
• Cause: Missing event prevention and conflicting event listeners
• Fix: Added proper preventDefault() and consolidated JavaScript initialization
• Result: Smooth modal opening without any page navigation side effects

JavaScript Event Conflicts

• Issue: Multiple DOMContentLoaded listeners causing timing issues
• Cause: Fragmented JavaScript initialization across different features
• Fix: Consolidated all functionality into single initialization event
• Result: Faster, more reliable feature initialization

🔧 Technical Improvements

Enhanced Event Handling

• Event delegation → Properly handles dynamically created elements
• Conflict prevention → Removed duplicate event listeners
• Better bubbling control → Strategic use of stopPropagation()
• Consolidated initialization → All features initialize together

Improved AJAX Implementation

• Secure nonce verification → Proper WordPress security for post content requests
• Error handling → User-friendly error messages for failed requests
• Content processing → Full WordPress content filter application
• Performance optimization → Efficient post content delivery

Better CSS Architecture

• Modal styling → Professional overlay design with proper z-indexing
• Mobile responsiveness → Optimized for all screen sizes
• Visual consistency → Matches WordPress admin design patterns
• Accessibility → Proper focus management and keyboard navigation

🎮 User Experience Enhancements

Post Preview Modal

Click post title → Modal opens with:
├── Header: Post title + × close button
├── Metadata: Date, author, status info  
└── Content: Full formatted post content (scrollable)

Close via:
├── × button in header
├── Click outside modal
└── Press Escape key

EXIF Popup Interaction

Hover image → EXIF popup appears
Click image → Popup locks open (stays visible)
Click same image again → Popup unlocks (back to hover mode)
Click different image → Pin moves to new image
Click elsewhere → All pins removed

🔄 Migration Notes

This is a fully backward-compatible update:

• ✅ All existing shortcodes work unchanged
• ✅ No database modifications required
• ✅ All previous functionality preserved
• ✅ Settings and configurations remain intact

📋 Usage Examples

Basic Usage (No Changes)

[media_image_list]
[media_image_list size="large" per_page="50"]

New Workflow

1. Browse images using any size setting
2. Click post titles to preview content inline
3. Click images to pin EXIF data for comparison
4. Edit categories using the existing inline editor
5. Navigate efficiently without losing your place

🧪 Testing Recommendations

After upgrading to v1.6.2, please test:

Post Preview Feature

• Click various post titles to open modal previews
• Test with draft, published, and private posts
• Verify modal closes via ×, overlay click, and Escape key
• Check mobile/tablet responsiveness
• Confirm no page scrolling when opening modals

EXIF Popup Improvements

• Click images to pin/unpin EXIF popups
• Verify hover behavior when not pinned
• Test clicking between different images
• Confirm clicking outside closes pinned popups

General Functionality

• Verify category editing still works
• Test image sizing options (thumbnail, small, large)
• Check pagination and search functionality
• Confirm AJAX saving works properly

🚨 Known Issues & Workarounds

Post Content with Complex Shortcodes

• Some shortcodes may not render perfectly in the modal
• Workaround: Content still displays, shortcodes show as processed text

Very Large Posts

• Posts with thousands of words load fine but may take a moment
• Improvement: Consider breaking very long posts into smaller sections

🔮 What's Coming Next

• Custom taxonomy support for category editing
• Bulk operations for multiple images
• Enhanced keyboard navigation throughout the interface
• Export functionality with EXIF data inclusion

📞 Support & Feedback

Reporting Issues

Please include:

• WordPress version
• Browser and device type
• Screenshots of any problems
• Console errors (F12 → Console tab)
• Specific steps to reproduce

Feature Requests

We'd love to hear about:

• Workflow improvements you need
• Integration requests
• UI/UX suggestions

🙏 Thank You

Special thanks to users who reported:

• The EXIF popup clicking issues
• Requests for inline post preview functionality

Your feedback drives these improvements!

---

Download: ap-media-image-list.php
Documentation: README.md
Previous Release: v1.6.1 Release Notes
License: MIT © AlwaysPhotographing

Media-Image-List v1.6.1

Release Notes - AP Media Image List v1.6.1

Release Date: October 11, 2025
Type: Image Display Enhancement
Compatibility: WordPress 5.9+ | PHP 7.4+

🖼️ What's New

Enhanced Image Sizing System

We've completely redesigned how images are displayed to give you precise control over image presentation:

• Three distinct sizing modes with proper aspect ratio maintenance
• No more image elongation - all images display correctly regardless of their original dimensions
• Smart column width adjustment - layout adapts automatically to the selected size
• Improved CSS specificity - overrides WordPress inline styles that were causing sizing issues

✨ Image Size Options

🔲 Thumbnail Mode (size="thumbnail")

• Display: 140×140px cropped square
• Behavior: Crops images to fill the entire square area
• Perfect for: Consistent grid layouts, catalog browsing
• Result: Uniform appearance across all images

📐 Small Mode (size="small" or size="medium")

• Display: 140×140px contained
• Behavior: Complete image fits within bounds, maintains aspect ratio
• Perfect for: Compact viewing while seeing the entire image
• Result: Full image visibility in minimal space

🔍 Large Mode (size="large" or size="full")

• Display: 300×300px contained
• Behavior: Complete image fits within bounds, maintains aspect ratio
• Perfect for: Detailed examination and quality assessment
• Result: Clear, detailed view for photo editing decisions

🔧 Technical Improvements

Fixed Image Distortion Issues

• Before: Images could appear elongated when using non-thumbnail sizes
• After: All images maintain proper aspect ratios regardless of size setting
• Solution: Proper CSS constraints with object-fit and !important declarations

Dynamic Layout Adjustment

• Thumbnail/Small: 190px column width for compact layout
• Large: 320px column width to accommodate larger images
• Responsive: Layout adjusts automatically based on your size selection

Enhanced CSS Specificity

• Added !important declarations to override WordPress inline styles
• Prevents WordPress from adding conflicting width/height attributes
• Ensures consistent sizing across all WordPress themes

🔄 Migration Notes

This is a fully backward-compatible update:

• ✅ All existing shortcodes continue to work unchanged
• ✅ No database modifications required
• ✅ All EXIF, category editing, and AJAX functionality preserved
• ✅ Existing size attribute values work better than before

📋 Usage Examples

// Uniform grid with cropped squares
[media_image_list size="thumbnail"]

// Compact view showing complete images  
[media_image_list size="small"]

// Detailed view for photo review
[media_image_list size="large"]

// Combined with other options
[media_image_list size="large" per_page="25" orderby="date"]

🎯 Who Benefits Most

• Photographers - Better image quality assessment with proper aspect ratios
• Content managers - Flexible viewing options for different workflows
• Anyone frustrated with elongated images - Complete fix for distortion issues
• Mobile users - Improved responsive behavior across all sizes

🐛 Bug Fixes

Image Elongation (Critical Fix)

• Issue: Images appeared stretched when using medium, large, or full sizes
• Cause: WordPress inline styles overriding CSS constraints
• Fix: Enhanced CSS specificity with proper object-fit constraints

Inconsistent Sizing

• Issue: Images didn't respect maximum dimensions properly
• Fix: Added !important declarations and proper container constraints

🧪 Testing Recommendations

After upgrading, please test:

• Try all three size modes: thumbnail, small, large
• Verify images maintain proper aspect ratios
• Check that no images appear elongated or distorted
• Test with various image orientations (portrait, landscape, square)
• Confirm EXIF popups still work with all sizes
• Verify category editing functionality remains intact

📊 Performance Impact

• Minimal: Only CSS changes, no JavaScript modifications
• Improved: Better CSS specificity reduces style calculation overhead
• Responsive: Dynamic column widths provide better mobile performance

🔮 Coming Next

• Custom taxonomy support for category editing
• Bulk category operations across multiple images
• Enhanced keyboard navigation for accessibility
• CSV export with EXIF data

💡 Tips for Best Results

For Catalog Browsing

Use size="thumbnail" for consistent, uniform grid appearance

For Content Review

Use size="small" to see complete images while maintaining compact layout

For Photo Editing Decisions

Use size="large" for detailed quality assessment and composition review

📞 Support

If you experience any sizing issues:

1. Clear any page caches after updating
2. Check browser developer tools for CSS conflicts
3. Report issues with your WordPress theme name and version
4. Include screenshots showing the problem

🙏 Thank You

Thanks to users who reported the image elongation issues! This fix ensures the plugin works perfectly regardless of your image dimensions or WordPress theme.

---

Download: ap-media-image-list.php
Documentation: README.md
License: MIT © AlwaysPhotographing

Media-Image-List v1.6.0

Release Notes - AP Media Image List v1.6.0

Release Date: October 11, 2025
Type: Major UI Enhancement
Compatibility: WordPress 5.9+ | PHP 7.4+

🎉 What's New

Compact 2-Column Layout

We've completely redesigned the interface for a cleaner, more efficient user experience:

• Removed the third column - no more wide tables taking up screen space
• Inline category editor - the editor now appears directly within the second column
• "Edit Categories" button - click to show/hide the category editor on demand
• Automatic updates - category display refreshes immediately after saving

✨ Key Improvements

📱 Better Mobile Experience

• Reduced table width makes the plugin much more mobile-friendly
• No horizontal scrolling on smaller screens
• Cleaner interface works better on tablets and phones

🎯 Improved User Experience

• One editor at a time - opening a new editor automatically closes others
• Visual feedback - button text changes to "Hide Editor" when editor is visible
• Seamless interaction - categories update in real-time without page refresh
• Space efficient - more content visible on screen at once

🔧 Technical Enhancements

• Streamlined HTML structure with fewer DOM elements
• Optimized CSS for better performance
• Enhanced JavaScript for smoother interactions
• Maintained all existing functionality while improving the interface

🔄 Migration Notes

This is a non-breaking update - all existing shortcodes and functionality remain the same:

• [media_image_list] continues to work exactly as before
• All shortcode attributes remain unchanged
• EXIF popups, search, and AJAX saving work identically
• User permissions and security remain the same

📸 Before & After

Before (v1.5.4)

• 3-column layout: Image | Post & Categories | Edit Categories
• Category editor always visible in third column
• Wide table requiring horizontal scrolling on smaller screens

After (v1.6.0)

• 2-column layout: Image | Post & Categories (with inline editor)
• Category editor appears on demand via "Edit Categories" button
• Compact design that works well on all screen sizes

🚀 Installation

New Installation

1. Download ap-media-image-list.php
2. Place in /wp-content/plugins/ap-media-image-list/
3. Activate from WordPress admin
4. Add [media_image_list] to any page

Upgrade from Previous Version

1. Replace the existing ap-media-image-list.php file
2. No database changes required
3. Clear any page caches if using caching plugins

🎯 Who Benefits Most

• Mobile users - Much better experience on phones and tablets
• Content managers - Cleaner interface for managing large media libraries
• Site administrators - Reduced screen real estate usage
• Anyone using the plugin on smaller screens - No more horizontal scrolling

🔍 Testing Recommendations

After upgrading, please test:

• Click "Edit Categories" button to show/hide editor
• Save categories and verify display updates automatically
• Test on mobile devices for improved responsiveness
• Verify only one editor opens at a time
• Confirm all existing functionality still works

📋 Full Changelog

Added

• "Edit Categories" button in second column
• Inline category editor with show/hide functionality
• Automatic category display updates after saving
• CSS styles for compact button and hidden editor states

Changed

• Converted from 3-column to 2-column table layout
• Integrated category editor into second column
• Improved mobile responsiveness
• Enhanced JavaScript for editor toggle functionality

Removed

• Third column from table structure
• Always-visible category editor
• Wide table layout requirements

🐛 Bug Fixes

• Maintained all existing AJAX functionality
• Preserved EXIF popup behavior
• Kept search and filtering capabilities intact
• Retained user permission checks

🔮 Coming Next

• Custom taxonomy support
• Bulk category operations
• Enhanced keyboard navigation
• Export functionality

📞 Support

Having issues? Please report them with:

• WordPress version
• Browser and device type
• Screenshots of any problems
• Console errors (if any)

🙏 Thank You

Thanks to all users who requested a more compact interface! This update makes the plugin much more versatile across different screen sizes and use cases.

---

Download: ap-media-image-list.php
Documentation: README.md
License: MIT © AlwaysPhotographing

Media-Image-List v1.5.4

Release v1.5.4 - AJAX Save & EXIF Metadata

Major Improvements

This release transforms the plugin into a professional batch-editing tool with two game-changing features:

🚀 AJAX Category Saving

• No more page reloads! Save categories and stay exactly where you are in the list
• Perfect for batch editing workflows—no more losing your place after each save
• Real-time feedback: "Saving..." → "Saved!" appears right next to the button
• Dramatically improves efficiency when categorizing large numbers of images

📸 EXIF Metadata Display

• View complete camera metadata for every image without leaving the page
• Extracted from original uploaded files (not WordPress thumbnails)
• Displays: Camera make/model, lens info, exposure settings (focal length, aperture, shutter speed, ISO), capture date, GPS coordinates (if available), and original filename
• Interactive popups: Hover to view, click to "pin" (stays open), click elsewhere to close
• Optional raw JSON view for debugging (metadata_display="json")

What This Means for Users

Before v1.5.4: Editing categories meant clicking "Save Categories" → entire page reloads → scroll back down to find where you left off → repeat for every image. Painful for batch work.

After v1.5.4: Click "Save Categories" → instant feedback → stay right where you are → move to next image. Combined with EXIF data at your fingertips, you can now efficiently categorize hundreds of images based on camera settings, location, or capture date.

Technical Details

• Switched from form POST with redirect to AJAX endpoint using fetch() API
• Added wp_ajax_ap_mit_save_categories handler with proper nonce validation
• EXIF extraction uses wp_read_image_metadata() with fallback to exif_read_data()
• Removed conflicting init hook that was causing HTML output in AJAX responses
• Added clickable/pinnable popup UI with JavaScript event handlers

New Shortcode Attribute

• metadata_display - Set to "basic" (default, human-readable) or "json" (raw EXIF array)

Files Changed

• ap-media-image-list.php - Complete rewrite of save mechanism, added EXIF extraction logic, enhanced JavaScript
• README.md - Comprehensive documentation update

Upgrade Notes

• Breaking change: Removed non-AJAX save handler. If you had custom code hooking into the old init handler, you'll need to update it.
• No database changes required
• Fully backward compatible with existing shortcodes

---

Full Changelog: See README.md

Download: [ap-media-image-list.php](link-to-file)

Media-Image-List v1.5.3

Added show_editor when fause will remove the category edit column for inventory printing

Category Image Gallery v1.5.2

Features

Displays every image in the Media Library (paginated)
Shows draft/private parent posts too

• Inline category editor with:
  • Search box + clear “×”
  • Tri‑state parents (indeterminate when some children selected)
  • No auto‑select of parent when selecting a child
  • Native tooltips on hover for long names
  • Non‑wrapping labels with ellipsis
  • Root categories have no left indent
  • Stable width while filtering (scrollbar-gutter: stable)
• Capability-aware (respects taxonomy assign_terms and edit_post)

• Minimal CSS, inherits WP font sizes (uses --wp--preset--font-size--small)
• No admin pages—just drop in the shortcode on any page