=== Quantira Featured Image ===
Contributors: quantiratechnologies
Donate link: https://quantiratechnologies.com
Tags: featured image, post thumbnail, custom post type, thumbnail, image
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically display featured images on single posts, pages, and custom post types. Configurable from Appearance → Quantira Featured Image.

== Description ==

**Quantira Featured Image** is a lightweight plugin by [Quantira Technologies](https://quantiratechnologies.com) that automatically shows the featured image at the top (or bottom) of single posts, pages, and custom post types — no theme editing required.

Many WordPress themes hide or inconsistently display featured images across posts and custom post types, forcing users into complicated theme edits. Quantira Featured Image solves this instantly with a simple, friendly settings screen so anyone can control how featured images appear.

= Key Features =

* Works out of the box on posts, pages, and any public custom post type
* Enables featured image support automatically for all public post types
* Choose which post types display the featured image
* Position the image above or below the content
* Select any registered image size (thumbnail, medium, large, full, custom)
* Left, center, or right alignment
* Max-width control
* Optionally link the image to the full-size version
* Optionally show the image caption
* Responsive by default
* Fully translation-ready
* Clean uninstall — removes its options when deleted
* Developer filter: `qfi_allowed_post_types`

= Where are the settings? =

After activation, go to **Appearance → Quantira Featured Image** in your WordPress dashboard.

= Who is it for? =

Site owners, bloggers, and developers using themes that don't display featured images automatically — or those who want more control over where and how the image appears.

== Installation ==

1. Upload the `qt-featured-image` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress **Plugins → Add New** screen.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Appearance → Quantira Featured Image** to configure options.
4. Set a featured image on any post, page, or custom post type — it will appear automatically.

== Frequently Asked Questions ==

= Where do I configure the plugin? =

Go to **Appearance → Quantira Featured Image** in your WordPress admin.

= The featured image is not showing. Why? =

Please check the following:
1. A featured image is actually set on the post.
2. The current post type is enabled in the plugin settings.
3. Your theme uses `the_content()` on single templates (most themes do).
4. No other plugin or theme is removing filters on `the_content`.

= Does it work with custom post types? =

Yes. The plugin auto-detects all public custom post types and lets you enable them from the settings page.

= Can I limit which post types display the featured image via code? =

Yes. Use the `qfi_allowed_post_types` filter:

`add_filter( 'qfi_allowed_post_types', function( $types ) {
    return array( 'post', 'product', 'portfolio' );
});`

= Is it translation ready? =

Yes. The text domain is `qt-featured-image` and the plugin is fully internationalized.

= Does it slow down my site? =

No. The plugin runs a single lightweight filter on singular views only, with no external requests.

== Screenshots ==

1. Settings page under Appearance → Quantira Featured Image.
2. Featured image displayed automatically on a single post.
3. Options for position, alignment, and image size.

== Changelog ==

= 1.1.0 =
* Added settings page under **Appearance → Quantira Featured Image**.
* Added options: enable/disable, per-post-type selection, position (above/below), image size, alignment, max width, link to full image, show caption.
* Added "Settings" link on the Plugins list.
* Added `uninstall.php` for clean removal.
* Improved sanitization and escaping.
* Added translation support.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.1.0 =
Adds a full settings page under Appearance → Quantira Featured Image with position, size, alignment, and per-post-type controls. Recommended upgrade.

= 1.0.0 =
Initial release.

== License ==

This plugin is licensed under the GNU General Public License v2 or later.
See https://www.gnu.org/licenses/gpl-2.0.html

== Credits ==

Developed and maintained by [Quantira Technologies](https://quantiratechnologies.com).
