=== Jinkosoft ===
Contributors: jinkosoft
Tags: widgets, booking, store locator, embeddable, shortcode
Requires at least: 5.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your Jinkosoft account and embed booking and store locator widgets in WordPress without adding heavy app logic to your site.

== Description ==

Jinkosoft brings embeddable business widgets into WordPress with a lightweight integration flow.

From one admin page you can connect your Jinkosoft account, activate the widgets available for your workspace, and choose how each widget should appear on your website.

Current widgets included in this bundle:

* Slotflow: an embeddable booking widget for appointments and calls
* Locate My Store: an embeddable store locator that points visitors to the right location

= Slotflow =

Slotflow helps you turn a normal page into a booking page.

Visitors can:

* pick an available date
* choose a time slot
* submit their details
* confirm a booking directly from your website

Slotflow is designed for appointments, discovery calls, consultations, demos, and similar booking flows. Depending on your Jinkosoft workspace setup, it can also work with availability rules, form-specific booking flows, and Google Calendar integration managed from the external Jinkosoft dashboard.

For more information, visit:

* `https://jinkosoft.com/en/embeddable-widgets/slotflow`

= Locate My Store =

Locate My Store helps visitors reach the right physical location without forcing them to search through long lists.

The widget is designed to:

* point visitors to the most relevant store
* show key details such as address, distance, and opening status
* make it easy to start directions
* reduce friction for businesses with multiple locations

It works especially well for retail brands, local businesses, chains, showrooms, and any business that wants a lightweight store locator experience on WordPress while keeping the heavier business logic on the Jinkosoft side.

For more information, visit:

* `https://jinkosoft.com/en/embeddable-widgets/locatemystore`

= Why site owners use Jinkosoft =

* Connect or create your Jinkosoft account directly from WordPress
* Enable the widgets you need from one plugin page
* Insert widgets with shortcode exactly where you want them
* Manage widget-specific settings such as the Slotflow form slug
* Open the related Jinkosoft dashboard directly from WordPress

= Typical use cases =

* Add a booking form to a sales page or contact page
* Use different Slotflow forms on different pages with shortcode attributes
* Show a store locator across the whole website
* Restrict a widget to selected landing pages only

== Screenshots ==

1. The Slotflow embeddable booking widget.
2. The Locate My Store embeddable locator widget.

== Installation ==

1. Upload the `yps-bundle` folder to `/wp-content/plugins/`
2. Activate the plugin through the Plugins menu in WordPress
3. Open `Jinkosoft` from the WordPress admin menu
4. Create an account or log in with your existing Jinkosoft account
5. Click `Try` or `Configure` on the widget you want to use
6. Copy the shortcode and place it in the page, post, or block where the widget should appear
7. For Slotflow, select the form you want to display

== Frequently Asked Questions ==

= Do I need a Jinkosoft account? =

Yes. The plugin connects to Jinkosoft services, so you need a Jinkosoft administrator account to activate and configure the available widgets.

= How do I display a widget? =

You can:

* insert it with shortcode
* choose the exact page position where the widget should appear

For Slotflow, you can also use different forms on different pages with shortcode attributes such as:

`[jinkosoft-slotflow form="demo-booking"]`

= Will this plugin slow down my WordPress site? =

The plugin is designed to stay lightweight on the WordPress side. It does not ship a large internal booking or locator application inside WordPress. Instead, it relies on the external Jinkosoft services and only loads the required embeddable widget scripts when the widget is actually used.

= Does this plugin use third-party services? =

Yes. This plugin relies on external services provided by Jinkosoft.

== Third Party Services ==

= Jinkosoft API =

The plugin communicates with the Jinkosoft API to register or log in administrators, load the list of active workspaces, create widget workspaces, and serve widget data to embeddable components.

* Service URL: `https://server.jinkosoft.com`
* Used for: account creation, authentication, workspace provisioning, and widget data delivery
* Data sent: administrator name, email, password, and widget configuration requests; visitors may send booking or store locator data through the embeddable widgets
* Terms of Service: `https://jinkosoft.com/en/terms-and-conditions`
* Privacy Policy: `https://jinkosoft.com/en/privacy-policy`

= Jinkosoft Widget CDN =

The plugin loads the widget scripts from the Jinkosoft CDN when the widgets are used on the website.

* Service URL: `https://cdn-widgets.jinkosoft.com`
* Used for: delivering the embeddable widget scripts to visitors' browsers
* Services loaded:
** `https://cdn-widgets.jinkosoft.com/widgets.iife.js`
* Terms of Service: `https://jinkosoft.com/en/terms-and-conditions`
* Privacy Policy: `https://jinkosoft.com/en/privacy-policy`

== Changelog ==

= 1.0.0 =
* Initial release