Advanced Gallery & Repeater Fields for ACF

<?php
// Auto-renders based on field settings
the_field('my_gallery');
?>

<?php
// Manual rendering with full control
echo agrfuxd_render_enhanced_gallery('gallery_field', get_the_ID());
echo agrfuxd_render_enhanced_repeater('repeater_field', get_the_ID());
?>

:root {
    --agrfuxd-columns: 4;
    --agrfuxd-gap: 20px;
    --agrfuxd-primary: #0073aa;
    --agrfuxd-radius: 10px;
}

:root {
    /* Layout */
    --agrfuxd-columns: 3;
    --agrfuxd-gap: 20px;

    /* Colors */
    --agrfuxd-primary: #2271b1;
    --agrfuxd-text: #1e1e1e;
    --agrfuxd-border: #ddd;
    --agrfuxd-bg: #f9f9f9;

    /* Design */
    --agrfuxd-radius: 8px;
    --agrfuxd-shadow: 0 2px 8px rgba(0,0,0,0.1);

    /* Transitions */
    --agrfuxd-transition: 0.3s ease;
}

سجل التغييرات

2.0.1 – 2026-01-04

Code Refactoring & WordPress.org Compliance

• REFACTORED: Changed plugin acronym from ACFGRA to AGRFUXD across entire codebase
• RENAMED: All ACF/acf prefixed identifiers to AGRF/agrf to avoid common word prefix issue
• RENAMED: Field class files from class-acf-field-enhanced-* to class-agrf-field-enhanced-*
• UPDATED: All CSS classes, JavaScript references, and PHP function names
• UPDATED: Shortcode from [acfgra_gallery] to [agrfuxd_gallery]
• UPDATED: CSS custom properties from --acfgra-* to --agrfuxd-*
• FIXED: Installation folder path in readme.txt to match plugin slug

2.0.0 – 2025-12-30

** WordPress.org Text Domain Compliance**

• CRITICAL: Changed text domain from acf-gallery-repeater-addon to advanced-gallery-repeater-fields-for-acf to match plugin slug
• UPDATED: All 150+ translation strings across all files to use correct text domain
• COMPLIANCE: Plugin now fully compliant with WordPress.org text domain requirements
• IMPORTANT: If you have custom translations, you’ll need to update your .po/.mo files to use the new text domain

1.9.9 – 2025-12-28

** Code Organization & Refactoring**

• REFACTORED: Main plugin file – separated code into logical files
• CREATED: /admin/settings-page.php – Settings page template file
• CREATED: /includes/helper-functions.php – Shortcodes and helper functions
• CREATED: /includes/wpallimport-integration.php – WP All Import compatibility
• CREATED: /includes/elementor-integration.php – Elementor compatibility
• IMPROVED: Main plugin file reduced by ~450 lines for better maintainability
• IMPROVED: Better code organization following WordPress best practices
• IMPROVED: Easier to navigate and maintain codebase
• PERFORMANCE: No functional changes – purely organizational improvements

1.9.8 – 2025-11-15

** WordPress.org Full Compliance**

• FIXED: Text domain mismatches – changed ‘acf’ to ‘acf-gallery-repeater-addon’ in all translation strings
• ADDED: Translator comments for all strings with placeholders
• FIXED: Ordered placeholders – changed %s to %1$s, %2$s for proper translation
• ADDED: phpcs:ignore comments for ACF’s escaping functions (acf_esc_attrs, acf_esc_atts)
• CREATED: Languages folder for translation files
• REMOVED: load_plugin_textdomain() – WordPress.org handles translations automatically
• ADDED: phpcs:ignore comment for nonce verification (admin asset loading)
• IMPROVED: Full WordPress Coding Standards compliance

1.9.7 – 2025-10-15

** Lightbox Improvements**

• FIXED: Lightbox loader now hidden by default (only shows when loading images)
• FIXED: Thumbnail section now fixed at bottom – prevents moving down during navigation
• ADDED: Thumbnail click functionality – click any thumbnail to jump to that image
• ADDED: Active thumbnail highlighting during navigation
• IMPROVED: Removed all error_log() calls for WordPress.org compliance
• IMPROVED: Fixed escape output warnings – all variables properly escaped
• UPDATED: Changed “Tested up to” from 6.9.0 to 6.9 for WordPress.org requirements

1.9.6 – 2025-07-15

** Lightbox Navigation Fix**

• FIXED: Lightbox thumbnails moving below screen when navigating between images
• FIXED: Screen freeze when closing lightbox after using prev/next navigation
• IMPROVED: Only save scroll position on initial lightbox open, not during navigation
• IMPROVED: Better body style management during lightbox image transitions

1.9.5 – 2025-01-15

** Carousel & Lightbox Fixes**

• FIXED: Lightbox not showing – changed class from ‘active’ to ‘is-open’ to match CSS
• FIXED: Screen freeze on Escape key press – added proper keyboard event handling
• CHANGED: Carousel height now uses exact height instead of minimum height
• IMPROVED: Images in carousel now properly constrain to configured height using object-fit
• IMPROVED: Better image loading indication with fade-in effect in lightbox
• IMPROVED: Keyboard navigation now includes keyCode fallback for better browser compatibility

1.9.4 – 2025-01-15

** Carousel Height Control & Lightbox Fix**

• ADDED: Carousel height option in field settings (100-1000px with 50px steps)
• FIXED: Lightbox trigger positioning issue in carousel layout
• IMPROVED: Carousel now uses configured height as fallback instead of hardcoded 400px
• IMPROVED: Better CSS specificity for carousel lightbox triggers

1.9.3 – 2025-01-15

** Settings & Carousel Improvements**

• REMOVED: Repeater shortcode (use ACF’s standard have_rows() and the_row() functions instead)
• IMPROVED: Settings page now only in Settings menu with plugin action link
• ADDED: Comprehensive gallery layouts documentation (Grid, Masonry, Carousel, Justified)
• FIXED: Carousel/slider image loading and display issues
• IMPROVED: Better image height calculation for carousel with fallback minimum height
• IMPROVED: Settings page now shows detailed information about each gallery layout
• ADDED: “Settings” link in plugins page for easy access

1.9.2 – 2025-01-15

** Elementor Integration Fix**

• FIXED: Elementor lightbox conflict – plugin’s lightbox now works correctly in Elementor templates
• FIXED: Scroll freeze issue when closing lightbox in Elementor pages
• IMPROVED: Added data-elementor-open-lightbox="no" attribute to all gallery lightbox triggers
• IMPROVED: Better event propagation control to prevent Elementor from intercepting clicks
• IMPROVED: Proper scroll position restoration when closing lightbox

1.9.1 – 2025-01-15

** STABLE RELEASE – Repeater Field Perfected!**

• CRITICAL FIX: Resolved white screen issue caused by infinite recursion
• MAJOR REFACTOR: Simplified repeater to work WITH ACF’s architecture instead of against it
• CODE REDUCTION: 500% simpler – reduced from 300+ lines to ~40 lines of code
• PERFORMANCE: Dramatically improved reliability and compatibility
• WORKING: Data now saves and loads correctly using ACF’s built-in repeater logic
• TESTED: Fully functional with add/edit/delete/reorder operations
• COMPATIBLE: Works exactly like ACF Pro’s repeater field
• DEVELOPER: Let ACF handle storage/loading automatically (no manual meta key management)

1.8.5 – 2025-01-14

• Fixed: Critical bug where old row count was fetched after updating
• Fixed: Old rows now properly deleted when row count decreases
• Improved: Comprehensive debugging added to trace data flow
• Updated: Better logging for troubleshooting save/load issues

1.8.4 – 2025-01-14

• Added: Comprehensive debugging to track repeater data save/load
• Fixed: Bug in delete_value method using wrong field property
• Improved: Enhanced error logging for troubleshooting

1.8.3 – 2025-01-13

• Fixed: Carousel height inconsistencies with equal height function
• Fixed: Carousel smooth sliding with improved CSS transitions
• Improved: Better carousel performance with hardware acceleration
• Updated: Modern settings page with gradient design and copy buttons

1.2.0 – 2024-12-XX

Major Update: ACF Free Compatibility!

• New: Enhanced Repeater now works with ACF Free! Custom admin interface included
• New: Full repeater functionality without ACF Pro (add, remove, duplicate, reorder rows)
• Improved: Better admin UI with drag-and-drop row reordering
• Improved: Enhanced row actions (duplicate, remove with confirmation)
• Improved: Visual status bar showing row count and limits
• Improved: Clearer field instructions and help text
• Updated: Plugin name to “Advanced Gallery & Repeater Fields for ACF”
• Updated: Author information to UXD Experts
• Updated: Requires Plugins header for better WordPress 6.5+ compatibility
• Fixed: Better value loading and formatting for repeater fields
• Fixed: Improved validation for min/max row limits
• Performance: Optimized admin scripts and styles
• Security: Enhanced sanitization and escaping throughout

1.1.0 – 2024-XX-XX

• Fixed: Gallery “Add Images” button now works correctly with WordPress Media Library
• Added: WP All Import Pro compatibility
• Added: Field type mapping for import/export
• Improved: Better admin interface for gallery field
• Improved: Sortable gallery attachments with drag & drop

1.0.0 – 2024-XX-XX

• Initial release
• Enhanced Gallery field with Grid, Masonry, Carousel, and Justified layouts
• Enhanced Repeater field with List, Grid, Table, Accordion, Tabs, and Timeline layouts
• Built-in lightbox for galleries
• ARIA accessibility support
• Responsive layouts with CSS variables
• Touch and keyboard navigation