Update changelog for v3.0 release

Author: danielgoulyk

CHANGELOG.md

@@ -1,17 +1,41 @@
 # Changelog
 
-## [2.0] - 2025-05-20
-### Added
-- Admin UI for selecting ACF source page
-- Auto-detect ACF fields from selected page
-- Input field to define custom shortcode names per ACF field
-- Copy-to-clipboard button for shortcodes
+All notable changes to this project will be documented in this file.
 
-### Changed
-- Refactored code to support dynamic shortcode registration
-- Improved fallback message if value is missing
+---
+
+## [3.0] - 2025-05-20 
+### Added  
+- Editable ACF field values directly from the plugin interface  
+- Sync mechanism to update ACF fields on the selected page  
+- Admin notice prompting users to clear their cache manually after saving  
+- Hyperlink to ACF field group settings when no custom fields are found  
+
+### Changed  
+- UI refinements and help text updates for clarity  
+- Improved shortcode copy button reliability  
+- Enhanced shortcode handling to avoid wrapping values in unnecessary characters  
+
+### Fixed  
+- Bug where changes made to values in the plugin did not reflect on the front-end  
+- Shortcode names not persisting on save  
+- Shortcode fallback logic now consistently returns a clean message when fields are undefined  
+
+---
+
+## [2.0] - 2025-05-20  
+### Added  
+- Admin UI for selecting ACF source page  
+- Auto-detect ACF fields from selected page  
+- Input field to define custom shortcode names per ACF field  
+- Copy-to-clipboard button for shortcodes  
+
+### Changed  
+- Refactored code to support dynamic shortcode registration  
+- Improved fallback message if value is missing  
 
 ---
 
-## [1.0] - 2025-05-20
-- Initial plugin release with hardcoded shortcodes and ACF option page usage
+## [1.0] - 2025-05-20  
+### Added  
+- Initial plugin release with hardcoded shortcodes and ACF option page usage  

README.md

@@ -1,9 +1,54 @@
 # ACF Dynamic Shortcodes
 
-This WordPress plugin lets you dynamically register shortcodes for ACF fields attached to a specific page. No coding required.
+**ACF Dynamic Shortcodes** is a lightweight WordPress plugin that lets you dynamically register shortcodes for [Advanced Custom Fields (ACF)](https://www.advancedcustomfields.com/) attached to a specific page — without writing a single line of code.
 
-## Features
+> ⚡ Perfect for custom pricing pages, dynamic content blocks, and personalised shortcodes mapped to ACF fields.
 
-- Admin settings panel for mapping shortcode names to ACF fields
-- Supports automatic `$` prefix and fallback to "Enquire for pricing"
-- Works with ACF Free
+---
+
+## 🚀 Features
+
+- 🔧 Admin settings panel to select an ACF source page
+- 🧩 Auto-detects ACF fields from the selected page
+- 🔗 Create custom shortcode names for each field
+- 📋 Copy-to-clipboard buttons for easy reuse
+- 📝 Editable value overrides directly from the plugin UI
+- 🪄 Syncs edited values back to the ACF field itself
+- 💬 Fallback message when value is missing
+- ✅ Works with both ACF Free and Pro
+
+---
+
+## 📦 Example Usage
+
+If you have a custom field called `starting_price`, and you assign it a shortcode like:
+
+[price]
+
+You can then use that shortcode anywhere on your WordPress site — pages, posts, or builders — and it will automatically output the ACF field value from your selected source page.
+
+---
+
+## ⚠️ Caching Notice
+
+If you're using a caching plugin (like **LiteSpeed Cache**, **WP Rocket**, or **W3 Total Cache**), please remember to **clear your site cache** after saving changes in this plugin to see them reflected on the frontend.
+
+---
+
+## 🛠 Requirements
+
+- WordPress 5.0+
+- ACF Free or Pro
+- PHP 7.2+
+
+---
+
+## 📄 License
+
+This plugin is open-sourced and licensed under the MIT License.
+
+---
+
+## ✨ Author
+
+**Daniel Goulyk** – [danielgoulyk.com](https://danielgoulyk.com)