Use and development of your product Use valid name for your product -- A products which name starts with a digit won't be installable in Plone, even if you see it registered as a Zope product in the ZMI in Control_Panel > Products. Empty all caches (!!) -- If the changes you applied to the product don't show out the way you planned, or if some skin elements persist after you uninstalled the product, make sure that either the browser and the front-end proxy caches (apache, squid) are emptied, and reload the current page.In Firefox, press shift while clicking the reload button. In IE
.If you didn't uninstall the product before renaming it or the skin selection, revert your changes on the filesystem, uninstall the product and rename the elements again. Check that the product is loaded in Zope -- From the ZMI
, go to '/Control_Panel/Products/manage_main' and check that the product is listed and not marked as broken.
If it's not listed you should double check the product installation on the filesystem, making sure that the user who launches the Zope server has at least read access on it.If it is marked as broken, you should check your error log and make sure that your business python code is valid (this should only happen if you added a broken Python class definition to your initial skeleton Plone style product). Make sure that the product is installable in Plone -- If your product is not listed or is marked as removed in *Site Setup > Add/Remove Products* or in the Quick Installer (*portal_quickinstaller* in the ZMI
), it probably means that you have to debug the module 'Extensions/Install.py'. Use the provided testing framework -- DIYPloneStyle comes with basic unit tests.Follow the links from the "Resources":resources chapter of this tutorial if you care about learning the Plone Unit Testing Framework. Use of the generator script Check that the script uses the right python interpreter -- Thank you Casper R. Nielsen for suggesting me to add this point.
With unix like systems, you can run the script by calling it directly, omitting the python command. If you get the error 'bad interpreter: No such file or directory' by calling the script that way, it's because the first line of the script refers to a file that does not exist.To make it run without error, you can either:
- prefix the shell command by the python command
$ python generator.py --productname CustomSkinor by the full path of the python interpreter. For instance:
$ /usr/local/bin/python generator.py --productname CustomSkin
- edit the first line of the script to make it point to your python interpreter.
Traceback (most recent call last): File "DIYPloneStyle/bin/generator.py", line 226, in ? generateDirectoryCopy( path, path.replace('DIYPloneStyle', productname) ) File "DIYPloneStyle/bin/generator.py", line 182, in generateDirectoryCopy os.mkdir(dstDirectory) OSError: [Errno 13] Permission denied: '/Users/david/plone-instance/Products/CustomStyle/'it is probably because you don't have write permissions on the folder where DIYPloneStyle resides and where the new product will be created. Get Further support From the Plone community -- Before adding a comment to the manual, please post your question/issue on the "plone-users":/contact#users mailing list or try to get some support on the IRC
"#plone":irc://irc.freenode.net/plone channel.From the DIYPloneStyle product authors -- Feel free to contact DIYPloneStyle authors by sending them an email (email addresses appear in the product 'README.txt' file).