Mastering Plone 5 development

This is the documentation for the "Mastering Plone 5" training.

Mastering Plone is intended as a week-long training for people who are new to Plone or want to learn about the current best practices of Plone development. It can be split in two trainings:

• A beginner training (2 to 3 days) that covers chapters 1-18.

• An advanced training (3 to 5 days) that covers the rest.

At conferences a shortened 2-day version of the advanced training with a slightly modified order is held.

Mastering Plone 5

• 1. About Mastering Plone
  • 1.1. Upcoming Trainings
  • 1.2. Previous Trainings
  • 1.3. Trainers
  • 1.4. License
  • 1.5. Using the documentation for a training
  • 1.6. Contributing
• 2. Introduction
  • 2.1. Who are you?
  • 2.2. What will we do?
  • 2.3. What will we not do?
  • 2.4. What to expect
  • 2.5. Classroom Protocol
  • 2.6. Documentation
  • 2.7. Further Reading
• 3. What is Plone?
  • 3.1. Core concepts
• 4. Installation & Setup
  • 4.1. Installing Plone
  • 4.2. Hosting Plone
  • 4.3. Production Deployment
• 5. The Case Study
  • 5.1. Background
  • 5.2. Requirements
• 6. The Features of Plone
  • 6.1. Starting and Stopping Plone
  • 6.2. Walkthrough of the UI
  • 6.3. Users
  • 6.4. Configure a Mailserver
  • 6.5. Content-Types
  • 6.6. Folders
  • 6.7. Collections
  • 6.8. Content Rules
  • 6.9. History
  • 6.10. Manage members and groups
  • 6.11. Workflows
  • 6.12. Working copy
  • 6.13. Placeful workflows
• 7. The Anatomy of Plone
  • 7.1. Database
  • 7.2. Zope
  • 7.3. Content Management Framework
  • 7.4. Zope Toolkit / Zope3
  • 7.5. Zope Component Architecture (ZCA)
  • 7.6. Pyramid
  • 7.7. Exercise
• 8. What's New in Plone 5, 5.1 and Plone 5.2
  • 8.1. Default Theme
  • 8.2. New UI and widgets
  • 8.3. Folder Contents
  • 8.4. Content Types
  • 8.5. Resource Registry
  • 8.6. Chameleon template engine
  • 8.7. Control panel
  • 8.8. Date formatting on the client side
  • 8.9. plone.app.multilingual
  • 8.10. New portlet manager
  • 8.11. Remove portal_skins
  • 8.12. Plone 5.1
  • 8.13. Plone 5.2
• 9. Configuring and Customizing Plone "Through The Web"
  • 9.1. The Control Panel
  • 9.2. Portlets
  • 9.3. Viewlets
  • 9.4. ZMI (Zope Management Interface)
  • 9.5. Summary
• 10. Theming
• 11. Extending Plone
  • 11.1. Extension technologies
• 12. Extend Plone With Add-On Packages
  • 12.1. Some notable add-ons
  • 12.2. How to find add-ons
  • 12.3. Installing Add-ons
  • 12.4. collective.easyform
  • 12.5. Add page layout management with plone.app.mosaic
  • 12.6. Internationalization
  • 12.7. Summary
• 13. Dexterity I: "Through The Web"
  • 13.1. What is a content type?
  • 13.2. The makings of a Plone content type
  • 13.3. Dexterity and Archetypes - A Comparison
  • 13.4. Modifying existing types
  • 13.5. Creating content types TTW
  • 13.6. Moving contenttypes into code
  • 13.7. Exercises
• 14. Buildout I
  • 14.1. Minimal Example
  • 14.2. Syntax
  • 14.3. Recipes
  • 14.4. References
  • 14.5. A real life example
  • 14.6. Mr. Developer
  • 14.7. Extensible
  • 14.8. Be McGuyver
• 15. Write Your Own Add-Ons to Customize Plone
  • 15.1. Creating the package
  • 15.2. Eggs
  • 15.3. Inspecting the package
  • 15.4. Including the package in Plone
  • 15.5. Exercises
  • 15.6. Summary
• 16. Return to Dexterity: Moving contenttypes into Code
  • 16.1. Changing a widget
  • 16.2. Protect fields with permissions
  • 16.3. Summary
• 17. Views I
  • 17.1. A simple browser view
• 18. Page Templates
  • 18.1. TAL and TALES
  • 18.2. Chameleon
  • 18.3. Exercise 1
  • 18.4. METAL and macros
  • 18.5. Accessing Plone from the template
  • 18.6. Exercise 2
  • 18.7. Accessing other views
  • 18.8. What we missed
• 19. Customizing Existing Templates
  • 19.1. The view for News Items
  • 19.2. The Summary View
  • 19.3. Finding the right template
  • 19.4. skin templates
  • 19.5. Summary
• 20. Views II: A Default View for "Talk"
  • 20.1. View Classes
  • 20.2. Browser Views
  • 20.3. Reusing Browser Views
  • 20.4. The default view
  • 20.5. Using helper methods from DefaultView
  • 20.6. The complete template for talks
  • 20.7. Behind the scenes
• 21. Views III: A Talk List
  • 21.1. Using portal_catalog
  • 21.2. brains and objects
  • 21.3. Querying the catalog
  • 21.4. Exercises
  • 21.5. The template for the listing
  • 21.6. Setting a custom view as default view on an object
  • 21.7. Summary
• 22. Testing in Plone
  • 22.1. Types of tests
  • 22.2. Writing tests
  • 22.3. Plone tests
  • 22.4. Robot tests
  • 22.5. More information
• 23. Behaviors
  • 23.1. Dexterity Approach
  • 23.2. Names and Theory
  • 23.3. Practical example
  • 23.4. Adding it to our talk
• 24. Writing Viewlets
  • 24.1. A viewlet for the featured behavior
  • 24.2. Featured viewlet
  • 24.3. Exercise 1
  • 24.4. Exercise 2
• 25. Programming Plone
  • 25.1. plone.api
  • 25.2. portal-tools
  • 25.3. Debugging
  • 25.4. Exercise
• 26. IDEs and Editors
• 27. Dexterity Types II: Growing Up
  • 27.1. Add a marker interface to the talk type
  • 27.2. Upgrade steps
  • 27.3. Add a browserlayer
  • 27.4. Add catalog indexes
  • 27.5. Query for custom indexes
  • 27.6. Exercise 1
  • 27.7. Add collection criteria
  • 27.8. Add versioning through GenericSetup
  • 27.9. Summary
• 28. Custom Search
  • 28.1. eea.facetednavigation
  • 28.2. collective.collectionfilter
• 29. Turning Talks into Events
  • 29.1. Exercise 1
  • 29.2. Exercise 2
• 30. User Generated Content
  • 30.1. Self-registration
  • 30.2. Constrain types
  • 30.3. Grant local roles
  • 30.4. A custom workflow for talks
  • 30.5. Move the changes to the file system
• 31. Resources
• 32. Using Third-Party Behaviors
  • 32.1. Add Teaser With collective.behavior.banner
• 33. Dexterity Types III: Python
  • 33.1. The Python schema
  • 33.2. The Factory Type Information, or FTI
  • 33.3. The view
  • 33.4. The viewlet
  • 33.5. The template for the viewlet
• 34. Dexterity: Reference
  • 34.1. Fields included in Plone
  • 34.2. How fields look like
  • 34.3. 3rd party fields
  • 34.4. Datagrid Field
  • 34.5. Widgets
  • 34.6. Directives
• 35. Relations
  • 35.1. Creating relations in a schema
  • 35.2. Accessing and displaying related items
  • 35.3. Creating RelationFields through the web
  • 35.4. The stack
  • 35.5. RelationValues
  • 35.6. Accessing relations and backrelations from code
• 36. Manage Settings with Registry, Control Panels and Vocabularies
  • 36.1. The Registry
  • 36.2. A setting
  • 36.3. Accessing and modifying values in the registry
  • 36.4. Add a custom control panel
  • 36.5. Vocabularies
• 37. Creating a Dynamic Front Page
  • 37.1. The Front Page
  • 37.2. The template
  • 37.3. Twitter
  • 37.4. Activating the view
• 38. Creating Reusable Packages
• 39. More Complex Behaviors
  • 39.1. Using Annotations
  • 39.2. Using Schema
  • 39.3. Writing Code
• 40. A Viewlet for the Votable Behavior
  • 40.1. Voting Viewlet
  • 40.2. Writing the Viewlet code
  • 40.3. The template
  • 40.4. JavaScript code
  • 40.5. Writing 2 simple view helpers
• 41. Making Our Package Reusable
  • 41.1. Adding permissions
  • 41.2. Using our permissions
  • 41.3. Provide defaults
• 42. Using starzel.votable_behavior in ploneconf.site
• 43. Releasing Your Code
• 44. Buildout II: Getting Ready for Deployment
  • 44.1. The Starzel buildout
  • 44.2. A deployment setup
  • 44.3. Other tools we use
• 45. Plone REST API
  • 45.1. Installing plone.restapi
  • 45.2. Explore the API
  • 45.3. Implementing the talklist
  • 45.4. Submit lightning talks
  • 45.5. Exercise
• 46. The Future of Plone
• 47. Optional
• 48. Using the code for the training
  • 48.1. The code-package
  • 48.2. Getting the code for a certain chapter
  • 48.3. Moving from chapter to chapter
  • 48.4. Tags
  • 48.5. Updating the code-package

Please note that this document is not complete without the spoken word of a trainer.

Even though we attempt to include the most important parts of what we teach in the narrative but reading it here can in no way be considered equal to attending a training.