=== StellaCodex Post Carousel ===
Contributors: stellacodex, freemius
Tags: post carousel, post slider, related posts, carousel
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Responsive post carousels from posts you pick by hand. Unlimited carousels, drag-to-reorder and full design controls, all free.

== Description ==

StellaCodex Post Carousel lets you select WordPress posts, arrange them visually, and display them with a shortcode.

Free features include unlimited carousels, manual post selection (search, add from a category, add by URL), drag-and-drop ordering, left/right arrow navigation, responsive card counts, and design controls (cards per view, border, corner radius, image ratio, card title and date).

Pro adds automatic sources (latest posts, a category, or a tag), autoplay (one-card and page-by-page) and continuous scrolling, auto-insert of a carousel at the end of post content (all posts or selected categories / tags), and carousel categories for organizing your carousels.

The free version is fully usable without a license and has no carousel-count limit.

== Installation ==

1. Upload the plugin ZIP from Plugins > Add New > Upload Plugin.
2. Activate StellaCodex Post Carousel.
3. Open Post Carousels in the WordPress dashboard.
4. Create a carousel and paste its shortcode into a post or page.

== Frequently Asked Questions ==

= How do I display a carousel? =

Create a carousel under "Post Carousels" in the WordPress dashboard, then copy its shortcode (for example `[stellacodex_carousel id="s1"]`) and paste it into any post or page.

= Can I choose which posts appear? =

Yes. In the free version you select posts manually and drag to reorder them. Pulling posts automatically from the latest posts, a category, or a tag is a Pro feature.

= What is the difference between "Add from a category" and a Pro automatic category source? =

"Add from a category" is a free editing shortcut: it copies the posts that are currently in that WordPress category into your manual list. A Pro automatic category source stays connected to the category and updates the carousel when posts are added later.

= How many carousels can I create in the free version? =

The free version lets you create an unlimited number of carousels.

= Does it work with standard WordPress themes? =

Yes. The carousel uses a shortcode and is designed to work with standard WordPress themes. No coding is required.

= Can I change the heading level or hide the title? =

Yes. The shortcode accepts optional attributes, for example `[stellacodex_carousel id="s1" tag="h3"]` to set the carousel heading level, or `[stellacodex_carousel id="s1" title="hide"]` to hide the heading above the carousel. Card-title visibility is controlled in Settings.

= What does the Pro version add? =

Automatic sources (latest posts, a category, or a tag), autoplay and continuous scrolling, auto-insert at the end of post content (all posts or selected categories / tags), and carousel categories for organizing carousels.

== External services ==

This plugin includes the Freemius SDK for optional usage analytics, Pro licensing, checkout, and Pro updates. Free users can skip the opt-in and continue using the plugin. No usage data is sent before an administrator explicitly opts in. When a user purchases or activates Pro, the plugin communicates with Freemius to provide licensing, payments, and updates.

Freemius terms of service: https://freemius.com/terms/
Freemius privacy policy: https://freemius.com/privacy/

== Screenshots ==

1. A responsive post carousel displayed on the front end.
2. The list of saved carousels in the WordPress dashboard.
3. The carousel editor: selecting and reordering posts.
4. Design settings for the carousels.

== Changelog ==

= 1.0.5 =
* Restored the bundled Japanese translation for both free and premium installations.
* Unified every plugin admin page with the StellaCodex brand header and card-based interface.

= 1.0.4 =
* Renamed the plugin to StellaCodex Post Carousel and updated its WordPress.org slug and text domain.
* Replaced the generic shortcode with `[stellacodex_carousel]`.
* Migrated legacy option data to uniquely prefixed option names without deleting existing data.
* Fixed front-end carousel initialization after the rebrand.

= 1.0.3 =
* Initial submission candidate.
* Unlimited post carousels in the free version, with manual selection (search, add from a category, add by URL), drag-and-drop ordering, left/right arrow navigation, responsive card counts, and design controls (cards per view, border, corner radius, image ratio, card title and date).
* Pro adds automatic sources (latest posts, a category, or a tag), autoplay (one-card and page-by-page) and continuous scrolling, auto-insert at the end of post content (all posts or selected categories / tags), and carousel categories.

== Upgrade Notice ==

= 1.0.5 =
This update restores Japanese translations and refreshes every plugin admin page with the StellaCodex interface.
