| Sling ESP blog sample |
| --------------------- |
| |
| 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-<version>-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. |
