This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

KB Gradebook


Students are frequently more concerned about their grades than they ought to be. Reduce some of their academic stress by letting them see what you’ve recorded for them in your grade book. If you’re like me, you’ll be surprised how frequently your students notice that you mis-recorded a grade. Includes an optional widget.

How it Works

You upload a CSV file (from Excel or some other spreadsheet) containing your students’ grades. One column in the spreadsheet contains student (or parent) email addresses. The plugin generates a random password for each email address (or you can use WP logins; see FAQ). Students use this password with their email to check their grades. To update the grades, you just upload a new CSV.

After uploading a CSV, you type up a generic message that will be personalized for each student. For example, if one of the columns in your spreadsheet is called “midterm” and another is called “final,” your message might be something like this:

Dear [student], you got a [midterm] on the midterm and a [final] on your final.

Obviously, individual students would see their grades substituted in for [midterm] and [final]. If you don’t feel like typing out a message, you don’t have to; when a student logs in, she’ll just see an automatically generated table showing her all the grades you have recorded for her.

After uploading a gradesheet, create a page containing [KB Gradebook] somewhere in the body. That’s where your students will go to check their grades. There’s also a sidebar widget included if that’s your thing.


  • You can have several different courses at once if you want. Just give each one a unique name, like “Second period English” or “Econ 100, Fall 2007.” It’s okay if the same students are in more than one class.
  • Since any decent spreadsheet program can export CSV files, it’s very easy to use.


If you post your support questions as comments below, I probably won’t see them. If the FAQs don’t answer your questions, you can post support questions at the KB Gradebook plugin page on my site.


Excel gives me weird warnings when I “Save As” as CSV

That’s because Excel is dumb. All the warnings are telling you is that you’ll lose formatting–only text can go into a CSV–and that only the active sheet will be saved in the CSV. But all your formatting and multiple sheets will remain in the original Excel file. When you click “Save As,” you create a copy of the original in CSV format. Just save the CSV to your desktop and delete it after uploading it.

My students already have WP logins; they don’t need randomly generated passwords

Sweet. Open the plugin file and look for this…

define('KBGV_WPUSERS', false );

… and set it to true. Once you do that, the plugin will use WP’s native authentication system rather than using its own randomly generated passwords.

I had students add/drop my class. Do I need to delete the old class and start over?

No. The plugin will notice the new students and generate passwords for them. The dropped students will remain in the passwords database, but they will no longer be able to log in and check their grades (since they won’t show up in the gradesheet).

I’m having trouble importing my gradesheet

It works like a charm with my versions of Excel and Firefox, but I haven’t tested other arrangements. Please let me know what error messages you’re getting (if any), what spreadsheet program you’re using (and version), what browser you’re using (and version), and what platform you use (Windows/Mac/Linux). I don’t guarantee that I can fix it, though.

Some of the data gets cut off

If you have more than 99,999 characters within a single row of your spreadsheet, then everything from the 100,000th character on will get cut off. To fix this, open the plugin file and increase this setting to something higher:

define('KBGV_CSVCUTOFF', 99999);

If you have PHP 5.0.4 or higher, set it to 0 to make line lengths infinite.

Is my gradesheet secure?

To protect my legal rear end, I’ll say that it is your job to look at the code and decide whether your data will be secure; I make no guarantees. But I do use this software myself and am comfortable doing so. If the MySQL database that holds all your WordPress information is secure, then your gradesheet should be secure.

When students punch in their email address and password, they will see only their own grades on the next screen, not the entire gradebook. It is possible (but not likely) that something could go funny when you import your gradebook, and a student might end up seeing somebody else’s grades instead of his own. To rule out this possibility, you will have the opportunity to check the imported gradesheet for errors before it becomes live on your site. (And even if this did happen, the student would probably have no idea whose grades he was looking at anyway.)

The most likely way that data might be insecure would be if a student viewed their grades and then left them up on the screen and walked away. In this case, somebody else might see them. So you may want to post a note on your grade viewing page reminding students to close the browser after checking their grades to help prevent this. (But frankly, it would be your students’ fault for not protecting their own data.)

I have a question that isn’t addressed here.

You may ask questions by posting a comment to the KB Gradebook plugin page.

Contributors & Developers

This is open source software. The following people have contributed to this plugin.


Browse the code