# Random Image Block - Feature Roadmap

This document tracks planned features for future releases.

---

## Free Version Enhancements

### 1. Link Options
- [x] Link to attachment page
- [x] Link to custom URL
- [ ] Lightbox/Modal integration
- [x] Open in new tab option

### 2. Image Shuffle Animation
- [x] Fade transition
- [x] Slide transition
- [x] Zoom transition
- [x] Transition duration control

### 3. Auto-refresh Interval
- [x] Auto-rotate images every X seconds
- [x] Enable/disable toggle
- [x] Custom time interval (seconds)

### 4. Image Filters (CSS)
- [x] Grayscale
- [x] Blur
- [x] Brightness
- [x] Contrast
- [x] Saturation
- [x] Hue Rotate

### 5. Random Seed/Sticky Mode
- [x] Keep same random image for session duration
- [x] Cookie-based persistence (using Local Storage)
- [x] Local storage option

---

## Pro Version Features

### 1. Advanced Lightbox
- [ ] Full-featured lightbox integration
- [ ] Zoom functionality
- [ ] Fullscreen mode
- [ ] Caption display in lightbox
- [ ] Keyboard navigation

### 2. Image Background Mode
- [ ] Use as section background
- [ ] Overlay controls (color, opacity)
- [ ] Parallax effect option

### 3. Lazy Loading
- [ ] Intersection observer implementation
- [ ] Loading spinner
- [ ] Fade-in animation on load

### 4. Custom Image Ordering
- [ ] Weighted random (some images appear more often)
- [ ] Priority/weight control per image
- [ ] Exclude certain images from random pool

### 5. Image Categories/Tags
- [ ] Filter random images by taxonomy
- [ ] Multiple category selection
- [ ] Tag filtering support

### 6. Gallery Sync
- [ ] Pull images from existing WordPress galleries
- [ ] Sync with gallery blocks
- [ ] Dynamic gallery integration

### 7. Image Hover Effects
- [ ] Zoom on hover
- [ ] Pan effect
- [ ] Rotate on hover
- [ ] Scale transformation
- [ ] Opacity change

### 8. Caption Styling
- [ ] Background color control
- [ ] Background opacity
- [ ] Caption typography options
- [ ] Caption padding (responsive)
- [ ] Caption border radius

### 9. Image Border Radius
- [ ] Rounded corners support
- [ ] Responsive border radius
- [ ] Full circle option

### 10. Conditional Display
- [ ] Show different images based on user role
- [ ] Time-based display
- [ ] Date-based display
- [ ] Seasonal images

---

## Version Planning

| Version | Features | Status |
|---------|----------|--------|
| 1.0.6 | Link Options, Image Filters | Planned |
| 1.1.0 | Auto-refresh, Animations | Planned |
| 1.2.0 | Advanced Lightbox | Planned |
| 1.3.0 | Image Background Mode | Planned |
| 1.4.0 | Lazy Loading | Planned |
| 1.5.0 | Hover Effects | Planned |
| 2.0.0 | Conditional Display, Weighted Random | Planned |

---

## Notes

- Features marked with `[ ]` are not yet implemented
- Features can be moved between Free/Pro versions as needed
- This list can be updated based on user feedback and priorities
- Some Pro features may be released as individual updates