=== Current Post Shortcode ===
Contributors: mdforiduddin
Tags: current post, shortcode, post title, post meta, custom field
Requires at least: 6.7
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 3.1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The Current Post Shortcode plugin allows you to display the current post's title and metadata using simple shortcodes.

== Description ==

The "Current Post Shortcode" plugin allows you to display post titles and custom field values using simple shortcodes. You can display the current post's title or meta information, or specify a post ID to retrieve data from a specific post.

= Display Current Post Title and Meta Information: =
- **Post Title:** `[current_post]`  → Outputs the current post title, e.g., "Hello World"
- **Post Meta** (Custom Field): `[current_post meta="custom_field"]`  → Outputs the value of the custom field

= Display Data from a Specific Post ID: =
- **Post Title:** `[current_post id="123"]`  → Outputs the title of the post with ID "123"
- **Post Meta** (Custom Field): `[current_post id="123" meta="custom_field"]`  → Outputs the value of the custom field in the post with ID "123"

= Display Fallback Meta Value: =

`[current_post meta="custom_field" default="Default Value"]`  → Displays "Default Value" if the custom field is empty

= Display Default Value for Zero Meta Value: =

`[current_post meta="custom_field" default="Default Value" skip="true"]`  → Displays "Default Value" if the custom field value is zero

== Installation ==

= From your WordPress dashboard: =

- Go to Plugins > Add New.
- Search for 'Current Post Shortcode'.
- Click "Install Now", then "Activate Plugin".

 = Or **install it manually**: =

- Download the plugin ZIP file from [WordPress Directory](https://wordpress.org/plugins/current-post-shortcode/).
- Log in to your WordPress Dashboard, navigate to Plugins > Add New, and click the "Upload Plugin" button.
- Choose the plugin ZIP file and click "Install Now".
- After installation, click "Activate Plugin".

== Frequently Asked Questions ==

= How do I use the shortcodes? =

- Use `[current_post]` to display the title of the current post.
- Use `[current_post meta="custom_field"]` to display a custom field value.
- To display data from a specific post, use the `id` attribute.

= Can I use this shortcode in widgets or other areas of the site? =

Yes, you can use these shortcodes anywhere shortcodes are supported in WordPress, such as posts, pages, widgets, Gutenberg blocks, and page builders like Elementor, Divi, WPBakery, etc.

= How do I handle empty or zero meta values? =

You can use the `skip` attribute to skip empty or zero values and optionally display a default value.

= Is there a fallback for meta values? =

Yes, you can use the `default` attribute to provide a fallback value for empty meta values.

== Changelog ==

= 3.1.0 - 14/01/2026 =

* Added Shortcode functionality for displaying current post information.
* Added support for displaying meta values with fallback options.

= 3.0.0 - 13/01/2026 =

* Improved shortcode functionality to support additional attributes.
* Enhanced compatibility with the latest WordPress versions.
* Added fallback meta value for better user experience.

= 1.0.0 - 11/03/2025 =

* Initial release of the plugin.