=== AddonLogic CPT Archive Template Helper ===
Contributors: snehalpancholi
Tags: custom post type, archive, taxonomy filter, grid, shortcode
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Shortcode-driven grid archive for any custom post type with taxonomy filter buttons and built-in pagination.

== Description ==

AddonLogic CPT Archive Template Helper renders a responsive card grid of posts from any registered custom post type via the `[addlc_cpt_archive]` shortcode. It supports taxonomy filter buttons (pills), per-post taxonomy tags, featured images with hover zoom, excerpt display, pagination, and fully configurable column counts.

**Key Features:**

* Works with any public custom post type
* Taxonomy filter buttons (show all or filter by any term)
* Responsive grid: 1–6 columns, collapses on mobile
* Featured image with 16:9 aspect ratio + hover scale
* Optional excerpt, date, taxonomy tag chips, and read-more link
* Per-instance URL-based pagination (multiple shortcodes on one page are independent)
* Pure CSS — no JS dependency for core functionality
* No admin configuration needed — all via shortcode attributes

== Installation ==

1. Upload the `cpt-archive-template` folder to `/wp-content/plugins/`
2. Activate through the 'Plugins' menu
3. Add `[addlc_cpt_archive post_type="movie"]` to any post or page

== Shortcode ==

`[addlc_cpt_archive]`

Attributes:
* `post_type` — Post type slug (default: post)
* `taxonomy` — Taxonomy slug for filter and term tags (default: none)
* `term` — Pre-filter to a specific taxonomy term slug
* `posts_per_page` — Items per page (default: 12)
* `columns` — Grid columns 1–6 (default: 3)
* `orderby` — date, title, menu_order, rand, etc. (default: date)
* `order` — ASC or DESC (default: DESC)
* `show_filter` — yes/no show taxonomy filter bar (default: yes)
* `show_thumbnail` — yes/no (default: yes)
* `show_excerpt` — yes/no (default: yes)
* `show_date` — yes/no (default: no)
* `excerpt_length` — word count (default: 20)
* `read_more` — link text (default: Read More)
* `no_posts_text` — text shown when empty (default: No posts found.)
* `instance_id` — unique ID for multiple shortcodes per page

== Changelog ==

= 1.0.0 =
* Initial release

== Screenshots ==

1. Three-column grid archive with taxonomy filter bar
2. Two-column layout on tablet
3. Single-column mobile layout
