CanalYar Channel Posts for Telegram, Bale and Rubika

CanalYar turns any WooCommerce product into a ready-made channel post — name, product code, price (with the old price struck through on sale), colors, attributes, your support ID and a buy link — and posts it with the product images to your channels on Telegram, Bale and Rubika. This plugin is the WordPress side of the CanalYar service (canalyarr.ir). Posts are delivered by the service's bots, so you need a CanalYar account and connection key. New accounts get a free trial; after that, a paid plan is required. See "External services" below for exactly what is sent. What makes it different Usually you have to create a bot for every messenger, paste its token into your site, and — if your server cannot reach Telegram — find a proxy too. CanalYar needs none of that:

• The bot is ours. You only make our bot an admin of your channel.
• No token ever enters your site, so there is nothing to leak.
• No access problems. Our server reaches all three messengers; your server does not have to.

One post, not many Telegram and Bale receive the images as an album with the text as its caption, so every product is a single post. Rubika has no albums, so the main image goes with the text. It runs by itself

• Auto send: every product published for the first time is sent to the channels you choose about a minute later.
• Scheduling and queue: send a post at a set day and hour, or add it to a queue that posts at a fixed gap within the hours you allow.
• Posts stay current: when a price changes, the channel posts are edited; a product that sells out gets an "Out of stock" label or is removed.

Send anything, not only products On the Send message tab you can post your own text to the channels, alone or with up to 10 images (an album), a file (PDF, ZIP, …), a song (MP3/M4A, with a music player) or a video (MP4), picked from the media library — up to 30 MB. One account, with or without WordPress The same CanalYar account also works without this plugin: in the web panel at canalyarr.ir you can add channels and send text, images, files, music and video from any browser, with no website at all. The plugin adds what only WooCommerce access makes possible — posts built from products, auto send, scheduling and prices kept current. Channels, quota and reports are shared between the panel and the plugin, and developers can use the same key with the REST API. Channel ownership check Because the bot is shared, "the bot is an admin" is not enough. When you add a channel, a six-digit code is posted in that channel and you enter it in the dashboard. Until you do, nothing is posted there — so nobody else can post to your channel. Languages The plugin is in English with a full Persian (fa_IR) translation included. Channel posts are written in your site's language, even when your own dashboard language is different.

1. Install and activate the plugin (WooCommerce must be active).
2. Sign up at canalyarr.ir/panel with your mobile number (there is a free trial) and copy your connection key.
3. Go to CanalYar → Connection & subscription and enter the key.
4. Make the bots shown there admins of your channels with the "Post messages" permission.
5. On the Channels tab, add each channel and verify it with the six-digit code.
6. In the product list, click Send to channel — or turn on auto send.

A full guide is on the plugin's Guide tab.

1.13.3

• Fix: product links with non-Latin (e.g. Persian) slugs were broken in posts sent by hand, because the %xx parts of the address were stripped.
• Bale now shows text as a clickable text too.

1.13.2

• The free-form message page now explains the text and ~strikethrough~ formatting.

1.13.1

• Post template: text turns a text into a clickable link on Telegram (for example Buy on our website); Bale and Rubika get "text: link". ~Strikethrough~ now also works on Telegram through the shared bot.

1.13.0

• All internal names (classes, constants, options, hooks, post meta) now use the unique prefix "canalyarr" instead of "mkc". Existing settings, send history and queued posts are moved over automatically on update.
• Developers: the filters are now canalyarr_post_values, canalyarr_post_installments and canalyarr_post_installment_offers.

1.12.2

• Plugin renamed to "CanalYar Channel Posts for Telegram, Bale and Rubika" (WordPress.org does not allow "WooCommerce" in plugin names).

1.12.1

• Plugin renamed to "CanalYar Channel Posts for Telegram, Bale and Rubika" to make clear it is a third-party integration.

1.12.0

• New post placeholder {base_price_number}: the base price without the installment markup, number only (filled by the cash and installment pricing plugin; otherwise the same as {price_number}). Price sync updates it in earlier posts too.

1.11.3

• Send queue: posts keep to their time slot, so with a daily gap they go out at the same hour every day instead of drifting later.

1.11.2

• Send queue: the gap between two posts can now be 1, 2 or 3 days or a week.

1.11.1

• Documentation: the same account works from the canalyarr.ir web panel without WordPress; new FAQ entries about sending messages and files.

1.11.0

• Send queue: choose which days of the week the queue may post on.

1.10.1

• Fix: scheduling a send for a set time was rejected as "in the past" on sites running a Persian (Jalali) date plugin.

1.10.0

• New "Send message" tab: post any text to your channels, with images, a file, a song or a video from the media library.

1.9.7

• Server messages follow the dashboard language (English outside Persian dashboards).

1.9.6

• Update details follow the dashboard language.

1.9.5

• Persian FAQ in update details.

1.9.4

• Persian installation guide in update details.

1.9.3

• Update details are shown in Persian.

1.9.2

• Plugin name and description are translated into Persian on Persian sites.

1.9.1

• New CanalYar logo as the admin menu icon.

1.9.0

• The plugin is now in English, with a full Persian translation included. Channel posts are always written in the site language.
• Dates follow the dashboard language: Jalali dates and Persian digits in Persian, WordPress dates otherwise.
• Fix: the "Color attribute" setting on the "Post template" tab had no effect.

1.8.3

• Guide: link to the API documentation for non-WordPress sites.

1.8.2

• Full guide to auto send, scheduling and the queue, keeping posts up to date, and panel features on the "Guide" tab.

1.8.1

• Fix: the send queue counts its gap from the channel's last post (manual, scheduled or automatic), not only from its own previous post.

1.8.0

• Channel posts are edited automatically when the price changes.
• A product that sells out gets an "Out of stock" label (or, if you choose, its posts are deleted); the label is removed when it is back in stock.

1.7.0

• Scheduled sending: pick a day and hour in the send window.
• Send queue: posts go out at a fixed gap within allowed hours; auto send can use the queue too.

1.6.0

• Auto send for newly published products.

1.0.0

• First release.