Rahkar Toolkit
| 开发者 | whoman |
|---|---|
| 更新时间 | 2026年11月2日 01:49 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Rahkar Toolkit puts the tools an Iranian WooCommerce store needs into one plugin: Iranian provinces and cities, SMS login, Jalali dates, Persian invoices and order notifications.
Every feature is a module. Switch on only what you use: a module that is off loads no code and runs no queries.
Checkout and orders
- Iranian provinces and cities: the full list in WooCommerce address forms, for the classic and the block checkout, with a city dropdown that follows the province. Each shipping method can be limited to some cities, or kept away from some.
- Price inquiry: hide the price and the buy button on chosen products and take requests for the price instead, with optional SMS verification and a price reply by SMS.
- Checkout fields: drag the checkout fields into order, make each one required or optional, or leave it out. Works with the classic checkout, the block checkout and themes that draw their own form, and adds nothing to the customer's browser.
- Invoices and shipping labels: Persian sales invoices and postal labels, for one order or many at once, through the browser's print and "Save as PDF".
- Guest order tracking: customers without an account follow their order by mobile or order number, confirmed by a one-time code sent to the number on the order.
- Courier status: an order status for orders handed to a motorbike courier, changeable in bulk from the orders list.
- Jalali calendar: Solar Hijri dates across WordPress and WooCommerce, with a Persian date picker. Stored dates are never changed.
- SMS login and registration: passwordless sign-in and sign-up with a one-time code by SMS, voice call or email, inside the theme's own login forms (full support for Woodmart). Optional phone verification before checkout. If codes stop getting through, sign-in falls back to the password form.
- Notifications: SMS and email on order and account events, with an editor per event, approved SMS patterns, a background queue with retries and a log. Send rules hold promotional messages during quiet hours and respect an opt-out list.
- Short links: links in messages become short links on your own domain. Clicks are counted, and an order placed within 7 days is tied to the message that brought it.
- Customer testimonials: testimonials with photo, voice or video, sent from the site and held until you approve them.
- Customer stats: each customer's order count and personal buying cycle, used to time follow-up messages.
- Matomo connection: your own Matomo server tracks products, the cart, internal search and every order, even when the browser blocks the tracker.
- Custom code: your own code in the page head, after the body tag or in the footer, such as analytics, ad pixels or a chat widget, kept when you change themes.
- Rahkar Foroosh connector: sends orders to the Rahkar Foroosh sales dashboard, only after you connect it with a one-time code.
- Abandoned cart: up to three SMS reminders, with a link that rebuilds the cart and opens the checkout.
- Back-in-stock alerts: customers ask to hear when a product is back; administrators get low-stock and out-of-stock alerts.
- Review invitations: a few days after an order is completed, the buyer is invited to review what they bought.
- Second purchase: a unique discount code for first-time buyers who have not ordered again.
- Win-back: messages to regular customers who have fallen behind their own buying cycle, with optional stepped discounts.
- Replenishment reminders: for consumable products, an SMS when the customer is likely to be running out.
- Payment gateway coupons: coupons that work only with chosen payment gateways, optionally applied as soon as the gateway is selected.
- Card-to-card payment: a card-to-card payment method with the store's card and Sheba number, the customer's tracking number on the order, and a status for payments awaiting review.
- Stories: Instagram-style circular stories with photo and video slides, managed in the dashboard.
- WooCommerce 8.0 or later, for every module except Jalali calendar and Notifications.
- An account with the SMS provider below, for SMS sending and SMS login.
安装:
- Install and activate the plugin.
- Go to Rahkar → Modules and switch on the modules you want. A fresh install starts with every module off.
- Open Rahkar → Settings to configure the modules you switched on.
- For SMS: switch on Notifications, enter your IPPanel API key and sender number, and send a test message from the settings screen.
屏幕截图:
常见问题:
Does it slow down my site?
Only by what you switch on. A module that is off is not loaded at all, and modules load only on the kinds of requests they need — the invoice module, for instance, never loads on the storefront.
Does the Jalali calendar change the dates stored in my database?
No. Dates are converted only when shown. Switching the module off returns every screen to Gregorian with nothing to undo.
Which SMS providers are supported?
IPPanel. Other providers can be added by developers through the rahkar_wp_notification_drivers filter.
What happens to my data if I delete the plugin?
It is kept by default, because deleting a plugin is often a troubleshooting step. To remove all tables and settings on deletion, add define( 'RAHKAR_WP_REMOVE_ALL_DATA', true ); to wp-config.php before deleting.
Is the source code of the admin design files available?
Yes. The admin screens use the Rahkar UI design system, whose compiled files are in assets/vendor/rahkar-ui/build/. Its source code is at https://github.com/rahkarnet/rahkar-ui and is built with npm install && npm run build.
更新日志:
0.39.0
- Custom code: a new tab in Settings for your own code in the page head, right after the body tag and before the closing body tag, such as analytics, ad pixels, site verification tags or a chat widget. It stays when you change themes. Only users allowed to post unfiltered HTML can save scripts, and positions left empty add nothing to the page.
- The price inquiry diagnosis box (
?rahkar_inquiry_debug=1) from 0.38.1 is removed; the problem it was built to find is fixed in 0.38.2.
- Fixed: saving a settings tab without changing anything saved nothing, because only changed fields are sent. Saving a tab now confirms that module's settings as they stand. Price inquiry left at its defaults therefore never switched on, while the screen still said "saved".
- While price inquiry is on but its settings have never been saved, the plugin's screens and the product list say so, with a link to its settings.
- Price inquiry diagnosis: an administrator who adds
?rahkar_inquiry_debug=1to a product page gets a box saying where the chain stops: settings not yet saved, the product outside the scope, the page drawing its buy button without WooCommerce's template, or the button printed but hidden. Visitors never see it.
- Price inquiry now answers WooCommerce's add-to-cart template itself, so its button appears wherever that template is drawn: page-builder product layouts (Woodmart's Elementor, WPBakery and Gutenberg layouts, Elementor Pro), quick views and product cards loaded over AJAX. A product that sells normally on the same page keeps its own form.
- Theme integrations: modules now fit themes we support without any switch. When Woodmart is the active theme, price inquiry also takes over Woodmart's sticky add-to-cart bar. The health screen lists which integrations are running.
- New module, Price inquiry. On all products, chosen categories, products without a price or products out of stock, the price gives way to a line of text and the buy button to an "ask for the price" button. Each product can also follow that setting, always ask, or never ask. The button and the texts are editable.
- The button opens one dialog for a name and a mobile number, with an optional notes field. On a phone it rises as a bottom sheet; on rahkartheme it opens through the theme's own sheet. A signed-in customer finds both filled in.
- Optionally the number is checked with a one-time code before the request is filed, using the SMS login's pattern, gateways and limits. A number already verified on the customer's account is not asked again.
- Requests are listed beside the orders, with their status (new, called, price sent, closed), a number to dial and the product and variation asked about. From a request the price goes out by SMS with one button.
- Three new notifications on the notifications screen: request filed (customer), new request (manager) and price reply (customer).
- An inquiry product cannot be bought by any route, its variations stay selectable without a price, and its price is left out of the product schema. Its settings are a tab of the plugin's Settings screen and its messages sit on the Notifications screen with the others. Nothing runs on the storefront until its settings have been saved once.
- The settings screen gains two field types for modules to use: option cards with an explanation each, and a filterable checklist; a field can also show only for one value of another.
- New module, Checkout fields. One list sets the order of the checkout fields, which are shown, which are required, and their labels, placeholders and widths, with a live preview beside it. The classic checkout honours all of it. The block checkout honours order, visibility, required and labels; where it cannot (the email is always required there, and widths and placeholders do not apply) the screen says so on the field. Fields that shipping or sign-in depend on are marked and cannot be switched off.
- On a block checkout the screen offers to switch the page to the classic form, keeping the block content to switch back with one click.
- Nothing runs at checkout until the list has been saved once.
- The settings button on a module card opens that module's own screen when it has one; Matomo's used to land on the general settings.
- City lists set on shipping methods by rahkartheme's older field are carried over as city rules.
- Shipping methods can be limited to cities. On a shipping zone's screen every method shows which cities it serves; clicking that opens a picker where the method is offered in every city, only in the chosen ones, or everywhere except them. A whole province can be chosen at once and then also covers cities added to it later.
- The zone screen warns when its rules leave cities with no shipping method at all, and names them.
- A store with no city rules runs none of this at checkout.
- Invoices show every discount. A line bought on sale shows its regular price struck through above the sale price, with the percentage off next to the product. Each coupon code is listed with its amount, and a "your savings" row above shipping adds up the sale, the coupons and any discount fees. Tax is shown as its own row when there is any.
- The regular price of a line bought on sale is now recorded at checkout, classic or block, so an invoice printed later shows the discount the customer actually had rather than one inferred from today's prices.
- The WooCommerce orders list shows the time an order was placed next to its date, on a 24-hour clock. A new Jalali calendar setting turns it off.
- The design tokens' inline stylesheet is stripped of tags at output, like every other inline style.
- The External services section lists every event the Rahkar Foroosh connector sends, including held-back messages, opt-outs, flow entries, issued coupons, short links and verified numbers.
- Short links also answer the campaign links the Rahkar Foroosh dashboard sends. The token, signed with the store's connection key, opens the home page, a product or a category with the campaign's UTM, reports the click and ties a later order to the campaign. No row is stored for these links, and with the dashboard connector off they open the home page like any unknown link.
- Links can open a module's card on the modules screen (
#rahkar-module-<slug>, highlighted) and a module's first settings tab (rahkar_tab=<slug>), so the Rahkar Foroosh action centre's buttons land on the right module. - The modules screen's "Settings" button now opens that module's tab instead of the first one.
- New module, off by default: Matomo connection. Puts your Matomo server's tracker on the shop with products, categories, the full cart, internal search and orders, and sends each paid order from the server as well, so an ad blocker does not lose it.
- The Rahkar Foroosh connector sends the buyer's Matomo visitor id with each order (contract 1.3) and the Matomo module's server and site with the daily heartbeat.
- The customer-stats log now records when the first fill starts, not only when it ends.