Askshelf

Описание

Askshelf adds an Askshelf menu to your WordPress admin (below WooCommerce) where you type a question, such as «Which products sold best in October, compared with September?», and get a short answer with the numbers behind it.

  • Answers come from WooCommerce Analytics, so they count the same order statuses, take refunds out and use your store’s time zone.
  • Each answer shows which lookups it made and a chart where one helps.
  • Askshelf only reads. It has no way to change your store.
  • Customer names, emails, phone numbers and addresses are never read or sent (sales by country read only the country). Askshelf declines questions about individual people.
  • Your questions and answers are saved in your store’s own database, per user.
  • Works with HPOS (order tables) and the older posts storage.
  • Free to use, with 10 questions a month on the free plan. Paid plans with more questions are available on askshelf.in.

What it can look up:

  • Sales totals and trends for any date range, with comparisons
  • Best-selling products
  • Profit and margin, in total and per product, from WooCommerce’s Cost of Goods Sold feature
  • Sales by category, country, weekday, hour of day or payment method
  • Products about to run out, from stock and recent sales
  • Stock that isn’t selling, and what all your stock is worth
  • Orders by channel, from WooCommerce order attribution
  • New and returning customers, repeat purchase rate and lifetime spend (counts only)
  • Customers who stopped buying (counts only)
  • Coupon results
  • Today’s orders, read live

Free, with no questions used and no AI:

  • A store snapshot at the top of the Askshelf page and on the WordPress Dashboard: net sales, orders and average order for the last 7 days against the 7 before, today so far, gross profit when product costs are on, what runs out in the next 14 days, stock with no sales in 60 days, and what your stock is worth. It works before you connect an Askshelf account.
  • An optional weekly email of the snapshot every Monday morning, sent by your own site.

External services

Askshelf uses the Askshelf service, run by the plugin’s author, to answer questions with an AI model. The store snapshot, the Dashboard widget and the weekly email are worked out on your server and never contact the service. The service is hosted on Supabase at https://uxyidbkbijinwziqwcjt.supabase.co, and accounts are managed on https://askshelf.in. The plugin does not contact the service until a store manager clicks «Start free» or «Use my askshelf.in account».

When you click Start free, the store sends the service its home URL, the WordPress, WooCommerce and Askshelf version numbers, and a one-time challenge. To confirm the request came from your site, the service then makes one request back to your store’s REST API (askshelf/v1/connect-proof), which answers only for that challenge, once, within ten minutes. The service returns a site ID and a secret, which are stored in your database and never shown in the browser. No account or email address is needed.

If you click «Use my askshelf.in account» instead, you are taken to askshelf.in to sign in to your account and approve the connection, then brought back, and the store sends the same facts. The account then holds your email address and plan.

Plans: Plans in the Askshelf top bar opens a checkout run by Dodo Payments (https://dodopayments.com), the merchant of record, which asks for your email address and payment details on its own page and returns you to your admin. «Invoices, card and cancelling» opens Dodo’s customer portal. The plugin never sees payment details. Dodo Payments terms: https://dodopayments.com/legal/terms-of-use, privacy policy: https://dodopayments.com/legal/privacy-policy

Disconnecting or deleting the plugin tells the service, so the store’s secret stops working. It does not cancel a paid plan; cancel it from «Invoices, card and cancelling» first. Reinstalling and clicking Start free on the same address restores the plan and this month’s count.

When you ask a question, your browser sends the service:

  • your question, and the earlier questions and answers in the same conversation;
  • the results of the read-only lookups the AI asked for (for example totals, product names and order numbers, never customer names or contact details);
  • your store’s date, time zone, currency and locale;
  • a short-lived token signed by your store.

The service forwards these to an AI model through OpenRouter (https://openrouter.ai), restricted to providers that do not store or train on the data, and streams the answer back. The service does not store questions, answers or store data. For each connected store it keeps the site ID, home URL and version numbers. For a store or account on a paid plan it keeps the billing customer and subscription IDs, and an account also keeps its email address. It also keeps how many questions were asked each month and how many AI tokens they used.

Questions that contain an email address or phone number are refused in your browser and never sent.

The service counts questions per store to apply your plan’s monthly limit. It also keeps a salted hash of the connecting server’s IP address for two days, to limit how many free stores one server can connect.

  • Askshelf service terms of use: https://askshelf.in/terms/
  • Askshelf service privacy policy: https://askshelf.in/privacy/
  • OpenRouter terms of service: https://openrouter.ai/terms
  • OpenRouter privacy policy: https://openrouter.ai/privacy

Privacy

Askshelf adds no cookies and no tracking. See «External services» above for what is sent when you ask a question. Uninstalling the plugin tells the service the store is disconnecting, then deletes its settings, the connection, the weekly email schedule and all saved conversations.

Custom queries (off by default, in Askshelf settings) let the AI write a read-only database query for questions no built-in lookup answers. You see each query and choose whether to run it. It can only read sales, product, stock, coupon and category tables, never customer names, emails, phones or addresses, and runs in a read-only transaction with a five-second limit.

Скриншоты

Часто задаваемые вопросы

Does Askshelf change my store?

No. Every lookup is read-only, and there is no code in the plugin that writes store data. The only things it saves are its own settings and your chat history.

Which order statuses does it count?

The same ones as WooCommerce Analytics. Change them in Analytics › Settings › Excluded statuses, and Askshelf follows.

Some numbers look low.

Askshelf reads the Analytics tables. If Analytics hasn’t finished importing your older orders, the first screen shows a warning. Import them in Analytics › Settings.

Is Askshelf free?

Yes. The plugin is free, and every feature in it works on every plan. Answering questions uses the Askshelf service, and the free plan includes 10 questions per store each calendar month (UTC), with no account. Every question counts, including ones Askshelf declines as off-topic. Stopped questions, errors and questions blocked for personal data don’t.

Paid plans include more questions each month; see https://askshelf.in/#pricing. Buy, change or cancel one from Plans in the Askshelf top bar. Checkout and billing are by Dodo Payments; the plugin never takes payment details.

The weekly email says WordPress could not send it.

The weekly email is sent by your own site with WordPress’s built-in mail, so it needs a site that can send email. Some hosts do not provide this. If «Send one now» fails, install an SMTP plugin (for example WP Mail SMTP or FluentSMTP) and connect it to your email provider, then try again. The message shows the reason WordPress gave.

Who can use it?

Anyone with the «View WooCommerce reports» capability (store managers and administrators by default). Connecting, changing what Askshelf may read and the weekly email need «Manage WooCommerce».

Отзывы

Нет отзывов об этом плагине.

Участники и разработчики

«Askshelf» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

Перевести «Askshelf» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

0.4.1

  • Fix: the Settings entry in the Askshelf menu now opens the settings dialog.
  • Fix: the live demo now opens on the Askshelf menu page instead of the old Analytics address.

0.4.0

  • New: Askshelf now has its own menu in the WordPress admin, below WooCommerce, with Ask and Settings entries. Settings opens the settings dialog.
  • Change: the page moved from Analytics › Askshelf to the Askshelf menu, at a new address. Update any bookmarks.

0.3.1

  • Fix: when the weekly email can’t be sent, the message now shows the reason WordPress gave, and the FAQ explains how to fix it.

0.3.0

  • New: Start free connects in one click, with no account. Buy, change or cancel a plan from Plans in the Askshelf top bar.
  • New: an ask-first start page with suggestions from your store, up to three things that need attention, and the full snapshot one click away.
  • New: «How I got this» under every answer shows each lookup, its dates and settings, and its caveats. Download CSV on answers with a chart or table.
  • New: optional custom queries for questions the built-in lookups can’t answer, shown to you before they run.
  • Answers now state the numbers and the change in the text, not only in the chart.
  • Deleting the plugin now disconnects the store from the service. A note on the Plugins screen says it doesn’t cancel a paid plan.

0.2.0

  • New: a free store snapshot on the Askshelf page and the WordPress Dashboard, with no questions used.
  • New: an optional weekly snapshot email.
  • New lookups: profit and margin (WooCommerce Cost of Goods Sold), sales by category, country, weekday, hour or payment method, new and returning customers, and stock that isn’t selling.

0.1.0

  • First release on WordPress.org.