Thursday, August 29, 2013

Magnolia CMS and Blossom on Chariot TechCast

There's a new episode out of the Chariot TechCast, this time the topic of discussion is Magnolia CMS and the Blossom spring integration module. Listen in as Boris Kraft, CTO of Magnolia and myself talk with Ken Rimple about the history of Magnolia, the revamped user interface in version 5 and of course in depth about how the Blossom module works!

The podcast is available on iTunes and as a direct download on the Chariot TechCast site.

For iPhone there's a great podcasts app from Apple, that I discovered only recently. It lets you subscribe to podcasts and can download new episodes automatically when on WiFi as they become available. Check it out and subscribe to Chariot's podcasts, lots of interesting stuff in these for Spring developers.

Wednesday, August 28, 2013

Submit your Blossom questions in our online Q&A

As I mentioned in my last blog post, Blossom 3 brings a number of changes to how dialogs and fields are configured. To make it easier to understand these changes, I'll be hosting an online Q&A in about three weeks to answer user-submitted questions about the new Blossom module.

Register now and submit your questions.

I'll be hosting this online event on 26 September at 5 PM CET (8 AM PDT) together with my colleague Daniel Lipp. If you run into problems integrating your Spring application with Blossom 3, or have suggestions for improvements, this is the ideal forum to make your voice heard and have your issues resolved.

See you there!

Friday, August 23, 2013

Blossom 3 alpha 1 released

I have just released the first alpha of Blossom 3.

Blossom 3 is a major update that brings support for Magnolia 5. In particular the new dialogs introduced as part of the brand new user interface.

Blossom 3 builds on Magnolia 5.1, which is also in development and both will be released this September in time for this years Magnolia conference.

The new user interface is built using Vaadin. A component based UI toolkit where the components run on the server and renders on the client using Google web toolkit. This makes it much easier than before to develop custom fields for your projects.

In previous versions of Blossom you would create and configure controls, now instead you build an object model that defines how the dialog and its fields should appear and behave. This definition
model is then used as a blueprint to create and configure Vaadin components.

For composing the definition model Blossom 3 uses a builder style API that creates a more fluent programming style. A new set of classes replaces the previous API. These classes include a new TabBuilder and DialogBuilder and provides builders for each of the built-in fields, making it easier to configure properties on the fields.

@TabFactory("Content")
public void contentTab(UiConfig cfg, TabBuilder tab) {
    tab.fields(
            cfg.fields.text("title").label("Title"),
            cfg.fields.checkbox("hideInNavigation").label("Hide in navigation").description("Check this box to hide this page in navigation")
    );
}


The fields now have much better support for validation which is why @TabValidator and @DialogValidator have been removed in this version.

@TabFactory("Content")
public void contentTab(UiConfig cfg, TabBuilder tab) {

    tab.fields(
            cfg.fields.text("title").label("Title").validator(
                    cfg.validators.email().errorMessage("A title is required")
            ),
            cfg.fields.checkbox("hideInNavigation").label("Hide in navigation").description("Check this box to hide this page in navigation")
    );
}


Using Springs freemarker macros for forms is now straight forward. When rendering freemarker views Blossom will expose a RequestContext object which these macros require, it will also expose everything in the model as request attributes. This feature is enabled by default but can be switched off on the FreemarkerTemplateViewRenderer..

The multipart support that bridges Springs multipart handling to the multipart support in Magnolia has been updated for API changes in Spring 3.1.

The sample has also been updated and as always, this is the best place to start.

Get the source and start it up with these commands:

git clone http://git.magnolia-cms.com/git/modules/blossom/samples.git
cd samples
git checkout magnolia-blossom-samples-3.0-alpha1
mvn install
cd magnolia-blossom-sample-webapp
mvn jetty:run-war

UPDATE: When running it like this from the command line you might run into issues where the application does not have enough memory, especially in the perm gen pool. To get around that do this first:

export MAVEN_OPTS="-XX:+CMSClassUnloadingEnabled -XX:PermSize=256M -XX:MaxPermSize=512M -Xmx512m"

UPDATE 2: The alpha1 release of Blossom builds on the alpha1 release of Magnolia 5.1. If you need to use a more recent build of Magnolia 5.1 you should use the corresponding Blossom release or use the latest SNAPSHOT.


Stay tuned!