Getting Started with AEM Sites - WKND Tutorial
A multi-part tutorial designed for developers new to Adobe Experience Manager. Walks through the implementation of an AEM site for a fictitious lifestyle brand the WKND. Covers fundamental topics like project setup, Core Components, Editable Templates, client libraries, and component development with Adobe Experience Manager Sites.
WKND Tutorial Overview
The goal for this multi-part tutorial is to teach a developer how to implement a website using the latest standards and technologies in Adobe Experience Manager (AEM). After completing this tutorial a developer understands the basic foundation of the platform and has knowledge of common design patterns in AEM.
The implementation works as-is on AEM 6.5 and AEM 6.4.2+. Many of the topics apply to all versions of AEM. The site is implemented using:
- Sling Models
- Touch UI
- Core Components v2.4.0
- Editable Templates
- Style System
- Maven AEM Project Archetype v18
Estimate 1-2 hours to get through each part of the tutorial.
A previous version of this tutorial existed that leveraged a different Maven archetype for the project. The finished code for the previous tutorial can be found here
WKND Site Design
The WKND is a fictional online magazine and blog that focuses on nightlife, activities, and events in several international cities. To make this tutorial closer to a real-world scenario one of Adobe's talented UX designers created the mockups for the site. Over the course of the tutorial various pieces of the mockup are implemented into a fully author-able AEM site. Special thanks to Lorenzo Buosi who created the beautiful design for the WKND site.
The name WKND is fitting because we expect a developer to take the better part of a weekend to complete the tutorial.
All of the code for the project can be found on Github in the AEM Guide repo:
In addition, each part of the tutorial has its own branch in GitHub. A user can begin the tutorial at any point by simply checking out the branch that corresponds to the previous part.
Table of Contents
In general each Part of the tutorial takes about 1-2 hours.
Project Setup - Covers the creation of a Maven Multi Module Project to manage the code and configurations for an AEM Site.
Maven, Lazybones Template, Eclipse IDE, Core Components, SCM, and Github
Creating a Base Page and Template - Covers the creation of a base page and an editable template. Core Component proxies are inspected.
Developing with the Style System - Covers extending Core Components with brand-specific CSS and leveraging the Style System to create multiple variations of components. This part also uses Content Fragments for long form article content and covers some advanced policy configurations of the Template Editor.
CSS, Style System, Template Editor Policies
Creating a custom AEM Component - Covers the end to end creation of a custom byline component that displays authored content. Includes developing a Sling Model to encapsulate business logic to populate the byline component and corresponding HTL to render the component.
Sling Models, HTL, Style System, Custom Components
Header and Footer - Covers dynamic navigation driven by the content hierarchy and fixed navigation populated by content authors. Sling Models, HTL templating language, and dialogs are used to implement the Header and Footer navigation. A Quick Search component is also added to the Header.
HTL, Design Dialogs, Composite Components
Landing Page - Covers the implementation of the Teaser and Carousel components to populate a dynamic and exciting Homepage.