=== Postify – Post Grid, Carousel, Timeline & Masonry Layouts ===
Contributors: faysal61, shshakib2001
Tags: post grid, post carousel, post slider, post timeline, post filter
Requires at least: 5.9
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Show your blog posts as a carousel, slider, grid, minimal list, timeline or masonry layout, with live filters, sorting and pagination.

== Description ==

Postify turns your posts into a polished, responsive layout you can place anywhere — no code and no page builder required.

Create a **layout** in the visual editor: pick one of six presets, choose which posts it shows, decide what each card displays, and style every part of it while the live preview updates. Postify gives you a shortcode, a block and an Elementor widget to place it with.

= Six layout presets =

*   **Carousel** — four styles: Standard, Ticker (continuous scroll), Center and Multi Row
*   **Slider** — one post at a time, with slide, fade, coverflow, cube and flip transitions
*   **Grid** — responsive columns at five screen widths
*   **Minimal List** — a compact list, with the image on the left or right
*   **Timeline** — vertical (five styles, with optional month separators) or horizontal (three styles)
*   **Masonry** — posts of different heights packed together without cropping

Every layout can use the **Custom** template, built from reorderable content fields, or one of the **pre-made templates** (three for the grid family, four for Minimal List).

= Choose exactly which posts appear =

*   Latest posts, sticky (featured) posts, or posts you pick by hand
*   Include or exclude specific posts, the current post and password-protected posts
*   Sticky posts in their normal place, pinned to the top, or hidden
*   Filter by category and tag (match any, all or none), keyword, publish timeframe, month, year, a specific date, year or period
*   Hide posts without a featured image
*   Order by date, modified date, title, slug, ID, comment count, menu order or random
*   Limit the number of posts

= Live filters, search and pagination =

*   Ajax live filters by category, tag, timeframe, month and year — as buttons, a dropdown, radio buttons or checkboxes, with post counts
*   Live keyword search, a reset button and a show/hide filter toggle
*   Pagination as Load More, Ajax page numbers, infinite scroll or classic page numbers, with a separate choice for mobile

= Every detail is adjustable =

*   Card border, radius, box shadow, padding, background and hover background
*   Thumbnail size and hard or soft crop, retina images, zoom and grayscale effects, lazy loading, and first-image/video/audio fallback
*   Title tag and length, meta fields (author with avatar, date or "time ago", categories or tags, comment count, reading time) with icons and separators
*   Excerpt, trimmed content or full content; Read More as a button or text link
*   Social share buttons for 13 networks
*   Custom fields from ACF, Pods, Toolset or plain post meta
*   Open posts on their page, in a new tab, in a popup (with next/previous), at a custom-field URL, or not at all
*   Typography for the section title, title, meta, content, Read More and custom fields — including Google Fonts and separate tablet and mobile sizes
*   Carousel controls: autoplay, speed, loop, direction, rows, slides to scroll, nine arrow positions, seven arrow styles, dots or numbers, touch, mouse drag, mouse wheel and keyboard navigation

= Built for real sites =

*   Global Color Scheme, Custom CSS and Custom JavaScript, and accessibility labels for the carousel
*   Export and import layouts and settings
*   SEO schema markup (an ItemList of BlogPosting) for each layout
*   Assets load only on pages that show a layout
*   Translation ready; every template can be overridden from your theme

== Installation ==

1. Upload the `postify` folder to `/wp-content/plugins/`, or install Postify from **Plugins → Add New**.
2. Activate the plugin.
3. Go to **Postify → Add New Layout**, choose a preset and save.
4. Paste the layout's shortcode — for example `[postify id="123"]` — into any post, page or widget, or add the **Postify** block or Elementor widget.

== Frequently Asked Questions ==

= I used Postify 1.x. Will my shortcodes keep working? =

Yes. Shortcodes you added with Postify 1.x, such as `[postify layout="carousel" theme="2"]`, keep working with every attribute they had, and nothing in your posts is changed. Postify 1.x stored no settings in the database, so there is nothing to migrate. Create a layout in the new editor whenever you want the new options.

= Which posts can Postify show? =

Standard WordPress posts, with their categories, tags, authors and dates.

= Can I use more than one layout on a page? =

Yes. Each layout keeps its own filters and pagination.

= Can I change the templates? =

Copy any file from `postify/src/Frontend/templates/` to `your-theme/postify/templates/`, keeping its folder structure, and edit the copy.

= What happens to my layouts if I delete the plugin? =

They are kept, so reinstalling brings them back. To remove everything instead, tick **Settings → Advanced → Delete All Data On Uninstall** before deleting the plugin.

= Why can't I save Custom JavaScript? =

Custom JavaScript runs for every visitor, so it can only be changed by users who are allowed to post unfiltered HTML — normally administrators.

== Screenshots ==

1. Post grid with live category filter buttons, using pre-made Template One: date badge and category on the image, author and reading time, a three-line excerpt, Read More and the comment count.
2. Post carousel with navigation arrows and dots, using Template Two: a date band across the image, the category as an accent label and an arrow Read More link.
3. Post slider: one large post at a time with the title, meta and excerpt over the image (Overlay content position).
4. Overlay grid: post text on top of the image with a readable gradient, in a custom template.
5. Grid with Template Three: a rounded date badge overlapping the image, with the category and author beside it and a solid button.
6. Masonry layout: cards at their natural heights, packed into columns.
7. Vertical timeline with a month separator, posts alternating either side of the line.
8. Horizontal timeline that scrolls sideways with arrows.
9. Minimal List, Template Four: an index table of category, title, one-line excerpt, date, reading time and Read More.
10. Minimal List, Template One: a date strip, thumbnail, category, author and title — ideal for sidebars and "latest posts" boxes.
11. The layout editor: name the layout, pick one of six layout presets, and copy its shortcode.
12. Template Styles: choose Custom or Pre-made, pick a template from its preview, and set its colours, alignment, image size and excerpt length.
13. Live preview: see the layout update as you edit, at desktop, tablet and phone widths, before you publish.
14. Filtering: keyword search and advanced filters by category, tag, timeframe, month or year, shown to visitors as buttons, a dropdown, radio buttons or checkboxes.
15. Carousel controls: Standard, Ticker, Center and Multi Row styles, slides to scroll, autoplay, speed, loop, navigation and pagination.
16. Typography: font family, style, transform, alignment, size and line height for desktop, tablet and mobile, with colours.
17. Built-in Help: a searchable manual covering every setting, with troubleshooting steps.
18. All Layouts: every saved layout with its shortcode, preset and status.

== Changelog ==

= 2.1.0 – 16 November 2026 =
A design and polish release. Every layout and pre-made template was reviewed and refined, settings are easier to find, and Postify now has a built-in manual. Your saved layouts and 1.x shortcodes keep working; no settings are renamed or migrated.
* New: built-in, searchable Help manual covering every setting, with a troubleshooting checklist. It works offline and replaces the external documentation links.
* New: Text Alignment option in every Typography group (Inherit, Left, Center, Right, Justify).
* New: pre-made templates now look clearly different — Template One "Classic card", Template Two "Editorial" (date band and arrow link) and Template Three "Date badge" (overlapping badge and solid button) — with descriptive names in the template picker and new preview images.
* New: pre-made cards show the author and reading time where the date and category were repeated, and the comment count beside Read More.
* New: pre-made grid and carousel cards are equal height with their buttons aligned along the bottom.
* New: new pre-made layouts default to a three-line excerpt, so every card's text is the same height.
* Improved: thumbnails frame at the Custom size ratio, so small images and the no-image placeholder line up with cropped ones (Masonry keeps natural heights).
* Improved: Overlay content position — text is white on a gradient when the layout has no Typography colours of its own, the card grows to fit its text, and posts without an image show on a dark panel.
* Improved: "On Right" and "On Left" content positions fill the card height and stack on phones.
* Improved: Minimal List — a proper image column in the Custom template, and refined Date strip, Compact thumbnail, Agenda and Index table templates.
* Improved: two-sided vertical timelines (styles 02 and 03) collapse to one column on tablets and phones.
* Improved: meta items no longer break in the middle ("0 Comments"), and slider and single-sided timeline images fill the card.
* Improved: settings — the template picker comes first when you choose Pre-made, and unclear labels are renamed (e.g. "Limit Title Length", "Reset Filters Button", "Show/Hide Filters Toggle").
* Improved: tooltips explain each setting in plain text instead of linking to demo pages.
* Improved: layout and template classes on the wrapper (`postify-layout-{layout}`, `postify-template-{custom|pre-made}`) for theme styling.
* Fixed: Post Box border radius was ignored, so cards were always square.
* Fixed: "Mark Links As Nofollow" — Read More printed a broken rel attribute, and titles and images never added nofollow. New-tab links also get rel="noopener".
* Fixed: pre-made templates ignored the Detail Page Target and Nofollow settings.
* Fixed: the comment count in pre-made templates was hidden.
* Fixed: the "Post Category" switch was ignored by grid Template Three, Minimal List Template Four and the category badge of Template One.
* Fixed: Overlay "on hover" animation did not run.
* Fixed: Masonry left gaps when images or fonts loaded after the first layout.
* Fixed: excerpts joined paragraphs without a space ("end.Next"), and an excerpt cut at a sentence end showed four dots.
* Fixed: the "Lines" excerpt length brought images, headings and embeds into the card.
* Fixed: tablet content line height and mobile section title size were never applied.
* Fixed: post titles with quotes could break the image alt text in pre-made templates.

= 2.0.0 – 31 October 2026 =
A complete rebuild. Postify now has the same editor, options and front-end design as Eventful Pro, applied to your posts. Postify 1.x shortcodes keep working unchanged.
* New: six layout presets — Carousel (Standard, Ticker, Center and Multi Row styles), Slider, Grid, Minimal List, Timeline (vertical and horizontal) and Masonry.
* New: pre-made templates — three for Carousel, Slider, Grid, Masonry and Timeline, four for Minimal List — alongside the Custom template.
* New: Custom template content positions (default, image left, image right, overlay) and reorderable content fields.
* New: responsive columns at five screen widths, spacing between items and an equal-height option.
* New: timeline controls — five vertical and three horizontal styles, month and year separators, line thickness and colours.
* New: latest, sticky (featured) or hand-picked posts; include and exclude lists; exclude the current or password-protected posts.
* New: Sticky Posts option — normal order, pinned to the top, or hidden.
* New: filter by category and tag (IN, AND or NOT IN), keyword, publish timeframe, month, year, or a specific date, year or period.
* New: hide posts without a featured image; order by date, modified date, title, slug, ID, comment count, menu order or random.
* New: Ajax live filters by category, tag, timeframe, month and year, as buttons, dropdowns, radio buttons or checkboxes, with icons, labels, post counts, column layout and colours.
* New: live keyword search, a filter reset button and a show/hide filter toggle.
* New: Load More, Ajax page numbers, infinite scroll and classic pagination, with a separate type for mobile, custom labels, colours, borders and alignment.
* New: card border, radius, box shadow, padding, background and sticky-post background; section title; preloader.
* New: thumbnail size and crop, retina images, image replacement from the post's first image, video or audio, zoom and grayscale effects, border, radius and margins.
* New: meta fields for author (with avatar), date (published, modified or "time ago", with any format), categories or tags, comment count and reading time, each with its own icon.
* New: excerpt, trimmed or full content, with HTML tag control; Read More as a button or text link with its own colours and border.
* New: social sharing for 13 networks and custom fields from ACF, Pods, Toolset or post meta.
* New: link types — single page, popup (single or with next/previous), custom-field URL or none — with target and nofollow.
* New: typography for every element, including Google Fonts and tablet and mobile sizes.
* New: carousel and slider controls — autoplay, speed, loop, direction, rows, slides to scroll, transition effects, nine navigation positions, seven arrow styles, dots or numbers, dynamic bullets, adaptive height, touch, mouse drag, mouse wheel and keyboard navigation.
* New: a visual layout editor with a live preview, the layout presets beside the title and the shortcode in the sidebar.
* New: All Layouts screen with search, status tabs, bulk actions, duplicate and one-click shortcode copy.
* New: Settings — Color Scheme, Custom CSS and JavaScript (edited with WordPress's built-in code editor), carousel accessibility labels and asset loading.
* New: export and import of layouts and settings as JSON. Layouts exported from Eventful Pro can be imported too.
* New: Postify block for the block editor and widget for Elementor.
* New: Help screen with a getting-started guide.
* New: SEO schema markup — an ItemList of BlogPosting for each layout.
* All Postify 1.x shortcodes keep working, with every attribute and its 1.x default honoured. Theme 1 and Theme 2 use the Custom template; Theme 3 uses the pre-made date-badge template. Nothing in your content is changed and nothing is migrated.
* Postify's settings use their own `ta_postify_` option names, so they cannot collide with other plugins.
* Custom JavaScript can only be saved by users allowed to post unfiltered HTML.
* Imported layouts only bring in Postify's own settings, and never PHP objects.
* A post that contains a Postify shortcode can be listed by another layout without the two rendering each other endlessly.
* Postify and Eventful Pro can run side by side on the same page.
* Data is only removed on uninstall when "Delete All Data On Uninstall" is ticked.

= 1.1.1 =
* Tested with WordPress 6.9.

= 1.0 =
* Initial release.

== Upgrade Notice ==

= 2.1.0 =
Refined layouts and pre-made templates, a built-in Help manual, a Text Alignment option and many display fixes (border radius, nofollow, overlay, masonry). Saved layouts keep their settings; some cards will look more polished after updating.

= 2.0.0 =
A complete rebuild with six layouts, live filters, pagination and a new visual editor. Your Postify 1.x shortcodes keep working unchanged; nothing is migrated or removed.
