REDSHAPE Easy Labels

Changelog

1.5.1

• Improvement: Settings page (Tools > Easy Labels) now always renders in the WordPress site language — the plugin_language option now controls only the operational interface (content labels, filter bar, notes, modals, dashboard widgets)
• Fix: Removed redundant switch_to_locale() call in prepare_view_data() — post-type names on the settings page now correctly follow the WordPress site locale
• Improvement: Updated Language tab description and i18n strings to accurately reflect the new two-locale behaviour (settings = WP locale, operational UI = plugin language)
• UI: Several layout and visual improvements to the settings page — all main tab containers (support, backup, language, permissions, post-types) set to full-width layout; post-types grid updated to a 3-column layout; intro card headers and descriptions standardised for consistent two-line appearance across all tabs
• UI: Label and widget editor cards are now collapsible — each card has a toggle arrow button next to the delete button; existing cards load collapsed by default, newly created cards start open
• UI: Post-type badges now appear to the right of the coloured label badge in the collapsed label card header, showing which content types the label is assigned to; badges update dynamically when checkboxes are changed
• UI: Widget editor card collapsed header now shows the configured content type and visualization type as info badges; badges update dynamically when the respective selects are changed
• UX: Clicking anywhere on the label or widget card header bar now toggles the collapsed state (the arrow button still works as before); cursor: pointer added to header bars for clarity
• UI: All card/section hover effects across the settings page now use a consistent style — base border standardised to 1px solid #c3c4c7 and hover border to 1px solid #2271b1 with box-shadow: 0 4px 12px rgba(0,0,0,0.08); removed transform: translateY animations and non-standard border thicknesses/colours from post-type cards, language cards, support cards and setting sections
• Fix: Extended phpcs:disable/enable block in redshape-easy-labels.php to correctly suppress NonceVerification.Recommended across the multi-line $is_settings_page expression (reading-only $_GET['page'] to determine admin context)
• Fix: Renamed template variables in admin-page.php to use the $redshape_easylabels_ plugin prefix, resolving PrefixAllGlobals PHPCS warnings
• Improvement: Labels created via the quick-create modal (from post list or meta box) are now automatically configured to be visible only on the current content type (post type), instead of all types; the modal info text updated accordingly
• Version bump: 1.5.0 → 1.5.1

1.5.0

• Maintenance: Full sync with WordPress.org SVN repository — all plugin files correctly added and distributed
• Version bump: 1.4.4 → 1.5.0

1.4.4

• Maintenance: Full sync with WordPress.org repository — no code changes, version bump to ensure all files are correctly distributed
• Version bump: 1.4.3 → 1.4.4

1.4.3

• Fix: Fatal “Class not found” error when plugin is loaded with missing files after a partial deploy — the previous fix (1.4.2) placed the file check inside class-redshape-easylabels.php which caused an early return that left Redshape_Easylabels undefined, then plugins_loaded still tried to instantiate it and crashed; check is now in the main entry file redshape-easy-labels.php so if any file is missing the plugins_loaded hook is never registered — WordPress shows a clear admin notice listing the missing files
• Version bump: 1.4.2 → 1.4.3

1.4.2

• Fix: Fatal error on activation when any core class file is missing from a partial deploy (class-redshape-easylabels-helpers.php, etc.) — class-redshape-easylabels.php now checks all 10 required files with file_exists() before loading them; if any are missing a clear admin notice lists them and the plugin exits cleanly instead of crashing WordPress
• Fix: PHPCS NonPrefixedVariableFound warning — removed global variable $_redshape_easylabels_lang_gen in redshape-easy-labels.php, replaced with an inline file_exists() call
• Version bump: 1.4.1 → 1.4.2

1.4.1

• Fix: Fatal error on activation/update when class-redshape-easylabels-language-generator.php was missing from a partial deploy — require_once is now conditional on file_exists(); all call-sites guarded with class_exists('Redshape_Easylabels_Language_Generator')
• Fix: Data loss after saving settings — save_settings() accessed $current_options['default_labels'] and $current_options['role_settings'] without isset; on PHP 8 a missing key returns null, causing update_option to overwrite labels and widgets with null/empty values; replaced with defensive isset reads and added automatic migration from the legacy labels key to default_labels
• Fix: Post type selector in “Add New Label” showed only post and page — enqueue_settings_page_scripts() read $settings['role_settings']['enabled_post_types'] which is always null because get_settings() flattens role_settings keys to root level; corrected to read $settings['enabled_post_types'] directly
• Fix: Dropdown close in post editor / Gutenberg — replaced jQuery $(document).on('click') bubbling (ineffective inside Gutenberg’s iframe) and capture-phase attempt with a transparent full-screen backdrop div (z-index 99998) that intercepts any click outside the dropdown; added centralised closeAllDropdowns() helper used by all 8 close paths
• Fix: Missing 'Label name is required' translation key in 8 non-Italian locales (fr_FR, de_DE, es_ES, ru_RU, zh_CN, ja_JP, ko_KR, hi_IN) — JS validation error was always displayed in English regardless of plugin language setting
• New: Added “Check for updates” link in the plugin description row on the Plugins page — clicking it triggers a WordPress update check (update-core.php?force-check=1) without leaving the admin
• Version bump: 1.4.0 → 1.4.1

1.4.0

• Code: Refactored monolithic God Object (class-redshape-easylabels.php, 4619 lines) into 8 focused single-responsibility classes — Redshape_Easylabels_Helpers (static shared utilities), Redshape_Easylabels_Admin_Columns, Redshape_Easylabels_Bulk_Actions, Redshape_Easylabels_Filter_Bar, Redshape_Easylabels_Meta_Box, Redshape_Easylabels_Ajax, Redshape_Easylabels_Dashboard_Widget, Redshape_Easylabels_Settings
• Code: Main Redshape_Easylabels class is now a lean coordinator that instantiates sub-classes and wires up shared hooks
• Fix: Corrected hardcoded Italian strings in admin.js (Clicca per rimuovere, Aggiungi etichetta, Errore critico. Ricarica la pagina., Errore di elaborazione risposta) — all now routed through the __() JS helper using English keys; translations added for all 10 supported languages
• Improvement: Migrated translation system from hardcoded PHP arrays to standard WordPress .po/.mo files — now fully compatible with Loco Translate, GlotPress, WPML, and WP-CLI i18n tools
• New: Added Redshape_Easylabels_Language_Generator class that builds .po and .mo files from the existing translation data (pure PHP, no external dependencies)
• New: Added bin/generate-languages.php CLI script to regenerate all language files from the command line during development
• New: load_textdomain() now loads the correct .mo based on the per-plugin language setting (plugin_language option), independently of the WordPress site locale
• New: Language files are automatically regenerated on plugin activation and lazily on first use if missing
• Code: Removed dead-code duplicate class-redshape-easylabels-content-i18n.php (\~2300 lines, \~70% identical to the main i18n class, never loaded, using a stale option key content_labels_options)
• Improvement: Migrated label storage from a single serialized array (_content_labels) to one post-meta row per label (_content_label) — meta queries now use exact-match = instead of LIKE '%...%', enabling MySQL index usage
• New: maybe_upgrade_storage() one-time migration function converts existing data transparently on first admin load after update
• New: Added get_post_label_ids() and set_post_label_ids() private helpers to centralise all label read/write operations
• Fix: All filter_posts_by_label(), add_quick_filter_bar(), and counter queries updated to use the new storage format
• Fix: Cache class (Redshape_Easylabels_Cache) updated to use the new meta key and exact-match queries
• Fix: uninstall.php now cleans up both _content_label (new) and _content_labels (legacy) meta keys
• Code: Separated logic from template in admin-page.php — all DB reads, locale switching, wp_localize_script, and static data arrays extracted into a new prepare_view_data() private method in Redshape_Easylabels_Settings; the template is now pure display HTML/PHP with no business logic
• Fix: Eliminated duplicate column hook registrations — only manage_{$pt}_posts_columns / manage_{$pt}_posts_custom_column are now registered (fires for all post types); the redundant manage_{$pt}s_columns / manage_{$pt}s_custom_column hooks that caused double-fire on built-in types have been removed, along with the workaround guards they required
• Performance: Replaced per-label COUNT queries with a single GROUP BY meta_value query in Redshape_Easylabels_Helpers::get_label_counts_for_post_type() — used by both the AJAX filter-count endpoint and the dashboard widget renderer; eliminates the N-query loop that previously ran one SELECT COUNT(DISTINCT) per label; no maybe_unserialize() needed since _content_label stores flat string values
• Code: Extracted ~65 lines of inline JS (bulk label selector) from a PHP string with manual \' escaping into a proper file assets/js/admin-bulk-actions.js; translated alert strings passed via wp_localize_script as redshapeEasylabelsBulk.i18n
• Fix: redshape_easylabels_cl_e() docblock now explicitly states it strips HTML; added companion redshape_easylabels_cl_html_e() that passes the translated string through wp_kses() with a minimal inline-tag allowlist (strong, em, code, span, br, a) so legitimate markup in translations is preserved instead of silently entity-encoded
• Fix: Redshape_Easylabels_Cache::invalidate_all() — replaced the version-number trick (broken without persistent object cache: each PHP process starts with empty memory, so the counter was never shared between requests) with wp_cache_flush_group() (WP 6.1+ / Redis / Memcached) plus a per-label fallback for standard setups; also removed the cache_version lookup from generate_cache_key() which added an extra wp_cache_get() on every cache read/write
• Fix: initializeInlineLabels() in admin.js — replaced setTimeout retry polling (two blind delays of 300–500 ms) with a MutationObserver that watches document.body and fires exactly once when .wp-list-table .row-title appears, then disconnects; eliminates missed renders and unnecessary CPU wake-ups
• Fix: redshape_easylabels_deactivate() was empty; now calls Redshape_Easylabels_Cache::invalidate_all() on deactivation so stale label counts don’t persist in Redis / Memcached between sessions
• Fix: get_cache_stats() was reading from the wrong option key (labels instead of default_labels) — always returned total_labels: 0; removed stale cache_version entry from the returned array (that key was deleted earlier in 1.4.0); loop now uses the associative key as label ID instead of $label['id']
• Fix: ajax_add_label_to_post() now validates that the requested label ID exists in the plugin configuration before writing to post meta, preventing arbitrary strings from being stored via AJAX by any user with edit_post capability
• Fix: get_all_post_labels() SQL query fetched all _content_label rows across the entire database with no post-type filter; query now JOINs wp_posts and filters by post_type, significantly reducing data volume on multi-post-type sites
• Fix: Two hardcoded Italian __() keys ('Il nome dell\'etichetta è obbligatorio') in the Quick Create Label handlers in admin.js replaced with the existing English key 'Label name is required' so all 10 locales translate correctly
• Fix: DOMNodeInserted event (deprecated, removed in Chrome 124+) replaced with a MutationObserver that watches for new .content-label-badge elements and adds the draggable class on insertion
• Fix: initializeDragAndDrop() and initFilterDragAndDrop() were started via 4 chained setTimeout calls (500 ms, 800 ms, 1500 ms, 3000 ms + $(window).on('load')); replaced with a single $(window).on('load') for the sortable initializer and a MutationObserver for the filter container — eliminates blind waits and missed renders
• Code: Corrected @since 1.4.1 tag to @since 1.4.0 in all 9 class file docblocks (coordinator, helpers, ajax, settings, admin-columns, bulk-actions, filter-bar, meta-box, dashboard-widget)
• Code: Removed redundant !defined('ABSPATH') guard in uninstall.php — WordPress defines ABSPATH and WP_UNINSTALL_PLUGIN simultaneously; the second check was unreachable dead code
• Version bump: 1.3.0 → 1.4.0

1.3.0

• Maintenance: Version bump to 1.3.0
• Compatibility: Tested up to WordPress 6.9
• New: Multi-select filters now support AND/OR relation modes
• Enhancement: Quick filters now apply instantly via AJAX (no Apply button)
• Fix: Removed duplicated uninstall cleanup blocks (cache/meta/transient)
• Fix: Aligned cache post type source with role_settings[enabled_post_types] and backward-compatible fallback
• Fix: Removed duplicate initializeLabelEvents() call in admin JavaScript

1.2.0

• New: Multi-Select Filter Mode – Toggle between single and multiple label selection in quick filters
• New: Multi-select mode uses AND logic – filter posts that have ALL selected labels together
• New: Apply button for multi-select – apply multiple label filters at once
• New: Visual selection indicators – green checkmarks on selected labels in multi-select mode
• New: State persistence – multi-select mode and selections maintained via URL parameters
• New: Dashboard Widgets – Create unlimited custom widgets with 5 visualization types
• New: Pie Chart visualization with interactive legend and click-to-filter functionality
• New: Donut Chart visualization with center stats display
• New: Bar Chart with horizontal/vertical orientation and multiple display modes (percentage, numeric, both)
• New: List visualization with clickable items for content filtering
• New: Stats Cards showing key metrics with click-to-filter (max 3 per row for optimal layout)
• New: Drag & Drop Label Ordering – Customize label sequence in each widget independently
• New: Click-to-Filter – Click any chart segment, bar, list item, or stat card to filter content by that label
• New: Widget Configuration – Select post type, visualization type, labels, and display options per widget
• New: “No Label” Support – Include posts without labels in widgets with custom positioning in sort order
• Enhancement: Bar charts display proportional heights based on total count with accurate pixel scaling
• Enhancement: Bar charts include left-side scale for easy value reading
• Enhancement: All default label names (including “No Label”) now use customized names from settings
• Enhancement: Widgets Settings tab with intuitive drag & drop interface for label reordering
• Enhancement: Debug mode – Console logs now only active when WP_DEBUG is enabled
• Enhancement: WordPress Coding Standards compliance for all variable naming conventions
• Fix: Label order now properly saved and persisted across page reloads
• Fix: Sortable list visibility maintained after save operations
• Fix: “No Label” positioning now respects custom order in all chart types
• Fix: Focus outlines removed from interactive chart elements for cleaner UI
• Fix: Stats cards layout limited to 3 per row for better visual balance
• Enhancement: Multi-select toggle hides “All” badge when active
• Enhancement: Toggle and Apply button only show when labels exist
• Enhancement: Vertical separators between quick filter sections for better visual organization
• Enhancement: Multi-select mode translations for all 10 supported languages

1.1.0

• New: Quick Create Label – Create new labels directly from content editor without going to settings
• New: Universal modal for label creation works in both post list and meta box
• New: Quick Create button always visible, even when no labels exist yet
• New: Post type names translation – Post types (Posts, Pages, Products, etc.) now display in plugin’s language for all 10 supported languages
• Enhancement: Streamlined workflow for content organization
• Enhancement: Auto-assign option when creating labels from content
• Enhancement: Improved multilingual support with custom post type name mapping
• Enhancement: Direct database queries for real-time counters to ensure accuracy on production sites
• Enhancement: Debounced counter updates to prevent multiple simultaneous requests
• Fix: Post type names now consistent with plugin language settings in all admin pages
• Fix: Real-time counter accuracy on live sites with persistent cache systems (Redis, Memcached)
• Fix: Counter increments now properly synchronized across multiple UI contexts (table, inline, metabox)
• Fix: Dropdown state properly restored after closing Quick Create modal without creating label
• Fix: PHPCS compliance for intentional direct database queries in counter calculations

1.0.1

• Fix: Added index.php files to all directories to prevent directory listing on misconfigured servers
• Fix: Replaced wp_redirect() with wp_safe_redirect() for enhanced security
• Fix: Added plugin prefix to all global variables in admin-page.php and uninstall.php to comply with WordPress Coding Standards
• Fix: Renamed helper functions cl__() and cl_e() to redshape_easylabels_cl__() and redshape_easylabels_cl_e() for proper namespacing
• Fix: Bulk action “Apply label” now correctly applies labels to selected posts
• Fix: Metabox label display – labels now show correctly with name and color immediately after assignment
• Fix: Metabox label removal – resolved permission errors when removing labels without page refresh
• Fix: Dropdown refresh – label dropdown now correctly updates after adding or removing labels in metabox
• Fix: Notes auto-save – each note field now has independent timeout to prevent data loss when editing multiple notes
• Fix: Notes persistence – all pending notes are now saved before page unload to prevent loss of unsaved changes
• Security: Enhanced directory protection following WordPress.org best practices

1.0.0

• First public release
• Colored labels system with automatic key generation from label name
• Customizable default labels (“All” and “No Label”)
• Custom borders for labels (5 styles: solid, dashed, dotted, double, none)
• Search field in label popup for quick label finding
• Drag & drop to reorder filters
• Real-time counts without page refresh
• Internal notes for content
• Quick filters and search
• Backup & Restore: export/import settings in JSON
• Multi-language support (10 languages: IT, EN, FR, DE, ES, RU, ZH, JA, KO, HI)
• Optimized cache system
• Granular permission management
• Custom Post Types support
• System tab with plugin information
• Smart label filtering: dropdown shows only unassigned labels
• Improved popup positioning without visual jumps
• WordPress.org compliance: all inline scripts/styles converted to wp_enqueue
• Code comments translated to English for international standards