Putting courses on your website
Branches are parts of Grapevine you place on your own website. A course card on your home page, the whole catalog on a “Training” page, a course with its lessons, an enroll button that takes payment without sending anybody away. They look just as they do on your Grapevine site, and they are your Grapevine site underneath: the same courses, the same learners, the same records.
The Branches there are
| Branch | What it shows |
|---|---|
| Course card | One course, as a card |
| Course outline | A course’s modules and lessons |
| Catalog | Your courses, a page at a time |
| Sign in | Signing in to your Grapevine site |
| Course | The whole course, with its lessons |
| Lesson | A single lesson |
| Enroll | Enrolling, and paying for a priced course |
| My courses | The courses a learner is on |
| Progress | How far a learner is through a course, as a bar or a line of text |
| My grades | A learner’s grades on a course |
| Links | Links into a course, as a list or a menu |
| Gradebook | The course gradebook, for its instructors |
Every one of them, working, with the code for each, is in the Branches gallery on this site.
What you need first
Branches are included in every paid plan.
Branches use the Grapevine API, so in Site Admin → Integrations, in the API section:
- Turn on the API for the site.
- Add your website’s address to Websites allowed to use it. Only the websites in that list can show your courses.
- Create a Publishable key. It goes in the code you paste into your website, and it is safe there.
Turning on the API covers each of these. Until they are done, the Branches section further down the same tab says what is missing, with a button to Open the API section.
Three ways in
The Branches section gives you the code already filled in with your site’s address and your publishable key. Copy it rather than typing it.
A WordPress website
Under For your platform, Download the Grapevine Branches plugin. The download link works for an hour; come back for a new one. Then:
- In WordPress, go to Plugins → Add New → Upload Plugin, choose the file, then install and activate it.
- Back in the API section, add the WordPress site’s address to the websites allowed, and create a Restricted key with only
learners:linkandsessions:write. - In WordPress, go to Settings → Grapevine Branches and enter your Grapevine site’s address, the publishable key and the restricted key. Press Test the connection.
- Add the Grapevine blocks to your pages, or paste a course’s address on a line of its own.
Updates to the plugin arrive in WordPress’s own Updates screen.
Any other website
Under On any website is one script tag. Paste it into your website once, then place a Branch where it should appear — the gallery has the line for each one.
Squarespace, Webflow and Wix
Under Website builders, each builder has the exact code it takes and where it goes, with a link to that builder’s own help for the details: Squarespace’s Code Injection and a Code block, Webflow’s Custom code and a Code Embed element, Wix’s Custom element.
Taking payment on your page
The Enroll Branch takes payment for a priced course on your website itself, in Stripe’s own card field. It is the same checkout your Grapevine site uses, so the price, Grapevine’s fee and the enrollment all work exactly as they do there, and the money goes to your Stripe account. Your site needs Stripe connected first — see Taking card payments with Stripe.
Stripe confirms a payment a moment after the card goes through, and the learner is enrolled when it does, so there can be a short wait before the course opens. If your website limits which scripts may run on it, it needs to allow Stripe’s.