How to install grokcore.viewlet
- Download and install ActivePython
- Open Command Prompt
pypm install grokcore.viewlet
This package provides support to write and register Zope Viewlets directly in Python (without ZCML). It's designed to be used with grokcore.view which let you write and register Zope Views.
- Setting up grokcore.viewlet
- API Overview
This package is set up like the grokcore.component package. Please refer to its documentation for more details. The additional ZCML lines you will need are:
<include package="grokcore.viewlet" file="meta.zcml" /> <include package="grokcore.viewlet" />
Put the first line somewhere near the top of your root ZCML file.
First we need a view to call our viewlet manager:
from grokcore import viewlet class Index(viewlet.View): pass index = viewlet.Page Template(""" <body> <head>Test</head> <body> <div tail:content="structure provider:content"> </div> </body> """)
After that we could define only a manager which display something:
class Content(viewlet.ViewletManager): viewlet.View(Index) def render(self): return u'<h1>Hello World</h1>'
Or a completely different example:
class AdvancedContent(viewlet.ViewletManager): viewlet.name('content') viewlet.view(Index)
And some viewlets for that one:
class StaticData(viewlet.Viewlet): viewlet.view(Index) viewlet.viewletmanager(AdvancedContent) def render(self): return u'<p> Data from %s</p>' self.context.id
class SecretData(viewlet.Viewlet): viewlet.view(Index) viewlet.viewletmanager(AdvancedContent) viewlet.require('agent.secret') secretdata = viewlet.PageTemplate(""" <p>Nothing to see here.</p> """)
The way templates are binded to components works exactly the way than in grokcore.view, for more information refer to its documentation.
Define a new viewlet manager. You can either provide a render method, a template, which can or not use registered viewlets.
If you define a template, view is added as a reference to the current view for which the manager is rendering in the template's namespace. It is available as well as an attribute on the manager object.
Define a new viewlet. You can either provide a template or a render method on it. Like in views, you can define an update method to process needed data.
Like for manager, view is added to the template namespace if used. viewletmanager is defined as well as a reference to the manager in the template's namespace and as an attribute on the viewlet object.
You can use directives from grokcore.view to register your viewlet or viewlet manager: name, context, layer and require (for security on a viewlet).
To that is added:
- Select for which view is registered a viewlet or a viewlet manager.
- Select for which viewlet manager is registered a viewlet.
- Define a rendering order for viewlets in a viewlet manager. This should be a number, the smaller order render first, bigger last.
- Make the has_render() and has_no_render() symmetrical to those in grokcore.view, grokcore.layout and grokcore.formlib, where a render.base_method attribute is checked.
- Do not require the role extra from grokcore.security.
- Use the component registration api from grokcore.component.
- Update how the static resources are found on a ViewletManager and a Viewlet, following the new name __static_name__ set by the template association.
- Introduce the available() method on viewlet component. The viewlet manager will filter out unavailable viewlet by calling this method. The available() method is called after the viewlet's update() is called, but before the render() is called.
- Update to use TemplateGrokker from grokcore.view to associate viewlet and viewletmanager templates.
- The computed default value for the viewletmanager directive is now defined in the directiv itself, not as a separate function that needs to be passed along.
- Upped version requirements for martian, grokcore.component, and grokcore.view.
- Move the order directive to grokcore.component.
- Move the view directive to grokcore.view.
- Make package comply to zope.org repository policy.
- Update functional tests to use Browser implementation of zope.app.wsgi instead of zope.app.testing.
- Reduce dependencies (zope.app.pagetemplate no longer necessary).
- Dropped the dependency on zope.app.zcmlfiles.
- Cleaned the code to remove unused imports and ensure the pep8 syntax.
- Updated tests to have a return value consistency. The grokcore.viewlet viewlet manager implementation requires viewlets to return unicode strings. Now, viewlets return unicode strings in the test packages.
- Define test requires.
- Reverted the use of grokcore.view.CodeView. We now require grokcore.view 1.12.1 or newer. As of grokcore.view 1.12, the CodeView/View separation has been undone.
- Remove the reference to the grok.View permission that is no longer in grokcore.security 1.2
- Use the grok.zope.org/releaseinfo information instead of our own copy of versions.cfg, for easier maintenance.
- Adapted tests to new grokcore.view release: switched from View to CodeView.
- Add grok.View permissions to functional tests (requires grokcore.security 1.1)
- Created grokcore.viewlet in November 2008 by factoring zope.viewlet-based components, grokkers and directives out of Grok.