skip to navigation
skip to content

waeup.kofa 1.3.3

A student online information and registration portal

What is WAeUP.Kofa ?

Kofa means ‘entrance’ or ‘portal’ in Hausa language.

WAeUP.Kofa is a multifunctional, open source, web based student management system to provide transparent and comprehensive information about application and study progress. The system controls all kinds of application and student registration processes at large schools and universities in Nigeria. It is a generic system which can be deployed by, and is useful to most universities, colleges or schools wordlwide.

WAeUP.Kofa is the flagship of the West African eUniversity Project (WAeUP). See to learn more about WAeUP.

WAeUP.Kofa is really an allrounder. The best way to briefly describe its functionality, is to explain what the software can not do for you, rather than trying to describe all its features in just a few words. Kofa is primarily not an e-learning system, although, it has some basic content management features which can be used by lecturers to disseminate course material. Kofa is also not a scheduler which generates lesson plans or timetables for lecturers or students. Although students register their courses with Kofa and can see or print course lists for each academic session, so far, courses do not contain information, when or where they take place. However, due to the modular design of Kofa, a scheduler or room planner could be easily added.

WAeUP.Kofa is divided into sections. Each section has its own folder in Kofa’s object database. When starting Kofa in debug mode:

$ ./bin/kofactl debug

we can use simple Python expression to view the first two levels of the database structure:

>>> list(root.keys())
>>> list(root['app'].keys())
[u'accesscodes', u'applicants', u'configuration', u'datacenter',
 u'documents', u'faculties', u'hostels', u'mandates', u'reports',
 u'students', u'users']

The section/folder structure can be figured as follows:

root (Database Root)
+---> app (University)
      +---> faculties (Academic Section)
      +---> students (Students Section)
      +---> applicants (Aplicants Section)
      +---> documents (Documents Section)
      +---> hostels (Accommodation Section)
      +---> accesscodes (Access Codes Section)
      +---> configuration (Configuration Section)
      +---> users (Officers)
      +---> datacenter (Data Center)
      +---> mandates (Mandates)
      +---> reports (Reports)

The user handbook follows this organizational structure and adds further chapters where needed. Also installation instructions and basic information about customization can be found there.

You can also find latest docs at


1.3.3 (2015-10-06)

  • Show file size of pdf documents in the documents section.
  • Add

1.3.2 (2015-09-14)

  • Add public page to check application status without password.
  • Fix department breakdown of student statistics.
  • Enable purging of applicants containers.
  • Enable pre-filling of applicants containers with empty application records which are used during self-registration to avoid excessive growth of the Data.fs.
  • Do only allow one running export job.
  • Add switch to disable all exports.
  • Enable import of list-of-choices fields.
  • Include ‘end day’ when searching for payments in a given period.
  • Do not create special application payment tickets with zero amount.
  • Remove manual clearance lock. Replace clearance_locked field by property attribute.
  • Make student email field required.
  • Rename application workflow transitions and remove forbidden transitions.
  • Rename ‘application section’ for the sake of consistency.
  • Rename student views which are not layout-aware and thus not pages.
  • Register KofaSourceOrderedMultiSelectWidget for IterableSource and KofaSourceOrderedMultiSelectWidget for IVocabularyTokenized.
  • Implement session-specific course registration deadline and late registration payment.
  • Remove quite old bug in doImport: Replace empty strings and lists with ignore-markers in update and create mode.
  • Add StudentUnpaidPaymentExporter to export only unpaid tickets. This exporter is designed for finding and finally purging outdated payment ticket.
  • Remove deprecated xml importer and exporter components.
  • Rearrange datacenter upload page. Provide modal windows to view all processors and sources and vocabularies.
  • Reorganize doctests. Remove deprecated doctests.
  • Enable temporary suspension of officer accounts. Plugins must be updated after restart.
  • Rename ‘Portal Users’ ‘Officers’.
  • Add link ‘Kofa Docs for this page’ at the end of the content box which refers to the corresponding section of the Kofa Documentation.
  • Filter students by current level in reports.
  • Add StudentsUtils.increaseMatricInteger method which allows to use various matric number counters when computing the matric number.
  • Bypass school fee payment activation code creation if student is allowed to proceed to next session.
  • Convert level into a schema field to be consistent with the documentation.
  • Rename classes StudentPaymentsExporter and BedTicketsExporter to be in accordance with other exporter names.
  • Add ReportsOfficer and ReportsManager roles with corresponding permissions.
  • Do not automatically allow import managers to import user data.
  • Skip empty rows produced by spreadsheet software.
  • Add components to configure a student export jobs in faculties.
  • StudentOnlinePaymentProcessor : Raise DuplicationError if payment (in state paid) with same p_session and p_category exists.
  • Add new payment state waived. This state can only be set by import and is only used for the payments overview exporter to mark sessions with waived fees.
  • Add exporter methods and export page to filter student data exports by entering a list of student ids.
  • Student statistic can now be broken down by faculties or by departments.
  • Check if p_id exists in payments catalog when importing payment tickets in create mode.

1.3.1 (2015-01-14)

  • 1.3 was a brown bag release. Fix uploaded files.

1.3 (2015-01-13)

  • Add documents package.
  • Do not compare ResultEntry objects but their attributes.
  • Modify getWidgetsData so that we always get the same error format.
  • Validate all codes in university.
  • Catch traceback when creating an application slip with a corrupted image file.
  • Remove deprecated HTML and REST widgets and use html2dict and rest2dict instead.
  • UserProcessor: Check if imported roles do exist in the portal.
  • Enable localization of batch processing modules.
  • Hide ‘Create students’ button. Only user admin can see this button.
  • Add application_slip_notice field to ApplicantsContainer.
  • Remove ‘Size’ column from logfiles table.
  • Add permission, page and button to mass-clear all students in a department.
  • Hide export download button 24 hours after file generation.
  • Add helper to allow meminfo checks for cached memory, etc.
  • Allow external checks of system load before performing expensive actions.
  • Add new dependency: psutil (required to check system state).
  • Show flash message on general search page for the academic section.
  • Fix CertificateCourseProcessor. Mandatory is not a required field and might be missing in import files. Improve logging. Extend and fix CertCourseProcessorTests.
  • Provide customizable method for disabling clearance by clearance officers.
  • Merge Javascript functions into one file. Add Javascript function to calculate copyright notice year automatically.
  • Use lastname (surname) instead of firstname to verify found application record on ApplicantRegistrationPage.
  • Append hash ‘#’ also to datetimes to circumvent unwanted excel automatic.
  • Method for (customizable) application passport upload requirements added.
  • Filter payment ticket data exports by specifying the payment_date period.
  • Method for (customizable) application payment slip download requirements added.
  • Method for (customizable) application payment ticket upload requirements added.
  • Remove unused rowadd javascript function.
  • certcode and reg_number added to DataForBursaryExporter.
  • Some batch processor names corrected.
  • Fixed ReST markup in long description.

1.2 (2014-06-16)

  • Redirect to login page after using password mandate.
  • Adding student payment tickets is logged.
  • Provide XMLRPC services for storing and retrieving fingerprint scans.
  • Sort ContextualDictSource by dictionary values not by keys.
  • Add regular school fee and balance payments when exporting payments overviews.
  • Add samePaymentMade method to StudentsUtils.
  • Fingerprint file upload enabled.
  • is_fresh property method added to Student class.
  • Special application procedure modified. Special applicants must submit their form before they can download payment slips. Thus the regular workflow is now applied but, in contrast to regular applications, special applicants can create and pay more than one payment ticket. Also application slips are hidden.
  • Add setMatricNumber and constructMatricNumber methods to StudentsUtils.
  • When sending mails, always set from-address to ‘’. Real from-addresses are now set in Cc and Reply-To fields. This is to tackle problems with yahoo (does not allow mails to be sent from non-yahoo servers).
  • Multiple payments in special application containers enabled. Special payment applicants remain in state started after payment.
  • File input fields brought into shape with Bootstrap 3.
  • Transcript and access code pagetemplates adjusted.
  • Print QR codes on all student slips.
  • Allow adding current_level to base data section on all student slips (requested by Uniben).
  • Windows is no longer supported. Installation manual removed.
  • Added JS helper to scroll to sequencelists after adding/removing items.

1.1 (2014-03-13)

  • Add display_fullname column to CourseTicketExporter (requested by Uniben).
  • Do also export student and course ticket data of students on probation.
  • ‘Create student’ option removed from ‘Application Transition’ select field.
  • API docs added.
  • Back-to links replaced by animated jQuery plugins.
  • Default frontpage text updated.
  • Use absolute urls on datacenter pages.
  • Provide customizable method for disabling student payments.
  • After login and logout, regular users (officers) are redirected to the portal’s index page not to the portal’s root. The root URL can now be rewritten be Nginx or Apache so that the user is being redirected to the university website when entering the root URL directly or clicking the acronym.
  • Show tooltip alert and warning window before updating plugins.
  • JSAction has been deprecated. KofaAction can be used instead. Additional parameters can be used in @action decorators to enable tooltips and/or warning windows. The old @jsaction decorator still triggers a default warning message.
  • jquery-ui.min.js is also used for tooltips.
  • Do not create TSC AC batch when updating plugins. All TSC batches are created.
  • Make table on applicantsrootpage responsive.
  • Change width of input, select and textarea fields.
  • Use only https in theme.html.
  • INSTALL.txt updated and integrated into Sphinx documentation.
  • Redundancies removed in docs.

1.0 (2014-02-22)

  • Diazofied the complete package.

0.2.1 (2014-02-21)

  • Send mails to from-address, if site-wide config admin is different from it.
  • Change flash message for successful applicants.
  • Use more attributes of applicants with payer objects.
  • Update copyright infos (year).
  • Localization updates.

0.2 (2014-01-09)

Tons of changes.

0.1 (never released)

Initial version. Copy from waeup.sirp.


File Type Py Version Uploaded on Size
waeup.kofa-1.3.3.tar.gz (md5) Source 2015-10-06 2MB
  • Downloads (All Versions):
  • 1 downloads in the last day
  • 82 downloads in the last week
  • 472 downloads in the last month