=== FlipEm ===
Contributors: boxhatch
Tags: flip card, shortcode, widget, css3, 3d transform
Requires at least: 4.9
Tested up to: 6.9
Requires PHP: 7.0
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

FlipEm adds CSS3 3D flipping cards to WordPress content and sidebars using shortcodes, a widget, and a live generator.

== Description ==

FlipEm adds configurable 3D flip cards to WordPress with shortcodes, a widget, and a visual generator. Build front/back cards, preview them live, and copy ready-to-use shortcodes without hand-coding each layout.

[View live demos and ready-to-paste examples](https://andreipetcu.com/flipem-simple-wordpress-3d-flipcard-generator/)

### What you can build

Use FlipEm for feature cards, service blocks, team cards, image reveals, callouts, pricing highlights, and other interactive content sections.

### Core features

* Shortcodes: `[flipem_card]`, `[flipem_front]`, `[flipem_back]`
* Trigger modes: hover, click, button, auto
* Directions: right, left, top, bottom
* Per-card overrides with global defaults
* Rich front/back content with nested shortcodes support
* Separate front/back background images
* Background repeat, size, and position controls
* Auto flip interval and start delay settings
* Sidebar widget support
* Live Generator tab with preview, shortcode copy, and presets

### Why use FlipEm

FlipEm is built for sites that need more than static boxes. It helps you create reusable interactive cards with per-card control over motion, layout, and styling while keeping shortcode and widget output consistent.

### Workflow

1. Open the FlipEm Generator.
2. Adjust the card settings visually.
3. Preview the result live.
4. Copy the shortcode into your content or widget area.

== Installation ==

1. Upload the plugin ZIP from Plugins -> Add New -> Upload Plugin.
2. Activate FlipEm.
3. Open the FlipEm menu in the WordPress admin left panel.
4. Use the Generator tab to build cards visually, or add shortcodes manually.

== Frequently Asked Questions ==

= Can I use different types/styles of cards on the same site? =
Yes. Global Settings define defaults only. Each card shortcode and widget instance can override them.

= Do nested shortcodes work inside the card faces? =
Yes. FlipEm runs nested shortcodes inside [flipem_front] and [flipem_back].

= Is there a widget? =
Yes. The plugin includes the "FlipEm Card" widget.

= How do I trigger flip only with a button? =
Use type="button" and add an element with class "flipem-flip-button" inside the card content.

== Shortcode Example ==

[flipem_card type="over" direction="right" width="320px" height="220px"]
[flipem_front]
<h3>Front</h3>
<p>Front content</p>
[/flipem_front]
[flipem_back]
<h3>Back</h3>
<p>Back content</p>
[/flipem_back]
[/flipem_card]

== Changelog ==

= 1.1.0 =
* Added generator presets for quickly loading ready-made FlipEm card designs.
* Various fixes and tweaks.

= 1.0.21 =
* Various bug fixes, security hardening, and general improvements.

= 1.0.20 =
* Various bug fixes, stability improvements, and general cleanup.

= 1.0.17 =
* Fixed Plugin Check/PHPCS packaging and compliance issues while preserving runtime behavior.
* Added PHPCS-safe escaping annotations for widget wrapper/card renderer output.
* Sanitized help icon output with wp_kses where rendered in admin templates.
* Reworked admin tab request read with nonce-verification recommendation comments for read-only view state.
* Removed discouraged load_plugin_textdomain() usage.
* Updated uninstall routine to avoid direct DB query and use prefixed multisite variables.
* Removed UTF-8 BOM and normalized line endings across plugin files.
* Corrected readme format headers for parser compliance.

= 1.0.16 =
* Added release/package files for marketplace distribution (readme, changelog, license, docs, uninstall, folder index guards).
* Added documentation HTML files in root and documentation folder.
* Added plugin header metadata (Requires at least / Tested up to / Requires PHP / License URI).
* Localized admin media picker labels and removed external admin font import dependency.

= 1.0.15 =
* Added separate front/back background image support and background controls in generator/widget.

== Upgrade Notice ==

= 1.1.0 =
Various bug fixes and general improvements.