=== Amitry Project Grid ===
Contributors: amitry
Tags: portfolio, case study, project, mockup, showcase
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Present projects as cards with icon, headline, description, an interactive browser-mockup screenshot that scrolls on hover, and a CTA button.

== Description ==

Amitry Project Grid gives agencies and freelancers a clean way to display their work. Each card has five fields: an icon (dashicon or uploaded image), a headline, a description, a browser-mockup screenshot that scrolls automatically on hover, and a call-to-action button.

Cards can be used individually or grouped into a responsive grid for portfolio overviews.

= Card fields =

* Icon (Dashicon picker or uploaded image)
* Headline with selectable heading level (H2-H6)
* Description with basic inline formatting (bold, italic, links)
* Mockup image displayed inside a browser frame, with hover-scroll for full-page screenshots
* Call-to-action button with text, URL and target

= Frontends =

* Project Grid block: grid container with a 1-6 column setting (responsive on smaller screens)
* Project Card block: single card, can be used standalone or inside a grid
* Shortcode for classic themes
* Elementor widget (loads only if Elementor is active)

= Mockup feature =

The mockup feature renders the uploaded screenshot inside a browser-style frame with traffic-light dots and an address bar. On hover (desktop) the image scrolls from top to bottom of the screenshot, then returns when the cursor leaves. On touch devices the scroll plays automatically when the card enters the viewport, and tapping replays it.

The plugin uses the original uploaded image (not WordPress\' auto-scaled version) so long screenshots stay sharp.

= Privacy =

The plugin makes no external network requests. No data is collected, transmitted or stored outside your own WordPress installation.

= For developers =

The plugin exposes hooks for extensions:

* `apshow_renderer_defaults`, `apshow_wrapper_classes`, `apshow_render_html`, `apshow_kses_allowed` (filters)
* `apshow_allowed_frames`, `apshow_allowed_scroll_modes`, `apshow_mockup_bar_html`, `apshow_mockup_html` (filters for extending mockup frames and animation modes)
* `apshow_before_render`, `apshow_after_render`, `apshow_loaded`, `apshow_activated`, `apshow_deactivated`, `apshow_admin_about_after_content` (actions)
* `APSHOW_HOOK_VERSION` constant for compatibility checks

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the Plugins screen.
2. Activate the plugin.
3. Add the "Project Grid" or "Project Card" block, or use the `[apshow_project_card]` shortcode, or the Elementor widget.

== Frequently Asked Questions ==

= Do I need an external service or API key? =

No. The plugin works entirely with images you upload to your own media library.

= Can I use just one card without the grid? =

Yes. The Project Card block works standalone.

= Does it work with my theme? =

The blocks, shortcode and Elementor widget work with any standard WordPress theme. Block alignment options (wide, full) on the grid require a theme that supports them.

= Is Elementor required? =

No. The Elementor widget only registers when Elementor is active.

= How tall can my screenshot be? =

Any height. The plugin reads the original uploaded image so even very tall full-page screenshots stay sharp inside the mockup.

== Screenshots ==

1. The Project Card block in the editor with all fields filled in.
2. A Project Grid block with three cards; set 1-6 columns in the sidebar.
3. A single card on the frontend at rest.
4. The same card during hover, showing the screenshot scrolled.
5. Sidebar controls for icon, headline, mockup and CTA.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
