browser.interfaces - Browser Interfaces

Interfaces for viewing components.

interface waeup.kofa.browser.interfaces.IBreadcrumb[source]

Provide breadcrumbs.


The viewname, for which the breadcrumb is provided.


The parent object.


Context description


The viewname of the parent to use.


The context of the breadcrumb.


The link target.

interface waeup.kofa.browser.interfaces.IBreadcrumbContainer[source]

A container of breadcrumbs.


Get the list of breadcrumbs as real Python list.


Allow iteration over the container.

interface waeup.kofa.browser.interfaces.IBreadcrumbIgnorable[source]

A marker interface for breadcrumbs that should be skipped in output.

If a breadcrumb wants to be skipped in real output (for instance, because it is set on a layer in site hierarchy that should not be accessed by users), it can also provide this interface. The getBreadcrumbList() function defined here will exclude IIgnorables by default.

interface waeup.kofa.browser.interfaces.ICaptcha[source]

Verify data entered in an HTTP request.

Expects some IHTTPRequest object and returns an ICaptchaResponse indicating that the solution was correct or not.

If the solution could not be verified (this might also happen because of technical reasons), the response might contain an error code.


Returns a piece of HTML code that displays the captcha.

The generated HTML code might depend on any previous error code as returned from verify().

The code is expected to appear inside a <form>. It therefore should not contain a <form> nor any submit buttons.

interface waeup.kofa.browser.interfaces.ICaptchaConfig[source]

Any type of captcha might need some configuration data.

By default we require no configuration data.

interface waeup.kofa.browser.interfaces.ICaptchaManager[source]

A chooser that collects available captchas.


Get captcha chosen for a certain site or default.


Return a dict of available captchas with registered names as keys.

interface waeup.kofa.browser.interfaces.ICaptchaRequest[source]

A set of data required to verify captcha solutions.

To solve a captcha we need at least a solution. Many types of captchas might also need a challenge to compare whether the solution is correct.


The challenge the solution might match


Solution string a user entered

interface waeup.kofa.browser.interfaces.ICaptchaResponse[source]

A formalized response for captcha solutions.


Indicates validity of entered captcha data.


Error when trying to validate entered captcha data.

Error codes are not expected to be readable strings.

interface waeup.kofa.browser.interfaces.IChangePassword[source]

Extends: waeup.kofa.interfaces.IKofaObject

Interface needed for change pasword page.


Unique Identifier

User Name, Student or Applicant Id, Matriculation or Registration Number


Email Address

interface waeup.kofa.browser.interfaces.IPDFCreator[source]

A component that knows where logo graphics for PDFs are stored and can generate PDF documents.

It is a utility (and not a simple function or class) to make these data customizable in derived packages.


Path to header logo JPG

paint_background(canvas, doc)

A callback function to render background of PDFs.


Path to watermark logo JPG

create_pdf(data, headerline=None, title=None, author=None, footer='', note=None, sigs_in_footer=[])

Create a PDF.

data is expected to be a list of reportlab flowables (paragraphs, images, tables, etc.), that will be rendered into some background.

headerline will be displayed in page head and title under the top bar.

note is optional HTML markup added at bottom of created document.

footer is the text rendered in the bottom line next to the page numbers.

sigs_in_footer is a set of translateable strings that will be rendered into signature boxes at bottom of each page.

If no headerline is given, a default will be rendered (name of university).

If no title is given, nothing will be rendered.

interface waeup.kofa.browser.interfaces.IStudentNavigationBase[source]

Extends: waeup.kofa.interfaces.IKofaObject

Objects that provide student navigation should implement this interface.


Some student object that has a display_fullname attribute.