=== Search and Stay ===
Contributors: searchandstay
Tags: accommodation, travel, reservations, bookings, property management
Requires at least: 5.2
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.4.10
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Plugin Documentation
===========================

1. Overview
-----------
The Plugin allows users to connect travelers with unique accommodations such as tiny homes, cabins,
and container houses. It provides property owners with tools to list their accommodations and manage bookings,
while offering travelers an easy way to discover and reserve unique stays.

2. Installation
---------------
1. Download the plugin from the WordPress Plugin Directory.
2. Go to your WordPress Admin Dashboard.
3. Navigate to Plugins > Add New.
4. Click on Upload Plugin and select the breakz.zip file.
5. Install and activate the plugin.
6. After activation, go to the plugin menu to configure the settings.

3. Features
-----------
- Reservation System: Travelers can book properties directly through the plugin's interface.
- User Dashboard: Separate dashboards for travelers and property owners.
- Secure Payments: Integrated secure payment gateway with Stripe.
- Responsive Design: Optimized for mobile and desktop use.
- Reviews & Ratings: Guests can leave feedback after their stay.

4. Usage
--------
1. Browse properties via page on the website.
2. Use filters to refine searches by location, type, or price range.
3. Select a property, check availability, and complete the booking process.
4. Privacy and Data Security

5. Data Collection
------------------
The Plugin collects the following data:

User account details (name, email, hashed password).

Booking information.

Payment Processing
Payments are processed securely using Stripe. The plugin does not store sensitive payment details (e.g., card numbers) on its servers.

User Consent
Users must explicitly agree to the terms and conditions and privacy policy before creating an account.

Compliance
The plugin complies with GDPR and other applicable privacy regulations. Users have the right to request access to, correction, or deletion of their data.

For more details, visit our Privacy Policy.

6. FAQ (Frequently Asked Questions)
------------------------------------
Q: Is the plugin free?
A: Yes, the core features are free. Additional premium features may be available in future versions.

Q: Can I customize the booking form?
A: Yes, the booking form fields can be customized in the plugin settings.

Q: How does the payment system work?
A: The plugin integrates with secure payment gateways like Stripe or PayPal to process transactions.

Q: Can travelers and property owners communicate?
A: Yes, the plugin includes a messaging system for travelers and property owners.

Q: Does the plugin support multiple languages?
A: The plugin is translation-ready and supports localization.

7. Changelog
------------
Version 1.0.0
- Initial release.
- Property listing and management.
- Booking and payment functionality.
- User dashboards for travelers.

Version 1.1.0
- Fixed layout and user usability bugs.
- Fixed responsiveness.

Version 1.2.1
- Add Map shortcode that loads all properties from cache,
- Add Map shortcode that loads 12 properties per viewport dynamically from API.

Version 1.2.2
- Fixed responsiveness.
- Fixed layout and user usability.

Version 1.2.3
- Property List View Port -> Add start scroll when load pagination
- Map -> Updated zoom map
- Recaptcha -> Updated production key
- Plugin Settings -> Updated defaults, api_url and checkbox - With this option enabled, then the plugin will retrieve posts based on the configured properties.

Version 1.2.4
- Map -> Implemented single call after 1.5s from the last interaction on the map. Credits removed from end of map
- Cards properties and marker map -> Adjusted currencies on property cards
- Single Property Selection -> Implemented properties combobox in the plugin settings, after 3 characters the shortcode searches the backend filtering properties with the name entered
- Plugin Settings -> Added single property selection shortcode for single property theme

Version 1.2.5
- Plugin Settings -> Implemented request for 5 properties to show the first images in the multi properties banner

Version 1.3.0
- Social Media Login -> Implemented social media login with Facebook, Google and Apple
- Version CDN's -> Implemented version in all CDN's. Updated arrow from carousel
- Plugin Settings Shortcodes -> Updated shortcodes listing layout, added button to copy the shortcode

Version 1.3.1
- Plugin Settings -> Implemented Yoast meta title and description update when triggering post request from SAS.

Version 1.3.2
- Search Single Shortcode -> Fixed error of not showing booked dates in the calendar

Version 1.3.3
- Sitemap Download Trigger -> An endpoint to trigger Wordpress site request on SAS api to download sitemap files from s3 (http://{domain}/wp-json/saswp/public/trigger_sitemap_download ). Added a menu item called “Sitemap Files” to list current downloaded sitemap files.

Version 1.3.4
- Stripe error message on booking -> Fixed Stripe error message when adding test credit card in production environment

Version 1.3.5
- Property Details -> Updated amenities dialog size

Version 1.3.6
- Login social medias -> Updated Apple and Google appId and clientId to login with social networks

Version 1.3.7
- Availability - Request or Instant Booking was not appearing
- Sas Logo - I wasn't assembling the shortcode

Version 1.4.0
- Updated plugin with Wordpress requirements for submitting the store
- Added descriptions to shortcodes in the admin section with tooltip
- Implement save card button when paying for booking

Version 1.4.1
- Updated Stripe card creation form validation
- Updated initialization of the variable that shows the error to the user in the stripe store

Version 1.4.2
- Added Sitemap menu for properties list

Version 1.4.3
- Added a hook to send config information to save on SAS through admin panel SAS settings.

Version 1.4.4
- Fix to allow downloading images for site posts directly from a URL without an extension.

Version 1.4.5
- Added Two Factor after sign up in the checkout step.
- Fixed error when copying shortcode in admin

Version 1.4.6
- Implemented two factor in sign up page.
- Implemented search filters shortcode

Version 1.4.7
- Updated booking payment of guest panel

Version 1.4.8
- The seted_up function for guest panel login has been updated.

Version 1.4.9
- Implemented a procedure to log the user out when they are not logged in but have data in local storage.

Version 1.4.10
- UI adjustments for properties card, login modal, checkout modal and guest area.

Version 1.4.11
- Updated email validation method for new users.

Version 1.4.12
- Fixed a store error, it was calling a function that didn't exist in that store, but rather in useUserStore().pull integration and fix errors.

Version 1.4.13
- Implemented a new shortcode for listing all filters.

Version 1.4.14
- Rework filter shortcode [searchandstay_exclusive_accommodations_filter]. Update to [searchandstay_unique_accommodations_filter].

Version 1.4.15
- Updated width of the property booking modal.

8. Support
----------
If you encounter any issues or have questions, contact us at:
https://breakz.com/breakz-contact-us/

9. CDNs Used
------------
To maximize performance and eliminate local dependencies, the plugin utilizes the following external libraries via CDN:

Vuetify: UI component library based on Material Design.
CSS: https://cdn.jsdelivr.net/npm/vuetify@3.6.0/dist/vuetify.min.css
JS: https://cdn.jsdelivr.net/npm/vuetify@3.7.4/dist/vuetify.min.js

Swiper: Library for creating sliders and carousels.CDN: https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.cssCDN (JS): https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.js

Material Design Icons (MDI): Icons based on Material Design.CDN: https://cdn.jsdelivr.net/npm/@mdi/font@7.4.47/css/materialdesignicons.min.css

Leaflet: Library for interactive maps.CDN (CSS): https://unpkg.com/leaflet@1.9.3/dist/leaflet.cssCDN (JS): https://unpkg.com/leaflet@1.9.3/dist/leaflet.js

Moment.js: Date and time manipulation library.CDN: https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.1/moment.min.js

Vue.js: JavaScript framework for reactive interfaces.CDN: https://unpkg.com/vue@latest

Vue Router: Routing management for Vue.js.CDN: https://unpkg.com/vue-router@4.0.15/dist/vue-router.global.js

Lodash: Utility library for data manipulation.CDN: https://cdn.jsdelivr.net/npm/lodash@4.17.21/lodash.min.js

IMask: Input masking library.CDN: https://cdnjs.cloudflare.com/ajax/libs/imask/7.6.1/imask.min.js

Pinia: State management for Vue.js.CDN: https://unpkg.com/pinia

Vuelidate: Validation library for Vue.js.CDN (Core): https://cdn.jsdelivr.net/npm/@vuelidate/coreCDN (Validators): https://cdn.jsdelivr.net/npm/@vuelidate/validators

Axios: HTTP request library.CDN: https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js

Stripe.js: Library for Stripe integration.CDN: https://js.stripe.com/v3/

Iconify: Icon library.CDN: https://code.iconify.design/3/3.1.0/iconify.min.js

10. Shortcodes
--------------
1 - [sas_logo]
	Displays the custom website logo that has been configured within the Search and Stay admin panel. This ensures brand consistency across the site.
2 - [property_title]
	Displays the main title or name of the property.
3 - [property_description]
	Displays the full-length description of the property.
4 - [property_image]
	Renders an image carousel or gallery for the property, allowing users to browse through all available photos.
5 - [property_basic_information]
	Outputs a summary of the property's essential details, such as availability.
6 - [property_house_configuration]
	Outputs a summary of the property's essential details, such as the number of bedrooms, bathrooms, and guest capacity.
7 - [property_amenities]
	Lists all the amenities available at the property (e.g., Wi-Fi, swimming pool, air conditioning).
8 - [property_price]
	Shows the current pricing information for the property. This includes the nightly rate.
9 - [property_rating]
	Displays the property's average user rating.
10 - [property_address]
	Displays the full address of the property.
11 - [property_pid]
	Outputs the unique Property ID (PID). This is often used for internal reference or advanced integrations.
12 - [single_property_selection]
	Displays the primary property selection interface. This is a crucial component for the single property view, often including the booking widget and primary details.
13 - [property_maps_all]
	Displays a map with markers for all available properties. This provides a comprehensive geographical overview of your listings.
14 - [property_maps_load]
	Embeds an interactive map that dynamically loads property markers as the user pans and zooms. This enhances performance for sites with a large number of listings.
15 - [property_list_view_port]
	'Displays a list of properties within a defined viewport. This is particularly useful for embedding a selection of properties within a blog post or a promotional landing page.
16 - [property_house_rules]
	Displays the specific house rules that guests must adhere to.
17 - [property_holiday_types]
	Shows the "Holiday Types" associated with the property (e.g., Beach, Ski, Urban).
18 - [property_holiday_suitable]
	Lists the suitability of the property for different holiday styles or groups (e.g., Family-friendly, Romantic getaway).
19 - [property_availability]
	Displays the property's availability calendar, showing booked and available dates.
20 - [saswp-property-search-form]
	GRenders a powerful property search form featuring an autocomplete address field. This allows users to search for any location, providing maximum flexibility.
21 - [saswp-property-search-form-location]
	Generates a property search form that uses a dropdown menu for location selection. This dropdown is dynamically populated only with locations that have available properties, ensuring users don't encounter empty search results.
22 - [banner_single]
	Creates a visually appealing banner using the first five images from the property's gallery.
23 - [banner_multi]
	Banner with the first 5 images of the first 5 properties - Multi Property Theme
24 - [search_single]
	Search for check-in, check-out, guests, and pets for the property - Single Property Theme
25 - [saswp-theme-home-discover]
	Property listing based on the token
26 - [searchandstay_accessibility_filter]
    Filter for searching accessible accommodations.
27 - [searchandstay_sustainability_filter]
    Filter for searching sustainable accommodations.
28 - [searchandstay_pets_filter]
    Filter for searching accommodations with pets.
29 - [searchandstay_pools_filter]
    Filter for searching accommodations with pools.
30 - [searchandstay_houses_linen_filter]
    Filter for searching accommodations with linen.
31 - [searchandstay_waterfront_filter]
    Filter for searching waterfront accommodations.
32 - [searchandstay_beachfront_filter]
    Filter for searching beachfront accommodations.
33 - [searchandstay_unique_accommodations_filter]
    Filter for searching unique accommodations.
34 - [searchandstay_ski_filter]
    Filter for searching accommodations for sking.
35 - [searchandstay_dedicated_workspace_filter]
    Filter for searching accommodations with dedicated workspace.
36 - [searchandstay_list_of_filters]
    Sorted list of all filters.