Cartaro Quickstart ¶

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

This Quick Start will guide you through the following tasks:

Create a new geo-enabled content type

Configure Cartaro to display the new content type

Add new content

Contents

Cartaro Quickstart

Start Cartaro ¶

Choose Geospatial ‣ Browser Clients ‣ Start Cartaro.
The application will take a few moments to start up
Go to the Cartaro web page at http://localhost/cartaro (this should happen automatically)

Front Page ¶

When you open the Cartaro page, you will see the screen above. The front page contains an example map with capital cities.

Click on Log in on the upper right corner to access the administrative interface. Please use admin as username and geoserver as password. You will now see the admin tool bar on top.

Tip

You can return to the Front Page anytime by clicking on the home icon in the upper left corner.

Content types are describing the fields and the structure of a specific kind of content (e.g. the content type Capital contains the fields name and location). To create a new content type, just follow the steps below.

Choose Structure ‣ Content types from the menu bar and click on Add content type

Type a name for the new content type and describe it if you want
Finish by clicking on Save and add fields

../../_images/cartaro_new_contenttype.png

Add new field by choosing a descriptive name, select Geospatial data as field type and OpenLayers Map as widget
Finish by clicking on Save

Select the geometry type that describes the kind of geospatial information you want to store. Choose Polygon to follow our example.
Finish by clicking on Save field settings

Tip

Other types of geometry are also available. Choose the type that fits best for your needs. Read the information below the Geometry type drop-box for additional help.

../../_images/cartaro_field_settings.png

Press Save settings to finally finish the field creation

Configure GeoServer ¶

GeoServer is used to provide the geospatial fields of your new content type as layer via Web Feature Service (WFS) and Web Map Service (WMS).

Choose Structure ‣ GeoServer from the menu bar to visit the GeoServer configuration page

../../_images/cartaro_geoserver_entry.png

Styling ¶

Note

This subsection is optional. Just go the next subsection if you want to speed up.

To change the symbolization of your geospatial fields within a map layer you can define your own style. This is done with the Styled Layer Descriptors (SLD) as XML files. There are several ways on how create them which is not covered here. The GeoServer documentation describes one way on how the create them. For the sake convenience we created an example styling that can be used here.

Choose Styles on the right side

../../_images/cartaro_geoserver_style.png

Choose a name for your new style
Copy the following example SLD into the SLD text box and click Save
Mind to adjust the content of the Name and Title tags in the SLD to match Style Title and Style Description respectively

<?xml version="1.0" encoding="ISO-8859-1"?><StyledLayerDescriptor version="1.0.0" xsi:schemaLocation="http://www.opengis.net/sld StyledLayerDescriptor.xsd" xmlns="http://www.opengis.net/sld" xmlns:ogc="http://www.opengis.net/ogc" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<NamedLayer>
  <Name>wildlife</Name>
   <UserStyle>
      <Title>Wildlife</Title>
          <FeatureTypeStyle>
              <Rule>
                  <PolygonSymbolizer>
                      <Fill>
                          <CssParameter name="fill">#00aa00</CssParameter>
                          <CssParameter name="fill-opacity">0.5</CssParameter>
                      </Fill>
                  </PolygonSymbolizer>
              </Rule>
          </FeatureTypeStyle>
      </UserStyle>
  </NamedLayer>
</StyledLayerDescriptor>

Layers ¶

Choose Structure ‣ GeoServer from the menu bar to visit the GeoServer configuration page
Select Layers and click Add to add your new layer

../../_images/cartaro_geoserver_layer.png

Type a suitable layer title
Select PostGIS Field as Layer type
If you have created your own style one step before, select it as Style
Select your fresh created content type as Source
Check Provide an OpenLayers WFS layer within the OpenLayers section
Finish configuration by clicking on Save

Tip

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

Configure OpenLayers ¶

OpenLayers is used to display your new layer.

Choose Structure ‣ OpenLayers from the menu bar to visit the OpenLayers configuration page
Choose Maps and look for frontmap which is used as default map

Note

An OpenLayers version warning appears only the first time you visit the OpenLayers configuration page and can be ignored.

../../_images/cartaro_openlayers_entry.png

Look for frontmap which is used as default map and select Edit on the right side

../../_images/cartaro_openlayers_maps.png

Frontmap’s configuration page will be appear as shown on the screenshot below.
Select Layers & Styles on the left side to add our newly created layer to the map.

Look for your new created layer (Wildlife habitats in our example)
Check the boxes Enabled, Activated and In Switcher to show your new layer by default
Finish configuration by clicking on Save at the bottom of the page

Add content ¶

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

Choose Content from the menu bar to see all exisiting content elements within your Cartaro installation
Select Add content to add more content
Choose your new content type

../../_images/cartaro_content_overview.png

Type a name for your new content element
You can now draw the geometry for your 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.
Simply click on the map to create a new geometry. Every click will produce a new edge. Finish the drawing with double click.
When you are ready, click on Save at the bottom.

Note

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

../../_images/cartaro_create_content2.png

You should now see your new content element
To view your new content element on the front map, click on the house icon in the upper left corner

Tip

If you are not satisfied with your result, you can easily edit your new content element and change the geometry

../../_images/cartaro_content_preview2.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, 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