WT Max bot - JoomShopping

Description

WT Max bot - JoomShopping

WT Max bot - JoomShopping sends JoomShopping store order data to the Max messenger. Delivery is handled through the WT Max library and system plugin, so this JoomShopping plugin only configures when to send, how to render the message, and which chat receives it.

Before Configuration

• JoomShopping must be installed and working.
• The WT Max library and WT Max system plugin must be installed and configured with the bot token.
• The bot must have access to the target Max chat or channel. The chat is selected directly in the Max chat ID for orders parameter. If no chat or channel is selected in the plugin, the default chat or channel from the settings of the WT Max library plugin will be used.

Configuration Steps

1. Install the plugin package through the Joomla extension manager.
2. Open Plugins and enable JoomShopping - WT Max bot.
3. Select when the notification is sent in Send information about new orders.
4. If Order status change is selected, choose the target order status. If no status is selected, no status-change notification will be sent.
5. Select the Max chat for orders. The field comes from WT Max and lists chats available to the bot.
6. Adjust the Markdown message template and the single item template if needed.
7. Enable Debug temporarily while diagnosing delivery issues. The plugin writes to plg_jshopping_wtmaxbotjshopping.log.

Plugin Parameters

Send information about new orders

Value: Always, Successful payment, or Order status change. What it does: selects the JoomShopping event that triggers a Max message. Why it matters: the store can notify managers immediately after checkout, only after payment, or only when the order reaches a workflow status.

Order status

Value: one JoomShopping order status. The field is shown only for Order status change. What it does: limits notification delivery to the selected status. Why it matters: it is useful when a Max message should appear only after confirmation, payment, preparation for shipping, or another business step.

Message template

Value: Markdown text with variables such as {{order_number}}, {{order_total_formatted}}, {{order_items}}, and {{order_address}}. What it does: renders the final notification text. Why it matters: the message structure can be changed without editing plugin code.

Message template help

Value: an expandable HTML reference with supported JoomShopping order properties and plugin-computed values. What it does: lists usable variables inside the plugin settings. Why it matters: the template can be assembled without looking into JoomShopping database tables or source code.

Order item template

Value: Markdown for one order item, for example - {{product_name}} x {{product_quantity}}: {{product_item_price_formatted}}. What it does: renders every product line and inserts the result into {{order_items}}. Why it matters: the order composition can be formatted independently from the main message.

Order item template help

Value: an expandable HTML reference with supported JoomShopping order item properties. What it does: lists product, quantity, price, attributes, weight, vendor, and service-field variables. Why it matters: it makes product-line formatting predictable.

Max chat ID for orders

Value: a Max chat selected through the WT Max field. What it does: sets the recipient for order notifications. After saving, WT Max shows the selected chat card and stores its chat_id in plugin parameters. Why it matters: orders can go to a dedicated managers chat without changing the global WT Max setup.

Debug

Value: Yes or No. What it does: when enabled, writes successful deliveries and diagnostic entries to plg_jshopping_wtmaxbotjshopping.log; errors are logged for troubleshooting. Why it matters: it helps identify why a notification was not sent or what Max returned.

Templates And Order Data

Shortcodes are named after JoomShopping order object properties. Scalar order and order-item fields are supported, along with plugin-computed values: {{order_items}}, {{order_items_count}}, {{order_address}}, {{order_billing_address}}, {{order_delivery_address}}, {{order_total_formatted}}, {{order_shipping_formatted}}, {{order_payment_name}}, {{order_shipping_name}}, {{order_status_name}}, and {{product_item_price_formatted}} for item rows.

Delivery Audit

The plugin stores an audit record for each order in its own table: order_id, Max delivery status, chat_id, and message_id. This makes delivery checks and integration debugging easier for developers.