Docs
Getting started
From an empty WordPress site to your first sold program in about twenty minutes. Every step below is something you do once.
You need: a WordPress site on version 5.8 or later with PHP 7.4 or later, a BOS account (free, opens as soon as you confirm your email), and WooCommerce if you want to sell. The lesson library works without WooCommerce.
1. Installing the plugin
Download bos-lessons.zip, then in your WordPress admin go to Plugins → Add New → Upload Plugin, choose the file and activate. The WordPress.org listing is under review; once it is live you can also install it from Plugins → Add New by searching for BOS Lessons.
The plugin adds one settings page (Settings → BOS Lessons), three shortcodes and, when WooCommerce is active, a “Program in the app” field on every product. It creates no tables and stores nothing about your students in WordPress.
2. Connecting your API key
Open your BOS dashboard at app.bos.work, open Programs and copy the API key from the WordPress card. In WordPress open Settings → BOS Lessons, paste the key and save. The page shows “Connected to BOS account #…” when the key is accepted.
The key identifies your account on every call the plugin makes. Keep it private; if it leaks, ask us for a new one and the old one stops working at once.
3. Creating a program
Lessons and programs live in the BOS dashboard, not in WordPress, so one upload serves your site and your app.
- Add lessons. Lessons → Add: a title, the audio file or a YouTube or Vimeo link for video, a cover picture (portrait, 720 × 1265 works best) and a short description.
- Group them into a program. Programs → Add: name, description, cover, then pick the lessons in the order students should take them. Set the status to on.
- Check it on your site. A page with
[bos_lessons_programs]lists every program that is on, and/program/<id>-<name>/shows one program. Changes appear within ten minutes, or at once when you save any product in WooCommerce.
4. Linking a WooCommerce product
Selling is a WooCommerce product with one extra field.
- Create a page with the slug
programcontaining[bos_lessons_program]. This one page serves every program at its own URL. - Products → Add New: name and price as usual. Under the General tab pick the program in Program in the app. Save.
- Put
[bos_lessons_programs]on your shop or home page. Each program now shows a Buy Now button that goes straight to checkout.
What happens on an order: when it is paid (status Processing or Completed) BOS opens the program for the buyer’s email, creates the student account if it is new, and sends a welcome email with a set-password link. The thank-you page sends the buyer into the player already signed in with the program open. A refund or cancellation closes the program again. Everything is keyed on the buyer’s email, so the same person can later sign in to your app with it.
Shortcodes
The lesson library
[bos_lessons_app]
The full player on one page: sign-in, search, favourites, history, audio and video playback, program progress. Put it on a page named something like Lessons or App and link it from your menu. Students are sent here after checkout.
All programs
[bos_lessons_programs]
A grid of every program with cover, price and Buy Now. Programs without a linked product show a View program button instead.
One program
[bos_lessons_program id="26"]
The program’s cover, description, price and lesson list, built from what you wrote in BOS. On the page with slug program leave out the id: the page serves every program at its own URL. On a WooCommerce product page that is linked to a program the id is not needed either.
FAQ
Do students need a WordPress account?
No. Students sign in to BOS inside the player. WordPress users and roles are untouched, and nothing about students is stored in your database.
Can I use my own payment provider?
Yes. Checkout is plain WooCommerce, so Stripe, PayPal, bank transfer or any WooCommerce gateway works. BOS takes no fee on sales.
Does it work with my theme and page builder?
The shortcodes work anywhere shortcodes do: the block editor, Elementor, Divi, classic editor. The library inherits your site’s fonts and colours.
What about video?
Host video on YouTube (unlisted is fine) or Vimeo and paste the link on the lesson. Audio files upload directly to BOS.
How do students get the mobile app?
On the App plan we publish an iOS and Android app under your name. Students sign in with the same email and password they use on your site, and their purchases are already there.
Something is not showing.
Programs appear only when their status is on and, for selling, when a product is linked. The plugin caches program data for ten minutes; saving any WooCommerce product or the plugin settings clears it. If the settings page shows a connection error, re-copy the API key. Still stuck? Write to [email protected] with your site address.