collective.cheatsheets

by Piotr Furman last modified Feb 16, 2011 02:04 AM

As Wikipedia says, cheatsheet "is a concise set of notes used for quick reference". Collective.cheatsheets provides lists of most common methods, variables and few code snippets usefull for Plone developers.

Project Description

Why distribute cheatsheets as a Plone product rather than a static PDF or some image? There are two reasons. First of all, you can easily add it to any site you are just making. Then, during work you don't need to search for this cheatsheet, nor even switch browser. Just type in browser address bar @@cs and voila, there it is.

Second reason is that there is a little javascript helper, allowing you to customize page layout. Most usefull methods and most often used variables are collected on few pages. However, it's not obvious which parts are important. Advanced developer probably doesn't need TAL commands, but beginner may find it usefull. Thanks customization everybody can change it, eg. remove unnecessary viewlets or use three column layout for widescreens.

Of course, if you still prefer static PDF version you can get it from here.

As a final word, keep in mind this is 0.1 version and it may still need more content (see TODO section in README). Feel free to extend it, it's 'collective' :)

 

Installation

Easiest to install with zc.buildout. In buildout.cfg put something like that:

[buildout]
find-links =
    ...
    http://dist.plone.org/packages

eggs =
    collective.cheatsheets

[instance]
zcml =
    collective.cheatsheets
Then run bin/buildout, restart Zope and add cheatsheets in portal_quickinstaller.

Current Release

No stable release available yet.

All Releases

Version Released Description Compatibility Status
0.1 Initial release, waiting for comments and suggestions. More about this release…
Plone 3
beta

Comments (2)

Alessandro Ceglie Oct 18, 2011 10:57 AM
Very useful sheet... always on my desk :)

In order to extend compatibility to plone4.1 please add in the main configure.zcml of the package the following conditional include:

    <include package="Products.CMFCore" file="permissions.zcml"
           xmlns:zcml="http://namespaces.zope.org/zcml"
           zcml:condition="have plone-41" />



Piotr Furman Oct 24, 2011 01:01 PM
Thanks, I'm glad You found it usefull :)

I just added Your patch to svn. Maybe if I find some time later this week I could build an egg for Plone repository.

But some sheets would have to be upgraded if we want really support Plone 4.1.