Creating a minimalistic Zope 3 View
Learn how to create a simple Page Template driven browser view using Zope 3 techniques.
Purpose
Creating Python Scripts and Page Templates in skin layers using the Zope Management Interface (ZMI) is a quick-and-easy approach to customizing Plone. However, some of the drawbacks of this approach are that you can't use standard developer tools such as an IDE or a version control system. In addition, when you edit Python code using your web browser, you are sending untrusted code over the internet. For security reasons, it is necessary to run this Python code in a security sandbox, which means that you are restricted from performing many common operations in Python.
By creating an ordinary Python package you can create your own custom Page Template, which is backed by a plain Python class that does not impose any of the security restrictions of Python Scripts. This approach requires some additional knowledge beyond ZMI customizations, but should be followable by a novice Developer. The traditional Zope 2 methods of making unrestricted Python available were to either create an External Method or create a Zope 2 Product. Using Zope 3 techniques we can create an ordinary Python package containing a simple View component that can be applied to any content item in your Plone site.
Prerequisities
Basic knowledge of Python. Basic knowledge of Zope Page Templates. Basic knowledge of the layout of your Zope 2 and Plone 3 installation.
Creating a simple Package with a simple View
Create a Python package called 'simpleview' inside the lib/python directory of your Zope instance. Inside this 'simpleview' directory create a file called '__init__.py'. The existence of an '__init__.py' file means that Python will treat that directory as a Python package. When Python imports that package it calls any code in __init__.py, In this case we do not need to run any special code, so we will just write a single line comment to amuse ourselves:
# poof! he said and it was a package
Now we will create a Python class to hold the code for our View component, a Page Template file that will hold the HTML and TAL, and a ZCML file that will tell Zope to associate our Python class and Page Template file with each other.
Let's start with the Python class, we will put this code in a file called 'simple.py'. The BrowserView base class you inherit from assigns the content item that your View is rendered for to self.context, while the incoming HTTP Request object is assigned to self.request. Each method you make available in your class is available to be called from your Page Template:
from Products.Five import BrowserView class SimpleView(BrowserView): def content_item_id(self): return self.context.getId() def user_agent(self): return self.request.get('HTTP_USER_AGENT','')
Next create a file called 'simple.pt'. You can access your Python class with the name view from within your Page Template.
<html xmlns="" xml: <body> <div metal: <h1 tal: <p>Your browser identifies as <span tal:</p> </div> </body> </html>
Finally, you need to tell Zope that you have a View component, and that you wish to use your Page Template to render that component. Create a file called 'configure.zcml' and put the following XML in it:
<configure xmlns="" xmlns: <browser:page </configure>
The browser:page directive has a number of attributes. These are:
- for: Registers the page for a specific Interface. The special syntax * means that this is a generic View that can be applied to any Interface.
- name: This is what your View is called in the URL.
- class: The Python class that backs your Page Template.
- template: The Page Template file for your View.
- permission: The permission required to access your View.
Finally, you need to do one last step, and that is to tell Zope to include your new package. You need to create a file, called a ZCML slug, inside your Zope instances etc/package-includes directory called 'basicview-configure.zcml' that has a single line of text:
<include package="simpleview" />
It is recommended that if you are going beyond this simple customization that you learn how to create a buildout driven Zope instance, and use the paster command to make your development packages available as Python eggs. This saves you the hassle of having to remember to manually manage the configuration inside the etc/package-includes directory, as well as providing you with a strong set of tools for managing your Plone instance and your Python eggs.
Finally, you can call your View and see it rendered in your web browser by going to the URL:
It is not necessary include the @@ syntax, but it avoids conflict in the case of having a content item also called 'simple-view' inside your Plone site. You can remember the @@ syntax by associating it with a pair of eyes, this is intended to represent a View.
Creating a minimalistic Zope 3 View
i have placed the zcml file here..
Program Files\Plone 3\Zope\skel\etc\package-includes
and the url,
my plone instance runs at port:8070
zmi :8080
i am not sure where i am going wrong...
plzzz help me
thanks & regards,
srisri