Home
Welcome!
OA Dues Lookup is a Wordpress plugin to allow your Order of the Arrow lodge members look up whether their dues are paid or not. It currently works in conjunction with data exported from OA LodgeMaster, however, if you have some other system that can export data in a machine-readable way (Excel spreadsheet, CSV, etc), file an issue requesting it and I'll try to make it work.
- Download and Installation
- Design Goals
- How to get help or report problems
- Screenshots
- OALM Setup/Export/Import Instructions
You can download the plugin from https://github.com/oa-bsa/dues-lookup/releases/latest
To install it: in the Wordpress admin, go to Plugins > Add New > Upload, and give it the zip file. Click "Activate Plugin" after it finishes installing. Then go to Settings > OA Dues Lookup to find the settings for it. This is also where you upload the file exported from OALM.
It defaults to using /oadueslookup as the URL. Feel free to make it something simple like /dues or whatever else suits you.
Versions prior to 1.0.3 did not check for updates. If you have version 1.0.2 or older installed, you will need to deactivate and delete the existing version before installing version 1.0.3 or newer. It will keep your config, don't worry. As of version 1.0.3, future versions should show up in Wordpress's Plugin Updates panel when they are available.
If you get a "Page Not Found" error from WordPress after uploading your import file from LodgeMaster, it usually means your import is taking longer to process than the max_execution_time setting in your PHP installation. Try raising that value until it works (you may need to kill existing php processes for the settings change to take effect).
My design goals in creating this (mostly to deal with privacy concerns) were:
- To look up whether your dues are paid or not, you need to know your member ID. This is a piece of information that's generally not out there and won't really be of use to an identity thief anyway.
- Nobody can view the entire list. You can only look it up by member ID, one ID at a time.
- The result the member gets to look at doesn't include any names. It only has the date they last paid dues, and what year they're paid up through.
- If we don't have their BSA Member ID on file, they can't look up their dues. We're not allowed to renew their membership without it now anyway (at least in my council), so if we don't have it on file, they're not technically a member, even if they paid up. If someone tries to look up an ID that's not in the list, it will suggest how to submit their ID to us.
As you probably noticed because this is hosted on Github, the plugin is open source. If programming is your thing and you want to help maintain this, feel free to fork it and send me pull requests (or put a patch in a ticket). I'm also open to trying to make this work for people, so if you want it to do something it doesn't, feel free to file tickets in the issue tracker.
Use the issue tracker. Or email me at the address in the screenshots below.
The main page looks like this:
From there you can look up a member ID and hopefully get a result like this:
Or maybe one like this:
There are pre-installed "fake ID numbers" that can be used as test codes to test the various situations. You can use Nataepu Shohpe's installation to try them out to see what the responses look like. Someday (hopefully soon) the output will be more customizable.
| test code | ID on file | dues paid | BSA audit result |
|---|---|---|---|
| 123452 | No | n/a | n/a |
| 123453 | Yes | No | No Match Found |
| 123454 | Yes | Yes | Not Registered |
| 123455 | Yes | Yes | Registered |
| 123456 | Yes | No | Registered |
| 123457 | Yes | Yes | No Match Found |
| 123458 | Yes | No | Not Registered |
| 123459 | Yes | Yes | never run |