Let's talk a bit …
Planet Plone
No more JS / CSS browser cache refresh pain
Jan 31st
We often have the following problem :
- a CSS or a Javascript file is changed in a package
- we make a release (or not) and put it to production
- some visitors still gets old CSS and Javascript versions (except if by chance we remembered to reinstall package / re-save portal_css and portal_javascripts configs) and need to flush their browser cache
As we do not have great memory and as our customer’s Helpdesk was tired of doing remote cache flush, we wanted to do something (automatic) about it.
Plone adds cache keys as suffixes for CSS and JS files, as for example base-cachekey6247.css.
This cache key doesn’t change, even after an instance restart. This is why browsers can keep the “old” versions cached.
To avoid that (and without touching to Apache or whatever), we wrote a little script that exectutes at the end of the instance startup process.It forces the “cook” of resources which generates a new cache key so that browser cannot cache CSS and JS anymore !
This script can of course be improved, but it fits our needs.
[Please note that this code is written for Plone 3.]
First, we subscribe to IDatabaseOpenedWithRootEvent (too bad we couldn’t use IProcessStarting because we have no context to get Plone sites) :
<subscriber for="zope.app.appsetup.interfaces.IDatabaseOpenedWithRootEvent" handler=".resources.clear_cache" />
Then, our handler gets the work done :
# -*- coding: utf-8 -*- from Products.CMFCore.utils import getToolByName from zope.app.appsetup.bootstrap import getInformationFromEvent import transaction from our.package import logger def clear_cache(event): """ Force cache key renewal for CSS and JS on all Plone sites at startup. This avoids any caching of changed CSS or JS. """ db, connection, root, root_folder = getInformationFromEvent(event) app = root_folder for obj_tuple in app.items(): (obj_name, obj) = obj_tuple if obj.get('portal_type') == 'Plone Site': p_css = getToolByName(obj, 'portal_css') p_css.cookResources() p_js = getToolByName(obj, 'portal_javascripts') p_js.cookResources() logger.info('Cache key changed for CSS/JS on Plone %s' % obj_name) transaction.commit()
And voilà, no more browser cache flush hassle for our customer and their Helpdesk
If you have any thoughts on this, or think that this should be packaged in a collective egg (useful for you ?), feel free to comment.
Get rid of huge images in your Plone site
Apr 12th
Do you have users that don’t care about image sizes at all ?
Do you have Plone sites with tons of raw photos galleries ?
Do you want to shrink your Data.fs ?
Then try the new collective.autoscaling package !
It allows automatic scaling of large images uploaded into your Plone sites.
You can configure the maximum width / height you are willing to tolerate and it does the rest !
This is totally transparent to the user (except if you choose to show message).
Images can be either Image content type or any Image field on Dexterity content types.
Example use case :
- You configure collective.autoscaling to have images with maximum size of height 800px / width 1200px.
- One of your user uploads a really big image : height 2000px / width 4000px.
- This image will be resized to height 600px / width 1200px (aspect ratio is of course preserved).
There is also a migration view you can call on any folder (or at the site root) to resize all contained images.
collective.autoscaling (developed for IMIO) is available on Github and version 1.0 has just been released on Pypi.
Please enjoy, improve and send feedback !
Automatically pack your Plone instances (without zeo)
Jan 20th
At Affinitic, we have many Plone sites on our servers and we wanted to pack their ZODB automatically.
Our goal is of course to do it without any downtime. It’s easy when you have a zeoserver, but you cannot use a packing script when there isn’t :
zc.lockfile.LockError: Couldn't lock 'instance/var/filestorage/Data.fs.lock'
We decided to simply do a wget on the ZMI packing form.
Here is the command to pack your main database (7 days) :
wget --max-redirect 0 --post-data='submit=Pack&days:float=7.0' http://user:password@localhost:8080/Control_Panel/Database/main/manage_pack
We wrapped this in a script to get meaningful exit code and this is deployed via Puppet to have a cron for each and every Plone instances. Even the user that is used to access the instance is created via Puppet with :
bin/instance adduser user password
Alternative method, not used for deployment reasons and using a Python script : https://www.nathanvangheem.com/news/automatically-pack-the-zodb
If it can help anyone …
Omit attribute in TAL
Mar 18th
I always tough than it was impossible to completely omit a tag attribute using TAL. So when I wanted to automatically check or not a radio button, I duplicated it like this:
<input type="radio" tal:condition="mycondition" checked="checked" />
<input type="radio" tal:condition="not:mycondition" />
But we can omit a tag attribute by passing nothing to a tal:attributes, like this:
<input type="radio" tal:attributes="checked python:mycondition and 'checked' or nothing" />
It’s so cleaner!
Keyword fields are tied to allowRolesToAddKeywords roles
Dec 3rd
For a project, we have added some extended fields on contents. Those fields use KeywordWidget
widget (same as Plone ‘Subject’ tags).
We wanted to have a custom permission on those fields, so we used :
read_permission=permissions.OurCustomPermission write_permission=permissions.OurCustomPermission
But it didn’t work : the field title and label displayed correctly (when we have the permission) but the widget never happeared.
Why ?
Because the KeywordWidget
template use allowRolesToAddKeywords
(from portal_properties
/ site_properties
) to filter who can add new keywords. So that “permission” will impact your custom fields too !
There has been tickets / discussion about allowRolesToAddKeywords, but that never changed.
Hope that noone else would get bitten by this once-for-all permission on keyword widgets.
Beware of uppercase letters in your config files
Aug 12th
We got a surprise using a [theme:parameters]
variable in the manifest.cfg
of one of our Diazo theme.
We were defining a parameter like that :
isFrontPage = context/@@isFrontPage
and then we were using it in the rules :
<drop css:content="#footer-sitemap" if="$isFrontPage" />
But we got an error after having the Theme installed. And we found that the parameter we got in Theme control panel was “isfrontpage” and not “isFrontPage” so the “isFrontPage” parameter used in rules was undefined !
This is happening because plone.app.theming
(as plone.resource
, Products.GenericSetup
, …) is using python’s ConfigParser
to parse the manifest.cfg
file (“from ConfigParser import ConfigParser
“) and it does a lower()
on the sections and variables that you put in your config files.
This is the same for RawConfigParser
and SafeConfigParser
.
So … don’t ever use camelcase there
Google Chrome + Firebug Lite + z3c.form = Bad combo
Jan 9th
There is a bug that provokes a double execution of the Update method of z3c.form when you launch Firebug Lite in Google Chrome. Be careful when you are developping in that environment.
I guess that firebug lite triggers an undesirable event.
New package affinitic.templer
Oct 1st
We just created a new package to gain a lot of time when we create new plone packages from scratch. The main goal is to maximum simplify this creation. This can include a diazo theme.
All the details are in the README of the package found in https://github.com/affinitic/templer.affinitic
Remove broken portlets programmatically
Mar 27th
If you have specific broken portlets that needs to be removed from your Plone site, you will have to reinstall the product that contains your portlets, otherwise you will get this error :
Traceback (innermost last): Module ZPublisher.Publish, line 126, in publish Module ZPublisher.mapply, line 77, in mapply Module ZPublisher.Publish, line 46, in call_object Module plone.app.portlets.browser.kss, line 66, in delete_portlet Module zope.container.ordered, line 243, in __delitem__ Module zope.container.contained, line 647, in uncontained Module OFS.Uninstalled, line 45, in __getattr__ AttributeError: __parent__
But what if you just can’t find / reinstall the product ?
You could already remove the broken portlet through Plone UI, thanks to packages like collective.braveportletsmanager. Now you will be able to do it without any additional package thanks to this change in plone.app.portlet.
If you want to delete broken portlets programmatically, this is possible by disabling the error raised before your usual portlet removal function (see fixing_up
in zope.container.contained
) :
from zope.container import contained contained.fixing_up = True manager = getUtility(IPortletManager, name=u'plone.leftcolumn', context=portal) assignments = getMultiAdapter((portal, manager), IPortletAssignmentMapping) for portlet in assignments: del assignments[portlet] contained.fixing_up = False
We used this in a migration step for a customer.
Enjoy !
Filter menu using a grok view
Mar 4th
You want a menu to be seen only in certain conditions without creating a new “permission” stuff. You can use the filter attribute in your menuItem. You can access the request and context in it.
Simple example:
<menuItem for="*" title="My dinosaur menu" description="" permission="zope.Public" action="@@mydinosaurpage" menu="mainmenu" filter="context/@@displayForDinosaursOnly"/>
Now we have to create a view that will be called by the filter attribute, the only working way I found was using a grok view (e.g. menufilter.py):
from five import grok from Products.CMFCore.utils import getToolByName from zope.interface import Interface class DisplayForDinosaursOnly(grok.View): """ Menu using that class as filter will be displayed for Dinosaurs roles """ grok.context(Interface) grok.name('displayForDinosaursOnly') def render(self): pm = getToolByName(self.context, 'portal_membership') roles = pm.getAuthenticatedMember().getRoles() return 'Dinosaur' in roles
And finally register your grok view:
<grok:grok package="my.package.ns.menufilter" />
And voilà! Your dinosaur menu will only be seen by dinosaurs, the filter is working.