=== Teaser Post Title ===
Contributors: tulipwork
Donate link: https://paypal.me/ziyadbachalany
Tags: headlines, SEO, clickbait, engagement, titles
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.0
Stable tag: 3.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

🌟 Skyrocket clicks with irresistible homepage headlines while keeping SEO intact!

== Description ==

🌟 **Teaser Post Title** (formerly WP Alternative Post Title) supercharges your WordPress site by letting you create **two powerful titles** for every post: a primary title—your default WordPress title, displayed on single post pages and kept unchanged for SEO and social sharing—and a **teaser title** designed to grab attention on your homepage.

**Boost click-through rates, captivate readers, and keep search engines happy—all with one easy-to-use plugin!**

In today’s digital world, headlines make or break engagement. Readers scroll fast, only clicking what sparks their curiosity. **Teaser Title** solves this by letting you craft **click-worthy teaser titles** for your homepage while preserving **SEO-friendly primary titles** for single posts, search engines, and social media. No more choosing between creativity and optimization—get both!

*Perfect for bloggers, marketers, businesses, and content creators who want to stand out!*

= Why Choose Teaser Post Title? =
- **Maximize Clicks**: Hook readers with compelling teaser titles that drive homepage engagement.
- **Protect SEO**: Keep primary titles keyword-focused for search engines and social shares.
- **Super Simple**: Add teaser titles in seconds via a metabox in the post editor.
- **Elementor Ready**: Seamless integration with Elementor’s "Posts" and "Post Title" widgets.
- **Free & Pro Options**: Start with powerful free features, and add Teaser Post Title Pro for more control.

**2025 Update**: Revamped branding, enhanced compatibility, and new Pro features to make your headlines unstoppable! Fully optimized for modern WordPress sites.

= Free Features =
- **Dual Titles**: Set a primary title for single posts and a teaser title for the homepage.
- **SEO Safe**: Primary titles stay intact for search engines and social media.
- **Easy Metabox**: Add teaser titles directly in the WordPress post editor.
- **Elementor Compatible**: Works perfectly with Elementor’s "Posts" and "Post Title" widgets.
- **Block Themes Ready**: Works with the Post Title block of full site editing themes.
- **Built-in Translations**: Includes English and French, with support for WPML, Polylang, Loco Translate, and more.
- **Lightweight & Fast**: Minimal impact on site speed for a smooth experience.

Craft teaser titles that hook readers without touching your primary titles. 🚀

= Premium Features (Pro Version) =
🌟 **Teaser Post Title Pro** is a separate add-on available at [tulipemedia.com](https://tulipemedia.com/en/product/alternative-post-title-wordpress-premium/) for game-changing headline tools:
- **Custom Display Locations**: Show teaser titles on category, tag, author, and archive pages.
- **AI-Powered Suggestions**: Generate creative titles instantly with the Gemini API.

**Ready to transform your headlines? Get Pro now at [tulipemedia.com!](https://tulipemedia.com/en/product/alternative-post-title-wordpress-premium/) 🌟**

= Who’s This For? =
- **Bloggers** looking to hook readers with irresistible headlines.
- **Marketers** aiming to boost click-through rates without harming SEO.
- **Content Creators** crafting engaging posts for homepage and social media.
- **Businesses** wanting a simple way to optimize headlines for engagement.
- **Elementor Users** seeking seamless integration with their page builder.

== Contribute ==
- 🌐 **Translate**: Make Teaser Post Title global! Contribute translations at [WordPress Translate](https://translate.wordpress.org/projects/wp-plugins/wp-alternative-post-title/).
- **Donate**: Fuel development with a coffee! ☕ [Donate now](https://paypal.me/ziyadbachalany).
- **Rate Us**: Love Teaser Post Title? Share a 5-star review on [WordPress.org](https://wordpress.org/support/plugin/wp-alternative-post-title/reviews/#new-post) to spread the word.
- **Follow Us**: Stay updated on [Instagram](https://instagram.com/ziyadbachalany/), [LinkedIn](https://www.linkedin.com/in/ziyadbachalany/), [X](https://x.com/ziyadbachalany), [Facebook](https://www.facebook.com/ziyadbachalany), or [YouTube](https://www.youtube.com/channel/UClMfre0hj-UCxGocDleZxTQ).

== Installation ==
1. Upload the `wp-alternative-post-title` folder to `/wp-content/plugins/` or install via the WordPress Plugins dashboard.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Edit or create a post, and add a teaser title in the **Teaser Post Title** metabox below the editor.
4. For Pro features, get Teaser Post Title Pro at [tulipemedia.com](https://tulipemedia.com/en/product/alternative-post-title-wordpress-premium/), install it next to this plugin, then enter your license key in **Settings > Teaser Post Title > License**.

== Frequently Asked Questions ==

= Where do teaser titles appear? =
In the free version, teaser titles display on the homepage only. The **Pro version** lets you show them on category, tag, archive, and other listing pages.

= Will this affect my SEO? =
No! Primary titles remain unchanged for search engines and social media, while teaser titles boost homepage clicks.

= Does it work with Elementor? =
Yes! Teaser Post Title integrates seamlessly with Elementor’s "Posts" and "Post Title" widgets.

= How do I get Pro features? =
1. Get Teaser Post Title Pro at [tulipemedia.com](https://tulipemedia.com/en/product/alternative-post-title-wordpress-premium/).
2. Install and activate it next to this plugin (both must stay active).
3. Enter your license key in **Settings > Teaser Post Title > License**, then configure locations and AI suggestions.

= I was using the premium features before version 3.0. What changed? =
Premium features are now in the separate Teaser Post Title Pro add-on, included with your existing license. Download it from your account on tulipemedia.com and install it: your license key, display locations and Gemini API key are kept.

= What happens when I uninstall the plugin? =
Teaser titles will no longer appear, and primary titles will be used everywhere.

= How do I translate the plugin? =
Use WPML, Polylang, or Loco Translate for custom translations. For WPML:
2. Go to **WPML > String Translation**.
3. Search for strings (e.g., "Teaser Title") or filter by domain `wp-alternative-post-title`.
4. Add translations and save.

== Screenshots ==
1. Homepage showcasing captivating teaser titles in action.
2. Teaser Post Title metabox in the post editor for easy title creation.
3. AI-powered title suggestions for creative headlines (Pro feature).
4. Pro settings page for customizing title display locations.

== Changelog ==
= 3.1 - 2026-10-03 =
* **Improved**: Consistent wording: the post editor box and settings now say "Teaser Title" (in French: "Titre d'accroche"). Existing teaser titles are kept.

= 3.0 - 2026-10-03 =
* **New**: Premium features (more display locations, AI title suggestions) moved to the separate Teaser Post Title Pro add-on, as required by WordPress.org guidelines. Existing premium users: download it from your account, your settings are kept.
* **Fixed**: Alternative titles could empty the title of Elementor heading widgets and of the Post Title block instead of replacing it.
* **Fixed**: Removed code that marked free WooCommerce orders as completed on sites using WooCommerce.
* **Improved**: Lighter and faster code: no more license checks or output buffering in the free plugin.
* **Improved**: Tested up to WordPress 7.1.

= 2.6 =
* Minor bug fixes.

= 2.5 =
* Minor bug fixes and performance optimizations.

= 2.4 =
* **New**: Reintroduced the_title filter for maximum compatibility.
* **Improved**: Enhanced Elementor compatibility with elementor/widget/render_content filter.
* **Fixed**: Minor UI bugs in the metabox for better usability.
* **New**: Renamed plugin to Teaser Post Title for clarity and improved branding.

= 2.3 =
* Minor bug fixes and performance optimizations.

= 2.2 =
* **New**: Added license validation for enhanced security.
* **Improved**: Optimized metabox rendering for faster editing.

= 2.1 =
* **New**: AJAX-based license validation with real-time feedback.
* **Fixed**: License validation bugs from version 2.0.
* **Improved**: Smoother user experience for premium features.

= 2.0 =
* **New**: Premium features including custom title locations and AI title suggestions via Gemini API.
* **Improved**: Enhanced Elementor compatibility and performance.
* **Updated**: Full multilingual support with translations.

= 1.0 =
* Removed legacy "wp-multiple-titles.php" file.
* Addressed WordPress.org review feedback.

= 0.2 =
* Updated WordPress compatibility requirements.

= 0.1 =
* Initial release with basic dual-title functionality.

== Upgrade Notice ==
= 3.1 =
Consistent "Teaser Title" wording in the editor and settings. No action needed.

= 3.0 =
Premium features move to the separate Teaser Post Title Pro add-on (included with existing licenses). Fixes Elementor and block theme titles.

= 2.6 =
* Minor bug fixes.

= 2.5 =
Minor bug fixes and performance optimizations.

= 2.4 =
Upgrade for improved Elementor compatibility and smoother title management. Don’t miss the latest engagement tools!

== Credits ==
Developed with ❤️ by [Ziyad Bachalany](https://tulipemedia.com). Built on modern WordPress standards for maximum compatibility.

== Support ==
Need help? Visit our [support page](https://tulipemedia.com/en/product/alternative-post-title-wordpress-premium/) for documentation, FAQs, and contact options. Get **Teaser Post Title Pro** at [tulipemedia.com](https://tulipemedia.com/en/product/alternative-post-title-wordpress-premium/) for priority support.

== License ==
This plugin is licensed under GPLv2 or later.