Einführung¶

Setuptools

[buildout]
parts =
    zope2
    productdistros
    instance
    zopepy

$ paster create -t plone3_buildout

# curl -O http://peak.telecommunity.com/dist/ez_setup.py

$ sudo apt-get install build-essential zlib1g-dev

$ sudo yum install make gcc-c++ zlib-devel

$ sudo apt-get install libssl-dev

$ sudo yum install openssl-devel

$ sudo apt-get install libreadline6-dev

$ sudo apt-get install wv poppler-utils

$ sudo yum install wv poppler-utils

$ sudo apt-get install python-dev python-libxml2 python-libxslt1 python-virtualenv

$ sudo yum install python27-devel python-lxml python-virtualenv

$ virtualenv --system-site-packages venv
$ cd venv
$ ./bin/pip install zc.buildout

# curl -O http://www.python.org/ftp/python/2.7.9/Python-2.7.9.tgz
# tar -xvzf Python-2.7.9.tgz

# cd Python-2.7.9
# ./configure --prefix=/opt/python/2.7.9

# make
# make install

export PATH=/opt/python/2.7.9/bin:$PATH

$ source ~/.bashrc

# mkdir /opt/python/2.7.9/Extensions
# cd $_
# curl -O http://peak.telecommunity.com/dist/ez_setup.py
# python ez_setup.py

# easy_install -U setuptools

# easy_install setuptools==0.9.8

NameError: global name 'log' is not defined

# easy_install setuptools>=dev06

$ python2.7 bootstrap.py

export http_proxy = http://localhost:8123/
export https_proxy = http://localhost:8123/

$ ssh -L 8123:localhost:8123 yourserver.com

[instance]
…
# Use statically compiled libxml2
environment-vars =
    LD_LIBRARY_PATH ${buildout:directory}/parts/lxml/libxml2/lib:${buildout:directory}/parts/lxml/libxslt/lib

# wget https://www.python.org/ftp/python/2.6.9/Python-2.6.9.tar.xz
# tar xvzf Python-2.6.9.tgz

lib_dirs = self.compiler.library_dirs + [
    '/lib64', '/usr/lib64',
    '/lib', '/usr/lib',
    '/usr/lib/x86_64-linux-gnu'
    ]

PySSL_BEGIN_ALLOW_THREADS
if (proto_version == PY_SSL_VERSION_TLS1)
    self->ctx = SSL_CTX_new(TLSv1_method()); /* Set up context */
else if (proto_version == PY_SSL_VERSION_SSL3)
    self->ctx = SSL_CTX_new(SSLv3_method()); /* Set up context */
else if (proto_version == PY_SSL_VERSION_SSL23)
    self->ctx = SSL_CTX_new(SSLv23_method()); /* Set up context */
PySSL_END_ALLOW_THREADS

/* protocol versions */
PyModule_AddIntConstant(m, "PROTOCOL_SSLv3",
                        PY_SSL_VERSION_SSL3);
PyModule_AddIntConstant(m, "PROTOCOL_SSLv23",
                        PY_SSL_VERSION_SSL23);
PyModule_AddIntConstant(m, "PROTOCOL_TLSv1",
                        PY_SSL_VERSION_TLS1);

from _ssl import PROTOCOL_SSLv2, PROTOCOL_SSLv3, PROTOCOL_SSLv23, PROTOCOL_TLSv1

from _ssl import PROTOCOL_SSLv3, PROTOCOL_SSLv23, PROTOCOL_TLSv1

# env CPPFLAGS="-I/usr/lib/x86_64-linux-gnu" LDFLAGS="-L/usr/include/x86_64-linux-gnu"  ./configure --prefix=/opt/python/2.6.9
# make
# make install

# cd /opt/python/2.4.6/
# mkdir Extensions
# cd $_
# wget https://pypi.python.org/packages/2.4/s/setuptools/setuptools-0.6c11-py2.4.egg#md5=bd639f9b0eac4c42497034dec2ec0c2b
# export PATH=/opt/python/2.4.6/bin:$PATH
# sh setuptools-0.6c11-py2.4.egg

# wget https://www.python.org/ftp/python/2.4.6/Python-2.4.6.tgz
# tar xvzf Python-2.4.6.tgz

lib_dirs = self.compiler.library_dirs + [
    '/lib64', '/usr/lib64',
    '/lib', '/usr/lib',
    '/usr/lib/x86_64-linux-gnu'
    ]

ssl_libs = find_library_file(self.compiler, 'ssl',lib_dirs,
                             ['/usr/local/ssl/lib',
                              '/usr/contrib/ssl/lib/',
                              'x86_64-linux-gnu'
                             ] )

# env CPPFLAGS="-I/usr/lib/x86_64-linux-gnu" LDFLAGS="-L/usr/include/x86_64-linux-gnu"  ./configure --prefix=/opt/python/2.4.6
# make
# make install

# cd /opt/python/2.4.6/
# mkdir Extensions
# cd $_
# wget https://pypi.python.org/packages/2.4/s/setuptools/setuptools-0.6c11-py2.4.egg#md5=bd639f9b0eac4c42497034dec2ec0c2b
# export PATH=/opt/python/2.4.6/bin:$PATH
# sh setuptools-0.6c11-py2.4.egg

$ curl -o master.zip  https://codeload.github.com/veit/vs_buildout/zip/master
$ unzip master.zip
$ cd vs_buildout-master
$ python bootstrap.py -c devel.cfg
…
Got distribute 0.6.28.
Generated script '/Users/plone/vs_buildout-master/bin/buildout'.

export PATH=/opt/python/Python-2.7.5/bin/:$PATH

$ source ~/.bashrc

$ sudo apt-get install libjpeg62-dev libfreetype6

$ sudo yum install libjpeg-turbo-devel freetype-devel

$ brew install freetype jpeg libtiff

[buildout]
…
versions = versions
…
eggs =
    Pillow

[versions]
…
Pillow = 1.7.8

$ sudo apt-get install libxml2-dev libxslt1-dev

$ sudo yum install libxml2-devel libxslt-devel

$ ../venv/bin/buildout -c devel.cfg
…
--------------------------------------------------------------------
SETUP SUMMARY (Pillow 1.7.8 / PIL 1.1.7)
--------------------------------------------------------------------
version      1.7.8
platform     darwin 2.7.3 (default, Feb  8 2013, 10:02:27)
             [GCC 4.2.1 (Based on Apple Inc. build 5658) (LLVM build 2336.11.00)]
--------------------------------------------------------------------
--- TKINTER support available
--- JPEG support available
--- ZLIB (PNG/ZIP) support available
--- FREETYPE2 support available
*** LITTLECMS support not available

--------------------------------------------------------------------

§ ./bin/instance start

§ ./bin/instance stop

$ ./bin/instance fg

C:\Python26;C:\Python26\Scripts;

C:\Python24;C:\Python24\Scripts;

gcc --version

[build]
compiler=mingw32

[instance]
…
eggs =
    Pillow
    Plone
    …

> bin\instance.exe install

> bin\instance.exe start

> bin\instance.exe remove

parts =
    instance-base
    zopepy
    i18ndude
    zopeskel

[instance-base]
recipe = plone.recipe.zope2instance
user = admin:admin
http-address = 8080
debug-mode = on
verbose-security = on
blob-storage = var/blobstorage

eggs =
    Plone
    Pillow

zcml =

environment-vars =
    PTS_LANGUAGES en de
    zope_i18n_allowed_languages en de
    zope_i18n_compile_mo_files true

eggs =
    ...
    SQLAlchemy>=0.3,<0.4dev

eggs =
    ...
    my.package

develop =
    src/my.package

zcml =
    my.package

zcml =
    my.package-overrides
    my.package-meta

<includeOverrides file="overrides.zcml" />

environment-vars =
    zope_i18n_compile_mo_files = true

[zopepy]
recipe = zc.recipe.egg
eggs = ${instance:eggs}
interpreter = zopepy
extra-paths = ${zope2:location}/lib/python
scripts = zopepy

$ ./bin/zopepy
>>> from Products import PageTemplates

$ ./bin/buildout -c deploy.cfg  annotate
Setting socket time out to 3 seconds.

Annotated sections
==================

[backup]
enable_snapshotrestore= false
    /home/veit/sandboxes/vs_buildout/deploy.cfg
...
[buildout]
...
develop-eggs-directory= develop-eggs
    DEFAULT_VALUE
directory= /home/veit/vs_buildout
    COMPUTED_VALUE
...

[versions]
...
six= 1.2.0
    /home/veit/vs_buildout/plone-versions.cfg
...

parts =
    zope2
    productdistros
    instance
    zopepy

[zope2]
recipe = plone.recipe.zope2install
fake-zope-eggs = true
additional-fake-eggs =
    ZODB3
url = ${versions:zope2-url}

additional-fake-eggs =
    ZODB3 = 3.7.1
    zope.annotation = 3.3.2

[buildout]
versions = versions

[versions]
zope.app.catalog = 3.5.2
zope.component = 3.5.1
zope.i18n = 3.6.0
zope.sendmail = 3.5.1
zope.testing = 3.7.1
five.intid = 0.3.0

[zope2]
fake-zope-eggs = true
additional-fake-eggs =
    ZConfig
    ZODB3
    pytz
skip-fake-eggs =
    zope.component
    zope.i18n
    zope.sendmail
    zope.testing

urls =
    http://www.zope.org/Members/shh/DocFinderTab/1.0.2/DocFinderTab-1.0.2.tar.gz

[productdistros]
recipe = plone.recipe.distros
urls =
    http://plone.org/products/ploneldap/releases/1.0/PloneLDAP-bundle-1.0.tar.gz
nested-packages =
    PloneLDAP-bundle-1.0.tar.gz
version-suffix-packages =

${productdistros:location}

[instance]
recipe = plone.recipe.zope2instance
zope2-location = ${zope2:location}
...
products =
    ${buildout:directory}/products
    ${productdistros:location}

[buildout]
parts =
...
plone

index = http://download.zope.org/ppix

[plone]
recipe = plone.recipe.plone

recipe = plone.recipe.plone>=3.1,<3.2dev

recipe = plone.recipe.plone==3.1.7

$ ./bin/buildout -N

$ ./bin/buildout -h

prefer-final = true

newest = false

allow-picked-versions = false

[buildout]
…
show-picked-versions = true

$ ./bin/buildout -Nv | sed -ne 's/^Picked: //p' | sort | uniq

[buildout]
…
extends =
   http://dist.plone.org/release/4.1/versions.cfg

versions = versions

[buildout]
extends = http://download.zope.org/zopetoolkit/index/1.0.3/zopeapp-versions.cfg
          http://download.zope.org/Zope2/index/2.13.8/versions.cfg

[versions]
# Buildout infrastructure
mr.developer = 1.17
…

# External dependencies
…

# Plone release
Plone                                 = 4.1
Products.ATContentTypes               = 2.1.3
…

[buildout]
…
extends =
    http://dist.plone.org/release/4.1/versions.cfg
    versions.cfg

versions = versions

[versions]
…

[buildout] … versions = release1

[release1] plone.locking = 1.0.5

[plone]
recipe = plone.recipe.plone
eggs =
    plone.locking

[buildout]
…
extensions =
    buildout.dumppickedversions
dump-picked-versions-file = versions.cfg
overwrite-picked-versions-file = false

[versions]
Cheetah = 2.2.1
Paste = 1.7.5.1
PasteScript = 1.7.3
ZopeSkel = 2.19
i18ndude = 3.2.2

#Required by:
#PasteScript 1.7.3
PasteDeploy = 1.3.4

#Required by:
#i18ndude 3.2.2
ordereddict = 1.1

[buildout]
parts =
    …
    checkversions
…
[checkversions]
recipe = zc.recipe.egg
eggs = z3c.checkversions [buildout]

[lxml]
parts =
   staticlxml
   pylxml

[pylxml]
recipe=zc.recipe.egg
interpreter=pylxml
eggs=
    lxml

[staticlxml]
recipe = z3c.recipe.staticlxml
egg = lxml

[buildout]
extends =
    lxml.cfg

parts =
    ${lxml:parts}
    …

[buildout]
extends =
    http://www.plone-entwicklerhandbuch.de/plone-entwicklerhandbuch/entwicklungsumgebung/lxml.cfg

[extensions]
recipe = plone.recipe.command
command =
    ln -sf ${buildout:directory}/Extensions/*  ${instance:location}/Extensions/
update-command =
    ${extensions:command}

[buildout]
extensions =
    …
    buildout.extensionscripts
…
extension-scripts =
    ${buildout:directory}/buildout-utils.py:patchScriptGeneration

# Workaround for https://bugs.launchpad.net/zc.buildout/+bug/164629

def patchScriptGeneration(buildout):
    from zc.buildout import easy_install
    if not 'sys.exit(' in easy_install.script_template:
        easy_install.script_template = easy_install.script_template.replace(
            "%(module_name)s.%(attrs)s(%(arguments)s)",
            "sys.exit(%(module_name)s.%(attrs)s(%(arguments)s))")

[buildout]
…
parts =
    …
    crontab

[crontab]
recipe = z3c.recipe.usercrontab
times = @reboot
command = ${buildout:directory}/bin/instance start

[buildout]
parts =
   …
   logrotate

…
[logrotate]
recipe = collective.recipe.template
input = templates/logrotate.conf
output = ${buildout:directory}/etc/logrotate.conf

…
${buildout:directory}/var/log/instance.log {
    postrotate
        ${buildout:bin-directory}/instance logreopen
    endscript
}

…
/home/veit/myproject/var/log/instance.log {
    postrotate
        /home/veit/myproject/instance logreopen
    endscript
}

vs_buildout
├── README.rst
├── base.cfg
├── bootstrap.py
├── deploy.cfg
├── devel.cfg
├── develop-eggs
│   └── vs.policy.egg-link
├── docs
│   └── HISTORY.rst
├── eggs
│   ├── AccessControl-2.13.10-py2.7-macosx-10.4-x86_64.egg
│   ├── Acquisition-2.13.8-py2.7-macosx-10.4-x86_64.egg
│   ├── …
├── etc
│   ├── logrotate.conf
│   └── plone.vcl
├── rsync.cfg
├── src
│   ├── README.txt
│   └── vs.policy
├── templates
│   ├── haproxy.conf.in
│   ├── logrotate.conf.in
│   └── plone.vcl.in
├── var
│   ├── blobbackup-blobstorages
│   ├── blobbackup-blobstoragesnapshots
│   ├── blobstorage
│   │   └── tmp
│   ├── filebackup-snapshots
│   ├── filebackups
│   ├── filestorage
│   │   ├── Data.fs
│   │   ├── Data.fs.index
│   │   ├── Data.fs.lock
│   │   └── Data.fs.tmp
│   ├── instance
│   │   └── import
│   ├── instance-base
│   │   └── import
│   └── log
│       └── zeoserver.log
├── versions.cfg
└── vs_buildout.txt

[buildout]
eggs-directory = /home/veit/.buildout/eggs

download-cache = /home/veit/.buildout/downloads

extends-cache = /home/veit/.buildout/cache

[buildout]
…
index = https://pypi.org/simple/

[buildout]
…
find-links =
    http://download.zope.org/distribution/
    /some/path
    /other/path/someegg-1.0.0-py2.4.egg

[buildout]
eggs-directory = /home/veit/.buildout/eggs
download-cache = /home/veit/.buildout/downloads
extends-cache = /home/veit/.buildout/cache
index = https://pypi.python.org/simple
socket-timeout = 3

[instance]
...
eggs =
    Products.DocFinderTab

parts =
    ...
    pyflakes

[pyflakes]
recipe = zc.recipe.egg:scripts
eggs = pyflakes
scripts = pyflakes
entry-points = pyflakes=pyflakes.scripts.pyflakes:main

[instance]
...
eggs =
    plone.app.debugtoolbar

parts =
    pylint
    ...

[pylint]
recipe = zc.recipe.egg
eggs =
    ${instance:eggs}
    pylint
entry-points = pylint=pylint.lint:Run
arguments = sys.argv[1:]

[instance]
...
debug-mode = on
eggs =
    Products.PDBDebugMode
    z3c.deadlockdebugger

[buildout]
parts =
    ...
    roadrunner

[roadrunner]
recipe = roadrunner:plone
packages-under-test = vs.policy

$ ./bin/roadrunner -s vs.policy

chown -R ${env:USER}:${grp:GROUP} ${buildout:directory}

[env]
recipe = gocept.recipe.env

[grp]
recipe = collective.recipe.grp

[buildout]
_
parts =
    ...
    ipzope
...
   [ipzope]
   # An IPython Shell for interactive use with Zope running.
   #
   # It requires the `ipy_profile_zope.py` configuration script. Get this from
   # git@github.com:collective/dotipython.git and put it in your profile
   # directory. Depending on your setup, this may be at
   # `$HOME/.ipython/profile_zope/startup`,
   # `$HOME/.config/ipython/profile_zope/startup` (Ubuntu 12.04), or see
   # http://ipython.org/ipython-doc/dev/config/overview.html#configuration-file-location
   # for more details.
   #
   recipe = zc.recipe.egg
   eggs =
       ipython
       ${instance}
   initialization =
       import sys, os
       os.environ["INSTANCE_HOME"] = "${instance:location}"
       sys.argv[1:1] = "--profile=zope".split()
   scripts = ipython=ipzope

$ ./bin/buildout
$ ./bin/ipzope

utils.commit()

utils.sync()

[buildout]
_
[instance]
eggs +=
    ...
    iw.debug
_
[instance]
_
zcml +=
    iw.debug

$ ./bin/buildout
$ ./bin/instance fg

...
--Return--
None
> /Users/veit/.buildout/eggs/iw.debug-0.3-py2.7.egg/iw/debug/pdbview.py(92)pdb()
     91             else:
---> 92                 set_trace()
     93

ipdb> ll
{'request': <HTTPRequest, URL=http://localhost:8080/Plone/ipdb>, 'portal': <PloneSite at /Plone>, 'context': <PloneSite at /Plone>, 'meth': None, 'view': None}
ipdb> context
<PloneSite at /Plone>
ipdb> context == portal
True
ipdb> portal.Title()
'Website'
ipdb> portal.portal_quickinstaller.listInstallableProducts()
[{'status': 'new', 'hasError': False, 'id': 'plone.app.dexterity', 'title': u'Dexterity Content Types'}, {'status': 'new', 'hasError': False, 'id': 'plone.app.theming', 'title': u'Diazo theme support'}, {'status': 'new', 'hasError': False, 'id': 'plone.app.caching', 'title': u'HTTP caching support'}, {'status': 'new', 'hasError': False, 'id': 'Marshall', 'title': 'Marshall'}, {'status': 'new', 'hasError': False, 'id': 'plone.app.openid', 'title': u'OpenID Authentication Support'}, {'status': 'new', 'hasError': False, 'id': 'plone.app.debugtoolbar', 'title': u'Plone debug toolbar'}, {'status': 'new', 'hasError': False, 'id': 'plone.session', 'title': u'Session refresh support'}, {'status': 'new', 'hasError': False, 'id': 'plone.resource', 'title': u'Static resource storage'}, {'status': 'new', 'hasError': False, 'id': 'CMFPlacefulWorkflow', 'title': u'Workflow Policy Support (CMFPlacefulWorkflow)'}, {'status': 'new', 'hasError': False, 'id': 'plone.app.iterate', 'title': u'Working Copy Support (Iterate)'}, {'status': 'new', 'hasError': False, 'id': 'collective.z3cform.datetimewidget', 'title': u'collective.z3cform.datetimewidget'}]
ipdb>

[buildout]
…
eggs =
    …
    sauna.reload

[instance]
…
zope-conf-additional =
    %import sauna.reload

$ RELOAD_PATH=src/ ./bin/instance fg

http://localhost:8080/@@saunareload

[buildout]
…
extensions = mr.developer
sources = sources
auto-checkout =
    vs.policy
    some.package
    bootstrap
always-checkout = true

[sources]
vs.policy = svn https://svn.veit-schiele.de/svn/vs.policy/trunk
some.package = git git://example.com/git/some.package.git
bootstrap = git git://github.com/twitter/bootstrap.git rev=d9b502dfb876c40b0735008bac18049c7ee7b6d2 path=${buildout:directory} egg=false

$ ./bin/develop help

$ cd src
$ $ ../bin/zopeskel plone_basic
…
Enter project name (or q to quit): vs.policy
Expert Mode? (What question mode would you like? (easy/expert/all)?) ['easy']: all
Namespace Package Name (Name of outer namespace package) ['vs']:
Package Name (Name of the inner namespace package) ['policy']:
Version (Version number for project) ['1.0']:
Description (One-line description of the project) ['']: Policy package for demonstration purposes
Register Profile (Should this package register a GS Profile) [False]: True
Long Description (Multi-line description (in ReST)) ['']: Policy package for demonstration purposes
Author (Name of author for project) ['']: Veit Schiele
Author Email (Email of author for project) ['']: kontakt@veit-schiele.de
Keywords (List of keywords, space-separated) ['']: Zope Plone
Project URL (URL of the homepage for this project) ['http://svn.plone.org/svn/collective/']: https://github.com/veit/vs.policy
Project License (Name of license for the project) ['GPL']:
Zip-Safe? (Can this project be used as a zipped egg? (true/false)) [False]:
Zope2 Product? (Are you creating a product for Zope2) [True]:
Creating directory ./vs.policy
…

vs_buildout/src/vs.policy
├── CHANGES.rst
├── CONTRIBUTORS.rst
├── README.rst
├── bootstrap.py
├── buildout.cfg
├── docs
│   ├── LICENSE.GPL
│   └── LICENSE.txt
├── setup.cfg
├── setup.py
└── src
    └── vs
        ├── __init__.py
        └── policy
            ├── __init__.py
            ├── configure.zcml
            ├── profiles
            │   ├── default
            │   │   └── metadata.xml
            │   └── testing
            │       └── metadata.xml
            ├── testing.py
            └── tests
                ├── __init__.py
                └── test_example.py

[buildout]
…
develop =
    src/vs.policy
…
[instance-base]
eggs +=
    …
    vs.policy

setup(name='vs.theme',
    …
    entry_points="""
    # -*- entry_points -*-
    [z3c.autoinclude.plugin]
    target = plone
    """,
    …
    )

[instance]
…
zcml =
    vs.policy

<include package="vs.policy" file="configure.zcml" />

$ ./bin/zopepy
>>> from vs import policy

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:five="http://namespaces.zope.org/five"
    xmlns:genericsetup="http://namespaces.zope.org/genericsetup"
    i18n_domain="vs.policy">

<five:registerPackage package="." initialize=".initialize" />

<genericsetup:registerProfile
  name="default"
  title="vs.policy"
  directory="profiles/default"
  description="Policies for www.veit-schiele.de"
  provides="Products.GenericSetup.interfaces.EXTENSION"
  />

</configure>

$ mkdir src/vs.policy/vs/policy/profiles src/vs.policy/vs/policy/profiles/default

<?xml version="1.0"?>
<site>
 <property name="title">Veit Schiele</property>
 <property name="description">Welcome to Veit Schiele</property>
</site>

<genericsetup:importStep
    name="vs.policy.various"
    title="vs.policy: miscellaneous import steps"
    description="Various import steps that are not handled by GS import/export handlers."
    handler="vs.policy.setuphandlers.setupVarious">
</genericsetup:importStep>

def setupVarious(context):
    if context.readDataFile('vs.policy_various.txt') is None:
        return

import logging
from plone.app.controlpanel.filter import IFilterSchema

logger = logging.getLogger('vs.policy')

def allowTags(site):
    """
    Allows embed, object, param and iframe tags
    """

    adapter = IFilterSchema(site)
    nasty_tags = adapter.nasty_tags
    if 'object' in nasty_tags:
        nasty_tags.remove('object')
    if 'embed' in nasty_tags:
        nasty_tags.remove('embed')

    stripped_tags = adapter.stripped_tags
    if 'object' in stripped_tags:
        stripped_tags.remove('object')
    if 'param' in stripped_tags:
        stripped_tags.remove('param')

    custom_tags = adapter.custom_tags
    if not 'embed' in custom_tags:
        custom_tags.append('embed')
    if not 'iframe' in custom_tags:
        custom_tags.append('iframe')

    adapter.nasty_tags = nasty_tags
    adapter.stripped_tags = stripped_tags
    adapter.custom_tags = custom_tags
    logger.info("Allowing embed, object, param and iframe tags.")

def setupVarious(context):

    if context.readDataFile('vs.policy_various.txt') is None:
        return

    site = context.getSite()
    allowIframeTags(site)

$ rm -rf src/vs.policy/vs/policy/tests.py
$ mkdir src/vs.policy/vs/policy/tests
$ touch src/vs.policy/vs/policy/tests/__init__.py

import unittest2 as unittest

from plone.testing import z2
from plone.app.testing import TEST_USER_NAME
from plone.app.testing import TEST_USER_PASSWORD

from vs.policy.tests import layer

def get_browser(app, loggedIn=True):
    browser = z2.Browser(app)
    if loggedIn:
        auth = 'Basic %s:%s' % (TEST_USER_NAME, TEST_USER_PASSWORD)
        browser.addHeader('Authorization', auth)
    return browser

class TestCase(unittest.TestCase):
    layer = layer.VS_POLICY_INTEGRATION

class FunctionalTestCase(unittest.TestCase):
    layer = layer.VS_POLICY_FUNCTIONAL

from plone.app.testing import applyProfile
from plone.app.testing import PloneFixture
from plone.app.testing import PloneSandboxLayer
from plone.app.testing import PloneTestLifecycle
from plone.app.testing import setRoles
from plone.app.testing import TEST_USER_ID
from plone.testing import z2
from zope.configuration import xmlconfig

class VsPolicyFixture(PloneFixture):
    # No sunburst please
    extensionProfiles = ()

VS_POLICY_FIXTURE = VsPolicyFixture()

class VsPolicyTestLifecycle(PloneTestLifecycle):
    defaultBases = (VS_POLICY_FIXTURE, )

class IntegrationTesting(VsPolicyTestLifecycle, z2.IntegrationTesting):
    pass

class FunctionalTesting(VsPolicyTestLifecycle, z2.FunctionalTesting):
    pass

class VsPolicyLayer(PloneSandboxLayer):
    defaultBases = (VS_POLICY_FIXTURE, )

    def setUpZope(self, app, configurationContext):
        import vs.policy

        xmlconfig.file("configure.zcml", vs.policy,
                       context=configurationContext)
        z2.installProduct(app, 'vs.policy')

    def tearDownZope(self, app):
        z2.uninstallProduct(app, 'vs.policy')

    def setUpPloneSite(self, portal):
        applyProfile(portal, 'vs.policy:default')

        setRoles(portal, TEST_USER_ID, ['Manager'])
        portal.invokeFactory('Folder', 'test-folder')
        setRoles(portal, TEST_USER_ID, ['Member'])

VS_POLICY_LAYER = VsPolicyLayer()
VS_POLICY_INTEGRATION = IntegrationTesting(
    bases=(VS_POLICY_LAYER, ), name="VsPolicyLayer:Integration")
VS_POLICY_FUNCTIONAL = FunctionalTesting(
    bases=(VS_POLICY_LAYER, ), name="VsPolicyLayer:Functional")

from vs.policy.tests.base import FunctionalTestCase

class TestTest(FunctionalTestCase):

    def test_test(self):
        self.assertTrue(True)

self.assertRaises(AttributeError, myObject.myMethod, someParameter)

$ ./bin/test -s vs.policy

 AssertionError:"Welcome to Veit Schiele != ''
…
AssertionError:'Veit Schiele != 'Plone site'
Ran 2 tests with 2 failures and 0 errors

Ran 2 tests with 0 failures and 0 errors.

$ ./bin/test -s my.package  -m 'test_setup'

$ ./bin/test -s vs.policy -m '.*setup.*' -t '.*installed.*'

$ ./bin/test --help

Ran 10 tests with 0 failures and 0 errors in 4.830 seconds.

Ran 10 tests with 2 failures and 3 errors in 9.688 seconds.

[buildout]
parts =
    …
    roadrunner

[roadrunner]
recipe = roadrunner:plone
packages-under-test = vs.policy

$ ./bin/roadrunner -s vs.policy

import pdb; pdb.set_trace()

install_requires=[
    'setuptools',
    'Plone',
    'vs.event',
],

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:five="http://namespaces.zope.org/five"
    xmlns:i18n="http://namespaces.zope.org/i18n"
    xmlns:genericsetup="http://namespaces.zope.org/genericsetup"
    i18n_domain="vs.policy">
    <includeDependencies package="." />
    …
</configure>

<include package="vs.event" />

<?xml version="1.0"?>
<metadata>
  <version>1.0</version>
  <dependencies>
    <dependency>profile-vs.event:default</dependency>
  </dependencies>
</metadata>

$ bin/buildout

class VsPolicy(PloneSandboxLayer):
    defaultBases = (PLONE_FIXTURE,)
    def setUpZope(self, app, configurationContext):
        # Load ZCML
        import vs.policy
        xmlconfig.file(
            'configure.zcml',
            vs.policy,
            context=configurationContext
        )
        # Install products that use an old-style initialize()
        # function
        z2.installProduct(app, 'vs.event')

def tearDownZope(self, app):
    # Uninstall products installed above
    z2.uninstallProduct(app, 'vs.event')

def setUpPloneSite(self, portal):
    applyProfile(portal, 'vs.policy:default')

def test_vs_event_installed(self):
    portal = self.layer['portal']
    portal_types = getToolByName(portal, 'portal_types')
    self.assertTrue("VSEvent" in portal_types)

$ ./bin/test

$ gem install docsplit --user-install

export PATH=$HOME/.gem/ruby/1.9.1/bin:$PATH

$ source ~/.bashrc

def installLinguaPlone(site):

     # LP must be installed a last step in order to deal with
     # several strange annoyances and expecations that LP relies on.

    pl = getToolByName(site, 'portal_languages')
    pl.supported_langs = ('de', 'en')

    qi = getToolByName(site, 'portal_quickinstaller')
    qi.installProducts(['Products.LinguaPlone'])

    transaction.savepoint(1)#
    site.restrictedTraverse('@@language-setup-folders')()

…

def setupVarious(context):
    if context.readDataFile('ise.policy_various.txt') is None:
        return
    …
    installLinguaPlone(site)

import unittest2
from base import TestBase

class LanguageTests(TestBase):
    def testInstalledProducts(self):
        …
        self.assertEqual('LinguaPlone' in installed, True)

    def testLanguageSettings(self):
        lang_tool = self.portal.portal_languages
        default_language = self.portal.portal_languages.getDefaultLanguage()
        self.assertEqual(default_language == 'de', True)
        # return [(country code, countryname), ...]
        supported_languages = [r[0] for r in self.portal.portal_languages.listSupportedLanguages()]
        self.assertEqual('en' in supported_languages, True)
        self.assertEqual('de' in supported_languages, True)
        self.assertEqual(lang_tool.use_cookie_negotiation, True)
        self.assertEqual(lang_tool.use_request_negotiation, True)
        self.assertEqual(lang_tool.use_content_negotiation, True)

def test_suite():
    from unittest2 import TestSuite, makeSuite
    suite = TestSuite()
    suite.addTest(makeSuite(LanguageTests))
    return suite

<include file="patches.zcml" />

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:monkey="http://namespaces.plone.org/monkey"
    i18n_domain="vs.policy">

    <include package="collective.monkeypatcher" />

    <monkey:patch
        description="TinyMCE JSON Folder listing should ignore INavigationRoot"
        class="Products.TinyMCE.adapters.JSONFolderListing.JSONFolderListing"
        original="getListing"
        replacement=".patches.getListing"
        />

    <monkey:patch
        description="Navigation support RefBrowserWidget across INavigationRoot"
        class="archetypes.referencebrowserwidget.browser.view.ReferenceBrowserPopup"
        original="breadcrumbs"
        replacement=".patches.breadcrumbs"
        />

   <monkey:patch
        description="Unrestrict TinyMCE image search"
        class="Products.TinyMCE.adapters.JSONSearch.JSONSearch"
        original="getSearchResults"
        replacement=".patches.getSearchResults"
        />
</configure>

$ cd src
$ paster create -t plone3_theme

Enter namespace_package (Namespace package (like plonetheme)) ['plonetheme']: vs
Enter package (The package contained namespace package (like example)) ['example']: theme
Enter skinname (The skin selection to be added to 'portal_skins' (like 'My Theme')) ['']: vs.theme
Enter skinbase (Name of the skin selection from which the new one will be copied) ['Plone Default']:
Enter empty_styles (Override default public stylesheets with empty ones?) [True]: False
Enter include_doc (Include in-line documentation in generated code?) [False]:
Enter zope2product (Are you creating a Zope 2 Product?) [True]:
…
Enter zip_safe (True/False: if the package can be distributed as a .zip file) [False]:

<?xml version="1.0"?>
<object name="portal_skins" allow_any="False" cookie_persistence="False"
        default_skin="vs.theme">

    <object name="vs_theme_custom_images"
            meta_type="Filesystem Directory View"
            directory="vs.theme:skins/vs_theme_custom_images"/>
    <object name="vs_theme_custom_templates"
            meta_type="Filesystem Directory View"
            directory="vs.theme:skins/vs_theme_custom_templates"/>
    <object name="vs_theme_styles"
            meta_type="Filesystem Directory View"
            directory="vs.theme:skins/vs_theme_styles"/>

    <skin-path name="vs.theme" based-on="Plone Default">
        <layer name="vs_theme_custom_images"
               insert-after="custom"/>
        <layer name="vs_theme_custom_templates"
               insert-after="vs_theme_custom_images"/>
        <layer name="vs_theme_styles"
               insert-after="vs_theme_custom_templates"/>
    </skin-path>

</object>

<skin-path name="*">
    ...
</skin-path>

<object name="vs_theme_custom_templates" remove="True "/>

logoName:string=logo.gif

<?xml version="1.0"?>
<object name="portal_css">

 <stylesheet title=""
    id="++resource++vs.theme.stylesheets/main.css"
    media="screen"
    rel="stylesheet"
    rendering="import"
    cacheable="True"
    compression="safe"
    cookable="True"
    enabled="1"
    expression=""/>

</object>

expression = "python:object.meta_type == 'ATFolder'"

expression="object/@@registration_view/enabled | nothing"

expression="python:portal.restrictedTraverse ('@@plone_portal_state').is_rtl()"

expression="not: portal/portal_membership/isAnonymousUser"

expression="python: not here.restrictedTraverse
                        ('@@plone_portal_state').anonymous()"

<!--[if IE]>
<style type="text/css" media="all">@import url(http://localhost:8080/mysite/portal_css/vs.theme/iefixes-cachekey7904.css);</style>
<![endif]-->

<stylesheet title=""
            …
            conditionalcomment="IE"
            id="iefixes.css"/>

<stylesheet id="++resource++vs.theme.stylesheets/main.css" remove="True"/>

<interface
   interface=".interfaces.IThemeSpecific"
   type="zope.publisher.interfaces.browser.IBrowserSkinType"
   name="vs.theme"
   />

<browser:page
    for="Products.CMFCore.interfaces.ISiteRoot"
    name="dashboard"
    permission="plone.app.portlets.ManageOwnPortlets"
    class=".dashboard.DashboardView"
    template="dashboard.pt"
    />

<browser:page
    for="Products.CMFCore.interfaces.ISiteRoot"
    class=".manage.ManageDashboardPortlets"
    name="manage-dashboard"
    template="templates/manage-dashboard.pt"
    permission="plone.app.portlets.ManageOwnPortlets"
    />

<include package="plone.app.portlets" />

<browser:page
    for="Products.CMFCore.interfaces.ISiteRoot"
    name="dashboard"
    permission="plone.app.portlets.ManageOwnPortlets"
    class="plone.app.layout.dashboard.dashboard.DashboardView"
    template="templates/dashboard.pt"
    layer=".interfaces.IThemeSpecific"
    />

<browser:page
    for="Products.CMFCore.interfaces.ISiteRoot"
    name="manage-dashboard"
    permission="plone.app.portlets.ManageOwnPortlets"
    class="plone.app.portlets.browser.manage.ManageDashboardPortlets"
    template="templates/manage-dashboard.pt"
    layer=".interfaces.IThemeSpecific"
    />

<!-- <metal:left fill-slot="column_one_slot" /> -->
<!-- <metal:right fill-slot="column_two_slot" /> -->

<head>
    <metal:block fill-slot="top_slot"
                 tal:define="dummy python:request.set('disable_border',1);
                             disable_column_one python:request.set('disable_plone.leftcolumn',1);
                             disable_column_two python:request.set('disable_plone.rightcolumn',1);" />
</head>

tal:define="canModifyItem python:checkPermission('Modify portal content', obj);"

self.portal_state = getMultiAdapter((self.context, self.request),
                                    name=u'plone_portal_state')
self.portal_url = self.portal_state.portal_url()

tal:attributes="value context/@@plone_context_state/current_page_url"

<?xml version="1.0"?>
<object>
    <order manager="plone.portaltop" skinname="vs.theme" based-on="Plone Default">
        <viewlet name="plone.header" />
    </order>

    <hidden manager="plone.portaltop" skinname="vs.theme">
        <viewlet name="plone.app.i18n.locales.languageselector" />
        <viewlet name="plone.path_bar" />
        <viewlet name="plone.personal_bar" />
    </hidden>

    <order manager="plone.portalheader" skinname="vs.theme" based-on="Plone Default">
        <viewlet name="plone.skip_links" />
        <viewlet name="plone.site_actions" />
        <viewlet name="plone.logo" />
        <viewlet name="plone.global_sections" />
    </order>

    <hidden manager="plone.portalheader" skinname="vs.theme">
        <viewlet name="plone.searchbox" />
    </hidden>

    <order manager="plone.contentviews" skinname="vs.theme" based-on="Plone Default">
        <viewlet name="vs.path_bar" />
        <viewlet name="vs.personal_bar" />
        <viewlet name="plone.contentviews" />
        <viewlet name="plone.contentactions" />
    </order>

    <hidden manager="plone.belowcontenttitle" skinname="vs.theme">
        <viewlet name="plone.belowcontenttitle.documentbyline" />
    </hidden>

    <hidden manager="plone.abovecontentbody" skinname="vs.theme">
        <viewlet name="plone.presentation" />
    </hidden>

    <order manager="plone.portalfooter" skinname="vs.theme" based-on="Plone Default">
        <viewlet name="vs.footer" />
        <viewlet name="plone.colophon" />
    </order>

    <hidden manager="plone.portalfooter" skinname="vs.theme">
        <viewlet name="plone.footer" />
    </hidden>

</object>

skinname="*"

<browser:viewletManager
    name="plone.portaltop"
    provides=".interfaces.IPortalTop"
    permission="zope2.View"
    class="plone.app.viewletmanager.manager.OrderedViewletManager"
    />

<div tal:replace="structure provider:plone.portaltop" />

<browser:viewlet
    name="vs.personal_bar"
    manager="plone.app.layout.viewlets.interfaces.IContentViews"
    layer=".interfaces.IThemeSpecific"
    class="plone.app.layout.viewlets.common.PersonalBarViewlet"
    permission="zope2.View"
    />

<interface
   interface=".interfaces.IThemeSpecific"
   type="zope.publisher.interfaces.browser.IBrowserSkinType"
   name="vs.theme"
   />

<hidden manager="plone.portaltop" skinname="vs.theme">
    …
    <viewlet name="plone.personal_bar" />
    …
</hidden>
…
<order manager="plone.contentviews" skinname="vs.theme" based-on="Plone Default">
    <viewlet name="vs.personal_bar" />
    …
</order>

<browser:viewlet
    name="vs.footer"
    manager="plone.app.layout.viewlets.interfaces.IPortalFooter"
    layer=".interfaces.IThemeSpecific"
    template="templates/footer.pt"
    permission="zope2.View"
    />

<browser:viewlet
    name="vs.path_bar"
    manager="plone.app.layout.viewlets.interfaces.IContentViews"
    layer=".interfaces.IThemeSpecific"
    class=".viewlets.PathBarViewlet"
    permission="zope2.View"
    />

from zope.component import getMultiAdapter
from Products.Five.browser.pagetemplatefile import ViewPageTemplateFile
from plone.app.layout.viewlets import common

class PathBarViewlet(common.PathBarViewlet):
    render = ViewPageTemplateFile('templates/path_bar.pt')

<metal:content-core fill-slot="content-core">
    <metal:content-core define-macro="content-core">
        <metal:field use-macro="python:context.widget('text', mode='view')">
            Body text
        </metal:field>
    </metal:content-core>
</metal:content-core>

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:browser="http://namespaces.zope.org/browser"
    xmlns:plone="http://namespaces.plone.org/plone"
    i18n_domain="vs.theme">

<include package="plone.app.portlets" />
…
<plone:portletRenderer
    portlet="plone.app.portlets.portlets.search.ISearchPortlet"
    layer=".interfaces.IThemeSpecific"
    template="templates/search_portlet.pt"
    />
…
</configure>

from zope.component import getMultiAdapter
from zope.component import getUtility
from plone.portlets.interfaces import IPortletAssignmentMapping
from plone.portlets.interfaces import IPortletManager
from plone.app.portlets import portlets

class Generator:
    def setupPortlets(self, portal):
        leftColumn = getUtility(IPortletManager, name=u'plone.leftcolumn', context=portal)
        rightColumn = getUtility(IPortletManager, name=u'plone.rightcolumn', context=portal)

        left = getMultiAdapter((portal, leftColumn,), IPortletAssignmentMapping, context=portal)
        right = getMultiAdapter((portal, rightColumn,), IPortletAssignmentMapping, context=portal)

        if u'search' not in left:
            left[u'search'] = portlets.search.Assignment(enableLivesearch=True,)

def setupVarious(context):
    if context.readDataFile('vs.theme_various.txt') is None:
        return

    site = context.getSite()
    gen = Generator()
    gen.setupPortlets(site)

<?xml version="1.0"?>
<portlets
    xmlns:i18n="http://xml.zope.org/namespaces/i18n"
    i18n:domain="plone">

<assignment
           manager="plone.leftcolumn"
           category="context"
           key="/"
           type="portlets.Search"
           name="search"
           insert-before="*"
           >

    <property name="enableLivesearch">True</property>

</assignment>
</portlets>

<portletmanager
  name="plone.leftcolumn"
  type="plone.app.portlets.interfaces.ILeftColumn"
  />

<assignment name="quick-links" category="user" key="veit"
   manager="plone.dashboard1" type="plone.portlet.collection.Collection">
 <property name="show_more">True</property>
 <property name="header">Quick links</property>
 <property name="limit">10</property>
 <property
    name="target_collection">/quick-links/quick-links</property>
 <property name="random">False</property>
 <property name="show_dates">False</property>
</assignment>

from plone.portlets.constants import CONTEXT_CATEGORY as CONTEXT_PORTLETS

class Generator:

    def setupPortlets(self, portal):
        rightColumn = getUtility(IPortletManager, name=u'plone.rightcolumn', context=portal)
        portletAssignments = getMultiAdapter((members, rightColumn,), ILocalPortletAssignmentManager)
        portletAssignments.setBlacklistStatus(CONTEXT_PORTLETS, True)

<blacklist
    manager="plone.rightcolumn"
    location="/Members"
    category="context"
    status="block"
    />

from zope.component import getUtility
from zope.component import getMultiAdapter
from plone.portlets.interfaces import IPortletManager
from plone.portlets.interfaces import IPortletAssignmentMapping

class Generator:
    def setupPortlets(self, portal):
        rightColumn = getUtility(IPortletManager, name=u'plone.rightcolumn', context=portal)
        right = getMultiAdapter((portal, rightColumn,), IPortletAssignmentMapping, context=portal)
        if u'calendar' in right:
            del right["calendar"]

def setupVarious(context):
    if context.readDataFile('vs.theme_various.txt') is None:
        return
    site = context.getSite()
    gen = Generator()
    gen.setupPortlets(site)

from zope.component import getSiteManager
from zope.component import getUtilitiesFor
from plone.portlets.interfaces import IPortletType
from Products.CMFCore.utils import getToolByName

def removeRegistrantsPortlet(self):
    sm = getSiteManager()
    for name, portletType in getUtilitiesFor(IPortletType):
        if name == "portlets.Registrants":
            sm.unregisterUtility(provided=IPortletType, name=name)

<assignment
    remove="true"
    name="calendar"
    category="context"
    key="/"
    manager="plone.rightcolumn"
    type="portlets.Calendar" />

<assignment
    visible="0"
    name="calendar"
    category="context"
    key="/"
    manager="plone.rightcolumn"
    type="portlets.Calendar" />

<assignment
    purge="True"
    manager="plone.rightcolumn"
    category="context"
    key="/Plone/news"
    />

<dl class="portlet portletSiteActions"
    i18n:domain="vs.theme">

    <dt class="portletHeader">
        <span class="portletTopLeft"></span>
        Site Actions
        <span class="portletTopRight"></span>
    </dt>

    <tal:actions tal:define="accesskeys python: {'sitemap' : '3', 'accessibility' : '0', 'contact' : '9'};"
                 tal:condition="view/site_actions">
        <dd class="portletItem"
            tal:repeat="saction view/site_actions"
            tal:attributes="id string:siteaction-${saction/id}">
            <a href=""
               tal:define="title saction/title;
                           id saction/id;
                           accesskey python: accesskeys.get(id, '');"
               i18n:attributes="title"
               i18n:translate=""
               tal:content="title"
               tal:attributes="href saction/url;
                               target saction/link_target|nothing;
                               title title;
                               accesskey accesskey;"
            >Site action</a>
        </dd>
    </tal:actions>
</dl>

from zope import schema
from zope.component import getMultiAdapter
from zope.formlib import form
from zope.interface import implements

from plone.app.portlets.portlets import base
from plone.portlets.interfaces import IPortletDataProvider
from Products.Five.browser.pagetemplatefile import ViewPageTemplateFile

from vs.theme import VsThemeMessageFactory as _

class ISiteActionsPortlet(IPortletDataProvider):
    """A portlet which shows the available site actions.
    """

class Assignment(base.Assignment):
    implements(ISiteActionsPortlet)

    @property
    def title(self):
        return _(u"Site actions")

class Renderer(base.Renderer):
    render = ViewPageTemplateFile('siteactions.pt')
    title = _('box_siteactions', default=u"Site actions")

    def site_actions(self):
        context_state = getMultiAdapter((self.context, self.request),
                                        name=u'plone_context_state')
        self.siteactions = context_state.actions('site_actions')
        return self.siteactions

class AddForm(base.NullAddForm):
    form_fields = form.Fields(ISiteActionsPortlet)
    label = _(u"Add Site Actions Portlet")
    description = _(u"This portlet lists the available site actions.")

    def create(self):
        return Assignment()

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:plone="http://namespaces.plone.org/plone">

    <include package="plone.app.portlets" />

    <plone:portlet
        name="vs.theme.SiteActionsPortlet"
        interface=".siteactions.ISiteActionsPortlet"
        assignment=".siteactions.Assignment"
        renderer=".siteactions.Renderer"
        addview=".siteactions.AddForm"
        />

</configure>

<?xml version="1.0"?>
<portlets>
    <portlet
       addview="vs.theme.SiteActionsPortlet"
       title="Site Actions"
       description="A portlet which can show the available site actions."
       />
</portlets>

<tal:block replace="structure provider:vs.abovecontentportlets" />

<browser:viewlet
    name="vs.abovecontentportlets"
    manager="plone.app.layout.viewlets.interfaces.IContentViews"
    layer=".interfaces.IThemeSpecific"
    template="templates/abovecontentportlets.pt"
    permission="zope2.View"
/>

from plone.theme.interfaces import IDefaultPloneLayer

class IThemeSpecific(IDefaultPloneLayer):
    """Marker interface that defines a Zope 3 browser layer.
       If you need to register a viewlet only for the
       "vs.theme" theme, this interface must be its layer.
    """

<?xml version="1.0"?>
<layers>
    <layer name="vs.theme.layer"
           interface="vs.theme.browser.interfaces.IThemeSpecific" />
</layers>

from plone.portlets.interfaces import IPortletManager

class IVsAboveContent(IPortletManager):
    """Portlet manager above the content area.
    """

<?xml version="1.0"?>
<portlets>
    <portletmanager
         name="vs.abovecontentportlets"
         type="vs.theme.browser.interfaces.IVsAboveContent"
    />
</portlets>

<browser:page
    for="plone.portlets.interfaces.ILocalPortletAssignable"
    class="plone.app.portlets.browser.manage.ManageContextualPortlets"
    name="manage-vsabove"
    template="templates/managevsabove.pt"
    permission="plone.app.portlets.ManagePortlets"
/>

<include package="plone.app.portlets" />

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:metal="http://xml.zope.org/namespaces/metal"
      xmlns:tal="http://xml.zope.org/namespaces/tal"
      xmlns:i18n="http://xml.zope.org/namespaces/i18n"
      metal:use-macro="context/main_template/macros/master"
      i18n:domain="plone">
<head>
    <div metal:fill-slot="javascript_head_slot" tal:omit-tag="">
        <link type="text/css" rel="kinetic-stylesheet"
            tal:attributes="href string:${context/absolute_url}/++resource++manage-portlets.kss"/>
    </div>
</head>
<body>
<div metal:fill-slot="main">
  <h1 class="documentFirstHeading">Manage above content portlets</h1>
  <span tal:replace="structure provider:vs.abovecontentportlets" />
</div>
</body>
</html>

http://localhost/mysite/@@manage-vsabove

<title tal:content="context/title">Page Title</title>

Die URL ist <span tal:replace="request/URL">URL</span>.

Die URL ist http://localhost:8080/mysite/my_page.

<title tal:content="template/title">The Title</title>

<table>
    <tr>
        <th>#</th><th>Id</th><th>Meta-Type</th><th>Title</th>
    </tr>
    <tr tal:repeat="item container/objectValues">
        <td tal:content="repeat/item/number">#</td>
        <td tal:content="item/id">Id</td>
        <td tal:content="item/meta_type">Meta-Type</td>
        <td tal:content="item/title">Title</td>
    </tr>
</table>

<table>
    <tr>
        <th>#</th><th>Id</th><th>Meta-Type</th><th>Title</th>
    </tr>
    <tbody tal:repeat="item container/objectValues">
        <tr bgcolor="#DDE0E8" tal:condition="repeat/item/even">
            <td tal:content="repeat/item/number">#</td>
            <td tal:content="item/id">Id</td>
            <td tal:content="item/meta_type">Meta-Type</td>
            <td tal:content="item/title">Title</td>
        </tr>
        <tr tal:condition="repeat/item/odd">
            <td tal:content="repeat/item/number">#</td>
            <td tal:content="item/id">Id</td>
            <td tal:content="item/meta_type">Meta-Type</td>
            <td tal:content="item/title">Title</td>
        </tr>
    </tbody>
</table>

<a tal:attributes="href href" tal:content="text" />

<a href="${href}">${text}</a>

class Markup(object):
    def __init__(self, s):
        self.s = s

    def __html__(self):
        return s

from chameleon.utils import Markup
form.status = Markup('<div class="note">Note</div>')

#confirm-registrant input:click {
    evt-click-preventdefault: true;
    action-server:confirmRegistrant;
    confirm-registrant: kssAttr('confirm');
}

<browser:resource
    name="registration.kss"
    file="registration.kss"
    />

<link rel="kinetic-stylesheet"
      type="text/css"
      href="http://localhost:8080/mysite/++resource++registration.kss" />

<?xml version="1.0"?>
<object name="portal_kss" meta_type="KSS Registry">
 <kineticstylesheet
     cacheable="True"
     compression="safe"
     cookable="True"
     enabled="1"
     expression=""
     id="registration.kss"/>
</object>

<tal:registrants condition="view/have_registrants">
    <h2 i18n:translate="title_registration_contents">Registrants</h2>
    <form action="confirmRegistrant">
        <tal:block repeat="registrant view/registrants">
            <dt>
                <a tal:attributes="href registrant/url"
                   tal:content="registrant/title" />
            </dt>
            <dd tal:content="registrant/address" />
            <dd>
                <input class="kssattr-confirm-yes"
                       type="submit"
                       name="vs.registration.confirm.confirm"
                       value="yes"
                       i18n:attributes="value"
                       i18n:attributes="confirm-button"
                       />
                <input class="kssattr-confirm-no"
                       type="submit"
                       name="vs.registration.confirm.reject"
                       value="no"
                       i18n:attributes="value"
                       i18n:attributes="reject-button"
                       />
            </dd>
        </tal:block>
    </form>
</tal:registrants>

action-server:confirmRegistrant;
confirm-registrant: kssAttr('confirm');

<browser:page
    for="vs.registration.interfaces.IRegistration"
    name="confirmRegistrant"
    class=".confirmations.confirmedRegistrants"
    attribute="confirm_registrant"
    permission="zope2.RequestReview"
    />

from zope.interface import alsoProvides
from kss.core import kssaction
from plone.app.kss.plonekssview import PloneKSSView
from plone.app.layout.globals.interfaces import IViewView
from Akquisition import aq_inner
from Products.Five.browser import BrowserView
from vs.Registration.interfaces import IConfirmations

class confirmedRegistrants
    @kssaction
    def confirm_registrant
        confirm = confirm.lower()
        if confirm not in ("confirm", "reject"):
            return

#visual-portal-wrapper {
    width: 62em;
    margin-left: auto;
    margin-right: auto;
}

<body tal:attributes="class string:${here/getSectionFromURL} .">

<body class="section-news">
<body class="section-events">

body.section-news {
    ...
}

body.section-events {
    ...
}

<body tal:attributes="class ... template-${template/id}; ...">

body.template-frontpage_view {
    ...
}

<form class="enableFormTabbing">
    <fieldset id="fieldset-id1">
        <legend id="fieldsetlegend-id1">Tab one</legend>
    </fieldset>
    <fieldset id="fieldset-id2">
        <legend id="fieldsetlegend-id2">Tab two</legend>
    </fieldset>
</form>

<dl class="enableFormTabbing">
    <dt id="fieldsetlegend-id1">tab one</dt>
    <dd id="fieldset-id1">content one</dd>
    <dt id="fieldsetlegend-id2">tab two</dt>
    <dd id="fieldset-id2">content two</dd>
</dl>

<table class="listing" id="my-table">
    <thead>
        <tr>
            <th>First Name</th>
            <th>Last name</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>
                Veit
            </td>
            <td>
                Schiele
            </td>
        </tr>
        <tr>
            <td>
                Sönke
            </td>
            <td>
                Löffler
            </td>
        </tr>
    </tbody>
</table>

<?xml version="1.0"?>
<object name="portal_javascripts" meta_type="JavaScripts Registry">
...
<javascript
    cacheable="True"
    compression="safe"
    cookable="True"
    enabled="True"
    expression=""
    id="table_sorter.js"
    inline="False"/>
</object>

<dl class="collapsible">
    <dt class="collapsibleHeader">
        Title
    </dt>
    <dd class="collapsibleContent">
        Content
    </dd>
</dl>

.expandedBlockCollapsible .collapsibleContent {
    display: block;
}

.collapsedBlockCollapsible .collapsibleContent {
    display: none;
}

jQuery("#content a[ @href $= '.pdf']").attr('target', '_blank');

$ cd src
$ ../bin/zopeskel archetype vs.registration

[buildout]
...
develop
    src/vs.policy
    src/vs.theme
    src/vs.registration
...
eggs =
    elementtree
    vs.policy
    vs.theme
    vs.registration
...

$ ./bin/buildout -o

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:five="http://namespaces.zope.org/five"
    xmlns:genericsetup="http://namespaces.zope.org/genericsetup"
    i18n_domain="vs.policy">

    <include package="vs.registration" />
    ...
</configure>

from zope.interface import Interface
from zope import schema

from zope.app.container.constraints import contains

class IRegistration(Interface):
    """A folder containing registrants
    """
    contains('vs.registration.interfaces.IRegistrants',)

    text = schema.SourceText(title=_(u"Descriptive text"),
                             description=_(u"Descriptive text about this registration"),
                             required=True)

class IRegistrant(Interface):
    """A registrant
    """

    name = schema.TextLine(title=_(u"Registrant name"),
                           required=True)

    address = schema.Text(title=_(u"Address"),
                          description=_(u""),
                          required=True)

    email = schema.TextLine(title=_(u"Email"),
                            description=_(u""),
                            required=True)

from zope.i18nmessageid import MessageFactory
RegistrationMessageFactory = MessageFactory('vs.registration')

from vs.registration import RegistrationMessageFactory as _

class Registrant(base.ATCTContent):
    implements(IRegistrant)

    portal_type = "Registrant"
    _at_rename_after_creation = True
    schema = RegistrantSchema

RegistrantSchema = schemata.ATContentTypeSchema.copy() + atapi.Schema((

    atapi.StringField('email',
        required=True,
        searchable=True,
        storage=atapi.AnnotationStorage(),
        widget=atapi.StringWidget(label=_(u"Email"),
                                  description=_(u""))
        ),

    ))

RegistrantSchema['title'].storage = atapi.AnnotationStorage()
RegistrantSchema['title'].widget.label = _(u"Registrant name")
RegistrantSchema['title'].widget.description = _(u"")

RegistrantSchema['description'].storage = atapi.AnnotationStorage()
RegistrantSchema['description'].widget.label = _(u"Address")
RegistrantSchema['description'].widget.description = _("")

RegistrantSchema['email'].storage = atapi.AnnotationStorage()
RegistrantSchema['email'].widget.label = _(u"Email")
RegistrantSchema['email'].widget.description = _(u"")

finalizeATCTSchema(RegistrantSchema, folderish=False, moveDiscussion=False)

class Registrant(base.ATCTContent):
    """Describe a registrant.
    """
    implements(IRegistrant)

    portal_type = "Registrant"
    _at_rename_after_creation = True
    schema = RegistrantSchema

    name = atapi.ATFieldProperty('title')
    address = atapi.ATFieldProperty('description')
    email = atapi.ATFieldProperty('email')

atapi.registerType(Registrant, PROJECTNAME)

...
from zope.i18nmessageid import MessageFactory
import config
...

ARTICLE_USABLE=DisplayList((
   ('yes', _(u'Yes')),
   ('no', _(u'No')),
   ('some', _(u'somewhat usable')),
   ))

...
TypeSchema = schemata.ATContentTypeSchema.copy() + atapi.Schema((
   atapi.StringField('usable',
       vocabulary=config.ARTICLE_USABLE,
       default='yes',
       widget=atapi.SelectionWidget(label=_(u"usable"),
                                 description=(u"is the article usable?"))
       ),

LinesField('customViewFields',
            required=False,
            mode="rw",
            default=('Title',),
            vocabulary='listMetaDataFields',
            enforceVocabulary=True,
            write_permission = ChangeTopics,
            widget=InAndOutWidget(
                    label=_(u'label_custom_view_fields', default=u'Table Columns'),
                    description=_(u'help_custom_view_fields',
                                  default=u"Select which fields to display when "
                                           "'Display as Table' is checked.")
                    ),
             ),
...
security.declareProtected(View, 'listMetaDataFields')
def listMetaDataFields(self, exclude=True):
    """Return a list of metadata fields from portal_catalog.
    """
    tool = getToolByName(self, TOOLNAME)
    return tool.getMetadataDisplay(exclude)

eggs =
    ...
    Products.AddRemoveWidget

atapi.LinesField('category',
       required=True,
       searchable=True,
       vocabulary='getTagsVocab',
       enforceVocabulary=False,
       accessor="Category"
       widget=atapi.AddRemoveWidget(label=_(u"tags"),
                               description=_(u"")),
       ),

class VsResale(base.ATCTContent):
...
  def getTagsVocab(self):
       """
       Get the available tags as a DisplayList.
       """
       tags = self.getTagsInUse()
       vocab = atapi.DisplayList()
       for t in tags:
           vocab.add(t, t)
       return vocab

  def getTagsInUse(self):
       """
       Get a list of the resale tags in use in this contenttype.
       """
       catalog = getToolByName(self, 'portal_catalog')
       issues = catalog.searchResults(portal_type = 'Resale Goods Type',)
       tags = {}
       result = set()
       for i in issues:
           issue = i.getObject()
           result.update(issue.Category())
       return sorted(result)

atapi.TextField('text',
    ....
    validators=("isTidyHtmlWithCleanup",),
    ....
    ),

validatorList.append(TidyHtmlWithCleanupValidator('isTidyHtmlWithCleanup', title='', description=''))

def validate_text (self, value):
    if "maybe" in value:
        return _(u"You shouldn’t be so vague.")
    return None

atapi.registerType(Registrant, PROJECTNAME)

BooleanField(
    'allowDiscussion',
    accessor="isDiscussable",
    mutator="allowDiscussion",
    edit_accessor="editIsDiscussable",
    ...
),

<browser:resource
   name="registration_icon.gif"
   image="registration_icon.gif"
   />

<img tal:attributes="src context/++resource++registration_icon.gif" />

<browser:resource
   name="registration.css"
   file="registration.css"
   />

<metal:css fill-slot="css_slot">
    <style type="text/css" media="all"
           tal:content="string: @import url(${context/++resource++registration.css});"></style>
</metal:css>

<browser:page
    for="..interfaces.IRegistration"
    name="view"
    class=".registration.RegistrationView"
    permission="zope2.View"
    />

<include package="plone.app.contentmenu" />
...
<browser:menuItem
    for="..interfaces.IRegistration"
    menu="plone_displayviews"
    title="Registration view"
    action="@@view"
    description="Default view of a registration"
    />

from Products.Five import BrowserView

class RegistrationView(BrowserView):
   """A view of a Registration object"""
   def name(self):
       return self.context.Title()

   def details(self):
       return self.context.Description()

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
      xmlns:tal="http://xml.zope.org/namespaces/tal"
      xmlns:metal="http://xml.zope.org/namespaces/metal"
      xmlns:i18n="http://xml.zope.org/namespaces/i18n"
      lang="en"
      metal:use-macro="context/main_template/macros/master"
      i18n:domain="vs.registration">
<body>

<metal:main fill-slot="main">
    <tal:main-macro metal:define-macro="main"
           tal:define="text context/text;">

        <div tal:replace="structure provider:plone.abovecontenttitle" />

        <h1 class="documentFirstHeading">
            <span metal:use-macro="python:context.widget('title', mode='view')" />
        </h1>

        <div tal:replace="structure provider:plone.belowcontenttitle" />

        <div class="documentDescription">
            <span metal:use-macro="python:context.widget('description', mode='view')" />
        </div>

        <div tal:replace="structure provider:plone.abovecontentbody" />

        <p tal:condition="python: not text and is_editable"
           i18n:translate="no_body_text"
           class="discreet">
            This item does not have any body text, click the edit tab to change it.
        </p>

        <div tal:condition="text" metal:use-macro="python:context.widget('text', mode='view')" />

        <form action="createObject">
            <input name="type_name"
                   type="hidden"
                   value="Registrant"
                   />
            <input class="standalone"
                   value="Registration"
                   type="submit"
                   i18n:attributes="value"
                   />
        </form>

        <tal:registrants condition="view/have_registrants">
            <h2 i18n:translate="title_registration_contents">Registrants</h2>
            <dl>
                <tal:block repeat="registrant view/registrants">
                    <dt>
                        <a tal:attributes="href registrant/url"
                           tal:content="registrant/title" />
                    </dt>
                    <dd tal:content="registrant/address" />
                </tal:block>
            </dl>
        </tal:registrants>

        <div metal:use-macro="context/document_relateditems/macros/relatedItems">
            show related items if they exist
        </div>

        <div tal:replace="structure provider:plone.belowcontentbody" />

    </tal:main-macro>
</metal:main>

</body>
</html>

<div tal:replace="structure provider:plone.abovecontenttitle" />

from zope.interface import implements
from Products.Five.browser import BrowserView
from plone.app.layout.globals.interfaces import IViewView

class MyView(BrowserView):
   implements(IViewView)

<span metal:use-macro="python:context.widget('title', mode='view')" />

<span tal:content="context/title" />

<object name="portal_types" meta_type="Plone Types Tool">
    <object name="Registration"
            meta_type="Factory-based Type Information with dynamic views"/>
    <object name="Registrant"
            meta_type="Factory-based Type Information with dynamic views"/>
</object>

<?xml version="1.0"?>
<object name="Registration"
        meta_type="Factory-based Type Information with dynamic views"
        i18n:domain="vs.registration"
        xmlns:i18n="http://xml.zope.org/namespaces/i18n">
    <property name="title"
              i18n:translate="">Registration</property>
    <property name="description"
              i18n:translate="">A folder which can contain registrants.</property>
    <property name="content_icon">++resource++registration_icon.gif</property>

<property name="content_meta_type">Registration</property>
<property name="product">vs.registration</property>
<property name="factory">addRegistration</property>
<property name="immediate_view">atct_edit</property>

<property name="global_allow">True</property>
<property name="filter_content_types">True</property>
<property name="allowed_content_types">
    <element value="Registrant" />
</property>

<property name="allow_discussion">False</property>

<property name="default_view">view</property>
<property name="view_methods">
    <element value="view"/>
    <element value="folder_summary_view"/>
    <element value="folder_tabular_view"/>
    <element value="folder_listing"/>
</property>

<alias from="(Default)" to="(dynamic view)"/>
<alias from="edit" to="atct_edit"/>
<alias from="sharing" to="@@sharing"/>
<alias from="view" to="(selected layout)"/>

<action title="View"
        action_id="view"
        category="object"
        condition_expr=""
        url_expr="string:${object_url}/"
        visible="True">
    <permission value="View"/>
</action>
<action title="Edit"
        action_id="edit"
        category="object"
        condition_expr=""
        url_expr="string:${object_url}/edit"
        visible="True">
    <permission value="Modify portal content"/>
</action>

from vs.registration import config
from Products.Archetypes import atapi
from Products.CMFCore import utils

def initialize(context):

from content import registration, registrant

content_types, constructors, ftis = atapi.process_types(
    atapi.listTypes(config.PROJECTNAME),
    config.PROJECTNAME)

for atype, constructor in zip(content_types, constructors):
    utils.ContentInit("%s: %s" % (config.PROJECTNAME, atype.portal_type),
        content_types      = (atype,),
        permission         = config.ADD_PERMISSIONS[atype.portal_type],
        extra_constructors = (constructor,),
        ).initialize(context)

ADD_PERMISSIONS = {
    "Registration" : "vs: Add Registration",
    "Registrant"   : "vs: Add Registrant",
}

<rolemap>
    <permissions>
        <permission name="vs: Add Registration" acquire="False">
            <role name="Manager" />
        </permission>
        <permission name="vs: Add Registrant" acquire="False">
            <role name="Manager" />
            <role name="Owner" />
            <role name="Contributor" />
        </permission>
    </permissions>
</rolemap>

<object name="portal_factory"
        meta_type="Plone Factory Tool">
    <factorytypes>
        <type portal_type="Registration"/>
        <type portal_type="Registrant"/>
    </factorytypes>
</object>

from StringIO import StringIO
from logging import getLogger

from Products.CMFCore.utils import getToolByName
from Products.Archetypes import atapi

from config import PROJECTNAME

class Generator:

    def setupEditions(self, p, out):

        content_types, constructors, ftis = atapi.process_types(
            atapi.listTypes(PROJECTNAME),
            PROJECTNAME)
        portal_repository = getToolByName(p, 'portal_repository')
        types = portal_repository.getVersionableContentTypes()

        for type in content_types:
            if type.portal_type not in types:
                types.append("%s" %type.portal_type)

        portal_repository.setVersionableContentTypes(types)
        print >> out, " Editions enabled %s \n" % types

def setupVarious(context):

    if context.readDataFile('vs.registration_various.txt') is None:
        return
    # Add additional setup code here
    out = StringIO()
    site = context.getSite()
    gen = Generator()
    gen.setupEditions(site, out)
    logger = context.getLogger(PROJECTNAME)
    logger.info(out.getvalue())

<?xml version="1.0"?>
<import-steps>
    <import-step id="idg.org.various"
                 version="20080617-01"
                 handler="vs.registration.setuphandlers.setupVarious"
                 title="vs.registration: miscellaneous import steps">
        <dependency step="typeinfo" />
            Various import steps that are not handled by GS import/export
            handlers.
    </import-step>
</import-steps>

<include package="vs.registration" />

PRODUCT_DEPENDENCIES = ('vs.theme',
                        'vs.registration')

<dependency>profile-vs.registration:default</dependency>

[buildout]
...
parts =
    ...
    atct_conf
...
[atct_conf]
recipe = plone.recipe.command
target = ${instance:location}/etc/atcontenttypes.conf
command = ln -s ${buildout:directory}/etc/atcontenttypes.conf ${:target}

paster create -t archetype vs.registration

$ cd vs.registration
$ paster addcontent --list
Available templates:
   atschema:     A handy AT schema builder
   contenttype:  A content type skeleton
   form:         A form skeleton
   formfield:    Schema field for a form
   i18nlocale:   An i18n locale directory structure
   portlet:      A Plone 3 portlet
   view:         A browser view skeleton
   zcmlmeta:     A ZCML meta directive skeleton

$ paster addcontent -a
  N anonymous_user_factory_plugin:  A Plone PAS AnonymousUserFactory Plugin
    atschema:                       A handy AT schema builder
  N authentication_plugin:          A Plone PAS Authentication Plugin
  N challenge_plugin:               A Plone PAS Challenge Plugin
    contenttype:                    A content type skeleton
  N credentials_reset_plugin:       A Plone PAS CredentialsReset Plugin
  N extraction_plugin:              A Plone PAS Extraction Plugin
    form:                           A form skeleton
    formfield:                      Schema field for a form
  N group_enumeration_plugin:       A Plone PAS GroupEnumeration Plugin
  N groups_plugin:                  A Plone PAS Groups Plugin
    i18nlocale:                     An i18n locale directory structure
    portlet:                        A Plone 3 portlet
  N properties_plugin:              A Plone PAS Properties Plugin
  N role_assigner_plugin:           A Plone PAS RoleAssigner Plugin
  N role_enumeration_plugin:        A Plone PAS RoleEnumeration Plugin
  N roles_plugin:                   A Plone PAS Roles Plugin
  N update_plugin:                  A Plone PAS Update Plugin
  N user_adder_plugin:              A Plone PAS UserAdder Plugin
  N user_enumeration_plugin:        A Plone PAS UserEnumeration Plugin
  N user_factory_plugin:            A Plone PAS UserFactory Plugin
  N validation_plugin:              A Plone PAS Validation Plugin
    view:                           A browser view skeleton
    zcmlmeta:                       A ZCML meta directive skeleton

<configure
    ...
    i18n_domain="vs.registration">

   <genericsetup:registerProfile
       name="default"
       title="Registration Content-types"
       directory="profiles/default"
       description="Short description of registration content-types"
       provides="Products.GenericSetup.interfaces.EXTENSION"
       />

$ cd vs.registration
$ paster addcontent contenttype
Enter contenttype_name (Content type name ) ['Example Type']: Registration
Enter contenttype_description (Content type description ) ['Description of the Example Type']: Container for registrants
Enter folderish (True/False: Content type is Folderish ) [False]: True
Enter global_allow (True/False: Globally addable ) [True]:
Enter allow_discussion (True/False: Allow discussion ) [False]:
 Inserting from README.txt_insert into /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/README.txt
 Inserting from config.py_insert into /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/config.py
 Recursing into content
   Copying +content_class_filename+.py_tmpl to /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/content/registration.py
   Inserting from configure.zcml_insert into /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/content/configure.zcml
 Recursing into interfaces
   Copying +content_class_filename+.py_tmpl to /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/interfaces/registration.py
   Inserting from __init__.py_insert into /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/interfaces/__init__.py
 Recursing into profiles
   Recursing into default
     Inserting from factorytool.xml_insert into /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/profiles/default/factorytool.xml
     Copying rolemap.xml_insert to /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/profiles/default/rolemap.xml
     Recursing into types
       Creating /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/profiles/default/types/
       Copying +types_xml_filename+.xml_tmpl to /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/profiles/default/types/Registration.xml
     Inserting from types.xml_insert into /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/profiles/default/types.xml

$ cd vs.registration
$ paster addcontent i18nlocale
Enter language_code (The iso-code of the language) ['']: de
 Inserting from configure.zcml_insert into /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/configure.zcml
 Recursing into locales
   Creating /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/locales/
   Recursing into +language_iso_code+
     Creating /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/locales/de/
     Recursing into LC_MESSAGES
       Creating /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/locales/de/LC_MESSAGES/
       Copying README.txt to /home/veit/Projects/IDG/idg_buildout/src/vs.registration/vs/registration/locales/de/LC_MESSAGES/README.txt

<object name="portal_types" meta_type="Plone Types Tool">
  <object name="Registration"
          meta_type="Factory-based Type Information with dynamic views"/>
  <object name="Registrant"
          meta_type="Factory-based Type Information with dynamic views"/>
</object>

 <factorytypes>
  ...
      <type portal_type="Registration"/>
      <type portal_type="Registrant"/>
</factorytypes>

RegistrationSchema = folder.ATFolderSchema.copy() + atapi.Schema((

  atapi.TextField('text',
      required=True,
      searchable=True,
      storage=atapi.AnnotationStorage(),
      validators=('isTidyHtmlWithCleanup',),
      default_output_type='text/x-html-safe',
      widget=atapi.RichWidget(label=_(u"Body Text"),
                              description=_(u"Text for front page of registration"),
                              rows=25,
                              allow_file_upload=False),
      ),
  ))

RegistrationSchema['title'].storage = atapi.AnnotationStorage()
RegistrationSchema['description'].storage = atapi.AnnotationStorage()
RegistrationSchema['text'].storage = atapi.AnnotationStorage()

schemata.finalizeATCTSchema(
  RegistrationSchema,
  folderish=True,
  moveDiscussion=False
)
...
title = atapi.ATFieldProperty('title')
description = atapi.ATFieldProperty('description')
text = atapi.ATFieldProperty('text')

RegistrantSchema = schemata.ATContentTypeSchema.copy() + atapi.Schema((

    atapi.StringField('email',
        required=True,
        searchable=True,
        storage=atapi.AnnotationStorage(),
        widget=atapi.StringWidget(label=_(u"Email"),
                                  description=_(u""))
        ),

    ))

RegistrantSchema['title'].storage = atapi.AnnotationStorage()
RegistrantSchema['title'].widget.label = _(u"Registrant name")
RegistrantSchema['title'].widget.description = _(u"")

RegistrantSchema['description'].storage = atapi.AnnotationStorage()
RegistrantSchema['description'].widget.label = _(u"Address")
RegistrantSchema['description'].widget.description = _("")

RegistrantSchema['email'].storage = atapi.AnnotationStorage()
RegistrantSchema['email'].widget.label = _(u"Email")
RegistrantSchema['email'].widget.description = _(u"")

schemata.finalizeATCTSchema(RegistrantSchema, moveDiscussion=False)

class Registrant(base.ATCTContent):
    """Describe a registrant.
    """
    implements(IRegistrant)

    meta_type = "Registrant"
    _at_rename_after_creation = True
    schema = RegistrantSchema

    name = atapi.ATFieldProperty('title')
    address = atapi.ATFieldProperty('description')
    email = atapi.ATFieldProperty('email')

atapi.registerType(Registrant, PROJECTNAME)

$ paster addcontent portlet
Enter portlet_name (Portlet name (human readable)) ['Example portlet']: My portlet
Enter portlet_type_name (Portlet type name (should not contain spaces)) ['ExamplePortlet']: registrants
Enter description (Portlet description) ['']: My portlet
  Recursing into portlets
    Copying +portlet_filename+.pt_tmpl to /home/veit/vs.mytype/vs/mytype/portlets/registrants.pt
    Copying +portlet_filename+.py_tmpl to /home/veit/vs.mytype/vs/mytype/portlets/registrants.py
File '__init__.py' already exists: skipped
    Inserting from configure.zcml_insert into /home/veit/vs.mytype/vs/mytype/portlets/configure.zcml
  Recursing into profiles
    Recursing into default
      Inserting from portlets.xml_insert into /home/veit/vs.mytype/vs/mytype/profiles/default/portlets.xml
  Recursing into tests
File '__init__.py' already exists: skipped
    Copying base_+portlet_filename+.py_tmpl to /home/veit/vs.mytype/vs/mytype/tests/base_registrants.py
    Copying test_+portlet_filename+.py_tmpl to /home/veit/vs.mytype/vs/mytype/tests/test_registrants.py

<browser:resource
   name="registration_icon.gif"
   image="registration_icon.gif"
   />

paster addcontent view

<object name="Registration"
  ...
  <property name="filter_content_types">True</property>
  <property name="allowed_content_types">
      <element value="Registrant" />
  </property>

<?xml version="1.0"?>
<rolemap>
   <permissions>
       <permission name="vs.registration: Add Registration" acquire="False">
           <role name="Manager" />
       </permission>
       <permission name="vs.registration: Add Registrant" acquire="False">
           <role name="Manager" />
           <role name="Owner" />
           <role name="Contributor" />
       </permission>
   </permissions>
</rolemap>

<configure
      ...
      i18n_domain="vs.registration">

      <class class=".registration.Registration">
      <require
          permission="zope2.View"
          interface="..interfaces.IRegistration"
          />
  </class>

  <class class=".registrant.Registrant">
      <require
          permission="zope2.View"
          interface="..interfaces.IRegistrant"
          />
  </class>
...
</configure>

<action title="View"
          action_id="view"
          category="object"
          condition_expr=""
          url_expr="string:${folder_url}/"
          visible="True">
      <permission value="View"/>
  </action>
  <action title="Edit"
          action_id="edit"
          category="object"
          condition_expr=""
          url_expr="string:${object_url}/edit"
          visible="True">
      <permission value="Modify portal content"/>
  </action>

|-- README.txt
|-- __init__.py
|-- config.py
|-- configure.zcml
|-- browser
|   |-- __init__.py
|   |-- configure.zcml
|   |-- registrant_icon.gif
|   |-- registrantview.pt
|   |-- registrantview.py
|   |-- registration_icon.gif
|   |-- registrationview.pt
|   |-- registrationview.py
|-- content
|   |-- __init__.py
|   |-- configure.zcml
|   |-- registrant.py
|   |-- registration.py
|-- interfaces
|   |-- __init__.py
|   |-- registrant.py
|   |-- registration.py
|-- locales
|   `-- de
|       `-- LC_MESSAGES
|-- portlets
|   |-- __init__.py
|   `-- configure.zcml
|-- profiles
|     `-- default
|         |-- factorytool.xml
|         |-- metadata.xml
|         |-- portlets.xml
|         |-- rolemap.xml
|         |-- types
|         |-- types.xml
|         |-- workflows
|         `-- workflows.xml
`-- tests
    |-- __init__.py
    |-- base.py
    `-- test_doctest.py

- ``/__init__.py``: Das Initialisierungsmodul.
- ``/configure.zcml``: beschreibt Konfigurationsangaben, meldet das Produkt am Generic Setup-Tool an und enthält weitere Verweise auf Sub-packages (=Unterordner), die ihrerseits Konfigurationsangaben enthalten. Hier werden auch die Übersetzungen des i18n-Layers registriert.
- ``/config.py``: Fügt den Content-Typen die Berechtigungen für das Hinzufügen von Registrierungen und Teilnehmern zu hinzu. Die Berechtigungen werden durch ``__init__.py`` aufgerufen.
- ``/browser/``: kann zusätzliche Templates für die Gestaltung enthalten.
- ``/browser/configure.zcml`` registriert die Komponenten und legt fest, welche Pagetemplates für welchen Content-Typ verwendet werden, und definiert die angepassten Icons.
- ``/browser/registrantview.py``, ``browser/registrationview.py`` weisen dem View spezifische Templates zu. Die Angaben werden durch FTI (factory type information) in ``profiles/default/types/*.xml`` aufgerufen.
- ``browser/registrantview.pt``, ``browser/registrationview.pt`` sind Page-Templates in TAL/METAL.
- ``content``: enthält die Implementierungen der Content-types.
- ``content/configure.zcml`` legt die Berechtigungen für die Content-types fest, die mindestens erfüllt sein müssen.
- ``content/registrant.py``, ``content/registration.py`` enthalten die eigentliche Definition der Datenstrukturen, und melden die Content-typen bei Archetypes an
- ``interfaces/``: Ordner enthält Beschreibungen der Interfaces für unsere definierten Klassen, ``IRegistrant``und ``IRegistration``.
- ``interfaces/__init__.py`` importiert die Interface-Definitionen aus den Content-Types. Datei wird vom Template ``contenttype`` angelegt.
- ``interfaces/registrant.py``, ``interfaces/registration.py`` legt Pflichtfelder und die Benennungen der Felder fest. In ``registration.py`` contains('vs.registration.interfaces.IRegistrant',)
- ``locales/de/LC_MESSAGES/`` kann einmal die sprachspezifischen Übersetzungsdateien enthalten, in der Form ``vsregistration-de.po``. Genauere Informationen erhält man in `i18n-locales und Plone 3.0`_
- ``profiles/default``: die Dateien definieren das Extension Profile gegenüber Generic Setup; dieser Pfad wird in ``/configure.zcml`` festgelegt.
- ``profiles/default/factorytool.xml`` macht die Content-typen dem Factory-Tool bekannt. Datei wird vom Template ``contenttype`` angelegt.
- ``profiles/default/metadata.xml`` enthält eine Versionsnummer. Datei wird vom Template ``contenttype`` angelegt/modifiziert.
- ``profiles/default/portlets.xml`` sofern Portlets mit ``paster addcontent portlet`` erzeugt wurden.
- ``profiles/default/rolemap.xml`` Datei wird vom Template ``contenttype`` angelegt.
- ``profiles/default/types.xml`` Datei wird vom Template ``contenttype`` angelegt.
- ``profiles/default/workflows.xml`` Datei wird vom Template ``contenttype`` angelegt.
- ``profiles/default/types``
- ``profiles/default/types``
- ``tests/``: Unit-Tests für das Produkt.

<?xml version="1.0"?>
<object name="portal_catalog" meta_type="Plone Catalog Tool">
     <index name="myfield" meta_type="FieldIndex">
         <indexed_attr value="myfield"/>
    </index>
    <column value="myfield"/>
</object>

<?xml version="1.0"?>
<atcttool>
    <topic_indexes>
        <index name="myfield"
               description="myfield's description"
               enabled="True"
               friendlyName="mytype's myfield">
            <criteria>ATSimpleStringCriterion</criteria>
        </index>
    </topic_indexes>
    <topic_metadata>
        <metadata  name="myfield"
                   description="myfield's description"
                   enabled="True"
                   friendlyName="mytype's myfield"/>
    </topic_metadata>
</atcttool>

from zope.interface import Interface
from Products.ATContentTypes.interface.image import IImageContent
...

class IRegistration(Interface, IImageContent):
    ...

RegistrationSchema = folder.ATFolderSchema.copy() + atapi.Schema((
    ...
    atapi.ImageField('image',
               primary=True,
               languageIndependent=True,
               storage = AnnotationStorage(migrate=True),
               swallowResizeExceptions = zconf.swallowImageResizeExceptions.enable,
               pil_quality = zconf.pil_config.quality,
               pil_resize_algo = zconf.pil_config.resize_algo,
               max_size = zconf.ATImage.max_image_dimension,
               sizes= {'large'   : (768, 768),
                       'preview' : (400, 400),
                       'mini'    : (200, 200),
                       'thumb'   : (128, 128),
                       'tile'    :  (64, 64),
                       'icon'    :  (32, 32),
                       'listing' :  (16, 16),
                      },
               validators = (('checkImageMaxSize', V_REQUIRED)),
               widget = ImageWidget(
                        description = 'Image for this registration',
                        label= _(u'label_image', default=u'Image'),
                        show_content_type = False,)),

    ), marshall=PrimaryFieldMarshaller()
    )
...
RegistrationSchema['image'].storage = atapi.AnnotationStorage()

class Registration(folder.ATFolder):
    """Contains multiple registrants
    """
    implements(IRegistration)
    ...

from zope.interface import implements
...
from zope.publisher.interfaces import IPublishTraverse
from ZPublisher.BaseRequest import DefaultPublishTraverse

...

@adapter(IRegistration)
class ImageTraverser(DefaultPublishTraverse):

    implements(IPublishTraverse)

    def __init__(self, context, request):
        self.context = context
        self.request = request

    def publishTraverse(self, request, name):
        if name.startswith('image'):
            field = self.context.getField('image')
            image = None
            if name == 'image':
                image = field.getScale(self.context)
            else:
                scalename = name[len('image_'):]
                if scalename in field.getAvailableSizes(self.context):
                    image = field.getScale(self.context, scale=scalename)
            if image is not None and not isinstance(image, basestring):
                # image might be None or '' for empty images
                return image
        else:
            return super(ImageTraverser, self).publishTraverse(request, name)

<adapter
 for="Products.ATContentTypes.interface.image.IImageContent zope.publisher.interfaces.http.IHTTPRequest"
 factory=".registration.ImageTraverser"
 provides="zope.publisher.interfaces.IPublishTraverse" />

<browser:page
    for="Products.ATContentTypes.interface.image.IImageContent"
    class=".imagesupport.ImageView"
    permission="zope2.View"
    name="img_view"
    allowed_interface="..interfaces.IRegistration"
/>

<browser:page
    for="Products.ATContentTypes.interface.image.IImageContent"
    name="fullscreen"
    class=".views.FullscreenView"
    permission="zope2.View"
/>
<browser:page
    for="..interfaces.IRegistration"
    name="view"
    class=".registration.RegistrationView"
    permission="zope2.View"
/>

from zope.interface import implements
from Products.CMFCore.utils import getToolByName
from Products.Five.browser import BrowserView
import urllib

class ImageView(BrowserView):

    def __init__(self, context, request):
        self.context = context
        self.request = request

    def tag(self, **kwargs):
        """ tag """
        return self.context.getField('image').tag(self.context , **kwargs)

    def getImageSize(self, scale=None):
        """ image size """
        field = self.context.getField('image')
        return field.getSize(self.context,scale=scale)

    def hasImage(self):
        """ image size
        """
        field = self.context.getField('image')
        return field.get_size(self.context)

...

class FullscreenView(BrowserView):
    """
    """
    __call__ = ViewPageTemplateFile('fullscreen_view.pt')

...
<div class="visualWrapper"
   tal:define="img_view context/@@img_view">
    <a href=""
       tal:attributes="href request/HTTP_REFERER"
       tal:condition="request/HTTP_REFERER">
        <span i18n:translate="label_back_to_site">
            Back to site
        </span>
        <br />
        <tal:block replace="structure img_view/tag" />
    </a>
    <a href=""
       tal:attributes="href here/portal_url"
       tal:condition="not: request/HTTP_REFERER">
        <span i18n:translate="label_home">
            Home
        </span>
        <br />
        <tal:block replace="structure img_view/tag"  />
    </a>
</div>

...
<div metal:fill-slot="main">
       <tal:main-macro
           metal:define-macro="main"
           tal:define="img_view context/@@img_view;
...
<span tal:condition="img_view/hasImage" tal:omit-tag="">
    <a href=""
        class="discreet"
        tal:attributes="href string:$here_url/fullscreen">
        <tal:block replace="structure python: img_view.tag(scale='preview')" />
        <br />
        <span class="visualNoPrint">
            <img src="" alt="" tal:replace="structure here/search_icon.gif" />
            <span i18n:translate="label_click_to_view_full_image" i18n:domain="plone">
                Click to view full-size image&hellip;
            </span>
        </span>
    </a>
</span>

$ ../bin/zopeskel dexterity vs.registration

vs.registration
├── CHANGES.txt
├── CONTRIBUTORS.txt
├── DEXTERITY_README.rst
├── README.txt
├── bootstrap.py
├── buildout.cfg
├── docs
│   ├── LICENSE.GPL
│   └── LICENSE.txt
├── setup.cfg
├── setup.py
└── src
    └── vs
        ├── __init__.py
        └── registration
                ├── INTEGRATION.txt
            ├── __init__.py
            ├── configure.zcml
            ├── locales
            │   └── README.txt
            ├── profiles
            │   └── default
            │       ├── metadata.xml
            │       └── types.xml
            ├── static
            │   └── README.txt
            ├── testing.py
            └── tests
                ├── __init__.py
                ├── robot_test.txt
                ├── test_example.py
                └── test_robot.py

install_requires=[
    'setuptools',
    'plone.app.dexterity',
    'plone.namedfile [blobs]',

install_requires=[
    ...
    'collective.autopermission',
    'plone.app.referenceablebehavior',
    'plone.app.relationfield',
],

<configure
    ...
    xmlns:grok="http://namespaces.zope.org/grok">
    <includeDependencies package="." />
    <grok:grok package="." />
    ...
</configure>

[buildout]
extensions =
    mr.developer
    ...
extends =
    ...
    http://good-py.appspot.com/release/dexterity/1.0rc1?plone=4.1
    versions.cfg
...
[test]
recipe = zc.recipe.testrunner
eggs =
    vs.registration
defaults = ['--exit-with-status', '--auto-color', '--auto-progress']

[sources]
...
vs.registration = svn https://dev.plone.org/svn/pen/vs.registrtion/trunk

install_requires=[
    'setuptools',
    'Plone',
    'vs.event',
    'vs.theme',
    'vs.registration',
],

<dependencies>
    <dependency>profile-vs.event:default</dependency>
    <dependency>profile-vs.theme:default</dependency>
    <dependency>profile-vs.registration:default</dependency>
</dependencies>

from five import grok
from zope import schema

from plone.directives import form, dexterity

from plone.app.textfield import RichText
from plone.namedfile.field import NamedImage

from vs.registration import _

class IAttendee(form.Schema):
    """An attendee for the event.
    """

    title = schema.TextLine(
            title=_(u"Name"),
        )

    description = schema.Text(
            title=_(u"A short summary"),
        )

from zope.i18nmessageid import MessageFactory
_ = MessageFactory("vs.registration")

from five import grok
from zope import schema

from plone.directives import form, dexterity
from plone.app.textfield import RichText

from vs.registration import _

class IRegistration(form.Schema):
    """A registration container for attendees.
    """

    title = schema.TextLine(
            title=_(u"Event name"),
        )

    description = schema.Text(
            title=_(u"Event summary"),
        )

    start = schema.Datetime(
            title=_(u"Start date"),
            required=False,
        )

    end = schema.Datetime(
            title=_(u"End date"),
            required=False,
        )

    details = RichText(
            title=_(u"Details"),
            description=_(u"Details about the event"),
            required=False,
        )

<?xml version="1.0"?>
<object name="portal_types">
 <object name="vs.registration.registration" meta_type="Dexterity FTI" />
 <object name="vs.registration.attendee" meta_type="Dexterity FTI" />
</object>

<?xml version="1.0"?>
<object name="vs.registrtion.attendee" meta_type="Dexterity FTI"
   i18n:domain="vs.registration" xmlns:i18n="http://xml.zope.org/namespaces/i18n">

 <!-- Basic metadata -->
 <property name="title" i18n:translate="">Attendee</property>
 <property name="description" i18n:translate="">An attendee</property>
 <property name="content_icon">user.gif</property>
 <property name="allow_discussion">True</property>
 <property name="global_allow">False</property>
 <property name="filter_content_types">False</property>
 <property name="allowed_content_types" />

 <!-- schema interface -->
 <property name="schema">vs.registration.attendee.IAttendee</property>

 <!-- class used for content items -->
 <property name="klass">plone.dexterity.content.Item</property>

 <!-- add permission -->
 <property name="add_permission">cmf.AddPortalContent</property>

 <!-- enabled behaviors -->
 <property name="behaviors">
     <element value="plone.app.content.interfaces.INameFromTitle" />
</property>

 <!-- View information -->
 <property name="default_view">view</property>
 <property name="default_view_fallback">False</property>
 <property name="view_methods">
  <element value="view"/>
 </property>

 <!-- Method aliases -->
 <alias from="(Default)" to="(dynamic view)"/>
 <alias from="edit" to="@@edit"/>
 <alias from="sharing" to="@@sharing"/>
 <alias from="view" to="(selected layout)"/>

 <!-- Actions -->
 <action title="View" action_id="view" category="object" condition_expr=""
    url_expr="string:${object_url}" visible="True">
  <permission value="View"/>
 </action>
 <action title="Edit" action_id="edit" category="object" condition_expr=""
    url_expr="string:${object_url}/edit" visible="True">
  <permission value="Modify portal content"/>
 </action>
</object>

<?xml version="1.0"?>
<object name="vs.registration.registration"  meta_type="Dexterity FTI"
   i18n:domain="vs.registration" xmlns:i18n="http://xml.zope.org/namespaces/i18n">

 <!-- Basic metadata -->
 <property name="title" i18n:translate="">Registration</property>
 <property name="description" i18n:translate="">A folderish content type for attendees</property>
 <property name="content_icon">folder_icon.gif</property>
 <property name="allow_discussion">False</property>
 <property name="global_allow">True</property>
 <property name="filter_content_types">True</property>
 <property name="allowed_content_types">
     <element value="vs.registration.attendee" />
 </property>

 <!-- schema interface -->
 <property name="schema">vs.registration.registration.IRegistration</property>

 <!-- class used for content items -->
 <property name="klass">plone.dexterity.content.Container</property>

 <!-- add permission -->
 <property name="add_permission">cmf.AddPortalContent</property>

 <!-- enabled behaviors -->
 <property name="behaviors">
     <element value="plone.app.content.interfaces.INameFromTitle" />
 </property>

 <!-- View information -->
 <property name="default_view">view</property>
 <property name="default_view_fallback">False</property>
 <property name="view_methods">
  <element value="view"/>
 </property>

 <!-- Method aliases -->
 <alias from="(Default)" to="(dynamic view)"/>
 <alias from="edit" to="@@edit"/>
 <alias from="sharing" to="@@sharing"/>
 <alias from="view" to="(selected layout)"/>

 <!-- Actions -->
 <action title="View" action_id="view" category="object" condition_expr=""
    url_expr="string:${object_url}" visible="True">
  <permission value="View"/>
 </action>
 <action title="Edit" action_id="edit" category="object" condition_expr=""
    url_expr="string:${object_url}/edit" visible="True">
  <permission value="Modify portal content"/>
 </action>
</object>

$ ./bin/instance fg

from Acquisition import aq_inner
from Products.CMFCore.utils import getToolByName

from vs.registration.attendee import IAttendee

class View(grok.View):
    grok.context(IRegistration)
    grok.require('zope2.View')

    def attendees(self):
        """Return a catalog search result of attendees to show
        """

        context = aq_inner(self.context)
        catalog = getToolByName(context, 'portal_catalog')
        return catalog(object_provides=IAttendee.__identifier__,
                       path='/'.join(context.getPhysicalPath()),
                       sort_on='sortable_title')

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
      xmlns:tal="http://xml.zope.org/namespaces/tal"
      xmlns:metal="http://xml.zope.org/namespaces/metal"
      xmlns:i18n="http://xml.zope.org/namespaces/i18n"
      lang="en"
      metal:use-macro="context/main_template/macros/master"
      i18n:domain="vs.registration">
<body>

<metal:main fill-slot="main">
    <tal:main-macro metal:define-macro="main"
        tal:define="toLocalizedTime nocall:context/@@plone/toLocalizedTime">

        <div tal:replace="structure provider:plone.abovecontenttitle" />

        <h1 class="documentFirstHeading" tal:content="context/title" />

        <div class="discreet">
            <tal:block condition="context/start">
                <span i18n:translate="label_from">From:</span>
                <span tal:content="python:context.start.strftime('%x %X')" />
            </tal:block>
            <tal:block condition="context/end">
                <span i18n:translate="label_to">To:</span>
                <span tal:content="python:context.end.strftime('%x %X')" />
            </tal:block>
        </div>

        <div tal:replace="structure provider:plone.belowcontenttitle" />

        <p class="documentDescription" tal:content="context/description" />

        <div tal:replace="structure provider:plone.abovecontentbody" />

        <h2 i18n:translate="heading_attendees">Attendees</h2>
        <dl>
            <tal:block repeat="attendee view/attendees">
                <dt>
                    <a tal:attributes="href attendee/getURL"
                       tal:content="attendee/Title" />
                </dt>
                <dd tal:content="attendee/Description" />
            </tal:block>
        </dl>

        <div tal:replace="structure provider:plone.belowcontentbody" />

    </tal:main-macro>
</metal:main>

</body>
</html>

class View(dexterity.DisplayForm):
    grok.context(ISession)
    grok.require('zope2.View')

<div tal:content="structure context/details/output" />

<div tal:content="structure view/w/details/render" />

import datetime
...
@form.default_value(field=IRegistration['start'])
def startDefaultValue(data):
    # To get hold of the folder, do: context = data.context
    return datetime.datetime.today() + datetime.timedelta(7)

@form.default_value(field=IRegistration['end'])
def endDefaultValue(data):
    # To get hold of the folder, do: context = data.context
    return datetime.datetime.today() + datetime.timedelta(10)

class IMySchema(form.Schema):
    myChoice = schema.Choice(...)

class IMySchema(form.Schema):
    myList = schema.List(
        title=u"My list",
        value_type=schema.Choice(values=['red', 'green', 'blue', 'yellow']))

from zope.schema.vocabulary import SimpleVocabulary, SimpleTerm

organisers = SimpleVocabulary(
    [SimpleTerm(value=u'vsc', title=_(u'Veit Schiele Communications')),
     SimpleTerm(value=u'zopyx', title=_(u'Zopyx Limited'))]
    )

organiser = schema.Choice(
            title=_(u"Organiser"),
            vocabulary=organisers,
            required=False,
        )

from zope.schema.interfaces import IContextSourceBinder
from zope.schema.vocabulary import SimpleVocabulary
from Products.CMFCore.utils import getToolByName

@grok.provider(IContextSourceBinder)
def possibleOrganisers(context):
    acl_users = getToolByName(context, 'acl_users')
    group = acl_users.getGroupById('organisers')
    terms = []

    if group is not None:
        for member_id in group.getMemberIds():
            user = acl_users.getUserById(member_id)
            if user is not None:
                member_name = user.getProperty('fullname') or member_id
                terms.append(SimpleVocabulary.createTerm(member_id, str(member_id), member_name))

   return SimpleVocabulary(terms)

class GroupMembers(object):
    """Context source binder to provide a vocabulary of users in a given
    group.
    """

    grok.implements(IContextSourceBinder)

    def __init__(self, group_name):
        self.group_name = group_name

    def __call__(self, context):
        acl_users = getToolByName(context, 'acl_users')
        group = acl_users.getGroupById(self.group_name)
        terms = []

        if group is not None:
            for member_id in group.getMemberIds():
                user = acl_users.getUserById(member_id)
                if user is not None:
                    member_name = user.getProperty('fullname') or member_id
                    terms.append(SimpleVocabulary.createTerm(member_id, str(member_id), member_name))

        return SimpleVocabulary(terms)

form.widget(organiser=AutocompleteFieldWidget)
organiser = schema.Choice(
        title=_(u"Organiser"),
        vocabulary=u"plone.principalsource.Users",
        required=False,
    )

class Employee(Item):
"""Customised Employee content class"""
    @property
    def title(self):
        if hasattr(self, 'first_names') and hasattr(self, 'surname'):
            return self.first_name + ' ' + self.surname
        else:
            return ''

from plone.app.content.interfaces import INameFromTitle
class INameFromEmployeeTitle(INameFromTitle):
    def title():
        """Return a processed title"""

class NameFromEmployeeTitle(object):
    implements(INameFromEmployeeTitle)

    def __init__(self, context):
        self.context = context

    @property
    def title(self):
        return self.context.first_name + ' ' + self.context.surname

    def setTitle(self, value):
        return

<adapter
    for="vs.registration.employee.ISampleEmployee"
    provides="vs.registration.employee.INameFromEmployeeTitle"
    factory="vs.registration.employee.NameFromEmployeeTitle"
/>

from zope.interface import invariant, Invalid

class StartBeforeEnd(Invalid):
    __doc__ = _(u"The start or end date is invalid")

class IRegistration(form.Schema):
    …
    start = schema.Datetime(
            title=_(u"Start date"),
            required=False,
        )

    end = schema.Datetime(
            title=_(u"End date"),
            required=False,
        )
    …
    @invariant
    def validateStartEnd(data):
        if data.start is not None and data.end is not None:
            if data.start > data.end:
                raise StartBeforeEnd(_(u"The start date must be before the end date."))

class StartBeforeEnd(Invalid):
    __doc__ = _(u"The start or end date is invalid")

<browser:page
    for="..interfaces.IRegistration"
    name="view"
    class=".registration.RegistrationView"
    permission="zope2.View"
    />

<permission
     id="vs.registration.AddRegistrant"
     title="vs.registration: Add registrant"
     />

 <permission
     id="vs.registration.ModifyRegistrant"
     title="vs.registration: Modify registrant"
     />

install_requires=[
    ...
    'collective.autopermission',
],

<?xml version="1.0"?>
<rolemap>
  <permissions>
    <permission name="vs.registration: Add registrant" acquire="True">
      <role name="Owner"/>
      <role name="Manager"/>
      <role name="Member"/>
      <role name="Contributor"/>
    </permission>
    <permission name="vs.registration: Modify registrant" acquire="True">
      <role name="Manager"/>
      <role name="Reviewer"/>
    </permission>
  </permissions>
</rolemap>

<?xml version="1.0"?>
<componentregistry>
  <utilities>
    <utility
      interface="plone.app.users.userdataschema.IUserDataSchemaProvider"
      factory="vs.policy.userdataschema.UserDataSchemaProvider"
    />
  </utilities>
</componentregistry>

from plone.app.users.userdataschema import IUserDataSchemaProvider

class UserDataSchemaProvider(object):
    implements(IUserDataSchemaProvider)

    def getSchema(self):
        """
        """
        return IEnhancedUserDataSchema

from plone.app.users.userdataschema import IUserDataSchema

class IEnhancedUserDataSchema(IUserDataSchema):
    """ Use all the fields from the default user data schema, and add various
    extra fields.
   """

newsletter = schema.Bool(
    title=_(u'label_newsletter', default=u'Subscribe to newsletter'),
    description=_(u'help_newsletter',
                  default=u"If you tick this box, we'll subscribe you to "
                    "our newsletter."),
    required=False,
    )

def validateAccept(value):
    if not value == True:
        return False
    return True

class IEnhancedUserDataSchema(IUserDataSchema):
    # ...
    accept = schema.Bool(
        title=_(u'label_accept', default=u'Accept terms of use'),
        description=_(u'help_accept',
                      default=u"Tick this box to indicate that you have found,"
                      " read and accepted the terms of use for this site. "),
        required=True,
        constraint=validateAccept,
        )

<?xml version="1.0"?>
<object name="portal_memberdata" meta_type="Plone Memberdata Tool">
<property name="subscribe_newsletter" type="boolean"></property>
</property>
</object>

<?xml version="1.0"?>
<object name="portal_properties" meta_type="Plone Properties Tool">
 <object name="site_properties" meta_type="Plone Property Sheet">
  <property name="user_registration_fields" type="lines">
   <element value="newsletter" />
   <element value="accept" />
  </property>
 </object>
</object>

<configure
    xmlns="http://namespaces.zope.org/zope"
    i18n_domain="vs.policy.userdata">
  <adapter
    provides=".userdataschema.IEnhancedUserDataSchema"
    for="Products.CMFCore.interfaces.ISiteRoot"
    factory=".adapter.EnhancedUserDataPanelAdapter"
    />
</configure>

from plone.app.users.browser.personalpreferences import UserDataPanelAdapter

class EnhancedUserDataPanelAdapter(UserDataPanelAdapter):
    """
    """
    def get_newsletter(self):
        return self.context.getProperty('newsletter', '')
    def set_newsletter(self, value):
        return self.context.setMemberProperties({'newsletter': value})
    newsletter = property(get_newsletter, set_newsletter)

    def get_accept(self):
        return self.context.getProperty('accept', '')
    def set_accept(self, value):
        return self.context.setMemberProperties({'accept': value})
    accept = property(get_accept, set_accept)

import plone.api
def setupGroups(portal):
    acl_users = plone.api.portal.get_tool('acl_users')
    if not acl_users.searchGroups(name='Staff'):
        gtool = getToolByName(portal, 'portal_groups')
        gtool.addGroup('Staff', roles=['StaffMember'])
def importVarious(context):
    """Miscellanous steps import handle
    """
    if context.readDataFile('vs.policy-various.txt') is None:
       return
    portal = context.getSite()
    setupGroups(portal)

from Products.CMFCore.utils import getToolByName
def setupGroups(portal):
    acl_users = getToolByName(portal, 'acl_users')
    if not acl_users.searchGroups(name='Staff'):
        gtool = getToolByName(portal, 'portal_groups')
        gtool.addGroup('Staff', roles=['StaffMember'])
…

def test_staffmember_group_added(self):
    portal = self.layer['portal']
    acl_users = portal['acl_users']
    self.assertEqual(1,
        len(acl_users.searchGroups(name='Staff')))

from AccessControl import getSecurityManager
from Products.CMFCore.permissions import ModifyPortalContent

sm = getSecurityManager()
if sm.checkPermission(ModifyPortalContent, context):
    # do something

context.manage_permission("Portlets: Manage portlets",
                          roles=['Manager', 'Owner'], acquire=1)

from Products.CMFCore.utils import getToolByName
mtool = getToolByName(context, 'portal_membership')
if mtool.isAnonymousUser():
    # do something

member = mtool.getAuthenticatedMember()
user_id = member.getId()

admin_user = mtool.getMemberById('admin')

<?xml version="1.0"?>
<sharing xmlns:i18n="http://xml.zope.org/namespaces/i18n"
         i18n:domain="vs.policy">
  <role
      id="Event-Manager"
      title="Manages the registrations for events"
      permission="Add Registration"
      i18n:attributes="title"
      />
</sharing>

<role
    id="Reviewer"
    title="Review submitted articles"
    permission="Modify portal content"
    i18n:attributes="title"
    />

<role
  remove="True"
  id="Reviewer"
  />

<sharing xmlns:i18n="http://xml.zope.org/namespaces/i18n"
         i18n:domain="plone">
  <role
      id="Site Manager"
      title="Is a site coordinator"
      permission="Manage portal"
      i18n:attributes="title"
      />
</sharing>

from Products.CMFCore.permissions import setDefaultRoles
from AccessControl import ModuleSecurityInfo

security = ModuleSecurityInfo('vs.policy')

security.declarePublic('MyRole')
MyRole = 'Sharing page: My Role'
setDefaultRoles(MyRole, ('Reviewer',))

from zope.interface import implements
from plone.app.workflow.interfaces import ISharingPageRole

import permissions

class ManagerRole(object):
    implements(ISharingPageRole)

    title = u'My Role'
    required_permission = permissions.MyRole

<permission
    id="plone.MyRole"
    title="Sharing page: My Role"
    />

<?xml version="1.0"?>
<object name="portal_workflow"
        meta_type="Plone Workflow Tool">
    <object name="registrant_workflow" meta_type="Workflow"/>
    <object name="registration_workflow" meta_type="Workflow"/>
    <bindings>
        <type type_id="Registrant">
            <bound-workflow workflow_id="registrant_workflow"/>
        </type>
        <type type_id="Registration">
            <bound-workflow workflow_id="registration_workflow"/>
        </type>
    </bindings>
</object>

<?xml version="1.0"?>
<dc-workflow workflow_id="registrant_workflow"
             title="registrant_workflow"
             state_variable="review_state"
             initial_state="unconfirmed">

<permission>Delete objects</permission>
<permission>Modify portal content</permission>
<permission>View</permission>

<state state_id="confirmed"
       title="Confirmed">
    <exit-transition transition_id="reject-open"/>
    <permission-map name="Delete objects"
                    acquired="False">
        <permission-role>Manager</permission-role>
    </permission-map>
    <permission-map name="Modify portal content"
                    acquired="False">
        <permission-role>Owner</permission-role>
        <permission-role>Manager</permission-role>
    </permission-map>
    <permission-map name="View"
                    acquired="False">
        <permission-role>Manager</permission-role>
    </permission-map>
</state>
...

    <transition transition_id="confirm"
                title="Confirm"
                new_state="confirmed"
                trigger="USER"
                before_script=""
                after_script="">
        <action url="%(content_url)s/content_status_modify?workflow_action=confirm"
                category="workflow">
            Confirm
        </action>
        <guard>
        </guard>
    </transition>
    ...
</dc-workflow>

import plone.api
wftool = plone.api.portal.get_tool('portal_workflow')
review_state = wftool.getInfoFor(context, 'review_state')

from Products.CMFCore.utils import getToolByName
wftool = getToolByName(context, 'portal_workflow'
review_state = wftool.getInfoFor(context, 'review_state')

from Products.CMFCore.utils import getToolByName
catalog = getToolByName(context, 'portal_catalog')
for result in catalog(portal_type = ('Document', 'News Item'),
                      review_state = ('published', 'public', 'visible',)):
    review_state = result.review_state
    # do something with the review state

wftool.doActionFor(context, action='publish')

def test_role_added(self):
    portal = self.layer['portal']
    self.assertTrue("StaffMember" in portal.validRoles())
def test_workflow_installed(self):
    portal = self.layer['portal']
    workflow = getToolByName(portal, 'portal_workflow')
    self.assertTrue('vs_sitecontent_workflow' in workflow)
def test_workflows_mapped(self):
    portal = self.layer['portal']
    workflow = getToolByName(portal, 'portal_workflow')
    self.assertEqual(('vs_sitecontent_workflow',),
        workflow.getDefaultChain())
def test_view_permisison_for_staffmember(self):
    portal = self.layer['portal']
    self.assertTrue('View' in [r['name']
        for r in portal.permissionsOfRole('Reader')
        if r['selected']])
    self.assertTrue('View' in [r['name']
        for r in portal.permissionsOfRole('StaffMember')
        if r['selected']])
def test_staffmember_group_added(self):
    portal = self.layer['portal']
    acl_users = portal['acl_users']
    self.assertEqual(1,
        len(acl_users.searchGroups(name='Staff')))

[security]
View = 0:Manager

[default]
proxy=Manager,Anonymous
[security]
View=0:Authenticated

def installUsers(site):

    site.portal_membership.addMember('me', 'secret', ['Member'], ())
    site.portal_membership.addMember('myself', 'secret', ['Editor', 'Member'], ())
    site.portal_membership.addMember('i', 'secret', ['Manager', 'Member'], ())

def setupVarious(context):

    if context.readDataFile('vs.policy_various.txt') is None:
       return

    ...
    installUsers(site)

<browser:page
  name="debug-user"
  for="*"
  permission="zope2.View"
  class=".debug.DebugUser"
  />

from Products.Five.browser import BrowserView
from AccessControl import getSecurityManager

class DebugUser(BrowserView):
    """ Current user debugging """

    def __call__(self):

        result = list()
        user = getSecurityManager().getUser()
        result.append('User: %s' % user.getUserName())
        result.append('Roles: %s' % user.getRoles())
        result.append('Roles in context: %s' % user.getRolesInContext(self.context))
        result.append('')
        result.append(self.request.text())
        return '\n'.join(result)

<browser:page
    for="Products.CMFCore.interfaces.ISiteRoot"
    name="enquiry"
    class=".enquiry.EnquiryForm"
    permission="zope2.View"
    />

import re
from zope.interface import Interface
from zope import schema
from zope.formlib import form
from Products.Five.formlib import formbase
from Products.Five.browser.pagetemplatefile import ViewPageTemplateFile
from Products.statusmessages.interfaces import IStatusMessage
from Acquisition import aq_inner
from Products.CMFCore.utils import getToolByName
from vs.registration import RegistrationMessageFactory as _

# Define a valiation method for email addresses
class NotAnEmailAddress(schema.ValidationError):
    __doc__ = _(u"Invalid email address")

check_email = re.compile(r"[a-zA-Z0-9._%-]+@([a-zA-Z0-9-]+.)*[a-zA-Z]{2,4}").match
def validate_email(value):
    if not check_email(value):
        raise NotAnEmailAddress(value)
    return True

MESSAGE_TEMPLATE = """\
Enquiry from: %(name)s <%(email_address)s>

%(message)s
"""

class IEnquiryForm(Interface):
    """Define the fields of our form
    """
    subject = schema.TextLine(title=_(u"Subject"),
                              required=True)
    name = schema.TextLine(title=_(u"Your name"),
                              required=True)
    email_address = schema.ASCIILine(title=_(u"Your email address"),
                                     description=_(u"We will use this to contact you if you request it"),
                                     required=True,
                                     constraint=validate_email)
    message = schema.Text(title=_(u"Message"),
                          description=_(u"Please keep to 1,000 characters"),
                          required=True,
                          max_length=1000)

class EnquiryForm(formbase.PageForm):
    form_fields = form.FormFields(IEnquiryForm)
    label = _(u"Enquiry")
    description = _(u"Got a question? Please make an enquiry using the form below!")

def __call__(self):
    self.request.set('disable_border', True)
    return super(EnquiryForm, self).__call__()

@form.action(_(u"Send"))
def action_send(self, action, data):

context = aq_inner(self.context)
mailhost = getToolByName(context, 'MailHost')
urltool = getToolByName(context, 'portal_url')
portal = urltool.getPortalObject()
email_charset = portal.getProperty('email_charset')

to_address = portal.getProperty('email_from_address')
source = "%s <%s>" % (data['name'], data['email_address'])
subject = data['subject']
message = MESSAGE_TEMPLATE % data

mailhost.secureSend(message, to_address, str(source),
                    subject=subject, subtype='plain',
                    charset=email_charset, debug=False,
                    From=source)

confirm = _(u"Thank you! Your enquiry has been received and we will respond as soon as possible")
IStatusMessage(self.request).addStatusMessage(confirm, type='info')

self.request.response.redirect(portal.absolute_url())
return ''

class IEnquiryForm(Interface):
    ...
    newsletter = schema.Bool(title=u'Subscribe to Newsletter?',
                             default=False,
                             required=True)

from zope.schema import vocabulary as schemavocabulary
from zope.app.form import browser as formbrowser

def YesNoWidget(field, request, true=_('yes'), false=_('no')):
    vocabulary = schemavocabulary.SimpleVocabulary.fromItems(((true, True),
                                                         (false, False)))
    return formbrowser.RadioWidget(field, vocabulary, request)

class EnquiryForm(formbase.PageForm):
    form_fields = form.FormFields(IEnquiryForm)
    form_fields['newsletter'].custom_widget = YesNoWidget
    ...

from plone.app.form.widgets.wysiwygwidget import WYSIWYGWidget
...
class IEnquiryForm(Interface):
...
    text = schema.Text(title=_(u"Text"),
                       description=_(u"A field which can contain rich text."),
                       required=True)
...
class EnquiryForm(base.EditForm):
    form_fields = form.FormFields(IEnquiryForm)
    ...
    form_fields['text'].custom_widget = WYSIWYGWidget

<?xml version="1.0"?>
<object name="portal_actions" meta_type="Plone Actions Tool"
        xmlns:i18n="http://xml.zope.org/namespaces/i18n">
    <object name="site_actions"
            meta_type="CMF Action Category">
        <object name="contact"
                meta_type="CMF Action"
                i18n:domain="vs.registration">
            <property name="title" i18n:translate="">Enquiry</property>
            <property name="description" i18n:translate=""></property>
            <property name="url_expr">string:$portal_url/@@enquiry</property>
            <property name="icon_expr"></property>
            <property name="available_expr"></property>
            <property name="permissions">
                <element value="View"/>
            </property>
            <property name="visible">True</property>
        </object>
    </object>
</object>

<form method="get"
      tal:attributes="action string:${context/absolute_url}/${view/__name__}">

    <div i18n:translate="registration_report_days_searched">
        Show changes in the the last
        <input type="text" size="2" name="days"
            tal:attributes="value view/days"
            i18n:name="num_days" />
        days.
        <input type="submit" class="context" name="form.button.UpdateDays"
            value="Refresh"
            i18n:name="submit_button"
            i18n:attributes="value" />
    </div>

</form>

template = ViewPageTemplateFile('registrationreport.pt')

def __call__(self):
    # Hide the editable-border
    self.request.set('disable_border', True)

    # The number for days with a silent fallback on the default
    # if the input is invalid.
    try:
        self.days = int(self.request.get('days', 7))
    except ValueError:
        self.days = 7

    return self.template()

def recently_modified_registrants(self):
    context = aq_inner(self.context)
    catalog = getToolByName(context, 'portal_catalog')
    results = []
    for r in catalog(object_provides=IRegistrant.__identifier__,
                     modified=dict(query=self.modified_after(), range='min'),
                     sort_on='modified',
                     sort_order='reverse',):
        results.append(dict(url=r.getURL(),
                            title=r.Title,
                            description=r.Description,
                            modified=self.localize(r.modified)))
    return results

def localize(self, time):
    return self._time_localizer()(time, None, aq_inner(self.context), domain='plonelocales')

def modified_after(self):
    return DateTime() - self.days

@memoize
def _time_localizer(self):
    context = aq_inner(self.context)
    translation_service = getToolByName(context, 'translation_service')

<input class="context" type="submit" name="form.button.Save" value="Save" i18n:attributes="value label_save" />
<input class="standalone" type="submit" name="form.button.Cancel" value="Cancel" i18n:attributes="value label_cancel"/>

class SharingView(BrowserView):

    # Actions

    template = ViewPageTemplateFile('sharing.pt')

    def __call__(self):
        """Perform the update and redirect if necessary, or render the page
        """

        postback = True

        form = self.request.form
        submitted = form.get('form.submitted', False)

        save_button = form.get('form.button.Save', None) is not None
        cancel_button = form.get('form.button.Cancel', None) is not None

        if submitted and not cancel_button:

            if not self.request.get('REQUEST_METHOD','GET') == 'POST':
                raise Forbidden

            # Update the acquire-roles setting
            inherit = bool(form.get('inherit', False))
            self.update_inherit(inherit)

            # Update settings for users and groups
            entries = form.get('entries', [])
            roles = [r['id'] for r in self.roles()]
            settings = []
            for entry in entries:
                settings.append(
                    dict(id = entry['id'],
                         type = entry['type'],
                         roles = [r for r in roles if entry.get('role_%s' % r, False)]))
            if settings:
                self.update_role_settings(settings)

        # Other buttons return to the sharing page
        if cancel_button:
            postback = False

        if postback:
            return self.template()
        else:
            context_state = self.context.restrictedTraverse("@@plone_context_state")
            url = context_state.view_url()
            self.request.response.redirect(url)

<input
    type="hidden"
    name="entries.id:records"
    tal:attributes="value entry/id"
    />
<input
    type="hidden"
    name="entries.type:records"
    tal:attributes="value entry/type"
    />

<input type="hidden"
       name="limit:int"
       value="8 />"

<textarea name="description:text" />

<input type="checkbox"
       name="status:list"
       value="1"

<input type="text"
       name="keywords:tokens" />

<input type="text"
       name="data.id:record" />

<input type="text"
       name="title:required" />

<input type="text"
       name="id:ignore_empty" />

<input type="hidden"
       name="accept:boolean:default"
       value="True" />
<input type="checkbox"
       name="accept:boolean:default"
       value="False" />

<div metal:fill-slot="main"
     tal:define="errors options/state/getErrors;">
  ...
  <form name="sendto_form"
        class="enableAutoFocus"
        action="sendto_form"
        method="post"
        enctype="multipart/form-data"
        tal:attributes="action string:$here_url/$template_id">
    ...
    <div class="field"
         tal:define="error errors/send_to_address|nothing;"
         tal:attributes="class python:test(error, ``field error``, ``field``)">
      ...
      <div class="formControls">
        <input class="context"
               type="submit"
               name="form.button.Send"
               value="Send"
               i18n:attributes="value label_send;"
               />
    </div>
    ...
  </form>

[default]
title=Send this page to somebody

[validators]
validators=validate_sendto

[actions]
action.success=traverse_to:string:sendto
action.failure=traverse_to:string:sendto_form

[validators]
validators = validate_script1, validate_script2

validators.Document = validate_script1
validators.Image = validate_script2

<input type="submit" name="form.button.button1" value="Value1" />
<input type="submit" name="form.button.button2" value="Value2" />

validators.button1 = validate_script1
validators.button2 = validate_script2

[actions]
action.success = traverse_to:string:script1

action.success.Document = traverse_to:string:document_script
action.success.Image = traverse_to:string:image_script

action.success.button1 = traverse_to:string:script1
action.success.button2 = traverse_to:string:script2

[validators]
validators=validate_sendto

[actions]
action.success = redirect_to_action:string:view
action.failure = redirect_to_action:string:view

## Controller Script Python "validate_sendto"
##bind container=container
##bind context=context
##bind namespace=
##bind script=script
##bind state=state
##bind subpath=traverse_subpath
##parameters=send_to_address='',send_from_address=''
##title=validates the email adresses

from Products.CMFPlone import PloneMessageFactory as _
plone_utils=context.plone_utils

if not send_to_address:
    state.setError('send_to_address', _(u'Please submit an email address.'), 'email_required')
...
if state.getErrors():
    context.plone_utils.addPortalMessage(_(u'Please correct the indicated errors.'), 'error')
    return state.set(status='failure')
else:
    return state

## Controller Python Script "sendto"
##bind container=container
##bind context=context
##bind namespace=
##bind script=script
##bind state=state
##bind subpath=traverse_subpath
##parameters=
##title=Send an URL to a friend
##
REQUEST=context.REQUEST

...

if not mtool.checkPermission(AllowSendto, context):
    context.plone_utils.addPortalMessage(_(u'You are not allowed to send this link.'), 'error')
    return state.set(status='failure')

...

context.plone_utils.addPortalMessage(_(u'Mail sent.'))
return state

<?xml version="1.0"?>
<object name="portal_languages" meta_type="Plone Language Tool">
 <default_language value="en"/>
 <use_content_negotiation value="False"/>
 <use_path_negotiation value="False"/>
 <use_cookie_negotiation value="True"/>
 <authenticated_users_only value="False"/>
 <use_request_negotiation value="False"/>
 <use_cctld_negotiation value="False"/>
 <use_subdomain_negotiation value="False"/>
 <use_combined_language_codes value="False"/>
 <display_flags value="False"/>
 <start_neutral value="False"/>
 <supported_langs>
  <element value="en"/>
  <element value="de"/>
 </supported_langs>
</object>

def testLanguageSettings(self):
    default_language = self.portal.portal_languages.getDefaultLanguage()
    self.assertEqual(default_language == 'de', True)
    # return [(country code, countryname), ...]
    supported_languages = [r[0] for r in self.portal.portal_languages.listSupportedLanguages()]
    self.assertEqual('en' in supported_languages, True)
    self.assertEqual('de' in supported_languages, True)

<html xmlns:tal="http://xml.zope.org/namespaces/tal"
      xmlns:metal="http://xml.zope.org/namespaces/metal"
      i18n:domain="vs.registration">

<a href=""
   tal:attributes="href python:test(item_type in use_view_action, item_url+'/view', item_url);"
   i18n:translate="read_more">
    Read More&hellip;
</a>

<img src="plone.gif"
     alt="Plone Icon"
     title="Plone Icon Title"
     i18n:attributes="alt vs_registration_plone_icon;
                      title vs_registration_plone_icon_title">

<p i18n:translate="text_download">There have been
    <span tal:content="here/download_count"
          i18n:name="count">100.000</span>
    downloads of Plone. </p>

msgid "text_download"
msgstr "There have been ${count} downloads of Plone."

<p i18n:translate="contentrules_controlpanel_link">
    Use the
    <a i18n:name="controlpanel_link"
       i18n:translate="contentrules_control_panel"
       tal:attributes="href string:${portal/absolute_url}/@@rules-controlpanel">
        content rules control panel
    </a>
    to create new rules or delete or modify existing ones.
</p>

msgid "contentrules_controlpanel_link"
msgstr "Benutzen Sie ${controlpanel_link} um neue Regeln zu erstellen, zu löschen oder zu modifizieren."

msgid "contentrules_control_panel"
msgstr "die Regeleinstellungen"

StringField('event_type', vocabulary='EventTypes',
    widget=SelectionWidget(
        label='Event Type',
        label_msgid='label_event_type',
        description='The type of the event',
        description_msgid='help_event_type',
        i18n_domain='vs.registration'),),

from zope.i18nmessageid import MessageFactory
RegistrationMessageFactory = MessageFactory('vs.registration')

from vs.registration import RegistrationMessageFactory as _

label=_(u"Body Text"),
description=_(u"Text for front page of registration")

from Products.CMFCore.utils import getToolByName
...
translation_service = getToolByName(self, 'translation_service')
value = u'John Doo'
return translation_service.utranslate('plone',
                                       u'My name is ${fullname}',
                                       mapping={u'fullname' : value})

<object name="Registration"
        meta_type="Factory-based Type Information with dynamic views"
        i18n:domain="vs.registration"
        xmlns:i18n="http://xml.zope.org/namespaces/i18n">
    <property name="title"
              i18n:translate="">Registration</property>

<p i18n:translate="">
  Cart has <tal:block replace="number">#</tal:block>
  book<tal:block condition=
      "python: number <> 1">s</tal:block>.</p>

install_requires=[
    'setuptools',
    'jarn.jsi18n'
],

<?xml version="1.0"?>
<metadata>
  ...
  <dependencies>
    ...
    <dependency>profile-jarn.jsi18n:default</dependency>
  </dependencies>
</metadata>

$(document).ready(function () {
    jarn.i18n.loadCatalog('plone', 'de');
    _ = jarn.i18n.MessageFactory('plone')
});

> _('contribute');
hinzufügen

> _('Groups are: ${names}', {names: 'staff'})
"Gruppen sind: Mitarbeiter"

> jarn.i18n.loadCatalog('plone', 'en');
> _en = jarn.i18n.MessageFactory('plone', 'en');
> _en('Contributor');
"Contributor"

[buildout]
parts =
    scripts

eggs =
    i18ndude

[scripts]
recipe = zc.recipe.egg
eggs = i18ndude

$ mkdir -p src/vs.registration/vs/registration/locales/de/LC_MESSAGES
$ cd /home/veit/i18ndude_buildout
$ ./bin/i18ndude rebuild-pot --pot /home/veit/myproject/src/vs.registration/vs/registration/locales/vs.registration.pot --create vs.registration /home/veit/myproject/src/vs.registration/vs/registration

$  touch src/vs.registration/vs/registration/locales/de/LC_MESSAGES/vs.registration.po
$ ./bin/i18ndude sync --pot src/vs.registration/vs/registration/locales/vs.registration.pot src/vs.registration/vs/registration/locales/de/LC_MESSAGES/vs.registration.po

src/vs.registration/vs/registration/locales/de/LC_MESSAGES/vs.registration.po: 31 added, 0 removed

$ ./bin/i18ndude sync --pot src/vs.registration/vs/registration/locales/vs.registration.pot src/vs.registration/vs/registration/locales/de/LC_MESSAGES/vs.registration.po

#!/usr/bin/env bash
./bin/i18ndude rebuild-pot --pot src/vs.policy/vs/policy/locales/vs.policy.pot --create "vs.policy" --merge src/vs.policy/vs/policy/locales/vs.policy-manual.pot src/vs.policy*
./bin/i18ndude rebuild-pot --pot src/vs.policy/vs/policy/locales/plone.pot --create "plone" --merge src/vs.policy/vs/policy/locales/plone-manual.pot src/vs.policy/vs/policy/profiles/
./bin/i18ndude sync --pot src/vs.policy/vs/policy/locales/vs.policy.pot src/vs.policy/vs/policy/locales/de/LC_MESSAGES/vs.policy.po
msgfmt --no-hash -o src/vs.policy/vs/policy/locales/de/LC_MESSAGES/vs.policy.mo src/vs.policy/vs/policy/locales/de/LC_MESSAGES/vs.policy.po
./bin/i18ndude sync --pot src/vs.policy/vs/policy/locales/plone.pot src/vs.policy/vs/policy/locales/de/LC_MESSAGES/plone.po
msgfmt --no-hash -o src/vs.policy/vs/policy/locales/de/LC_MESSAGES/plone.mo src/vs.policy/vs/policy/locales/de/LC_MESSAGES/plone.po

msgid "date_format_long"
msgstr "${Y}-${m}-${d} ${H}:${M}"

msgid "date_format_short"
msgstr "${Y}-${m}-${d}"

locales/de/LC_MESSAGES/
locales/en/LC_MESSAGES/

<configure
    ...
    xmlns:i18n="http://namespaces.zope.org/i18n"
    i18n_domain="vs.theme">
    ...
    <i18n:registerTranslations directory="locales" />
</configure>

# Compile po files
for lang in $(find locales -mindepth 1 -maxdepth 1 -type d); do
    if test -d $lang/LC_MESSAGES; then
        msgfmt -o $lang/LC_MESSAGES/${PRODUCT_NAME}.mo $lang/LC_MESSAGES/${PRODUCT_NAME}.po
    fi
done

[instance]
...
environment-vars =
    zope_i18n_compile_mo_files = true

[instance]
...
environment-vars =
    ...
    PTS_LANGUAGES en de
    zope_i18n_allowed_languages en de

#. Default: "Categorization"
#: ./ATContentTypes/content/schemata.py
msgid "label_schema_categorization"
msgstr "Kategorisierung"

[buildout]
...
instance
i18n-overwrites
...

[i18n-overwrites]
recipe = plone.recipe.command
command =
    ln -sf ${buildout:directory}/i18n ${instance:location}/
update-command =
    ${i18n-overwrites:command}

[instance]
...
eggs =
    Zope2
    Plone
    ${buildout:eggs}

zcml =
    vs.theme
    ...

<?xml version="1.0"?>
<object name="portal_languages">
 <default_language value="de"/>
 <use_cookie_negotiation value="True"/>
 <use_content_negotiation value="True"/>
 <use_request_negotiation value="True"/>
 <display_flags value="False"/>
 <start_neutral value="False"/>
 <supported_langs>
   <element value="en"/>
   <element value="de"/>
 </supported_langs>
</object>

Setup of language root folders on Plone site 'mysite'
Added 'en' folder: en
INavigationRoot setup on folder 'en'
Added 'de' folder: de
INavigationRoot setup on folder 'de'
Translations linked.
Portal default page removed.
Moved default page 'front-page' to folder 'de'.
Root language switcher set up.

import transaction
...
class Generator:

    def configureLinguaPlone(self, portal):

        pl = getToolByName(portal, 'portal_languages')
        pl.supported_langs = ('de', 'en')

        transaction.savepoint(1)
        portal.restrictedTraverse('@@language-setup-folders')()

def setupVarious(context):
    ...
    gen.configureLinguaPlone(site)

<configure
    ...
    xmlns:monkey="http://namespaces.plone.org/monkey">
...
    <monkey:patch
        description="TinyMCE JSON Folder listing should ignore INavigationRoot"
        class="Products.TinyMCE.adapters.JSONFolderListing.JSONFolderListing"
        original="getListing"
        replacement=".patches.getListing"
        />

68c68,69
< if INavigationRoot.providedBy(object) or (rooted == "True" and document_base_url[:-1] == object.absolute_url()):
---
> #if INavigationRoot.providedBy(object) or (rooted == "True" and document_base_url[:-1] == object.absolute_url()):
> if (rooted == "True" and document_base_url[:-1] == object.absolute_url()):

<monkey:patch
    description="Navigation support for the ReferenceBrowserWidget across INavigationRoot"
    class="archetypes.referencebrowserwidget.browser.view.ReferenceBrowserPopup"
    original="breadcrumbs"
    replacement=".patches.breadcrumbs"
    />

12c14,21
<                     portal_state.navigation_root_url())}]
---
>                     portal_state.portal_url())}]
>
> if portal_state.portal_url() != portal_state.navigation_root_url():
>     nav_root_path = portal_state.navigation_root_path()
>     nav_root = self.context.restrictedTraverse(nav_root_path)
>     newcrumbs.append({'Title': nav_root.Title(),
>                   'absolute_url': self.genRefBrowserUrl(
>                         portal_state.navigation_root_url())})

try:
    from Products.LinguaPlone.public import *
except ImportError:
    # No multilingual support
    from Products.Archetypes.public import *

class IRegistration(Interface):
    """A folder containing registrants
    """
    contains('vs.registration.interfaces.IRegistrant',)

    registration_key = schema.ASCIILine(title=_(u"Registrant key"),
                                        description=_(u"This should match the registration key used by the booking system"),
                                        required=True)

    ...

class IRegistrant(Interface):
    """A registrant
    """

    occurrence_key = schema.ASCIILine(title=_(u"Occurrence key"),
                                      description=_(u"This should match the occurrence key used by the booking system"),
                                      required=True)

    ...

class IOccurrence(Interface):
    """A single occurrence
    """

    occurrence_key = schema.Int(title=_(u"Occurrence identifier"),
                                description=_(u"A unique id for this occurrence"),
                              required=True,
                              readonly=True)

    registration = schema.Object(title=_(u"Registration"),
                                 schema=IRegistration
                                 required=True,
                                 readonly=True)

    occurrence_time = schema.Date(title=_(u"Date/time"),
                                  required=True,
                                  readonly=True)

    vacancies = schema.Int(title=_(u"Vacancies"),
                           description=_(u"Vacancies for this Occurrence"))

class IReservation(Interface):
    """A reservation for a particular occurrence
    """

    customer_name = schema.TextLine(title=_(u"Customer name"),
                                    description=_(u"The name of the customer making the reservation"),
                                    required=True)

    num_reservations = schema.Int(title=_(u"Number of reservations"),
                                  description=_(u""),
                                  required=True,
                                  min=1)

    occurrence = schema.Object(title=_(u"Occurrence"),
                               description=_(u"Occurrence to book for"),
                               schema=IOccurrence,
                               required=True)

class Occurrence(object):
    """A single occurrence.
    """

    implements(IOccurrence)

    occurrence_key = None
    registration = None
    occurrence_time = None
    vacancies = 0

class Reservation(object):
    """A reservation for a particular occurrence
    """

    implements(IReservation)

    customer_name = u""
    num_reservations = 0
    occurrence = None

class IRegistrations(Interface):
    """Searches appropriate occurrences
    """

    def registrations_for_registrant(registrant):
        """Return a list of all registrations of a specific registrant as
        list of dictionaries with keys 'registration_key', 'url' and
        'title'.
        """

    def occurrence_by_key(occurence_key):
        """Get an IOccurrence from an occurrence key
        """

class IReservations(Interface):
    """A utility capable of making reservations
    """

    def __call__(reservation):
        """Make a reservation
        """

create database if not exists registration;
use registration;

-- Occurrences
create table if not exists occurrence (
    occurrence_key integer unsigned not null auto_increment primary key,
    registration_key char(4) not null,
    registrant_key char(4) not null,
    occurrence_time datetime not null,
    vacancies integer unsigned not null,
    index showing_registration_key(registration_key),
    index showing_registrant_key(registrant_key),
    index showing_occurrence_time(occurrence_time),
    index showing_vacancies(vacancies)
) engine=InnoDB;

-- Reservations
create table if not exists reservation (
    reservation_key integer unsigned not null auto_increment primary key,
    occurrence_key integer unsigned not null,
    num_reservations tinyint unsigned not null,
    customer_name varchar(64) not null,
    index reservation_num_reservations(num_reservations),
    foreign key(occurrence_key)
        references occurrence(occurrence_key)
            on update restrict
            on delete restrict
) engine=InnoDB;

install_requires=[
    'setuptools',
    # -*- Extra requirements: -*-
    'MySQL-python',
    'collective.lead>=1.0b3,<2.0dev',
],

from persistent import Persistent

from zope.interface import implements
from zope.component import getUtility

from collective.lead import Database
from vs.registration.interfaces import IDatabaseSettings

from sqlalchemy.engine.url import URL
from sqlalchemy import Table, mapper, relation

from vs.registration.occurrence import Occurrence
from vs.registration.reservation import Reservation

class ReservationsDatabaseSettings(Persistent):
    implements(IDatabaseSettings)

    drivername = 'mysql'
    hostname = 'localhost'
    port = None
    username = ''
    password = None
    database = ''

class ReservationsDatabase(Database):
    @property
    def _url(self):
        settings = getUtility(IDatabaseSettings)
        return URL(drivername=settings.drivername, username=settings.username,
                   password=settings.password, host=settings.hostname,
                   port=settings.port, database=settings.database)

    def _setup_tables(self, metadata, tables):
        tables['occurrence'] = Table('occurrence', metadata, autoload=True)
        tables['reservation'] = Table('reservation', metadata, autoload=True)

    def _setup_mappers(self, tables, mappers):
        mappers['occurrence'] = mapper(Occurrence, tables['occurrence'])
        mappers['reservation'] = mapper(Reservation, tables['reservation'],
                                        properties = {
                                            'occurrence' : relation(Occurrence),
                                            })

<utility
    provides="collective.lead.interfaces.IDatabase"
    factory=".db.ReservationsDatabase"
    name="vs.reservations"
    />

<?xml version="1.0"?>
<componentregistry>
    <utilities>
        <utility
            interface="vs.registration.interfaces.IDatabaseSettings"
            factory="vs.registration.db.ReservationsDatabaseSettings"
            />
    </utilities>
</componentregistry>

>>> from zope.component import getUtility
>>> from collective.lead.interfaces import IDatabase
>>> db = getUtility(IDatabase, name='vs.reservations')

class IDatabaseSettings(Interface):
    """Database connection settings.
    """

    drivername = schema.ASCIILine(title=_(u"Driver name"),
                                  description=_(u"The database driver name"),
                                  default='mysql',
                                  required=True)

    hostname = schema.ASCIILine(title=_(u"Host name"),
                                description=_(u"The database host name"),
                                default='localhost',
                                required=True)

    port = schema.Int(title=_(u"Port number"),
                      description=_(u"The database port number. Leave blank to use the default."),
                      required=False)

    username = schema.ASCIILine(title=_(u"User name"),
                                description=_(u"The database user name"),
                                required=True)

    password = schema.Password(title=_(u"Password"),
                               description=_(u"The database password"),
                               required=False)

    database = schema.ASCIILine(title=_(u"Database name"),
                                description=_(u"The name of the database on this server"),
                                required=True)

from zope.component import getUtility
from zope.formlib import form

from plone.app.controlpanel.form import ControlPanelForm

from collective.lead.interfaces import IDatabase

from vs.registration.interfaces import IDatabaseSettings
from vs.registration import RegistrationMessageFactory as _

def reservations_database_settings(context):
    return getUtility(IDatabaseSettings)

class ReservationsDatabaseControlPanel(ControlPanelForm):
    form_fields = form.FormFields(IDatabaseSettings)

    form_name = _(u"Reservations Database settings")
    label = _(u"Reservations Database settings")
    description = _(u"Please enter the appropriate connection settings for the database")

    def _on_save(self, data):
        db = getUtility(IDatabase, name='vs.reservations')
        db.invalidate()

<browser:resource
    name="dbsettings_icon.gif"
    image="dbsettings_icon.gif"
    />

<browser:page
    name="reservations-database-controlpanel"
    for="Products.CMFPlone.interfaces.IPloneSiteRoot"
    class=".dbsettings.ReservationsDatabaseControlPanel"
    permission="cmf.ManagePortal"
    />

<adapter
    for="Products.CMFPlone.interfaces.IPloneSiteRoot"
    provides="vs.registration.interfaces.IDatabaseSettings"
    factory=".dbsettings.reservations_database_settings"
    />

<?xml version="1.0"?>
<object name="portal_controlpanel" meta_type="Plone Control Panel Tool">
    <configlet title="Reservations Database" action_id="ReservationsDatabase"
               appId="ReservationsDatabase" category="Products" condition_expr=""
               url_expr="string:${portal_url}/@@reservations-database-controlpanel"
               visible="True">
        <permission>Manage portal</permission>
    </configlet>
</object>

<?xml version="1.0"?>
<action-icons>
    <action-icon category="controlpanel"
                 action_id="ReservationsDatabase"
                 title="Reservations Database"
                 priority="0" icon_expr="++resource++dbsettings_icon.gif"/>
</action-icons>

from zope.interface import implements
from zope.component import getUtility
from zope.app.component.hooks import getSite

from Products.CMFCore.interfaces import ISiteRoot
from Products.CMFCore.utils import getToolByName

from vs.registration.interfaces import IRegistrant
from vs.registration.interfaces import IRegistration
from vs.registration.interfaces import IOccurrence
from vs.registration.interfaces import IRegistrations

import sqlalchemy as sql
from collective.lead.interfaces import IDatabase

...

class Registrations(object):
    implements(IRegistrations)

    def registrations_for_registrant(self, registrant):
        db = getUtility(IDatabase, name='vs.reservations')
        connection = db.connection

        statement = sql.select([Occurrence.c.registration_key],
                               sql.and_(
                                    Occurrence.c.registrant_key == registrant.registrant_key,
                               ),
                               distinct=True)

        results = connection.execute(statement).fetchall()

        registration_keys = [row['registration_key'] for row in results]

        site = getSite()
        catalog = getToolByName(site, 'portal_catalog')

        return [ dict(registration_key=registration.registration_key,
                      url=registration.getURL(),
                      title=registration.Title,)
                 for registration in
                    catalog(object_provides=IRegistration.__keyentifier__,
                            registration_key=registration_keys,
                            sort_on='sortable_title')
               ]

def occurrences(self, registrant, registration):

    db = getUtility(IDatabase, name='vs.reservations')
    session = db.session

    occurrences = session.query(Occurrence).select(sql.and_(
                                                       Occurrence.c.registrant_key==registrant.registrant_key,
                                                       Occurrence.c.registration_key==registration.registration_key,
                                                       ),
                                                   )

    for occurrence in occurrences:
        occurrence.registrant = registrant
        occurrence.registration = registration

    return occurrences

from zope.interface import implements
from zope.component import getUtility

from vs.registration.interfaces import IReservations
from vs.registration.interfaces import ReservationError

from vs.registration.occurrence import Occurrence
from vs.registration import RegistrationMessageFactory as _

import sqlalchemy as sql
from collective.lead.interfaces import IDatabase

class Reservations(object):
    implements(IReservations)

    def __call__(self, reservation):
        db = getUtility(IDatabase, name='vs.reservations')
        session = db.session

        occurrence = reservation.occurrence
        session.refresh(occurrence)

        if occurrence.vacancies <= 0:
            raise ReservationError(_(u"There are not enough vacancies anymore!"))
        elif occurrence.vacancies < reservation.num_reservations:
            raise ReservationError(_(u"Not enough reservations remaining!"))

        occurrence.vacancies -= reservation.num_reservations
        session.update(occurrence)
        session.save(reservation)
        session.flush()

class ReservationError(Exception):

    def __init__(self, message):
        Exception.__init__(self, message)
        self.error_message = message

from zope.component import getUtility
...
@memoize
def registrations(self):
    context = aq_inner(self.context)
    registrations = getUtility(IRegistrations)
    return registrations.registrations_for_registrant(context)

<h2 i18n:translate="title_registrated_at">Registrated at</h2>
<ul>
    <tal:block repeat="registration view/registrations">
        <li>
            <a tal:attributes="href registration/url"
               tal:content="registration/title" />
        </li>
    </tal:block>
</ul>

[buildout]
extends =
    base.cfg

parts =
    zeoserver
    instance1

[zeoserver]
recipe = plone.recipe.zeoserver
zeo-address = 127.0.0.1:8000
blob-storage = ${buildout:directory}/var/blobstorage

[instance-base]
zeo-client = True
zeo-address = ${zeoserver:zeo-address}
blob-storage = ${zeoserver:blob-storage}
shared-blob = on
zserver-threads = 4
http-fast-listen = off

[instance1]
<= instance-base
http-address = 8010
debug-mode = off
verbose-security = off

eggs =
    tempstorage
zodb-temporary-storage =
    <zodb_db temporary>
        # Temporary storage database (for sessions)
        <zeoclient>
            server ${zeoserver:zeo-address}
            storage temp
            name zeostorage
            var ${buildout:directory}/var/filestorage
        </zeoclient>
        mount-point /temp_folder
        container-class Products.TemporaryFolder.TemporaryContainer
    </zodb_db>

[instance-profile]
<= instance-base
...
environment-vars +=
    PROFILE_PUBLISHER 1

eggs -=
    Products.PDBDebugMode

${zeoserver:zeo-address}

$ python2.7 bbootstrap.py -c deploy.cfg
$ ./bin/buildout -c deploy.cfg

$ ./bin/zeoserver start
$ ./bin/instance1 start

[instance]
...
effective-user = plone

> bin\instance install

/plone/vs_buildout/var/blobstorage 192.168.110.0/24(rw)

# service nfs restart
NFS-Daemon beenden:                                        [  OK  ]
NFS mountd beenden:                                        [  OK  ]
NFS-Dienste beenden:                                       [  OK  ]
NFS-Dienste starten:                                       [  OK  ]
NFS-mountd starten:                                        [  OK  ]
NFS-Daemon starten:                                        [  OK  ]

mount -t nfs4 192.168.110.3:/plone/vs_buildout/var/blobstorage /plone/vs_buildout/var/blobstorage

...
192.168.110.3:/plone/vs_buildout/var/blobstorage /plone/vs_buildout/var/blobstorage nfs4 rw,addr=192.168.110.3,clientaddr=192.168.110.4 0 0

> bin\zeoserver_service  install

> bin\zeoservice install

> bin\instance install
> bin\instance2 install

> bin\instance remove
> bin\instance2 remove

webdav-address = 8091
webdav-force-connection-close = off

zope-conf-additional =
    ...
    enable-ms-public-header on

<IfModule mod_setenvif.c>
 BrowserMatch "Microsoft Data Access Internet Publishing Provider" redirect-carefully
</IfModule>

zope-conf-additional =
    <clock-server>
        method /mysite/do_stuff
        period 60
        user admin
        password secret
        host localhost
    </clock-server>

2009-03-03 19:57:38 INFO ZServer Clock server for "/mysite/do_stuff" started (user: admin, period: 60)

[zeoserver]
...
zeo-conf-additional =
    <filestorage extra>
        path  ${buildout:directory}/var/filestorage/Extra.fs
    </filestorage>

[instance]
...
zope-conf-additional =
    <zodb_db extra>
        # Extra database
        cache-size 10000
        allow-implicit-cross-references false
    # ZEOStorage database
        <zeoclient>
          server ${zeoserver:zeo-address}
          storage extra
          name zeostorage
          var ${buildout:directory}/var
          cache-size 500MB
        </zeoclient>
        mount-point /extra
    </zodb_db>

[instance2]
...
zope-conf-additional =
    ${instance:zope-conf-additional}
    zserver-threads 1

path_on_client:path_on_zeo_server

$ ./bin/buildout -Noc deploy.cfg

[buildout]
parts =
    filestorage
    ...

[filestorage]
recipe = collective.recipe.filestorage
parts =
    extra
    super

${zeoserver:zeo-address}

[buildout]
parts =
    filestorage
    ...

[filestorage]
recipe = collective.recipe.filestorage
blob-storage = ${buildout:directory}/var/blobstorage-%(fs_part_name)s
parts =
    extra

[zeoserver]
...
blob-storage = ${buildout:directory}/var/blobstorage-%(fs_part_name)s

$ ./bin/zeopack days=7

[buildout]
parts =
    ...
    zeopack-crontab
...
[zeopack-crontab]
recipe = z3c.recipe.usercrontab
times = 5 0 * * 1
command = ${buildout:bin-directory}/zeopack days=7

#!/home/veit/myproject/bin/zopepy

username = None
blob_dir = "/home/veit/myproject/var/blobstorage-%(fs_part_name)s"
realm = None
storages = '1','extra'
days = "7"
unix = None
address = "localhost:8100"
host = "localhost"
password = None
port = "8100"
import getopt; opts = getopt.getopt(sys.argv[1:], 'S:B:W1')[0];
opts = dict(opts)
storage = opts.has_key('-S') and opts['-S'] or '1'
blob_dir = opts.has_key('-B') and opts['-B'] or blob_dir

import plone.recipe.zeoserver.pack

for storage in storages:
    print 'Packing storage %s' % storage
    plone.recipe.zeoserver.pack.main(host, port, unix, days, username, password, realm, blob_dir, storage)

[zeoserver]
eggs = plone.recipe.zeoserver
...
[zopepy]
...
eggs =
    ${instance:eggs}
    ${zeoserver:eggs}

[zeopack-crontab]
...
command = ${buildout:directory}/zeopackall

$ mkdir backups
$ ./bin/repozo -BvzQ -r backups -f var/filestorage/Data.fs

$ ./bin/repozo -Rv -r backups -o Data.fs

[buildout]
parts =
    ...
    backup-crontab
...
[backup-crontab]
recipe = z3c.recipe.usercrontab
times = 15 0 * * *
command = ${buildout:bin-directory}/repozo  -BvzQ -r ${buildout:directory}/backups -f ${buildout:directory}/var/filestorage/Data.fs

[buildout]
parts =
    ...
    backup
...
[backup]
recipe = collective.recipe.backup
additional_filestorages =
    Extra
    Super

[backup]
recipe = collective.recipe.backup
additional_filestorages = ${filestorage:parts}

location = ${buildout:directory}/backups

[backup-crontab]
...
command = ${buildout:bin-directory}/backup -q

[buildout]
parts =
    ...
    remove-incremental-backups
    remove-full-backups
...
[remove-incremental-backups]
recipe = z3c.recipe.usercrontab
times = 8 0 * * *
command = find ${buildout:directory}/backups -name \*deltafs -ctime +14 -delete

[remove-full-backups]
recipe = z3c.recipe.usercrontab
times = 8 0 * * *
command = find ${buildout:directory}/backups -name \*dat -ctime +35 -delete

[buildout]
parts =
    instance
    backup

[instance]
recipe = plone.recipe.zope2instance
user = admin:admin
blob-storage = ${buildout:directory}/var/blobstorage

[backup]
recipe = collective.recipe.backup

[buildout]
parts =
    ...
    filebackup
    blobbackup

[filebackup]
recipe = collective.recipe.backup
backup_blobs = false

[blobbackup]
recipe = collective.recipe.backup
blob_storage = ${buildout:directory}/var/blobstorage
only_blobs = true

[extrablobbackup]
recipe = collective.recipe.backup
blob_storage = ${buildout:directory}/var/extrablobstorage
only_blobs = true

[rsync-file]
recipe = collective.recipe.rsync
source = veit-schiele.de:/srv/www.veit-schiele.de/var/filestorage/Data.fs
target = var/filestorage/Data.fs
script = true

[rsync-blob]
recipe = collective.recipe.rsync
source = veit-schiele.de:/srv/www.veit-schiele.de/var/blobstorage/
target = var/blobstorage/
script = true

$ ./bin/zopepy -m ZODB.scripts.fsrecover -P 0 var/filestorage/Data.fs var/filestorage/Data.fs.recovered &> logrecover.txt

Recovering var/filestorage/Data.fs into var/filestorage/Data.fs.recovered
. 1 . 2 . 3 . 4 . 5 . 6 . 7 . 8 . 9 . 0
0 bytes removed during recovery
Packing ...

$ easy_install-2.6 virtualenv
$ virtualenv --no-site-packages zeo_check

$ cd zeo_check
$ ./bin/easy_install zc.zodbdgc

<zodb>
  <filestorage my>
     path var/filestorage/my.fs
     blob-dir var/blobstorage-my
  </filestorage>
</zodb>

$ ./bin/multi-zodb-check-refs storages.cfg

!!! main 26798 ?
POSKeyError: 0x68ae

# Check ZEO Storages
0 6 * * * cd /home/veit/zeo_check; ./bin/multi-zodb-check-refs |mailx -s "Check Storages" -c admin@veit-schiele.de

$ ./bin/multi-zodb-check-refs -r var/filestorage/refdb.fs storages.cfg
!!! main 26798 main 16717
POSKeyError: 0x68ae

<zodb main>
    <filestorage 1>
          path /home/veit/zeo_check/var/filestorage/refdb.fs
    </filestorage>
</zodb>

$ ../myproject/bin/zopepy
>>> import ZODB.config
>>> db = ZODB.config.databaseFromFile(open('./refdb.cfg'))
>>> conn = db.open()
>>> refs = conn.root()['references']

!!! main 13184375 ?
POSKeyError: 0xc92d77

>>> parent = list(refs['main'][13184375])
>>> parent
[13178389]

>>> app._p_jar.get('13178389')
2010-07-16 15:30:18 ERROR ZODB.Connection Couldn't load state for 0xc91615
Traceback (most recent call last):
…
ZODB.POSException.POSKeyError: 0xc92d77

>>> app._p_jar.db()._storage.load('\x00\x00\x00\x00\x00\xc9\x16\x15', '')
('cBTrees.IOBTree
IOBucket
q\x01.((J$KT\x02ccopy_reg
_reconstructor
q\x02(cfive.intid.keyreference
KeyReferenceToPersistent
…

$ ./bin/instance-debug debug
Starting debugger (the name "app" is bound to the top-level Zope object)
…
>>> import transaction
>>> transaction.begin()
>>> from ZODB.utils import p64
>>> p64(26798)
'\x00\x00\x00\x00\x00\x00h\xae'
>>> from persistent import Persistent
>>> a = Persistent()
>>> a._p_oid = '\x00\x00\x00\x00\x00\x00h\xae'
>>> a._p_jar = app._p_jar
>>> app._p_jar._register(a)
>>> app._p_jar._added[a._p_oid] = a
>>> transaction.commit()

>>> app._p_jar.get('\x00\x00\x00\x00\x00\x00h\xae')
<persistent.Persistent object at 0xab7f9cc>
>>> app._p_jar.get('\x00\x00\x00\x00\x00\xc9\x16\x15')
BTrees.IOBTree.IOBucket([(39078692, <five.intid.keyreference…

>>> conn.close()
>>> db.close()

$ ./Processed 123816 records in 2601 transactions
Average record size is 1276.43 bytes
Average transaction size is 60762.18 bytes
Types used:
Class Name                                       Count    TBytes    Pct AvgSize
---------------------------------------------- ------- ---------  ----- -------
AccessControl.User.UserFolder                        1       185   0.0%  185.00
App.ApplicationManager.ApplicationManager            1       189   0.0%  189.00
App.Product.ProductFolder                            1        34   0.0%   34.00
BTrees.IIBTree.IIBTree                            6705   1783379   1.1%  265.98
BTrees.IIBTree.IIBucket                           6957   4584392   2.9%  658.96
…
webdav.LockItem.LockItem                          1203    323529   0.2%  268.94
...PersistentAdapterRegistry                         2      7074   0.0% 3537.00
zope.ramcache.ram.RAMCache                           1       288   0.0%  288.00
============================================== ======= =========  ===== =======
                            Total Transactions    2601                   59.34k
                                 Total Records  123816   154338k 100.0% 1276.43
                               Current Objects   74107    78439k  50.8% 1083.87
                                   Old Objects   47124    75898k  49.2% 1649.27

[instance-debug]
<= instance
...
eggs =
    dm.historical
    ...

$ ./bin/instance-debug debug
Starting debugger (the name "app" is bound to the top-level Zope object)

>>> from DateTime import DateTime
>>> from dm.historical import getObjectAt
>>> site = getObjectAt(app.Plone, DateTime('2014-03-28 14:00:00'))
>>> folder = site['news']
>>> folder.manage_exportObject()

<eventlog>
    level info
    <logfile>
        path  /home/veit/myproject/var/log/instance.log
        level info
    </logfile>
</eventlog>

<eventlog>
    level info
    <logfile>
        path ${buildout:directory}/var/log/instance.log
        level info
    </logfile>
    <email-notifier>
        from zope@veit-schiele.de
        to admin@veit-schiele.de
        subject "Zope Error"
        level error
    </email-notifier>
</eventlog>

[instance-base]
...
event-log-max-size = 5 MB
event-log-old-files = 7
access-log-max-size = 20 MB
access-log-old-files = 7

[instance]
recipe = plone.recipe.zope2instance
...
event-log-custom =
    <logfile>
        path ${buildout:directory}/var/log/${:_buildout_section_name_}.log
        when D
        old-files 7
    </logfile>
access-log-custom =
    <logfile>
        path ${buildout:directory}/var/log/${:_buildout_section_name_}-Z2.log
        when D
        old-files 7
    </logfile>

[buildout]
parts =
    ...
    logrotate
    ...
[logrotate]
    recipe = collective.recipe.template
    input = templates/logrotate.conf.in
    output = ${buildout:directory}/etc/logrotate.conf

daily
missingok
rotate 14
mail zope-logs@veit-schiele.de
compress
delaycompress
notifempty
size 1k

${buildout:directory}/var/log/zeoserver.log {
    postrotate
        ${buildout:bin-directory}/zeoserver logreopen
    endscript
}

${buildout:directory}/var/log/instance.log ${buildout:directory}/var/log/instance-Z2.log {
    sharedscripts
    postrotate
        ${buildout:bin-directory}/instance logreopen
    endscript
}

${buildout:directory}/var/log/instance2.log ${buildout:directory}/var/log/instance2-Z2.log {
    sharedscripts
    postrotate
        ${buildout:bin-directory}/instance2 logreopen
    endscript
}

7 0 * * * /usr/sbin/logrotate -s  /home/veit/myproject/var/log/logrotate-status /home/veit/myproject/etc/logrotate.conf

[buildout]
parts =
    ...
    logrotate-crontab
...
[logrotate-crontab]
recipe = z3c.recipe.usercrontab
times = 7 0 * * *
command = /usr/sbin/logrotate -s ${buildout:directory}/var/log/logrotate-status ${buildout:directory}/etc/logrotate.conf

#!/bin/sh
# /etc/rc.d/init.d/zeo
# Startup script for a ZEOCluster
#
# chkconfig: 345 80 20
# description: Zope, a scalable web application server
#
# config: /srv/myproject/deploy.cfg
#
# LSB Source function library
. /lib/lsb/init-functions

RETVAL=0
# list zeo clients in the list below
zeoclients="instance instance2"
# this is for the default install path
clusterpath="/srv/myproject"
prog="ZEOCluster"

start() {
    echo -n $"Starting $prog: "
    output=`${clusterpath}/bin/zeoserver start`
    # the return status of the zeoserver is not reliable, we need to parse
    # its output via substring match
    if echo $output | grep -q "start"; then
            # success
            touch /var/lock/zope/$prog
            log_success_msg "zeoserver started successfully"
            echo
            RETVAL=0
    else
            # failed
            log_failure_msg "zeo failed to start or was already started"
            echo
            RETVAL=1
    fi
    for client in $zeoclients
        do
            echo -n $"Starting $client: "
            output=`${clusterpath}/bin/${client} start`
            # the return status of the instance is not reliable, we need to parse
            # its output via substring match
            if echo $output | grep -q "start"; then
                # success
                touch /var/lock/zope/${client}
                log_success_msg "$client started successfully"
                echo
                RETVAL=0
            else
                # failed
                log_failure_msg "$client failed to start or was already started"
                echo
                RETVAL=1
            fi
        done
        return $RETVAL
}

stop() {

for client in $zeoclients
    do
       echo -n $"Stopping $client: "
       output=`${clusterpath}/bin/${client} stop`
       # the return status of the instance is not reliable, we need to parse
        # its output via substring match
        if echo $output | grep -q "stop"; then
            # success
            rm /var/lock/zope/${client}
            log_success_msg "$client stopped successfully"
            echo
            RETVAL=0
        else
            # failed
            log_failure_msg "$client failed to stop or was already stopped"
            echo
            RETVAL=1
        fi
    done
    echo -n $"Stopping $prog: "
    output=`${clusterpath}/bin/zeoserver stop`
    # the return status of the instance is not reliable, we need to parse
    # its output via substring match
    if echo $output | grep -q "stop"; then
            # success
            rm /var/lock/zope/$prog
            log_success_msg "zeoserver stopped successfully"
            echo
            RETVAL=0
    else
            # failed
            log_failure_msg "zeoserver failed to stop or was already stopped"
            echo
            RETVAL=1
    fi
        return $RETVAL
}

restart() {
   stop
   start
}

case "$1" in
  start)
    start
    ;;
  stop)
    stop
    ;;
  status)
        echo "ZEO Server:"
        output=`${clusterpath}/bin/zeoserver status`
        echo $output
        for client in $zeoclients
        do
                echo "Zope Client" $client
                output=`${clusterpath}/bin/${client} status`
                echo $output
        done
        ;;
  restart)
    restart
    ;;
  condrestart)
    [ -e /var/lock/zope/$prog ] && restart
    ;;
  *)
    echo $"Usage: $0 {start|stop|status|restart|condrestart}"
    RETVAL=2
esac

exit $RETVAL

[instance]
...
environment-vars =
    PYTHON_EGG_CACHE = /home/zope/.python-eggs

$ cd /etc/init.d
$ sudo ln -s /srv/myproject/zeo .
$ sudo /etc/init.d/zeo start

$ sudo chkconfig --level 345 zeo off

[buildout]
...
parts =
    ...
    reboot

[reboot]
recipe = z3c.recipe.usercrontab
times = @reboot
command = ${buildout:directory}/zeo start

$ svn propset svn:executable ON zeo

[zeoserver1]
...
zeo-conf-additional =
    <zrs>
        replicate-to 5000
        <filestorage>
            path ${buildout:directory}/var/filestorage/Data.fs
        </filestorage>
    </zrs>

[zeoserver2]
...
zeo-conf-additional =
    <zrs>
        replicate-from primary-host: 5000
        replicate-to 5000
        keep-alive-delay 60
        <filestorage>
            path ${buildout:directory}/var/filestorage/Data.fs
        </filestorage>
    </zrs>

[zeoserver]
recipe = plone.recipe.zeoserver[zrs]
...

[instance]
...
zope-conf-additional =
    publisher-profile-file ${buildout:directory}/var/instance/profile.dat
environment-vars =
    PROFILE_PUBLISHER 1

eggs =
    ...
    Products.PTProfiler

http://plone.org/products/callprofiler/releases/1.4-fixed/CallProfiler-1.4-fixed.tar.gz

      167 function calls (160 primitive calls) in 5.229 CPU seconds

Ordered by: internal time

ncalls  tottime  percall  cumtime  percall filename:lineno(function)
     1    2.927    2.927    2.960    2.960 document_view:0(__call__)
     1    0.754    0.754    3.715    3.715 mysite:0(Request)
     1    0.186    0.186    0.187    0.187 search_icon.gif:0(Request)
     1    0.132    0.132    0.132    0.132 folder_icon.gif:0(Request)
     1    0.080    0.080    0.080    0.080 file_icon.gif:0(Request)
     1    0.076    0.076    0.076    0.076 member-cachekey9666.css:0(Request)
     1    0.071    0.071    0.073    0.073 document_icon.gif:0(Request)
...

http://www.dieter.handshake.de/pyprojects/zope/ZopeProfiler.tgz

./bin/instance test -pvvv --profile -m vs.registration

$ python
>>> from hotshot.stats import load
>>> s = load('tests_profile.bMAEin.prof')
s.print_stats('.*some_function.*')

from profilehooks import profile

  @profile
  def my_function(args, etc):
      pass

[instance]
...
eggs =
    ...
    collective.stats

2014-02-17 12:25:30 INFO Zope Ready to handle requests
2014-02-17 12:25:50 INFO collective.stats | 0.0021 0.0014 0.0018 0.0004 0.0000 0000 0000 0000 | GET:/favicon.ico | t: 0.0000, t_c: 0.0000, t_nc: 0.0000 | RSS: 116708 - 116744
2014-02-17 12:25:55 INFO collective.stats | 0.1783 0.0021 0.1779 0.0004 0.0000 0000 0000 0000 | GET:/manage_main | t: 0.0000, t_c: 0.0000, t_nc: 0.0000 | RSS: 116756 - 116948

[instance]
...
eggs =
    ...
    Products.LongRequestLogger

environment-vars =
    longrequestlogger_file = ${buildout:directory}/var/log/${:_buildout_section_name_}-longrequest.log
    longrequestlogger_timeout = 4
    longrequestlogger_interval = 2

$ apt-get install apache2-utils

$ ab -n 100 -c 3 http://www.veit-schiele.de/

$ ab -h

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %T/%D" combined

[31/Oct/2011:13:36:07 +0000] "GET / HTTP/1.1" 200 7918 "" "..." 0/95491

[buildout]
...
extends =
    ...
    http://good-py.appspot.com/release/plone.app.caching/1.0b2
...
eggs =
    ...
    plone.app.caching

Last-Modified: <last-modified-date>
Cache-Control: max-age=<seconds>, proxy-revalidate, public

ETag: <etag-value>
Cache-Control: max-age=0, s-maxage=<seconds>, must-revalidate

Last-Modified: <last-modified-date>
Cache-Control: max-age=0, s-maxage=<seconds>, must-revalidate

<genericsetup:registerProfile
    name="with-caching-proxy"
    title="With caching proxy"
    description="Settings useful for setups with a caching proxy such as Squid or Varnish"
    directory="profiles/with-caching-proxy"
    provides="Products.GenericSetup.interfaces.EXTENSION"
    for="plone.app.caching.interfaces.ICacheProfiles"
    />

<record name="plone.caching.interfaces.ICacheSettings.operationMapping">
    <value purge="False">
        <element key="plone.resource">plone.app.caching.strongCaching</element>
        <element key="plone.stableResource">plone.app.caching.strongCaching</element>
        <element key="plone.content.itemView">plone.app.caching.weakCaching</element>
        <element key="plone.content.feed">plone.app.caching.moderateCaching</element>
        <element key="plone.content.folderView">plone.app.caching.weakCaching</element>
        <element key="plone.content.file">plone.app.caching.moderateCaching</element>
    </value>
</record>

<record name="plone.app.caching.weakCaching.plone.content.itemView.ramCache">
    <field ref="plone.app.caching.weakCaching.ramCache" />
    <value>True</value>
</record>

$ sudo apt-get install varnish

$ yum install varnish

$ sudo port install varnish

$ brew install varnish

# varnishadm -T localhost:6082 -S /etc/varnish/secret
200
-----------------------------
Varnish Cache CLI 1.0
-----------------------------
Linux,4.4.0-92-generic,x86_64,-junix,-smalloc,-smalloc,-hcritbit
varnish-4.1.1 revision 66bb824

Type 'help' for command list.
Type 'quit' to close CLI session.

varnish>

quit

# varnishadm "ban req.url ~".

# varnishadm "ban req.url ~ .jpg"

# vcl.load <name> <file>

# vcl.load ploneconf /etc/varnish/plone.vcl

# vcl.use ploneconf

[buildout]
parts =
...
varnish-config
...
[varnish-config]
recipe = collective.recipe.template
input = templates/plone.vcl.in
output = ${buildout:directory}/etc/plone.vcl
backend-host = 127.0.0.1
backend-port = 8010

# varnishlog

# varnishstat
Uptime mgt:     1+23:43:52
Hitrate n:       10       46       46
Uptime child:   1+23:43:53                                                       avg(n):   0.0000   0.0000   0.0000
    NAME                             CURRENT        CHANGE       AVERAGE        AVG_10       AVG_100      AVG_1000
MAIN.uptime                       1+23:43:53
MAIN.sess_conn                         53834          0.00           .            0.07          0.07          0.07
MAIN.client_req                        53834          0.00           .            0.07          0.07          0.07
MAIN.cache_hit                         14119          0.00           .            0.00          0.00          0.00
MAIN.cache_miss                        39568          0.00           .            0.07          0.07          0.07
MAIN.backend_reuse                     38602          0.00           .            0.07          0.07          0.07
...

backend instance1 {
    .host = "127.0.0.1";
    .port = "8081";
    .connect_timeout = 0.4s;
    .first_byte_timeout = 300s;
    .between_bytes_timeout  = 60s;
    .probe = {
        .url = "/";
        .timeout = 5s;
        .interval = 15s;
        .window = 10;
        .threshold = 8;
    }
}

backend instance2 {
    .host = "127.0.0.1";
    .port = "8082";
    .connect_timeout = 0.4s;
    .first_byte_timeout = 300s;
    .between_bytes_timeout  = 60s;
    .probe = {
        .url = "/";
        .timeout = 5s;
        .interval = 15s;
        .window = 10;
        .threshold = 8;
    }
}

...

import directors;

sub vcl_init {
    new vdir = directors.fallback();
    vdir.add_backend(instance1);
    vdir.add_backend(instance1);
}

...

import std;

sub vcl_recv {

    set req.backend_hint = vdir.backend();
    ...
    if (! std.healthy(req.backend_hint))  {
        set req.backend_hint = sorryserver();
        return(pass);
    }
    ...
}

from plone.memoize import instance

class MyClass(object):

   @instance.memoize
   def some_function(self, arg1, arg2):
       ...

from plone.memoize import view

class MyView(BrowserView):

    @view.memoize
    def some_function(self, arg1, arg2):
        ...

from Products.Five import BrowserView
from plone.memoize import ram

def _render_cachekey(method, self, brain):
    return (brain.getPath(), brain.modified)

class View(BrowserView):
    @ram.cache(_render_cachekey)
    def render(self, brain):
        obj = brain.getObject()
        view = obj.restrictedTraverse('@@obj-view')
        return view.render()

from time import time
...
class View(BrowserView):
    @ram.cache(lambda *args: time() // (60 * 60))
    ...

from zope.interface import directlyProvides
import zope.thread
from plone.memoize.interfaces import ICacheChooser
from plone.memoize.ram import MemcacheAdapter
import os
import memcache

thread_local = zope.thread.local()

def choose_cache(fun_name):
    global servers

    client=getattr(thread_local, "client", None)
    if client is None:
        servers=os.environ.get(
            "MEMCACHE_SERVER", "127.0.0.1:11211").split(",")
        client=thread_local.client=memcache.Client(servers, debug=0)

    return MemcacheAdapter(client)

directlyProvides(choose_cache, ICacheChooser)

<configure
        xmlns="http://namespaces.zope.org/zope">

    <utility
        component=".caching.choose_cache"
        provides="plone.memoize.interfaces.ICacheChooser"
        />

</configure>

LoadModule alias_module    /usr/lib/apache2/modules/mod_alias.so
LoadModule proxy_module    /usr/lib/apache2/modules/mod_proxy.so
LoadModule proxy_http      /usr/lib/apache2/modules/mod_proxy_http.so
LoadModule rewrite_module  /usr/lib/apache2/modules/mod_rewrite.so

$ a2enmod alias proxy proxy_http rewrite

NameVirtualHost 83.223.91.163:80
<VirtualHost 83.223.91.163:80>
    ServerName    www.veit-schiele.de
    RewriteEngine on
    RewriteRule   ^/(.*) http://83.223.91.163:8082/VirtualHostBase/http/%{SERVER_NAME}:80/vs/VirtualHostRoot/$1 [P]
</VirtualHost>

Listen 83.223.91.163:80

# a2ensite www.veit-schiele.de
Site www.veit-schiele.de installed; run /etc/init.d/apache2 reload to enable.

Redirect permanent / https://www.veit-schiele.de/

LoadModule ssl_module      /usr/lib/apache2/modules/mod_ssl.so

NameVirtualHost 83.223.91.163:443
<VirtualHost 83.223.91.163:443>
    ServerName            www.veit-schiele.de
    SSLEngine             on
    SSLCertificateFile    /etc/apache2/ssl.crt/server.crt
    SSLCertificateKeyFile /etc/apache2/ssl.key/server.key
</VirtualHost>

# Rewrites the came_from in the URL for https
RewriteCond %{QUERY_STRING} came_from=http(.*)
RewriteRule ^/(.*)login_form$ https://edit.veit-schiele.de/$1login_form?came_from=https%1 [NE,L]

# Switches to https when hit login_form or login_success
RewriteRule ^/login_(.*) https://edit.veit-schiele.de/login_$1 [NE,L]

# Switches to http upon logout
RewriteRule ^/(.*)logged_out http://www.veit-schiele.de/$1logged_out [L,P]

# Keeps on https until log out
RewriteRule ^/(.*) http://83.223.91.163:8080/VirtualHostBase/https/%edit.veit-schiele.de:443/vs/VirtualHostRoot/$1 [L,P]

# Forbidden HTTP status for all path components beginning with manage
RedirectMatch 403 /manage

[buildout]
parts =
    ...
    apache

[apache]
recipe = zc.recipe.macro
macro = apache-macro
result-recipe=collective.recipe.template
targets =
    my-apache:mysite-parameters

[apache-macro]
domain=$${:domain}
host=$${:host}
port=$${:port}
input = ${buildout:directory}/template/apache-vhost.in
output = ${buildout:parts-directory}/$${:__name__}

[mysite-parameters]
domain=mysite.org
host=83.223.91.163
port=8080

${host}
${port}
${domain}

[apache]
recipe = zc.recipe.macro:empty
result-sections = my-apache

[my-apache]
recipe = collective.recipe.template
domain = mysite.org
host = 83.223.91.163
input = /home/veit/myproject/template/apache-vhost.in
output = /home/veit/myproject/parts/my-apache
port = 8080

83.223.91.163
8080
mysite.org

[apache]
...
targets =
    ...
    vs-apache:vs-parameters

...
[vs-parameters]
domain=veit-schiele.de
host=83.223.91.163
port=8090

[buildout]
parts =
    ...
    mysite-awstats

[awstats]
recipe = zc.recipe.macro
macro = awstats-macro
result-recipe=collective.recipe.template
targets =
    mysite-awstats:mysite-parameters
    vs-awstats:vs-parameters

[awstats-macro]
domain=$${:domain}
host=$${:host}
port=$${:port}
input = ${buildout:directory}/template/awstats-conf.in
output = ${buildout:parts-directory}/$${:__name__}

${host}
${port}
${domain}

[buildout]
parts =
    ...
    awstats
    mysite-awstats
    vs-awstats

...

[awstats]
recipe = zc.recipe.macro:empty
result-sections =
    mysite-awstats
    vs-awstats

[mysite-awstats]
domain = mysite.org
host = 83.223.91.163
input = /home/veit/myproject/template/awstats-conf.in
output = /home/veit/myproject/parts/mysite-awstats
port = 8080
recipe = collective.recipe.template

[vs-awstats]
domain = veit-schiele.de
host = 83.223.91.163
input = /home/veit/myproject/template/awstats-conf.in
output = /home/veit/myproject/parts/vs-awstats
port = 8090
recipe = collective.recipe.template

83.223.91.163
8080
mysite.org

[instance]
...
eggs =
    ...
    redturtle.munin
zcml =
    ...
    redturtle.munin

[buildout]
parts =
    ...
    munin1

[munin1]
recipe = zc.recipe.egg
eggs = redturtle.munin
arguments = http_address='${instance:http-address}', user='${instance:user}'

http://localhost:8081/@@redturtle.munin.plugins/zopethreads

$ bin/munin install /opt/munin/etc/plugins [<prefix>] [<suffix>]

$ cd /opt/munin/etc/plugins
$ ln -s ~/myproject/bin/munin vs_zodbactivity_mysite1

$ cd /opt/munin/etc/plugin-conf.d/
$ vim redturtle.conf
... [vs_*_mysite1]
... env.AUTH admin:secret
... env.URL http://localhost:8081/@@redturtle.munin.plugins/%s

eggs =
    ...
    plone.postpublicationhook [Zope2.10]

[instance-base]
...
eggs +=
    ...
    haufe.requestmonitoring
    threadframe
    zope.app.appsetup
zcml +=
    ...
    haufe.requestmonitoring

[instance-base]
...
zope-conf-additional =
    <product-config successlogging>
        filebase /home/veit/vs_buildout/var/log/request
    </product-config>

    %import haufe.requestmonitoring
    <requestmonitor requestmonitor>
        period 5s
        <monitorhandler dumper>
            factory haufe.requestmonitoring.DumpTraceback.factory
            # 0 means no repetition.
            # A negative value means indefinitely.
            repeat -1
            time 10s
        </monitorhandler>
    </requestmonitor>

timestamp status request_time type request_id request_info

%import haufe.requestmonitoring
<requestmonitor requestmonitor>
    period 5s
    <monitorhandler dumper>
        factory Haufe.RequestMonitoring.DumpTraceback.factory
        # 0 --> no repetition
        repeat -1
        time 10s
    </monitorhandler>
</requestmonitor>

2009-08-11 14:29:09 INFO Zope Ready to handle requests
2009-08-11 14:29:09 INFO RequestMonitor started
2009-08-11 14:29:14 INFO RequestMonitor monitoring 1 requests
2009-08-11 14:29:19 INFO RequestMonitor monitoring 1 requests
2009-08-11 14:29:24 INFO RequestMonitor monitoring 1 requests
2009-08-11 14:29:24 WARNING RequestMonitor.DumpTrace Long running request
Request 1 "/foo" running in thread -497947728 since 14.9961140156s
Python call stack (innermost first)
Module /home/junga/sandboxes/review/parts/instance/Extensions/foo.py, line 4, in foo
Module Products.ExternalMethod.ExternalMethod, line 231, in __call__
- __traceback_info__: ((), {}, None)
Module ZPublisher.Publish, line 46, in call_object
Module ZPublisher.mapply, line 88, in mapply
Module ZPublisher.Publish, line 126, in publish
Module ZPublisher.Publish, line 225, in publish_module_standard
Module ZPublisher.Publish, line 424, in publish_module
Module Products.ZopeProfiler.ZopeProfiler, line 353, in _profilePublishModule
Module Products.ZopeProfiler.MonkeyPatcher, line 35, in __call__
Module ZServer.PubCore.ZServerPublisher, line 28, in __init__

[buildout]
parts =
    ...
   ztop
...
[ztop]
recipe = zc.recipe.egg
eggs = haufe.ztop

[instance-base]
…
eggs +=
    haufe.monitoring
zcml +=
    haufe.monitoring

[buildout]

parts =
     ...
    zhw

eggs =
     ...
    ZopeHealthWatcher

[zhw]
recipe = zc.recipe.egg
eggs = ZopeHealthWatcher
scripts = zope_health_watcher

ACTIVATED = True
SECRET = 'secret'

$ zope_health_watcher http://localhost:8080
Idle: 3        Busy: 1
OK - Everything looks fine

$ zope_health_watcher http://localhost:8080
Information:
    Time: 2011-06-02T10:52:31.522557
    Sysload: 0.25 0.18 0.20 4/1003 32523
    Meminfo: MemTotal:       11759712 kB
    MemFree:         4799368 kB
    Buffers:             204 kB
    Cached:          2933200 kB
    SwapCached:            0 kB
    Active:          4051368 kB
    Inactive:        1678532 kB
    Active(anon):    2830948 kB
    Inactive(anon):    46644 kB
    Active(file):    1220420 kB
    Inactive(file):  1631888 kB
    Unevictable:        2764 kB
    Mlocked:            2764 kB
    SwapTotal:       4000176 kB
    SwapFree:        4000176 kB
    ...
Dump:
Thread -162882704
QUERY: GET /VirtualHostBase/http/www.plone-entwicklerhandbuch.de:80/pen/VirtualHostRoot/@@downloadPDF?
URL: http://www.plone-entwicklerhandbuch.de/@@downloadPDF
HTTP_USER_AGENT: Mozilla/5.0 (X11; U; Linux i686; de; rv:1.9.2.17) Gecko/20110422 Ubuntu/10.04 (lucid) Firefox/3.6.17
File "/home/veit/plone40_buildout/eggs/Zope2-2.12.17-py2.6-linux-x86_64.egg/ZServer/PubCore/ZServerPublisher.py", line 31, in __init__
   response=b)
...
Thread -184550544
...

$ ./bin/zope_health_watcher http://localhost:8080
Idle: 0 Busy: 0
FAILURE - [Errno socket error] (61, 'Connection refused')

http://www.plone-entwicklerhandbuch.de/manage_zhw?secret

[buildout]
...
eggs =
    ...
    raven

[instance1]
...
event-log-custom =
    %import raven.contrib.zope
    <logfile>
      path ${buildout:directory}/var/{:_buildout_section_name_}.log
      level INFO
    </logfile>
    <sentry>
      dsn YOUR_DSN
      level ERROR
    </sentry>

[unix_http_server]
file=%(here)s/../var/supervisor.sock
chmod=0600

[supervisorctl]
serverurl=unix://%(here)s/../var/supervisor.sock

[rpcinterface:supervisor]
supervisor.rpcinterface_factory=supervisor.rpcinterface:make_main_rpcinterface

[supervisord]
logfile=%(here)s/../var/log/supervisord.log
logfile_maxbytes=5MB
logfile_backups=10
loglevel=info
pidfile=%(here)s/../var/supervisord.pid ;
childlogdir=%(here)s/../var/log
nodaemon=false              ; (start in foreground if true; default false)
minfds=1024                 ; (min. avail startup file descriptors; default 1024)
minprocs=200                ; (min. avail process descriptors; default 200)
directory=%(here)s

[program:zeoserver]
command = %(here)s/../bin/zeoserver fg
autostart= true
autorestart = true
startsecs = 10
priority = 100

[program: instance]
command = %(here)s/../bin/instance console
startsecs = 60
priority = 2
redirect_stderr = true
autostart= true
autorestart = true
priority = 500

[groups]
programs = instance

[program:varnish]
command = %(here)s/../bin/varnish -F
autostart= true
autorestart = true
priority = 1000

[buildout]
parts =
   ...
   supervisor

[supervisor]
recipe = zc.recipe.egg
eggs = supervisor

$ ./bin/buildout
$ ./bin/supervisord

$ ./bin/supervisorctl start all
$ ./bin/supervisorctl stop all

[inet_http_server]
port=127.0.0.1:9001
username=admin
password=secret

[supervisorctl]
serverurl = http://localhost:9001

$ ./bin/supervisord
$ ./bin/supervisorctl
Server requires authentication
Username:admin
Password:

instance                        STARTING
varnish                         RUNNING    pid 21683, uptime 0:00:10
zeoserver                       STARTING

supervisor> shutdown
Really shut the remote supervisord process down y/N? y
Shut down

[supervisor]
recipe = collective.recipe.supervisor
plugins =
    superlance

eventlisteners =
    memmon  TICK_60  ${buildout:bin-directory}/memmon [-g app=1GB]
    httpok1  (startsecs=600)  TICK_3600  ${buildout:bin-directory}/httpok  [-p app:instance1 -t 30 http://127.0.0.1:8010/]
    httpok2  (startsecs=600)  TICK_3600  ${buildout:bin-directory}/httpok  [-p app:instance2 -t 30 http://127.0.0.1:8020/]

[buildout]
parts += fabric

[versions]
fabric = 1.0.0
paramiko = 1.7.6
pycrypto = 2.3

[fabric]
recipe = zc.recipe.egg
eggs =
    setuptools
    fabric

from __future__ import with_statement
from fabric.api import cd, env, local, run, sudo

def www():
    env.hosts = ['www.veit-schiele.de']
    env.shell = '/bin/sh -c'
    env.sudo_prefix = "sudo -S -p '%s' -H "
    env.code_root = '/srv/www.veit-schiele.de'
    env.code_user = 'zope'

def update():
    with cd(env.code_root):
        sudo('nice svn up', user=env.code_user)

def rebuild():
    with cd(env.code_root):
        sudo('nice bin/buildout -c deploy.cfg', user=env.code_user)

def restart():
    with cd(env.code_root):
        sudo('nice bin/supervisorctl reload', user=env.code_user)

def start():
    with cd(env.code_root):
        sudo('nice bin/supervisord', user=env.code_user)

def stop():
    with cd(env.code_root):
        sudo('nice bin/supervisorctl shutdown', user=env.code_user)

def deploy():
    update()
    rebuild()
    restart()

>>> browser.open('http://localhost:8080/mysite/')
>>> browser.lastRequestPystones < 5
True

$ sudo apt-get install jmeter

[buildout]
...
eggs =
    ...
    collective.indexing

<include package="collective.indexing" />

[instance]
...
zcml =
    collective.indexing

[zeoserver]
...
zeo-conf-additional =
    <filestorage 2>
        path ${buildout:directory}/var/filestorage/CatalogData.fs
    </filestorage>

[instance1]
...
zope-conf-additional =

    <zodb_db catalog>
        mount-point /mysite/portal_catalog
        container-class Products.CMFPlone.CatalogTool.CatalogTool
        cache-size 300000
        <zeoclient>
            server ${zeo:zeo-address}
            storage 2
            name catalogstorage
            var ${buildout:parts-directory}/instance1/var
            cache-size 400MB
        </zeoclient>
    </zodb_db>

[buildout]
...
eggs =
    ...
    experimental.catalogqueryplan

<include package="experimental.catalogqueryplan" />

[instance]
...
zcml =
    experimental.catalogqueryplan

[instance]
...
zope-conf-additional =
    <environment>
        LOG_SLOW_QUERIES True
        LONG_QUERY_TIME  0.05
    </environment>

2009-04-17T16:56:47 INFO experimental.catalogqueryplan portal_catalog, query: 0.11ms (hits: 0), mean 128.41ms (key hits: 11),  priority: ('path', 'review_state', 'is_default_page', 'allowedRolesAndUsers', 'portal_type')

[buildout]
parts =
    ...
    eggcheckouts
...
[eggcheckouts]
recipe = infrae.subversion
urls =
    https://svn.plone.org/svn/collective/unimr.catalogqueryplan/trunk unimr.catalogqueryplan
location = src
as_eggs = true

[instance]
...
eggs =
    ...
   ${eggcheckouts:eggs}

[instance]
...
zope-conf-additional =
    <environment>
        LOG_SLOW_QUERIES True
        LONG_QUERY_TIME  0.05
    </environment>

2009-04-17T16:56:47 INFO unimr.catalogqueryplan portal_catalog, query: 0.11ms (hits: 0), mean 128.41ms (key hits: 11),  priority: ('path', 'review_state', 'is_default_page', 'allowedRolesAndUsers', 'portal_type')

[instance]
...
zope-conf-additional =
    ...
    <environment>
        REFRESH_RATE 500
    </environment>

[buildout]
...
eggs =
    ...
    unimr.compositeindex

<include package="unimr.compositeindex" />

[instance]
...
zcml =
    unimr.compositeindex

<?xml version="1.0"?>
<object name="portal_catalog" meta_type="Plone Catalog Tool">
    <index name="comp01" meta_type="CompositeIndex">
        <indexed_attr value="is_default_page"/>
        <indexed_attr value="review_state"/>
        <indexed_attr value="portal_type"/>
        <indexed_attr value="allowedRolesAndUsers"/>
    </index>
    <column value="comp01"/>
</object>

[instance]
...
eggs =
    ...
    five.pt

[haproxy-build]
recipe = plone.recipe.haproxy
url = http://www.haproxy.org/download/1.4/src/haproxy-1.4.26.tar.gz
target = linux26
cpu = i686
pcre = 1

[haproxy-config]
recipe = collective.recipe.template
input = ${buildout:directory}/templates/haproxy.conf.in
output = ${buildout:directory}/etc/haproxy.conf
user = haproxy
group = haproxy
frontend-host = 127.0.0.1
frontend-port = 8001

global
  maxconn  ${haproxy-conf:maxconn}
  user ${haproxy-config:user}
  group ${haproxy-config:group}
  daemon
  nbproc 1
  spread-checks 3
  ulimit-n 65536

defaults
  mode http

  # The zope instances have maxconn 1, and it is important that
  # unused/idle connections are closed as soon as possible.
  option httpclose

  # Remove requests from the queue if people press stop button
  option abortonclose

  retries 3
  option redispatch
  monitor-uri /haproxy-ping

  timeout connect 5s
  timeout queue 30s
  timeout client 50s
  timeout server 120s
  timeout check 50s
  stats enable
  stats uri /haproxy-status
  stats refresh 60s
  stats realm Haproxy\ statistics

frontend zeocluster
  bind ${haproxy-config:frontend-host}:${haproxy-config:frontend-port}
  default_backend zope

  option httplog
  log 127.0.0.1:1514 local6

  # Load balancing over the zope instances
  backend zope
  # Use Zope's __ac cookie as a basis for session stickiness if present.
  appsession __ac len 32 timeout 1d
  # Otherwise add a cookie called "serverid" for maintaining session stickiness.
  # This cookie lasts until the client's browser closes, and is invisible to Zope.
  cookie serverid insert nocache indirect
  # If no session found, use the roundrobin load-balancing algorithm to pick a backend.
  balance roundrobin
  # Use / (the default) for periodic backend health checks
  option httpchk GET /

  # Server options:
  # "maxconn" is how many connections can be sent to the server at once
  # "check" enables health checks
  # "rise 1" means consider Zope up after 1 successful health check
  server instance1 127.0.0.1:${instance1:http-address} weight 1 check inter 15s rise 2 fall 1 maxconn 2
  server instance2 127.0.0.1:${instance1:http-address} weight 1 check inter 15s rise 2 fall 1 maxconn 2

${buildout:directory}/bin/haproxy -f ${buildout:directory}/etc/haproxy.conf -db

from plone.protect import PostOnly
from plone.protect import protect

@protect(PostOnly)
def something(self, param, REQUEST=None):
    pass

<span tal:replace="structure context/@@authenticator/authenticator"/>

authenticator=getMultiAdapter((context, request), name=u"authenticator")
if not authenticator.verify():
    raise Unauthorized

from plone.protect import CheckAuthenticator
from plone.protect import protect

@protect(CheckAuthenticator)
def something(self, param, REQUEST=None):
    pass

from plone.protect import CheckAuthenticator
...
CheckAuthenticator(self.context.REQUEST)
...

self.request.response.setHeader ('X-Frame-Options "," AllowAll'))

# system-config-firewall-tui

Firewall-Konfiguration: Anpassen
Trusted Dienste: WWW (HTTP)
Andere Ports: Hinzufügen
Port/Port-Bereich: 9000
Protokoll: tcp

# Firewall configuration written by system-config-firewall
# Manual customization of this file is not recommended.
*filter
:INPUT ACCEPT [0:0]
:FORWARD ACCEPT [0:0]
:OUTPUT ACCEPT [0:0]
-A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
-A INPUT -p icmp -j ACCEPT
-A INPUT -i lo -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 22 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 9000 -j ACCEPT
-A INPUT -j REJECT --reject-with icmp-host-prohibited
-A FORWARD -j REJECT --reject-with icmp-host-prohibited
COMMIT

# watch iptables --list -v
Every 2,0s: iptables --list -v                                                                  Wed Mar 20 18:30:34 2013

Chain INPUT (policy ACCEPT 0 packets, 0 bytes)
 pkts bytes target     prot opt in     out     source               destination
 1476  202K ACCEPT     all  --  any    any     anywhere             anywhere            state RELATED,ESTABLISHED
    0     0 ACCEPT     icmp --  any    any     anywhere             anywhere
    1    60 ACCEPT     all  --  lo     any     anywhere             anywhere
    1    60 ACCEPT     tcp  --  any    any     anywhere             anywhere            state NEW tcp dpt:ssh
    0     0 ACCEPT     tcp  --  any    any     anywhere             anywhere            state NEW tcp dpt:nfs
    6   360 ACCEPT     tcp  --  any    any     anywhere             anywhere            state NEW tcp dpt:cslistener
   18   576 REJECT     all  --  any    any     anywhere             anywhere            reject-with icmp-host-prohibited

Chain FORWARD (policy ACCEPT 0 packets, 0 bytes)
 pkts bytes target     prot opt in     out     source               destination
    0     0 REJECT     all  --  any    any     anywhere             anywhere            reject-with icmp-host-prohibited

Chain OUTPUT (policy ACCEPT 1405 packets, 117K bytes)
 pkts bytes target     prot opt in     out     source               destination

# netstat -tulpen
Aktive Internetverbindungen (Nur Server)
Proto Recv-Q Send-Q Local Address               Foreign Address             State       Benutzer   Inode      PID/Program name
...
...        0      0 0.0.0.0:9000                0.0.0.0:*                   LISTEN      502        1302676    23572/python
...

$ cd parts/instance/
$  python ../../parts/zope2/utilities/zpasswd.py access
Username: veit
Password:
Verify password:
Please choose a format from:

SHA - SHA-1 hashed password (default)
CRYPT - UNIX-style crypt password
CLEARTEXT - no protection

Encoding: SHA
Domain restrictions:

# apt-get install slapd ldapscripts

# /etc/init.d/slapd restart

# ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/ldap/schema/cosine.ldif
# ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/ldap/schema/inetorgperson.ldif
# ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/ldap/schema/nis.ldif

###########################################################
# DATABASE SETUP
###########################################################

# Load modules for database type
dn: cn=module{0},cn=config
objectClass: olcModuleList
cn: module{0}
olcModulePath: /usr/lib/ldap
olcModuleLoad: {0}back_hdb

# Create directory database
dn: olcDatabase={1}hdb,cn=config
objectClass: olcDatabaseConfig
objectClass: olcHdbConfig
olcDatabase: {1}hdb
olcDbDirectory: /var/lib/ldap
olcSuffix: dc=veit-schiele,dc=de
olcRootDN: cn=admin,dc=veit-schiele,dc=de
olcRootPW: 1234
olcAccess: {0}to attrs=userPassword,shadowLastChange by dn="cn=admin,dc=veit-schiele,dc=de" write by anonymous auth by self write by * none
olcAccess: {1}to dn.base="" by * read
olcAccess: {2}to * by dn="cn=admin,dc=veit-schiele,dc=de" write by * read
olcLastMod: TRUE
olcDbCheckpoint: 512 30
olcDbConfig: {0}set_cachesize 0 2097152 0
olcDbConfig: {1}set_lk_max_objects 1500
olcDbConfig: {2}set_lk_max_locks 1500
olcDbConfig: {3}set_lk_max_lockers 1500
olcDbIndex: uid pres,eq
olcDbIndex: cn,sn,mail pres,eq,approx,sub
olcDbIndex: objectClass eq

###########################################################
# DEFAULTS MODIFICATION
###########################################################
# Some of the defaults need to be modified in order to allow
# remote access to the LDAP config. Otherwise only root
# will have administrative access.

dn: cn=config
changetype: modify
delete: olcAuthzRegexp

dn: olcDatabase={-1}frontend,cn=config
changetype: modify
delete: olcAccess

dn: olcDatabase={0}config,cn=config
changetype: modify
add: olcRootPW
olcRootPW: {CRYPT}7hzU8RaZxaGi2

dn: olcDatabase={0}config,cn=config
changetype: modify
delete: olcAccess

# ldapadd -Y EXTERNAL -H ldapi:/// -f db.ldif

# Top level - the organization
dn: dc=veit-schiele,dc=de
objectClass: dcObject
objectclass: organization
o: veit-schiele.de
dc: veit-schiele
description: Top level

# LDAP admin
dn: cn=admin,dc=veit-schiele,dc=de
objectClass: simpleSecurityObject
objectClass: organizationalRole
cn: admin
userPassword: 1234
description: LDAP admin

# ldapadd -x -D cn=admin,dc=veit-schiele,dc=de -W -f base.ldif

ldapsearch -xLLL -b dc=veit-schiele,dc=de

# Second level - organizational units
dn: ou=people, dc=veit-schiele,dc=de
ou: people
description: All people in organisation
objectclass: organizationalunit

dn: ou=groups, dc=veit-schiele,dc=de
ou: groups
description: All groups in the organization
objectclass: organizationalunit

# Third level - people
dn: uid=vschiele,ou=people,dc=veit-schiele,dc=de
objectClass: pilotPerson
objectClass: uidObject
uid: vschiele
cn: Veit Schiele
sn: Schiele
userPassword:: e1NIQX01ZW42RzZNZXpScm9UM1hLcWtkUE9tWS9CZlE9
mail: kontakt@veit-schiele.de

# Third level - groups
dn: cn=Staff,ou=groups,dc=veit-schiele,dc=de
objectClass: top
objectClass: groupOfUniqueNames
cn: Staff
uniqueMember: uid=vschiele,ou=people,dc=veit-schiele,dc=de

# ldapadd -xWD 'cn=admin, dc=veit-schiele,dc=de' -f veit-schiele.ldif

$ ./bin/zopepy
$ import _ldap

$ sudo apt-get install libldap2-dev libsasl2-dev libssl-dev

[buildout]
parts =
    python-ldap
    ...

[python-ldap]
recipe = zc.recipe.egg:custom
eggs = python-ldap
find-links =
include-dirs = /usr/include /usr/lib/sasl2
library-dirs = /usr/lib

setup(name='vs.policy',
    ...
    install_requires=[
        ...
          'plone.app.ldap',
    ],

<?xml version="1.0"?>
<metadata>
    ...
    <dependencies>
        ...
        <dependency>profile-plone.app.ldap:ldap</dependency>
    </dependencies>
</metadata>

"cn=admin,dc=veit-schiele,dc=de"

ou=people,dc=veit-schiele,dc=de

ou=groups,dc=veit-schiele,dc=de

[buildout]
eggs =
    ...
    vs.genericsetup.ldap

[instance]
...
zcml =
    ...
    collective.genericsetup.ldap

# apt-get install libapache2-mod-auth-kerb

# yum install mod_auth_kerb

# LoadModule auth_kerb_module /usr/lib/apache2/modules/mod_auth_kerb.so

# kadmin -p bofh/admin -q "addprinc -randkey HTTP/www.example.com"

# kadmin -p bofh / admin -q "ktadd -k /etc/apache2/http.keytab HTTP / www.example.com"

# chown www-data /etc/apache2/http.keytab

# chown apache /etc/httpd/http.keytab

# kinit -k -t /etc/apache2/http.keytab HTTP/www.example.com
# klist

<VirtualHost 10.0.0.1:80>
    ServerAdmin webmaster@mydomain.com
    ServerName intranet.mydomain.com

    <Location />
        AuthName "Intranet"
        AuthType  Kerberos
        KrbAuthoritative on
        KrbAuthRealms  MYDOMAIN
        KrbServiceName HTTP
        Krb5Keytab /etc/krb5.keytab
        KrbMethodNegotiate on
        KrbMethodK5Passwd off
        KrbSaveCredentials on
        require valid-user
        RequestHeader set X_REMOTE_USER %{remoteUser}e
    </Location>

    RewriteEngine On
    RewriteRule ^/(.*) http://10.0.0.2:8080/VirtualHostBase/http/intranet.mydomain.com:80/portal/VirtualHostRoot/$1 [L,P,E=remoteUser:%{LA-U:REMOTE_USER}]
</VirtualHost>

# service apache2 force-reload

[instance]
…
eggs =
    …
    Products.WebServerAuth

<dtml-var REQUEST>

[buildout]
...
eggs =
    ...
    mr.inquisition

[instance]
...
zcml =
    mr.inquisition

Instance version: 4.3.18
File system version: 5.2

$ python2.7 bootstrap --version 1.5.2

<browser:page
  zcml:condition="installed plone.app.collection"
  name="mycollectionview"
  for="plone.app.collection.interfaces.ICollection"
  class=".views.MyCollectionView"
  permission="zope2.View"/>

<class class="plone.app.collection.collection.Collection"
 zcml:condition="installed plone.app.collection">
 <implements interface=".interfaces.IMyCollectionInterface" />
</class>

from plone.app.querystring import queryparser
query = queryparser.parseFormquery(collectionobj, collectionobj.getRawQuery())

[instance]
eggs +=
    zodbverify
...

$ bin/zodbupdate --convert-py3 --file=var/filestorage/Data.fs --encoding utf8
...
Updating magic marker for var/filestorage/Data.fs
Ignoring index for /Users/pbauer/workspace/projectx/var/filestorage/Data.fs
Loaded 2 decode rules from AccessControl:decodes
Loaded 12 decode rules from OFS:decodes
Loaded 2 decode rules from Products.PythonScripts:decodes
Loaded 1 decode rules from Products.ZopeVersionControl:decodes
Committing changes (#1).

$ ./bin/zodbupdate --convert-py3 --file=var/filestorage/Data.fs --encoding=utf8
Updating magic marker for var/filestorage/Data.fs
loading index
Traceback (most recent call last):
  File "/home/erral/downloads/eggs/ZODB-5.5.1-py3.6.egg/ZODB/FileStorage/FileStorage.py", line 465, in _restore_index
    info = fsIndex.load(index_name)
  File "/home/erral/downloads/eggs/ZODB-5.5.1-py3.6.egg/ZODB/fsIndex.py", line 134, in load
    v = unpickler.load()
UnicodeDecodeError: 'ascii' codec can't decode byte 0x80 in position 249: ordinal not in range(128)

[buildout]

parts =+
    zodbupdate

[zodbupdate]
recipe = zc.recipe.egg
eggs =
    zodbupdate
    ${buildout:eggs}

$ bin/zodbupdate -f var/filestorage/Data.fs

from Products.CMFCore.utils import getToolByName
from StringIO import StringIO
from Products.ATContentTypes.migration.walker import CatalogWalker
from Products.ATContentTypes.migration.migrator import CMFFolderMigrator

class  PhotoAlbumMigrator(CMFFolderMigrator):
    """Base class to migrate PhotoAlbum to Folder.
    """
    walkerClass = CatalogWalker
    src_meta_type = 'PhotoAlbum'
    src_portal_type = 'PhotoAlbum'
    dst_meta_type = 'ATFolder'
    dst_portal_type = 'Folder'

 def migrate(self):
     """Run the migration"""

     out = StringIO()
     print >> out, "Starting migration"

     portal_url = getToolByName(self, 'portal_url')
     portal = portal_url.getPortalObject()

     migrators = (PhotoAlbumMigrator,)

     for migrator in migrators:
         walker = migrator.walkerClass(portal, migrator)
         walker.go(out=out)
         print >> out, walker.getOutput()

     print >> out, "Migration finished"
     return out.getvalue()

class FileMigrator(CMFItemMigrator):
    walkerClass = CatalogWalker
    ...

    def custom(self):
        ctype = self.old.getContentType()
        file = str(self.old)
        self.new.setFile(file, mimetype = ctype)

class LinkMigrator(CMFItemMigrator):
    walkerClass = CatalogWalker
    map = {'remote_url' : 'setRemoteUrl'}

[buildout]
...
eggs =
    ...
    Products.contentmigration

from Products.contentmigration.walker import CustomQueryWalker
from Products.contentmigration.migrator import FieldActionMigrator
from Products.Archetypes.public import *

class MyMigrator(FieldActionMigrator):
    src_portal_type = 'MyType'
    src_meta_type = 'MyType'

    fieldActions = ({'fieldName'    : 'someField',
                     'storage'      : AttributeStorage(),
                     'newFieldName' : 'renamedField',
                     'newStorage'   : AnnotationStorage(),
                     'transform'    : lambda obj, val, **kw: val + 10,
                     })

walker = CustomQueryWalker(portal, migrator,
                           query = {'path' : '/some/path'})
walker.go()

from plone.app.contenttypes.behaviors.collection import ICollection
from plone.dexterity.content import Container
from zope.interface import implementer

@implementer(ICollection)
class FolderishCollection(Container):
    pass

<?xml version="1.0"?>
<object name="Collection" meta_type="Dexterity FTI">
    <property name="klass">my.package.content.FolderishCollection</property>
</object>

tal:attributes="action string:$here_url/${template/getId}"

tal:attributes="action string:${context/@@plone_context_state/object_url}/${template/getId}"

<property name="icon_expr">string:${portal_url}/document_icon.png</property>

from Interface import Interface
class MyInterface(Interface):
    pass

class MyClass(object):
    __implements__ = (MyInterface,)

from zope.interface import Interface
class MyInterface(Interface):
    pass

class MyClass(object):
    implements(MyInterface)

ImportError: No module named Interface

Products.validation.exceptions.FalseValidatorError:
<vs.registration.validators.ProjectIdValidator instance at 0xa92082c>

__implements__= (IValidator,)

from zope.interface import implements
...
try:
   # Plone 4 and higher
    import plone.app.upgrade
    USE_BBB_VALIDATORS = False
except ImportError:
    # BBB Plone 3
    USE_BBB_VALIDATORS = True
...
if USE_BBB_VALIDATORS:
    __implements__ = (ivalidator,)
else:
   implements(IValidator)

Products.CMFPlone.utils.utranslate
Products.PageTemplates.GlobalTranslationService.getGlobalTranslationService

string:${folder_url}/@@add-my-content

msg_type='text/plain'

subtype='plain'

from email import message_from_string
from email.Header import Header
my_message = message_from_string(message_body.encode('utf-8'))
my_message.set_charset('utf-8')
my_message['CC']= Header('someone@example.com')
my_message['BCC']= Header('secret@example.com')
my_message['X-Custom'] = Header(u'Some Custom Parameter', 'utf-8')
mailhost.send(my_message, mto, mfrom, subject)

for="plone.app.portlets.interfaces.IColumn"

<for interface="plone.app.portlets.interfaces.IColumn" />

<for interface="plone.app.portlets.interfaces.IColumn" />
<for interface="plone.app.portlets.interfaces.IDashboard" />

install_requires=[
    'setuptools',
    'Plone',
],

install_requires=[
    'setuptools',
    'Products.CMFPlone',
],

<include package="Products.CMFCore" file="permissions.zcml"
         xmlns:zcml="http://namespaces.zope.org/zcml"
         zcml:condition="have plone-41" />

ImportError: cannot import name DEFAULT_POLICIES

from Products.CMFEditions.setuphandlers import DEFAULT_POLICIES

try:
    from Products.CMFEditions.setuphandlers import DEFAULT_POLICIES
    # we're on plone < 4.1, configure versionable types manually
    setVersionedTypes(portal)
except ImportError:
    # repositorytool.xml will be used
    pass

<?xml version="1.0"?>
<repositorytool>
    <policymap>
        <type name="MyType">
            <policy name="at_edit_autoversion"/>
            <policy name="version_on_revert"/>
        </type>
        <type name="AnotherType">
            <policy name="at_edit_autoversion"/>
            <policy name="version_on_revert"/>
        </type>
    </policymap>
</repositorytool>

<?xml version="1.0"?>
<metadata>
    <description>Policies for www.veit-schiele.de</description>
    <version>1.3</version>
</metadata>

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:five="http://namespaces.zope.org/five"
    xmlns:genericsetup="http://namespaces.zope.org/genericsetup"
    i18n_domain="vs.policy">

    ...

    <!-- Upgrade step for the migration -->
    <genericsetup:upgradeStep
        sortkey="1"
        source="1.0"
        destination="1.1"
        title="Upgrade from 1.0 to 1.1"
        description="Fixes the front page title"
        profile="vs.policy:default"
        handler=".upgrades.v1_0_to_v1_1"
        />

    ...

</configure>

from Products.CMFCore.utils import getToolByName

def v1_0_to_v1_1(portal_setup):
    portal_url = getToolByName(portal_setup, 'portal_url')
    portal = portal_url.getPortalObject()
    front_page = portal['front-page']
    front_page.setTitle('Welcome to Veit Schiele communication design')

<genericsetup:upgradeSteps
    sortkey="2"
    source="1.1"
    destination="1.2"
    profile="vs.policy:default"
    >
    <genericsetup:upgradeStep
        title="Upgrade titles"
        description="Fix all other titles"
        handler=".upgrades.v1_1_to_v1_2a"
        />
    <genericsetup:upgradeStep
        title="Upgrade site title"
        description="Fixes the portal title"
        handler=".upgrades.v1_1_to_v1_2b"
        />
</genericsetup:upgradeSteps>

<genericsetup:registerProfile
      name="1.2_to_1.3"
      title="Migration profile for veit-schiele.de 1.2 to 1.3"
      description=""
      directory="profiles/migrations/v1_2_to_v1_3"
      for="Products.CMFPlone.interfaces.IMigratingPloneSiteRoot"
      provides="Products.GenericSetup.interfaces.EXTENSION"
      />
<genericsetup:upgradeStep
    sortkey="3"
    source="1.2"
    destination="1.3"
    title="Upgrade from 1.2 to 1.3"
    description="Runs a migration profile"
    profile="vs.policy:default"
    handler=".upgrades.v1_2_to_v1_3"
    />

$ python3 -m venv py3env
$ cd py3env
$ ./bin/pip install modernize six

parts += precompiler
...
[precompiler]
recipe = plone.recipe.precompiler
eggs = ${instance:eggs}
compile-mo-files = true

$ bin/buildout -c py3.cfg  install precompiler

$ bin/buildout -c py3.cfg

$ bin/wsgi.py

$ bin/test --all -s my.package

$ bin/test -s my.package -D

classifiers=[
    ...
    "Framework :: Plone :: 5.2",
    ...
    "Programming Language :: Python :: 3.6",
    "Programming Language :: Python :: 3.7",
    "Programming Language :: Python :: 3.8",
    ...
],

if six.PY2 and isinstance(value, six.text_type):
    value = value.encode('utf8')
do_something(value)

from Products.CMFPlone.utils import safe_unicode
...
obj = self.context.unrestrictedTraverse(
    safe_unicode(item['_path'].lstrip('/')), None)

from six import StringIO

from six import BytesIO

portal_types = context.portal_types.objectIds()

print "Orphaned items:"
print

for i in context.portal_catalog.uniqueValuesFor('portal_type'):
   if i in portal_types: continue
   print i
   results = context.portal_catalog(portal_type=i)
   for i in results:
       print i.getURL()
   print
return printed

AttributeError: type object 'IQueue' has no attribute '__iro__'

AttributeError: type object 'ISalt' has no attribute '__iro__'

$ ./bin/instance debug

sm = app.Plone.getSiteManager()

from collective.singing.interfaces import ISalt
from collective.singing.async import IQueue

util_obj = sm.getUtility(ISalt)
sm.unregisterUtility(provided=ISalt)
del util_obj
sm.utilities.unsubscribe((), ISalt)
del sm.utilities.__dict__['_provided'][ISalt]
del sm.utilities._subscribers[0][ISalt]

util = sm.queryUtility(IQueue, name='collective.dancing.jobs')
sm.unregisterUtility(util, IQueue, name='collective.dancing.jobs')
del util
del sm.utilities._subscribers[0][IQueue]

import transaction
transaction.commit()
app._p_jar.sync()

sm = app.Plone.getSiteManager()

adapters = sm.utilities._adapters
for x in adapters[0].keys():
    if x.__module__.find("my.package") != -1:
      print "deleting %s" % x
      del adapters[0][x]
sm.utilities._adapters = adapters

subscribers = sm.utilities._subscribers
for x in subscribers[0].keys():
    if x.__module__.find("my.package") != -1:
      print "deleting %s" % x
      del subscribers[0][x]
sm.utilities._subscribers = subscribers

provided = sm.utilities._provided
for x in provided.keys():
    if x.__module__.find("my.package") != -1:
      print "deleting %s" % x
      del provided[x]
sm.utilities._provided = provided

from transaction import commit
commit()
app._p_jar.sync()

setup_tool = app.Plone.portal_setup
toolset = setup_tool.getToolsetRegistry()
if 'my.package' in toolset._required.keys():
    del toolset._required['my.package']
    setup_tool._toolset_registry = toolset

from transaction import commit
commit()
app._p_jar.sync()

$ ./bin/instance debug

[buildout]
...
extends =
    ...
    lxml.cfg

[lxml]
parts =
   staticlxml
   pylxml

[pylxml]
recipe=zc.recipe.egg
interpreter=pylxml
eggs=
    lxml

[staticlxml]
recipe = z3c.recipe.staticlxml
egg = lxml

$ ./bin/buildout
$ ./bin/instance fg

[buildout]
...
eggs =
    elementtree
    collective.plone.gsxml
    ...

[instance]
...
zcml=
    collective.plone.gsxml
    ...

[instance-base]
eggs +=
    ...
    Products.LinguaPlone
    plone.app.multilingual

[versions]
...
Products.LinguaPlone = 4.1.3
plone.app.multilingual =  2.0.0

try: # for Plone 2.5 and above
    from Products.CMFCore import permissions as CMFCorePermissions
except: # for Plone 2.1
    from Products.CMFCore import CMFCorePermissions

from Products.Archetypes import transaction

import transaction

get_transaction().commit(1)

transaction.commit(1)

from Products.CMFCore.TypesTool import ContentFactoryMetadata

from Products.CMFCore.TypesTool import FactoryTypeInformation

<include package="Products.CMFCore" file="permissions.zcml"
         xmlns:zcml="http://namespaces.zope.org/zcml"
         zcml:condition="have plone-41" />

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:meta="http://namespaces.zope.org/meta">

    <meta:provides feature="plone-4" />
    <meta:provides feature="plone-41" />

</configure>

$ sudo apt-get install git-core

$ sudo port install git-core

$ ./bin/buildout -c migration.cfg

$ ./bin/migration --ploneupload:target=http://admin:secret@localhost:8080/Plone/documentation/manual/plone-nutzerhandbuch

[buildout]
...
migration

[migration]
recipe = funnelweb
crawler-url=file://${buildout:directory}/docs/html
crawler-ignore=
    cgi-bin
    javascript:
    _static
    _sources
    genindex\.html
    search\.html
    saesrchindex\.js
cache-output =
template1-title = text //div[@class='body']//h1[1]
template1-_permalink = text //div[@class='body']//a[@class='headerlink']
template1-text = html //div[@class='body']
template1-_label = optional //p[contains(@class,'admonition-title')]
template1-description = optional //div[contains(@class,'admonition-description')]/p[@class='last']/text()
template1-_remove_useless_links = optional //div[@id = 'indices-and-tables']
templateauto-condition = python:False
titleguess-condition = python:True
indexguess-condition = python:True
hideguess-condition =  python:item.get("_path","").startswith('_images') and item.get('_type')=='Folder'
changetype-value=python:{'Folder':'HelpCenterReferenceManualSection','Document':'HelpCenterLeafPage'}.get(item['_type'],item['_type'])
ploneprune-condition=python:item.get('_type') in ['HelpCenterReferenceManualSection','HelpCenterReferenceManual'] or item['_path'] == ''

import os
import base64

try:
    import json
except ImportError:
    # Python 2.5/Plone 3.3 use simplejson
    import simplejson as json

from Products.Five.browser import BrowserView
from Products.CMFCore.interfaces import IFolderish
from DateTime import DateTime

# Private attributes for the export list
EXPORT_ATTRIBUTES = ["portal_type", "id"]

class ExportFolderAsJSON(BrowserView):
    """
    Exports the current context folder as JSON.
    """

    def convert(self, value):
        """
        Convert value to more JSON friendly format.
        """
        if isinstance(value, DateTime):
            # Zope DateTime
            return value.ISO8601()
        elif hasattr(value, "isBinary") and value.isBinary():
            return None

            # FileField and ImageField payloads are binary
            # as OFS.Image.File object
            data = getattr(value.data, "data", None)
            if not data:
                return None
            return base64.b64encode(data)
        else:
            return value

    def grabData(self, obj):
        """
        Export schema data as dictionary object.
        Binary fields are encoded as BASE64.
        """
        data = {}
        for field in obj.Schema().fields():
            name = field.getName()
            value = field.getRaw(obj)
            print "%s" % (value.__class__)

            data[name] = self.convert(value)
        return data

    def grabAttributes(self, obj):
        data = {}
        for key in EXPORT_ATTRIBUTES:
            data[key] = self.convert(getattr(obj, key, None))
        return data

    def export(self, folder, recursive=False):
        """
        Export content items.
        Possible to do recursively nesting into the children.
        :return: list of dictionaries
        """

    array = []
        for obj in folder.listFolderContents():
            data = self.grabData(obj)
            data.update(self.grabAttributes(obj))

            if recursive:
                if IFolderish.providedBy(obj):
                    data["children"] = self.export(obj, True)
            array.append(data)
        return array

    def __call__(self):
        """
        """
        folder = self.context.aq_inner
        data = self.export(folder)
        pretty = json.dumps(data, sort_keys=True, indent='    ')
        self.request.response.setHeader("Content-type", "application/json")
        return pretty

[buildout]
parts =
    lxml
    server

# Change the number here to change the version of Plone being used
extends =

versions = versions
# Add additional egg download sources here. dist.plone.org contains archives
# of Plone packages.
find-links =

# Add additional eggs here
eggs =

# Reference any eggs you are developing here, one per line
# e.g.: develop = src/my.package
develop =

[versions]
Deliverance = 0.6.0
WebOb = 0.9.8
lxml = 2.2.4

[lxml]
recipe = z3c.recipe.staticlxml
egg = lxml
force = false

[server]
recipe = zc.recipe.egg

eggs =
    lxml
    PasteScript
    Deliverance
interpreter = py

$ ./bin/buildout -c deliverance.cfg
...
Generated script '/home/veit/deliverance_buildout/bin/paster'.
Generated script '/home/veit/deliverance_buildout/bin/deliverance-proxy'.
Generated interpreter '/home/veit/deliverance_buildout/bin/py'.

<server-settings>
    <server>localhost:8000</server>
    <execute-pyref>true</execute-pyref>
    <dev-allow>localhost</dev-allow>
    <dev-user username="admin" password="secret" />
</server-settings>

<proxy path="/static" class="static" editable="1">
    <dest href="{here}/static/" />
</proxy>

<proxy path="/" class="plone">
    <dest href="http://localhost:8080/VirtualHostBase/http/localhost:8000/Plone/VirtualHostRoot/" />
</proxy>

$ ./bin/deliverance-proxy rules.xml

$ /usr/bin/nohup ./bin/deliverance-proxy rules.xml &

<rule class="static" />
<rule class="plone" suppress-standard="true">

<rule class="news-section">
    <theme href="/static/news.html" />

<match path="regex:^/news" class="news-section" />

<rule>
    <replace content="children:/html/head/title"
             theme="children:/html/head/title" nocontent="ignore" />
    <append content="elements:/html/head/link"
            theme="children:/html/head" nocontent="ignore" />
    <append content="elements:/html/head/script"
            theme="children:/html/head" nocontent="ignore" />
    <append content="elements:/html/head/style"
            theme="children:/html/head" nocontent="ignore" />
</rule>

<theme href="/static/index.html" />

<replace content='/html/head/title' theme='/html/head/title' />

<append content='/html/head/base' theme='children:/html/head' />

<prepend content='dl.portletNavigationTree' theme='children:#rightbar' />

<drop content='#user-name img' />

content="#content || children:body"

<replace if-content='body.section-news' content='children:dl.portletEvents dt.portletHeader a' theme='children:#rightbar h2' />

<append href="http://twitter.com/plone"
        content="#timeline"
        theme='#rightbar' />

<drop if-content="not(//*[@class='portlet'])" css:theme="#portlet-wrapper" />

<rules css:if-content="#personal-bar">
    <append css:theme="#header-box" css:content="#user-prefs"/>
    <append css:theme="#header-box" css:content="#logout"/>
</rules>

<rules if-content="condition1">
    <rules if-content="condition2">
        <copy if-content="condition3" css:theme="#a" css:content="#b"/>
    </rules>
</rules>

<copy if-content="(condition1) and (condition2) and (condition3)" css:theme="#a" css:content="#b"/>

<theme href="theme.html"/>
<theme href="news.html" css:if-content="body.section-news"/>
<theme href="members.html" css:if-content="body.section-members"/>

<rules css:if-content="body.section-news">
    <theme href="news.html"/>
    <copy css:content="h2.articleheading" css:theme="h1"/>
</rules>

<theme href="news.html" if-path="/news"/>

<theme href="news.html" if-path="/news/"/>

<append css:content="#timeline"
        href="http://www.heise.de/newsticker/classic/"
        css:theme="#rightbar" />

[buildout]
...
extends =
    http://dist.plone.org/release/4.1b2/versions.cfg
    http://good-py.appspot.com/release/plone.app.theming/1.0b5

find-links =
    http://dist.plone.org/release/4.1b2/
    ...

versions = versions

...
eggs =
    ...
    plone.app.theming

$ ./bin/buildout
...
$ ./bin/instance fg

$ cd plone.app.theming_buildout
$ curl -O http://www.oswd.org/files/designs/3293/Invention.zip
$ unzip Invention.zip

Invention/rules.xml

python://vs.theme/static/rules.xml

<replace theme='//*[@id="leftbar"]' content='//*[@id="content"]' />

//*[@id="content"]

/html/body/div/div[2]/h2

<replace theme="/html/head/title" content="/html/head/title" />
<replace theme="/html/head/base" content="/html/head/base" />

<append theme='/html/head' content='/html/head/script' />
<append theme="/html/head" content="/html/head/link | /html/head/style" />

<prepend theme="/html/body" content="/html/body/@class" />

<append content='//*[@id="portal-column-one"]/div' theme='//*[@id="rightbar"]' />
<append content='//*[@id="portal-column-two"]/div' theme='//*[@id="rightbar"]' />

<copy content='//*[@id="portal-globalnav"]/li' theme='//*[@id="main-nav"]' />

<drop content='//*[@id="user-name"]/img' />

$ cd src/
$ paster create -t plone vs.diazotheme
 ...
Register Profile (Should this package register a GS Profile) [False]: True
...

[buildout]
...
develop =
    ...
    src/vs.diazotheme
...
[instance]
...
eggs =
    ...
    vs.diazotheme
zcml =
    ...
    vs.diazotheme

<plone:static
    type="theme"
    directory="Invention" />

$ cd vs.diazotheme/vs/diazotheme/
$ curl -O http://www.oswd.org/files/designs/3293/Invention.zip
$ unzip -v Invention.zip

[theme]
title = vs.diazotheme
description = A diazo theme for veit schiele communications
rules = /++theme++vs.diazotheme/rules.xml

[theme:parameters]
ajax_load = python: 'ajax_load' in request.form

<registry>

    <!-- plone.app.theming settings -->
    <record field="enabled" interface="plone.app.theming.interfaces.IThemeSettings">
        <value>True</value>
    </record>
    <record field="rules" interface="plone.app.theming.interfaces.IThemeSettings">
        <value>/++theme++vs.diazotheme/rules.xml</value>
    </record>
    <record field="absolutePrefix" interface="plone.app.theming.interfaces.IThemeSettings">
        <value>/++theme++vs.diazotheme</value>
    </record>
</registry>

/++resource++vs.diazotheme

<?xml version="1.0"?>
<object name="portal_css">

    <!-- Set conditions on stylesheets we don't want to pull in -->
    <stylesheet
        expression="not:request/HTTP_X_THEME_ENABLED | nothing"
        id="public.css"
    />

    <!-- Add new stylesheets -->

    <stylesheet title="" authenticated="False" cacheable="True"
        compression="safe" conditionalcomment="" cookable="True" enabled="on"
        expression="request/HTTP_X_THEME_ENABLED | nothing"
        id="++theme++vs.diazotheme/css/style.css" media="" rel="stylesheet"
        rendering="link"
        applyPrefix="True"
    />

</object>

<metadata>
    <version>1</version>
    <dependencies>
        <dependency>profile-plone.app.theming:default</dependency>
    </dependencies>
</metadata>

$ DIAZO_ALWAYS_CACHE_RULES=1 ./bin/instance fg

http://localhost:8080/mysite/frontpage?diazo.off=1

http://localhost:8080/mysite/front-page?diazo.debug=1

<rules css:if-content="#visual-portal-wrapper xml:id="r0">
    <drop css:theme="content" xml:id="r1"/>
    <append css:theme="content" xml:id="r2">
        <xsl:message>Some content</xsl:message>
    </append>
    ...
</rules>

<rules
    xmlns="http://namespaces.plone.org/xdv"
    xmlns:css="http://namespaces.plone.org/xdv+css"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    ...
</rules>

<rules
    xmlns="http://namespaces.plone.org/diazo"
    xmlns:css="http://namespaces.plone.org/diazo/css"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    ...
</rules>

<drop if-content="not(//*[@class='portlet'])" css:theme="#portlet-wrapper" />

<rules css:if-content="#personal-bar">
    <append css:theme="#header-box" css:content="#user-prefs"/>
    <append css:theme="#header-box" css:content="#logout"/>
</rules>

<rules if-content="condition1">
    <rules if-content="condition2">
        <copy if-content="condition3" css:theme="#a" css:content="#b"/>
    </rules>
</rules>

<copy if-content="(condition1) and (condition2) and (condition3)" css:theme="#a" css:content="#b"/>

<theme href="theme.html"/>
<theme href="news.html" css:if-content="body.section-news"/>
<theme href="members.html" css:if-content="body.section-members"/>

<rules css:if-content="body.section-news">
    <theme href="news.html"/>
    <copy css:content="h2.articleheading" css:theme="h1"/>
</rules>

<theme href="news.html" if-path="/news"/>

<theme href="news.html" if-path="/news/"/>

<append css:content="#timeline"
        href="/http://twitter.com/plone"
        css:theme="#rightbar" />

[buildout]
...
extends =
    http://dist.plone.org/release/3.3.5/versions.cfg
    lxml.cfg
    http://good-py.appspot.com/release/collective.xdv/1.0?plone=3.3.5

versions = versions

...
eggs =
    ...
    collective.xdv [Zope2.10]

[versions]
zope.i18n = 3.7.2

eggs =
    ...
    collective.xdv

[lxml]
parts =
   staticlxml
   pylxml

[pylxml]
recipe=zc.recipe.egg
interpreter=pylxml
eggs=
    lxml

[staticlxml]
recipe = z3c.recipe.staticlxml
egg = lxml

$ ./bin/buildout
...
We have the distribution that satisfies 'collective.xdv[zope2.10]==1.0rc11'.
Getting required 'collective.directoryresourcepatch==1.0'
We have the distribution that satisfies 'collective.directoryresourcepatch==1.0'.
Getting required 'ZPublisherEventsBackport==1.1'
We have the distribution that satisfies 'ZPublisherEventsBackport==1.1'.
Getting required 'five.globalrequest==1.0'
We have the distribution that satisfies 'five.globalrequest==1.0'.
Getting required 'repoze.xmliter==0.1'
We have the distribution that satisfies 'repoze.xmliter==0.1'.
Getting required 'plone.transformchain==1.0b1'
We have the distribution that satisfies 'plone.transformchain==1.0b1'.
Getting required 'plone.subrequest==1.3'
We have the distribution that satisfies 'plone.subrequest==1.3'.
Getting required 'plone.app.registry==1.0b2'
We have the distribution that satisfies 'plone.app.registry==1.0b2'.
Getting required 'lxml==2.2.4'
We have the distribution that satisfies 'lxml==2.2.4'.
Getting required 'xdv==0.4b2'
We have the distribution that satisfies 'xdv==0.4b2'.
...

$ ./bin/instance fg

$ cd collective-xdv_buildout
$ curl -O http://www.oswd.org/files/designs/3293/Invention.zip
$ unzip Invention.zip

Invention/index.html

python://vs.xdvtheme/static/index.html

Invention/rules.xml

python://vs.xdvtheme/static/rules.xml

^.*/manage$

<replace theme='//*[@id="leftbar"]' content='//*[@id="content"]' />

//*[@id="content"]

/html/body/div/div[2]/h2

<replace theme="/html/head/title" content="/html/head/title" />
<replace theme="/html/head/base" content="/html/head/base" />

<append theme='/html/head' content='/html/head/script' />
<append theme="/html/head" content="/html/head/link | /html/head/style" />

<prepend theme="/html/body" content="/html/body/@class" />

<append content='//*[@id="portal-column-one"]/div' theme='//*[@id="rightbar"]' />
<append content='//*[@id="portal-column-two"]/div' theme='//*[@id="rightbar"]' />

<copy content='//*[@id="portal-globalnav"]/li' theme='//*[@id="main-nav"]' />

<drop content='//*[@id="user-name"]/img' />

$ cd src/
$ paster create -t plone vs.xdvtheme
 ...
Register Profile (Should this package register a GS Profile) [False]: True
...

[buildout]
...
eggs =
    ...
    vs.xdvtheme

develop =
    ...
    src/vs.xdvtheme
...
[instance]
...
zcml =
vs.xdvtheme

<browser:resourceDirectory
    name="vs.xdvtheme" directory="Invention"  />

$ cd vs.xdvtheme/vs/xdvtheme/
$ curl -O http://www.oswd.org/files/designs/3293/Invention.zip
$ unzip -v Invention.zip

<registry>

    <!-- collective.xdv settings -->
    <record field="enabled" interface="collective.xdv.interfaces.ITransformSettings">
        <field type="plone.registry.field.Bool">
            <title>Enabled</title>
        </field>
        <value>True</value>
    </record>
    <record interface="collective.xdv.interfaces.ITransformSettings" field="domains">
        <value>
            <element>localhost:8080</element>
        </value>
    </record>
    <record interface="collective.xdv.interfaces.ITransformSettings" field="rules">
        <value>python://vs.xdvtheme/Invention/rules.xml</value>
    </record>
    <record interface="collective.xdv.interfaces.ITransformSettings" field="theme">
        <value>python://vs.xdvtheme/Invention/index.html</value>
    </record>
    <record interface="collective.xdv.interfaces.ITransformSettings" field="absolute_prefix">
        <value>/++resource++vs.xdvtheme</value>
    </record>
</registry>

<?xml version="1.0"?>
<object name="portal_css">

 <!-- Set conditions on stylesheets we don't want to pull in -->
 <stylesheet
     expression="not:request/HTTP_X_XDV | nothing"
     id="public.css"
     />

 <!-- Add new stylesheets -->

 <stylesheet title="" authenticated="False" cacheable="True"
    compression="safe" conditionalcomment="" cookable="True" enabled="on"
    expression="request/HTTP_X_XDV | nothing"
    id="++resource++vs.xdvtheme/css/style.css" media="" rel="stylesheet"
    rendering="link"
    applyPrefix="True"
    />

</object>

<metadata>
    <version>1</version>
    <dependencies>
        <dependency>profile-collective.xdv:default</dependency>
    </dependencies>
</metadata>

$ mkdir diazo

$ cd diazo
$ curl -O http://svn.zope.org/*checkout*/zc.buildout/trunk/bootstrap/bootstrap.py

[buildout]
# Adjust the version number as required. See
# http://good-py.appspot.com/release/diazo for a full list

extends = http://good-py.appspot.com/release/diazo/1.0rc4
versions = versions

parts =
    lxml
    diazo

[diazo]
recipe = zc.recipe.egg
eggs =
    diazo [wsgi]
    PasteScript

[lxml]
recipe = z3c.recipe.staticlxml
egg = lxml

$ python2.6 bootstrap.py

$ bin/buildout

[server:main]
use = egg:Paste#http
host = 0.0.0.0
port = 8000

[composite:main]
use = egg:Paste#urlmap
/static = static
/ = default

[app:static]
use = egg:Paste#static
document_root = %(here)s/theme

[pipeline:default]
pipeline = theme
           content

[filter:theme]
use = egg:diazo
rules = %(here)s/rules.xml
prefix = /static
debug = true

[app:content]
use = egg:Paste#proxy
address = http://127.0.0.1:8080/VirtualHostBase/http/127.0.0.1:8000/Plone

<rules
    xmlns="http://namespaces.plone.org/diazo"
    xmlns:css="http://namespaces.plone.org/diazo/css"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <theme href="theme/theme.html" />

  <prepend theme="//head" content="//head/base"
           nocontent="ignore" />
  <prepend theme="//head" content="//head/link"
           nocontent="ignore" />
  <prepend theme="//head" content="//head/style"
           nocontent="ignore" />
  <append theme="//head" content="//head/script"
          nocontent="ignore" />
  <append theme="//head" content="//head/meta"
          nocontent="ignore" />

  <replace css:theme="title"
           css:content="title"
           nocontent="ignore" />
  <copy css:theme="div.container"
        css:content="body > *"
        nocontent="ignore" />

</rules>

<!DOCTYPE html>
<html>
  <head>
    <title>Dummy title</title>
    <link rel="stylesheet"
          href="./screen.css"
          type="text/css"
          media="screen, projection" />
    <link rel="stylesheet"
          href="./print.css"
          type="text/css"
          media="print" />
    <!--[if IE]>
    {% compress css %}
    <link rel="stylesheet"
          href="./ie.css"
          type="text/css"
          media="screen, projection" />
    {% endcompress %}
    <![endif]-->
  </head>
  <body>
    <div class="container">
      <h1>Dummy Headline</h1>
      <p>Sample content</p>
    </div>
  </body>
</html>

$ ./bin/paster serve --reload proxy.ini

<theme href="theme/theme.html" />

<theme href="theme/theme.html" />
<notheme css:if-content="body.template-file_view" />

<replace theme="/html/head/title" content="/html/head/title" />
<replace theme="/html/head/base" content="/html/head/base" />

<append theme='/html/head' content='/html/head/script' />
<append theme="/html/head" content="/html/head/link | /html/head/style" />

<prepend theme="/html/body" content="/html/body/@class" />

<append content='//*[@id="portal-column-one"]/div' theme='//*[@id="rightbar"]' />
<append content='//*[@id="portal-column-two"]/div' theme='//*[@id="rightbar"]' />

<copy content='//*[@id="portal-globalnav"]/li' theme='//*[@id="main-nav"]' />

<drop content='//*[@id="user-name"]/img' />

<strip css:theme="#content" />

<strip css:content="#main-area .wrapper" />
<replace css:theme="#content-area" css:content="#main-area" />

<merge attributes="class" css:theme="body" css:content="body" />

<drop css:content="#viewlet-social-like"/>
<replace method="raw"
    css:theme-children="#viewlet-social-like"
    css:content="#viewlet-social-like"
    />

<merge attributes="class" css:theme="body" css:content="body" />

<replace css:theme="#header" content="#header-element" if-content="" />

<drop css:theme="#portlet-wrapper" css:if-not-content=".portlet"/>

<drop css:theme="#news-box" if-not-path="/news"/>

<copy
    if-path="/somewhere"
    css:theme="#content"
    css:content="body > *"
    />

if-path="/somewhere/"

if-path="somewhere/"

if-path="somewhere"

<drop css:theme=".warning" if="$mode = 'anon-personalbar'" />

<rules xmlns="http://namespaces.plone.org/diazo"
       xmlns:css="http://namespaces.plone.org/diazo/css"
       xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <rules css:if-content="#personal-bar">
        <after css:theme-children="#header-box" css:content="#user-prefs"/>
        <after css:theme-children="#header-box" css:content="#logout"/>
    </rules>
    …
</rules>

<rules if="condition1">
    <rules if="condition2">
        <copy if="condition3" css:theme="#a" css:content="#b"/>
    </rules>
</rules>

<copy if="(condition1) and (condition2) and (condition3)" css:theme="#a" css:content="#b"/>

<theme href="theme.html"/>
<theme href="news.html" css:if-content="body.section-news"/>
<theme href="members.html" css:if-content="body.section-members"/>

<xsl:strip-space elements="*" />
<xsl:output indent="yes"/>

<after theme-children="/html/head">
    <style type="text/css">
        /* From the rules */
        body > h1 { color: red; }
    </style>
</after>

<replace css:theme="#details">
    <dl id="details">
        <xsl:for-each css:select="table#details > tr">
            <dt><xsl:copy-of select="td[1]/text()"/></dt>
            <dd><xsl:copy-of select="td[2]/node()"/></dd>
        </xsl:for-each>
    </dl>
</replace>

<replace css:content="div#portal-searchbox input.searchButton">
    <button type="submit">
        <img src="images/search.png" alt="Search" />
    </button>
</replace>

<drop content="p[not(*) and (not(normalize-space()) or text() = '&#160;')]"/>

<replace css:theme="#account a.dropdown-toggle"
         css:content="#portal-personaltools li#anon-personalbar a" />
<before css:theme-children="#account a.dropdown-toggle"
        method="raw">
    <i class="icon-user"></i>
</before>

<replace css:content-children="#content" css:theme-children="#content"/>
<before css:theme-children="#content">
    <div id="wrapper">
      <xsl:apply-templates css:select="#title" mode="raw"/>
      <xsl:apply-templates css:select="#description" mode="raw"/>
    </div>
</before>
<drop css:content="#title"/>
<drop css:content="#description"/>

<xsl:template match="ul[@id='portal-globalnav']/li/@class[contains(., 'selected')]">
    <xsl:attribute name="class"><xsl:value-of select="." /> current-menu-item</xsl:attribute>
</xsl:template>

<replace css:theme="#content" css:content="#content" />
<xsl:template match="img/@src[not(contains(., '@@'))]">
    <xsl:attribute name="src"><xsl:value-of select="." />/@@/images/image/thumb</xsl:attribute>
</xsl:template>

<img src="smiley.gif" class="myimage" />

<img src="smiley.gif/@@/images/image/thumb" class="myimage" />

<replace css:theme="#content"
         css:content="#content" />
<xsl:template match="h2/text()">
     <xsl:copy /> – Extra text
</xsl:template>

<rules
    …
    xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:include href="base.xml" />
</rules>

<replace  css:theme-children="#navigation ul.dropdown-menu li a"
          css:content-children=".navTreeLevel2  > li > div"
          href="/sitemap" />

[filter:theme]
use = egg:collective.diazo.readheaders
#You can use any other Diazo middleware options here, too!
read_network = True

<xsl:template match="activity|add-profile-tab|bookmark|comments|friendpile|like|like-box|live-stream|login-button|pronoun|recommendations|serverFbml|profile-pic|user-status">
  <xsl:element name="fb:{local-name()}" xmlns:fb="http://www.facebook.com/2008/fbml">
    <xsl:apply-templates select="@*|node()"/>
  </xsl:element>
</xsl:template>

<xsl:output
    doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"
    doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"/>

var common_content_filter = '#content>*:not(div.configlet),dl.portalMessage.error,dl.portalMessage.info';

$ ./configure --with-http_xslt_module

location / {
    xslt_stylesheet /etc/nginx/theme.xsl
        path='$uri'
        ;
    xslt_html_parser on;
    xslt_types text/html;
    rewrite ^(.*)$ /VirtualHostBase/http/localhost/Plone/VirtualHostRoot$1 break;
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Diazo "true";
    proxy_set_header Accept-Encoding "";
}

sub vcl_fetch {
    if (obj.http.Content-Type ~ "text/html") {
        esi;
    }
}

NameVirtualHost *
LoadModule transform_module /usr/lib/apache2/modules/mod_transform.so
<VirtualHost *>

    FilterDeclare THEME
    FilterProvider THEME XSLT resp=Content-Type $text/html

    TransformOptions +ApacheFS +HTML +HideParseErrors
    TransformSet /theme.xsl
    TransformCache /theme.xsl /etc/apache2/theme.xsl

    <LocationMatch "/">
        FilterChain THEME
    </LocationMatch>

</VirtualHost>

<before css:content="head link" css:theme="head link" />

<before css:content="head link" theme="/head/link[1]" />

$ bin/diazocompiler -r rules.xml -o compiled.xsl
$ xsltproc --timing --repeat --html --noout compiled.xsl mypage.html
Parsing stylesheet compiled.xsl took 1 ms
Parsing document mypage.html took 26 ms
Applying stylesheet 20 times took 197 ms

# apt-get install libexpat1-dev erlang

[ejabberd]
recipe = rod.recipe.ejabberd
erlang-path = /usr/bin
url = http://www.process-one.net/downloads/ejabberd/2.1.8/ejabberd-2.1.8.tar.gz

[ejabberd.cfg]
recipe = collective.recipe.template
input = templates/ejabberd.cfg.in
output = ${buildout:directory}/etc/ejabberd.cfg
xmppdomain = localhost
pubsub_max_items_node = 1000
admin_userid = admin
collaboration_allowed_subnet = 0,0,0,0
collaboration_port = 5347
component_password = secret

# apt-get install pcre-devel

[nginx]
recipe = zc.recipe.cmmi
url = http://nginx.org/download/nginx-1.0.8.tar.gz
md5sum = 1049e5fc6e80339f6ba8668fadfb75f9

[nginx-conf]
recipe = gocept.nginx
configuration =
  worker_processes 1;
  daemon off;
  events {
    worker_connections 1024;
  }
  http {
    proxy_read_timeout 400;
    server {
        listen       8080;
        server_name  localhost;

        location ~ ^/http-bind {
            proxy_pass http://localhost:5280;
        }

        location / {
           proxy_pass http://localhost:8081/VirtualHostBase/http/localhost:8080/Plone/VirtualHostRoot/;
       }

   }
 }

$ ./bin/ejabberdctl restart
$ ./bin/nginx  start
$ ./bin/instance start

[supervisor]
recipe = zc.recipe.egg
eggs = supervisor

[supervisor-conf]
recipe = collective.recipe.template
input = ${buildout:directory}/templates/supervisord.conf.in
output = ${buildout:directory}/etc/supervisord.conf

$ ./bin/supervisord

function chatMessageReceived {
    alert(Reviewved a message stanza);
    return true;
}
connection.addHandler(chatMessageReceived, null, 'message', 'chat');

var message = $msg({
            to: "someone@jabber.plone.org",
            type: "chat"
        }).c("body").t("Welcome to the plone chat");

<message to="someone@jabber.plone.org"
         type="chat">
    <body>Welcome to the plone chat</body>
</message>

ChatBox = Backbone.Modeol.extend({
    initialize: function () {
        this.set ({
            'jid' : Strophe.getNodeFromJid(this.get('jid')),
            'box_id' : this.get('id'),
            'fullname' : this.get('fullname'),
        });
    }
});

var box = new ChatBox({'id': hex_sha1(jid), 'jid': jid, 'fullname': name});

ChatBoxView = Backbone.View.extend({
    tagName: 'div',
    className: 'chatbox',
    events: {'keypress textareea.chat-textarea': keyPressed'};
    template: _.template(
        '<div class="chat-title"> {{fullname}} </div>' +
        '<div class="chat-content"></div>' +
        '<form class="sendXMPPMessage" method="post">' +
            '<textarea type="text" class="chat-area" />' +
        '</form>'),
    render: function() {
        $(this.el).html(this.template(this.model.toJSON()));
            return this;
    },
    keyPressed: function (ev) {
        ...
    }
});

[buildout]
extends = http://dist.plone.org/release/4.1-latest/versions.cfg
parts =
   instance
   paster
   wsgiconfig

[instance]
recipe = plone.recipe.zope2instance
eggs =
    Plone
    PIL
user = admin:admin

[paster]
recipe = zc.recipe.egg
eggs =
    ${instance:eggs}
    Paste
    PasteScript
    repoze.tm2
    repoze.retry
script = paster

[wsgiconfig]
recipe = collective.recipe.template
input = inline:
    [app:zope]
    use = egg:Zope2#main
    zope_conf = ${buildout:directory}/parts/instance/etc/zope.conf

    [pipeline:main]
    pipeline =
        egg:paste#evalerror
        egg:repoze.retry#retry
        egg:repoze.tm2#tm
        zope

    [server:main]
    use = egg:paste#http
    host = localhost
    port = 8000
output = ${buildout:directory}/zope2.ini

$ ./bin/paster serve zope2.ini

use = egg:infrae.wsgi#zope2

use = egg:gunicorn#main

debug = True

[pipeline:main]
pipeline = egg:Paste#cgitb
           egg:Paste#httpexceptions
#           egg:Paste#translogger
           egg:repoze.retry#retry
           egg:repoze.tm#tm
           egg:repoze.vhm#vhm_xheaders
           errorlog
           zope2

egg:Paste#evalerror

$ sudo easy_install Deliverance

[pipeline:main]
pipeline = egg:Paste#cgitb
           egg:Paste#httpexceptions
#           egg:Paste#translogger
           egg:repoze.retry#retry
           egg:repoze.tm#tm
           egg:repoze.vhm#vhm_xheaders
           errorlog
           deliverance
           zope2

[filter:deliverance]
paste.filter_app_factory = deliverance.wsgimiddleware:make_filter
theme_uri = http://www.veit-schiele.de/frontpage
rule_uri = file:///%(here)s/rules.xml

<?xml version="1.0" encoding="UTF-8"?>
<rules xmlns:xi="http://www.w3.org/2001/XInclude" xmlns="http://www.plone.org/deliverance">
  <prepend theme="//head" content="//head/link" nocontent="ignore" />
  <prepend theme="//head" content="//head/style" nocontent="ignore" />
  <append theme="//head" content="//head/script" nocontent="ignore" />
  <append theme="//head" content="//head/meta" nocontent="ignore" />
  <append-or-replace theme="//head"
                     content="//head/title"
                     nocontent="ignore" />
  <replace theme="//body//div[@id='content']"
           content="//body//div[@id='content']"
           nocontents="ignore" />
</rules>

$ ./bin/paster serve etc/zope2.ini

[buildout]
parts =
    solr-download
    solr-instance

[versions]
collective.recipe.solrinstance = 3.5
gocept.download = 0.9.5

[solr-download]
recipe = hexagonit.recipe.download
download-directory = parts/solr-download
strip-top-level-dir = true
url = http://ftp-stud.hs-esslingen.de/pub/Mirrors/ftp.apache.org/dist//lucene/solr/3.4.0/apache-solr-3.4.0.tgz
ignore-existing = true

solr-instance]
recipe = collective.recipe.solrinstance
solr-location = ${solr-download:location}
host = 83.223.91.163
port = 8983
basepath = search

${solr-download:location}

$host:$port/$basepath

$ ./bin/solr-instance fg

$ ./bin/solr-instance start

logdir = ${buildout:directory}/var/solr
logging-template = ${buildout:directory}/templates/logging.properties.tmpl

${buildout:directory}/var/solr

${buildout:directory}/templates/logging.properties.tmpl

# Default global logging level:
.level= INFO

max-num-results = 500
section-name = SOLR
unique-key = id
default-search-field = text
filter =
    text solr.StopFilterFactory ignoreCase="true" words="stopwords.txt"
    text solr.WordDelimiterFilterFactory generateWordParts="1" generateNumberParts="1" catenateWords="0" catencatenateAll="0"
    text solr.LowerCaseFilterFactory
    text solr.RemoveDuplicatesTokenFilterFactory

index =
    name:text             type:text    stored:true
    name:title            type:text    stored:true
    name:created          type:date    stored:true required:true
    name:modified         type:date    stored:true
    name:filesize         type:integer stored:true
    name:mimetype         type:string  stored:true
    name:id               type:string  stored:true required:true
    name:relpath          type:string  stored:true
    name:fullpath         type:string  stored:true
    name:renderurl        type:string  stored:true
    name:tag              type:string  stored:true

[instance]
…
eggs =
    …
    …alm.solrindex

[buildout]
…
extensions =
   mr.developer
sources = sources
auto-checkout =
    bg.solr

[sources]
bg.solr = git https://github.com/zopyx/bg.solr

[instance]
…
eggs =
   …
   bg.solr

$ easy_install bg.crawler

$ ./bin/solr-crawler --help

install_requires=[
    'setuptools',
    ...
    'archetypes.schemaextender',
],

from plone.theme.interfaces import IDefaultPloneLayer

class IVSRegistrationExtenderLayer(IDefaultPloneLayer):
    """A Layer Specific to VSRegistrationExtender"""

<layers>
    <layer name="vs.registration"
           interface="vs.registration.interfaces.IVSRegistrationExtenderLayer" />
</layers>

$ mkdir extender
$ touch extender/__init__.py

<include package=".extender" />

<include package="archetypes.schemaextender" />
<adapter factory=".teaser.TeaserExtender"
         provides="archetypes.schemaextender.interfaces.ISchemaExtender"
         for="Products.ATContentTypes.interfaces.IATEvent" />

class TeaserExtender(object):
    """ teaser fields """

    implements(ISchemaExtender, IBrowserLayerAwareExtender)
    # bind this extender to the browser layer
    layer = VSRegistrationExtenderLayer
    fields = [TeaserField('teaserImage',
                            default=False,
                            storage = AnnotationStorage(migrate=True),
                            swallowResizeExceptions=zconf.swallowImageResizeExceptions.enable,
                            pil_quality=zconf.pil_config.quality,
                            pil_resize_algo=zconf.pil_config.resize_algo,
                            max_size=config.TEASER_MAX_DIMENSION,
                            sizes=config.TEASER_SIZES,
                            widget=atapi.ImageWidget(
                                label=u"Teaser image",
                                label_msgid='label_teaser_image',
                                i18n_domain='plone',
                                ),
                             schemata='Teaser',
                             ),
            ]

    def __init__(self, context):
        self.context = context

    def getFields(self):
        return self.fields

<adapter
    factory=".extender.VSRegistrationExtender"
    provides="archetypes.schemaextender.interfaces.IOrderableSchemaExtender" />

from archetypes.schemaextender.interfaces import IOrderableSchemaExtender, IBrowserLayerAwareExtender
...
class TeaserExtender(object):
    implements(IOrderableSchemaExtender, IBrowserLayerAwareExtender)
    ...
    def fiddle(object, schema):
    def getOrder(self, order):
        do = order['default']

        # place teaser at the very top
        do.remove('teaser')
        do.insert(0, 'teaser')
        return order

<adapter
    factory=".teaser.TeaserExtender"
    provides="archetypes.schemaextender.interfaces.ISchemaModifier" />

from archetypes.schemaextender.interfaces import IOrderableSchemaExtender, IBrowserLayerAwareExtender, ISchemaModifier
...
def fiddle(object, schema):
    schema['image'].widget.visible = {'edit':'invisible','view':'invisible'}
    return schema

$ mkdir vs.theme/vs/theme/adapters
$ touch vs.theme/vs/theme/adapters/__init__.py

<include package=".adapters" />

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:five="http://namespaces.zope.org/five"
    xmlns:cmf="http://namespaces.zope.org/cmf"
    xmlns:i18n="http://namespaces.zope.org/i18n"
    i18n_domain="vs.theme">
  <adapter name="hasTeaserImage" factory=".indexer.hasTeaserImageDocument" />
</configure>

from plone.indexer import indexer
from Products.ATContentTypes.interfaces import ITextContent

def _hasTeaserImage(obj, fieldname):
    """ generic wrapper """
    field = obj.getField(fieldname)
    if field is None:
        return False
    img = field.get(obj)
    img_data = str(img.data)
    return len(img_data) > 0

@indexer(ITextContent)
    def hasTeaserImageDocument(obj):
    """ Returns True/False if an teaser image exists or not """
    return _hasTeaserImage(obj, 'teaserImage')

...
install_requires=[
    'setuptools',
    'z3c.jbot',
    ...
],
...

<configure
    ...
    xmlns:browser="http://namespaces.zope.org/browser">
...
<include package="z3c.jbot" file="meta.zcml" />
...
<browser:jbot
 directory="overrides"
 layer=".interfaces.IThemeSpecific"
 />

<?xml version="1.0"?>
<layers>
    <layer name="vs.theme"
           interface="vs.theme.interfaces.IThemeSpecific" />
</layers>

from plone.theme.interfaces import IDefaultPloneLayer
from plone.portlets.interfaces import IPortletManager

class IThemeSpecific(IDefaultPloneLayer):
    """Marker interface that defines a Zope 3 browser layer.
    """

<td>
    <img tal:condition="obj/hasTeaserImage"
         tal:attributes="src string:${obj/getURL}/@@teaserImage?scale=teaser"
         class="teaserImage"
         />
    <div class="teaserText"
         tal:condition="obj/teaserText"
         tal:content="structure obj/teaserText" />
</td>

<table class="listing"
       summary="Content listing"
       i18n:attributes="summary summary_content_listing;">
    <thead>
        <tr tal:condition="options/with_teaser  | request/with_teaser | nothing" >
        ...
        <td tal:condition="options/with_teaser | request/with_teaser | nothing">
            <tal:if condition="obj/hasTeaserImage">
                <a tal:attributes="href obj/getURL">
                    <img tal:condition="obj/hasTeaserImage"
                        tal:attributes="src string:${obj/getURL}/@@teaserImage?scale=teaser"
                        class="teaserImage"
                    />
                </a>
            </tal:if>
            <tal:if condition="not: obj/hasTeaserImage">
                <div class="title" tal:content="obj/Title" />
                <div class="description" tal:content="obj/Description" />
                <a tal:attributes="href obj/getURL"
                   i18n:translate="label_more">
                    more
                </a>
            </tal:if>
        </td>

from Products.Five.browser import BrowserView

class TopicTeaserView(BrowserView):
    """ Topic table view with teaser """

    def __call__(self):
        view = self.context.restrictedTraverse('atct_topic_view')
        return view(with_teaser=True)

<browser:page
  name="atct_topic_teaser_view"
  for="Products.ATContentTypes.interfaces.topic.IATTopic"
  permission="zope2.View"
  class=".topic.TopicTeaserView"
  />

<include package="plone.app.contentmenu" />
...
<browser:menuItem
  for="Products.ATContentTypes.interfaces.topic.IATTopic"
    menu="plone_displayviews"
    title="Collection with teaser"
    action="atct_topic_teaser_view"
    description="Collection table view with teaser"
    />

<img tal:define="scale context/@@images"
 tal:replace="structure python: scale.scale('image',
              width=260, height=160, direction='down').tag()" />

<browser:page
    for="*"
    name="sunburstview"
    class=".sunburstview.SunburstView"
    layer=".interfaces.IThemeSpecific"
    permission="zope.Public"
    allowed_interface="plonetheme.sunburst.browser.interfaces.ISunburstView"
    />

elif sl and sr:
    return "cell width-1:2 position-1:2"

elif (sr and not sl) and (not portal_state.is_rtl()):
    return "cell width-1:2 position-1:2"

<div id="portal-column-two"
    class="cell width-1:4 position-1:4"
    ...
    tal:attributes="class python:isRTL and 'cell width-1:4 position-0' or 'cell width-1:4 position-1:4'">

import loremipsum

def gen_paragraphs(num=3):
    return u'/'.join([p[2] for p in loremipsum.Generator().generate_paragraphs(num)])

def gen_sentence():
    return loremipsum.Generator().generate_sentence()[-1]

def gen_sentences(length=80):
    return u'/'.join([s[2] for s in loremipsum.Generator().generate_sentences(length)])

def installGlossary(self, site):
    service = site.restrictedTraverse('deutschland/de/service')
    glossary = invokeFactory(service, 'PloneGlossary', 'Glossar')
    for i in range(100):
        term = invokeFactory(glossary, 'PloneGlossaryDefinition')
        term.setDefinition(gen_paragraphs(2))
        term.reindexObject()

import random
import urllib2

def random_image(width, height):
    url = 'http://lorempixel.com/%d/%d/' % (width, height)
    return urllib2.urlopen(url).read()

def installAssets(self, site):
    service = site.restrictedTraverse('de/service')
    assets = invokeFactory(service, 'Folder', 'Assets')
    for width,height in ((200,200), (400,400), (600, 400), (800, 600), (800,800), (1024, 768)):
        imagefolder_id = '%sx%s' % (width, height)
        images = invokeFactory(assets, 'Folder', imagefolder_id)
        for i in range(20):
            img = invokeFactory(images, 'Image')
            img.setImage(random_image(width, height))
            img.reindexObject()

[buildout]
parts =
    variables
    source

[variables]
var = ${source:path}/var
logs = ${variables:var}/logs

[source]
path = instance

[variables]
...
base_variables = ${:_buildout_section_name_}

[instance-base]
recipe = plone.recipe.zope2instance
...

[instance1]
<=instance-base
http-address = 8081

[instance2]
<=instance
http-address = 8082

[instance-debug]
<=instance-base
eggs +=
    Products.PDBDebugMode
    z3c.deadlockdebugger

[instance1]
<=instance-base
eggs -=
    Products.PDBDebugMode

[buildout]
extends = base.cfg

[buildout]
parts =
    ...
    mrbob

[mrbob]
recipe = zc.recipe.egg
eggs =
    mr.bob
    bobtemplates.plone

$ mrbob --remember-answers -O vs.policy bobtemplates:plone_addon
...

$ ../bin/mrbob --config .mrbob.ini -O vs.theme bobtemplates:plone_addon

$ ../bin/mrbob --config https://raw.github.com/veit/dotfiles/master/.mrbob.ini bobtemplates:plone_addon

[mr.bob]
verbose = True

[variables]
package.namespace = vs
author.name = Veit Schiele
author.email = kontakt@veit-schiele.de
author.github.user = veit
author.irc = irc.freenode.org#veit

$ cd src/
$ ../bin/mrbob -O vs.policy bobtemplates:plone_addon

$ ../bin/mrbob -O vs.bootstrap.tinymce bobtemplates:plone_addon

vs.policy/
├── bootstrap-buildout.py
├── buildout.cfg
├── CHANGES.rst
├── CONTRIBUTORS.rst
├── docs
│   ├── index.rst
│   ├── LICENSE.GPL
│   └── LICENSE.rst
├── MANIFEST.in
├── README.rst
├── setup.py
├── src
│   └── vs
│       ├── __init__.py
│       └── policy
│           ├── browser
│           │   ├── configure.zcml
│           │   ├── __init__.py
│           │   ├── overrides
│           │   └── static
│           ├── configure.zcml
│           ├── __init__.py
│           ├── interfaces.py
│           ├── locales
│           │   ├── update.sh
│           │   └── vs.policy.pot
│           ├── profiles
│           │   ├── default
│           │   │   ├── browserlayer.xml
│           │   │   ├── metadata.xml
│           │   │   └── vspolicy_default.txt
│           │   └── uninstall
│           │       ├── browserlayer.xml
│           │       └── vspolicy_uninstall.txt
│           ├── setuphandlers.py
│           ├── testing.py
│           └── tests
│               ├── __init__.py
│               ├── robot
│               │   └── test_example.robot
│               ├── test_robot.py
│               └── test_setup.py
└── travis.cfg

<configure
    ...
    xmlns:plone="http://namespaces.plone.org/plone"
    ...

<plone:static
    directory="theme"
    type="theme"
    name="vs.theme"
    />

<dependency>profile-plone.app.theming:default</dependency>

from vs.task import _
from zope import schema
from zope.interface import Interface

class ITask(Interface):

    title = schema.TextLine(
        title=_(u"Title"),
        required=True,
    )

    description = schema.Text(
        title=_(u"Description"),
        required=False,
    )

<dependency>profile-plone.app.dexterity:default</dependency>

$ cd src/
$ ../bin/mrbob -O vs.policy bobtemplates:plone_addon

$ ../bin/mrbob -O vs.bootstrap.tinymce bobtemplates:plone_addon

vs.policy/
├── bootstrap-buildout.py
├── buildout.cfg
├── CHANGES.rst
├── CONTRIBUTORS.rst
├── docs
│   ├── index.rst
│   ├── LICENSE.GPL
│   └── LICENSE.rst
├── MANIFEST.in
├── README.rst
├── setup.py
├── src
│   └── vs
│       ├── __init__.py
│       └── policy
│           ├── browser
│           │   ├── configure.zcml
│           │   ├── __init__.py
│           │   ├── overrides
│           │   └── static
│           ├── configure.zcml
│           ├── __init__.py
│           ├── interfaces.py
│           ├── locales
│           │   ├── update.sh
│           │   └── vs.policy.pot
│           ├── profiles
│           │   ├── default
│           │   │   ├── browserlayer.xml
│           │   │   ├── metadata.xml
│           │   │   └── vspolicy_default.txt
│           │   └── uninstall
│           │       ├── browserlayer.xml
│           │       └── vspolicy_uninstall.txt
│           ├── setuphandlers.py
│           ├── testing.py
│           └── tests
│               ├── __init__.py
│               ├── robot
│               │   └── test_example.robot
│               ├── test_robot.py
│               └── test_setup.py
└── travis.cfg

<configure
    ...
    xmlns:plone="http://namespaces.plone.org/plone"
    ...

<plone:static
    directory="theme"
    type="theme"
    name="vs.theme"
    />

<dependency>profile-plone.app.theming:default</dependency>

from vs.task import _
from zope import schema
from zope.interface import Interface

class ITask(Interface):

    title = schema.TextLine(
        title=_(u"Title"),
        required=True,
    )

    description = schema.Text(
        title=_(u"Description"),
        required=False,
    )

<dependency>profile-plone.app.dexterity:default</dependency>

parts =
    ...
    zopeskel

[zopeskel]
recipe = zc.recipe.egg
unzip = true
eggs =
    Paste
    ZopeSkel
    templer.plone
    templer.plone.localcommands

$ ./bin/zopeskel --list

Plone Development
-----------------

archetype: A Plone project that uses Archetypes content types

   This creates a Plone project that uses Archetypes content types. It
   has local commands that will allow you to add content types and to
   add fields to your new content types.
...

$ ./bin/zopeskel <template> <output-name>

$ cd src/
$ ../bin/zopeskel archetype vs.registration

$ ../bin/zopeskel archetype vs.registration author_email=kontakt@veit-schiele.de

$ ./bin/paster create -t <template-name> --list-variables

$ ./bin/zopeskel --make-config-file > ~/.zopeskel

[DEFAULT]
author_email = kontakt@veit-schiele.de
license_name = BSD
master_keywords = Web Python Zope

[[plone_basic]]
expert_mode = all
namespace_package = vs
add_profile = True
keywords = %(master_keywords)s Plone
url = https://github.com/veit/

[buildout]
parts =
    ...
    paster
    zopeskel
...
[paster]
recipe = zc.recipe.egg
eggs =
   ZopeSkel
   PasteScript
   PasteDeploy

$ cd src
$ ../bin/zopeskel archetype vs.registration

$ cd vs.registration/
$ python setup.py egg_info

$ cd src/
$ ../../../bin/paster add contenttype Registrant

$ ../../../bin/paster add --list
Available templates:
    browserlayer:  A Plone browserlayer
    browserview:   A browser view skeleton
    contenttype:   A content type skeleton
    schema_field:  A handy AT schema builder

import os
from templer.core.vars import var
from templer.localcommands import TemplerLocalTemplate

from Cheetah.Template import Template as cheetah_template

class ArchetypeSubTemplate(TemplerLocalTemplate):
    use_cheetah = True
    parent_templates = ['archetype']

class ContentType(ArchetypeSubTemplate):
    _template_dir = 'templates/archetype/contenttype'
    summary = "A content type skeleton"
...

$ tree ~/.buildout/eggs/templer.plone.localcommands-1.0b1-py2.7.egg/templer/plone/localcommands/templates/archetype/contenttype/
/home/veit/.buildout/eggs/templer.plone.localcommands-1.0b1-py2.7.egg/templer/plone/localcommands/templates/archetype/contenttype/
├── config.py_insert
├── content
│   ├── configure.zcml_insert
│   └── +content_class_filename+.py_tmpl
├── interfaces
│   ├── +content_class_filename+.py_tmpl
│   └── __init__.py_insert
├── profiles
│   └── default
│       ├── factorytool.xml_insert
│       ├── rolemap.xml_insert
│       ├── types
│       │   └── +types_xml_filename+.xml_tmpl
│       └── types.xml_insert
└── README.txt_insert

5 directories, 10 files

#<?xml version="1.0"?>
#<rolemap>
#  <permissions>
#    <!-- -*- extra stuff goes here -*- -->
    <permission name="$add_permission_name" acquire="False">
      <role name="Manager" />
      <role name="Contributor" />
    </permission>
#  </permissions>
#</rolemap>

$ ./bin/test -s vs.policy

$ ./bin/test -s my.package  -m 'test_setup'

$ ./bin/test -s vs.policy -m '.*setup.*' -t '.*installed.*'

$ ./bin/test --help

Ran 10 tests with 0 failures and 0 errors in 4.830 seconds.

Ran 10 tests with 2 failures and 3 errors in 9.688 seconds.

[buildout]
parts =
    …
    roadrunner

[roadrunner]
recipe = roadrunner:plone
packages-under-test = vs.policy

$ ./bin/roadrunner -s vs.policy

[buildout]
...
parts =
    ...
    instance
    test

[test]
recipe = zc.recipe.testrunner
defaults = ['--auto-color', '--auto-progress']
eggs =
    ${instance:eggs}
defaults = ['--auto-color', '--auto-progress', '-q', '--module', '^vs[.]']
initialization =
    import warnings
    warnings.simplefilter('ignore', DeprecationWarning)

[buildout]
...
parts =
    ...
    instance
    test
    alltests
...
[alltests]
recipe = plone.recipe.alltests

[alltests]
recipe = plone.recipe.alltests
exclude =
    repoze.*

[alltests]
recipe = plone.recipe.alltests
groups = test-groups

[test-groups]
Zope2 =
    Acquisition
    DateTime
    ExtensionClass
    Persistence
ZODB =
    transaction
    zc.lockfile
chameleon =
    chameleon.core
    cmf.pt
    z3c.pt

[alltests]
recipe = plone.recipe.alltests
groups = test-groups

[package-map]
Plone = Products.CMFPlone

./bin/test -s vs.registration --coverage=coverage

  Ran 19 tests with 0 failures and 0 errors in 43.924 seconds.
Tearing down left over layers:
  Tear down Products.PloneTestCase.layer.PloneSite in 2.009 seconds.
  Tear down Products.PloneTestCase.layer.ZCML in 0.012 seconds.
lines   cov%   module   (path)
   14    57%   vs.registration.__init__   (/home/veit/myproject/src/vs.registration/vs/registration/__init__.py)
   66    63%   vs.registration.browser.enquiry   (/home/veit/myproject/src/vs.registration/vs/registration/browser/enquiry.py)
    7   100%   vs.registration.browser.registrant   (/home/veit/myproject/src/vs.registration/vs/registration/browser/registrant.py)
   26    76%   vs.registration.browser.registration   (/home/veit/myproject/src/vs.registration/vs/registration/browser/registration.py)
   37   100%   vs.registration.content.registrant   (/home/veit/myproject/src/vs.registration/vs/registration/content/registrant.py)
   44   100%   vs.registration.content.registration   (/home/veit/myproject/src/vs.registration/vs/registration/content/registration.py)
   22   100%   vs.registration.interfaces   (/home/veit/myproject/src/vs.registration/vs/registration/interfaces.py)
   64   100%   vs.registration.portlets.registrants   (/home/veit/myproject/src/vs.registration/vs/registration/portlets/registrants.py)
   25    96%   vs.registration.setuphandlers   (/home/veit/myproject/src/vs.registration/vs/registration/setuphandlers.py)
   17   100%   vs.registration.tests.base   (/home/veit/myproject/src/vs.registration/vs/registration/tests/base.py)
   12    91%   vs.registration.tests.test_doctest   (/home/veit/myproject/src/vs.registration/vs/registration/tests/test_doctest.py)
   74   100%   vs.registration.tests.test_portlet_registrants   (/home/veit/myproject/src/vs.registration/vs/registration/tests/test_portlet_registrants.py)
   22   100%   vs.registration.tests.test_setup   (/home/veit/myproject/src/vs.registration/vs/registration/tests/test_setup.py)

       """Define a browser view for the Registration content type. In the FTI
       configured in profiles/default/types/*.xml, this is being set as the default
       view of that content type.
    1: """

    1: from Acquisition import aq_inner
    1: from Products.Five.browser import BrowserView
    1: from Products.Five.browser.pagetemplatefile import ViewPageTemplateFile

    1: from Products.CMFCore.utils import getToolByName

    1: from vs.registration.interfaces import IRegistration
    1: from vs.registration.interfaces import IRegistrant

    1: from plone.memoize.instance import memoize

    2: class RegistrationView(BrowserView):
           """Default view of a registration
           """

           # This template will be used to render the view. An implicit variable
           # 'view' will be available in this template, referring to an instance
           # of this class. The variable 'context' will refer to the registration
           # being rendered.

    1:     __call__ = ViewPageTemplateFile('registration.pt')

    1:     @memoize
            def registrations(self):
>>>>>>         context = aq_inner(self.context)
>>>>>>         catalog = getToolByName(context, 'portal_catalog')
>>>>>>         return [ dict(url=registration.getURL(),
                             title=registration.Title,
                             description=registration.Description,)
                        for registration in
                           catalog(object_provides=IRegistration.__identifier__,
>>>>>>                             path=dict(query='/'.join(context.getPhysicalPath()),
>>>>>>                                       depth=1),
>>>>>>                             sort_on='sortable_title')
                      ]

...

[buildout]
...
parts =
    ...
    test
    coverage

[test]
recipe = zc.recipe.testrunner
eggs =
    ${instance:eggs}

[coverage]
recipe = zc.recipe.egg
eggs = coverage
initialization =
    include = '--source=${buildout:directory}/src'
    sys.argv = sys.argv[:] + ['run', include, 'bin/test', '--all']

[buildout]
...
parts =
    ...
    report
...
[report]
recipe = zc.recipe.egg
eggs = coverage
scripts = coverage=report
initialization =
    sys.argv = sys.argv[:] + ['html', '-i']

$ rm -rf src/vs.policy/vs/policy/tests.py
$ mkdir src/vs.policy/vs/policy/tests
$ touch src/vs.policy/vs/policy/tests/__init__.py

import unittest2 as unittest

from plone.testing import z2
from plone.app.testing import TEST_USER_NAME
from plone.app.testing import TEST_USER_PASSWORD

from vs.policy.tests import layer

def get_browser(app, loggedIn=True):
    browser = z2.Browser(app)
    if loggedIn:
        auth = 'Basic %s:%s' % (TEST_USER_NAME, TEST_USER_PASSWORD)
        browser.addHeader('Authorization', auth)
    return browser

class TestCase(unittest.TestCase):
    layer = layer.VS_POLICY_INTEGRATION

class FunctionalTestCase(unittest.TestCase):
    layer = layer.VS_POLICY_FUNCTIONAL

from plone.app.testing import applyProfile
from plone.app.testing import PloneFixture
from plone.app.testing import PloneSandboxLayer
from plone.app.testing import PloneTestLifecycle
from plone.app.testing import setRoles
from plone.app.testing import TEST_USER_ID
from plone.testing import z2
from zope.configuration import xmlconfig

class VsPolicyFixture(PloneFixture):
    # No sunburst please
    extensionProfiles = ()

VS_POLICY_FIXTURE = VsPolicyFixture()

class VsPolicyTestLifecycle(PloneTestLifecycle):
    defaultBases = (VS_POLICY_FIXTURE, )

class IntegrationTesting(VsPolicyTestLifecycle, z2.IntegrationTesting):
    pass

class FunctionalTesting(VsPolicyTestLifecycle, z2.FunctionalTesting):
    pass

class VsPolicyLayer(PloneSandboxLayer):
    defaultBases = (VS_POLICY_FIXTURE, )

    def setUpZope(self, app, configurationContext):
        import vs.policy

        xmlconfig.file("configure.zcml", vs.policy,
                       context=configurationContext)
        z2.installProduct(app, 'vs.policy')

    def tearDownZope(self, app):
        z2.uninstallProduct(app, 'vs.policy')

    def setUpPloneSite(self, portal):
        applyProfile(portal, 'vs.policy:default')

        setRoles(portal, TEST_USER_ID, ['Manager'])
        portal.invokeFactory('Folder', 'test-folder')
        setRoles(portal, TEST_USER_ID, ['Member'])

VS_POLICY_LAYER = VsPolicyLayer()
VS_POLICY_INTEGRATION = IntegrationTesting(
    bases=(VS_POLICY_LAYER, ), name="VsPolicyLayer:Integration")
VS_POLICY_FUNCTIONAL = FunctionalTesting(
    bases=(VS_POLICY_LAYER, ), name="VsPolicyLayer:Functional")

from vs.policy.tests.base import FunctionalTestCase

class TestTest(FunctionalTestCase):

    def test_test(self):
        self.assertTrue(True)

self.assertRaises(AttributeError, myObject.myMethod, someParameter)

$ ./bin/test -s vs.policy

AssertionError:"Welcome to Veit Schiele != ''
...
AssertionError:'Veit Schiele != 'Plone site'
Ran 2 tests with 2 failures and 0 errors

Ran 2 tests with 0 failures and 0 errors.

$ ./bin/test -s my.package  -m 'test_setup'

$ ./bin/test -s vs.policy -m '.*setup.*' -t '.*installed.*'

$ ./bin/test --help

Ran 10 tests with 0 failures and 0 errors in 4.830 seconds.

Ran 10 tests with 2 failures and 3 errors in 9.688 seconds.

[buildout]
parts =
    ...
    roadrunner

[roadrunner]
recipe = roadrunner:plone
packages-under-test = vs.policy

$ ./bin/roadrunner -s vs.policy

import pdb; pdb.set_trace()

def normalizeString(self, text, relaxed=False):
    """Normalizes a title to an id.

    normalizeString() converts a whole string to a normalized form that
    should be safe to use as in a url, as a css id, etc.

    If relaxed=True, only those characters that are illegal as URLs and
    leading or trailing whitespace is stripped.

    >>> ptool = self.portal.plone_utils

    >>> ptool.normalizeString("Foo bar")
    'foo-bar'

    ...

    """
    return utils.normalizeString(text, context=self, relaxed=relaxed)

import unittest
from zope.testing import doctest

def test_suite():
    return unittest.TestSuite((
        doctest.DocFileSuite('README.txt'),
        ))

if __name__ == '__main__':
    unittest.main(defaultTest='test_suite')

import unittest
import doctest

from zope.testing import doctestunit
from zope.component import testing, eventtesting

from Testing import ZopeTestCase as ztc

from vs.registration.tests import base

def test_suite():
    return unittest.TestSuite([

        # Demonstrate the main content types
        ztc.ZopeDocFileSuite(
            'README.txt', package='vs.registration',
            test_class=base.RegistrationFunctionalTestCase,
            optionflags=doctest.REPORT_ONLY_FIRST_FAILURE | doctest.NORMALIZE_WHITESPACE | doctest.ELLIPSIS),

        ])

if __name__ == '__main__':
    unittest.main(defaultTest='test_suite')

>>> self.portal.invokeFactory('Registration', 'my-first-registration')

>>> from my.package.tests.utils import reset
>>> reset()

(Pdb) locals()
{'__return__': None, 'self': <zope.testing.doctest._OutputRedirectingPdb instance at 0x5a7c8f0>}

(Pdb) up
> /Users/veit/vs_buildout/src/Products.PloneGetPaid/Products/PloneGetPaid/notifications.py(22)__call__()
-> import pdb ; pdb.seT_trace()
(Pdb) locals()
{'settings': <Products.PloneGetPaid.preferences.StoreSettings object at 0x5f631b0>, 'store_url': 'http://nohost/plone', 'self': <Products.PloneGetPaid.notifications.MerchantOrderNotificationMessage object at 0x56c30d0>, 'order_contents': u'11 pz @84.00 total: US$924.00\n22 ph @59.00 total: US$1298.00\n12 pf @98.00 total: US$1176.00\n23 pX @95.00 total: US$2185.00\n3 pM @89.00 total: US$267.00\n22 po @60.00 total: US$1320.00\n23 pj @39.00 total: US$897.00\n15 po @34.00 total: US$510.00\n5 pS @76.00 total: US$380.00\n1 pm @70.00 total: US$70.00', 'template': u'To: ${to_email}\nFrom: "${from_name}" <${from_email}>\nSubject: New Order Notification\n\nA New Order has been created\n\nTotal Cost: ${total_price}\n\nTo continue processing the order follow this link:\n${store_url}/@@admin-manage-order/${order_id}/@@admin\n\nOrder Contents\n\n${order_contents}\n\nShipping Cost: ${shipping_cost}\n\n', 'pdb': <module 'pdb' from '/Users/moo/code/python-macosx/parts/opt/lib/python2.4/pdb.pyc'>}
(Pdb)

>>> from interlude import interact
>>> interact(locals())

>>> try:
...     someOperation()
... except:
...     import pdb; pdb.set_trace()
>>> # continue as normal

[...]

class ReferenceSource(object):
    """A base implementation of an IReferenceSource adapter that
    relies on a IReferenceQuery local utility to look up targets and
    on an IReferenceStorage adapter to add references.

    Basic setup:

        >>> import archetypes.testing
        >>> archetypes.testing.setupPortal()
        >>> archetypes.testing.wireUp()

    We create an object that we adapt to our ReferenceSource:

        >>> obj = archetypes.testing.FakeObject('sourceobj')
        >>> source = ReferenceSource(obj)

    We don't have any targets or relationships at this point:

        >>> source.getTargets()
        []
        >>> source.getRelationships()
        set([])

    [...]

    Teardown:

        >>> archetypes.testing.teardownPortal()
    """

    [...]

import unittest
from zope.testing import doctest

optionflags = doctest.REPORT_ONLY_FIRST_FAILURE | doctest.ELLIPSIS

def test_suite():
    from zope.testing.doctestunit import DocTestSuite
    return unittest.TestSuite((
            DocTestSuite('archetypes.reference.base',
                         optionflags=optionflags),
            ))

if __name__ == '__main__':
    unittest.main(defaultTest='test_suite')

import unittest
from zope.testing import doctest
from Testing.ZopeTestCase import ZopeDocTestSuite

from Products.pluggablecatalog.tests import common
common.setupPloneSite()

from Products.PloneTestCase import PloneTestCase

optionflags =  (doctest.ELLIPSIS |
                doctest.NORMALIZE_WHITESPACE |
                doctest.REPORT_ONLY_FIRST_FAILURE)

def test_suite():
    return unittest.TestSuite(
        [ZopeDocTestSuite(module,
                          test_class=PloneTestCase.PloneTestCase,
                          optionflags=optionflags)
         for module in ('Products.pluggablecatalog.tool',)]
       )

def setupPloneSite():
    from Products.PloneTestCase import PloneTestCase
    PloneTestCase.installProduct('pluggablecatalog')
    PloneTestCase.setupPloneSite()

import unittest

[...]

from zope.component.testing import setUp, tearDown
from zope.configuration.xmlconfig import XMLConfig
from zope.testing import doctest
from zope.testing.doctestunit import DocTestSuite

def configurationSetUp(self):
    setUp()
    XMLConfig('meta.zcml', zope.component)()
    XMLConfig('meta.zcml', zope.app.publisher.browser)()
    XMLConfig('configure.zcml', plone.i18n.locales)()

def testAvailableCountries():
    """
      >>> util = queryUtility(ICountryAvailability)
      >>> util
      <plone.i18n.locales.countries.CountryAvailability object at ...>

      >>> countrycodes = util.getAvailableCountries()
      >>> len(countrycodes)
      243

      >>> 'de' in countrycodes
      True

      >>> countries = util.getCountries()
      >>> len(countries)
      243

      >>> de = countries['de']
      >>> de['name']
      'Germany'

      >>> de['flag']
      '/@@/country-flags/de.gif'
    """

def test_suite():
    return unittest.TestSuite((
        DocTestSuite('plone.i18n.locales.countries'),
        DocTestSuite(setUp=configurationSetUp,
                     tearDown=tearDown,
                     optionflags=doctest.ELLIPSIS | doctest.NORMALIZE_WHITESPACE),
        ))

if __name__ == '__main__':
    unittest.main(defaultTest="test_suite")

Setting up and logging in
-------------------------

    >>> from Products.Five.testbrowser import Browser
    >>> browser = Browser()
    >>> portal_url = self.portal.absolute_url()
    [...
    >>> from Products.PloneTestCase.setup import portal_owner, default_password

    >>> browser.open(portal_url + '/login_form?came_from=' + portal_url)
    >>> browser.getControl(name='__ac_name').value = portal_owner
    >>> browser.getControl(name='__ac_password').value = default_password
    >>> browser.getControl(name='submit').click()

>>> browser.handleErrors = False

>>> self.portal.error_log._ignored_exceptions = ()

>>> try:
...     browser.getControl('Save').click()
... except:
...     print self.portal.error_log.getLogEntries()[0]['tb_text']
...     import pdb; pdb.set_trace()
>>> # continue as normal

import unittest
from zope.testing import doctest

def test_suite():
    return unittest.TestSuite((
        doctest.DocFileSuite('TestSystem.txt'),
        ))

if __name__ == '__main__':
    unittest.main(defaultTest='test_suite')

[buildout]
...
eggs =
    ...
    zope.testrecorder
...

[instance]
...
zcml =
     ...
     zope.testrecorder

http://localhost:8080/++resource++recorder/index.html

Create the browser object we'll be using.

    >>> from zope.testbrowser import Browser
    >>> browser = Browser()
    >>> browser.open('http://localhost:8080/mysite')

A test comment.

    >>> 'start writing' in browser.contents
    True

class MyJSLintTest(gocept.jslint.TestCase):

    include = ('my.package.browser:js',
               'my.package.browser:js/lib')
    options = (gocept.jslint.TestCase.options +
               ('browser', 'jquery',))

$ npm install jshint -g

$ ../bin/zopeskel plone_basic vs.registration
...
Expert Mode? (What question mode would you like? (easy/expert/all)?) ['easy']: all
...
robot tests (should the default robot test be included) [false]: true

extras_require={
    'test': ['plone.app.testing[robot]>=4.2.2']
},

from  vs.registration.testing import VS_REGISTRATION_FUNCTIONAL_TESTING
from plone.testing import layered
import robotsuite
import unittest

def test_suite():
    suite = unittest.TestSuite()
    suite.addTests([
        layered(robotsuite.RobotTestSuite("robot_test.txt"),
                layer=VS_REGISTRATION_FUNCTIONAL_TESTING)
    ])
    return suite

*** Settings ***

Library  Selenium2Library  timeout=10  implicit_wait=0.5

Suite Setup  Start browser
Suite Teardown  Close All Browsers

*** Variables ***

${BROWSER} =  firefox

*** Test Cases ***

Plone site
    [Tags]  start
    Go to  http://localhost:55001/plone/
    Page should contain  Plone site

*** Keywords ***

Start browser
    Open browser  http://localhost:55001/plone/  browser=${BROWSER}

$ cd vs_buildout/src/vs.registration
$ python bootstrap.py
$ ./bin/buildout
$ ./bin/test
Running vs.registration.testing.VsregistrationLayer:Functional tests:
  Set up plone.testing.zca.LayerCleanup in 0.000 seconds.
  Set up plone.testing.z2.Startup in 0.394 seconds.
  Set up plone.app.testing.layers.PloneFixture in 10.463 seconds.
  Set up vs.registration.testing.VsregistrationLayer in 0.464 seconds.
  Set up plone.testing.z2.ZServer in 0.503 seconds.
  Set up vs.registration.testing.VsregistrationLayer:Functional in 0.000 seconds.
  Running:

  Ran 1 tests with 0 failures and 0 errors in 3.026 seconds.
Running vs.registration.testing.VsregistrationLayer:Integration tests:
  Tear down vs.registration.testing.VsregistrationLayer:Functional in 0.000 seconds.
  Tear down plone.testing.z2.ZServer in 5.152 seconds.
  Set up vs.registration.testing.VsregistrationLayer:Integration in 0.000 seconds.
  Running:

  Ran 1 tests with 0 failures and 0 errors in 0.004 seconds.
Tearing down left over layers:
  Tear down vs.registration.testing.VsregistrationLayer:Integration in 0.000 seconds.
  Tear down vs.registration.testing.VsregistrationLayer in 0.002 seconds.
  Tear down plone.app.testing.layers.PloneFixture in 0.092 seconds.
  Tear down plone.testing.z2.Startup in 0.007 seconds.
  Tear down plone.testing.zca.LayerCleanup in 0.004 seconds.
Total: 2 tests, 0 failures, 0 errors in 20.510 seconds.

.. robot_tests::
   :source: ../src/vs/registration/tests/my_suite.txt

.. robot_tests:: Log.*
   :source: ../src/vs/registration/tests/my_suite.txt

.. robot_tests::
   :source: ../src/vs/registration/tests/my_suite.txt
   :tags: login, logout

.. robot_keywords::
   :source: ../src/my_package/tests/acceptance/my_suite.txt

.. robot_keywords:: Log.*
   :source: ../src/my_package/tests/acceptance/my_suite.txt

extensions = ['sphinxcontrib_robotdoc']

Use virtualenv
[x]  Install your project inside a virtualenv using setup.py install

sphinxcontrib-robotdoc>=0.3.4

Requirements file:
docs/requirements.txt

[buildout]
parts =
    ...
    pybot

[pybot]
recipe = zc.recipe.egg
eggs =
     robotframework
     robotframework-wavelibrary

$ python bootstrap.py
$ ./bin/buildout

*** Settings ***

Library  WAVELibrary

Resource  plone/app/robotframework/server.robot

Suite Setup  Setup
Suite Teardown  Teardown

*** Variables ***

${START_URL}  about:

*** Keywords ***

 Setup
     Setup Plone site  plone.app.robotframework.testing.AUTOLOGIN_ROBOT_TESTING
     Import library  Remote  ${PLONE_URL}/RobotRemote
     Enable autologin as  Site Administrator
     Set autologin username  test-user-1

 Teardown
     Teardown Plone Site

 *** Test Cases ***

 Test new page form tabs
     [Template]  Check new page tabs for accessibility errors
     default
     categorization
     dates
     creators
     settings

 *** Keywords ***

 Check new page tabs for accessibility errors
     [Arguments]  ${fieldset}
     Go to  ${PLONE_URL}/createObject?type_name=Document
     ${location} =  Get location
     Go to  ${PLONE_URL}
     Go to  ${location}#fieldsetlegend-${fieldset}
     Check accessibility errors

$ ./bin/pybot plone.robot

[buildout]

   [buildout]

   parts =
      jetty-download
      jenkins-download
      jenkins

   [jetty-download]
   recipe = hexagonit.recipe.download
   url =  http://ftp.halifax.rwth-aachen.de/eclipse//jetty/stable-9/dist/jetty-distribution-9.2.2.v20140723.tar.gz
   strip-top-level-dir = true

   [jenkins-download]
   recipe = hexagonit.recipe.download
   url = http://mirrors.jenkins-ci.org/war/latest/jenkins.war
   download-only = true

   [jenkins]
   recipe = jarn.jenkins
   jetty-location = ${jetty-download:location}
   jenkins-location = ${jenkins-download:location}
   host = localhost
   port = 8070

$ ./bin/jenkins fg

cd /home/veit/my_buildout
./bin/develop up
./bin/buildout
./bin/test --xml -s vs.registration

[test]
recipe = collective.xmltestreport
eggs =
    vs.registration
extra-paths = ${zope2:location}/lib/python
defaults = ['--exit-with-status', '--auto-color', '--auto-progress']

$ gem install travis

...
install_requires=[
    'setuptools',
    'Products.CMFPlone>=4.2',
    ],
extras_require={
    'test': ['plone.app.testing'],
    },
...

---
language: python
python: '2.7'
install:
- mkdir -p buildout-cache/eggs
- mkdir -p buildout-cache/downloads
- python bootstrap.py -c travis.cfg
- ./bin/buildout -N -t 3 -c travis.cfg
script: ./bin/test

[buildout]
extends =
    http://svn.plone.org/svn/collective/buildout/plonetest/test-4.x.cfg

parts = test

package-name = vs.registration
package-extras = [test]
#test-eggs = Pillow

allow-hosts +=
    code.google.com
    robotframework.googlecode.com

[environment]
ZSERVER_HOST = 0.0.0.0
ROBOT_ZOPE_HOST = 0.0.0.0

[test]
environment = environment

[test]
eggs =
    ${buildout:package-name} ${buildout:package-extras}
    ${buildout:test-eggs}

.. image:: https://secure.travis-ci.org/collective/vs.registration.png
:target: http://travis-ci.org/collective/vs.registration

language: python
python:
  - 2.6
  - 2.7

env:
  - PLONE_VERSION=4.2
  - PLONE_VERSION=4.3

- riak     # will start riak
- rabbitmq # will start rabbitmq-server
- memcache # will start memcached

- "export DISPLAY=:99.0"
- "sh -e /etc/init.d/xvfb start"

- unzip Sauce-Connect-latest.zip
- java -jar Sauce-Connect.jar $SAUCE_USERNAME $SAUCE_ACCESS_KEY -i $TRAVIS_JOB_ID -f CONNECTED &
- JAVA_PID=$!

bash -c "while [ ! -f CONNECTED ]; do sleep 2; done"

./bin/test

kill $JAVA_PID

# blacklist
branches:
  except:
    - legacy
    - experimental

# whitelist
branches:
  only:
    - master
    - stable

notifications:
  irc:
    email:
      - "kontakt@veit-schiele.de"
    channels:
      - "irc.freenode.org#sprint"
    on_success: never
    on_failure: always
    template:
      - "%{repository}#%{build_number} (%{branch} - %{commit} : %{author}): %{message}"
      - "Change view : %{compare_url}"
      - "Build details : %{build_url}"

$ git commit -m 'Typo in README.rst [ci skip]'

*** Settings ***

Library  Selenium2Library  timeout=10  implicit_wait=0.5

Suite Setup  Start browser
Suite Teardown  Close All Browsers

*** Variables ***

${ZOPE_HOST} =  localhost
${ZOPE_PORT} =  55001
${ZOPE_URL} =  http://${ZOPE_HOST}:${ZOPE_PORT}

${PLONE_SITE_ID} =  plone
${PLONE_URL} =  ${ZOPE_URL}/${PLONE_SITE_ID}

${BROWSER} =  Firefox
${REMOTE_URL} =
${DESIRED_CAPABILITIES} =  platform:Linux
${BUILD_NUMBER} =  manual

*** Test Cases ***

Plone site
    [Tags]  start
    Go to  ${PLONE_URL}
    Page should contain  Plone site

*** Keywords ***

Start browser
    ${BUILD_INFO} =  Set variable
    ...           build:${BUILD_NUMBER},name:${SUITE_NAME} | ${TEST_NAME}
    Open browser  ${PLONE_URL}  ${BROWSER}
    ...           remote_url=${REMOTE_URL}
    ...           desired_capabilities=${DESIRED_CAPABILITIES},${BUILD_INFO}

---
language: python
python: '2.7'
install:
- mkdir -p buildout-cache/eggs
- mkdir -p buildout-cache/downloads
- python bootstrap.py -c travis.cfg
- ./bin/buildout -N -t 3 -c travis.cfg
- curl -O http://saucelabs.com/downloads/Sauce-Connect-latest.zip
- unzip Sauce-Connect-latest.zip
- java -jar Sauce-Connect.jar $SAUCE_USERNAME $SAUCE_ACCESS_KEY -i $TRAVIS_JOB_ID -f CONNECTED &
- JAVA_PID=$!
before_script:
- bash -c "while [ ! -f CONNECTED ]; do sleep 2; done"
script: ./bin/test
after_script:
- kill $JAVA_PID
env:
  global:
  - ROBOT_BUILD_NUMBER=travis-$TRAVIS_BUILD_NUMBER
  -  ROBOT_REMOTE_URL=http://$SAUCE_USERNAME:$SAUCE_ACCESS_KEY@ondemand.saucelabs.com:80/wd/hub
  matrix:
  - ROBOT_BROWSER=firefox ROBOT_DESIRED_CAPABILITIES=tunnel-identifier:$TRAVIS_JOB_ID
  - ROBOT_BROWSER=chrome ROBOT_DESIRED_CAPABILITIES=tunnel-identifier:$TRAVIS_JOB_ID
  - ROBOT_BROWSER=internetexplorer ROBOT_DESIRED_CAPABILITIES=tunnel-identifier:$TRAVIS_JOB_ID

$ travis encrypt SAUCE_USERNAME=myusername -r mygithubname/example.product --add env.global
$ travis encrypt SAUCE_ACCESS_KEY=myaccesskey -r mygithubname/example.product --add env.global

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:genericsetup="http://namespaces.zope.org/genericsetup"
    i18n_domain="vs.theme">

  <genericsetup:registerProfile
      name="default"
      title="Theme for the Websites of Veit Schiele Communications"
      directory="profiles/default"
      description="Default profile for vs.theme"
      provides="Products.GenericSetup.interfaces.EXTENSION"
      />

</configure>

<?xml version="1.0"?>
<object name="portal_properties">
    <object name="navtree_properties">
        <property name="metaTypesNotToList" type="lines" purge="False">
            <element value="Registration"/>
        </property>
    </object>
</object>

<?xml version="1.0"?>
<metadata>
  <description>Policy for the Website of Veit Schiele Communications</description>
  <version>1.0dev $LastChangedRevision$ </version>
  <dependencies>
    <dependency>profile-vs.theme:default</dependency>
    <dependency>profile-Products.LinguaPlone:LinguaPlone</dependency>
  </dependencies>
</metadata>

<rule
    name="rule-1"
    title="Mail notification"
    description=""
    enabled="True"
    event="Products.CMFCore.interfaces.IActionSucceededEvent"
    stop-after="False">

<assignment
    location="/news"
    name="rule-1"
    enabled="True"
    bubbles="False"
    insert-before="*"
/>

<?xml version="1.0"?>
<repositorytool>
    <policymap>
        <type name="MyType">
            <policy name="at_edit_autoversion"/>
            <policy name="version_on_revert"/>
        </type>
        <type name="AnotherType">
            <policy name="at_edit_autoversion"/>
            <policy name="version_on_revert"/>
        </type>
    </policymap>
</repositorytool>

<?xml version="1.0"?>
<tool-setup>
  <required tool_id="portal_foo" class="dotted.path.to.Foo" />
  <forbidden tool_id="portal_bar" />
</tool-setup>

from zope import interface, schema
from plone.directives import form
…

class IExcludeFromNavigation(form.Schema):
    """Interface to exclude items from navigation.
    """

    form.fieldset('settings', label=u"Settings",
                  fields=['exclude_from_nav'])

    exclude_from_nav = schema.Bool(
                title=_(u'label_exclude_from_nav', default=u'Exclude from navigation'),
                description=_(u'help_exclude_from_nav', default=u'If selected, this item will not appear in the navigation tree'),
                default=False
                )

    form.omitted('exclude_from_nav')

[server-login]
username:veit
password:secret

from setuptools import setup, find_packages
import os

version = '0.2.19'

setup(name='vs.event',
      version=version,
      description="An extended event content-type for Plone (and Plone4Artists calendar)",
      long_description=open("README.txt").read() + "\n" +
                       open(os.path.join("docs", "HISTORY.txt")).read(),
      # Get more strings from https://www.python.org/pypi?%3Aaction=list_classifiers
      classifiers=[
        "Framework :: Plone",
        "Programming Language :: Python",
        "Topic :: Software Development :: Libraries :: Python Modules",
        ],
      keywords='Zope Plone Event Recurrence Calendar Plone4Artists',
      author='Veit Schiele, Anne Walther, Andreas Jung',
      author_email='vs.event@veit-schiele.de',
      url='http://svn.plone.org/svn/collective/vs.event',
      license='GPL',
      packages=find_packages(exclude=['ez_setup']),
      namespace_packages=['vs'],
      include_package_data=True,
      zip_safe=False,
      install_requires=[
          'setuptools',
          'python-dateutil',
          'dateable.chronos',
          'dateable.kalends',
          'collective.calendarwidget',
          'Products.DataGridField',
          'zope.app.annotation',
          # -*- Extra requirements: -*-
      ],
      entry_points="""
      # -*- Entry points: -*-
      """,
      )

$ python setup.py register

$ python setup.py sdist upload

$ cd my.package
$ python setup.py sdist upload -r http://index.pythonpackages.com
$ pip install my.package -i http://index.pythonpackages.com

$ easy_install sdistmaker

$ sdists_from_tags --print-example-defaults

$ sdists_from_tags --defaults-file=defaults.py

[buildout]
parts = sdists

[sdists]
recipe = zc.recipe.egg
eggs = sdistmaker
scripts = sdists_from_tags
# arguments =
#      defaults_file='${buildout:directory}/defaults.py'

# Allow indexing
Options +Indexes
IndexOptions FancyIndexing VersionSort

# Start of rewriterules to use our own var/private/* packages
# when available and to redirect to pypi if not.
RewriteEngine On
# Use our robots.txt:
RewriteRule ^/robots.txt - [L]
# Use our apache's icons:
RewriteRule ^/icons/.* - [L]
# We want OUR index.  Specified in a weird way as apache
# searches in a weird way for index.htm index.html index.php etc.
RewriteRule ^/index\..* - [L]

# Use our var/private/PROJECTNAME if available,
# redirect to pypi otherwise:
RewriteCond /path/on/server/var/private/$1 !-f
RewriteCond /path/on/server/var/private/$1 !-d
RewriteRule ^/([^/]+)/?$ http://pypi.python.org/pypi/$1/ [L]

# Use our var/private/PROJECTNAME/project-0.1.tar.gz if available,
# redirect to pypi otherwise:
RewriteCond /path/on/server/var/private/$1 !-d
RewriteRule ^/([^/]+)/([^/]+)$ http://pypi.python.org/pypi/$1/$2 [L]

$ easy_install -i https://packages.veit-schiele.de/ vs.event

[buildout]
index = https://packages.veit-schiele.de/
parts =
    ...

[gocept.zestreleaser.customupload]
vs = scp://download.veit-schiele.de:/var/www/packages
example = https://dav.veit-schiele.de:/var/www/example

>>> class IPerson(interface.Interface):
...     name = interface.Attribute("Name")
>>> class PersonGreeter:
...
...     component.adapts(IPerson)
...     interface.implements(IGreeter)
...
...     def __init__(self, person):
...         self.person = person
...
...     def greet(self):
...         print "Hello", self.person.name

>>> list(component.adaptedBy(PersonGreeter)) == [IPerson]
True

>>> component.provideAdapter(PersonGreeter)

>>> class VeitPersonGreeter(PersonGreeter):
...     name = 'Veit'
...     def greet(self):
...         print "Hello", self.person.name, "my name is", self.name
>>> component.provideAdapter(
...                        VeitPersonGreeter, [IPerson], IGreeter, 'veit')

>>> class ChrisPersonGreeter(VeitPersonGreeter):
...     name = "Chris"
>>> component.provideAdapter(
...     factory=ChrisPersonGreeter, adapts=[IPerson],
...     provides=IGreeter, name='chris')

>>> component.queryAdapter(Person("Chris"), IGreeter, 'veit').greet()
Hello Chris my name is Veit
>>> component.getAdapter(Person("Chris"), IGreeter, 'veit').greet()
Hello Chris my name is Veit

>>> component.queryAdapter(Person("Chris"), IGreeter, 'daniel')
>>> component.getAdapter(Person("Chris"), IGreeter, 'daniel')
... 
Traceback (most recent call last):
...
ComponentLookupError: (...Person...>, <...IGreeter>, 'daniel')

>>> class TwoPersonGreeter:
...
...     component.adapts(IPerson, IPerson)
...     interface.implements(IGreeter)
...
...     def __init__(self, person, greeter):
...         self.person = person
...         self.greeter = greeter
...
...     def greet(self):
...         print "Hello", self.person.name
...         print "my name is", self.greeter.name

>>> component.queryMultiAdapter((Person("Chris"), Person("Veit")),
...                                  IGreeter).greet()
Hello Chris
my name is Veit

from plone.theme.interfaces import IDefaultPloneLayer

class IThemeSpecific(IDefaultPloneLayer):
    """Marker interface that defines a Zope 3 browser layer.
       If you need to register a viewlet only for the
       "vs.theme" theme, this interface must be its layer.
    """

<layers>
    <layer name="vs.theme"
           interface="vs.theme.interfaces.IThemeSpecific" />
</layers>

<browser:page
    for="Products.CMFCore.interfaces.ISiteRoot"
    name="dashboard"
    permission="plone.app.portlets.ManageOwnPortlets"
    class="plone.app.layout.dashboard.dashboard.DashboardView"
    template="templates/dashboard.pt"
    layer=".interfaces.IThemeSpecific"
    />

>>> import zope.component.event

>>> class Event1(object):
...     pass
>>> class Event2(Event1):
...     pass

>>> called = []
>>> import zope.component
>>> @zope.component.adapter(Event1)
... def handler1(event):
...     called.append(1)
>>> @zope.component.adapter(Event2)
... def handler2(event):
...     called.append(2)

>>> zope.component.provideHandler(handler1)
>>> zope.component.provideHandler(handler2)

>>> from zope.event import notify
>>> notify(Event1())
>>> called
[1]
>>> del called[:]
>>> notify(Event2())
>>> called.sort()
>>> called
[1, 2]

>>> import datetime
>>> def documentCreated(event):
...     event.doc.created = datetime.datetime.utcnow()
>>> documentCreated = component.adapter(IDocumentCreated)(documentCreated)

>>> component.provideHandler(documentCreated)

>>> component.handle(DocumentCreated(doc))
>>> doc.created.__class__.__name__
'datetime'

from zope.interface import Interface

class IHello(Interface):

    def hello(name):
        """Say hello to somebody"""

>>> IHello
<InterfaceClass __main__.IHello>

>>> from zope.interface import Interface

>>> class ISpecialGreeting(Interface):
...     """A special greeting"""

>>> def contacts_invariant(obj):
...
...     if not (obj.email or obj.phone):
...         raise Exception(
...             "At least one contact info is required")

>>> from zope.interface import Interface
>>> from zope.interface import Attribute
>>> from zope.interface import invariant

>>> class IPerson(Interface):
...
...     name = Attribute("Name")
...     email = Attribute("Email Address")
...     phone = Attribute("Phone Number")
...
...     invariant(contacts_invariant)

>>> from zope.interface import implements

>>> class Person(object):
...     implements(IPerson)
...
...     name = None
...     email = None
...     phone = None

>>> veit = Person()
>>> veit.email = u"veit@example.org"
>>> IPerson.validateInvariants(veit)
>>> chris = Person()
>>> IPerson.validateInvariants(jill)
Traceback (most recent call last):
...
Exception: At least one contact info is required

class HelloComponent:

    implements(IHello)

    def hello(self, name):
        return "Hello %s!" % name

class HelloComponent:

    implements(IHello, IOther)
    ...

IHello.implementedBy(HelloComponent)

class ISmartHello(IHello):
    """A Hello object that remembers who is greeted"""

    def lastGreeted(self):
        """Returns the name of the last person greeted."""

>>> ISmartHello.getBases()
(<InterfaceClass __main__.IHello>,)

>>> ISmartHello.extends(IHello)
True
>>> IOther(Interface):
...     pass
>>> ISmartHello.extends(IOther)
False

>>> IUser.names()
['getUserName', 'getPassword']

>>> IUser.namesAndDescriptions()
[('getUserName', <zope.interface.interface.Method.Method object at 80f38f0>),
('getPassword', <zope.interface.interface.Method.Method object at 80fded8>)]

jQuery("#content a[ @href $= '.pdf']").attr('target', '_blank');

from logging import getLogger
log = getLogger('Plone')
log.info('Debug: %s \n%s', summary, text)

...
plone_log=context.plone_log
constrainTypesMode = context.REQUEST.get('constrainTypesMode', [])
currentPrefer = context.REQUEST.get('currentPrefer', [])
currentAllow = context.REQUEST.get('currentAllow', [])
plone_log( "SET: currentAllow=%s, currentPrefer=%s" % ( currentAllow, currentPrefer ) )
...

<configure
    ...
    xmlns:monkey="http://namespaces.plone.org/monkey">
    ...
    <monkey:patch
        description="TinyMCE JSON Folder listing should ignore INavigationRoot"
        class="Products.TinyMCE.adapters.JSONFolderListing.JSONFolderListing"
        original="getListing"
        replacement=".patches.getListing"
        />

import pdb; pdb.set_trace()

$ ./bin/instance fg

-> Pdb().set_trace()
(Pdb)

try:
    [YOUR CODE HERE]
except:
    import pdb, sys
    e, m, tb = sys.exc_info()
    pdb.post_mortem(tb)

if not globals().get( 'PDB_ACTIVE', 0 ):
    globals()['PDB_ACTIVE'] = 1
    import pdb; pdb.set_trace()

# Print a sorted dictionary.
# %1 is the dict
# %2 is the prefix for the names.
alias p_ for k in sorted(%1.keys()): print "%s%-15s= %-80.80s" % ("%2",k,repr(%1[k]))

# Print the member variables of something
alias pi p_ %1.__dict__ %1.

# Print the member variables of self
alias ps pi self

# Print locals
alias pl p_ locals() local:

# Next list and step list
alias nl n;;l
alias sl s;;l

#!/opt/python/2.4.6/bin/python

import sys
sys.path[0:0] = [
  '/opt/plone/3.3/eggs/zc.buildout-1.3.1-py2.4.egg',
  '/opt/plone/3.3/eggs/setuptools-0.6c9-py2.4.egg',
  ]

>>> components.registerSubscriptionAdapter(tests.A1_2)
... 
Registered event:
SubscriptionRegistration(<Components comps>, [I1], IA2, u'', A1_2, u'')

>>> component.provideSubscriptionAdapter(SingleLineSummary)
>>> component.provideSubscriptionAdapter(AdequateLength)

>>> doc = Document("A\nDocument", "blah")
>>> [adapter.validate()
...  for adapter in component.subscribers([doc], IValidate)
...  if adapter.validate()]
['Summary should only have one line', 'too short']

>>> doc = Document("A\nDocument", "blah")
>>> [adapter.validate()
...  for adapter in component.subscribers([doc], IValidate)
...  if adapter.validate()]
['Summary should only have one line', 'too short']

>>> for registration in sorted(
...     components.registeredSubscriptionAdapters()):
...     print registration.required
...     print registration.provided, registration.name
...     print registration.factory, registration.info

>>> components.unregisterSubscriptionAdapter(tests.A1_2)
... 
Unregistered event:
SubscriptionRegistration(<Components comps>, [I1], IA2, u'', A1_2, '')
True

>>> from zope import interface
>>> class IGreeter(interface.Interface):
...     def greet():
...         "say hello"
>>> class Greeter:
...     interface.implements(IGreeter)
...
...     def __init__(self, other="world"):
...         self.other = other
...
...     def greet(self):
...         print "Hello", self.other

>>> component.queryUtility(IGreeter, 'christian').greet()
Hello chris
>>> component.getUtility(IGreeter, 'christian').greet()
Hello chris

>>> component.queryUtility(IGreeter, 'veit')
>>> component.getUtility(IGreeter, 'veit')
... 
Traceback (most recent call last):
...
ComponentLookupError: (<InterfaceClass ...IGreeter>, 'veit')

>>> from zope import component
>>> greet = Greeter('chris')
>>> component.provideUtility(greet, IGreeter, 'christian')

$ easy_install-2.7 virtualenv
$ virtualenv my_virtualenv

$ pip install --user foo

target = 'http://localhost:8080/plone'
path = xmlrpclib.ServerProxy(target).getPhysicalPath()

target = 'http://admin:secret@localhost:8080/plone'
path = xmlrpclib.ServerProxy(target).getPhysicalPath()

import os
from xmlrpclib import ServerProxy
from xmlrpclib import Binary

client = ServerProxy("http://admin:secret@localhost:8080/plone")
data = open(os.path.join('pictures', 'portrait.jpg')).read()
myimage = {'portraits/veit.jpg': [{'title': 'a Portrait of Veit', 'image':Binary(data)},'Image']}
output = client.get_object(client.post_object(myimage))

<!-- Load the meta -->
<include files="package-includes/*-meta.zcml" />
<five:loadProducts file="meta.zcml"/>

<!-- Load the configuration -->
<include files="package-includes/*-configure.zcml" />
<five:loadProducts />

<!-- Load the configuration overrides-->
<includeOverrides files="package-includes/*-overrides.zcml" />
<five:loadProductsOverrides />

<securityPolicy
    component="Products.Five.security.FiveSecurityPolicy" />

<include
    zcml:condition="installed zope.app.zcmlfiles"
    package="zope.app.zcmlfiles"
    />
<include
    zcml:condition="not-installed zope.app.zcmlfiles"
    package="zope.app"
    />
<include zcml:condition="installed some.package"
    package="some.package" />
<include zcml:condition="not-installed some.package"
    package=".otherpackage" />

<include
    package="Products.CMFCore" file="permissions.zcml"
    xmlns:zcml="http://namespaces.zope.org/zcml"
    zcml:condition="have plone-41" />
<configure
    zcml:condition="not-have plone-4">
   <!-- only when the Plone 4 feature has not been provided -->
</configure>
<configure
    zcml:condition="not-have plone-5">
   <!-- only when the Plone 5 feature has not been provided -->
</configure>

$ easy_install zope.component

Feld	dazugehörige Widgets	Beschreibung
StringField	StringWidget, SelectionWidget, PasswordWidget	Eine einzelne Textzeile
TextField	TextAreaWidget, RichWidget	Mehrzeiliges Textfeld, wobei das `RichWidget` den WYSIWYG-Editor einbindet
LinesField	LinesWidget, MultiSelectionWidget, InAndOutWidget	Liste von Zeichenketten, mehrzeilig
IntegerField	IntegerWidget	Ganze Zahl
FixedPointField	DecimalWidget	Dezimalzahl
BooleanField	BooleanWidget	Wahr/falsch-Checkbox
FileField	FileWidget	Feld um Dateien hochzuladen
ImageField	ImageWidget	Feld um Bilder hochzuladen
DateTimeField	CalendarWidget	Feld um ein Datum auszuwählen
ReferenceField	ReferenceWidget, InAndOutWidget	Referenz auf ein anderes Archetypes-Objekt

Feldeigenschaft	Beschreibung
required	Erforderlich, die möglichen Werte sind `true` oder `false`.
searchable	Der Wert `true` schließt das Feld in die `Searchable Text`-Suche ein.
default	Bietet einen Standardwert für dieses Feld.
default_method	Name einer Methode (als Zeichenkette), die aufgerufen wird, um den Standardwert zu liefern.
schemata	Der Name eines Reiters in der Editieransicht. Das Standardschema ist `Default`. Durch den Aufruf von `finalizeATCTSchema()` werden verschiedene Änderungen am Schema vorgenommen, die das Plone-spezifische Erscheinungsbild ermöglichen.
read_permission, write_permission	Die Namen der Berechtigungen, die zum Lesen bzw. Schreiben des Feldes erforderlich sind. Die Standardwerte sind `View` bzw. `Modify portal content`.
vocabulary, vocabulary_factory, enforceVocabulary	Definieren eines Vokabulars für das Auswahlfeld, s.u.
validators	Eine Liste von Feldvalidatoren, s.u.
accessor, edit_accessor, mutator	Überschreibt die Namen der Accessor-, Edit-Accessor- oder Mutator-Methode.
widget	Widget, mit dem das Feld dargestellt werden soll
storage	Speicherabstraktion, die für dieses Feld verwendet werden soll Der Standardwert ist `AttributeStorage` `AttributeStorage` die Feldwerte werden in Attributen dieses Objekts gespeichert. Die Attribute haben dabei denselben Namen wie das Feld `AnnotationStorage` speichert die Werte in Zope3-Annotations, wodurch das Risiko von Namenskonflikten vermieden wird

Widget-Eigenschaft	Beschreibung
`label`	Eine Zeichenkette oder übersetzbare Nachricht, die als Etikett des Widgets verwendet wird
`description`	Eine Zeichenkette oder übersetzbare Nachricht, die als Hilfe-Text verwendet wird
`condition`	Ein TALES-Ausfruck, die bestimmt, ob ein Widget angezeigt wird. Die Variablen `object`, `portal` und `folder` sind in diesem Kontext verfügbar
`size`	Die Länge einer Textbox oder die Höhe einer Auswahlbox
`rows`	Höhe einer Textbox
`default_output_type`	Wird von `RichWidget` verwendet um den eingegebenen Text bei der Ausgabe zu verändern `text/x-html-safe` nutzt Plone’s HTML-Filter-Richtlinien zum Ausfiltern potentiell gefährlicher Tags `text/html` kann verwendet werden, wenn Sie Ihren Nutzern trauen

CMFCore Permission	Five Permission	Beschreibung
`AccessContentsInformation`	`zope2.AccessContentsInformation`	Niedrigschwellige Zope-Berechtigung, die den Zugang zu Objekten kontrolliert
`View`	`zope2.View`	Zugang zu der Hauptansicht eines Inhaltsobjekts
`ListFolderContents`	`cmf.ListFolderContents`	Berechtigung, die Verzeichnisübersicht zu sehen
`ModifyPortalContent`	`cmf.ModifyPortalContent`	Editiermöglichkeit für die Inhalte
`ManagePortal`	`cmf.ManagePortal`	Operationen, die typischerweise der Manager-Rolle zugewiesen werden
`AddPortalContent`	`cmf.AddPortalContent`	Möglichkeit, neue Inhalte hinzuzufügen. Darüberhinaus haben viele Artikeltypen ihre eigenen Berechtigungen zum Hinzufügen von Inhalten, so dass beide Berechtigungen benötigt werden

Konverter	Beispiel	Anmerkung
`boolean`, `int`, `long`, `float`, `string`, `date`, `boolean`	<input type="hidden" name="limit:int" value="8 />"	Wandelt die Variable in den zugehörigen Python-Typ um, `date` führt so zu `DateTime`. Solche Umwandlungen sind normalerweise nur in `hidden`-Feldern sinnvoll; werden unzulässige Werte eingegeben, ist die resultierende Fehlermeldung für die meisten Nutzer wenig aussagekräftig.
`text`	<textarea name="description:text" />	Konvertiert eine Zeichenkette mit normalisierten Zeilenumbrüchen entsprechend der Server-Plattform
`list`, `tuple`	<input type="checkbox" name="status:list" value="1"	Erstellt eine Liste oder ein Tuple aus mehreren Feldern mit demselben Namen oder aus einer mehrwertigen Listenauswahl. Dieser Konverter kann mit anderen kombiniert werden, z.B. `int:list` um eine Liste ganzer Zahlen zu erhalten
`tokens`, `lines`	<input type="text" name="keywords:tokens" />	Wandelt eine durch Leerzeichen (tokens) oder neue Zeilen (lines) getrennte Zeichenkette in eine Liste um
`record`, `records`	<input type="text" name="data.id:record" />	Erstellt ein Wörterbuch (`record`) oder eine Liste von Wörterbüchern (`records`). Der Name vor `.` ist der Variablenname, der Name danach der Schlüssel.
`required`	<input type="text" name="title:required" />	Gibt eine Fehlermeldung aus wenn das Feld nicht ausgefüllt wurde.
`ignore_empty`	<input type="text" name="id:ignore_empty" />	Die Variable wird bei einem Request nicht angegeben wenn sie leer ist. Dieser Konverter kann mit anderen kombiniert werden.
`default`	<input type="hidden" name="accept:boolean:default" value="True" /> <input type="checkbox" name="accept:boolean:default" value="False" />	Standardwert, falls in keinem Feld mit demselben Namen ein Wert übermittelt wurde. Dies ist vor allem für Checkboxen sinnvoll, die nicht übertragen werden wenn für sie keine Angabe gemacht wurde. Dieser Konverter kann mit anderen kombiniert werden.

Anweisung	Beschreibung
`%a`	Lokalisierter abgeküzter Name des Wochentags.
`%A`	Lokalisierter Wochentag.
`%b`	Lokalisierter abgekürzter Name des Monats.
`%B`	Lokalisierter Monatsname
`%c`	Lokalisierte entsprechende Datums- und Zeitdarstellung.
`%d`	Tag des Monats als Dezimalzahl `01` – `31`.
`%H`	Stunde als Dezimalzahl `00` – `23`.
`%I`	Stunde als Dezimalzahl `01` – `12`.
`%j`	Tag des Jahres als Dezimalzahl. `001` – `366`.
`%m`	Monat als Dezimalzahl `01` – `12`.
`%M`	Minute als Dezimalzahl `00` – `59`.
`%p`	Lokalisiertes Äquivalent von AM oder PM. 1
`%S`	Sekunde als Dezimalzahl `00` – `61`. 2
`%U`	Wochenzahl eines Jahres als Dezimalzahl `00` – `53` (Sonntag als erster Tag der Woche). Alle Tage eines Jahres vor dem ersten Sonntag werden der Woche 0 zugerechnet. 3
`%w`	Wochentag als Dezimalzahl `0` (Sonntag) – `6`.
`%W`	Wochenzahl eines Jahres als Dezimalzahl `00` – `53` (Montag als erster Tag der Woche) Alle Tage eines Jahres vor dem ersten Montag werden der Woche 0 zugerechnet. 3
`%x`	Lokalisierte angemessene Datumsdarstellung.
`%X`	Lokalisierte angemessene Zeitdarstellung.
`%y`	Jahr ohne Jahrhundert als Dezimalzahl `00` – `99`.
`%Y`	Jahr mit Jahrhundert als Dezimalzahl.
`%Z`	Name der Zeitzone (keine Zeichen, wenn keine Zeitzone existiert.
`%%`	Das Zeichen `%`.

Regelsatz	Profile
Regelsatz	without-caching-proxy	with-caching-proxy	with-caching-proxy-splitviews
Content Feed	weakCaching	moderateCaching	moderateCaching
Content files and images	weakCaching	moderateCaching	moderateCaching
Content folder view	weakCaching	weakCaching	moderateCaching
Content item view	weakCaching	weakCaching	moderateCaching
File and image resources	strongCaching	strongCaching	strongCaching
Stable file and image resources	strongCaching	strongCaching	strongCaching

alt	neu
Products.ATContentTypes.content.folder.ATFolder	plone.app.folder.folder.ATFolder
Products.ATContentTypes.content.folder.ATFolderSchema	plone.app.folder.folder.ATFolderSchema
Products.CMFPlone.browser.navtree.SitemapNavtreeStrategy.icon	Products.CMFPlone.browser.navtree.SitemapNavtreeStrategy.item_icon
Products.CMFPlone.browser.plone	Products.CMFPlone.browser.ploneview
Products.CMFPlone.browser.ploneview.cache_decorator	plone.memoize.instance.memoize
Products.CMFPlone.browser.ploneview.IndexIterator	Products.CMFPlone.utils.IndexIterator
Products.CMFPlone.browser.ploneview.Plone.isRightToLeft	@@plone_portal_state/is_rtl
Products.CMFPlone.browser.ploneview.Plone.keyFilteredActions	@@plone_context_state/keyed_actions
Products.CMFPlone.browser.portlets	plone.app.portlets.portlets
Products.CMFPlone.interfaces.OrderedContainer.IOrderedContainer	OFS.interfaces.IOrderedContainer
Products.CMFPlone.utils.BrowserView	Products.Five.BrowserView
Products.CMFPlone.utils.getGlobalTranslationService	Products.PageTemplates.GlobalTranslationService.getGlobalTranslationService
Products.CMFPlone.utils.scale_image	Products.PlonePAS.utils.scale_image
Products.CMFPlone.utils.utranslate	zope.i18n.translate
Products.PageTemplates.GlobalTranslationService.getGlobalTranslationService	zope.i18n
Products.CMFPlone.utils.ulocalized_time	Products.CMFPlone.i18nl10n.ulocalized_time
zope.app.cache.interfaces.ram.IRAMCache	zope.ramcache.interfaces.ram.IRAMCache
Products.ATReferenceBrowserWidget.ATReferenceBrowserWidget.ReferenceBrowserWidget	archetypes.referencebrowserwidget.ReferenceBrowserWidget

Frühere Plone-Versionen	Plone 4.1
`from Products.CMFPlone import Batch`	`from Products.CMFPlone.PloneBatch import Batch`
`from zope.app.interface import queryType`	`from zope.app.content import queryType`
`from Products.Five.formlib import formbase`	`from five.formlib import formbase`

Diazo	Deliverance
`replace`	`replace`
`copy`	`replace` + Kindselektortyp
`before`	`prepend`
`after`	`append`
`prepend`	`prepend` + Kindselektortyp
`prepend` + XPATH + `@id` oder `prepend` + XPATH + `@class`	`prepend` + Kindselektortyp
`append`	`append` + Kindselektortyp
`drop`	`drop`

Interface	Eigenschaft	Typ	Beschreibung
`IField`	`title`	unicode	Der Titel des Feldes, der im Widget verwendet wird.
	`description`	unicode	Die Beschreibung des Feldes, die im Widget verwendet wird.
	`required`	bool	Es wird überprüft, ob das Feld eine Angabe enthält. Der Standarwert ist `True`.
	`readonly`	bool	Ist der Wert `True`, so kann das Feld nur gelesen werden. Der Standarwert ist `False`.
	`default`		Der Standardwert eines Feldes. Dieser Wert kann ggf. auch als Fallback verwendet werden, falls keine Angabe gemacht wurde. Dieser Wert muss eine valide Angabe für dieses Feld sein. Der Standardwert ist `None`.
	`missing_value`		Ein wert, der verdeutlicht, dass dieses Feld nicht ausgefüllt wurde. Dieser Wert wird bei der Validierung des Formulars verwendet. Der Standarwert ist `None`. Für Listen und Tuples kann es gelegentlich nützlich sein, eine leere Liste oder ein leeres Tuple zu setzen.
`IMinMaxLen`	`min_length`	int	Die minimale Länge der Eingabe. Wird für `string`-Felder verwendet. Der Standardwert ist `0`.
`IMinMaxLen`	`max_length`	int	Die maximale Länge der Eingabe. Wird für `string`-Felder verwendet. Der Standardwert ist `0`.
`IMinMax`	`min`		Der minimal erlaubte Wert. Dies muss ein valider Wert für dieses Feld sein. Der Standardwert ist `None`.
`IMinMax`	`max`		Der maximal erlaubte Wert. Dies muss ein valider Wert für dieses Feld sein. Der Standardwert ist `None`.
`ICollection`	`value_type`		Erlaubte Werte einer Liste, eines Tuples oder einer anderen Sammlung. Muss für jedes `collection`-Feld gesetzt werden. Häufig wird als Wert `Choice` angegeben um ein Multi-Selection-Feld mit einem Vokabular zu erstellen.
`ICollection`	`unique`	`bool`	Ob die Werte in der Kollektion eindeutig sein müssen oder nicht. Wird meist nicht direkt gesetzt, sondern es wird ein `Set` oder ein `Frozenset` verwendet um die Eindeutigkeit zu garantieren.
`IDict`	`key_type`		Beschreibt die erlaubten Schlüssel in einem Dictionary. Ähnlich dem `value_type` in Kollektionen. Muss gesetzt werden.
`IDict`	`value_type`		Beschreibt die erlaubten Werte in einem Dictionary. Ähnlich `value_type` in Kollektionen. Muss gesetzt werden.
`IObject`	`schema`	`Ìnterface`	Ein Interface, das von jedem Objekt, das in diesem Feld gespeichert wird bereitgestellt werden muss.
`IRichText`	`default_mime_type`	`str`	Standard-MIME-Typ für den Eingabetext eines Rich Text-Felds. Der Standard ist `text/html`.
	`output_mime_type`	`str`	Standard-MIME-Typ für den transformierten Text eines Rich Text-Felds. Der Standard ist `text/x-html-safe`.
	`allowed_mime_types`	`tuple`	Eine Liste aller erlaubten MIME-Typen für die Eingabe. Der Standardwert ist `None`, wobei den die Einstellungen für die gesamte Website übernommen werden.

Name	Typ	Beschreibung	Typ
`NamedFile`	`NamedFile`	Eine hochzuladende Binärdatei. Üblicherweise wird das Widget aus `plone.formwidget.namedfile` verwendet.	`IField`
`NamedImage`	`NamedImage`	Ein hochzuladendeis Bild. Üblicherweise wird das Widget aus `plone.formwidget.namedfile` verwendet.	`IField`
`NamedBlobFile`	`NamedBlobFile`	Eine hochzuladende Binärdatei, die als ZODB-BLOB gespeichert wird. Üblicherweise wird das Widget aus `plone.formwidget.namedfile` verwendet.	`IField`
`NamedBlobImage`	`NamedBlobImage`	Ein hochzuladendes Bild, das als ZODB-BLOB gespeichert wird. Üblicherweise wird das Widget aus `plone.formwidget.namedfile` verwendet.	`IField`

Name	Typ	Beschreibung	Typ
`Relation`	`RelationValue`	Speichert den Wert einer einzelnen Relation.	`IField`
`RelationList`	`list`	List-Feld für `RelationValue`.	Siehe `List`.
`RelationChoice`	`RelationValue`	Choice-Feld für `RelationValue`.	Siehe `Choice`

Widget	Importiert von	Feld	Beschreibung
`WysiwygFieldWidget`	`plone.app.z3cform.wysiwyg`	`Text`	Hiermit erhalten Sie den Standard-WYSIWYG-Editor von Plone für dieses Feld.
`RichTextWidget`	`plone.app.textfield.widget`	`RichText`	Dieses Feld erlaubt neben dem Standard-WYSIWYG-Editor auch Text-basiertes Markup wie bei reStructuredText.
`AutocompleteFieldWidget`	`plone.formwidget.autocomplete`	`Choice`	Autocpmplete-Widget, das auf jQuery-Autocomplete basiert. Erfordert ein Choice-Feld mit Angabe von `source`. Siehe Vokabularien.
`AutocompleteMultiFieldWidget`	`plone.formwidget.autocomplete`	`Collection`	Multi-Select-Version für Tuple, Listen,Sets oder Frozensets mit dem WErtetyp `Choice`.
`ContentTreeFieldWidget`	`plone.formwidget.contenttree`	`RelationChoice`	Content-Browser. Erfordert eine Quelle, die nach Objekten angefragt werden kann.
`MultiContentTreeFieldWidget`	`plone.formwidget.contenttree`	`RelationList`	Content-Browser. Erfordert eine Quelle, die nach Objekten angefragt werden kann.
`NamedFileFieldWidget`	`plone.formwidget.namedfile`	`NamedFile`	Ein Widget zum Hochladen von Dateien.
`NamedImageFieldWidget`	`plone.formwidget.namedimage`	`NamedImage`	Ein Widget zum Hochladen von Bildern.
`TextLinesFieldWidget`	`plone.z3cform.textlines`	Collection`	Listen-Eintrag für List, Tuple, Set oder Frozenset-Felder. Erfordert als Wertetyp `TextLine` oder `ASCIILine`.
`SingleCheckBoxFieldWidget`	`z3c.form.browser.checkbox`	`Bool`	Checkbox für wahr/falsch.
`CheckBoxFieldWidget`	`z3c.form.browser.checkbox`	`Collection`	Ein Set von Checkboxen. Wird verwendet für Set- oder Frozenset-Felder mit `Choice` als WErtetyp und einem Vokabular.

Interface	Beschreibung
`plone.app.dexterity.behaviors.metadata.IBasic`	Fügt die Standardfelder Titel und Beschreibung hinzu.
`plone.app.dexterity.behaviors.metadata.ICategorization`	Fügt das Fieldset Kategorisierung mit dessen Feldern hinzu
`plone.app.dexterity.behaviors.metadata.IPublication`	Fügt das Datum-Fieldset und dessen Felder hinzu.
`plone.app.dexterity.behaviors.metadata.IOwnership`	Fügt das Urheber-Fieldset und dessen Felder hinzu.
`plone.app.dexterity.behaviors.metadata.IDublinCore`	Fügt alle DublinCore-Felder der oben genannten Behaviors hinzu.
`plone.app.content.interfacess.INameFromTitle`	Berechnet den Namen aus dem Titel-Attribut.
`plone.app.dexterity.behaviors.metadata.IRelatedItems`	Fügt ein Related Items-Feld zum Kategorisierung-Fieldset hinzu.

Name	Beschreibung
`widget`	Spezifiziert ein alternatives Widget für ein Feld. Dabei wird der Feldname als Key und der Widget-Name als Value angegeben. Das Widget kann entweder eine Instanz aus z3c.form.widget sein oder ein Dotted Name eines Widgets.
`omitted`	Spart ein oder mehrere Felder aus einem Formular aus. Als Parameter kann eine Sequenz der Feldnamen angegeben werden.
`mode`	Folgende Modi sind möglich: `input`, display``oder ``hodden. Dabei wird der Feldname als Key und der Modus als Value angegeben.
`order_before`	Spezifiziert, dass das betreffende Feld vor einem anderen gerendert werden soll. Ist das Feld in einem zusätzlichen Schema definiert (z.B. in einem Behavior), ist der Name z.B. `ICategorization.language`. Alternativ kann auch `*` verwendet werden um das Feld am Anfang des Formulars anzuzeigen.
`order_after`	Spezifiziert, dass das betreffende Feld nach einem anderen gerendert werden soll. Ist das Feld in einem zusätzlichen Schema definiert (z.B. in einem Behavior), ist der Name z.B. `ICategorization.language`. Alternativ kann auch `*` verwendet werden um das Feld am Ende des Formulars anzuzeigen.
`primary`	Markiert ein bestimmtes Feld als Primary Field in einem Schema. Dies wird beim Zugriff per WebDAV für das Marshalling des Objekts verwendet.
`fieldset`	Erstellt ein Fieldset, das in Plone als Reiter im Bearbeiten- Formular angezeigt wird.

Name	Beschreibung
`read_permission`	Setzt die Zope3-Permission, die zum Lesen des Feldwerts erforderlich ist. Dabei wird der Feldname als Schlüssel und die Berechtigung als Wert angegeben.
`write_permission`	Setzt die Zope3-Permission, die zum Schreiben des Feldwerts erforderlich ist. Dabei wird der Feldname als Schlüssel und die Berechtigung als Wert angegeben.

Eigenschaft/Methode	Typ	Beschreibung
`__name__`	`unicode`	Der Name (ID) des Objekts in seinem Container. Dies kann eine Unicode-Zeichenkette sein wobei aktuell Zope2 jedoch nur ASCII-Zeichen in URLs erlaubt.
`id`	`str`	Der Name (ID) des Objekts in seinem Container. Dies ist das ASCII-ENcoding von `__name__`.
`getId()`	`str`	Gibt den Wert der ID-Eigenschaft aus.
`isPrincipaFolderish`	`bool/int`	`True` oder `1` wenn das Objekt ein Ordner ist, `False` oder `0` wenn das Objekt kein Ordner ist.
`portal_type`	`str`	Der Artikeltyp dieser Instanz.
`meta_type`	`str`	Zope2-spezifische Art, eine Klasse zu beschreiben
`title_or_id()`	`str`	Gibt den Wert des Titels aus oder sofern dieser nicht gesetzt ist, die ID-Eigenschaft.
`absolute_url()`	`str`	Die vollständige URL des Inhaltsobjekts. Berücksichtigt Virtual Hosting und die aktuelle Domain.
`getPhysicalPath()`	`tuple`	Eine Sequenz von Pfadelementen ab dem Wurzelverzeichnis der Anwendung. Die Angabe sollte nicht verwendet werden um relative URLs zu konstruieren, da Virtual Hosting nicht berücksichtigt wird.
`getIcon()`	`str`	Gibt eine Zeichenkette zurück, die als `src`-Attribut in einem `<img />`-Tag verwendet werden kann.
`title`	`unicode/str`	Titel-Eigenschaft des Objekts. Üblicherweise Teil des Schemas eines Objekts, das durch das ÌBasic`-Behavior`` bereitgestellt wird.
`Title()`	`iunicode/str`	DublinCore-Accessor für die Titel-Eigenschaft. Es kann auch ``setTitle()``verwendet werden.
`listCreators()`	`tuple`	Eine Liste von User-IDs, Der erste Ersteller ist üblicherweise der Eigentümer des Objekts. Mit `setCreators()` kann die Liste verändert werden.
`Creator()`	`str`	Der erste Ersteller, der aus der `listCreators()`-Methode ausgegeben wird. Üblicherweise wird hier der Eigentümer des Objekts ausgegeben.
`Subject()`	`tuple`	DublinCore-Accessor für Schlagwörter. Die Liste kann bearbeitet werden mit der `setSubject()`-Methode.
`Description()`	`unicode/str`	DublinCore-Accessor für die Beschreibung, die üblicherweise mit dem `ÌBase`-Behavior mitkommt. Die Beschreibung kann geändert werden mit der `setDescription()`-Methode.
`listContributors()`	`tuple`	DublinCore-Accessor für die Liste der an dem Objekt Beteiligten. Die Beschreibung kann geändert werden mit der `setContributors()`-Methode.
`Date()`	`str`	DublinCore-Accessor für das Datum des Artikels im ISO-Format. Sofern vorhanden wird `EffectiveDate` verwendet, andernfalls `ModificationDate`.
`CreationDate()`	`str`	DublinCore-Accessor für das Erstellungsdatum des Artikels im ISO-Format.
`EffectiveDate()`	`str`	DublinCore-Accessor für das Veröffentlichungsdatum des Artikels im ISO-Format. Das Veröffentlichungsdatum kann geändert werden mit der `setEffectiveDate()`-Methode.
`ExpirationDate()`	`str`	DublinCore-Accessor für das Ablaufdatum des Artikels im ISO-Format. Das Ablaufdatum kann geändert werden mit der `setExpirationDate()`-Methode.
`ModificationDate()`	`str`	DublinCore-Accessor für das Änderungsdatumdes Artikels im . ISO-Format.
`Language()`	`str`	DublinCore-Accessor für die Sprache des Artikels. Diese kann geändert werden mit der `setLanguage()`-Methode.
`Rights()`	`str`	DublinCore-Accessor für die Copyright-Angabe. Diese kann geändert werden mit der `setRights()`-Methode.
`created()`	`DateTime`	Gibt die Zope2-DateTime-Angabe für das Erstellungsdatum zurück. Falls diese nicht gesetzt ist, wird `January 1st, 1970` ausgegeben.
`modified()`	`DateTime`	Gibt die Zope2-DateTime-Angabe für das Änderungsdatum zurück. Falls diese nicht gesetzt ist, wird `January 1st, 1970` ausgegeben.
`effective()`	`DateTime`	Gibt die Zope2-DateTime-Angabe für das Veröffentlichungsdatum zurück. Falls diese nicht gesetzt ist, wird `January 1st, 1970` ausgegeben.
`expires()`	`DateTime`	Gibt die Zope2-DateTime-Angabe für das Ablaufdatum zurück. Falls diese nicht gesetzt ist, wird `January 1st, 1970` ausgegeben.

Einführung¶

Zielgruppe¶

Konventionen¶

Inhalt¶

Entwicklungsumgebung¶

Konzepte¶

Installation¶

Mac OS X¶

Weitere Informationen¶

Python 2.6¶

Python 2.4¶

Erstellen eines Buildout-Projekts¶

Zusätzliche Informationen für Windows¶

Buildout-Konfiguration¶

annotate¶

Plone 3.2¶

Plone 3.1¶

Aktualisierung und Versionierung¶

Buildout-Erweiterungen¶

Verzeichnisstruktur¶

Ressourcen teilen¶

Weitere Entwicklungswerkzeuge¶

Zope-Neustarts¶

mr.developer¶

Erstellen eines Site-Policy-Produkts¶

Ändern der Site-Konfiguration¶

Erstellen eines EXTENSION-Profils¶

Zusätzliche Änderungen der Site-Konfiguration¶

Konfigurieren der HTML-Filter¶

Tests schreiben¶

Tests erstellen¶

Test-Fixture¶

Tests¶

Test- und Hilfsmethoden¶

Testen¶

Filter¶

Report¶

Analyse¶

Setup¶

Weitere Optionen¶

roadrunner¶

Tipps & Tricks¶

Installation¶

Zusatzprodukte¶

Finden¶

Evaluieren¶

Installation und Aktivierung¶

Tests¶

Häufig verwendete Zusatzprodukte¶

Plone 5¶

Plone 4¶

LinguaPlone¶

Tests¶

TinyMCE-Erweiterungen¶

Erscheinungsbild¶

Plone3-Theme-Package¶

Erstellen des Eggs¶

Skin¶

Resourcen registrieren¶

Browser Views¶

Globale Variablen und Hilfsansichten¶

Viewlets¶

content-Macros¶

Portlets ändern, zuweisen, blockieren und entfernen¶

Portlet erstellen¶

Portlet-Manager hinzufügen¶

Zope Page Templates (ZPT)¶

Chameleon¶

Kinetic Style Sheets¶

Tipps¶

Archetypes-Artikeltypen¶

Paket-Layout¶

Interfaces¶

Archetypes¶

Content-Basisklassen¶

Schema¶

Felder¶

Widgets¶

Vokabularien¶

Schlagworte in einen eigenen Index schreiben¶

`annotate`¶

Erstellen eines `EXTENSION`-Profils¶

Adapter für `IImageContent` schreiben¶

Mehrere `submit`-Tasten¶