Added by Jeremy Quinn, last edited by Ard Schrijvers on Jan 18, 2007  (view change)

Labels:

sample sample Delete
site site Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.

A very basic sample Hippo Site, designed to show you how the various parts work together.

The Sample Site

  • Download the latest sample version (18/01/07 it is v1.02.01) from Hippo CMS sample website ZIP file, and unpack it into a directory of your choice.
  • Use cocoon-2.1.10 or newer. The Simple Site Sample older Cocoon versions
  • In sitemap.xmap of the sample website, set the global variables "previewRepository" and "liveRepository" to the correct URLs in your setup. For example, if your repository runs on "http://localhost:60000/default" (which is the default), set the global variables as follows: 
    <map:component-configurations>
  <global-variables>
    <repositoryRoot>webdav://siteuser:siteuser@localhost:60000/default/</repositoryRoot>
    <previewPath>files/default.preview/</previewPath>
    <livePath>files/default.www/</livePath>
  </global-variables>
</map:component-configurations>
  • In the Cocoon directory, rename mount-table.xml.sample to mount-table.xml and add the following line within the <mount-table> element: 
    <mount uri-prefix="hippo-sample/" src="LOCATION"/>

    where LOCATION must be replaced by the exact location of the Hippo CMS sample site files.

  • Start Cocoon in that console by typing:
    • ./cocoon.sh servlet
  • Open http://localhost:8888/hippo-sample/ in your browser.

Usage

In the "http://localhost:8888/hippo-sample/" url you will find an almost empty page containing just two links: "preview" and "live". Clicking on one of these links will lead you to either to preview website, which shows all documents in the CMS, or the live site, which shows only the published documents.

How does it work?

Preview and live

The only real difference between the preview and live websites is the repository they retrieve their content from. The preview website uses the same repository as the CMS. Every change you make to a document in the CMS will be immediately visible on the preview website. The live website on the other hand, uses the repository to which document are published. Documents in the CMS will only be visible on the live website after they have been published.

DASL query

The pipeline "*/documents" retrieves a list of available documents in the CMS folder "documents" from the repository by doing a DASL query (using the DASLTransformer). The result is transformed into the navigation menu on the left side of the XHTML pages in the site. The DASL syntax is described in Using DASL Queries.

Further Reading

Configuration Properties Reference
Input Module Reference
Source Reference
DASL Reference
Hippo Cocoon Plugin Reference
HippoJXTemplate Reference

You may also find The Site Skeleton useful.