Implement projects successfully with Magnolia best practices

March 6-8, 2013 at #Mplify Natascha Desmarais, Trainer

Implement Projects Successfully with Magnolia Best Practices

1 Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.

2

About me

Version 1.1 Magnolia is a registered trademark owned by Magnolia International Ltd.

Services Team

Trainings, trainings, trainings, …

Customer projects

Magnolia Academy

!   Why you need this

!   Base setup

!   Advanced configuration

!   Extending

!   Developing in your IDE

!   Version handling

!   Questions

3

Agenda


!   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

Why you need this


!   Use maven archetypes if possible [1]

!   General project layout

!   Blog post series [2]: “Don’t build/configure/deploy

magnolia, …”

5

Base Setup – Starting from scratch


[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

!   Before starting:

•  Security concept

•  Multilanguage

! magnolia.properties [3]

!   Subscribers

!   Site configuration

!   Messages

6

Advanced configuration


[3] http://documentation.magnolia-cms.com/administration/deployment/war-file-with-multiple-configurations.html

!   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!

7

Extending


[4] http://documentation.magnolia-cms.com/technical-guide/configuration-mechanisms.html#Extendingconfiguration http://documentation.magnolia-cms.com/reference/controls.html#Extendingconfiguration

8

Extending


Advantages

Advantages Disadvantages

✔  Maintainability

✔  Readability

✔  Automatic updates for bugfixes

✔  Easy injection of own messages

✔  Migration path

✖  No automatic notifications

✖  Extending overdone

✖  Need to implement STK / other messages

!   Module structure

! Bypass / Resources

!   Templates vs Inplace Templates

!   Export configurations

!   Clean backup repository

9

Developing in your IDE


!   Abstract- and DefaultMVH info.magnolia.module.AbstractModuleVersionHandler

info.magnolia.module.DefaultModuleVersionHandler"

! getBasicInstallTasks vs getExtraInstallTasks

! getDefaultUpdateTasks vs single deltas

10

Version handling


Questions


March 6-8 at #Mplify [email protected]

Natascha Desmarais, Trainer Magnolia International Ltd.

www.magnolia-cms.com

Thank you!


Implement projects successfully with Magnolia best practices

Documents

Transcript of Implement projects successfully with Magnolia best practices