=== Turnaa eSIM Reseller ===
Contributors: turnaa
Tags: esim, travel, affiliate, monetization, travel blog
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show live travel eSIM plans on your site in 18 ready-made layouts and earn commission on every sale.

== Description ==

Travel writers get asked the same question on every destination post: how do I get online there? This plugin answers it in place, with live plans and prices for that destination, and pays you when a reader buys.

Drop a shortcode into a post, add a block, or let the plugin place itself automatically on posts that mention a destination. Every link carries your referral, so sales are attributed without you doing anything.

= It looks like your site, not ours =

There is no imposed brand colour. Every layout inherits your theme's typography, text colour and corner radius, so a placement reads as part of the page. If you would rather set an accent colour, that is one setting. Three sizes (small, medium, large) scale padding, type and card width together.

= 18 layouts =

* Card grid, list, comparison table, horizontal scroll
* Featured plan, accordion
* Strip, note box, inline link, text-only line, hover-for-prices
* Banner, price badge, sticky bar, corner bubble
* Destination grid, search box, how-it-works steps

= Prices stay current =

Plans and prices are read from Turnaa and cached for six hours, so your posts do not go stale and your site does not make a request per visitor. If the service is briefly unreachable, the last known prices are shown rather than an empty gap.

== External services ==

This plugin displays eSIM plans supplied by Turnaa (Turna LLC) and requires a free Turnaa partner account to attribute sales to you.

It sends requests to `https://esim.turnaa.cloud/wp-json/turnaa/v1` to fetch plan names, data allowances, validity periods and prices for the destinations you choose to display. No personal data about you or your visitors is transmitted: the requests contain only the destination code being displayed.

Links rendered by the plugin point to `https://esim.turnaa.cloud` with your referral token appended, so purchases can be credited to you. Your visitors' data is then handled by Turnaa under its own terms.

* Terms of service: https://esim.turnaa.cloud/terms/
* Privacy policy: https://esim.turnaa.cloud/privacy-policy/

== Installation ==

1. Install and activate the plugin.
2. Go to **Turnaa eSIM → Setup** and connect your Turnaa partner account. If you do not have one, you can apply from that screen; it is free.
3. Add a placement with the block, a widget, the `[turnaa_esim]` shortcode, or turn on automatic placement.

== Frequently Asked Questions ==

= Do I need a Turnaa account? =

Yes, and it is free. Without one the plugin can still render layouts, but no sale can be credited to you.

= How do I place plans in a post? =

Use the block, or the shortcode: `[turnaa_esim country="jp" layout="grid" limit="4"]`. Attributes: `layout`, `country`, `label`, `limit`, `size` (sm/md/lg), `accent` (hex), `cta`, `byline` (yes/no).

= Can I hide the "Plans provided by Turnaa" line? =

Yes — `byline="no"` on the shortcode, or the equivalent toggle in the block and settings.

= Will it slow my site down? =

No. Plans are cached for six hours and the stylesheet is only loaded on pages that actually show a placement.

= Are the links marked correctly? =

Yes. Every outbound link carries `rel="nofollow sponsored"`, which is what search engines expect of affiliate links.

== Screenshots ==

1. Card grid on a destination post
2. Comparison table
3. The 18 layouts side by side
4. Automatic placement settings

== Changelog ==

= 2.0.0 =
* Rewritten from scratch: class-based architecture, 18 layouts, theme-inherited styling.
* Added size options (small, medium, large) and an optional accent colour.
* Added comparison table, horizontal scroll, featured plan, accordion, note box, text-only, corner bubble, destination grid and how-it-works layouts.
* Plans are now cached for six hours with a fallback to the last known prices.
* Stylesheet loads only on pages that render a placement.
* Full translation support.

= 1.4.2 =
* Earlier self-distributed release.
