There are many ways to skin a cat, and many ways to utilize Magnolia for your content management goals. However, over the years, a set of best practices have evolved that allow IT teams to scale and to achieve a maintainable state for their Magnolia installation. No matter if you already have projects running or are about to begin your first one, this session is a must see to ensure the long-term sanity of your project and your developers.
Implement projects successfully with Magnolia best practices
1. Implement Projects Successfully
with Magnolia Best Practices
Natascha Desmarais, Trainer
March 6-8, 2013 at #Mplify
1 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
2. About me
Services Team
Trainings, trainings, trainings, …
Customer projects
Magnolia Academy
2 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
3. Agenda
! Why you need this
! Base setup
! Advanced configuration
! Extending
! Developing in your IDE
! Version handling
! Questions
3 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
4. Why you need this
! Feel more confident about your project
! Feel at ease with the powerful tool in your hand
! Many ways to achieve a goal, what would we recommend?
! Reassurance for your own project handling
! Maintenance and recognition factor
! Migration path
4 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
5. Base Setup – Starting from scratch
! Use maven archetypes if possible [1]
! General project layout
! Blog post series [2]: “Don’t build/configure/deploy
magnolia, …”
[1] http://wiki.magnolia-cms.com/display/WIKI/Module+QuickStart
[2] http://dev.magnolia-cms.com/~gjoseph/dont-build-magnolia-build-your-projects
http://dev.magnolia-cms.com/~gjoseph/dont-configure-magnolia-let-your-projects-configure-it
http://dev.magnolia-cms.com/~gjoseph/dont-deploy-magnolia-deploy-your-project
5 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
6. Advanced configuration
! Before starting:
• Security concept
• Multilanguage
! magnolia.properties [3]
! Subscribers
! Site configuration
! Messages
[3] http://documentation.magnolia-cms.com/administration/deployment/war-file-with-multiple-configurations.html
6 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
7. Extending
! How does the mechanism work?
• Extends & extends-override [4]
• Absolute & relative paths
! Do not reinvent the wheel!
• Use existing configurations: STK, Form, …
• Extend even if there are no local changes!
[4] http://documentation.magnolia-cms.com/technical-guide/configuration-mechanisms.html#Extendingconfiguration
http://documentation.magnolia-cms.com/reference/controls.html#Extendingconfiguration
7 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
8. Extending
Advantages Disadvantages
✔ Maintainability ✖ No automatic notifications
✔ Readability ✖ Extending overdone
✔
Advantages
Automatic updates for bugfixes
✔ Easy injection of own messages ✖ Need to implement STK / other
messages
✔ Migration path
8 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
9. Developing in your IDE
! Module structure
! Bypass / Resources
! Templates vs Inplace Templates
! Export configurations
! Clean backup repository
9 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
10. Version handling
! Abstract- and DefaultMVH
info.magnolia.module.AbstractModuleVersionHandler
info.magnolia.module.DefaultModuleVersionHandler"
! getBasicInstallTasks vs getExtraInstallTasks
! getDefaultUpdateTasks vs single deltas
10 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
11. Questions
11 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
12. Thank you!
Natascha Desmarais, Trainer March 6-8 at #Mplify
Magnolia International Ltd.
natascha.desmarais@magnolia-cms.com
www.magnolia-cms.com
12 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
13. 13 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.
14. 14 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.