=== Nuage Business Calendar ===
Contributors: nuagecreative
Tags: calendar, holidays, shortcode, business, schedule
Requires at least: 5.8
Tested up to: 7.1
Stable tag: 1.2.0
Requires PHP: 7.4
Author: Nuage Creative
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A minimalist business calendar that highlights days with elegant colored circles. Perfect for business days, regular holidays, and events.

== Description ==

Nuage Business Calendar is a lightweight, clean, and easy-to-use business calendar plugin developed by Nuage Creative. It allows you to display a simple calendar on your website and mark specific days (such as regular holidays, business events, or special days) with elegant colored circles.

No complex booking systems, no heavy CSS—just a beautiful, minimalist calendar.

### 🌟 Key Features

* **Simple Click-to-Mark Interface**: Just click on a date in the admin panel to toggle a circle.
* **Customizable Styles**: Create up to 10 different circle styles with your own labels (e.g., Red for "Holidays", Blue for "Events") and custom colors.
* **National Holiday Import**: Instantly import public holidays for specific countries (Japan, US, UK, France, Canada, etc.) via JSON files.
* **Flexible Shortcode**: Easily display the calendar anywhere using the `[nbcal_calendar]` shortcode. You can also add a custom title like `[nbcal_calendar title="Business Day Calendar"]`.
* **One-Click Shortcode Copy**: The admin settings page includes a ready-to-use shortcode box — enter an optional title and copy the finished shortcode with a single click.
* **Today Highlight**: Mark the current day automatically with an Outer Ring or Underline marker, based on your WordPress timezone setting.
* **Clickable Date Links**: Turn any circle style into a link (a Default URL for every date it marks), or override the destination for one specific date. Choose whether links open in the same tab, a new tab, or a new tab only for external sites.
* **Smart Navigation Limits**: Prevent users from clicking too far into the past or future by setting navigation limits (e.g., allow navigating only 3 months ahead).
* **Legend Toggle**: Choose whether to show or hide the legend below the calendar. Even if hidden, hover tooltips will show the label name!
* **Multilingual Ready**: Fully internationalized. English, Japanese, and French translations are supported.

== Installation ==

1. Upload the `nuage-business-calendar` folder to the `/wp-content/plugins/` directory, or install it via the WordPress plugin directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Settings > Nuage Business Calendar** to create your circle styles and mark your dates.
4. Use the shortcode `[nbcal_calendar]` on any page, post, or widget to display the calendar.

== Frequently Asked Questions ==

= How do I display the calendar with a title? =
You can use the `title` attribute in the shortcode. For example: 
`[nbcal_calendar title="Store Schedule"]`

= How do I copy the shortcode? =
Go to **Settings > Nuage Business Calendar**. At the top of the page you'll find a Shortcode box — optionally enter a calendar title, then click "Copy" to copy the ready-to-use shortcode to your clipboard.

= How do I highlight today's date on the calendar? =
Go to **Settings > Nuage Business Calendar > Display Settings**, and set "Today Marker" to "Outer Ring" or "Underline".

= How do I make a date link to another page? =
On the settings page, switch to **Link Mode** above the calendar editor. Click any date that already has a circle mark to select it, then enter a URL and click "Apply Link" — this overrides the link for that date only. To link every date under a given circle style at once, set a "Default URL" on that style instead, under Circle Design & Legend Labels.

= Can I control whether links open in a new tab? =
Yes. Go to **Settings > Nuage Business Calendar > Display Settings**, and set "Link Target" to "Same Tab", "New Tab", or "New Tab for External Links Only".

= How do I add my own country's holidays? =
You can easily add your own holidays! Just create a JSON file named `holidays-[country-code]-[year].json` (e.g., `holidays-de-2026.json` for Germany 2026) and upload it to the plugin's `/data/` directory via FTP. It will automatically appear in the import dropdown. The file should contain a `_region_name` key and date entries in `YYYY-MM-DD` format.

= Can I hide the labels/legend under the calendar? =
Yes. Go to Settings > Nuage Business Calendar > Display Settings, and set "Show Legend" to "No". Users can still see the label name by hovering over the colored circle on the calendar.

== Screenshots ==

1. The front-end calendar view with colored circles and a legend.
2. The admin settings page where you can easily click dates and import holidays.

== Changelog ==

= 1.2.0 =
* Added: Clickable date links — a Default URL per circle style, plus a per-date override editable via a new "Link Mode" in the admin calendar editor.
* Added: "Link Target" display setting to control whether links open in the same tab, a new tab, or a new tab only for external sites.
* Fixed: Uninstalling the plugin now removes all of its settings, including options added since 1.1.0.
* Improved: The Link Mode URL field now stays visible at all times instead of appearing only after picking an eligible date.

= 1.1.0 =
* Added: "Today Marker" display setting (Outer Ring / Underline) to highlight the current day on both the front-end and admin calendars.
* Added: Shortcode box on the admin settings page with a calendar title input and a one-click copy button.
* Improved: Circle sizing and cell spacing so date markers no longer touch neighboring days.

= 1.0.0 =
* Initial release.