=== Amitry Project Grid - Browser Mockup & Scrolling Screenshot Portfolio ===
Contributors: amitry
Tags: browser mockup, scrolling screenshot, website preview, portfolio, showcase
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show website previews in a browser mockup that scrolls on hover. Build portfolio and project showcase grids with screenshots, headline, and CTA.

== Description ==

**[See the live demo &rarr;](https://demo.amitry.de/)** &mdash; hover any mockup to watch the full page scroll.

Amitry Project Grid is a WordPress browser mockup and scrolling screenshot plugin for agencies and freelancers. Show a website preview inside a clean browser frame that scrolls through the full-page screenshot on hover, then group these project cards into a responsive portfolio grid. 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.

People look for this kind of plugin under many names - browser mockup, scrolling screenshot, website preview, portfolio screenshot grid, project showcase, or website frame. Amitry Project Grid covers that use case as a block, a shortcode, and an Elementor widget.

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 hover effect in action: a full-page website screenshot scrolling inside a browser mockup.
2. The Project Card block in the editor with all fields filled in.
3. A Project Grid block with three cards; set 1-6 columns in the sidebar.
4. A single card on the frontend, and the same card during hover showing the screenshot scrolled.
5. Sidebar controls for icon, headline, mockup and CTA.

== Changelog ==

= 1.0.2 =
* Added a link to the live demo at https://demo.amitry.de/

= 1.0.1 =
* Renamed the single-card shortcode to [apshow_project_card] for prefix consistency.
* Readme: clearer title and description for the browser-mockup / scrolling-screenshot use case.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.2 =
Adds a link to the new live demo.

= 1.0.1 =
Shortcode tag is now [apshow_project_card]. Update any existing shortcodes.

= 1.0.0 =
Initial release.
