=== ZodiacSign Horoscope ===
Contributors: your-wporg-username
Tags: horoscope, astrology, zodiac, widget, shortcode
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a daily horoscope widget to any page, post or sidebar: three designs, live preview, shortcode and block. Texts come from ZodiacSign.ro.

== Description ==

**ZodiacSign Horoscope** puts a clean, fast daily horoscope on your site. Visitors pick a zodiac sign and read today's teaser; every sign has love, career, money and luck scores and a short profile.

* **Three ready-made designs** (Signature, Aurora, Midnight), light or dark, responsive from a narrow sidebar to a full page.
* **Configurator with live preview**: colors, typography, cards, number of columns, which parts to show, desktop / tablet / sidebar / mobile preview.
* **Shortcode and block**: `[zodiacsign_horoscope config="cfg_xxxxxxxx"]` or the "ZodiacSign Horoscope" block.
* **English and Romanian** texts; the language can be set per insertion.
* **Fast**: the widget is drawn in a Shadow DOM so your theme cannot break it, loads when it scrolls into view, remembers the last answer and needs one small request.
* **Accessible**: keyboard operation, screen reader labels, visible focus, reduced-motion friendly, colors checked for contrast.
* **Free**: every feature is included. There is no license key, no trial and no paid tier.

The horoscope texts are written and published daily by ZodiacSign.ro. The plugin shows them through the ZodiacSign.ro service (see "External services" below). A link "Horoscope provided by ZodiacSign.ro" is available but **off by default**; you choose whether to show it.

= Nothing happens until you agree =
After activation the plugin does not contact any server and shows nothing on your public pages. In the plugin dashboard you read what is sent and press "I agree, connect". You can disconnect at any time from the Help tab.

== External services ==

This plugin connects to the **ZodiacSign.ro** service (https://www.zodiacsign.ro), operated by the plugin author, to obtain the daily horoscope texts and to register your site so that the service can answer the widget. The connection starts only after the site owner clicks "I agree, connect" in the plugin dashboard.

**1. Registration of your site (server to server, from your WordPress site)**
* When: when you save a widget design (and once an hour, only to repeat a registration that failed).
* Data sent: your site's domain name (for example example.com), the widget design settings (colors, layout, language) and the plugin edition identifier. No personal data of your users or of you is sent.
* Returned: an installation code that ties the design to your domain.

**2. Horoscope texts (from your visitors' browsers)**
* When: when a visitor opens a page that contains the widget.
* Data sent: the browser requests the horoscope of the chosen sign from ZodiacSign.ro, together with the installation code and the address of the page. As with any web request, the ZodiacSign.ro server receives the visitor's IP address and browser details in its normal access logs. The widget sets no cookies and does not track visitors; it keeps the last answer in the visitor's own browser storage (localStorage) to load faster.

Service provider: ZodiacSign.ro. Privacy policy: https://www.zodiacsign.ro/confidentialitate/ . Terms: https://www.zodiacsign.ro/termeni/ .

== Installation ==

1. Upload the plugin to `/wp-content/plugins/`, or install it from the Plugins screen, and activate it.
2. Open **ZodiacSign Horoscope** in the admin menu, read the notice and press **I agree, connect**.
3. Pick a design, adjust it in the editor and press **Save configuration**.
4. Copy the shortcode from the Configurations tab into a page, a post or a sidebar widget (Shortcode or Text block), or use the **ZodiacSign Horoscope** block.

== Frequently Asked Questions ==

= Is it free? =
Yes. All features are free and there is no license key or limit built into the plugin.

= Does it work in a sidebar? =
Yes. The widget adapts to the width of the place it is in. Use the "Sidebar" preview in the editor to check a narrow column. In a classic widget area add a Text or Shortcode widget with the shortcode; in block themes add a Shortcode block to the sidebar template part.

= Does it show a link to your website? =
Only if you choose it. The credit link "Horoscope provided by ZodiacSign.ro" is off by default. After you save your first design the plugin asks you once, with a Yes / No choice, whether you want to show it; nothing changes until you answer, and you can change it at any time in the editor (Links & Branding).

= What data leaves my site? =
See "External services" above. Nothing is sent before you agree in the dashboard.

= Can I use another language? =
The widget texts are available in English and Romanian; choose the language in the editor or with `lang="en"` / `lang="ro"` in the shortcode.

= The widget says the content is not available =
The horoscope of the day is published by ZodiacSign.ro; if it is not published yet the widget shows a message instead of old content. If your site cannot reach www.zodiacsign.ro, ask your host to allow outgoing HTTPS requests.

= How do I remove everything? =
Disconnect from the Help tab, deactivate and delete the plugin. Saved designs and options are removed on deletion.

== Screenshots ==

1. First start: the plugin explains what is sent and waits for your agreement.
2. Choose a design: the three models, open, with today's real horoscope.
3. The editor: sections, live preview and Desktop / Tablet / Sidebar / Mobile views.
4. The widget in a sidebar.
5. The widget in a page.

== Changelog ==

= 2.2.0 =
* Opt-in connection: nothing is sent and nothing is shown until the site owner agrees in the dashboard.
* The "Horoscope provided by ZodiacSign.ro" link is now optional and off by default; the widget is never paused for lacking it. A one-time question (Yes / No) invites you to show it; nothing is switched on before you answer.
* New "External services" and privacy information, Disconnect button.
* Faster first load (one request), instant return visits, shaped loading placeholder.
* Readable colors checked against WCAG AA; configurator isolated from theme styles; Sidebar preview.
* Date labels always in the language of the widget.

= 2.1.0 =
* Redesigned dashboard, open design gallery, speed improvements.

= 2.0.0 =
* Complete rewrite: three designs, configurator, block, signed installation codes.

== Upgrade Notice ==

= 2.2.0 =
Adds an explicit consent screen and makes the credit link optional. Open the plugin dashboard once after updating and press "I agree, connect" to keep widgets visible.
