tree: 14b865f8091f6265e6da744d058353f669d6d472 [path history] [tgz]
  1. README.md
  2. pom.xml
  3. src/
espblog/README.md

Apache Sling ESP blog sample

This module is part of the Apache Sling project.

WHY THIS SAMPLE?

This demonstrates the use of ESP server-side javascript to implement a simple blog, with file attachments.

A java service uses JCR observation to detect incoming files (either uploaded via the blog forms, or copied via WebDAV), and creates thumbnails of files image files, to demonstrate observation and OSGi SCR services.

PRECONDITIONS

As a first step, launch Sling.

The Sling Container can be launched by running the following command in the launchpad/builder/target directory: java -jar org.apache.sling.launchpad--standalone.jar so if the current version is 7, the command should be: java -jar org.apache.sling.launchpad-7-standalone.jar

This launches sling on the default port: 8080.

Once Sling is running, deploy the ‘path-based-rtp’ bundle, which is required by this demo: samples/path-based-rtp$ mvn clean install -P autoInstallBundle

INSTALL ESPBLOG

Install the espblog demo with the following command: mvn clean install -P autoInstallBundle

To verify that the bundle is correctly installed:

  1. http://localhost:8080/apps/espblog/html.esp must return the html.esp script.

  2. Log in by visiting http://localhost:8080/?sling:authRequestLogin=true, using username=admin and password=admin

  3. The console at http://localhost:8080/system/console/bundles must list both the following bundles as active:

    Apache Sling ESP blog sample (org.apache.sling.samples.espblog) Apache Sling Sample Path Based Resource Type Provider (org.apache.sling.samples.path-based.rtp)

HOW TO TEST

The http://localhost:8080/content/espblog/*.html should display the “Sling ESP blog sample” page, with the Home/Admin/New Post/... menu.

Create a new post using the “New Post” menu.

The post can include an attachment, if that‘s an image the included ThumbnailGeneratorService generates thumbnails in different sizes, displayed on the post’s page. This happens asynchronously, so depending on your machine's speed the thumbnails might only appear after a few seconds.

Clicking on the Home menu item will show all the blog entries. The Admin menu item allows you to edit and delete entries.

Clicking on the RSS menu item shows an alternative rendering of the posts list.

The ESP scripts can be found under /apps/espblog in the repository.