Description
Green Bridge CBT is a computer-based testing service with past papers and practice tests for WAEC, JAMB, NECO, IGCSE and other exams. This plugin puts those tests on your WordPress site, so your visitors can practise without leaving it.
It is for tutoring businesses, schools and course sellers with a Green Bridge CBT partner account. Sign up for a partner account.
What you can put on a page
- All the free practice papers. Visitors pick a paper by subject and exam, then sit it on your page. They do not need to log in.
- A catalogue. A shorter list of papers that you choose in the partner console, such as only JAMB Mathematics.
- One practice paper.
- One of your own tests. Tests you write in the partner console, sat by your logged-in WordPress users under their own accounts. Their grades come back to your site. Your own tests need the Starter plan or above.
Adding a test to a page
If you use the standard WordPress editor: click the + button, search for “Green Bridge CBT” and add the Green Bridge CBT test block. Straight away, it shows all the free practice papers. To show something else, look at the Green Bridge CBT panel on the right of the editor and change Show to a catalogue, a single paper, or one of your own tests. Your own tests appear in a list, so you just pick one.
If you use the classic editor or a page builder: paste one of these lines into your page where you want the test to appear.
- For all the free practice papers:
[greenbridgecbt] - For one of your catalogues:
[greenbridgecbt catalogue="CATALOGUE_ID"] - For one practice paper:
[greenbridgecbt paper="PAPER_ID"] - For one of your own tests:
[greenbridgecbt test="TEST_ID"]
Replace CATALOGUE_ID, PAPER_ID or TEST_ID with the id from the partner console. The FAQ below shows where to find it.
To make the test taller, add a height in pixels, such as [greenbridgecbt height="900"]. To show it in another language, add a two-letter language code, such as [greenbridgecbt language="fr"].
External services
This plugin connects to Green Bridge CBT (https://www.supergb.com), run by Eagle Beacon Global, to show tests and receive grades.
- On pages with a shortcode or block, the visitor’s browser loads https://www.supergb.com/cbt/js/embed/v1.js and the test itself from www.supergb.com, with your practice papers key (publishable key).
- When a logged-in user opens one of your own tests, your server sends Green Bridge CBT the test id and a unique anonymous id for the user. Depending on the setting you choose, it also sends their display name, or their display name and email address.
- The settings page’s “Check your tests key” button and the block editor’s test list call Green Bridge CBT from your server with your tests key (secret key).
- Green Bridge CBT sends learners’ grades to your site’s address when you add it under Grades in the partner console. Each request is signed with your grades key, and the plugin rejects any request that is not.
Terms of use: https://www.supergb.com/cbt/users/legal/terms-and-conditions
Privacy policy: https://www.supergb.com/cbt/users/legal/privacy-policy
For developers
When a grade arrives, the plugin runs the greenbridgecbt_attempt_graded action with the WordPress user id, the test id and the result, which includes score, max_score and percent:
add_action( 'greenbridgecbt_attempt_graded', function ( $user_id, $test_id, $result ) { /* ... */ }, 10, 3 );<h3>Security</h3>
Report a security problem to feedback@eagle-beacon.com. Fixes are released through WordPress plugin updates.
Blocks
This plugin provides 1 block.
- Green Bridge CBT test A Green Bridge CBT practice paper, a catalogue of papers, or one of your own tests.
Installation
Show the free practice papers
- Sign up for a Green Bridge CBT partner account if you do not have one.
- In WordPress, install and activate the plugin.
- Sign in to the partner console at https://www.supergb.com/cbt/partners and open Websites and keys.
- Under Approved websites, add your website’s address exactly as visitors see it, such as
https://www.example.com. If your site useswww, include it. - Under Practice papers keys, create a key and copy it. It starts with
pk_. Choose Test while you set things up: test keys are free and open a small number of tests a day. Choose Live when you are ready for real visitors. Live keys become available once Green Bridge CBT approves your organisation. - In WordPress, go to Settings > Green Bridge CBT, paste the key into Practice papers key and click Save Changes.
- Add the Green Bridge CBT test block or the
[greenbridgecbt]shortcode to a page and view the page. You should see the list of free practice papers.
Show your own tests (Starter plan and above)
- In the partner console, open Connect your website or app. Under Your tests keys, create a key. It starts with
sk_. Copy it straight away, because the full key is only shown once. - On the Settings > Green Bridge CBT page, paste it into Your tests key and click Save Changes. Then click Check your tests key to confirm it works.
- Choose which Learner details to send to Green Bridge CBT. Only an anonymous id is sent unless you choose to also send names, or names and email addresses.
Get your learners’ grades in WordPress
Your site must be public and use https. Grades cannot be sent to a site on your own computer.
- On the Settings > Green Bridge CBT page, copy the address shown under Grades key.
- In the partner console, open Connect your website or app and find Grades. Paste the address, make sure
attempt.gradedis ticked under Events, and click Add webhook. - Copy the grades key it shows you straight away, because it is only shown once. It starts with
whsec_. - Paste it into Grades key on the settings page and click Save Changes. To test the connection, click Send test event in the partner console. Under Recent deliveries, a last response of
200means it works.401means the grades key in WordPress does not match, so paste it again.
FAQ
-
Do I need a Green Bridge CBT partner account?
-
Yes. That is where you get the keys that connect your site, and where you write your own tests. Sign up here.
-
How much does it cost?
-
The plugin is free. Your partner plan sets how many tests can be completed on your websites each month. Showing the free practice papers works on every plan. Your own tests and grades need the Starter plan or above. You can compare plans under Plan and billing in the partner console.
-
Do learners need to log in?
-
Not for practice papers: anyone visiting the page can sit them. For your own tests, learners log in to your WordPress site first, so each result belongs to the right person. Visitors who are not logged in see a link to log in.
-
Which exams are covered?
-
WAEC, JAMB, NECO, IGCSE and more, with new papers added over time. Only the free papers can be shown on partner websites.
-
Where do I find a paper, catalogue or test id?
-
- Paper: in the partner console, open Embed assessments and paste the link to the paper. The code it gives you contains the paper’s id.
- Catalogue: under Embed assessments, the Catalogues list shows each catalogue’s id with a copy button.
- Your own test: you do not need the id if you use the block, because it lists your tests. For the shortcode, the id is under Your tests > Tests in the partner console.
-
Can I try it before my site goes live?
-
Yes. Use a test key (it starts with
pk_test_orsk_test_) while you build your pages. Test keys are free, also work on your own computer (localhost), and open a small number of tests a day. Switch to a live key when you are ready. -
Can a learner retake one of my tests?
-
Each learner sits each of your tests once. To give them another try, add a new test.
-
What does Green Bridge CBT learn about my learners?
-
For practice papers, nothing from WordPress. For your own tests, only a unique anonymous id by default. On the settings page you can choose to also send each learner’s display name, or their display name and email address, so they are easier to recognise in your results. See External services below.
-
Why does the test not appear?
-
Check that your website’s address is in your approved websites in the partner console, exactly as your site uses it, with or without
www. If a key is missing or an id is wrong, administrators see a note on the page explaining what to fix. Visitors do not see it. -
Is my tests key safe?
-
It is stored in your WordPress database, used only by your server, and never shown on a page. If you think it has leaked, revoke it in the partner console and save a new one.
-
Can a course plugin mark a lesson complete when a learner passes?
-
Yes, but it needs a developer. Each learner’s grade is saved on their WordPress account, and the plugin tells other plugins when a grade arrives. A developer can use that to mark a lesson complete, award a certificate or unlock the next course. The details are under For developers below.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Green Bridge CBT” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Green Bridge CBT” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.1
- Clearer plugin page: plain-language description, step-by-step installation, a link to partner sign-up, and answers to common questions.
- No changes to how the plugin works.
1.0.0
- First release: practice papers, catalogues and your own tests by shortcode or block; grades by signed webhook.
