=== Tweenix: GSAP Text Animations ===
Contributors: atibshaikh
Donate link: https://atibshaikh.in/
Tags: gsap, text-animation, typography, elementor, divi
Requires at least: 5.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Words that move.

== Description ==

Tweenix lets you apply a curated set of preset text animations to WordPress headings and other selected elements. Choose an effect in the plugin settings and target elements by HTML tag, CSS class, or HTML ID. No code, timeline, keyframe editor, or arbitrary animation-property controls are provided.

The plugin includes 14 preset text effects, plus optional scroll-triggered image reveals. It supports Elementor, Divi, and standard WordPress themes and editors.

== Features ==

* 14 preset text effects:
  * Word Reveal Upwards
  * Words Fade + Slide
  * Line Mask Reveal
  * Scroll Scrub (Words)
  * Scroll Scrub (Letters)
  * Character Spring
  * Typewriter + Cursor
  * Interactive Word Roller
  * Gentle Fade & Blur
  * Motion Blur In
  * 3D Unfold / Flip
  * Matrix Scramble
  * Outline to Solid Fill
  * Marker Highlight Wipe
* Configure effects for H1-H6 headings, paragraphs, spans, and inputs.
* Assign preset effects to custom CSS classes and HTML IDs.
* Class rules take priority over ID rules, which take priority over tag rules.
* Detect Elementor and Divi automatically, or select a builder mode manually.
* Optional image reveals with directional mask or blur-to-clear effects.
* Optional Lenis smooth scrolling, custom effect colors, header/footer exclusions, and reduced-motion support.
* Frontend animation assets are loaded only when the plugin is enabled; image reveal assets are loaded only when that feature is enabled.
* Optional admin subscription popup after saving settings. It appears again after later saves until the admin subscribes.

== GSAP and third-party licensing ==

GSAP is a separate third-party component and is not relicensed by Tweenix as MIT or GPL. GSAP's terms are available at [https://gsap.com/standard-license/](https://gsap.com/standard-license/). The GSAP team confirmed that Tweenix's current curated, preset-based feature set may be used under the GSAP Standard License. That confirmation applies to the product as reviewed; it does not cover a future freeform timeline, keyframe editor, or general-purpose animation builder.

This version loads GSAP Core, ScrollTrigger, and CustomEase from cdnjs (version 3.12.5); these files are not bundled in this plugin ZIP. SplitType is loaded from unpkg, and Lenis is loaded from unpkg only when its optional setting is enabled. Using these external services requires the visitor's browser to be able to access them.

If GSAP files are distributed with a future plugin package, they must remain the official, unmodified files with their copyright notices intact and remain separately covered by the GSAP Standard License. The plugin's GPL license does not change GSAP's license. The GSAP team's confirmation is limited to GSAP's position and does not determine WordPress.org or other third-party license compatibility requirements.

== Email subscription popup ==

After an administrator saves Tweenix settings, the plugin can show an optional popup inviting them to subscribe to occasional updates. The admin must enter an email address and check the consent box. On submission, the address is emailed to the developer at `atib.ahmed.s@gmail.com`; the plugin does not save the address in the WordPress database. The popup is suppressed in that browser for one year after WordPress successfully sends the email. Dismissing it without subscribing does not suppress it after a later settings save.

The popup is disabled by default. To enable it, uncomment `define( 'TWEENIX_GSAP_SUPPORT_POPUP_ENABLED', true );` in the main plugin file. Comment out that line again to disable it. This feature has its own PHP module, stylesheet, and JavaScript file.

== Installation ==

1. Upload the `atib-gsap-animation` folder to `/wp-content/plugins/`, or install the plugin through **Plugins > Add New**.
2. Activate **Tweenix: GSAP Text Animations** through the **Plugins** menu.
3. Open **Tweenix** in the WordPress admin menu.
4. Choose preset effects for the tags you want to animate, or add rules for specific CSS classes and HTML IDs.
5. Optionally configure image reveals and other settings, then save your changes.

== Frequently Asked Questions ==

= Does Tweenix provide a timeline or let me build arbitrary animations? =
No. Tweenix provides a curated selection of preset effects maintained by the plugin. You choose a preset and assign it to supported HTML tags, CSS classes, or IDs; there are no timeline, keyframe, or arbitrary property controls.

= Can I apply different effects to different H1 elements? =
Yes. Add a custom class or ID rule in **Custom Classes & IDs** and select its preset effect. Class rules take priority over ID rules, and both take priority over tag-level settings.

= Does Tweenix work with Elementor and Divi? =
Tweenix detects Elementor and Divi automatically. You can also choose a builder mode manually in **Page Builders & Config**.

= Does Tweenix require an internet connection? =
This version loads GSAP and supporting third-party scripts from public CDNs. Visitors' browsers need access to those CDN hosts for the related animations to run.

= Does Tweenix respect reduced-motion preferences? =
Yes. Enable the reduced-motion option to disable animations for visitors whose operating system or browser requests reduced motion.

== Changelog ==

= 1.2.3 =
* Show the directional reveal origin setting only when the directional reveal effect is selected.

= 1.2.4 =
* Add an optional admin subscription popup after saving settings.
