=== Sami Curtain Advertisement ===
Contributors: same2cool
Tags: advertisement, popup, banner, call to action, analytics
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.13
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

An animated corner-curtain ad with a customizable clickable area, optional button, opposite-side slide-in, and built-in local analytics.

== Description ==

Sami Curtain Advertisement displays a gently animated curtain in a corner of your website. The subtle movement draws attention without opening the advertisement automatically.

When a visitor clicks the curtain, the advertisement slides in from the opposite side of the screen. The background dims, the curtain animation pauses, and the ad appears centered in an A4-style frame. Closing the ad reverses the animation and resumes the curtain's movement.

Features:

* Continuously animated curtain that pauses automatically while the ad is open.
* Left or right corner placement, with the ad always entering from the opposite side.
* Three curtain/carpet artwork themes, each with a visual thumbnail in the admin.
* Website page-fold design concept with adjustable pixel dimensions (≈300 × 300 px by default).
* Customizable accent, popup, and button colors.
* Optional transparent PNG logo, with independent visibility settings for the curtain and the ad.
* Drag-and-position controls for the logo, with separate placement on the curtain and the ad.
* Draw and resize an invisible clickable area directly over an existing banner button.
* Optional visible custom button for banners that don't already include one.
* Only the defined hotspot or button is clickable — the rest of the banner stays unlinked.
* Local tracking of impressions, opens, unique session opens, closes, and link clicks.
* Optional "Powered by Ping Booster" credit, off by default.
* No external analytics service, account, or license required — all data stays on your site.

== Installation ==

1. Upload the plugin ZIP from Plugins > Add New.
2. Activate Sami Curtain Advertisement.
3. Open Sami Curtain Advertisement > Ad Editor.
4. Upload a banner and optional transparent PNG company logo.
5. Select the curtain design, colors, jewellery and side.
6. Choose whether to select an existing banner area or add a new button.
7. Enter the URL, position and resize the selected area in the preview.
8. Enable Sami Curtain Advertisement and save.

== Frequently Asked Questions ==

= Is the complete banner clickable? =

No. Only the selected hotspot or optional generated button contains the destination link.

= Where is analytics data stored? =

Aggregate counts are stored locally in WordPress and are not sent to Ping Booster.

= Does the curtain keep moving? =

Yes. It moves until opened, pauses while open, and resumes after closing.

= Is Ping Booster front-end branding required? =

No. The optional credit is disabled by default.

= Must I add a separate company logo? =

No. The logo is optional. You can hide it from the curtain, advertisement, or both when the uploaded banner already contains branding.

== Screenshots ==

1. Visual advertisement editor.
2. Moving curtain before opening.
3. Centered advertisement with dimmed background.
4. Local analytics dashboard.

== Other Notes ==

All JavaScript and CSS in this plugin is hand-written, human-readable source with no build step, bundler, or minifier involved — what ships in the plugin package is the full and only source code.

== Changelog ==

= 1.0.13 =

* Renamed the plugin from Funky Ad to Sami Curtain Advertisement (slug changed to sami-curtain-advertisement) for directory approval.
* Removed the unnecessary load_plugin_textdomain() call; WordPress.org auto-loads translations since 4.6.
* Removed WordPress.org directory-only assets (icon, logo) from the plugin package.
* Reformatted admin JavaScript for readability; no functional changes.
* Shortened the readme short description to meet the 150-character limit.

= 1.0.11 =

* Added a detailed Sami Curtain Advertisement overview and usage guide beneath Analytics.
* Added explanations for every analytics metric.
* Added a voluntary Support Ping Booster switch for the optional powered-by credit.
* Added a direct Ad Editor shortcut from the Analytics information section.

= 1.0.10 =

* Removed the hanging jewellery and jhoomer from the frontend.
* Removed the jewellery selector from the advertisement editor.
* Retained all animated curtain and carpet designs.

= 1.0.9 =

* Added transparent 24-frame animated cloth GIFs for every cover design.
* Replaced rigid whole-cover bouncing with true fabric-edge deformation.
* Added automatic animated-to-static swapping while the advertisement is open.
* Restarts cloth motion after the reverse carpet return completes.

= 1.0.8 =

* Replaced the 3D card flip with a flying-carpet unroll and roll-back animation.
* Added a visibly stronger whole-cover attention movement.
* Made the closed cover movement independent of JavaScript transforms.
* Removed the 180-degree curtain flip during opening and closing.

= 1.0.7 =

* Added up to 20 independent links on one advertisement banner.
* Added per-area URL, label, invisible/visible mode, button text and new-tab behavior.
* Added visual selection, dragging, resizing and removal for every linked area.
* Blocked overlapping link areas in both the editor and server-side sanitization.
* Added click tracking to every configured link area.

= 1.0.6 =

* Made hotspot placement generic for every banner and image aspect ratio.
* Normalized all hotspot coordinates against the exact rendered image.
* Expanded hotspot sizing to 1-100 percent for small or large linked areas.

= 1.0.5 =

* Corrected link-area and logo coordinates to use the exact banner image stage.
* Added continuous JavaScript movement for the complete closed cover.
* The fold, genie eyes, company logo and jewellery now move together.
* Movement stops during opening and resumes after the reverse close animation.

= 1.0.4 =

* Fixed frontend initialization so clicking the folded corner reliably opens the advertisement.
* Doubled the default trigger footprint to approximately 300 x 300 pixels.
* Added the original Website Page Fold concept with a clear backside logo area.
* Added JavaScript-controlled 3D launch and reverse-return states.
* Changed banner entry to a perspective flip that comes forward from the page corner.

= 1.0.3 =

* Replaced the oversized CSS triangle with transparent curtain artwork.
* Added Royal Satin, Theatre Velvet and Persian Carpet visual samples.
* Changed the default closed-curtain footprint to approximately 150 x 150 pixels.
* Strengthened the gentle-breeze motion and kept it paused while the ad is open.
* Added legacy setting migration and a no-JavaScript content fallback.

= 1.0.2 =

* Made the uploaded company logo optional.
* Added separate visibility controls for the curtain and advertisement logos.
* Added draggable advertisement-logo positioning and separate X/Y controls.
* Added separate curtain-logo positioning controls.

= 1.0.1 =

* Replaced the forced visible CTA with an invisible resizable link-area mode.
* Added an optional custom-button mode for banners without existing button artwork.
* Added drag-and-resize controls based on the approved editor behavior.

= 1.0.0 =

* Initial release.
