=== Botastico Script Inserter ===
Contributors: Botastico
Tags: botastico, script, chatapp, chat, app, app id, id
Tested up to: WordPress 6.4
Requires at least: WordPress 6.3.2
Stable tag: 1.0.5
License: GPLv2 or later

## Description

The Botastico Script Inserter WordPress plugin allows you to effortlessly embed the Botastico script, using your specific app ID, directly into the head section of the HTML document. This lightweight and easy-to-use plugin simplifies the process of integrating Botastico scripts into your WordPress site, enabling you to harness the power of Botastico with minimal effort.

## Features

- Embed the Botastico script with your specific app ID.
- Define `excludePaths` to specify URL path fragments where the chatbot icon should not be displayed. If no paths are defined, the chatbot icon will appear on all URLs.
- Seamless integration into the head section of your HTML documents.
- Enhance user experience and engagement by leveraging Botastico features.
- Display clear success and error messages when saving settings.
- Interactive plugin settings page with the Botastico logo for enhanced brand recognition.

## Installation

1. From your WordPress dashboard, navigate to `Plugins` in the left sidebar.
2. Click `Add New` to access the WordPress Plugin Menu.
3. In the search bar, enter `Botastico Script Inserter` and press `Enter`.
4. Locate the `Botastico Script Inserter` plugin in the search results, and click `Install Now`.
5. After installation, activate the plugin by clicking `Activate`.
6. Once activated, navigate to the plugin settings under `Settings` -> `Botastico Script Inserter`.
7. Configure the plugin by providing your Botastico app ID and defining `excludePaths` as needed.
8. Save your settings, and the Botastico script will be automatically embedded into the head section of your HTML documents, excluding the specified paths.

## Frequently Asked Questions

#### How do I obtain a Botastico app ID?

You can obtain a Botastico app ID by visiting the [Botastico website](https://www.botasti.co/) and signing up for an account. Once registered, you can create and manage your Botastico apps, and each app will have its unique app ID.

#### Can I customize the placement of the Botastico script in my HTML documents?

The Botastico Script Inserter plugin automatically embeds the script into the head section of your HTML documents for optimal performance and functionality.

#### How do I define `excludePaths`?

In the plugin settings, under `Exclude Paths`, enter comma-separated string fragments. The chatbot icon will not be displayed on any URLs containing these fragments. For example: `programs, about, contact`.

## Changelog

### 1.0.4
- Added Admin Notices to provide feedback when settings are saved or when errors occur.
- Improved security by verifying nonces during form submissions.
- Enhanced validation to ensure each exclude path is a non-empty string.
- Integrated the Botastico logo into the plugin listing and settings page for better brand recognition.
- Updated CSS to refine the appearance of the settings page and submit button.
- Updated plugin version in the header to reflect the latest changes.

### 1.0.3
- Implemented conditional inclusion of `excludePaths` parameter in the injected script.
- Updated documentation to reflect default behavior when `excludePaths` is not set.
- Incremented plugin version to `1.0.3` for tracking changes.

### 1.0.2
- Removed restrictions on `excludePaths`; any string fragment is now allowed.
- Enhanced validation to ensure each exclude path is a non-empty string.
- Improved error handling and user feedback on the settings page.

### 1.0.1
- Added validation to ensure `excludePaths` start with `/` and contain only allowed characters.

### 1.0.0
- Initial release of the Botastico Script Inserter plugin.

## Support

If you encounter any issues or have questions about using the Botastico Script Inserter plugin, please contact our support team at [fantastico@botasti.co](mailto:fantastico@botasti.co).

---

## Upgrade Notice

### 1.0.4
**Important:** This update introduces Admin Notices for better user feedback and integrates the Botastico logo for enhanced brand visibility. Please ensure to review your settings after updating to take advantage of these new features.

---

## License

This plugin is licensed under the GPLv2 or later. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation.

---

*This plugin is not affiliated with or endorsed by WordPress.org or the WordPress Foundation.*