The Grok administration and development UI (base)
Project description
grokui.base – Base components for Grok UI
grokui.base is a base layer to build a zope instance-level set of utilities. The package provides a collection of easy-to-use components that will allow you to build your own configuration or admin panels. grokui.base provides the components that should be used by other grokui packages to plug into a coherent layout.
Using grokui.base we can provide different UI parts that can be used indenpendently from each other, for example a ZODB browser or a general admin panel to manage local Grok applications. It is up to the admins to decide what grok UI parts they want to have installed.
In general, grokui.base provides viewlets, menus, layouts and a special namespace for use by other components.
Detailed Description
grokui.base provides tools to assemble a coherent environment.
The ++grokui++ namespace
In order to keep a sane and clean naming policy, the grokui components are compartmented in a logical namespace, ++grokui++, which is defined and registered in grokui.base.
This namespace is a multi-adapter that will act like a parent for the view. It’s the natural context of all the grokui pages. Let’s get out first contact with this namespace:
>>> from grokui.base import GrokUINamespace >>> from grokui.base import IGrokUIRealm >>> IGrokUIRealm.implementedBy(GrokUINamespace) True
Example
We can build a simple admin screen that fits into the environment like this:
>>> import grokcore.viewlet as grok >>> from zope.interface import Interface >>> from grokui.base import GrokUILayer>>> class MyAdminScreen(grok.View): ... grok.layer(GrokUILayer) ... grok.name('helloadmin') ... grok.context(Interface) ... def render(self): ... return u'Hello admin!'
The important thing here is, that we set our view to belong to the GrokUI namespace, which is named ++grokui++ in URLs.
We grok this view to register it with the component architechture:
>>> from grokcore.component.testing import grok_component
>>> grok_component('MyAdminScreen', MyAdminScreen)
True
Let’s create a browser to lookup this view:
>>> from zope.app.wsgi.testlayer import Browser
>>> browser = Browser()
>>> browser.addHeader('Authorization', 'Basic mgr:mgrpw')
We can get this screen when we ask for the correct namespace:
>>> browser.open('http://localhost/++grokui++/@@helloadmin')
>>> print browser.contents
Hello admin!
If we ask for this view without the namespace set correctly, the view will not be found:
>>> browser.open('http://localhost/@@helloadmin')
Traceback (most recent call last):
...
HTTPError: HTTP Error 404: Not Found
GrokUI Pages
We can, however, also create admin pages, that fit completely into the GrokUI layout without much hassle, providing a menu bar, images and all other parts of the standard grokui layout automatically for your page.
To do so, we derive our admin page from GrokUIView, give it a title, and optionally set an order number:
>>> from grokui.base.layout import GrokUIView >>> from grokui.base.namespace import GrokUILayer>>> class CaveManagementScreen(GrokUIView): ... # Name where we can access this page via URL: ... grok.name('managecave') ... # Also optional, but highly recommended: ... grok.require('zope.ManageServices') ... # Set title of page in menu bar: ... grok.title('admin stuff') ... # Display this entry very far to the left in menu bar: ... grok.order(-1) ... ... def render(self): ... # Instead of render() we could also define a page template ... # for the actual contents of this page. ... return u'Hello cave manager!'>>> grok_component('CaveManagementScreen', CaveManagementScreen) True
While the title will be displayed in the main menu bar of the GrokUI layout automatically, the order tells at which position in the menu we want our page to appear. Pages without a title do not appear in the menu bar at all.
Instances of GrokUIView are in fact megrok.layout.Page instances that render the content provided by a template or render method into a given layout (here: the general GrokUI layout).
We can access the page in GrokUI namespace ++grokui++ under the name given above (managecave):
>>> browser.open('http://localhost/++grokui++/managecave')
>>> print browser.contents
<html xmlns="http://www.w3.org/1999/xhtml">
...<head>
...<title>Grok User Interface</title>
...<base href="http://localhost/++grokui++/" />
...Hello cave manager!...
...
Making your admin page the default target page
The above admin page was set up with order number -1. That means, that its menu entry will appear at far left position in the menu bar. As we have currently no menu entries with a lower order number, the entry will even appear at leftmost position.
Furthermore this leftmost entry is also the default page if someone wants to see the index page of the running Zope instance at all:
>>> browser.open('http://localhost/')
>>> browser.url
'http://localhost/++grokui++/@@managecave'
This means, we’ve been redirected to our cave admin page.
If we want to change this default, for instance in order to set another page as default, we simply have to provide a lower order number for that other admin page. The redirect will then redirect to it.
CHANGES
0.4 (2010-10-25)
Set the default view name for IRootFolder to ‘index’ and register the the redirecting view for this name as well.
0.3 (2010-10-18)
Removed dependency on zope.app.testing.
0.2.1 (2010-05-19)
Package modified to comply with repository policy (license, etc.).
Use own template dir for layout module in order not to provoke (erraneous) warnings of template registry.
0.2 (2010-03-06)
A minor CSS glitch has been corrected.
The messaging system is now registered via grokcore.message. grokui.base is no longer bound to z3c.flashmessage.
Dependencies have been cleaned up : grokui.base no longer depends on zope.app.zcmlfiles and can now be used outside the Grok suite. It uses only the grokcore packages.
0.1 (2010-02-23)
Initial implementation.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
