WP Manifestindependent plugin directory
manifest / ai / science-class-chatbot

Science Class Sidebar Chatbot

A sidebar AI tutor widget for a high school science class Wordpress website.

by Yohei · github.com/yoheiocean/science-class-chatbot

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/yoheiocean/science-class-chatbot/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/yoheiocean/science-class-chatbot ↗

Science Class Sidebar Chatbot (WordPress Plugin)

A sidebar AI tutor widget for a high school science class website.

What It Does

  • Login-only student chatbot in a sidebar widget
  • Teacher personality + LLM settings in wp-admin
  • Lesson management in wp-admin (Subject, Lesson, Objectives)
  • Objective checking + task assignment
  • Token generation when objective is met
  • Yohei Coin system with balances per student
  • Overall and subject-specific leaderboards
  • Student progress logging + bulk delete tools
  • Student coin management (manual add/remove by subject)
  • Optional state images (Idle, Thinking, Objective Met, Keep Trying)

Project Structure

  • science-class-chatbot.php - main plugin logic
  • includes/class-science-chatbot-widget.php - widget markup
  • assets/js/chatbot.js - frontend chat + leaderboard behavior
  • assets/css/chatbot.css - widget styles

Requirements

  • WordPress site with admin access
  • LLM API endpoint + API key + model
  • Students must have WordPress user accounts and be logged in

Install

  1. Copy science-class-chatbot folder into wp-content/plugins/
  2. Activate plugin in Plugins
  3. Go to Science Chatbot in wp-admin and configure settings
  4. Add Science Class Chatbot widget to your sidebar in Appearance > Widgets

Admin Pages

  • Science Chatbot: personality, LLM config, state images
  • Lessons: create/edit/delete subject+lesson+objectives
  • Student Progress: view logs, bulk delete rows
  • Student Coins: manual add/remove coins and clear earned records by subject/all

Leaderboards

  • Widget includes a leaderboard with a subject filter
  • Shortcode is available:
    • [scsb_leaderboard]
    • [scsb_leaderboard limit="20"]
    • [scsb_leaderboard limit="20" subject="Biology"]

Notes

  • Manual coin changes now require selecting a subject and are tracked as subject-linked records
  • Subject leaderboard totals come from earned records (objective completions + manual subject adjustments)
  • Updating plugin files in place preserves settings and stored data

Quick Update Workflow

  1. Replace plugin files in wp-content/plugins/science-class-chatbot/
  2. Hard refresh browser (Ctrl+F5)
  3. If needed, deactivate/reactivate plugin once