The book is now available:

Plone 3 Multimedia Cover

In the book you will find help on how to set up a customized multimedia CMS by collaborating with external resources such as . . . → Read More: New Book: “Plone 3 Multimedia”]]> I was tired of reading and answering all the p4a related questions on the Plone user mailing list and wrote a book about it .

The book is now available:

Plone 3 Multimedia Cover

In the book you will find help on how to set up a customized multimedia CMS by collaborating with external resources such as YouTube, Google videos as well as to use and extend specialized multimedia content-types for images, audio, video, and Flash.

Plone 3 Multimedia provides a rich repository of tools and techniques to add full multimedia power to Plone along with collaboration with many external web resources in order to build an interactive Plone site. The readers will learn to structure their content by tagging, rating, and geolocating through this practical guide. Furthermore, it also gives readers an insight into how to upload, store, and serve their multimedia content in an effective way.

Using this book, developers will be able to include photos, movies, audio, and Flash-applications into their Plone site to make it more user-friendly. In addition to learning about the various video and audio formats best suited for web publishing, developers will also be able to get to grips with categorization, syndication, upload, storage, and serving of multimedia content. This book will also enable developers to create an engaging user experience by including powerful Silverlight web and mobile applications into Plone.

A step-by-step tutorial packed with hands-on-examples, this book is ideal for Plone integrators who want to extend the core of Plone with multimedia features and want to learn to use multimedia effectively. The book is out now and available from Packt. To read more about it, please visit: http://www.packtpub.com/plone-3-3-multimedia-website/book

There is a full example including a buildout on how to set up a secure video on demand solution using Plone and the Red5 Flash Server.

To nevertheless use them you have to do a little trick and fool CMFDynamicViewFTI. We do . . . → Read More: Using five.grok views as default views]]> Once you get used to the power of grok in Plone via five.grok you never want to miss it and use it for all and everything. Unfortunately it is currently not possible to use grok views as default views via CMFDynamicViewFTI.

To nevertheless use them you have to do a little trick and fool CMFDynamicViewFTI. We do so by manually adding two dummy functions to your grok view:

class MyDefaultGrokView(grok.View):
    """ A grok view used as a default view in Plone
    """

    grok.context(MyGrokContext)

    # fix to be used with CMFDynamicViewFTI
    def __of__(self, context):
        return self

    # fix to be used with CMFDynamicViewFTI
    def __call__(self, context=None, request=None):
        return super(MyDefaultGrokView, self).__call__()

    def update(self):
        ...

No more, no less

BTW My Plone book “Plone 3 Multimedia” I worked on the last year is published and available!

Plone itself ships with a big amount of uncompressed JavaScript and CSS which are compiled in the resource registry. The usual minifying recipes . . . → Read More: Minifying JavaScript and CSS with buildout]]> An easy way to increase the performance of a web-page is to minify the used CSS and JavaScript resources. There are ready available tools that strip the comments and whitespaces from JavaScript and CSS-files.

Plone itself ships with a big amount of uncompressed JavaScript and CSS which are compiled in the resource registry. The usual minifying recipes don’t work in this case. To benefit from minifying resources there are some buildout recipes, which eased my life. I recently switched to TinyMCE, because kupu isn’t compatible with IE8. TinyMCE  comes with really many plain JavaScript-files. I believe this is true for any (multilanguage) WYSIWYG-editor. So before putting it into production, I minified all the resources of TinyMCE, with a striking performance increase. What I did was changing my buildout the following way:

With the hexagonit.recipe.download-recipe I download the Java-sources of the yui-compressor

[yui-compressor]
recipe = hexagonit.recipe.download
url = http://yuilibrary.com/downloads/yuicompressor/yuicompressor-2.4.2.zip
strip-top-level-dir = true

The collective.recipe.ant-recipe built the yui-compressor from the previously downloaded sources for me. This recipe assumes there Java and ant are installed and working. If ant is not in the PATH-environment, the recipe provides the ant-home-option for specifying the location of ant.

[yui-compressor-build]
recipe = collective.recipe.ant
ant-options =
    -buildfile ${yui-compressor:location}/build.xml

Finally I used the collective.recipe.minify-recipe to add a wrapper for minifying ALL resources of TinyMCE. The recipe has a paths-option, where you can specify a list of paths to products, which should be minified. The wrapper will walk these paths recursively, look for *.css and *.js-files and minify them, if needed. The products don’t necessarily need to be check-outs or development-eggs. Already packaged 3rd party eggs can be walked too.

[minify]
recipe = collective.recipe.minify
paths =
    src/Products.TinyMCE
ignore =
verbose = true
include-devel = false
css-command = java -jar ${yui-compressor:location}/build/yuicompressor-2.4.2.jar --type css
js-command = java -jar ${yui-compressor:location}/build/yuicompressor-2.4.2.jar --type js

The full inclusion of all parts looks like this:

[buildout]
parts =
zope2
productdistros
instance
yui-compressor
yui-compressor-build
minify

[yui-compressor]
recipe = hexagonit.recipe.download
url = http://yuilibrary.com/downloads/yuicompressor/yuicompressor-2.4.2.zip
strip-top-level-dir = true

[yui-compressor-build]
recipe = collective.recipe.ant
ant-options =
    -buildfile ${yui-compressor:location}/build.xml

[minify]
recipe = collective.recipe.minify
paths =
    src/Products.TinyMCE
ignore =
verbose = true
include-devel = false
css-command = java -jar ${yui-compressor:location}/build/yuicompressor-2.4.2.jar --type css
js-command = java -jar ${yui-compressor:location}/build/yuicompressor-2.4.2.jar --type js

...

After running the buildout I had a minify-wrapper script in the bin-directory of my buildout. Executing it took some time (about 20minutes on my machine) and issued a

INFO: Minified 13 CSS and 917 JavaScript-files

And here is the difference:

Loading the default page of Plone in authenticated mode without minified TinyMCE:

Loading the default page of Plone in authenticated mode with minified TinyMCE:

The size of the TinyMCE-JavaScript reduced from 329.2 KB to 181.8 KB and the loading time decreased from 523 ms to 248 ms. This is less than half!

The next thing I did was . . . → Read More: Migrating to Plone 4. Part 1]]> Recently I tried to migrate the website of the university I work for to Plone 4. The first thing I did was to checkout the development buildout from Plone http://svn.plone.org/svn/plone/buildouts/plone-coredev/branches/4.0. The alpha2 release is quite near, but I thought I can watch the changes/bugfixes better, when I use the development buildout.

The next thing I did was to include our custom and third-party products the site uses into the buildout configuration. This was the easy part, but running the buildout gave me the first error.  It complained about some custom packages, which were not included as development eggs. We use the haufe.eggserver for our internal eggs and most of them were compiled in the Python 2.4 version. I took me a while to figure out I had to provide the 2.6 version of the eggs or the source-distributions. (BTW There seems to be a bug in both setuptools and distribute with the upload command in Python 2.6. They do not accept the -r, –repository flag and always try to upload the egg to pypi) For that reason I chose the source format and the eggs were recognized flawlessly.

Ready for the next step I tried to start the instance in foreground mode. Of course there were some errors. I had to use the Plone 4 branches of  PloneFormGen and CacheFu and the the trunk of the PloneFormGen dependencies TALESField, PythonField and TemplateFields. In my custom products I had two errors occuring quite frequently:

1. I use safeEditProperty quite frequently. The import location changed from Products.CMFPlone.migrations.migration_util to plone.app.upgrade.utils
2. The registerType-method of Archetypes (1.6) now takes two parameters: klass and package. The klass parameter has been there before. The package parameter is optional in Plone 3. It is the name of the product for packages in the Products namespace and the full name of the package for all others I guess.

Well now the instance with all dependencies still does not start because of the p4a.plonecalendar, which still imports the object events from zope.app.event. This is where I stopped today…. more to come ….

Nowadays all people use buildouts and adding . . . → Read More: Customize Plone translations with iw.recipe.cmd]]> Sometimes the good translations of Plone do not fit your usecase or screen space. Overriding the translations in a pre-buildout area was easy. All you needed to do is to put a directory i18n in your instance home containing a file custom-plone-en.po. The structure of the filename is important: custom-DOMAIN-LANGUAGECODE.po

Nowadays all people use buildouts and adding something to the instance doesn’t seem to be a good idea. It lives in the parts directory and gets overridden on every “install” run of buildout. A solution I use (on Linux) is to maintain the translations in a directory i18n in the buildout and let a recipe copy it to the instance.

For the recipe I use iw.recipe.cmd and the buildout snippet looks like:

[i18n]
recipe = iw.recipe.cmd
on_install = true
on_update = true
cmds =
test -d ${instance:location}/i18n && rm -rf ${instance:location}/i18n || true
cp -R ${buildout:directory}/i18n ${instance:location}/


Update! 27.08.2010This Recipe only works with Plone 3. For Plone 4 and onwards it is not need any longer. The Plone i18n-domain can be overridden in a customization product.