project logo

Cartaro Quickstart

Cartaro is a geo-enabled Content Management System (CMS) to manage and publish geospatial and non-geospatial content.

This Quickstart will guide you through the following tasks:

  1. Create a new geospatial content type
  2. Configure Cartaro to display the new content type
  3. Add new geospatial content

All tasks will be performed using the example of a touristic web portal with the goal to map lakes.

Starting Cartaro

  1. Start the OSGeoLive DVD
  2. Choose Geospatial ‣ Browser Clients ‣ Start Cartaro to start Cartaro
  3. The Cartaro web page http://localhost/cartaro will automatically open

Front Page

When the Cartaro page is opened, you will see the screen below. The front page contains a global map with capital cities as an example.

../../_images/cartaro_frontpage.png
  • Please Log in on the upper right corner to access the administrative interface with admin as username and geoserver as password. You will now see the administration menu bar on top.
../../_images/cartaro_userpage.png

Tip

You can return to the front page anytime by click on the home icon in the upper left corner.

Creating a new Content type

Content types and fields define the structure of a specific content (e.g. the content type Capital contains the fields “name” and “location” to generate content elements for the respective capitals displayed on the map). To create a new content type, follow the steps below.

  • Choose Structure ‣ Content types on the menu bar and click on Add content type
../../_images/cartaro_addcontenttype.png
  • Type a name for the new content type and describe it if you want.
../../_images/cartaro110.png
  • Finish by click on Save and add fields
  • Add a new field for your content type by entering a descriptive name. We want to create a geospatial field with the name Geometry. Select Geospatial data as field type and OpenLayers Map as widget.
../../_images/cartaro210.png
  • Finish by click on Save
  • Choose your field settings in the new window: Select the geometry type that describes the kind of geospatial information you want to store. Choose Polygon to follow our example.
../../_images/cartaro310.png

Tip

Read the text below the Geometry type drop-down box to find the geometry type that fits your needs.

  • Finish by click on Save field settings
../../_images/cartaro410.png
  • Press Save settings to finish the field creation
../../_images/cartaro510.png
  • Under the tab Manage fields you could create further non-geospatial fields. We don’t need to create a new one for our example.

Configuring GeoServer

GeoServer is used to provide layers via Web Feature Service (WFS) and Web Map Service (WMS) with the geospatial field from your newly created content type.

  • Choose Structure ‣ GeoServer from the menu bar to visit the GeoServer configuration page
../../_images/cartaro_geoserver_entry.png

Creating a new layer in GeoServer

  • Use GeoServer layers to publish your geospatial data.
  • Choose Structure ‣ GeoServer from the menu bar to visit the GeoServer configuration page again
  • Select Layers and click Add to add a new layer
../../_images/cartaro_geoserver_addnewlayer.png
  1. Type a suitable layer title (e.g. lakes).
  2. Select the layer type. We choose PostGIS Field for advanced geospatial operations and geodata storage.
  3. As source select your created content type which will be associated with your new layer.
  4. Make the checkmark Provide an OpenLayers WFS layer within the OpenLayers section.
  5. Finish configuration by click on Save
../../_images/cartaro710.png
  • Congratulation! Your new GeoServer layer was added to GeoServer.

Tip

You can now also access the geospatial fields of your content type via WFS or WMS with other applications (e.g. with QGis)

Configuring OpenLayers to activate your GeoServer layer in a map

OpenLayers is used to display your new layer on a map. You will now associate your GeoServer layer with your OpenLayers map.

  • Go to Structure ‣ OpenLayers ‣ Maps to visit the OpenLayers maps configuration page
  • Look for frontmap - a pre-generated, default map and select Edit on the right side.
../../_images/cartaro_openl_maps_frontmapedit.png
  • frontmap’s configuration page appears as shown on the screenshot below.
../../_images/cartaro_openlayers_frontmapediting.png
  • Select Layers & Styles in the left sidebar to add our newly created layer to the frontmap.
  • Look for your created GeoServer layer (‘lakes’ in our example)
  • Make checkmarks for Enabled, Activated and In Switcher to activate your new layer lakes in your map
../../_images/cartaro_openl_layersstylessettings.png
  • Finish configuration by clicking on Save at the bottom

Adding geospatial content

After creating your content type and configuring GeoServer and OpenLayers you can now add as many content elements of this type as you want.

  • Choose Content from the menu bar to see all existing content elements within your Cartaro installation
../../_images/cartaro_contentlist.png
  • Select Add content to add more content and choose your new content type in the appearing window (not shown). In the configuration page of your new content element (called node in Drupal language) make the following settings:
  1. Type a name
  2. You can draw the geometry for your content element. Choose the draw symbol on the upper right corner of the map. Note that tool tips are shown when you hover the toolbar icons. Click on the map to create a new geometry. Finish the drawing with double click.
  3. Save your geometry.

Note

Only one geometry per content element can be drawn in our example configuration. Create additional content elements to add more polygons.

../../_images/cartaro810.png
  • You should now see your new content element
../../_images/cartaro_addedcontent_lakefr.png
  • To view your new content element on the front map, click on the house icon in the upper left corner
../../_images/cartaro_addedcontent_frontmap.png

Congratulations, you have just finished the quickstart tutorial. Your first content element is now ready. To add more content elements simply peform the steps of this section again.

Things to Try

  • Use the Layer Assistant to include external layers Structure ‣ Open Layers ‣ Layers ‣ Add using assistant
  • Change the default map behaviors and build your own map
  • Try different geometry types and build more complex content types

What Next ?

The quickstart has given a first impression about the possibilities of Cartaro to you. But there is a lot more to discover.

Your next step may be to install Cartaro on your own servers. Just visit http://cartaro.org/documentation/getting-started to learn how.

In context to this quickstart, check our documentation about Layer Assistant or about Styling

Our documentation web page can be found here http://cartaro.org/documentation

Available on http://cartaro.org