=== Botoscope ===
Contributors: botoscope
Donate link: https://botoscope.com/upgrade/
Tags: woocommerce, telegram, store, shop, bot
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.3
WC requires at least: 9.0
WC tested up to: 10.9
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Stable tag: 1.0.5

Connect your WooCommerce store to Telegram: sell products, bookings and digital goods via your own bot — no fees, no commissions.

== Description ==

**Botoscope** turns your WordPress + WooCommerce store into a full-featured Telegram shop. Your customers browse your catalog, filter products, place orders, book appointments and pay — all without leaving Telegram. You stay in control: no marketplace rules, no commission cuts.

🚀 **Launch your Telegram store in 15 minutes.** Install the plugin, connect your Telegram bot, and you're live.

🔗 [Live Demo Bot](https://telegram.me/botoscope_demo4_bot) | 📚 [Documentation](https://botoscope.com/documentation) | 💬 [Support Forum](https://pluginus.net/support/forum/botoscope/)

---

### 📅 Built-in Booking System — Sell Time-Based Services

Perfect for beauty salons, consultants, fitness trainers, lawyers, dentists, tutors, and any service business.

* **⏰ Weekly schedule templates** — Set your availability once (e.g. Mondays 9 AM – 5 PM)
* **💰 Dynamic pricing per time slot** — Charge $60 for evening appointments, $40 for morning slots
* **👥 Group bookings with capacity control** — Yoga class for 10 people? Set capacity = 10
* **🔄 Clone schedules between days** — Identical days? Copy in one click
* **▶️ Manual reservations for walk-ins** — Cash payments? Reserve a slot instantly from admin

---

### 🎨 Variable Products with Unlimited Combinations

Full support for WooCommerce variable products — with a smooth customer experience inside Telegram.

* **🎨 Multiple attributes** — Size, color, material, and any custom attribute
* **💰 Individual pricing per variation** — Red/Large $50, Blue/Medium $45
* **📦 Separate stock tracking** — 10 red, 5 blue tracked independently
* **🖼️ Variation images** — Different image for each attribute combination
* **📦 In Grouped bundles with variations** — Customer selects variation first, then adds the whole bundle to cart

---

### 💳 Accept Payments Your Customers Use

Every major payment method — from cards to crypto to Telegram's own currency.

* **⭐ Telegram Stars** — Built-in Telegram currency. Instant checkout. Zero redirects.
* **💳 Stripe** — Credit cards, Apple Pay, Google Pay worldwide
* **🅿️ PayPal** — Trusted by millions globally
* **💸 LiqPay** — Popular in Eastern Europe
* **₿ CryptoBot** — Crypto payments directly inside Telegram
* **₿ CoinGate** — Bitcoin, Ethereum and 70+ cryptocurrencies
* **🏦 Bank Transfer** — For B2B and invoice-based orders
* **❤️ PayForMe** — Let someone else pay: send a payment link via Telegram, WhatsApp or email

💡 Please note: Each payment method requires your own account with the respective provider. Botoscope provides the integration layer — payment processing is handled entirely by the gateway you choose.

---

### 🛍️ Sell Any Product Type

One platform, unlimited product types. Mix and match in the same store.

* **📦 Physical Products** — T-shirts, electronics, furniture (Simple & Variable)
* **💼 Services** — Consulting, coaching, legal advice (Virtual + booking)
* **📥 Digital Downloads** — eBooks, software, templates (Downloadable)
* **🔒 Protected Media** — Video courses, audio training — plays inside Telegram, no download possible
* **🔗 Affiliate Products** — Amazon, AliExpress (External)
* **📦 Grouped Bundles** — Sell product sets at a fixed price, even with variable items inside

---

### 📱 Business in Your Pocket — Manage Your Store From Your Phone

Get instant Telegram notifications for everything that matters:

* **🛒 New order alerts** — Customer name, items, payment method, shipping address, daily totals
* **💬 Customer messages → instant replies** — Reply from your personal Telegram. No app switching.
* **📦 Low stock warnings** — Get notified before you lose a sale

---

### 🎯 Promotions & Discount Engine

Create any discount structure without hiring a developer.

* **🎁 Buy X, Get Y Free** — Formula-based campaigns (e.g. `c>=2; 100%; mc`)
* **⚡ Percentage or fixed discounts** — Site-wide or per-category
* **🎯 Target specific products** — Discount only winter jackets, only sneakers, etc.
* **🧪 Test mode** — Preview campaign only for you before going live

---

### 🆘 Built-in Customer Support with Tickets

Professional support built into your Telegram store — no external tools needed.

* **📱 "Manager" button everywhere** — Next to every product and every order in the bot (optional)
* **🎫 Customer creates a ticket** — One tap, they write their question
* **💻 You handle it from WordPress plugin admin side** — Tickets appear in your dashboard
* **💬 Reply → delivered instantly in Telegram** — Customer never leaves the bot
* **📊 Full ticket history** — Who answered, when, what was resolved
* **⚙️ 3 support modes — choose what fits your workflow:**
  * 🤖 **Botoscope system** *(default)* — built-in ticket system as described above
  * 👤 **Telegram username** — "Manager" button opens a direct chat with your Telegram account
  * 🌐 **Web site** — "Manager" button redirects to your external support page or helpdesk

---

### 🌍 Sell Globally — 7 Languages, Multi-Currency
One store. International reach. Zero headaches.

* **🗣️ 7 languages built-in** — English, Spanish, Ukrainian, Polish, Portuguese, Russian, Kazakh — powered by Botoscope's own translation system, no multilingual plugins required
* **💱 Unlimited currencies** — Powered by [FOX - Currency Switcher Professional for WooCommerce](https://wordpress.org/plugins/woocommerce-currency-switcher/). Add any currency your customers use — USD, EUR, GBP, UAH, Telegram Stars, etc. and hundreds more, with auto exchange rates
* **📝 Translate everything** — Products, descriptions, taxonomies directly from admin panel via built-in translation manager
* **🤖 AI Translation** — Auto-translate descriptions into all 7 languages in one click *(requires your own OpenAI API key)*

---

### 🔍 Powerful Product Filters

Thanks to full integration with [HUSKY – Products Filter Professional](https://products-filter.com/) — one of the most advanced WooCommerce filter plugins — your customers can find exactly what they want without ever leaving Telegram.

* **🧩 Visual filter constructor** — Build any filter combination with drag & drop, no coding needed
* **🏷️ Filter by anything** — Category, price range, tags, attributes, custom meta fields, location and more
* **⚡ Results delivered instantly inside the bot** — No redirects, no page reloads, real-time response

---

### 🎟️ Flexible Discount Coupons

* **💯 Percentage or fixed amount** — "SAVE20" for 20% off, "GET10" for $10 off
* **🎯 Product-specific coupons** — Apply to one product or a category
* **📅 Expiry dates** — Create urgency with limited-time codes
* **🔢 Usage limits & minimum purchase amounts**

---

### 📦 Grouped Product Bundles at Fixed Price

Create gift sets and starter kits — sell them as one item at a special price.

* **💰 Fixed bundle price** — Set $50 for a bundle regardless of which variations customer picks
* **🎨 Variable products inside bundles** — Customer selects size/color, then adds the whole bundle
* **📈 Increase average order value** — Bundles outsell individual items every time
* **🎁 Perfect for:** gift sets, starter kits, seasonal collections, clearance bundles

---

### 📢 Broadcasting — Reach All Customers Instantly

Send announcements to every customer who has ever started your Telegram shop.

* **📣 One-click campaigns** — New drop, flash sale, important update
* **No email lists. No spam filters.** Only real opted-in customers.

---

### 🔐 Private Access — Password-Protect Your Store

Set a single secret key in admin — only customers who know it can enter your Telegram shop.

* **🔑 One key, set in admin** — Simple to configure, easy to share with the right people
* **🎁 Pre-launch access** — Let selected customers buy before public release
* **🤫 Exclusive drops** — Share the key only with VIP buyers or wholesale partners

---

### 🏢 B2B Features for Wholesale

* **💼 Minimum order amounts** — Set $500 minimum cart value
* **🔢 Quantity adjusters** — Bulk quantity selectors for large orders

---

### 📚 Catalog Mode — Browse Without Buying
Disable the cart and turn your shop into a browsable catalog.

* **👀 Display-only mode** — Products are visible but not purchasable
* **🔄 Toggle anytime** — Switch between catalog and shop mode in one click

---

### 🤖 AI-Powered Product Descriptions

Generate and improve descriptions with ChatGPT.

* **✨ Auto-generate from product name** — AI writes a full description
* **🌍 Auto-translate** — Into all 7 supported languages in one click
* **✏️ Improve product description** — Fix grammar, enhance tone, optimize for conversions

*Requires OpenAI API key (purchased separately on Open AI site).*

---

### 🧲 Advertising Slots — Promote Anything Inside Your Bot

* **🔄 Rotation support** — Display multiple banners or promotional messages, rotating automatically
* **✏️ You control the content** — Add, edit or disable any ad slot anytime from admin panel

*How you use it is up to you: promote your own bestsellers, seasonal offers, or arrange partnerships with other brands on your own terms. Botoscope is not an ad marketplace — it simply gives you the slots to fill.*

---

### 🌟 Elogios — Build Loyalty with Compliments

Random friendly compliment messages that build emotional connection and bring customers back.

---

### ✏️ Custom Text & Labels — Your Words, Your Voice

Replace any default text in your Telegram shop interface — button labels, messages, hints — with your own wording.

* **✏️ Edit any label or message** — e.g. "Add to Cart" → "Get This!", "Support" → "Talk to Us"
* **🌍 Per-language** — Set different wording for each of the 7 supported languages
* **📝 No coding** — Plain text fields in admin panel, nothing technical

---

### 🚚 Smart Shipping with Conditional Rules
Flexible shipping methods with intelligent pricing.

* **📦 Multiple methods** — Pickup, courier, express, free shipping and more custom ones
* **💰 Conditional pricing** — e.g. free shipping automatically applied over $50

---

### 🛠️ Bulk Product Management ([requires BEAR plugin](https://bulk-editor.com/))

Update 100 products in seconds directly from Telegram shop admin.

* **💰 Mass price updates** — Increase all by 10% in one click
* **📁 Batch category and tag changes**
* **📦 Bulk stock adjustments**
* **🔄 Publish/unpublish multiple products**

---

https://www.youtube.com/playlist?list=PLX-KWhgqncjH19Pa8SnHxqI9iAkQrqVx2

---

### Free vs Premium

**Botoscope is free to start — no credit card, no commitment, no hidden fees.**
Your Telegram shop works from day one. Take your time, explore all the features, and upgrade only when you're ready.

**🆓 Free plan includes:**
* Up to 9 products synced to your Telegram shop
* Up to 200 unique visitors per month
* Up to 4 booking slots
* "Powered by Botoscope" branding in your store
* Manual reconnection required every 14 days — just press one button to keep your shop alive

**⚡ Upgrade to full power → [botoscope.com/upgrade](https://botoscope.com/upgrade/)**
* Up to 1,000 products
* Unlimited visitors
* Unlimited booking slots
* No branding — your store, your identity
* Uninterrupted connection — no manual reconnection needed
* No subscription, no percentage cuts, no commissions — ever
* Top up your balance with vouchers, use as long as you need

💡 *Botoscope is a connector between your WooCommerce store and Telegram. You own your shop, your customers, and every cent you earn. We just keep the connection alive — as long as your balance is topped up.*

---

### Related Plugins

&#9989;&nbsp;[HUSKY - Products Filter Professional for WooCommerce](https://wordpress.org/plugins/woocommerce-products-filter/) — powers advanced product filtering inside your Telegram shop

&#9989;&nbsp;[BEAR - WooCommerce Bulk Editor Professional](https://wordpress.org/plugins/woo-bulk-editor/) — mass-update products directly from your WooCommerce admin

&#9989;&nbsp;[FOX - Currency Switcher Professional for WooCommerce](https://wordpress.org/plugins/woocommerce-currency-switcher/) — multi-currency pricing for your store

&#9989;&nbsp;[TABLEON - WordPress Post Tables Filterable](https://wordpress.org/plugins/posts-table-filterable/) — display products and posts in filterable table format

== External Services ==

= Telegram API (api.telegram.org) =
Used to send notifications to the store owner (new orders, support tickets,
low stock alerts) and to deliver messages to customers inside the Telegram bot.
Data sent: order details, notification messages, bot token.
Sent when: a new order is placed, a support ticket is created, or a stock
alert is triggered.
Terms of Service: https://telegram.org/tos
Privacy Policy: https://telegram.org/privacy

= Shopify API (myshopify.com) =
Used optionally by the Shopify Sync extension to import products from a
Shopify store into WooCommerce. This extension is inactive by default and
only runs when manually enabled and configured by the store owner.
Data sent: Shopify store URL, OAuth client credentials, product data.
Sent when: store owner triggers a manual sync in the admin panel.
Terms of Service: https://www.shopify.com/legal/terms
Privacy Policy: https://www.shopify.com/legal/privacy

= OpenAI API (api.openai.com) =
Used optionally for AI-powered product description generation and
auto-translation. Requires the store owner to provide their own OpenAI API key.
Data sent: product names and descriptions (no customer data).
Sent when: store owner manually triggers AI generation or translation
in the admin panel.
Terms of Service: https://openai.com/policies/terms-of-use
Privacy Policy: https://openai.com/policies/privacy-policy

== Installation ==

1. Download the plugin ZIP or install directly via WordPress admin → **Plugins → Add New**.
2. Activate the plugin.
3. Create a Telegram bot via [@BotFather](https://telegram.me/BotFather) and copy your bot API token.
4. Go to [@botoscope_bot](https://telegram.me/botoscope_bot) — register your shop using the newly created bot. Choose the **free plan** (with limits) or top up your balance for a paid plan.
5. In your WordPress admin, connect the plugin to your Botoscope shop by entering the credentials provided in your Botoscope dashboard. Full step-by-step guide: [https://botoscope.com/docs/installing-botoscope-on-your-woocommerce-store/](https://botoscope.com/docs/installing-botoscope-on-your-woocommerce-store/)
6. Your Telegram shop is live. 🎉

== Frequently Asked Questions ==

= Do I need a Telegram bot to use Botoscope? =
Yes. You create a free bot via [@BotFather](https://telegram.me/BotFather) in Telegram — it takes about 2 minutes. Botoscope connects your WooCommerce store to that Telegram bot.

= Demo? =
Yes! See the live demo at [https://telegram.me/botoscope_demo4_bot](https://telegram.me/botoscope_demo4_bot)

= Does it work with variable products? =
Yes — full support for WooCommerce variable products including per-variation pricing, stock tracking, and images inside Telegram.

= Which payment gateways are supported? =
Telegram Stars, Stripe, PayPal, LiqPay, CryptoBot, CoinGate, Bank Transfer, and the unique PayForMe link system.

= Does it support multiple languages? =
Yes — 7 languages built-in: English, Spanish, Ukrainian, Polish, Portuguese, Russian, Kazakh. All translatable from admin panel with optional AI auto-translation.

= Can I accept bookings / appointments? =
Yes — the built-in booking system supports weekly schedules, dynamic slot pricing, group capacity, and manual reservations. Perfect for salons, consultants, trainers and service businesses.

= Where can I get support? =
[https://pluginus.net/support/forum/botoscope/](https://pluginus.net/support/forum/botoscope/)

= Where can I read the documentation? =
[https://botoscope.com/documentation](https://botoscope.com/documentation)

= Where do I report a security vulnerability? =
You can report security bugs through the Patchstack Vulnerability Disclosure Program — [Report via Patchstack](https://patchstack.com), or through the Wordfence Intelligence Vulnerability Disclosure Program — [Report via Wordfence](https://www.wordfence.com). Both teams help validate, triage and handle any security vulnerabilities responsibly.


== Screenshots ==

https://www.youtube.com/watch?v=4yG2IUTUz9g

1. Telegram shop — product catalog with filters



== Changelog ==

= 1.0.5 =
* Added hook filter: botoscope_get_product_meta
* Added hook action: botoscope_product_meta_updated
* Fixed issue with meta data saving in the product
* Added new option: Hide out of stock products - "Out of stock products will not be visible or synced to Telegram"
* Links changed form t.me to telegram.me

= 1.0.4 =
* Compatibility: fixed compatibility with FOX - WooCommerce Currency Switcher Professional
* Fix: digital product access check now treats both 0 and -1 as infinite access (previously only 0 worked, -1 caused immediate expiry)

= 1.0.3 =
* Security: media casting content access is now protected against unauthorized URL access

= 1.0.2 =
* Fix: product meta fields (e.g. access_days for downloads/casting) were being saved to bot cache before all fields were written to DB, causing a one-save lag in Telegram — bot cache now updates only after the full save loop completes
* Fix: bot cache was updating twice per product save due to two sequential AJAX calls from the frontend — cache update is now skipped on the type-only first call
* Fix: fatal error in botoscope_edit_cell when value is an array (e.g. downloads_order reordering) — value sanitization now handles both string and array types

= 1.0.1 =
* Fix: new product is now assigned the lowest <expression: menu_order - 1> so it appears first when store uses menu order sorting

= 1.0.0 =
* Initial release


== License ==

Botoscope is copyright Botoscope.com &copy; 2025-2026 with [GNU General Public License](http://www.gnu.org/copyleft/gpl.html).
