=== Dynamic Tags for Elementor ===
Contributors: nisan92, tawsif
Tags: elementor, dynamic-tags, acf, woocommerce, wpml
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Supercharge Elementor Free with 100+ custom dynamic tags. Unlocks WooCommerce, ACF, SCF, and advanced system metrics in Elementor.

== Description ==

**Dynamic Tags for Elementor** is the ultimate dynamic content toolkit. It enables **100+ custom dynamic tags** in Elementor Free, organized into purpose-built groups. When upgraded to Pro, it unlocks **149+ additional premium tags** across Post Pro, Media Pro, Author Pro, Site Pro, WooCommerce Pro, ACF Pro, and SCF Pro.

Our advanced caching system with request-scoped memoization for repeated field lookups and product queries, and transient-based admin caching with smart invalidation, delivers faster page rendering and reduced database queries.

= Features =
* **Post & Archive** — Post title, date, content, categories, comments, excerpt, terms, parent, archive titles, and descriptions.
* **Site & Media** — Site title, URL, tagline, logo, icon, featured images, and galleries.
* **Author & User** — Author details, bio, profile pictures, user roles, capabilities, and profile metrics.
* **Actions & Comments** — Dynamic links for lightboxes, off-canvas, reload, and comment forms.
* **WooCommerce** — Product price, SKU, stock status, categories, and reviews.
* **ACF & SCF Parity** — 13 custom field tags supporting repeaters, galleries, relationships, date-time, maps, and option pages.
* **Pro Version (Upgrade)** — Unlocks 149+ premium tags including WooCommerce Pro (34 tags), ACF Pro (34 tags), SCF Pro (34 tags), and the newly categorized WordPress Pro suite: Post Pro (16 tags), Media Pro (6 tags), Author Pro (12 tags), and Site Pro (13 tags).

Use for dynamic text, URLs, images, and conditional outputs in any Elementor Free widget.

== Video Tutorial ==

Watch this quick overview video to see how Dynamic Tags for Elementor works in action:

https://www.youtube.com/watch?v=9rvMCf-gUFE

== Installation ==

1. Upload plugin files to `/wp-content/plugins/dynamic-tags-for-elementor`.
2. Activate via Plugins menu.
3. Open Elementor editor → click Dynamic Tags icon on any supported field → choose a tag.

For quick tag discovery, go to **WP Admin → Dynamic Tags → Tag Directory**.

== Frequently Asked Questions ==

= Does this require Elementor Pro? =
No. This plugin works exclusively with Elementor Free. All dynamic tags are designed for Elementor Free and do not require a Pro license.

= Will this conflict with Elementor Pro tags? =
No. DTE tags are registered in separate groups and coexist peacefully with Elementor Pro tags. If you later upgrade to Pro, both tag sets remain available.

= Which custom fields and third-party plugins are supported? =
DTE supports:
* **WooCommerce** (Product price, SKU, stock status, categories, ratings, add-to-cart URLs).
* **ACF (Advanced Custom Fields)** (13 tags including repeaters, galleries, relationships, true/false, taxonomy terms, dates).
* **SCF (Secure Custom Fields)** (13 tags with feature parity to ACF).
* **WPML & Polylang** (Automatic language-aware URL filtering).

= Can I use these tags in all Elementor widgets? =
Most widgets with text, URL, or image fields support dynamic tags (indicated by the small Dynamic Tag icon next to the field).

= How do I find a specific tag quickly? =
Go to **WP Admin → Dynamic Tags → Tag Directory** to view a searchable list of all tags grouped by category with descriptions.

= Can I register custom dynamic tags? =
Yes. DTE provides filters and action hooks for third-party developers, including `dynatafo_dynamic_tag_groups` and `dynatafo_register_dynamic_tags`.

== Dependencies ==

* **Required**: Elementor
* **Optional**: Advanced Custom Fields (ACF), Secure Custom Fields (SCF), WooCommerce, WPML, Polylang

== Changelog ==

= 1.3.1 =
* UX Updated: Improved admin review notice layout and removed shown count statistics.
* Security Updated: Hardened and secured outputs within admin messages.
* Pro Updated: Added full compatibility and alignment for the new Taxonomy Pro suite.

= 1.3.0 =
* Fixed: Escaped output in the admin review notice for improved security.
* Fixed: Resolved PHP Coding Standards (WPCS/PHPCS) translation warnings by adding translators comments and reordering/formatting placeholders.

= 1.2.9 =
* Added: Inline warning and notice when installed Pro plugin version is newer than the Free version.
* Added: Support for new Post Pro category.
* Added: Post Reading Time tag that will help to display the reading time of a post.
* Added: Related Posts Count tag that will help to count the number of posts matching the current post's category or tag taxonomy.
* Added: Next Post Title tag that will help to display the title of the next post in sequence.
* Added: Previous Post Title tag that will help to display the title of the previous post in sequence.
* Added: Next Post URL tag that will help to display the permalink URL of the next post in sequence.
* Added: Previous Post URL tag that will help to display the permalink URL of the previous post in sequence.
* Added: Next Post Thumbnail URL tag that will help to display the featured image URL of the next post.
* Added: Previous Post Thumbnail URL tag that will help to display the featured image URL of the previous post.
* Added: Post Word Count tag that will help to display the exact word count of the current post content.
* Added: Post Character Count tag that will help to display the character count of the current post content.
* Added: Post Revision Count tag that will help to display the total number of saved revisions for the current post.
* Added: Post Sticky Status tag that will help to check if the post is set as sticky.
* Added: Post Password Protected tag that will help to check if the post is password protected.
* Added: Post Menu Order tag that will help to display the menu order value defined for the current page.
* Added: Days Since Post Published tag that will help to calculate the number of days since the current post was published.
* Added: Days Until Event / Date tag that will help to count down the days until a custom target date or meta date field.
* Added: Support for new Media Pro category.
* Added: Post Featured Image Alt Text tag that will help to display the alternative text of the featured image.
* Added: Post Featured Image Caption tag that will help to display the caption of the featured image.
* Added: Post Featured Image Description tag that will help to display the description of the featured image.
* Added: Attachment File Size tag that will help to display the file size of a media attachment file.
* Added: Attachment File Type tag that will help to display the file extension or MIME type of the media attachment.
* Added: Attachment Dimensions tag that will help to display the width and height of the image attachment.
* Added: Support for new Author Pro category.
* Added: Current User First Name tag that will help to display the first name of the currently logged-in user.
* Added: Current User Last Name tag that will help to display the last name of the currently logged-in user.
* Added: Logged In Status tag that will help to check if the visitor is logged in.
* Added: Current User Post Count tag that will help to display the total number of published posts by the logged-in user.
* Added: Current User Comment Count tag that will help to display the total number of comments by the logged-in user.
* Added: Current User Nickname tag that will help to display the nickname of the logged-in user.
* Added: Current User Website URL tag that will help to display the website URL of the logged-in user.
* Added: Current User Description / Bio tag that will help to display the biographical info of the logged-in user.
* Added: Current User Meta (Generic) tag that will help to retrieve custom user meta fields of the logged-in user.
* Added: Author Post Count tag that will help to display the total number of published posts by the post author.
* Added: Author Registration Date tag that will help to display the registration date of the post author.
* Added: Author Social Links tag that will help to display social profile links for the post author.
* Added: Support for new Site Pro category.
* Added: WordPress Version tag that will help to display the current WordPress version string.
* Added: PHP Version tag that will help to display the current PHP version string.
* Added: Site Admin Email tag that will help to display the administrator email address of the site.
* Added: Site Language tag that will help to display the active site locale code.
* Added: Site Charset tag that will help to display the site character set encoding.
* Added: Custom Option Value tag that will help to retrieve any option value from the options table by option name.
* Added: Theme Name tag that will help to display the name of the active theme.
* Added: Theme Version tag that will help to display the version of the active theme.
* Added: Child Theme Name tag that will help to display the active child theme name.
* Added: Active Plugins Count tag that will help to display the total number of active plugins.
* Added: Memory Usage tag that will help to display the PHP memory usage details.
* Added: Server Time Zone tag that will help to display the site's configured timezone setting.
* Added: Site Tagline with Fallback tag that will help to display the site tagline with a fallback option.


== Upgrade Notice ==

= 1.3.1 =
Upgrade to 1.3.1 for UX and security updates, and full alignment with the new Taxonomy Pro suite.

= 1.3.0 =
Upgrade to 1.3.0 for security hardening in admin review notice, and WPCS translation standard enhancements.
